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 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 this procedure.

NOTE: The default installation is interactive and uses a GUI display. XServer must be running and configured using 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

Ensure the following:

• Verify that all jobs running on Control-M/Agent have ended.
• (Upgrade only) Stop the Java, Web Services and Messaging plug-ins, as described in Shutting down Control-M for Web Services, Java, or Messaging.
• (Upgrade only) Remove the ws_lockfile.lock from the <Agent>/temp directory, if exists.

To install Control-M for WJM on Control-M/Agent on UNIX:

1. Log in as the Control-M/Agent user, and stop the Control-M/Agent by typing the following command:

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

   NOTE: If the Control-M/Agent was installed with user root, then log in as user root every time you start up or shut down the Control-M/Agent throughout this procedure. If you are using an AIX operating system, you must remove unused libraries from memory, by typing the following command as a root user:

   /usr/sbin/slibclean

2. Do one of the following:
   • Mount the installation DVD.
   • Extract the files from the temporary directory that you created when obtaining the installation files via EPD (see Control-M for Web Services, Java, and Messaging Release Notes).
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. From the installation DVD or from the installation files via EPD, activate the installation script with the following command:

   <source_path>/setup.sh

5. From the Product Settings - Select application window, select BMC Control-M for Web Services, Java and Messaging.

   NOTE: If you have a previous version of any of the following products, Control-M for WJM automatically detects and upgrades during the installation process:

   • Control-M for Web Services
   • Control-M for Java
   • Control-M for Messaging
6. 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. To run the installation script, type the following command:

        >cd <DVD>/UNIX/<OS type>/Setup_files/components/cm/cmbpi

        >setup.sh –silent <filename.xml>

   The installation logs can be found at the following location:

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

7. Log out of the Control-M/Agent account.
8. Start the Control-M/Agent by running the following command:

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

9. Install Control-M for WJM on Control-M/EM before using the Control-M Configuration Manager, as described in Installation on Control-M/EM.
10. To use Control-M for WJM in Control-M Configuration Manager, run the ctmgetcm utility in the Control-M/Server, as described in ctmgetcm in Control-M Utilities.