Opsview - Infrastructure Agent - Custom *nix installations

This page covers the installation of source code compiled agents based on "Infrastructure Agent" - this is for additional operating systems not included as part of the normal pre-packaged agent release.

Agent tarball files may be downloaded from the Support Repository 

General Steps

See also any specific steps below for the OS

1. Download the relevant agent tarball from the Support Repository and transfer to the server to be monitored
2. As root, create the agent directory

   mkdir /opt/itrs  

3. Extract the agent into the directory
   

   tar -zxf infrastructure-agent_xxxxxx.tar.gz -C /opt/itrs/

4. Configure the agent as per the Linux Package steps
5. Start the agent manually to ensure it is configured correctly
   

   /opt/itrs/infrastructure-agent/bin/python3 /opt/itrs/infrastructure-agent/infrastructure-agent

Specific Steps

Ubuntu 22.04, RHEL9 and OL9

1. After following the "General Steps", install the SystemD configuration
   

   cp /opt/itrs/infrastructure-agent/installer/infrastructure-agent.service /etc/systemd/system/infrastructure-agent.service

2. Enable and start the service
   

   /bin/systemctl enable infrastructure-agent
   /bin/systemctl restart infrastructure-agent

3. Verify the services has started correctly
   

   /bin/systemctl status infrastructure-agent

4. If the service is not working, check the logs and remediate as necessary
   

   journalctl -fu infrastructure-agent

5. Configure the server in the Opsview UI as normal

AIX 7.1

Python 3.9

The Infrastructure Agent relies on Python 3.9 being available on the server.  This can be installed via the IBM AIX Toolbox by running these steps as the "root" user:

1. Download the AIX Toolbox setup script
   

   curl -o /tmp/dnf_aixtoolbox.sh https://public.dhe.ibm.com/aix/freeSoftware/aixtoolbox/ezinstall/ppc/dnf_aixtoolbox.sh

2. Run the setup script
   

   sh ./dnf_aixtoolbox.sh -y

3. Install the package
   

   dnf install -y python3.9

Python 3.9 will now be available at "/opt/freeware/bin/python3.9"

NOTE: if you receive error message about libcrypto.a missing or out of date, you may need to upgrade your OpenSSL and OpenSSH packages by following the steps on https://www.ibm.com/support/pages/node/720655 

Infrastructure Agent

1. After following the "General Steps", create the infrastructure agent subsystem 
   

   mkssys -s infrastructure-agent -u root -Q -R -S -n 15 -f 9 \
       -p /opt/itrs/infrastructure-agent/bin/python \
       -a /opt/itrs/infrastructure-agent/infrastructure-agent \
       -e /opt/itrs/infrastructure-agent/var/infrastructure-agent.log \
       -o /opt/itrs/infrastructure-agent/var/infrastructure-agent.log

2. Enable and start the infrastructure agent subsystem
   

   startsrc -s infrastructure-agent 

3. Configure the server in the Opsview UI as normal

Further Information

Documentation for Infrastructure Agent is available here