Open topic with navigation

# Upgrading OMT with the ArcSight Installer

Follow the Checklist: Upgrading Your Environment to ensure a successful upgrade.

As part of the process, you must upgrade OMT with the ArcSight Installer. This is the recommended and simplest method for upgrading OMT, as it also will automatically perform the required pre-upgrade and post-upgrade actions, and will ensure any installation bug fixes are automatically implemented.

Note: The ArcSight Installer is supported only for `root` installations.

To perform the automatic upgrade with `arcsight-install`:

1. Download the `arcsight-platform-installer-x.x.x.x.zip` file into a temporary directory (referred to as {unzipped-installer-dir}) in a secure network location.
2. Become `root` and navigate to {unzipped-installer-dir}.

3. Unzip `arcsight-platform-installer-x.x.x.x.zip`

4. Run the following command:

       cd arcsight-platform-installer-x.x.x.x

5. Run the following command:

       ./arcsight-install --cmd upgrade

   Note: If the directory /tmp has insufficient space, run this command instead:
   `./arcsight-install --cmd upgrade --tmp-folder {unzipped-installer-dir}`,
   where `{unzipped-installer-dir}` is the name of your temporary upgrade directory.
Caution: Executing the command above might return random errors ending with the CDF upgrade failed message.

To recover from the failure, execute the upgrade command again, multiple times if necessary, until the upgrade succeeds.

6. Follow the prompts supplied by the ArcSight Installer. You can follow the progress of the upgrade by opening a separate shell session and checking the log file at `/tmp/autoUpgrade/upgradeLog/autoUpgrade-<timestamp>.log`.
Note: Errors found in the log can be cut and pasted into an ArcSight support ticket. In addition, you can consult the Release Notes for ArcSight Platform 23.3 for workarounds.
7. If `--tmp-folder {unzipped-installer-dir}` is used, after the upgrade completes, remove the temporary folder by running the command:

       rm -rf {unzipped-installer-dir}

Note: In the rare event that performing the upgrade using this method fails, roll back to a different upgrade method as described below.

If upgrading with arcsight-install is not possible, you can upgrade OMT manually.