Centralized agent update by using Dynamic Workload Console

You can centrally update multiple fault-tolerant agent and dynamic agent instances with just one single action by using Dynamic Workload Console.

Before you begin

In the master domain manager Security file, you must have manage authorization for all the agent workstations for TWS_master_user, root, or Administrator users. If your master domain manager is a version 9.3.0 or later fresh installation, the authorization role is automatically added to the Security file. If your master domain manager is an upgraded version 9.3.0 or later instance, you must manually add the authorization.

For more information about the manage keyword usage, see Object type - cpu. For an example of a master domain manager Security file, see Security file on the master domain manager to install fix packs or upgrade fault-tolerant agents and dynamic agents.

Note: From an HCL Workload Automation master domain manager version 9.3.0 or later, you can centrally update only instances of fault-tolerant agent version 9.3.0 or later and dynamic agent version 9.3.0 or later.

About this task

Complete the following steps:
  1. From the installation package download site, download on the master domain manager workstation the fix pack or upgrade installation package that you want to install on fault-tolerant agent or dynamic agent instances in the following default directory:
    On Windows operating systems:
    <TWA_home>\TWS\depot\agent
    On UNIX operating systems:
    <TWA_home>/TWS/depot/agent
    where TWA_home is the master domain manager installation directory.
    You can change the default directory value performing the following steps:
    • Stop WebSphere Application Server Liberty Base on the master domain manager
    • Modify the com.ibm.tws.conn.engine.depot key value in the following property file:
      On Windows operating systems:
      TWA_home>\usr\servers\engineServer\resources\properties\TWSConfig.properties
      On UNIX operating systems:
      TWA_home>/usr/servers/engineServer/resources/properties/TWSConfig.properties
    • Start WebSphere Application Server Liberty Base

    Ensure the installation files are readable by the operating system user which owns the Application Server process (java).

  2. Log on to Dynamic Workload Console.
  3. Create a Monitor Workstations task, as described in Creating a task to Monitor Workstations.
  4. Run a Monitor Workstations task and select one or more dynamic agent or fault-tolerant agent instances that you want to update.
  5. Click More Actions > Update agent. The Update agent action checks whether the selected agent is a supported workstation type.
    The Update agent action is applicable to the following workstation types only:
    • Dynamic Agent
    • Fault-tolerant agent
    The Update agent action is not applicable to the following workstation types:
    • Master domain manager
    • Backup master domain manager
    • Dynamic domain manager
    • Backup dynamic domain manager
    • Extended agent
    • Standard agent
    • Remote engine
    • Broker
    • Pool
    • Dynamic pool
    • Limited fault-tolerant agent
    The process updates the agent only if the workstation type is supported. Otherwise, either an error message is displayed on the Dynamic Workload Console, or is written in the operator log messages console, depending on the workstation type.

    You can schedule the centralized update of multiple agent instances, by using the Dynamic Workload Console or the command line. For a description of the scheduling option, see: Scheduling the centralized agent update.

    For a description of the Update agent action on fault-tolerant agents and dynamic agents, see: Updating fault-tolerant agent and dynamic agent instances.

Results

Verify the update agent results by completing one of the following actions in the Dynamic Workload Console:
Check the operator log messages console:
Click Monitoring and Reporting > Event Monitoring > Monitor Triggered Actions and check the messages related to the agent workstation update.
The following event rules are triggered:
UPDATESUCCESS
When the workstation is successfully updated
UPDATEFAILURE
When an error occurs
UPDATERUNNING
With the information about the update process status
Check the workstation version changes:
After the next plan update, in the Monitor Workstations view of the Dynamic Workload Console, you can check the updated version in the Version column of the selected agent. Otherwise, if you do not want to wait for the next plan update to see the updated version, run the command JnextPlan -for 0000 with the -noremove option.
You can also perform a manual check of the update agent results by looking at the following log files on the agent system:
On Windows operating systems:
<TWA_home>\logs\centralized_update.log
On UNIX operating systems:
<TWA_home>/logs/centralized_update.log