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:
-
Support for ZMF 8.2 Patch 5.
-
Fixed issues in encrypt.cmd:
'NullPointerException' when running encrypt.cmd in almsernet/almzmf/alfalmzmf. 'NullPointerException' when running encrypt.cmd with empty *_resource.properties file in almsernet/almzmf/alfalmzmf. 'NoClassDefFoundError' when running encrypt.cmd in almsernet/almzmf/alfalmzmf.
Install or upgrade ALM Solutions Connector
To install ALM Solutions Connector or upgrade it from version 6.0 or later to the latest version:
- Download the latest ALM Solutions Connector installation files from the ALM Solutions Connector product page.
- (Optional) If your current Tomcat version is earlier than 8.5.33.0, download and install the latest Common Tools.
-
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
-
-
Install the new version of the ALM Solutions Connector services:
-
Extract the following war files from the installation zip file:
- almsernet.war
- almzmf.war
- almzmfalf.war
- zmfws.war
-
Stop Common Tomcat.
-
Ensure that the Common Tomcat directory is writeable and none of the existing services files are in use.
-
Copy all the war files into the Common Tomcat webapps directory, for example: C:\Program Files\Micro Focus\common\tomcat\8.5\webapps
-
Start Common Tomcat. When running, the server automatically unpacks and deploys the war files.
-
almzmfalf
almsernet
almzmf
After installing the ALM Solutions Connector services, manually configure resource properties for the following services:
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:
-
Audit requests do not show as completed if the audit return code is 20.
If you run a change package audit request, and the ChangeMan ZMF task is somehow terminated during the run, the audit return code returned to ALM Solutions Connector is 20. In this situation, the audit task may not show as completed in the integrating product, even if it is successfully completed in ChangeMan ZMF (DEF275298).