Upgrading a BMC Digital Workplace Catalog server

Follow the process described in this topic to upgrade a single instance of BMC Digital Workplace Catalog to the latest release.

If BMC Digital Workplace Catalog is installed in a cluster for high availability, you can upgrade each server sequentially without losing data, user requests, and running processes. The net effect is minimal downtime to upgrade BMC Digital Workplace Catalog and increased productivity for your organization.

For more information, see Upgrading BMC Digital Workplace Catalog in a server group.

Before you begin

Perform the following tasks to prepare your environment for upgrading.

To upgrade BMC Digital Workplace Catalog on a single server

If BMC Digital Workplace Catalog is installed only in a single-server environment, you cannot use BMC Digital Workplace Catalog or request services through the BMC Digital Workplace enhanced catalog until after the upgrade is finished. The time necessary for upgrade of a BMC Digital Workplace Catalog on a single server environment depends on the configuration, the version you are upgrading from, and database size. 

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.

Successful upgrade messages

You should receive the following messages that indicate a successful upgrade. The BMC Digital Workplace Catalog application server host name is shown in the URL.

$ ./upgrade-digitalworkplace.sh -o myoptions.txt

===========================================================================
          Welcome to the BMC Digital Workplace Catalog Installer
===========================================================================

Would you like you validate your options file using the DWPCatalog
Configuration Wizard [y/n]? n

In order to use this software you are required to accept the license
agreement, please press [Enter/Return] key to view the license.

You can scroll with the arrow keys and quit the viewer by pressing 'q'.

[Enter/Return]

Do you agree to the terms and conditions as defined in the EULA [y/n]? y

The upgrade will take roughly 5m-2h, depending on hardware and
installation type.

You can monitor the progress by viewing the logs:        

tail -f /tmp/dwp_install_log.txt

[ Upgrade started: 15:21:11 ]

[15:21:11] Validating Files    ..............................    [  PASS  ]
[15:21:26] Deploying File System    .........................    [  PASS  ]
[15:21:49] Upgrading Database    ............................    [  PASS  ]
[15:26:55] Starting Server    ...............................    [  PASS  ]
[15:28:35] Deploying Smart Bundles    .......................    [  PASS  ]
[15:28:35] Starting Server    ...............................    [  PASS  ]
[15:30:37] Upgrading BMC DWP Catalog    .....................    [  PASS  ]
[15:31:12] Updating old protected platform object    ........    [  PASS  ]
[15:31:23] Restarting Server    .............................    [  PASS  ]
[15:33:06] Deleting old protected platform object    ........    [  PASS  ]
[15:33:19] File Cleanup    ..................................    [  PASS  ]
[15:33:23] Restarting Server    .............................    [  PASS  ]

=========================================================================== 

Upgrade successful, you can now log into the BMC DWP Catalog
 administration console:              

 http://digitalworkplace-catalog.example.com/myitsbe/login

===========================================================================