Control-M for Web Services, Java, and Messaging Installation

The following procedures describe how to install Control-M for Web Services, Java, and Messaging (Control-M for WJM) on Control-M/Agent on UNIX and Windows interactively or automatically.

If you want to install multiple instances of Control-M for WJM on several computers using the same configuration, use the automatic installation, as described in these procedures.

Installing Control-M for WJM on Control-M/Agent on UNIX

This procedure describes how to install Control-M for WJM on Control-M/Agent on UNIX.

Before You Begin

• Verify that all jobs running on the Control-M/Agent have ended.

• Verify that you have met Java requirements, as described in Control-M External Java Installation.

Begin

1. Log in as the Control-M/Agent user.

2. Type the following command to stop the Control-M/Agent:

   $CONTROLM/scripts/shut-ag -u <agentUser> -p all

   If the Control-M/Agent was installed with user root, log in as user root every time you start up or shut down the Control-M/Agent throughout this procedure.

3. Use one of the following modes:

   • Display: If you install using GUI (or XServer), set your DISPLAY environment variable, as described in Setting Environment Variables in UNIX.

   • Console: It is not necessary to set DISPLAY.

4. Type one of the following commands to activate the installation script:

   • Linux: <install_source_path>/DRCOB.9.0.00_Linux-x86_64.BIN

   • AIX: <install_source_path>/DRCOB.9.0.00_AIX.BIN

5. Do one of the following:

   • Interactive Install: Continue with the on-screen instructions until the installation is complete.

   • Automatic Install: Do the following:

     1. Continue with the on-screen instructions until the Summary window.

     2. Click Generate and select the location to create the XML parameter file.

     3. Click Yes.

     4. Copy the automatic installation parameters file to a network location that is accessible to all computers where you want to perform an automatic installation.

     5. Type the following command to activate the installation script:

        <install_source_path>/<DRCOB.9.0.00_AIX.BIN|DRCOB.9.0.00_Linux-x86_64.BIN> -silent<filename.xml>

6. The installation log is saved to the following location:

   $HOME/BMCINSTALL/log/cmwjm/BMC_Control-M_For_WJM_Install_<date-time>.log

7. Log out of the Control-M/Agent host.

8. Log in and start the Control-M/Agent with the following command:

   $CONTROLM/scripts/start-ag -u <agentUser> -p all

Installing Control-M for WJM on Control-M/Agent on Windows

This procedure describes how to install Control-M for WJM on Control-M/Agent on Windows.

Before You Begin

• Verify that all jobs running on the Control-M/Agent have ended.

• Verify that you have met Java requirements, as described in Control-M External Java Installation.

Begin

1. Log in as a user with Administrator privileges and stop the Control-M/Agent.

2. Do one of the following:

   • From the installation path, double-click the DRCOB.9.0.00_windows_x86_64.exe file.

   • Open the command prompt as Administrator and type the following command:

     <install_source_path>\DRCOB.9.0.00_windows_x86_64.exe.

3. Do one of the following:

   • Interactive Install: Continue with the on-screen instructions until the installation is complete.

   • Automatic Install: Do the following:

     1. Continue with the on-screen instructions until the Summary window.

     2. Click Generate and select the location to create the XML parameter file.

     3. Click Yes.

        The automatic installation XML parameters file created (<filename>.xml) is relevant only for computers with the same Control-M/Agent instance name. A separate <filename>.xml file must be created or modified manually for each Control-M/Agent instance name.

     4. Copy the automatic installation parameters file to a network location that is accessible to all Control-M/Agent computers where you want to perform an automatic installation.

     5. Run the installation script, as follows:

        <install_source_path>\DRCOB.9.0.00_windows_x86_64.exe -silent <silent.xml>

4. Restart the Control-M/Agent.

The installation log is available at the following location:

<Control-M Agent instance directory>\BMCINSTALL\log\cmwsj\BMC_Control-M_For WJM_Install_<date-time>.log

If the installation fails, the log file is saved to the following location:

%temp%\BMC_Control-M_For WJM_<date-time>.log

Installing Control-M for WJM on the Control-M Client on Windows

This procedure describes how to install Control-M for WJM on the Control-M Client on Windows.

Before you begin

• Close the Control-M client and the CCM.

Begin

1. Log in as an Administrator.

2. Navigate to the following directory and click setup.exe.

   <source_path>\EM\setup.exe

