You can set up agents to run as system services.
Before you begin
Install an agent.
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
For more information on modifying the /etc/inittab file, see https://www.ibm.com/support/knowledgecenter/en/ssw_aix_71/com.ibm.aix.osdevice/modetc.htm
Results
The agent runs as a service. To verify that the agent is running as a service, run the
following command and verify that two processes from the agent are
running:
ps -ef | grep installFolder
For
installFolder, specify the installation folder of the agent,
such as
/opt/ucd/agent.
What to do next
For information about the way that IBM AIX handles services, see
Starting and Stopping Software via RC Directories.