Linux Agent Install – the brief version

  1. Click on the download link (below) to download the latest Linux monitoring agent, saving it somewhere on your drive. We suggest /usr/local/bin but you can save it anywhere you like.
  2. Unzip the file extracting ‘nutpile_agent_linux’. Make sure it has executable permissions, 755.
  3. Create a file in your /etc directory called agentid (/etc/agentid).
    Edit this file and enter the Username and Password shown below,
    Username on the first line and Password on the second line. Nothing else.

usernamexxx
passwordxxx

  1. Start the agent from the console ./nutpile_agent_linux (use a cron job if you prefer to auto run this on bootup)
  2. Log into your NutPile control panel, pick the agent you are installing then click on the pings graph.
  3. Wait several minutes and refresh the pings graph until you see data being displayed.

Once you see pings data coming in, the installation is complete.

About the Linux agent

 

Note: Known to run on Centos7, Debian7, etc.

In order to support most newer Linux operating systems, the compiler used is dated April 12th 2013. The agent should run on all Linux versions the same age or newer and probably a few older ones but at this time, we cannot confirm which.

Note that the Username and Password for your agent given below allows it to be associated with your account. Sharing these agent credentials with any other agent will corrupt your statistics therefore, do not share this with anyone else.

 

Console vs Auto Start

At this point, you can manually run the agent software, but it will take up your console session unless you run it as its own process. You will probably want to auto start the agent when your machine starts.


Examples

On Linux Centos 7, the service would look something like the following:

[Unit]
Description=nutpile monitoring agent

[Service]
ExecStart=/usr/local/bin/nutpile_agent_linux
ExecStop=/usr/local/bin/nutpile_agent_linux

[Install]
WantedBy=multi-user.target

On Debian7, the service would look something like the following:

#!/bin/sh
### BEGIN INIT INFO
# Provides: nutpile
# Required-Start: $network
# Required-Stop: $network
# Default-Start: 2 3 5
# Description: nutpile monitoring agent
### END INIT INFO

case "$1" in
'start')
	/usr/local/bin/nutpile_agent_linux
	;;
'stop')
	/usr/local/bin/nutpile_agent_linux
	;;
*)
	echo "Usage: $0 { start | stop }"
	;;
esac
exit 0


You will have to search the Internet to find out how you can add an auto start service for your particular operating system flavor. There are countless resources on the Internet which show and explain how this can be done. If you cannot do it yourself, there are usually Linux experts in your community which can help.

You want to create a new service called nutpile.
You want the service to run using root.
You want the path to the program to be /usr/local/bin/nutpile_agent_linux (or where ever you put the program).
You want to auto start the program upon bootup.

By adding this service, you will be able to start/stop and restart the agent automatically.

Confirm communications

If you are installing the agent where you have a PC, simply log into your NutPile control panel, go to your new agent reports page and click on the Pings graph. Within a few minutes of installing your agent, you will begin to see the pings graph populate with data.

If you are out in the field or at a remote location, then all you need is a mobile phone or tablet. Again, log into your NutPile control panel, pick the agent that you are installing and click on the pings graph. Within minutes, you can confirm that the agent is communicating when you see ping data starting to populate the graph. At this point, you are done.

Pin It on Pinterest

Shares