...

If an Agent should no longer be used, then it can be taken out of operation. This is a process that is not limited to deleting an Agent but requires taking a few prerequisite steps for decommissioning the Agent.

The JS7 Controller keeps track of a consistent inventory of scheduling objects such as Workflows:

• If an Agent should be deleted that is assigned a Job in an existing a deployed Workflow, then the Controller will deny deletion of the Agent as otherwise Workflows would will become inconsistent.
• If Orders exists are submitted for a deployed Workflow, then the Controller will deny removal of the related Workflow as otherwise Orders would will become inconsistent.
• An Agent can be deleted only after no Workflows and no File Order Sources referencing the Agent are available with the Controller.

Taking

...

a running Agent out of Operation

The operation to take an Agent out of operation includes to cleanup references to the Agent from existing scheduling objectsdeployed Workflows and File Order Sources.

• Cleanup is performed while the Agent is running and is connected to the Controller.
• Deletion of the Agent from the Controller and optionally from the inventory is performed after cleanup.

Cleaning up Agent References

Agents can be deleted

...

if they are not assigned to any Jobs in deployed Workflows and to any deployed File Order Sources

...

.

How to identify Agent References

The Workflows view offers to filter workflows Workflows by Agents:

• In the left panel the tree view offers the (chevron down) icon at folder level that will display all workflows Workflows of the current folder and of any sub-folders recursively in the right panel.
• The right panel offers
  • the Agents
  filter
  • button that allows to select one or more Agents
  for which workflows are displayed.
  • for filtering of Workflows displayed.
  • the Order Filter button that allows to select the All option to display any orders for future start times assigned the Workflows displayed. The first line of the right panel displays related orders per state and offers JS7 - Orders - Bulk Operations.
    
    

How to bulk update Agent References

Users can apply the Search & Replace operation for Agent assignments assignment at workflow Workflow level that is available in the JS7 - Workflow Editor.

• When displaying the workflow Workflow in the Inventory sub-view, the Search & Replace operation is offered from the right upper corner of the view.
• The operation allows to select one or more Agents that should be replaced.
• The operation expects an Agent to be selected that acts as the a replacement.
  
  

Users can apply the JS7 - Inventory Search function operation to replace Agent assignments across workflowsWorkflows:

• Search for the return type: workflowsWorkflows
• Open the Advanced search criteria and select the Agent that should be replaced across workflowsWorkflows.
  • Optionally specify one or more folders where to look up workflowsWorkflows.
  • Optionally specify that deployed/released objects only should be considered.
• Hit the Search button to get the list of resulting workflows Workflows that reference the Agent.
  
  

The list of resulting workflows Workflows can look like this:

• Select desired workflows Workflows from the result lisltlist.
  
  

When hitting the Update Job button, a popup window is will be displayed that allows to specify values that will be updated in all jobs Jobs of the selected workflowsWorkflows:

• Select the Standalone Agent or Subagent Cluster that should act as a replacement.
• Consider that the checkbox rigth right to the Agent selection has to be checked to activate the replacement.
  
  

...

Users first should check if orders Orders are assigned existing versions of Workflows and File Order Sources. Such orders should be completed or should be cancelled as they prevent deletion of old current versions of Workflows and File Order Sources from the Controller.

...

• Each Agent's action menu offers the operation to delete and to revoke operation the Agent. A number of Agents can be selected for the bulk operation operations to delete/revoking an Agentrevoke Agents.
• If the Agent is deleted, then it will be removed from the Controller and from the inventory.
• If the Agent is revoked, then it will be removed from the Controller and will remain in the inventory in undeployed status.

Taking an uninstalled Agent out of Operation

Users should avoid this scenarion and should take Agents out of operation while they are running.

If users first did uninstall an Agent that they want to delete from the inventory later on, then they can follow the instructions available from the JS7 - How to remove an Agent or an Order from the Journal article.

Resources

• JS7 - How to remove an Agent or an Order from the Journal
• JS7 - Orders - Bulk Operations