Control-M/Agent PAKAI.9.0.21.306

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

Enhancement

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 Problems

The following table describes the problems that are corrected in Control-M/Agent PAKAI.9.0.21.306.

Tracking Number	Patch	Description
CTM-11498	PAKAI.9.0.21.304	(Windows) The ctmldnrs utility fails to run when a job attempts to run it on the (local) Agent that is included in the Control-M/Server installation.
CTM-11548	PAKAI.9.0.21.304	The Agent is unavailable when the following occurs: The Agent is not set to communicate via SSL, but Control-M/Server is set to communicate via SSL. The Agent is set to communicate via SSL, but Control-M/Server is not set to communicate via SSL.
CTM-11626	PAKAI.9.0.21.304	(Windows) Jobs appear in a viewpoint as Executing with a Disappeared job state, instead of Ended Not OK, after the Agent host restarts.
CTM-11691	PAKAI.9.0.21.304	(Windows) Successive Agentless Host jobs fail with the job log message Job disappeared, even though the jobs successfully run and execute, four minutes after an initial Agentless Host job fails to respond to an Agent submit request.
CTM-12013	PAKAI.9.0.21.304	Agents fail to recover their communication with Control-M/Server when the Control-M/Server is in a cluster and switches between hosts. The following error message appears in the Agent logs: java.io.UncheckedIOException: java.io.IOException: Not connected after connectTimeout
CTM-12114	PAKAI.9.0.21.304	(Windows) The p_ctmam process utilizes excessive memory when an Agent submits jobs to an Agentless Host.
CTM-12920	PAKAI.9.0.21.306	Jobs fail to execute on AIX 7.3 TL3 Agents in non-root mode. The following error message appears: Authentication Failed. The user name or password are invalid

Installing Control-M/Agent Patch PAKAI.9.0.21.306 on UNIX

This procedure describes how to install Control-M/Agent patch PAKAI.9.0.21.306 on 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.
   
   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.21 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.21.306_<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.21.306_<Platform>_INSTALL.BIN
   • Automatic Installation: Run the following command:
     <Temporary_Directory>/PAKAI.9.0.21.306_<Platform>_INSTALL.BIN -s
     where the -s parameter enables automatic installation.

8. Run the following command to start up the Agent:
   start-ag

Installing Control-M/Agent Patch PAKAI.9.0.21.306 on Windows

This procedure describes how to install Control-M/Agent patch PAKAI.9.0.21.306 on 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. Download the installation package from Control-M/Agent 9.0.21 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.21.306_windows_x86_64.exe
   • Automatic Installation: Run the following command:
     <Temporary_Directory>\PAKAI.9.0.21.306_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.

Uninstalling Control-M/Agent Patch PAKAI.9.0.21.306 from UNIX

This procedure describes how to uninstall Control-M/Agent patch PAKAI.9.0.21.306 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.21.306/uninstall.sh
5. Run the following command to start up the Agent:
   start-ag

Uninstalling Control-M/Agent Patch PAKAI.9.0.21.306 from Windows

This procedure describes how to uninstall Control-M/Agent patch PAKAI.9.0.21.306 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.21.306\uninstall.bat
4. Open Windows Services, right-click the Control-M/Agent service, and from the drop-down list select Start.