Control-M Agent PAFZ4.9.0.22.052
BMC Software is releasing Control-M/Agent PAFZ4.9.0.22.052 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.052.
| Tracking Number | Description | Impacted Integrations |
|---|---|---|
| CTM-14493 | Jobs created with Control-M Application Integrator on Windows might remain stuck in Executing state if any runtime parameters generated from the Output Handling definitions contain newline characters. |
|
| CTM-13804 | Execution logs that are created during job execution and grow in size to several megabytes might result in significant memory usage. |
|
| CTM-14482 | Application Integrator jobs fail, and the following error appears in the logs: xml_buff_size is over MAX_XML_REQUEST_SIZE. stop adding XML elements to avoid 'xml element value too long' error This error is generated even though the maximum request size was not reached. | Any user-defined Application Integrator plug-in |
| CTM-14511 | The Contains and Equals (=) operators in the Fail the job if extracted data field in Output Handling definitions do not trigger job failure as expected. | Any user-defined Application Integrator plug-in |
Installing Patch PAFZ4.9.0.22.052 on UNIX
This procedure describes how to install Control-M/Agent patch PAFZ4.9.0.22.052 for Application Integrator on UNIX.
Before You Begin
- Verify that Control-M/Agent 9.0.22.050 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.052_GA/PAAIT.9.0.22.052_unix.tar.Z - Save the PAAIT.9.0.22.052_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.052_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.052) 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.052 on Windows
This procedure describes how to install Control-M/Agent patch PAFZ4.9.0.22.052 for Application Integrator on Windows.
Before You Begin
- Verify that Control-M/Agent 9.0.22.050 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.052_GA/PAAIT.9.0.22.052_windows_x86_64.zip - Save the PAAIT.9.0.22.052_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.052_windows_x86_64.zip file.
Navigate to the temporary directory and run the following command:
PAAIT.9.0.22.052_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.052) 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.052 from UNIX
This procedure describes how to uninstall Control-M/Agent patch PAFZ4.9.0.22.052 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.052/uninstall.sh - Run the following command to start up the Agent:
start-ag
Note: After uninstallation is complete, the Agent version (9.0.22.050) 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.052 from Windows
This procedure describes how to uninstall Control-M/Agent patch PAFZ4.9.0.22.052 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.050 Patch 2 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.050) 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.