Space banner


This documentation supports the 20.02 version of BMC Digital Workplace Basic.

To view the latest version, select the version from the Product Version menu.

Performing the BMC Digital Workplace upgrade

This topic describes how to use the wizard installer to upgrade BMC Digital Workplace on a single server. Other options for running the installer are described in Performing the BMC Digital Workplace installation.

Before you begin

Complete the tasks described in Preparing for a BMC Digital Workplace upgrade.

To upgrade BMC Digital Workplace on a single server 

Best practice

Do not use Xming to install the server, because it might not perform reliably during installation. Instead, we recommend that you use VNC, MobaXterm, or any other client.

  1. Unzip the suite installer (for example, or DigitalWorkplaceV.V.V.linux.tar.gz where VV.VV.VV and V.V.V indicates the version number of BMC Digital Workplace).
  2. Navigate to the Disk 1 folder.
  3. Start the installer:
    • For Windows, run setup.exe.
    • For UNIX, run setup.bin.

  4. On the Welcome panel, click Next.
  5. Review the license agreement, click I agree to the terms of license agreement, and then click Next.
  6. Enter the values from Upgrade worksheets.
    After you have entered the required information, the installer validates your input.
  7. Select the directory.
  8. Back up the following databases before performing an upgrade in your production environment: 
    • BMC Digital Workplace database 
    • BMC Remedy AR System database
    In case of upgrade errors related to database schemas or AR System workflow, you can use the backups to restore the databases and resume the upgrade from the last successful step.
  9. If you have BMC Digital Workplace Advanced installed, select the check box if you want to switch to using BMC Digital Workplace Basic.
  10. Review the list of services stopped by the installer, and start the services that are required after the upgrade is complete.
    After post-upgrade cleanup, a summary of the installation appears.

  11. From the installation summary, review the information and any instructions. For example, if a database update failure occurred, you can recover and run the upgrade again if you have a backup of your database and perform the recovery steps:
    1. Restore the database by using the backup created in step 8.
    2. View the installation log files to find and correct the cause of failure. For example, review any SEVERE error messages or warnings in the product installer log. See whether errors are due to network, host, or other environment-related issues. You can view a log file of the installation: 
      • C:\Users\Administrator\AppData\Local\Temp\digital_workplace_install_log.txt (Windows) 
      • /tmp/digital_workplace_install_log.txt (Linux)
    3. Run the installer again.
      The upgrade resumes from the last successful step.
  12. Click Done to exit the installer.


    When the DWP Application service starts for the first time after the upgrade, the total processor utilization across all cores increases for the first few minutes. The increase in total processor utilization depends on your server configuration and other applications running on the same server.

    Make sure that the server has Oracle JDK or Open JDK 11.

To upgrade BMC Digital Workplace in a cluster

  1. Upgrade BMC Digital Workplace on the first server, as described earlier in this topic.
    You can run the first upgrade on the primary server, or on any of the secondary servers.
  2. Upgrade BMC Digital Workplace on each of the other servers in the cluster.
    For each of these additional upgrades, the application is upgraded on the applicable server. However, the AR System server and database are not updated because they are updated when you run the upgrade on the first server.


    You can save time by upgrading the other servers in parallel. However, you should start the additional upgrades only after completing the upgrade for the first server.

Where to go from here

Verifying the BMC Digital Workplace installation

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