This documentation supports the 20.08 version of BMC Digital Workplace Advanced, which is available only to BMC Helix subscribers (SaaS). To view an earlier version, select the version from the Product Version menu.

Upgrading BMC Digital Workplace Catalog in a server group

If you are running BMC Digital Workplace Catalog on multiple servers in a cluster to enable high availability, you can upgrade all servers in the cluster to BMC Digital Workplace Catalog 20.02 without disrupting your business. The BMC Digital Workplace Catalog non-disruptive upgrade process ensures that you do not lose the data from user requests and running processes.

The following sections describe changes to the functions of a load balancer in a cluster and how to perform the upgrade. 


Related topics

System-requirements

Downloading-the-BMC-Digital-Workplace-Catalog-upgrade-files

Cluster environment before the BMC Digital Workplace Catalog upgrade

A typical cluster installation comprises a primary server that is used for all administrative operations, and a group of secondary servers that process all the end user requests through the BMC Digital Workplace application. All servers in the cluster share the database associated with the primary server, as shown in the following illustration.

digitalworkplace_catalog_high_availability_3.3.00.001.png

 

Cluster environment after the upgrade to BMC Digital Workplace Catalog 18.02.00 or later

After you upgrade BMC Digital Workplace Catalog  to 18.02.00 or later on all the servers, the primary server and all secondary servers still share the same database. However, the upgraded primary server and all secondary servers can process administrative operations as well as end user requests through the BMC Digital Workplace application, as shown in the following illustration.

digital_workplace_catalog_high_availability_installation_3.4.00.png

Before you begin

Perform the following tasks to prepare your environment for upgrading BMC Digital Workplace Catalog in a cluster.

Important

When you upgrade BMC Digital Workplace Catalog in a cluster, you must upgrade each server individually until all the servers have been upgraded.


When you upgrade BMC Digital Workplace Catalog on the primary server, you must modify the server configuration before and after the upgrade, as described in the following sections.

To prepare the BMC Digital Workplace Catalog primary server for the upgrade

Perform the following tasks to remove the primary server from the cluster temporarily so that you can upgrade BMC Digital Workplace Catalog.

  1. Log in to the primary server with the credentials of the user account that will perform the upgrade.

  2. Open the ar.conf file in a text editor. If you installed BMC Digital Workplace Catalog in the default location, run the following command:

    Example of opening the vi text editor to edit the ar.conf file
    vi /opt/bmc/digitalworkplace/conf/ar.conf
  3. Search for the Server-Group-Member parameter, and set the value to F. Only the primary server must be removed from the cluster before the upgrade.

  4. Restart the primary server for the setting to take effect. For example, if you installed BMC Digital Workplace Catalog in the default location, run the following commands to stop and restart the server. Replace the user name Demo and the password Passw0rd! with your system credentials.

    $ /opt/bmc/digitalworkplace/dwpcontroller stop

    (... wait for the console to stop displaying messages ...)

    $ /opt/bmc/digitalworkplace/dwpcontroller start -u Demo -p Passw0rd!


To upgrade  BMC Digital Workplace Catalog on the primary server

Perform the following steps to upgrade the BMC Digital Workplace Catalog  primary server with the upgrade options file that you created for the primary server.

  1. Extract the files from the upgrade archive package. For instructions, see Extracting-the-downloaded-archive.
  2. On the Linux server, find the directory where you extracted the installation files.

  3. Run the upgrade script and specify the upgrade options file. For more information, see Creating-a-BMC-Digital-Workplace-Catalog-upgrade-options-file.

    Command to run the upgrade script and load an upgrade options file
    ./upgrade-digitalworkplace.sh -o myoptions.txt

    Tip

    If you want to use the configuration wizard to create a new options file, run the above command without specifying the upgrade options file. Follow the prompts to proceed with the upgrade.

  4. If you specified the options file, the following message will be displayed. Enter y to validate your options file, and enter n to skip the validation and proceed with the next step.
    Would you like you validate your options file using the DWPCatalog Configuration Wizard
  5. After you read and accept the End User License Agreement (EULA), the upgrade process begins.
    The system will report if the upgrade succeeds or fails. If the upgrade fails, review the error message and the log files to troubleshoot the problem.

To reset the BMC Digital Workplace Catalog primary server to be part of the cluster

  1. Log in to the primary server with the credentials of the user account that performed the upgrade.

  2. Open the ar.conf file in a text editor. If you installed BMC Digital Workplace Catalog in the default location, run the following command:

    Example of opening the vi text editor to edit the ar.conf file
    vi /opt/bmc/digitalworkplace/conf/ar.conf
  3. Search for the Server-Group-Member parameter, and set the value back to T.

  4. Restart the primary server for the settings to take effect. For example, if you installed BMC Digital Workplace Catalog in the default location, run the following commands to stop and restart the server. Replace the user name Demo and the password Passw0rd! with your system credentials.

    Example of stopping and restarting the BMC Digital Workplace Catalog 3.3.02 server
    $ /opt/bmc/digitalworkplace/dwpcontroller stop

    (... wait for the console to stop displaying messages ...)

    $ /opt/bmc/digitalworkplace/dwpcontroller start -u Demo -p Passw0rd!

To upgrade each of the BMC Digital Workplace Catalog secondary servers in the cluster

You do not need to modify the configuration of the secondary servers. Proceed to upgrade BMC Digital Workplace Catalog on each secondary server one after another. The BMC Digital Workplace Catalog cluster will still process end user requests through the BMC Digital Workplace application by reading the cached data on the secondary servers that have not yet been upgraded.

  1. Extract the files from the upgrade archive package. For instructions, see Extracting-the-downloaded-archive.
  2. On the Linux server, find the directory where you extracted the installation files.

  3. Run the upgrade script and specify the upgrade options file. For more information, see Creating-a-BMC-Digital-Workplace-Catalog-upgrade-options-file.

    Command to run the upgrade script and load an upgrade options file
    ./upgrade-digitalworkplace.sh -o myoptions.txt

    Tip

    If you want to use the configuration wizard to create a new options file, run the above command without specifying the upgrade options file. Follow the prompts to proceed with the upgrade.

  4. If you specified the options file, the following message will be displayed. Enter y to validate your options file, and enter n to skip the validation and proceed with the next step.
    Would you like you validate your options file using the DWPCatalog Configuration Wizard
  5. After you read and accept the End User License Agreement (EULA), the upgrade process begins.
    The system will report if the upgrade succeeds or fails. If the upgrade fails, review the error message and the log files to troubleshoot the problem.