Stop Agent

The Stop Agent service in the IBM® Security Guardium® Key Lifecycle Manager Multi-Master cluster is used to stop the monitoring agent.

The stopped agent restarts automatically when the Agent Invoker service is run.

Location of the stopAgent script file

The stopAgent script file is in the SKLM_INSTALL_HOME\agent directory. For example,
Windows
C:\Program Files\IBM\SKLMV41\agent\stopAgent.bat
Linux®
/opt/IBM/SKLMV41/agent/stopAgent.sh

Stopping the agent service

Run the following command:
Windows
stopAgent.bat WAS_HOME
stopAgent.bat "C:\Program Files\IBM\WebSphere\AppServer"
Linux
./stopAgent.sh WAS_HOME
./stopAgent.sh /opt/IBM/WebSphere/AppServer

Stopping the agent permanently

You can stop an agent permanently. When stopped permanently, the agent does not restart automatically when the Agent Invoker service runs.

To stop the agent permanently:
  1. In the SKLMConfig.properties file, update the stopAgentInvocation property value to true. 
    stopAgentInvocation=true
  2. Stop the agent. See the Stopping the agent permanently section.
Note: Do not stop the agent permanently on a Multi-Master setup. You can do so on a standalone IBM Security Guardium Key Lifecycle Manager server or a replication setup.
To start an agent that was permanently stopped:
  1. In the SKLMConfig.properties file, update the value of the stopAgentInvocation property to false. 
    stopAgentInvocation=false
    You can use the tklmConfigUpdateEntry CLI command or the Update Config Property REST Service to update the SKLMConfig.properties file.
  2. Restart the WebSphere® Application Server.