HCL Workload Automation, Version 9.4

switchmgr

Switches domain management from the current domain manager to a backup domain manager.

You must have start and stop access to the backup domain manager.

The switchmgr command must only be used as part of specific procedures for switching domain management capabilities from a domain manager to its backup domain manager either permanently or temporarily. For information about these procedures, refer to the HCL Workload Automation: Administration Guide.

Syntax

{switchmgr | switchm} domain;newmgr

Arguments

domain
Specifies the domain in which you want to switch managers.
newmgr
Specifies the name of the new domain manager. This must be a workstation in the same domain, and should be defined beforehand as a fault-tolerant agent with Resolve Dependencies and Full Status enabled.

Comments

The command stops a specified workstation and restarts it as the domain manager. All domain member workstations are informed of the switch, and the old domain manager is converted to a fault-tolerant agent in the domain.

The next time JnextPlan is run on the old domain manager, the domain acts as though another switchmgr command had been run and the old domain manager automatically resumes domain management responsibilities.

Fault-tolerant agents defined with securitylevel = on might fail to use the SSL port to connect to the new master domain manager after the switchmgr command is run. In this case do either of the following to let the agent start correctly:
  • Unlink and then link the agent from the new master domain manager.
  • Use the securitylevel = force option on the agent.

Examples

To switch the domain manager to workstation orca in the masterdm domain, run the following command:
switchmgr masterdm;orca 
To switch the domain manager to workstation ruby in the bldg2 domain, run the following command:
switchmgr bldg2;ruby 

See also

From the Dynamic Workload Console you can perform the same task as follows:
  1. In the navigation bar at the top, click System Status and Health > Workload Monitoring > Monitor Workload.
  2. Select an engine.
  3. In Object Type, select Workstation.
  4. From the Query drop-down list, select a query to monitor workstations.
  5. Click Run to run the monitoring task.
  6. From the table containing the list of workstations, select a workstation and click More Actions > Become Master Domain Manager.