NINO

NINO is a network management solution. It runs on a web server and can 
monitor your network traffic, status, SNMP traps, send e-mail notification
and more. NINO is web based and easy to use.

Installation notes:

Before you proceed, please make sure that the next software is installed before 
installing NINO:

Apache web server
Apache mod_perl module (if not available, just run cgi)
MySQL client and server
Perl 5.6 or higher
Perl MySQL DBD/DBI libraries
Perl SNMP libraries


The NINO package contains the NINO Perl scripts and HTML docs.

subdirs in /var/nino: 

htdocs/		HTML docs and Java classes
mod_perl/	NINO Perl modules
conf/		Example httpd-nino.conf to use with Include into main httpd.conf
ucd/		UCD or Net-SNMP agent support, pls read ucd/readme.txt
scripts/        NINO startup and install scripts

Unpack the package using:

  cd /var
  gunzip nino41X.tar.gz
  tar -xvf nino41X.tar
  rm nino41X.tar

Installation:

  cd /var/nino/scripts
  ./install

The installer will setup the startup scripts 
and configure Apache httpd.conf.

Start NINO services and httpd:

  cd /etc/init.d
  ./httpd start
  ./nino start

Now the services are started and NINO can be configured with your browser:

  http://localhost/nino/install.html

This will setup the configuration and MySQL database. To start NINO, goto:

  http://localhost/nino/main.html


  *   *   *   *   *

Detailed info for manual install and operation:

Database:

NINO also uses MySQL database. Please install MySQL and the Perl DBI/DBD modules.
Then use the web gui install.html or installcgi.html to create the nino database.
The database is used for event-handling and reporting. Please note that all data
will be destroyed, this installation should only be used to install NINO from scratch.

For LiNUX ditributions a nino startup script is provided
to start and stop all NINO services. Using nino services it is
also possible to stop and start the services using the web GUI.

Activate nino services:

  cp /var/nino/scripts/nino /etc/init.d/
  ./nino start

For non linux systems, please create a startup script to start the NINO servcies:

Start:
  perl /var/nino/mod_perl/services.pl /var/nino/conf/snmp.ini start

Stop:
  perl /var/nino/mod_perl/services.pl /var/nino/conf/snmp.ini stop

To debug or see what is going on:

  perl /var/nino/mod_perl/services.pl /var/nino/conf/snmp.ini start debug


If you do not want the services.pl to control NINO, please read info below. NINO uses
several scripts for monitoring. With additional option "debug" the script will show
everything on the console.

Debug example:

perl /var/nino/mod_perl/trapd.pl /var/nino/conf/snmp.ini debug

All NINO services:

SNMP trap listener:
perl /var/nino/mod_perl/trapd.pl /var/nino/conf/snmp.ini

Event Action:
perl /var/nino/mod_perl/eventaction.pl /var/nino/conf/snmp.ini

Status (Ping and SNMP Uptime):
perl /var/nino/mod_perl/status.pl /var/nino/conf/snmp.ini

Monitoring:
perl /var/nino/mod_perl/monitor.pl /var/nino/conf/snmp.ini <queue>

The default queues are: fast, default, slow, internet
but you may create your own addtitional queues.

Each process will write a pid file to the statistics directory
with service info and "last update" timestamp. This timestamp
can be used to detect if a monitoring process is hanging. 


Customized monitoring presets and queues:

If you need customized presets, you may want to test this without interfering
the other monitoring queues. You can create a new queue and assign your new
monitoring presets to the new queue. Each queue has its own cycle in seconds,
so for troubleshooting this cycle could be set to 10 seconds for faster updates.
The services.pl (/etc/init.d/nino ) will take care of controlling new
monitoring queues. If the services.pl is not used, you need to create your own 
monitoring startup script.

Import monitoring presets or other settings:

NINO is able to import monitoring presets and other settings. In menu ADMIN
click on import. A list of ini-files will appear. By default the next presets
are included:

apache.ini     - Monitor Apache server-status, requests, bytes and
                 Apache Idle/Busy using http.
rdbms.ini      - RDBMS statistics, can be used to monitor Oracle with 
                 Oracle Enterprise Manager SNMP Agent.
openmanage.ini - This will integrate Dell Open Manage as plugin. A new Dell icon
                 will be added next to hostmeter. This will open the Dell
                 Open Manage web interface on the server. This simple example
                 can also be used to integrate your own software into NINO.

Logging:

In menu ADMIN->Diagnostic->NINO statistics the log levels can be set. All NINO
actions are logged to:
   /var/nino/mod_perl/statistics/nino.log

Please note that debug and performance logging will let the nino.log grow very fast.
Performance logging will log every action in milisecs, also MySQL queries (and that
is a lot).  Debug will show more detailed actions. 






For more info, please read the HTML docs, or go to:

   http://sourceforge.net/projects/nino/


Enjoy NINO!

