Upgrading Control-M/Server on UNIX

This procedure describes how to upgrade from Control-M/Server 9.0.18 and higher to the latest version of Control-M/Server on UNIX. If you want to upgrade multiple instances of Control-M/Server on several computers using the same configuration, use the automatic upgrade, 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.

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/Server, as described in Control-M/Server UNIX system requirements.
• If you are upgrading in a cluster environment, see Control-M/Server UNIX cluster configuration.
• If your current Control-M components were installed using the Full Installation method and you are upgrading to the current version from a version earlier than 9.0.20, upgrade Control-M/EM before upgrading Control-M/Server.

To upgrade Control-M/Server on UNIX:

1. Copy the installation files from the temporary directory that you created in Obtaining Control-M installation files, to the home directory.
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/Server 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/Server option and continue with the on-screen instructions until the Summary window.

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

   The upgrade log can be found at the following location:

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

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