Control-M for Web Services, Java, and Messaging PACOB.9.0.00.009

BMC Software is releasing Control-M for Web Services, Java, and Messaging patch PACOB.9.0.00.009 to introduce an enhancement and correct several problems in Control-M for Web Services, Java, and Messaging for UNIX and Windows.

Enhancements

You can now convert a Control-M for Web Services job to a Control-M for Web Services REST or Control-M for Web Services SOAP job, as described in the following procedures:

• Converting a Control-M for Web Services Job to a Control-M Web Services REST or Control-M Web Services SOAP Job on UNIX
• Converting a Control-M for Web Services Job to a Control-M Web Services REST or Control-M Web Services SOAP Job on Windows

Corrected Problems

The following table describes the problems that are corrected in Control-M for Web Services, Java, and Messaging PACOB.9.0.00.009.

Installing Control-M for Web Services, Java, and Messaging PACOB.9.0.00.009 on UNIX

This procedure describes how to install patch PACOB.9.0.00.009 on UNIX.

Before You Begin

• Verify that no Control-M jobs are executing on the Agent.
• Verify that Java 11.0.16 or higher is installed.

Begin

1. Log in to the account where Control-M/Agent is installed and navigate to the Control-M/Agent home directory.
2. Download the installation package from Download Links for Control-M Plug-ins.
3. Save the downloaded installation package to a temporary directory on your local hard drive (not a network drive).

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

   AIX 

   Note

   If Control-M/Agent was installed or is running as the user root, you must log in as the user root to stop the Agent.

5. Run the following commands to stop the Control-M for Web Services, Java, and Messaging plug-in:
   • ${HOME}/ctm/cm/WS/exe/stopwscm
   • ${HOME}/ctm/cm/JAVA/exe/stopjavacm
   • ${HOME}/ctm/cm/MSG/exe/stopmsgcm

6. Run the following command to verify that the Control-M for Web Services process ID (PID) is deleted:
   ps -ef | grep wscm
   A one-line response appears. 

   Note

   If a response longer than one line appears, you must run the following command to kill the PID and repeat this step to verify it has been deleted:
   kill -9 <PID>

7. If Control-M/Agent is installed on an AIX operating system, run the following command to clear shared libraries from the memory:
   /usr/sbin/slibclean
8. From the temporary directory, run the following command to extract the patch installation file:
   • Linux: zcat PACOB.9.0.00.009_linux.tar.Z | tar -xvf -
   • AIX: zcat PACOB.9.0.00.009_aix.tar.Z | tar -xvf -
   • Solaris: zcat PACOB.9.0.00.009_solaris.tar.Z | tar -xvf -
9. Navigate to the extracted PACOB.9.0.00.009 directory and run the following command to install the patch:
   install_patch.sh
10. Change the JRE package, as described in Changing the JRE Package in Control-M for Web Services, Java, and Messaging.

11. Run the following command to start the Agent: start-ag

    Note

    If Control-M/Agent was installed or is running as the user root, you must log in as the user root to start up the Agent.

Installing Control-M for Web Services, Java, and Messaging PACOB.9.0.00.009 on Windows

This procedure describes how to install patch PACOB.9.0.00.009 on Windows.

Before You Begin

• Verify that no Control-M jobs are executing on the Agent.
• Verify that Java 11.0.16 or higher is installed.

Begin

1. Log in to the account where Control-M/Agent is installed with administrator privileges.
2. Download the installation package from Download Links for Control-M Plug-ins.
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. Run the following command to stop the Control-M for Web Services, Java, and Messaging plug-in:
   • <Agent_Home>\cm\WS\exe\stopwscm
   • <Agent_Home>\cm\JAVA\exe\stopjavacm
   • <Agent_Home>\cm\MSG\exe\stopmsgcm
