Upgrading

Overview

When upgrading your HCL Workload Automation environment, it is a good practice to start with the upgrade of the Dynamic Workload Console first. If you upgrade the console to the new product version level, you can then use it to verify that your environment is working after upgrading the remaining components.

In a direct upgrade procedure, you upgrade the Dynamic Workload Console, then upgrade the domain managers and their backups, the dynamic domain manager and its backups, then master domain manager and its backups and finally the agents.

In a parallel upgrade, you upgrade the Dynamic Workload Console (if your previous version was 9.5.0.x) or install the Dynamic Workload Console at v 10.1.0.x (if your previous version was 9.4.x). You then proceed to upgrading the backup domain managers and domain managers. You then upgrade the database tables for the dynamic domain manager and its backups and install a new backup dynamic domain manager, switch the manager to the new backup, install a new backup and switch back the manager capabilities, so that the newly installed backup dynamic domain manager becomes the current dynamic domain manager.

You then proceed to upgrading the master domain manager database tables and running the serverinst script to install a version 10.1.0.x master domain manager configured as a backup. The installation process is able to detect the presence of an existing master domain manager and automatically configures the second one as the backup master domain manager. The new backup master domain manager is configured to point to the existing database instance. You then perform a switch with the previous version master domain manager, so that the newly installed backup master domain manager becomes the current active master domain manager.

You then install a second master domain manager to act as the new backup master domain manager. Each Dynamic Workload Console, backup dynamic domain manager, dynamic domain manager, master domain manager and backup master domain manager installation requires its own installation of WebSphere Application Server Liberty Base. The upgrade process concludes with upgrading agents. Agents can be upgraded with minimal disruption to scheduling activities.

When upgrading, you can upgrade directly to the latest fix pack level, if available, by downloading the latest fix pack image, and launching one single command that automatically installs the latest product level. For more information, see Upgrading from the CLI.

Using the new features introduced with the latest release creates new records in the database which are not compatible with previous versions and therefore you cannot roll back your environment to a previous version.

If you upgrade HCL Workload Automation to version 10.1.0.x, and the HCL Workload Automation database was created with DB2, change the DB2 configuration parameter EXTENDED_ROW_SZ to ENABLE, or create a new buffer pool and table space with a page size of 16 kilobytes and migrate the tables to the new table space. For more information, see Error in upgrading the HCL Workload Automation database when using a DB2 database.

Before upgrading, ensure that you have stopped workload processing on the master domain manager.

Choosing how to upgrade your network

After upgrading the Dynamic Workload Console, there are different approaches to upgrading the remaining components in your HCL Workload Automation environment. Because HCL Workload Automation supports compatibility with earlier versions, after upgrading the console, you can decide to proceed with upgrading in one of the following ways, depending on the type of your network:

Top-down

Upgrade components in the following order:

1. backup domain managers and domain managers
2. dynamic domain managers
3. backup master domain manager
4. master domain manager
5. agents

This order ensures that events involving folders are correctly managed by the master domain manager and sent to agents at a supported version level.

When you have a backup master domain manager at the V9.5 Fix Pack 2, or later, but the master domain manager is still at a previous product version level, problems can occur when monitoring objects that support the definition in a folder such as, prompts, workstations, and resources, as well as objects that contain the workstation in their object identifier, for example, job streams. More specifically these objects are not displayed in the results of the monitoring query on the plan if you use filters in your query. To solve this problem, upgrade the master domain manager to the V9.5 Fix Pack 2 level, or later, and then run planman resynch.

Many of the new functions that are introduced in the current version become available for each agent as it is upgraded. The disadvantage is that the same functions are not available to all agents at the same time.

Bottom-up

Upgrade components in the following order:

1. agents
2. backup domain managers and domain managers
3. dynamic domain managers
4. backup master domain manager
5. master domain manager

The new functions that are introduced in the current version are not available until the whole network is upgraded.

..............
logon=MYDOMAIN\\user1
...............