HCL Workload Automation, Version 9.4

Enabling dynamic scheduling after installation

This section describes the procedure that you must follow to enable dynamic scheduling if you upgrade the product, both the master and the agent, without enabling the dynamic scheduling capabilities. For example, you upgraded the product in the following ways:
Using the installation wizard
You did not select one or both of the following options:
  • Enable the dynamic scheduling capabilities, when upgrading the master
  • Dynamic agent, when upgrading the agent.
Using twsinst, when upgrading the agent
You did not specify the -tdwbport tdwbport_number and -tdwbhostname host_name.
To enable dynamic scheduling, perform the following steps:
  1. In the tws_home/TDWB/config/BrokerWorkstation.properties file, modify the values of the following properties according to the values that you specified at upgrade time:
    Broker.Workstation.Name= workstation_name_DWB
    Broker.Workstation.Port= port_number
    MasterDomainManager.HostName= host_name
    MasterDomainManager.Name= workstation_name
    Broker.AuthorizedCNs=server1; ... ;servern
    where:
    Broker.Workstation.Name=workstation_name_DWB
    It is the master domain manager workstation name followed by _DWB. You can modify this value including the _DWB suffix.
    Broker.Workstation.Port=port_number
    It is the port on the workload broker workstation used by the HCL Workload Automation master domain manager to communicate with dynamic workload broker. You can specify any value. The default value is 41114 if the Netman port number is 31111. The valid range is from 1 to 65535. If you changed the Netman port number, the Broker.Workstation.Port port_number is calculated as:
    netman_port_number+10003
    MasterDomainManager.HostName=host_name
    It is the fully qualified host name on which the master domain manager will be contacted by the agents.
    MasterDomainManager.Name=workstation_name
    It is the master domain manager workstation name.
    Broker.AuthorizedCNs=server1; ... ;servern
    It is the list of prefixes of common names included in the master domain manager certificates authorized to communicate with the broker server. For more information about authorizing the connection to the server, see sections Customizing the SSL connection to the master domain manager and dynamic domain manager section in the HCL Workload Automation: Administration Guide.
  2. On the master domain manager, verify the current value of the httpsPort by running the showHostProperties wastool. The default value is 31116. The following is an example output:
    ################################################################
    # Ports Configuration Panel
    ################################################################
    bootPort=31117
    bootHost=nynewhost.romelab.myorg.it.com
    soapPort=31118
    soapHost=mynewhost.romelab.it.myorg.com
    httpPort=31115
    httpHost=*
    httpsPort=31116
    ............
  3. On the master domain manager and on every agent that is connected to the workload broker server, update the JobManager.ini configuration file located under:
    • On Windows operating systems:
      tws_home\TWS\ITA\cpa\config\JobManager.ini
    • On UNIX and Linux operating systems:
      tws_home/TWS/ITA/cpa/config/JobManager.ini
    by assigning to the tdwb_hostname and tdwb_httpsport variables contained in the ResourceAdvisorUrl property, the following values:
    tdwb_hostname
    Specify the fully qualified host name of the workload broker server
    tdwb_httpsport
    Specify the value that the httpsPort has on the master domain manager as shown by the showHostPorperties wastool. The default is 31116, which is the dynamic workload broker port number. The port is currently set to zero because at installation time you specified that you would not use the dynamic workload broker.
    The ResourceAdvisorUrl property has the following syntax:
    ResourceAdvisorUrl = https://<tdwb_hostname>:<tdwb_httpsport>
    /JobManagerRESTWeb/JobScheduler/resource
  4. Start the dynamic workload broker component by running the startBrokerApplication.sh wastool as follows:
    /<TWS_home>/wastools/startBrokerApplication.sh -user user_name
    -password password 
    where:
    user_name
    Specifies the name of the WebSphere® Application Server.
    password
    Specifies the password of the WebSphere Application Server.
  5. On the master domain manager and on every agent of your network that you want to connect to the workload broker server, start the HCL Workload Automation agent by running the following command from the TWS_home directory:
    • On Windows operating systems:
      StartUpLwa.cmd
    • On UNIX and Linux operating systems:
      StartUpLwa
This is an example of BrokerWorkstation.properties file.
# --------------------------------
# Broker Workstation Configuration
# --------------------------------

# This file can be used to configure the local Dynamic Workload Broker Workstation.
# Jobs submitted or scheduled on this workstation are routed to TWS agents 
# according to available resources.  
#---------------------------------

# Use this switch to enable or disable the Dynamic Workload Broker Workstation
Broker.Workstation.Enable=true

# Name of the Dynamic Workload Broker Workstation in the TWS production plan
Broker.Workstation.Name=NC926121_DWB

# Port on which the Dynamic Workload Broker Workstation listens (equivalent to 
# Netman port)
Broker.Workstation.Port=41114

# Seconds between following attempts to link the Dynamic Workload Broker 
# Workstation
Broker.Workstation.RetryLink=600

# Name of the Master Domain Manager Workstation
MasterDomainManager.Name=NC926121

# Name of the Master Domain Manager Host Name
MasterDomainManager.HostName=localhost

# HTTPS Port on which the Master Domain Manager listens
MasterDomainManager.HttpsPort=31116

# Cpu Type of the Dynamic Workload Broker Workstation
Broker.Workstation.CpuType=MDM

Broker.AuthorizedCNs=Server;ServerNew

# Domain of the Domain Manager Workstation
DomainManager.Workstation.Domain=MASTERDM

# Name of the Domain Manager Workstation in the TWS production plan
DomainManager.Workstation.Name=NC926121

# Port on which the Domain Manager Workstation listens (equivalent to Netman 
# port)
DomainManager.Workstation.Port=31111

# Name of the Dynamic Master Domain Manager Host Name
DomainManager.Workstation.Address=nc926121.romelab.it.myorg.com

# Name of the Dynamic Master Domain Manager OS Type
DomainManager.Workstation.OS=UNIX