Nagios does not come deployed with the virtual box environment provided. However, installing it is very straightforward and can be done quickly. The resources required by Hyperglance to integrate with Nagios are actually on the virtual machine, just not in the place where Hyperglance expects to find them. This was done to avoid having Nagios integrated with Hyperglance unless specific need for it was established. Here are the steps to take to enable Nagios integrations with Hyperglance.
Step 1. Open a SSH remote connection to the VM
There are many different ways to do this, depending on the OS your working from for instance. We will provide a basic example, nevertheless the user is welcome to adapt our approach to particular technological needs.
Assuming a windows environment, Putty can be used to open an SSH connection by just providing it the IP address of the VM, the same one that the VM prints out when it boots. For example:
Enter the same log in credentials as the ones you have for your VM, or ones that have administrative control over the it.
Step 2. Move the NagiosRefinementCollector.ear file to where Hyperglance can use it
The file should be located at the folder you land in when you open a putty connection to the VM, namely '/home/hyperglance'. The detailed steps ares:
It should be moved to '/opt/wildfly/standalone/deployments/collector-plugins/'.
- sudo mv NagiosRefinementCollector.ear/ /opt/wildfly/standalone/deployments/collector-plugins/
After the move is successful the wildfly service has to be restarted
- sudo service wildfly restart
In the Hyperglance Admin Panel https://IP_address:8443/#/admin , select the 'Nagios' Collector under the 'Collectors' section. Click on 'Add Record' button which brings up a pop up with the necessary fields (shown below).
In order to get started we need certain information to allow Hyperglance to connect into Nagios:
1. Nagios IP
The IP of the Nagios API service
2. Nagios Port
The Port of the Nagios API service
The credentials introduced are simply used by Hyperglance to connect to the Nagios API. No authentication credentials are provided as the Nagios API we are using does not provide any authentication mechanism. Instead the user is recommended to place IP Table entries to limit who and what can access the API.
After the credentials are entered and validated, Nagios is integrated with Hyperglance.