This documentation supports the 21.05 (12.2) version of BMC Discovery.To view an earlier version of the product, select the version from the Product version menu.

Performing the upgrade

This section describes how to upgrade BMC Discovery. After you download the upgrade files, you use the UI to perform the upgrade for installations on standalone machines and in a cluster environment.  You can upgrade to a Patch, Service Pack, and perform OS upgrades by using the UI. However, in case of an upgrade issue that cannot be resolved in the UI, use the 

tw_run_upgrade
 command line utility. 

Related topics

System-requirements

Preparing-for-upgrade

Known-and-corrected-issues

Limitations-and-restrictions-of-this-version

To perform the upgrade

Use the following steps to upgrade BMC Discovery by using the UI.

  1. From the main menu, click the Administration admin_icon.png icon.
    The Administration page is displayed.
  1. From Appliance, click Upgrade.
    Make sure that no warnings are displayed in the Pre-Upgrade Check section. All pre-upgrade checks pass when the following required conditions for the upgrade are fulfilled:
    • For clustered deployments, all the members of the cluster are functioning.
    • Discovery is stopped.
    • The credential vault is open.
    • No discovery run or consolidation in progress.
    • No synchronization with BMC Helix CMDB is in progress.
  2. Depending on whether your browser has HTML5 support, use the appropriate step outlined in the following section to copy the upgrade archive files.
    • Browser with HTML5 support
      • Click the Upload button and choose the upgrade archive from your file system and click upload again. 
        A progress bar shows the progress of the upload.
    • Browser with no HTML5
      • From the command prompt, copy the upgrade archive file to the /usr/tideway/var/upgrade directory.
      • After the upgrade archive is uploaded, click Check for upgrade archive in the UI.
  3. The upgrade installer now provides you with an option to perform the upgrade in advanced mode or regular mode. With Advanced mode, you can prepare the upgrade, including distributing the upgrade files, and defer executing the upgrade until later. This option is useful for clustered environments.

  4. Depending on whether you want to upgrade using the regular mode or advanced mode, click one of the following steps:

    • To perform the upgrade in regular mode:

      1. Click Apply Upgrade. 
        If you are using a cluster, the archive is distributed to other members of the cluster. The upgrade runs and when it completes, the system reboots.

        Note

        To complete the upgrade, and start using the new version, you must open the credentials vault using the existing passphrase. The credentials cannot be upgraded until the vault has been opened. Once this is done the upgrade is complete and you can then change the passphrase.

    • To perform the upgrade in advanced mode:
      1. Select the Advanced Mode check box.
      2. Click Prepare Upgrade.
        The upgrade files in the compressed upgrade archive are extracted and the UI displays the status in the progress bar and notifies you on completion.
      3. (Only if you are upgrading a cluster) Click Distribute Upgrade.
        When the distribution starts, you can monitor the progress of the distribution for all the cluster members. 
        The screen refreshes once the distribution is completed.

      1. Click Run Upgrade.
        A window shows the progress of the upgrade and details of the upgrade. When the upgrade completes, the system reboots.

        Note

        To complete the upgrade, and start using the new version, you must open the credentials vault using the existing passphrase. The credentials cannot be upgraded until the vault has been opened. Once this is done the upgrade is complete and you can then change the passphrase.

    After the upgrade process completes, the system reboots. If you are a user with Admin privileges, you can view the upgrade notifications by clicking the Messages icon in the dynamic toolbox. The messages displayed include warnings and errors.

See the following video (01:59), which explains how you can upgrade BMC Discovery version 11.x (CentOS 7) to version 12.x (CentOS 7). 

icon-play.png https://youtu.be/LK-Phg8Rr7U

Where to go from here

Upgrading-and-configuring-Windows-proxies