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 a UNIX- and Windows-based Agent, either interactively or automatically.

To install Control-M for WJM on several hosts with the same configuration, choose the Automatic Installation option described in the procedures below.

Installing Control-M for WJM on a UNIX Agent

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

The default installation is interactive and uses a GUI display. XServer must be running and configured with the DISPLAY environment variable. If you do not have XServer available, BMC recommends that you continue with the console installation or perform an automatic installation.

Before You Begin

Begin

  1. Log in as the Agent user.

  2. Run the following command to stop the Agent:

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

    If Control-M/Agent was installed with user root, log in as user root every time you start up or shut down the 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. Run one of the following commands to activate the installation script:

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

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

  5. Do one of the following:

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

    • Automatic Installation: 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 hosts where you want to perform an automatic installation.

      5. Run the following command to execute the installation script:

        <Installation_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_<Timestamp>.log

  7. Log out of the Agent host.

  8. Log in to the Agent and run the following command to start the Agent:

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

Installing Control-M for WJM on a Windows Agent

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

Before You Begin

Begin

  1. Log in as a user with Administrator privileges and stop the Agent.

  2. Do one of the following:

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

    • Open a command prompt as an Administrator and run the following command:

      <Installation_Source_Path>\DRCOB.9.0.00_windows_x86_64.exe

  3. Do one of the following:

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

    • Automatic Installation: Do the following:

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

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

      3. Click Yes.

        The automatic installation *.xml parameter file that is created (<Filename>.xml) is relevant only for hosts with the same Agent instance name. A separate <Filename>.xml file must be manually created or modified for each Agent instance name.

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

      5. Run the following command to execute the installation script:

        <Installation_Source_Path>\DRCOB.9.0.00_windows_x86_64.exe -silent <Silent.xml>

  4. Restart the Agent.
    The installation log is saved to one the following locations:

    • Successful Installation: <Agent_Instance_Directory>\BMCINSTALL\log\cmwsj\BMC_Control-M_For WJM_Install_<Timestamp>.log

    • Failed Installation: %temp%\BMC_Control-M_For WJM_<Timestamp>.log

Installing Control-M for WJM on Control-M Desktop on Windows

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

You do not need to perform this procedure on Control-M Desktop 9.0.21.100 or higher.

Before You Begin

  • Close Control-M Desktop and the CCM.

Begin

  1. Log in as an Administrator.

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

    <Installation_Source_Path>\EM\setup.exe

  3. Do one of the following:

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

    • Automatic Installation: 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 hosts with the same Control-M/EM version. For hosts with different Control-M/EM versions, a separate file must be created for each host.

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

      4. Run the installation script with the following command:

        <Installation_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_<Timestamp>.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 from running on the Agent.

  • Verify that all jobs have completed execution.

Begin

  1. From an Agent host, log in as an Agent user, and run the following command to shut down the Agent:

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

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

  2. Set your DISPLAY environment variable according to the hostname, 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 <Agent_User> -p all

    The uninstallation log is saved to the following location:

    $HOME/BMCINSTALL/log/cmwjm/BMC_ControlM_WJM_Uninstall_<Timestamp>.log

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 from running on the Agent.

  • Verify that all jobs have completed execution.

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.

    The uninstallation log is saved to the following location:

    BMCINSTALL\log\cmwjm\BMC_ControlM_WJM_Uninstall_<Timestamp>.log

Automatically Uninstall Control-M for WJM from Windows

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

Before You Begin

  • Stop all jobs from running on the Agent.

  • Verify that all jobs have completed execution.

Begin

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

  2. Navigate to the following directory:

    <Agent_Installation_Path>\BMCINSTALL\uninstall\DRCOB.9.0.00\

  3. Open a command prompt with Administrator privileges, and run the following command:

    uninstall.exe-silent

    The uninstallation log is saved to the following location:

    BMCINSTALL\log\cmwjm\BMC_ControlM_WJM_Uninstall_<Timestamp>.log

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. JRE is supported only when the major release version is the same as the tested version. For more information, see Control-M External Java Installation.

Begin

  • Do one of the following:

    • UNIX: Do the following:

      1. Run the following command to stop Control-M for Web Services, Java, and Messaging:

        $CONTROLM/cm/WS/exe/stopwscm

      2. Navigate to the $CONTROLM/cm/JRE directory and run the following command to rename the directory and save it as a backup:

        mv JRE <JRE_Backup_Name>

        mv JRE JRE_Backup

      3. Run the following command to copy the new JRE package directory to $CONTROLM/cm and rename it JRE:

        cp -rf /home/<New_JRE_Package_Directory> $CONTROLM/cm/JRE

        The following JRE directories now appear in $CONTROLM/cm/:

        • New JRE Directory: $CONTROLM/cm/JRE

        • Backed Up JRE Directory: $CONTROLM/cm/<JRE_Backup_Name>

        The new JRE package in the /home/java/jre_11.0.13 directory is copied to $CONTROLM/cm/ and renamed JRE.

        • Relative directory paths are not supported.

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

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

    • Windows: Do the following:

      1. Run the following command to stop Control-M for Web Services, Java, and Messaging:

        <AGENT_HOME>\cm\WS\exe\stopwscm

      2. Rename the <Agent_Home>\cm\JRE directory to save it as a backup.

        <Agent_Home>\cm\JRE_Backup

      3. Copy the new JRE package directory to <Agent_Home>\cm\, and rename it JRE.

        The following JRE directories now appear in <Agent_Home>\cm\:

        • New JRE Directory: <Agent_Home>\cm\JRE

        • Backed Up JRE Directory: <Agent_Home>\cm\<JRE_Backup_Name>

        The new JRE package in the C:\java\jre_11.0.13 directory is copied to <Agent_Home>\cm\ and renamed JRE.

        • You must enclose the directory with " (quotation marks).

        • Network and relative directory paths are not supported.

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

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