6. Do the following to verify that Control-M for Web Services, Java, and Messaging is stopped:
   1. Press CTRL+ALT+DELETE, click Task Manager, and click the Details tab.
      The Windows Task Manager Details tab appears.
   2. Right-click on a column, select Select Columns, then select the Command Line checkbox, and then click OK.
      The Command Line column appears in the Details tab.
   3. In the Name column, locate the javaw.exe task and if you find it, in the Command Line column, verify that the line contains the following string:
      CM\WS\EXE
   4. If CM\WS\EXE appears in the Command Line of the javaw.exe task, right-click on the javaw.exe task and then select End Task from the drop-down list.
      The javaw.exe task disappears from the Details tab table.
7. If the installation package is compressed, run the following command to extract it:
   tar -xf PACOB.9.0.00.009_windows_x86_64.zip
8. Navigate to the temporary directory and run the following command:
   PACOB.9.0.00.009\install_patch.bat
9. Change the JRE package, as described in Changing the JRE Package in Control-M for Web Services, Java, and Messaging.
10. Open Windows Services, right-click the Control-M/Agent service, and from the drop-down list select Start.

Uninstalling the Patch from UNIX

This procedure describes how to uninstall patch PACOB.9.0.00.009 from UNIX. The original Control-M for Web Services connection profile, wsprofile.dat, is not restored. However, this connection profile is saved as wsprofile.dat.install_saved in the <Agent_Home>/data directory.

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. Run the following command to shut down Control-M/Agent:
   shut-ag

   Note

   If Control-M/Agent was installed or is running as the user root, you must log in as the user root to stop the Agent.

3. Run the following command to stop the Control-M for Web Services, Java, and Messaging plug-in:
   • ${HOME}/ctm/cm/WS/exe/stopwscm
   • ${HOME}/ctm/cm/JAVA/exe/stopjavacm
   • ${HOME}/ctm/cm/MSG/exe/stopmsgcm

1. Run the following command to verify that the Control-M for Web Services process ID (PID) is deleted:
   ps -ef | grep wscm
   A one-line response appears. 

   Note

   If a response longer than one line appears, you must run the following command to kill the PID and repeat this step to verify it has been deleted:
   kill -9 <PID>

2. If Control-M/Agent is installed on an AIX operating system, run the following command to delete unused libraries:
   ${HOME}/usr/sbin/slibclean

3. Run the following command:

   PACOB.9.0.00.009/uninstall_patch.sh

4. From the Agent account, run the following command to start up the Agent:
   start-ag

Uninstalling the Patch from Windows

This procedure describes how to uninstall patch PACOB.9.0.00.009 from Windows. The original Control-M for Web Services connection profile, wsprofile.dat, is not restored. However, this connection profile is saved as wsprofile.dat.install_saved in the <Agent_Home>\data directory.

Before You Begin

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

Begin

1. Log in, as an administrator, to the host 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 to stop the Control-M for Web Services, Java, and Messaging plug-in:
   • <Agent_Home>\cm\WS\exe\stopwscm
   • <Agent_Home>\cm\JAVA\exe\stopjavacm
   • <Agent_Home>\cm\MSG\exe\stopmsgcm
4. Do the following to verify that Control-M for Web Services, Java, and Messaging is stopped:
   1. Press CTRL+ALT+DELETE, click Task Manager, and click the Details tab.
      The Windows Task Manager Details tab appears.
   2. Right-click on a column, select Select Columns, then select the Command Line checkbox, and then click OK.
      The Command Line column appears in the Details tab.
   3. In the Name column, locate the javaw.exe task and if you find it, in the Command Line column, verify that the line contains the following string:
      CM\WS\EXE
   4. If CM\WS\EXE appears in the Command Line of the javaw.exe task, right-click on the javaw.exe task and then select End Task from the drop-down list.
      The javaw.exe task disappears from the Details tab table.

5. From the <Agent Home> directory, run the following command:

   PACOB.9.0.00.009\uninstall_patch.bat

6. Open Windows Services, right-click the Control-M/Agent service, and from the drop-down list select Start.