Skip to content

Latest commit

 

History

History
81 lines (56 loc) · 2.99 KB

INSTALL.md

File metadata and controls

81 lines (56 loc) · 2.99 KB
Raw

Installation

Updating from v1.6.x to v2.0.0?

See here a detailed guide of all the changes made and what actions are necessary for version migration!

Configuration

The first step in using the Nagmap Reborn is to configure the Latitude and Longitude of the hosts, which will be used to represent them on the map.

This information needs to be placed in a specific field, the 'notes' field/line, depending on the monitoring system you are using, which can be via the interface or directly editing the configuration files.

This definition must be made through the tag:

<latlng></latlng>

Which must contain the latitude and longitude separated by commas (,):

<latlng>LATITUDE,LONGITUDE</latlng>

The 'notes' field for host definition needs to match the following example:

<latlng>66.174082,-13.119136</latlng>

If you are editing configuration files by hand this is how the FULL notes line should look like:

  notes       <latlng>66.174082,-13.119136</latlng>

If you use the notes field to display other information, you can make this definition as a line comment:

  notes    OTHER STUFF   #<latlng>66.174082,-13.119136</latlng>

You can get the precise coordinates from OSM.

  • Right click on the spot where your device is located and select option "Show Addres".

  • The coordinates will be set in maps search bar.

To draw connections, hosts need to have 'parents' field set up.

Apache / Nagmap Reborn setup

Your webserver (e.g. Apache) needs to have PHP support enabled! Please make sure your PHP is version 5.3 and above :) (see phpinfo() php function) yum install php-mbstring

  1. copy the Nagmap Reborn directory into your Apache web folder (/var/www/ on Debian/Ubuntu, or /var/www/html/ on RedHat/CentOS);

  2. copy config.php.example into config.php and to fit your needs;

  3. Make sure the application has read and write permission in ./cache;

  4. Open the website of Nagmap Reborn installation (e.g. open Firefox - point to YOUR_IP/nagmapReborn);

Dependencies

The only dependencies of Nagmap Reborn are PHP extensions/modules, make sure they are installed:

  • json.
  • mbstring.

JS Compability

Since v2.0.0 of the Nagmap Reborn, features of ES6 (ECMAScript 2015) are used, so it is only possible to use the project in modern browsers.

The following is the minimum supported version relationship:

Browser Min. version
Chrome 58
Firefox 54
Edge 14
Safari 10
Opera 55
Internet Explorer Does not support

* You can see the full list here.

For compatibility with legacy browsers, use an previous version (1.6.4) of the project.

Support

You can see here the Wiki / FAQ of Nagmap Reborn. You'll find tutorials and answers to common questions!