Running agents as services on IBM® AIX®
You can set up agents to run as system services.
Before you begin
Procedure
-
Change the owner of the agent installation folder to the user that runs the agent.
For example, if the user
ucdagent
run the agent and the agent installation folder is /opt/ucd/agent, run the following command:chown -R ucdagent /opt/ucd/agent/
You can find the user that runs the agent by looking at the USER property on the agent. -
Similarly, change the group of the agent installation folder to the group that is associated
with the user.
For example, if the agent is installed in the folder /opt/ucd/agent, run the following command:
chgrp -R ucdagent /opt/ucd/agent/
-
Make a copy of the file agent-install/bin/init/agent,
where agent-install is the installation folder of the agent.
If you are running multiple agents on the system, give the file a unique name, such as ucdagent-A.
-
In a text editor, edit the file:
- Set the property AGENT_USER to the name of the user that runs the agent.
- Set the property AGENT_GROUP to the name of the group that is associated with that user.
- Set the property SCRIPT to the location of the agent executable file. The default location is /opt/ucd/agent/bin/agent.
The file might look like the following example:AGENT_HOME="/opt/ucd/agent" AGENT_USER="ucdagent" AGENT_GROUP="ucdagent" # == END INSTALL MODIFICATIONS =================== ANT_HOME="$AGENT_HOME/opt/apache-ant-1.8.4" GROOVY_HOME="$AGENT_HOME/opt/groovy-1.8.8" SCRIPT="/opt/ucd/agent/bin/agent"
-
Configure the agent to run when the system starts.
The steps depend on how your IBM® AIX® system manages services.For example, for IBM® AIX® systems that use
init.d
, follow these steps:- Copy the file to the folder /etc/rc.d/init.d/.
- Add the file to run level 2. For example, if the file is named ucdagent,
run the following
command:
ln -s /etc/rc.d/init.d/ibm-ucdagent /etc/rc.d/rc2.d/S98ucdagent
Results
ps -ef | grep installFolder
For
installFolder
, specify the installation folder of the agent,
such as /opt/ucd/agent.