Introduction

The Agent ID is a unique identifier for a Standalone Agent, Agent Cluster, Director Agent or Subagent.

The identifier is specified during installation and cannot be modified. Therefore the procedure to modify the Agent ID for an existing installation implies a number of steps.

Modifying Agent ID

Prerequisites

Check that no jobs are running with the related Agent. Orders should be completed, workflows will not pick up from a given job step when applying the procedure.

Consider that the configuration of Subagent Clusters will be affected if the Agent ID of a Director Agent or Subagent will be modified.

JOC Cockpit

Navigate to the Manage Controllers/Agents page:

• Delete the existing Agent configuration.
  • This applies to Standalone Agents.
  • Should an Agent Cluster ID be modified then the Agent Cluster has to be deleted. This will delete any included Director Agents and Subagents.
  • Should a Director Agent ID be modified then the Director Agent has to be deleted. This includes to delete both instances of a Director Agent in an Agent Cluster. Subagents can remain in place.
  • Should a Subagent ID be modified then just the Subagent has to be deleted.
• Add a Standalone Agent and/or Cluster Agent holding the modified ID as explained with chapter Initial Operation of the following articles:
  • JS7 - Initial Operation for Standalone Controller
  • JS7 - Initial Operation for Controller Cluster
  • Find details from JS7 - Management of Agent Clusters
• Deploy the Agent using the Deploy operation of the related Agent's action menu.
• Initialize the Agent using the Reset Forced operation of the related Agent's action menu.
  • This will force the Agent to restart and to drop its journal in the related <agent-data>/state directory.
    • If the operation is applied to a Director Agent then this will automatically initialize any Subagents of the Agent Cluster.
  • It can take the Controller approx. 60-120s to reconnect to the Agent.
    • The Controller will automatically deploy scheduling objects to the Agent.
    • The Controller will automatically submit orders to the Agent.

If an Agent Cluster is used then in the Manage Controllers/Agents page navigate to the Agent Cluster's Subagent Cluster, see Manage Subagent Cluster.

• If the Agent ID of a Director Agent is modified then the Subagent Cluster has to be re-created.
• If the Agent ID of a Subagent is modified then the Subagent Cluster remains in place but the Subagent holding the previous Subagent ID is removed and the Subagent holding the new Subagent ID has to be added.