This Readme provides the latest information about ALM Solutions Connector 6.2.4.

ALM Solutions Connector (ALM SC) is a flexible set of services and programs for Windows or UNIX/Linux platforms that enables you to deploy to z/OS through Micro Focus ChangeMan ZMF.

Note: This product was named ZMF Connector for versions 6.0 to 6.1.2. For earlier versions, it was named Mainframe Connector.

About this release

What's new? For a list of enhancements in ALM Solutions Connector 6.2.4, see What's new in ALM SC 6.2.4.
Download Download the ALM Solutions Connector 6.2.4 zip file from the ALM Solutions Connector product page.

Note: Ensure that Micro Focus Common Tools are up to date. If your current Tomcat version is earlier than 8.5.33.0, download and install the latest Common Tools.
Install / upgrade ALM Solutions Connector To install ALM SC or upgrade it from version 6.0 or later, follow the instructions in Install or upgrade ALM Solutions Connector.

To upgrade from versions earlier than 6.0, contact Support for assistance.
Integrate ChangeMan ZMF with Release Control To integrate ChangeMan ZMF with Release Control 6.0.1 and later, use the ChangeMan ZMF plugin and ALM Solutions Connector.

Note: There are additional ways to integrate products with ChangeMan ZMF using ALM Solutions Connector. For help with custom integrations, contact Support.
Install / upgrade the ChangeMan ZMF plugin for Release Control To install the ChangeMan ZMF plugin for Release Control, see the Release Control Plugin Help in the Documentation Center.

To upgrade the ChangeMan ZMF plugin, see the Release Control Plugins Readme in the Documentation Center.
Supported platforms For details about supported platforms, see the Supported Platforms.
Known issues For a list of known issues, see the Known issues.
Documentation For configuration details, see the ALM Solutions Connector Configuration Guide. The guide covers the integration with Release Control.
Helpful links To learn more about the ALM Solutions Connector, see the Knowledge Base.

What's new in ALM SC 6.2.4

In this release, ALM Solutions Connector introduces the following enhancements:

Install or upgrade ALM Solutions Connector

To install ALM Solutions Connector or upgrade it from version 6.0 or later to the latest version:

  1. Download the latest ALM Solutions Connector installation files from the ALM Solutions Connector product page.
  2. (Optional) If your current Tomcat version is earlier than 8.5.33.0, download and install the latest Common Tools.
  3. If you are upgrading, back up your earlier version. Navigate to the Common Tomcat webapps directory, for example: C:\Program Files\Micro Focus\common\tomcat\8.5\webapps

    Copy the following directories from the webapps directory to a backup location:

    • almsernet

    • almzmf
    • almzmfalf
    • almzmfws
  4. Install the new version of the ALM Solutions Connector services:

    1. Extract the following war files from the installation zip file:

      • almsernet.war
      • almzmf.war
      • almzmfalf.war
      • zmfws.war
    2. Stop Common Tomcat.

    3. Ensure that the Common Tomcat directory is writeable and none of the existing services files are in use.

    4. Copy all the war files into the Common Tomcat webapps directory, for example: C:\Program Files\Micro Focus\common\tomcat\8.5\webapps

    5. Start Common Tomcat. When running, the server automatically unpacks and deploys the war files.

    After installing the ALM Solutions Connector services, manually configure resource properties for the following services:

    • almzmfalf
    • almsernet
    • almzmf

If they are not encrypted, you can use your backed-up versions of the properties files to get the values you need for setup.

Note: In ALM Solutions Connector 6.2.2 and earlier, the zmfws services were named the almzmfws services. Though the zmfws services need no additional configuration, they are used when deployment tasks run.

The host and port information for ChangeMan ZMF as well as the URL for ALM Solutions Connector are specified in the ChangeMan ZMF plugin configuration. You can define multiple plugin configurations that point to different ChangeMan ZMF systems and ALM Solutions Connector configurations.

For details about installing and configuring the ALM Solutions Connector services, see the ALM Solutions Connector Configuration Guide.

Known issues

The following issue is known to exist at the time of the release: