Upgrading Control-M/Agent on UNIX

This procedure describes how to upgrade from Control-M/Agent 8.0.00.500 and higher to the latest version of Control-M/Agent on UNIX. If you want to upgrade multiple instances of Control-M/Agent on several computers using the same configuration, use the automatic upgrade, as described in this procedure.

NOTE: This procedure upgrades Control-M/Agent locally. To deploy and upgrade multiple Control-M/Agents from the CCM, see Control-M/Agent deployment.

NOTE: The default upgrade 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 upgrade or perform an automatic upgrade.

Before You Begin

Ensure that you have met the following requirements:

• Ensure that your operating system and database software is compatible with the new version of Control-M/Agent, as described in Control-M/Agent system requirements.
• Ensure that the Internal Process Communication (IPC) subsystem is enabled.
• Verify that your locale is set to English before beginning the upgrade.

To upgrade Control-M/Agent on UNIX:

1. Log in as a Control-M/Agent user and then switch to user root.
2. Copy the installation files from the temporary directory that you created in Obtaining Control-M installation files, to the home directory.

   If you are upgrading Control-M/Agent in non-root mode, log out user root and log in as the Control-M/Agent user.

3. Set your DISPLAY environment variable, as described in Setting environment variables in UNIX.
4. From your home directory, type the following command:

   <source_path>/setup.sh

5. Do one of the following:
   • Interactive upgrade : Select the Control-M/Agent option and continue with the on-screen instructions until the upgrade is complete.
   • Automatic upgrade: Create a parameter file and then run the automatic install in a non-interactive mode, as follows:
     1. Select the Control-M/Agent option and continue with the on-screen instructions until the Summary window.

        NOTE: There is no confirmation to shut down Control-M/Agent processes. It is done automatically.

     2. Click Generate and select the location to create the XML parameter file.
     3. Click Yes to quit the upgrade.

        A confirmation message appears.

     4. Click Yes.
     5. Copy the automatic upgrade parameters file to a network location that is accessible to all computers where you want to perform an automatic upgrade.
     6. To run the upgrade script, type the following command:

        <source_path>/Setup_files/components/agent/setup.sh -silent <xml_path>/<filename.xml>

   The upgrade log can be found at the following location:

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

   After you have upgraded Control-M/Agent, you need to run a script that removes the Log4j v2 vulnerability, as described in 000391322.