Agent Starter

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

When the agent in a IBM Security Guardium Key Lifecycle Manager master is down, the Agent Invoker service runs the Agent Starter script, startAgent to restart the service. The agentStarter.properties file contains the necessary information to run the script.

Location of the script and the properties file

The startAgent script and the agentStarter.properties file are in the SKLM_INSTALL_HOME\agent directory. For example,
Windows
C:\Program Files\IBM\GKLMV42\agent\startAgent.bat
C:\Program Files\IBM\GKLMV42\agent\agentStarter.properties
Linux®
/opt/IBM/GKLMV42/agent/startAgent.sh
/opt/IBM/GKLMV42/agent/agentStarter.properties

Starting the agent service

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

Sample Agent Starter properties file

SELF_DB_PASSWORD=75927941B378990404B33FBD35D3A433
PRIMARY_IP_HOSTNAME=civ3cez161
SERVICE=PortMonitoring,AgentMonitoring,TakeOverService
SELF_IP_HOSTNAME=civ3cez161
SELF_SSL_PORT=1441
SELF_DB_NAME=KLMDB42
SELF_INSTANCE_ID=f39dba2
SELF_AGENT_PORT=60015
PRIMARY_DB_PORT=50090
PRIMARY_DB_IP=civ3cez161
SELF_NAME=f39dba2
SELF_SKLM_PASSWORD=A965C364C4DC71657A2A5B1013690045
STANDBY_INSTANCE_COUNT=0
PRIMARY_DB_PASSWORD=75927941B378990404B33FBD35D3A433
SELF_OWNER_EMAIL_ADDR2=
SELF_HTTP_PORT=9443
SELF_OWNER_EMAIL_ADDR1=
SELF_SKLM_USERNAME=SKLMAdmin
SELF_HADR_TYPE=1
SELF_DB_PORT=50090
SELF_KEYSTORE_PASSWORD=EDB95C175FCC69347674702DB9C366BC
PRIMARY_DB_USERNAME=KLMDB42
SELF_DB_USERNAME=KLMDB42
SELF_DB_IP=civ3cez161
SELF_KMIP_PORT=5696
SELF_TCP_PORT=3801
PRIMARY_AGENT_PORT=60015
SELF_HADR_PORT=60030
NODE_INSTANCE_COUNT=0
PRIMARY_DB_NAME=klmdb42
PRIMARY_HADR_PORT=60030
SELF_CLUSTER_NAME=multimaster

Possible values for the SERVICE parameter are PortMonitoring, AgentMonitoring, TakeOverService, or DataSynchronizeService.