This documentation supports the 20.02 version of Remedy Deployment.
To view an earlier version, select the version from the Product version menu.

Performing the BMC Remedy ITSM upgrade

When you start the version 18.05 installer, you can choose one or more applications or features to upgrade at one time. Because certain applications depend on a specific set of features, you might need to run the installer multiple times to upgrade all of the applications in the ITSM solution. For example, you might run the installer to first upgrade BMC Change Management, and then run the installer a second time to upgrade or perform a fresh install of BMC Knowledge Management. You can also run the installer separately to install additional language packs.


There are no installers for Remedy ITSM applications after version 18.05. To upgrade Remedy ITSM, you need to first install ITSM and other applications using version 18.05 installers and then apply the latest deployment packages.

In this topic

Before you begin

If you have not done so already, prepare the system to run the installers. If you want to run in nonadmin mode on Windows, see Preparing a Windows environment. If you want to run in nonroot mode on UNIX, see Preparing a UNIX environment.

To upgrade BMC Remedy ITSM

  1. If you have not already done so, download the BMC Remedy ITSM Suite 18.05 installer from EPD, or navigate to the installation directory on the DVD.
  2. Unzip the installer and navigate to the Disk 1 folder.
  3. Start the installer.
    • For Windows, run setup.cmd.
    • For UNIX, run setup.bin.

      Best practice

      When installing the application on UNIX, we recommend that you perform the installation as a root user. However, you can perform the installation as a non-root user, but you must log on to the UNIX system under the same UNIX user ID that was used to install BMC Remedy AR System.

  4. In the lower right corner of the Welcome panel, click Next.
  5. Review the license agreement, click I agree to the terms of the license agreement, and then click Next.
  6. In the BMC Remedy AR System User Inputs panel, perform the following actions:
    1. Enter the administrator name and password.
    2. Review the default installation directory.
      Navigate to the directory in which you want to install BMC Remedy ITSM Suite. The default locations are C:\Program Files\BMC Software\BMCRemedyITSMSuite (Windows) and/opt/bmc/BMCRemedyITSMSuite (UNIX or Linux).
    3. Click Next.
  7. In the Overlay Information panel, perform the following actions:
    1. Carefully review the warning.
      The upgrade overwrites all customizations unless you create them in overlays or custom objects.
    2. Select the I understand and agree that proceeding from this point will overwrite any customizations that are not in overlays or in custom objects check box if you agree.
    3. Click Next.

    The installer validates the system resources of your computer and displays a list of BMC applications (such as BMC Asset Management, BMC Change Management, and so on).

  8. Select one or more applications to install (by default, the entire ITSM suite is selected), and then click Next.

    The installer checks the AR System server for valid ITSM licenses and validates other application dependencies (for example, the current version of the BMC Atrium CMDB).

  9. In the Installation preview panel, review the features that you are installing.
    You are nearly finished with the ITSM installation.
  10. Click Install.
    After postinstallation cleanup, a summary of the installation appears. 
  11. Click View Log to review the SEVERE error messages or warnings in the product installer log.
    • (Windows) C:\Users\<installUser>\AppData\Local\Temp\bmcremedyitsmsuite_install_log.txt
    • (UNIX or Linux) /tmp/bmcremedyitsmsuite_install_log.txt
  12. When you are done reviewing, close the log and click Done to exit the installer.
  13. Perform the following steps to flush the mid tier cache:
    1. Stop the mid tier service.
    2. Delete all content under the following directory: C:\Program Files\BMC Software\ARSystem\midtier\PluginsCache\<ARSystemServer>.
    3. Restart the mid tier service.
    4. In the Mid Tier Configuration Tool, flush the mid tier cache.
    5. In the Mid Tier Configuration Tool, trigger the AR System server preload process. 

     For instructions on how to flush the cache and trigger the AR System server preload, see  Cache Settings parameters Open link . See also About Mid Tier caching Open link .

Troubleshooting the BMC Remedy ITSM upgrade

If your upgrade fails at any point due to invalid field mappings in a join form, you must correct the invalid field mappings before you proceed with the upgrade. For more information, see Correcting invalid field mappings in join forms.

Consult the following topics for information about other issues that you might encounter during the upgrade:

Where to go from here

Next task

Go to Post-upgrade procedures for BMC Remedy ITSM.

If you do not intend to use BMC Service Request Management or BMC Service Level Management, after performing the post-upgrade procedures for ITSM, apply the latest ITSM deployment package. For more information, see Applying a deployment package.

Up to process

If you have finished upgrading the applications, return to the appropriate upgrade process:

Related topics

Summary of changes to the Common Data Model Open link

Was this page helpful? Yes No Submitting... Thank you


  1. Marie Johnson

    I think you need to review and update this as you are stating there is no installer for 18.08 or after, yet this is for v20. Everything on this page talks about v18 not 20.

    Jun 05, 2021 03:20
    1. Himanshu Raul

      Hi Marie,

      Thank you for your feedback on the documentation. 

      If you are on a version prior to 18.05, you must first upgrade the Remedy ITSM Suite to version 18.05, and then apply the latest 20.02 deployment packages.

      This topic describes the process of upgrading to version 18.05. For steps to apply the latest deployment packages, see Applying a deployment package.



      Jun 22, 2021 11:15