Configuring the Integration Files

Additional files must be configured in the application server before the integration to ChangeMan ZMF can be used.

Configure the additional files as follows:

  1. Download the Deployment Automation ChangeMan ZMF plugin bundle from the Deployment Automation downloads on the Serena website at http://www.serena.com/support. For example, ChangeMan_ZMF_Bundle_vvv.zip, where vvv is the version of Deployment Automation.
  2. Extract the plugin zip file, such as ZMF_6.1.3_v_bbb.zip, from the bundle, where v is the version of the plugin and bbb is the build number.
  3. Copy the zmf-core-CURRENT.jar from the plugin zip file to the Deployment Automation application server as follows:
    1. In the plugin bundle, navigate to the lib directory. For example:

      C:\Users\bjoson\Downloads\ZMF_6.1.3_v_bbb.zip\lib

    2. Copy the zmf-core-CURRENT.jar file to the Deployment Automation application server WEB-INF\lib directory. The default path is:

      C:\Program Files\Serena\common\tomcat\8.0\webapps\serena_ra\WEB-INF\lib

  4. In the Deployment Automation application server WEB-INF directory, such as

    C:\Program Files\Serena\common\tomcat\8.0\webapps\serena_ra\WEB-INF,

    edit the web.xml file and add the following lines before the </web-app> tag.

      <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>
    
  5. Restart the application server. For example, Serena Common Tomcat.