ZMF Plug-in Installation

The ChangeMan ZMF plug-in must be configured in the application server before it can be loaded into Release Automation.

Configure the plug-in as follows:

1. Download the zmf-plugin-bundle.zip file from the plug-ins download location on the Serena website at http://www.serena.com/support.

2. Extract the zmf-plugin-bundle.zip file. It contains the following files:

   zmf-plugin.zip

   ZMF Sample Application.json

   Sample UAT.json

   almzmf.war

   almzmfalf.war

   almzmfws.war

   cmn-core-current.jar

   web.xml

3. Stop the Release Automation application server and deploy the following files to the Release Automation deployment location, the actual Release Automation application server location where serena_ra.war is deployed:

   almzmf.war

   almzmfalf.war

   almzmfws.war

4. Copy cmn-core-current.jar to the following application server path:

   ..\webapps\serena_ra\WEB-INF\lib

5. Copy the included web.xml to replace the existing one in the following application server path:

   ..\webapps\serena_ra\WEB-INF

   If you are using your web.xml file for other purposes and cannot replace it, you can instead modify it to add the following lines to it.

     <servlet>
           <servlet-name>ZMFALFEventRouter</servlet-name>
           <servlet-class>com.serena.servlet.ZMFALFEventRouter</servlet-class>
           <init-param>
               <param-name>redirectURL</param-name>
               <param-value>/</param-value>
           </init-param>
           <load-on-startup>1</load-on-startup>
       </servlet>
       <servlet-mapping>
           <servlet-name>ZMFALFEventRouter</servlet-name>
           <url-pattern>/servlet/ZMFALFEventRouter</url-pattern>
       </servlet-mapping>
   
       <servlet-mapping>
           <servlet-name>ZMFALFEventRouter</servlet-name>
           <url-pattern>/services/*</url-pattern>
       </servlet-mapping>
   

6. Restart the application server.
7. After the application server is started, load the zmf-plugin.zip file in Release Automation through Administration > Automation > Automation Plugins. See Loading Plug-ins.
8. Configure the processes for the plug-in that are required for the Release Manager integration.