Ona Installation

The project is moving to http://ona.sourceforge.net/. Please be patient during the transition while some parts of the documentation is here, and some is on sourceforge.

Note: these installation instructions are for FreeBSD. If using another operating system, some installation paths and procedures may be different. Adjust accordingly. The actual ona source should not require any changes, as it is written in PHP and is portable.

Disclaimer: ona is not yet a mature open source application. Installation and maintenance of this application will require a reasonable knowledge of mysql, php, apache, snmp and unix.

Questions and Comments - please join the ona discussion list available at http://ona.uwaterloo.ca and peruse the archives, and ask questions there.

• Download ona-0.90.tar.gz and (optionally ona-mibs-optional-0.90.tar.gz) from http://sourceforge.net/projects/ona
• install ApacheWebServer with modssl
• install MySql
• install ModPhp with Snmp, Mysql, and FTP support enabled (at least). Install the standalone php binary also
• optionally install PhpMyAdmin (not required, but highly recommended)
• install cvsweb as shown in CvsEtc
• install rrdtool

cd /usr/ports/net/rrdtool
make
make install

• Add the following to your httpd.conf file:

<Directory /usr/local/www/data/ona>
    Allow from all
    AllowOverride All
</Directory>

• install ona

mkdir /usr/local/www/data/ona
chown www:www /usr/local/www/data/ona
chmod 700 /usr/local/www/data/ona
cd /usr/local/www/data/ona
gunzip ona-0.90.tar.gz
tar xf ona-0.90.tar
chown -R www:www *
chmod -R 700 *
cp UWlogo.gif /usr/local/www/icons
mkdir rrd tmp
chown www:www rrd tmp
./cvssetup.csh
cd /usr/local/www/data/ona/cvsweb.private
ln -s /usr/local/www/cgi-bin/cvsweb.cgi cvsweb.cgi
cp /usr/local/etc/cvsweb/cvsweb.conf.dist cvsweb.conf
cd /usr/local/www/data/ona/cvsweb.public
ln -s /usr/local/www/cgi-bin/cvsweb.cgi cvsweb.cgi
cp /usr/local/etc/cvsweb/cvsweb.conf.dist cvsweb.conf

• Change the two cvsweb.conf files to point to the ona repository. Example, change:

       'local'   => ['My CVS Repository', '/home/cvs'],

to...

       'local'   => ['Ona', '/usr/local/www/data/ona/cvsroot.public'],

• adjust /usr/local/www/data/ona/config/config.php as required
• Enable TrivialFileTransferProtocol on the server which is hosting ona
• Create a directory /tftpboot/configs for example:

mkdir /tftpboot/configs
chown nobody:www /tftpboot/configs
chmod 770 /tftpboot/configs

chgrp www /tftpboot
chmod 770 /tftpboot

If using utftpd then config.php should contain:

$upload_path = "tftpboot/configs";
$upload_root = "/";

If using the stock FreeBSD tftp daemon then config.php should contain:

$upload_path = "configs";
$upload_root = "/tftpboot";

The reason for this is that utftpd references paths from the root, while the stock tftpd references paths from /tftpboot

• move /usr/local/www/data/ona/nexus.php to the php include directory, typically /usr/local/share/pear
• Create the ona database and user:

mysql -u root -p
 create database ona;
 use mysql;
 INSERT INTO db VALUES ('localhost','ona','onaman','Y','Y','Y','Y','Y','Y','Y','Y','Y','Y');
 INSERT INTO user VALUES ('localhost','onaman',PASSWORD('something'),'N','N','N','N','N','N','N','N','N','N','N','N','N','N');
 flush privileges;
 exit;

• Create the ona tables:

mysql <ona.sql

• Fetch the vendor mibs and place in subdirectories under /usr/local/share/snmp and add the directories to /usr/local/share/snmp/snmp.conf. Mibs are available as follows:

Cisco	http://www.cisco.com/public/sw-center/netmgmt/cmtk/mibs.shtml
Extreme	http://www.extremenetworks.com/services/software/
HP Procurve	http://www.hp.com/rnd/software/MIBs.htm
Nortel	http://www130.nortelnetworks.com/cgi-bin/eserv/cs/main.jsp?cscat=SOFTWARE&resetFilter=1&poid=11502

• Example /usr/local/share/snmp/snmp.conf file:

mibdirs /usr/local/share/snmp/mibs:/usr/local/share/snmp/bay:/usr/local/share/snmp/mau:/usr/local/share/snmp/cisco:/usr/local/share/snmp/extreme

The required mibs are also optionally available in a single file and can be installed as follows:

cd /usr/local/share/snmp
gunzip ona-mibs-optional-0.90.tar.gz
tar xf ona-mibs-optional-0.90.tar

If you get the mibs from the vendor sites, delete the following as they give errors...

RMON2-MIB.my
bay/brdgmib.mib
bay/pbridgemib.mib
bay/qbridgemib.mib
cisco/P-BRIDGE.my

Plus, change bay/xlr30.mib as follows

--- bay/xlr30.mib.orig  Sat Feb 28 14:13:40 2004
+++ bay/xlr30.mib       Sat Feb 28 14:31:01 2004
@@ -649,7 +649,7 @@
 -- bit of octet #1 corresponds to ifIndex 0, while the least significant
 -- bit of octet #88 corresponds to ifIndex 703."
 --
-PortSet        ::= OCTET STRING (SIZE (88))
+PortSet        ::= OCTET STRING (SIZE (64))
 IdList                 ::= OCTET STRING (SIZE (0..4096))

• Add to /etc/crontab

59 23 * * * www:www /usr/local/www/data/ona/tools/recent.php>/dev/null
50 17 * * * www:www /usr/local/www/data/ona/tools/settings.php +all>&1 | /usr/bin/mailx -E -s "ona settings" root
*/5 * * * * www:www /usr/local/www/data/ona/tools/rrd.php>/dev/null 2>&1

-- BruceCampbell - 27 Apr 2004
to top