Control-M/Agent PAFZ4.9.0.22.101
BMC Software is releasing Control-M/Agent PAFZ4.9.0.22.101 to correct various issues in Control-M SaaS Application Integrator.
Corrected Problems
The following table describes the Control-M Application Integrator problems that are corrected in patch PAFZ4.9.0.22.101.
| Tracking Number | Description | Impacted Integrations |
|---|---|---|
CTM-14955 | Control-M Application Integrator files in the procid directory that meet the retention policy criteria might not be deleted during the New Day procedure if their size exceeds 4 KB. | Any user-defined Application Integrator plug-in |
| CTM-14920 WBL-380023 | OAuth2 token requests might fail if a custom Content-Type header is defined in the OAuth2 configuration. In such cases, the user-defined value (for example, application/json or text/plain) overrides the required application/x-www-form-urlencoded header, which causes the OAuth2 authorization endpoint to reject the request. | Any user-defined Application Integrator plug-in |
| CTM-14839 WBL-374942 | Job execution takes longer than usual when the Control-M/Agent procid directory accumulates tens of thousands of files. | Any user-defined Application Integrator plug-in |
| CTM-14788 WBL-372948 | A server REST response that is sent with GZIP compression is unreadable. |
|
| CTM-14782 WBL-372709 | The Kubernetes job output appears in Control-M only after the job has finished, rather than being displayed during execution. | Any user-defined Application Integrator plug-in |
| CTM-14730 WBL-371092 | (Windows only) Application Integrator interprets CLI command output based on UTF-8 encoding. If the system’s active code page differs (for example, Windows-1252), any non-ASCII characters in the output might be rendered incorrectly. | Any user-defined Application Integrator plug-in |
| CTM-14702 WBL-370273 | HTTP response bodies are decoded using UTF-8, even when a different charset is specified in the Content-Type header. This causes special or accented characters to appear corrupted for responses encoded with non-UTF-8 charsets (such as ISO-8859-1). | Any user-defined Application Integrator plug-in |
| CTM-14697 WBL-367011 | A job ends OK rather than failing if a Verify operation completion sub-step fails during job execution and a later Verify operation completion sub-step succeeds. | Any user-defined Application Integrator plug-in |
| CTM-14690 WBL-369986 | The counter defined by the Retry in case of failure setting in a Verify operation completion sub-step is not reset after a successful response is returned during a sequence of retries. As a result, other Verify operation completion failures continue from the previous Retry count instead of starting over. | Any user-defined Application Integrator plug-in |
| CTM-14651 WBL-368632 | Application Integrator jobs on Linux or UNIX do not consistently resolve the character encoding for script execution and input parameters. This might cause incorrect processing of non-ASCII characters. | Any user-defined Application Integrator plug-in |
Installing Patch PAFZ4.9.0.22.101 on UNIX
This procedure describes how to install Control-M/Agent patch PAFZ4.9.0.22.101 for Application Integrator on UNIX.
Before You Begin
- Verify that Control-M/Agent 9.0.22.100 is installed before you install this patch.
- Verify that no Control-M jobs are executing on the Agent.
- If you are using an AIX operating system, remove unused libraries from memory by typing the following command as a root user:
/usr/sbin/slibclean
Begin
- Log in to the Control-M/Agent host where Control-M Application Integrator is installed.
- Create a temporary directory to save downloaded files.
- Download the patch from the following S3 link:
https://control-m-pre-ga.s3.us-east-1.amazonaws.com/PAFZ4.9.0.22.101_GA/PAAIT.9.0.22.101_unix.tar.Z - Save the PAAIT.9.0.22.101_unix.tar.Z file in the temporary directory.
- Run the following command to shut down the Agent:
shut-ag - Extract the patch tar.Z file, using the following command:
zcat PAAIT.9.0.22.101_unix.tar.Z | tar -xvf - - Run the following command
sh setup.sh - Follow the on-screen instructions until the installation is complete.
- Run the following command to start the Agent:
start-ag
Note: After installation is complete, the new Agent version (9.0.22.101) might take several hours to be updated in the Configuration domain. If you want an immediate update of the Agent version, run the ag_ping utility from the Agent machine.
Installing Patch PAFZ4.9.0.22.101 on Windows
This procedure describes how to install Control-M/Agent patch PAFZ4.9.0.22.101 for Application Integrator on Windows.
Before You Begin
- Verify that Control-M/Agent 9.0.22.100 is installed before you install this patch.
- Verify that no Control-M jobs are executing on the Agent.
Begin
- Log in to the Control-M/Agent computer.
- Create a temporary directory to save downloaded files.
- Download the patch from the following S3 link:
https://control-m-pre-ga.s3.us-east-1.amazonaws.com/PAFZ4.9.0.22.101_GA/PAAIT.9.0.22.101_windows_x86_64.zip - Save the PAAIT.9.0.22.101_windows_x86_64.zip file in the temporary directory.
- Open Windows Services, right-click the Control-M/Agent service, and from the drop-down list select Stop.
- Extract the PAAIT.9.0.22.101_windows_x86_64.zip file.
Navigate to the temporary directory and run the following command:
PAAIT.9.0.22.101_windows_x86_64.exe- Follow the on-screen instructions until the installation is complete.
- Open Windows Services, right-click the Control-M/Agent service, and from the drop-down list select Start.
Note: After installation is complete, the new Agent version (9.0.22.101) might take several hours to be updated in the Configuration domain. If you want an immediate update of the Agent version, run the ag_ping utility from the Agent machine.
Uninstalling Patch PAFZ4.9.0.22.101 from UNIX
This procedure describes how to uninstall Control-M/Agent patch PAFZ4.9.0.22.101 for Application Integrator from UNIX.
Before You Begin
- Verify that no Control-M jobs are executing on the Agent.
- If you are using an AIX operating system, remove unused libraries from memory by typing the following command as a root user:
/usr/sbin/slibclean
Begin
- Log in to the account where Control-M/Agent is installed.
Run the following command to shut down Control-M/Agent:
shut-ag- Run the following command:
/<Agent_Home>/ctm/install/PAAIT.9.0.22.101/uninstall.sh - Run the following command to start up the Agent:
start-ag
Note: After uninstallation is complete, the Agent version (9.0.22.100) might take several hours to be updated in the Configuration domain. If you want an immediate update of the Agent version, run the ag_ping utility from the Agent machine.
Uninstalling Patch PAFZ4.9.0.22.101 from Windows
This procedure describes how to uninstall Control-M/Agent patch PAFZ4.9.0.22.101 for Application Integrator from Windows.
Before You Begin
- Verify that no Control-M jobs are executing on the Agent.
Begin
- Log in, as an administrator, to the host where Control-M/Agent is installed.
- Open Windows Services, right-click the Control-M/Agent service, and from the drop-down list select Stop.
- From the Control Panel, select Program and Features.
- Select Control-M Application Integrator 9.0.22.100 Patch 1 and click Uninstall.
- Open Windows Services, right-click the Control-M/Agent service, and from the drop-down list select Start.
Note: After uninstallation is complete, the Agent version (9.0.22.100) might take several hours to be updated in the Configuration domain. If you want an immediate update of the Agent version, run the ag_ping utility from the Agent machine.