Configuring the ChangeMan ZMF Plug-in

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

Important: This plug-in is supported only in a Tomcat application server.

Configure the plug-in as follows:

  1. Download the ChangeMan ZMF plug-in bundle file from the Release Manager download location on the Serena website at http://www.serena.com/support. For example, ZMF_bundle_vvv, where vvv is the version.
    Note: The bundle appears in the download list only if you have purchased the Mainframe Connector option.
  2. Extract the plug-in bundle file. It contains the zmf-plugin.zip file and all of the files needed to configure the plug-in.

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

    almzmf.war

    almzmfalf.war

    almzmfws.war

  4. Copy zmf-core-CURRENT.jar to the following application server path:

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

  5. Add the following lines to the application server web.xml file.
    Note: If you are initiating the ChangeMan ZMF processes directly through Deployment Automation and not through Release Manager, these lines should not be added; you should comment them out if they are already there.
      <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 Deployment Automation through Administration > Automation > Automation Plugins.
  8. Configure the processes for the plug-in that are required for the Release Manager integration.

Related Topics

Automation Plug-ins