3. Do one of the following:

   • Interactive Install: Follow the on-screen instructions until the installation is complete.

   • Automatic Install: Do the following:

     1. Follow the on-screen instructions until the Summary window.

     2. Click Generate, select the location to create the XML file, and click Yes.

        The XML file is only relevant only for computers with the same Control-M/EM version. For computers with different Control-M/EM versions, a separate file must be created for each computer.

     3. Copy the XML file to a network location that is accessible to all computers where you want to perform an automatic installation.

     4. Run the installation script with the following command:

        <source_path>\EM\setup.exe -silent <silent.xml>

   The installation log is saved to the following location or under the directory that contains the %temp% directory:

   %temp%\BMC_Control-M-CM_EM_Install_<date-time>.log

Uninstalling Control-M for WJM from UNIX

This procedure describes how to uninstall Control-M for WJM from UNIX.

Before You Begin

• Stop all jobs running on Control-M/Agent.

• Verify that all jobs have ended.

Begin

1. From a Control-M/Agent computer, log in as a Control-M/Agent user, and type the following command to shut down Control-M/Agent:

   $CONTROLM/scripts/shut-ag -u <agentUser> -p all

   If the Control-M/Agent was installed with user root, log in as user root every time you start up or shut down the Control-M/Agent throughout this procedure.

2. Set your DISPLAY environment variable according to the computer name, as described in Setting Environment Variables in UNIX.

3. Navigate to the following directory:

   $HOME/BMCINSTALL/uninstall/DRCOB.9.0.00/

4. Type one of the following commands:

   • Interactive Uninstall: ./uninstall.sh

   • Automatic Uninstall: ./uninstall.sh -silent

5. To restart Control-M/Agent, type the following command:

   $CONTROLM/scripts/start-ag -u <agentUser> -p all

Uninstalling Control-M for WJM from Windows

This procedure describes how to uninstall Control-M for WJM from Windows.

Before You Begin

• Stop all jobs running on Control-M/Agent.

• Verify that all jobs have ended.

Begin

1. From the Start menu, select Control Panel.

2. Double-click Uninstall a Program.

3. Select Control-M for Web Services, Java, and Messaging.

4. Click OK to continue.

Performing an Automatic Uninstall from Windows

This procedure describes how to perform an automatic uninstall of Control-M for WJM from Windows.

Before You Begin

• Stop all jobs running on Control-M/Agent.

• Verify that all jobs have ended.

Begin

1. Log in to the computer using a user ID that has Administrator authorizations.

2. Navigate to the following directory:

   <Agent Install Path>\BMCINSTALL\uninstall\DRCOB.9.0.00\

3. Open a command prompt window as an Administrator and type the following command:

   uninstall.exe-silent

Changing the JRE Package in Control-M for Web Services, Java, and Messaging

This procedure describes how to change the JRE package in Control-M for Web Services, Java, and Messaging. The use of JRE is supported only where the major release version is the same as the tested version. For more information about Java, see Control-M External Java Installation.

Begin

• Do one of the following:

  • UNIX: Do the following:

    1. From the <Agent_Home>/data/ directory, open wsprofile.dat file in a text editor.

    2. At the bottom of the [General] section, add or modify the JRE_BIN parameter so that it points to the external Java path, as follows:

       JRE_BIN <New JRE Path>\bin\

       JRE_BIN c:\java\jre_11.0.13\bin\

       • A relative path is not supported.

       • The path can only include alphanumeric characters, spaces, ., _, -, and +.

    3. Stop Control-M for Web Services, Java, and Messaging using the following command.

       $CONTROLM/cm/WS/exe/stopwscm

       Control-M for Web Services, Java, and Messaging restarts automatically.

  • Windows: Do the following:

    1. From the <Agent_Home>\data directory, open the wsprofile.dat file in a text editor.

    2. At the bottom of the [General] section, add or modify the JRE_BIN parameter so that it points to the external Java path, as follows:

       JRE_BIN <New JRE Path>\bin\

       JRE_BIN c:\java\jre_11.0.13\bin\

       • The path must be enclosed with quotation marks.

       • A network path is not supported.

       • A relative path is not supported.

       • The path can only include alphanumeric characters, spaces, ., _, -, and +.

    3. Stop Control-M for Web Services, Java, and Messaging using the following command.

       <AGENT_HOME>\cm\WS\exe\stopwscm

       Control-M for Web Services, Java, and Messaging restarts automatically.