Performing a direct upgrade of the Dynamic Workload Console and its database

Perform a direct upgrade of the Dynamic Workload Console from version 9.5.0.x to version 10.1.0.x. If you have several Dynamic Workload Console nodes in a cluster, upgrade all the nodes in the cluster.

About this task

When updating the HCL Workload Automation environment, it is a good practice to update the Dynamic Workload Console first. If you update the console, you can then use it to verify that your environment is working after updating the remaining components.

Procedure

  1. Log in to the workstation where you plan to install the Dynamic Workload Console.
  2. Download the installation images from HCL License Portal.
  3. Browse to the folder image_location.
  4. If possible, stop all Dynamic Workload Console instances.
    If this is not possible, launch the configureDB script at a time when the Dynamic Workload Console is processing a low workload. If the configureDB script should fail because of conflicts with the Dynamic Workload Console, restart the script.
  5. Define an environment variable with name JKS_SSL_PASSWORD and set it to the password you defined when creating the certificates. You can optionally encrypt the password using the secure script. For more information about the secure script, see Optional password encryption - secure script.
  6. To update the database version, run the following command:
    On Windows operating systems
    cscript configureDb.vbs --rdbmstype db_type --dbhostname db_hostname --dbport db_port --dbname db_name --dbuser db_user --dbpassword db_password --dbadminuser db_administrator --dbadminuserpw db_administrator_password
    On UNIX operating systems
    ./configureDb.sh --rdbmstype db_type --dbhostname db_hostname --dbport db_port --dbname db_name --dbuser db_user --dbpassword db_password --dbadminuser db_administrator --dbadminuserpw db_administrator_password
    On z/OS operating systems
    ./configureDb.sh --rdbmstype db_type --dbhostname DB_hostname
    --dbport db_port --dbname db_name --dbuser db_user
    --dbadminuser DB_admin_user --dbadminuserpw DB_admin_pwd
    --zlocationname zOS_location_containing_db --zbufferpoolname buffer_pool_in_zOS_location
    For more information about all parameters and supported values of the configureDb command, see Database configuration - configureDB script.
  7. Start the upgrade by launching the following command:
    On Windows operating systems
    cscript dwcinst.vbs --acceptlicense yes --inst_dir INST_DIR
    On UNIX operating systems
    ./dwcinst.sh --acceptlicense yes --inst_dir INST_DIR
    On z/OS operating systems
    ./dwcinst.sh --acceptlicense yes --inst_dir INST_DIR

    For further details about commands, see Reference.

What to do next

You have now successfully upgraded the Dynamic Workload Console. You can now proceed to upgrade domain managers using the procedure described in Upgrading agents and domain managers.