Using the upgrade configuration utility

Use the upgrade configuration utility to simplify the process of updating the infra.config, deployment.config, and secrets.txt files while upgrading from the previous versions (22.2.01, 22.4, or 23.1.02 ) of BMC Helix IT Operations Management (BMC Helix ITOM) to the current version. The utility performs the following tasks:

  • It picks the values from the latest successful deployment of BMC Helix ITOMto configure the infra.config, deployment.config, and secrets.txt files. 
    You need not manually configure any parameter that you had configured previously.
  • It lists the infra.config file parameters whose names have been modified in the current release and updates their values automatically.
  • It lists the infra.config file parameters that were added in the current release. You must manually enter the values for the new configuration parameters in the infra.config file.


Related topics

Configuration-file-settings

Preparing-for-password-encryption

To run the upgrade configuration utility

  1. Download the upgrade configuration utility from Electronic Product Distribution (EPD).
    The upgrade configuration utility is a part of the deployment manager. For more information, see Downloading-the-deployment-manager.

  2. Go to helix-on-prem-deployment-manager/utilities/upgrade.

  3. Run the following command to provide execution permission to upgrade-configuration.sh: 

    $chmod a+x ../helix-on-prem-deployment-manager/utilities/upgrade/upgrade-configuration.sh

  4. Run the upgrade configuration utility:

    ./upgrade-configuration.sh <namespace>

    <namespace> is the namespace that you used to deploy BMC Helix ITOM.

    You will get a confirmation message after the utility has completed updating the     infra.config, deployment.config, and secrets.txt files.

    The utility     lists the infra.config file parameters that were added in the current release. You must manually enter the values for the new configuration parameters in the infra.config file.
    For more information about the     infra.config, and deployment.config files, see Configuration-file-settings. For more information about secrets.txt file, see Preparing-for-password-encryption.

    Important

    The utility only picks the values from the latest successful deployment of BMC Helix ITOM. We recommend that you to review the infra.config, deployment.config, and secrets.txt files files before starting the upgrade. 

  5. If you are upgrading from BMC Helix ITOM version 22.2.01 to 23.2.02, make sure that you set the value of the parameter PG_HOSTNAME as postgres-bmc-pg-ha-pool in the infra.config file. 
    23.2.02_DRRE3-3637.png


Where to go from here

Back to process

Complete the other prerequisites tasks listed on the Preparing-for-upgrade page.

Next task



 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*