Control-M/Agent PAFZ4.9.0.22.004

BMC Software is releasing Control-M/Agent patch PAFZ4.9.0.22.004, which applies an enhancement and corrects the following problem in Control-M/Agent on UNIX and Windows.

Enhancement

The following table describes the enhancement that is applied in Control-M/Agent PAFZ4.9.0.22.004.

Tracking Number	Description
WSI-2600	Control-M Automation API now enables you to create a certificate signing request (CSR) and deploy a signed certificate that is based on that CSR to an Agent before the Agent is configured to communicate via SSL/TLS. For more information, see the following Control-M Automation API commands: config server:agent:csr::create  config server:agent:crt::deploy

Corrected Problem

The following table describes the problem that is corrected in Control-M/Agent PAFZ4.9.0.22.004.

Tracking Number	Description
CTM-13115	(Windows only) Agent job submissions fail when SolutionSoft Time Machine, a third-party app that significantly decreases internal communication between Agent processes, is installed on the Agent host.

Installing Control-M/Agent Patch PAFZ4.9.0.22.004 on UNIX

This procedure describes how to install Control-M/Agent patch PAFZ4.9.0.22.004 on UNIX.

Before You Begin

• Verify that Control-M/Agent 9.0.22 is installed before you install this patch.
• Verify that no Control-M jobs are executing on the Agent.

Begin

1. Log in to the account where Control-M/Agent is installed.
   
   InformationIf Control-M/Agent was installed on the root, you must log in as the root user.​​
    
2. Download the installation package from Control-M/Agent 9.0.22 Patches.
3. Save the downloaded installation package to a temporary directory on your local hard drive (not a network drive).
4. Navigate to the Control-M/Agent home directory.

5. Run the following command to shut down the Agent:
   shut-ag

6. Run the following command to ensure that the installation file has the necessary authorizations:
   chmod +x <Temporary_Directory>/PAKAI.9.0.22.004_<Platform>_INSTALL.BIN
7. Do one of the following:
   • Interactive Installation: Run the following command and follow the on-screen instructions until the installation is complete.
     <Temporary_Directory>/PAKAI.9.0.22.004_<Platform>_INSTALL.BIN
   • Automatic Installation: Run the following command:
     <Temporary_Directory>/PAKAI.9.0.22.004_<Platform>_INSTALL.BIN -s
     where the -s parameter enables automatic installation.

8. Run the following command to start up the Agent:
   start-ag
   After the installation completes, the new Agent version (9.0.22.004) might take several hours appear in the Configuration domain.

9. (Optional) To immediately update the Agent version in Control-M/EM, from the Agent host run the ag_ping utility.

Installing Control-M/Agent Patch PAFZ4.9.0.22.004 on Windows

This procedure describes how to install Control-M/Agent patch PAFZ4.9.0.22.004 on Windows.

Before You Begin

• Verify that Control-M/Agent 9.0.22 is installed before you install this patch.
• Verify that no Control-M jobs are executing on the Agent.

Begin

1. Log in to the account where Control-M/Agent is installed.
2. Download the installation package from Control-M/Agent 9.0.22 Patches.
3. Save the downloaded installation package to a temporary directory on your local hard drive (not a network drive).
4. Open Windows Services, right-click the Control-M/Agent service, and from the drop-down list select Stop.
5. Do one of the following:
   • Interactive Installation: Run the following command and follow the on-screen instructions until the installation is complete.
     <Temporary_Directory>\PAKAI.9.0.22.004_windows_x86_64.exe
   • Automatic Installation: Run the following command:
     <Temporary_Directory>\PAKAI.9.0.22.004_windows_x86_64.exe -s -i <Agent_Name>
     where:
     • -s enables automatic installation.
     • -i <Agent_Name> specifies Default for the default Agent or the name of a specific non-default Agent that is installed on the host.
6. Open Windows Services, right-click the Control-M/Agent service, and from the drop-down list select Start.
   After the installation completes, the new Agent version (9.0.22.004) might take several hours appear in the Configuration domain.

7. (Optional) To immediately update the Agent version in Control-M/EM, from the Agent host run the ag_ping utility.

Uninstalling Control-M/Agent Patch PAFZ4.9.0.22.004 from UNIX

This procedure describes how to uninstall Control-M/Agent patch PAFZ4.9.0.22.004 from UNIX.

Before You Begin

• Verify that no Control-M jobs are executing on the Agent.

Begin

1. Log in to the account where Control-M/Agent is installed.
2. From a command line, navigate to Control-M/Agent home directory.
3. Run the following command to shut down the Agent:
   shut-ag
4. Run the following command:
   ${CONTROLM}/install/PAKAI.9.0.22.004/uninstall.sh
   Run the following command to start up the Agent:
   start-ag
5.  

Uninstalling Control-M/Agent Patch PAFZ4.9.0.22.004 from Windows

This procedure describes how to uninstall Control-M/Agent patch PAFZ4.9.0.22.004 from Windows.

Before You Begin

• Verify that no Control-M jobs are executing on the Agent.

Begin

1. Log in to the account where Control-M/Agent is installed.
2. Open Windows Services, right-click the Control-M/Agent service, and from the drop-down list select Stop.
3. Run the following command:
   <AGENT_HOME>\install\PAKAI.9.0.22.004\uninstall.bat
4. Open Windows Services, right-click the Control-M/Agent service, and from the drop-down list select Start.