If you already own your own mini router or are a developer wanting to integrate NutPile into your products, you can install our Outage Tracer Monitor (OTM) yourself.
Please be aware that we do not provide support for self installed hardware unless you are integrating it into your own products but do try to update these notes to help others along. We plan to eventually make available a social site which should allow members to share their findings and where we can help with questions being asked.
Supported operating systems, Linux and mini routers
Windows 7, 8 and 10
Linux Centos7, Debian7
OpenWrt ar71xx, ar9331, ramips
Mini routers, project and other embedded devices – Known to run on
Dragino: MS14N-S, MS14-P, PAN, LG01, LG02, OLG01, OLG02, LG08, PG08
Centos 7, Debian 7
Installing Software Agent
Note: Compiler used dated April 12th 2013. Agent should run on Linux versions of the same age or newer and possibly some older Linux versions. We have only tests and used on Centos7 and Debian7. Please contact us if you successfully run on unlisted versions so that we may update our list of supported devices.
Note: Credentials required to associate this agent with your account/reports. Sharing credentials or re-using them will corrupt your statistics. An API method will be offered in the future.
LINUX operating system
Please agree to the NutPile terms and conditions to reveal the required credentials and download link.
Click on the download link and save the program on your drive.
Change the file permissions to 755 making the program executable permission.
Create/edit a file in your /etc directory called agented (/etc/agented).
Enter the credential shown, no line spaces, one line each and save it.
Run your program by typing ./filename – the name of the file you saved and made executable.
No output is shown but if your agent is communicating, you’ll now see data in your dashboard.
The first thing you’ll see is the Heartbeat then Recent Events will begin to fill it
Agent can now be run manually or auto started using standard Linux methods.
Please be sure to check any virus scanner or firewalls which may be blocking agent communications. The agent does not require any special ports to communicate with the NutPile network.
Need to auto start the agent?
At this point, you can manually run the agent software but it will take up your console session unless you take this into account. For the best reports, keep the agent running non stop and will probably want to auto start the agent when your machine starts. If you need help, there are many Linux help sites on the Internet. However, you are also welcome to create an account in our forums (forums.nutpile.com) and post a question in the Platform support section.
Mini routers, arxxxx and ramips
The NutPile agent runs on a factory build or your own custom build. Note that LEDE is NOT supported at this time.
If you factory reset the router, simply re-install. Keep a note of this install.
SSH into or enable SSH on your factory router then log into the router.
There are five packages which need to be installed onto the router.
opkg install curl libpthread libstdcpp
opkg install otm_xxx.ipk (downloaded from your control panel)
NOTE: Replace ‘starter.sh’ for arxxxx devices or ‘starter_ramips.sh’ for ramips based devices
opkg install bash (If you will be using the above bash script to start the agent)
mv starter.sh /etc/
chmod 755 /etc/starter.sh
mv ca-certificates.crt /etc/ssl/certs/
Create a file called agentid in /etc/.
Edit /etc/agentid and add the credentials shown above in the same order, two lines, nothing else.
Add the following into /etc/rc.local, just above the exit 0 line; /bin/bash /etc/starter.sh
Chmod starter.sh to 755 to make it executable.
When you reboot your router, the rc.local file will start the ‘starter.sh’ script.
The starter.sh script then does the following.
-Checks to make sure we have networking and can reach the Internet.
-Downloads the agent binary software from our network and executes it. The binary is constantly being updated so downloading it each time the router starts ensures that the device is always running the newest version without user intervention.
-Monitors that the binary is always running and tries to prevent two copies from running at the same time. We will refine this in the near future so that this service can be started/stopped as a regular service.
Note: *MUST* set the router to UTC or local time zone otherwise, your reports will not have the correct date/time.
Once your router is restarted, it will begin communicating with the NutPile network.