Upgrading Control-M/EM on UNIX

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

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.
• If you have a Control-M/EM Distributed installation, you must upgrade the default Control-M/EM first and then upgrade the Distributed Control-M/EM. The Workload Archiving server is upgraded automatically during the Control-M/EM Distributed upgrade.

Before You Begin

Ensure that you have met the following requirements:

• Verify that your operating system and database software is compatible with the new version of Control-M/EM, as described in Control-M/EM UNIX system requirements.
• If you are upgrading Control-M in a cluster environment, see Control-M/EM UNIX cluster configuration.

To upgrade Control-M/EM on UNIX:

1. Do one of the following:
   • Mount the Installation DVD.
   • From the temporary directory that you created (see Product Distribution in the Control-M version 9.0.19 Release Notes), extract the .tar.Z file.
2. Set your DISPLAY environment variable, as described in Setting environment variables in UNIX.
3. From your home directory, type the following command:

   <source_path>/setup.sh

4. Do one of the following:
   • Interactive upgrade: Select the Control-M/Enterprise Manager 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/Enterprise Manager option and continue with the on-screen instructions until the Summary window.

        NOTE: There is no confirmation to shut down Control-M/EM 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.sh -silent <xml_path>/<filename.xml>

   The upgrade logs can be found at the following location:

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

   To ensure compatibility between older versions of Control-M client, Control-M/EM is now running in Compatibility Mode.

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