OIXports
Home Install Screenshots Download
Requires perl and net-snmp (with the perl module) already installed.
You can get it from http://www.net-snmp.org.

DO NOT INSTALL SNMP:: or Net::SNMP from CPAN!

The SNMP module is matched to an install of net-snmp, and must be installed from
the net-snmp source tree.

The Perl module SNMP is found inside the net-snmp distribution. Go to the perl/
directory of the distribution to install it, or run from the top directory of the
net-snmp distribution:

$ ./configure --with-perl-modules --disable-embedded-perl
$ make
$ sudo make install


Running OIXports:

1. Put all files under the same directory, for easy setup put all files in your
 public_html or html directory that is accessible via your web browser.
 Make sure you have read write execute privileges within this directory as
 well as the 2 files:

 chmod 755 oixports.pl
 chmod 755 index.cgi

2. Rename device.cfg.sample to device.cfg

3. Edit device.cfg, put as many devices to monitor seperating each device
 with a blank line, the format is:

 [DeviceNameWithNoSpaces]
 host = "your.device.ip.address"
 comm = "snmpcommunity"

 example :

 [officeswitch]
 host = "192.168.100.10"
 comm = "public"

4. edit both oixports.pl and index.cgi, just change the $path to
 wherever you have installed the script :

 $path = "/hard/link/to/your/directory";

 example :

 $path = "/home/johar/public_html/oixports";

5. run oixports.pl from command line once or twice to make sure it does not
 produce an error message :

 bash:~/public_html$ ./oixports.pl

 If it runs with no error then run oixports.pl from cron every 5 minutes:

 */5 * * * * /hard/link/to/installation/directory/oixports.pl

6. Configure web server to allow scripts (cgi) to be executed from this directory.
 In Apache this can be done in adding to httpd.conf :

 <Directory /home/johar/public_html/oixports>
    Options All
    AllowOverride All
    Require all granted
 </Directory>

7. Access http://your.web/subdir/index.cgi with your web browser, give the script
 at least 10 minutes to make it feel at home after running cron.

(optional : you can now move index.cgi together with the css and woff2 file to
wherever you want. Do not change the $path, it should always point to where
oixports.pl directory is located)


Script can be downloaded from http://www.openixp.net/oixports

-end
Johar Alam <johar@openixp.net>