Upgrade process overview for BMC Digital Workplace Catalog
Review this section for details about the requirements and process for upgrading BMC Digital Workplace Catalog.
Upgrade path supported by version
The following table describes the upgrade path for the supported versions of BMC Digital Workplace Catalog and the application under its previous name, MyIT Service Broker.
|Application||Currently installed version||Supported upgrade to version||Comments|
BMC Digital Workplace Catalog
18.05 or later
You can upgrade directly from BMC Digital Workplace Catalog 18.05 or later to version 19.11 . The upgrade process migrates existing data, so you do not need to run a separate data migration step.
If the application is installed in a cluster for high availability, you can perform a non-disruptive upgrade by upgrading each individual server in sequence. For more information, see Upgrading BMC Digital Workplace Catalog in a server group.
BMC Digital Workplace Catalog
|3.3.02 to 18.02||18.05|
You cannot upgrade directly from BMC Digital Workplace Catalog 3.3.02 to the latest BMC Digital Workplace Catalog 19.11 release. You must first upgrade to BMC Digital Workplace Catalog 18.05 to upgrade your existing database schema, and then you can upgrade to the latest version.
|MyIT Service Broker||3.3||3.3.02|
You cannot upgrade directly from MyIT Service Broker 3.3 to the latest BMC Digital Workplace Catalog 19.11 release. You must first upgrade to version 3.3.02 to upgrade your existing database schema, and then you can upgrade to 18.05 followed by upgrade to 19.11 .
If you upgrade from 3.3 to 3.3.02, you must also perform a manual step to update the platform version in the database to be able to upgrade to version 18.05. For more information, see the following knowledge article: .
|MyIT Service Broker||3.2 and related service packs and patches||(None)||You cannot perform an in-place upgrade directly from versions prior to version 3.3.02. For help transitioning your existing MyIT Service Broker 3.2 installation and migrating data into the latest release, contact BMC Support.|
Before you begin
|1||Review the latest deployment use cases to understand whether any changes to your system architecture are required.|
|2||Review the release notes for information about what's new, what's changed, and solutions to issues encountered during testing.|
|3||Collect the required information about the existing installation that will be used for the upgrade process.||Upgrade worksheet for BMC Digital Workplace Catalog|
If the upgrade is to be performed as a non-root user, ensure that the user account that will be performing the upgrade has the appropriate access to the installation folders and files.
Note: This step would have been completed before the original installation of BMC Digital Workplace Catalog.
|See the "Preparing a server for installation as a non-root user" section in Preparing a Linux server for BMC Digital Workplace Catalog installation|
Tasks to upgrade BMC Digital Workplace Catalog
Review the following tasks to understand the process before performing the upgrade.
|1||Download the files required for upgrade.||Downloading the BMC Digital Workplace Catalog upgrade files|
|2||Back up the database, file system, and create a snapshot of all servers.||Preparing a system for a BMC Digital Workplace Catalog upgrade|
Copy the information from the BMC Digital Workplace Catalog upgrade worksheet into an upgrade options file to upload to the server.
|Creating a BMC Digital Workplace Catalog upgrade options file|
Select an upgrade path based on your deployment scenario—a single BMC Digital Workplace Catalog instance or high-availability cluster deployment.
If BMC Remedy Single Sign-On is integrated with BMC Digital Workplace Catalog, log in to the BMC Remedy SSO administration console, and make sure the Backchannel Service URL is configured.
|Configuring BMC Remedy Single Sign-On integration for BMC Digital Workplace Catalog|
Test the upgrade after completion by logging in to BMC Digital Workplace Catalog.