netdisco-frontend 1.0-2 / usr / share / netdisco / html / doc / INSTALL.html

<%text>

<p><a name="__index__"></a></p>
<!-- INDEX BEGIN -->

<ul>

	<li><a href="#name">NAME</a></li>
	<li><a href="#version">VERSION</a></li>
	<li><a href="#author">AUTHOR</a></li>
	<li><a href="#support">SUPPORT</a></li>
	<li><a href="#install_flavors">INSTALL FLAVORS</a></li>
	<li><a href="#requirements">REQUIREMENTS</a></li>
	<ul>

		<li><a href="#os">OS</a></li>
	</ul>

	<li><a href="#upgrade">UPGRADE</a></li>
	<li><a href="#install">INSTALL</a></li>
	<ul>

		<li><a href="#1__download_netdisco">1. Download Netdisco</a></li>
		<li><a href="#2__create_a_unix_user_group_for_netdisco">2. Create a Unix User/Group for Netdisco</a></li>
		<li><a href="#3__add_unix_administrators_to_netdisco_group">3. Add Unix Administrators to Netdisco Group</a></li>
		<li><a href="#4__postgres">4. Postgres</a></li>
		<li><a href="#5__snmp">5. SNMP</a></li>
		<ul>

			<li><a href="#5_1__netsnmp">5.1.  Net-SNMP</a></li>
			<li><a href="#5_2__snmp__info">5.2. SNMP::Info</a></li>
			<li><a href="#5_3__mibs">5.3.  MIBs</a></li>
		</ul>

		<li><a href="#6__graphviz__optional_">6. GraphViz  (Optional)</a></li>
		<li><a href="#7__setup_apache">7. Setup Apache</a></li>
		<li><a href="#8__perl_modules">8. Perl Modules</a></li>
		<li><a href="#9__netdisco_configuration">9. Netdisco Configuration</a></li>
		<li><a href="#10__oui_database">10. OUI Database</a></li>
		<li><a href="#11__restart_apache">11. Restart Apache</a></li>
		<li><a href="#12__discover_a_device_in_netdisco">12. Discover a Device in Netdisco</a></li>
		<li><a href="#13__create_network_topology">13. Create Network Topology</a></li>
		<li><a href="#14__test_web_side">14. Test Web Side</a></li>
		<li><a href="#15__add_cron_jobs">15. Add Cron Jobs</a></li>
		<li><a href="#16__start_the_netdisco_admin_daemon">16. Start the Netdisco Admin Daemon</a></li>
	</ul>

	<li><a href="#os_specific_notes">OS Specific Notes</a></li>
	<ul>

		<li><a href="#freebsd">FreeBSD</a></li>
		<li><a href="#mac_os_x">Mac OS X</a></li>
		<li><a href="#linux__generic">Linux - Generic</a></li>
		<li><a href="#fedora___centos___redhat">Fedora / CentOS / Redhat</a></li>
		<li><a href="#mandrivia_linux">Mandrivia Linux</a></li>
		<li><a href="#debian_linux">Debian Linux</a></li>
		<li><a href="#mandrake_linux_9_1">Mandrake Linux 9.1</a></li>
		<li><a href="#solaris">Solaris</a></li>
	</ul>

	<li><a href="#success">SUCCESS</a></li>
</ul>
<!-- INDEX END -->

<hr />
<p>
</p>
<h1><a name="name">NAME</a></h1>
<p>Netdisco INSTALL -- Instructions for setting up the Netdisco application.</p>
<p>
</p>
<hr />
<h1><a name="version">VERSION</a></h1>
<p>Netdisco 1.0</p>
<p>
</p>
<hr />
<h1><a name="author">AUTHOR</a></h1>
<p>Developed by team of Open Source authors headed by Eric Miller, Bill Fenner,
and Oliver Gorwits, originally created by Max Baker.  See list at the end of
README of all the contributors.</p>
<p>Netdisco was created at the University of California, Santa Cruz (UCSC),
Networking and Technology Services (NTS) department.   UCSC continues to
support the development of Netdisco by providing development servers and beer.</p>
<p>The Netdisco project is hosted by Source Forge at <a href="https://sourceforge.net/projects/netdisco">https://sourceforge.net/projects/netdisco</a>
and <a href="https://sourceforge.net/projects/snmp-info">https://sourceforge.net/projects/snmp-info</a>.</p>
<p>
</p>
<hr />
<h1><a name="support">SUPPORT</a></h1>
<p>Netdisco is an Open Source project created and maintained by volunteer
developers.</p>
<p>Please use the <code>netdisco-users</code> mailing list for all help, problems and
comments.  Developers, patches, and ideas are always welcome.</p>
<dl>
<dt><strong><a name="item_in_case_of_problems">In Case of Problems</a></strong>

<dd>
<p>In case of problems, the first thing you should do is <strong>search</strong> for answers on
the mailing list at
<a href="http://sourceforge.net/search/?group_id=80033&type_of_search=mlists">http://sourceforge.net/search/</a>.</p>
</dd>
</li>
<dt><strong><a name="item_to_ask_a_question">To ask a Question</a></strong>

<dd>
<p>To subscribe to the <code>netdisco-users</code> mailing list to ask questions go to
<a href="http://lists.sourceforge.net/lists/listinfo/netdisco-users">http://lists.sourceforge.net/lists/listinfo/netdisco-users</a>.</p>
</dd>
</li>
<dt><strong><a name="item_to_report_a_bug">To report a bug</a></strong>

<dd>
<p>To report bugs, please use the Bug tracker on the Netdisco Source Forge project page at 
<a href="https://sourceforge.net/tracker2/?group_id=80033&atid=558508">https://sourceforge.net/tracker2/?group_id=80033&atid=558508</a></p>
</dd>
</li>
<dt><strong><a name="item_to_become_a_developer">To become a developer</a></strong>

<dd>
<p>If you would like to help develop Netdisco, or have code to contribute, please
submit your code to the patches tracker at
<a href="https://sourceforge.net/tracker2/?group_id=80033&atid=558510">https://sourceforge.net/tracker2/?group_id=80033&atid=558510</a> and join us on
the <code>netdisco-devel</code> mailing list.</p>
</dd>
</li>
<dt><strong><a name="item_to_register_your_install_of_netdisco">To register your install of Netdisco</a></strong>

<dd>
<p>The developers are now maintaining a registry of Netdisco installs.  This is
mainly for morale boosting purposes, but also helps us direct feature requests
to our target audience.  One drawback of the Source Forge system is that we
have no idea how many people are using the software compared to the number of
downloads.  So after you have Netdisco up and running please spend a minute to
let us know you're using it at <a href="http://netdisco.org/register.html">http://netdisco.org/register.html</a>.</p>
</dd>
</li>
</dl>
<p>
</p>
<hr />
<h1><a name="install_flavors">INSTALL FLAVORS</a></h1>
<p>There are three general flavors of installs out there for Netdisco:</p>
<dl>
<dt><strong><a name="item_from_source">From Source</a></strong>

<dd>
<p>The most common way is to install it from source on your machine using an
install script (see <em>bin/install</em> and
<em><a href="http://www.auburn.edu/~gouldwp/netdisco/">http://www.auburn.edu/~gouldwp/netdisco/</a></em>), or manually using this document.</p>
</dd>
</li>
<dt><strong><a name="item_from_package">From Package</a></strong>

<dd>
<p>Netdisco is available as a package / port on a few flavors of Linux
and BSD.  Check your favorite package repository first before 
going to the trouble of installing it manually.</p>
</dd>
</li>
<dt><strong><a name="item_virtual_machine__2f_vmware_applicance">Virtual Machine / VMWARE Applicance</a></strong>

<dd>
<p>Charles Goldsmith maintains a VMWARE Appliance version of Netdisco
at <a href="http://wokka.org/netdisco/">http://wokka.org/netdisco/</a>.  This is by far the easiest way
to get up and running w/ Netdisco.</p>
</dd>
</li>
</dl>
<p>
</p>
<hr />
<h1><a name="requirements">REQUIREMENTS</a></h1>
<p>Netdisco is built using lots of fine Open-Source tools:</p>
<ul>
<li><strong><a name="item_perl">Perl</a></strong>

<p>5.8.x and newer advised.   Whatever version that comes with your distro should
be fine.</p>
</li>
<li><strong><a name="item_perl_modules">Perl Modules</a></strong>

<p>Listed below</p>
</li>
<li><strong><a name="item_net_2dsnmp">Net-SNMP</a></strong>

<p>5.1.x and newer advised.  Reported working on 5.0.x as well.</p>
</li>
<li><strong><a name="item_postgres_sql_server">Postgres SQL Server</a></strong>

<p>Version 8.x or higher suggested.</p>
<p>Reported working for versions 7.2, 7.3, 7.4, 8.0, 8.1</p>
</li>
<li><strong><a name="item_mason">Mason</a></strong>

<p>1.26 or newer required.  1.39 or newer advised, especially
for Apache2 installs.</p>
</li>
<li><strong><a name="item_apache">Apache</a></strong>

<p>1.3.x and 2.x supported.  2.x strongly preferred.</p>
</li>
<li><strong><a name="item_mod_perl">mod_perl</a></strong>

<p>Get the mod_perl version to match your Apache:</p>
<dl>
<dt><strong><a name="item_apache_1_2e3_2ex">Apache 1.3.x</a></strong>

<dd>
<p>mod_perl version  1.29 or higher is recommended.</p>
</dd>
</li>
<dt><strong><a name="item_apache_2_2ex">Apache 2.x</a></strong>

<dd>
<p><strong>Do not install version 1.99</strong>!
Make sure you have mod_perl version 2.02 or later.</p>
</dd>
</li>
</dl>
<li><strong><a name="item_graphviz">GraphViz (Optional)</a></strong>

<p>Version 2.22 or higher recommended.</p>
</li>
</ul>
<p>See <a href="#install">INSTALL</a> below for details on how to retrieve and install each prerequisite.</p>
<p>
</p>
<h2><a name="os">OS</a></h2>
<p>Netdisco was developed on a FreeBSD system but should work on any
system that Postgres, Perl, Apache, and Net-SNMP run on.</p>
<p>Linux is a sure bet.  Successful installs have been reported under Redhat,
Mandrivia, Gentoo and Debian.  A beta RPM is available for Mandrivia, but may
be out of date.  One user has reported getting Netdisco running on OS X.
Solaris has been successful for 8 and 10.  Windows will take a lot of massaging
but should be possible under Cygwin.</p>
<p>See <a href="#os_specific_notes">OS Specific Notes</a> below for details.</p>
<p>
</p>
<hr />
<h1><a name="upgrade">UPGRADE</a></h1>
<p>If you are upgrading your copy of Netdisco, please read through this file
and then read the <code>UPGRADE</code> document in this directory.</p>
<p>
</p>
<hr />
<h1><a name="install">INSTALL</a></h1>
<p>This is not a terribly easy install.  If you aren't comfortable installing
programs from source and using a text editor, get some help.  Some packaged
versions of Netdisco are available.</p>
<p>
</p>
<h2><a name="1__download_netdisco">1. Download Netdisco</a></h2>
<p>Get the newest version from <a href="http://www.netdisco.org">http://www.netdisco.org</a>.</p>
<dl>
<dt><strong><a name="item__5b1_2e1_5d_unarchive_netdisco">[1.1]  Unarchive Netdisco</a></strong>

<dd>
<pre>
    tar xvfz netdisco-x.xx_with_mibs.tar.gz</pre>
</dd>
<dt><strong><a name="item__5b1_2e2_5d_create_a_directory_for_netdisco_and_mo">[1.2]  Create a directory for Netdisco and move the files into that dir</a></strong>

<dd>
<pre>
    mkdir /usr/local/netdisco
    mv netdisco-x.xx/* /usr/local/netdisco</pre>
</dd>
<dt><strong><a name="item__5b1_2e3_5d_non_2dstandard_install_directory">[1.3]  Non-Standard install Directory</a></strong>

<dd>
<p>If you plan to install to a directory other than <code>/usr/local/netdisco</code> then
you must change a couple files.  Otherwise Skip down to Number 2.</p>
</dd>
<dl>
<dt><strong><a name="item__5b1_2e3_2e1_5d_shell_scripts">[1.3.1] Shell Scripts</a></strong>

<dd>
<p>The following shell scripts require you specify the Netdisco directory
if it is not in the default location:</p>
</dd>
<dd>
<pre>
    sql/pg -d /path/to/netdisco
    bin/netdisco_daemon</pre>
</dd>
</li>
<dt><strong><a name="item__5b1_2e3_2e2_5d_netdisco_2econf">[1.3.2]  netdisco.conf</a></strong>

<dd>
<p>Set the <code>home</code> option in <em>netdisco.conf</em>.</p>
</dd>
</li>
<dt><strong><a name="item__5b1_2e3_2e3_5d_netdisco_apache_2econf">[1.3.3] netdisco_apache.conf</a></strong>

<dd>
<p>Change all the appearances of <code>/usr/local/netdisco</code> in <em>netdisco_apache.conf</em>
to match your new directory.</p>
</dd>
</li>
<dt><strong><a name="item__5b1_2e3_2e4_5d_netdisco_apache_dir_2econf">[1.3.4]  netdisco_apache_dir.conf</a></strong>

<dd>
<p>Change all the appearances of <code>/usr/local/netdisco</code> in <em>netdisco_apache_dir.conf</em>
to match your new directory.</p>
</dd>
</li>
</dl>
</dl>
<p>
</p>
<h2><a name="2__create_a_unix_user_group_for_netdisco">2. Create a Unix User/Group for Netdisco</a></h2>
<dl>
<dt><strong><a name="item__5b2_2e1_5d_create_a_user_and_group_named_netdisco">[2.1] Create a user and group named <code>netdisco</code></a></strong>

<dd>
<p>Linux:</p>
</dd>
<dd>
<pre>
    useradd -d /usr/local/netdisco netdisco</pre>
</dd>
<dd>
<p>BSD:</p>
</dd>
<dd>
<pre>
    adduser netdisco</pre>
</dd>
</li>
<dt><strong><a name="item__5b2_2e2_5d_user_permissions">[2.2] User Permissions</a></strong>

<dd>
<p>Give this user permission to the installed files</p>
</dd>
<dd>
<pre>
    chown -R netdisco.netdisco /usr/local/netdisco</pre>
</dd>
</li>
</dl>
<p>
</p>
<h2><a name="3__add_unix_administrators_to_netdisco_group">3. Add Unix Administrators to Netdisco Group</a></h2>
<p>Once Netdisco is up and running most administration
can be done from the Web interface.  Whoever will be doing
the back-end administration will need to have write access and will need
write access on Netdisco's files.</p>
<p>Add the unix account names of administrators that will modify the
source code or use the command line interface interface to the <code>netdisco</code>
group in <em>/etc/group</em>.</p>
<p>Don't forget to logout and login after adding yourself to a group.</p>
<p>
</p>
<h2><a name="4__postgres">4. Postgres</a></h2>
<p>Netdisco runs Postgres SQL as its database back-end.</p>
<dl>
<dt><strong><a name="item__5b4_2e1_5d_install_postgres">[4.1] Install Postgres</a></strong>

<dd>
<p>See the section <a href="#os_specific_notes">OS Specific Notes</a> below for any notes relating to your operating
system of for a binary version.</p>
</dd>
<dd>
<p>There is probably a binary package all ready for you.  See your distribution's
instructions for more help.</p>
</dd>
<dd>
<p>If you cannot use a binary package, download and compile the source code
from <a href="http://www.postgresql.org">http://www.postgresql.org</a>.</p>
</dd>
<dd>
<p>If you are installing Postgres from source you may have to run these two commands in order
to install the DBD::Pg Perl module later on :</p>
</dd>
<dd>
<pre>
    export POSTGRES_INCLUDE=/usr/local/postgres/include
    export POSTGRES_LIB=/usr/local/postgres/lib</pre>
</dd>
<dd>
<p>You may also have to modify your <em>/etc/ld.so.conf</em> to include your new
POSTGRES_LIB directory.  Don't forget to run <code>ldconf</code> afterwards.</p>
</dd>
</li>
<dt><strong><a name="item__5b4_2e2_5d_configure_postgres">[4.2] Configure Postgres</a></strong>

<dd>
<p>Netdisco's settings in Postgres are</p>
</dd>
<dd>
<pre>
 Database User     : netdisco
 Database Name     : netdisco
 Database Password : you choose it</pre>
</dd>
<dd>
<p>Edit <em>netdisco.conf</em> and <em>netdisco_apache.conf</em> to match this
user name and password.</p>
</dd>
<dd>
<p>Follow these steps to setup Netdisco in Postgres.</p>
</dd>
</li>
<dt><strong><a name="item__5b4_2e3_5d_permissions">[4.3] Permissions</a></strong>

<dd>
<p>If you have just setup Postgres for the first time you may have to change the
default permissions in <em>$PG_DATA/pg_hba.conf</em>.  $PG_DATA might be in
<em>/usr/local/pgsql</em> or in <em>/var/db</em>, depends on your OS.  Check the postgres
users' homedir files for the location of $PG_DATA.</p>
</dd>
<dd>
<p>For installation you must give the database user access to the <code>template1</code> database.
The following line will give all users who have logon permissions in Unix access
to the <code>template1</code> database.</p>
</dd>
<dd>
<pre>
    local template1 all ident</pre>
</dd>
<dd>
<p>Restart Postgres.  If you have permission problems try the following line which
opens up access to all users.</p>
</dd>
<dd>
<pre>
    local template1 all all</pre>
</dd>
<dd>
<p>Next you must give the <code>netdisco</code> database user access to the <code>netdisco</code> database.
The following line will give all database users access to a database that is the same
name as them.  This line must be put above all the rest of the uncommented lines in the
<em>pg_hba.conf</em> file to take precedence.</p>
</dd>
<dd>
<pre>
    local sameuser all md5</pre>
</dd>
<dd>
<p>For older 7.3 or 7.4 installs of Postgres you may have to swap <code>md5</code> for <code>crypt</code>.
Upgrade. Please.</p>
</dd>
<dd>
<p>Finally if you would like to have <code>root</code> be able to access all databases,
try this one :</p>
</dd>
<dd>
<pre>
    local all root trust</pre>
</dd>
</li>
<dt><strong><a name="item__5b4_2e4_5d_restart_postgres">[4.4] Restart Postgres</a></strong>

<dd>
<p>You must now restart Postgres</p>
</dd>
<dd>
<p>Linux : one of these three</p>
</dd>
<dd>
<pre>
    /etc/rc.d/init.d/postgresql restart
    service postgresql restart
    /etc/rc.d/postgresql restart</pre>
</dd>
<dd>
<p>FreeBSD :</p>
</dd>
<dd>
<pre>
    /usr/local/etc/rc.d/*pgsql* restart</pre>
</dd>
<dd>
<p>If there are problems with this step you will receive an error that mentions something
about <em>pg_hba.conf</em>.</p>
</dd>
</li>
<dt><strong><a name="item__5b4_2e5_5d_create_database_2e">[4.5] Create Database.</a></strong>

<dd>
<p>Make sure Postgres is up and running.</p>
</dd>
<dd>
<p>The <code>pg</code> command use <em>netdisco.conf</em> to find the database
user name and password.  Make sure that the database user name and password are
set.</p>
</dd>
<dd>
<p>As root, run <code>sql/pg --init</code> to create the database and user for Netdisco.</p>
</dd>
<dd>
<p>When you are prompted for a password, enter the new password for the database
user you are creating.  This is the same password you set in
<em>netdisco_apache.conf</em> and in <em>netdisco.conf</em>.  The <code>pg</code> command has additional
options shown in <code>pg --help</code></p>
</dd>
<dd>
<pre>
    cd /usr/local/netdisco/sql
    ./pg --help
    ./pg --init</pre>
</dd>
<dd>
<p>If you get permissions errors, find out the name of your database user.  This
is the <code>unix</code> user that the Postgres database is running as.  The default name
for some Linux RPM versions is <code>postgres</code> and for some BSD installations
<code>pgsql</code>.  If yours is different, please specify it with the <code>-u</code> option to 
<em>sql/pg</em>.</p>
</dd>
</li>
<dt><strong><a name="item__5b4_2e6_5d_check_settings">[4.6] Check Settings</a></strong>

<dd>
<p>Now as a non-privileged user (root) make sure you can get into the database by
running <code>sql/pg</code>.  The database user password given above will be
retrieved from <em>netdisco.conf</em>.</p>
</dd>
<dd>
<pre>
    cd /usr/local/netdisco/sql
    ./pg</pre>
</dd>
<dd>
<p>You should see output similar to the below:</p>
</dd>
<dd>
<pre>
    Welcome to psql 8.0.6, the PostgreSQL interactive terminal.</pre>
</dd>
<dd>
<pre>
    Type:  \copyright for distribution terms
           \h for help with SQL commands
           \? for help with psql commands
           \g or terminate with semicolon to execute query
           \q to quit</pre>
</dd>
<dd>
<pre>
    netdisco=&gt;
    netdisco=&gt; \q</pre>
</dd>
</li>
<dt><strong><a name="item__5b4_2e7_5d_optimizations">[4.7] Optimizations</a></strong>

<dd>
<p>If you have freshly installed Postgres then the default memory usage <strong>NEEDS</strong> to
be increased for efficiency.  See the Postgres documentation for
<em>postgresql.conf</em>.   Newer versions may have options to turn on for
automatic tuning.</p>
</dd>
<dd>
<p>Specifically, you really need to up the maximum connections and shared memory
settings.  After you have Netdisco running on a large installation it would be
of great benefit to get a Postgres guru in there to tune things for you.  See
<em>README</em> for more info about how to speed things up now and again.</p>
</dd>
<dd>
<p>See <a href="http://www.postgresql.org/docs/current/static/kernel-resources.html">http://www.postgresql.org/docs/current/static/kernel-resources.html</a> for
kernel settings related to Postgres that you <em>should</em> check.</p>
</dd>
</li>
<dt><strong><a name="item__5b4_2e8_5d_postgres_startup">[4.8] Postgres Startup</a></strong>

<dd>
<p>Make sure that Postgres is set to start on reboot of the server.</p>
</dd>
<dl>
<dt><strong><a name="item_linux">Linux</a></strong>

<dd>
<pre>
    chkconfig postgresql on</pre>
</dd>
<dt><strong><a name="item_bsd">BSD</a></strong>

<dd>
<p>Make sure that the file in <code>/usr/local/etc/rc.d</code> is alright and
you have added</p>
</dd>
<dd>
<pre>
    postgresql_enable=&quot;YES&quot;</pre>
</dd>
<dd>
<p>to <em>/etc/rc.conf</em>.</p>
</dd>
</li>
</dl>
<dt><strong><a name="item__5b4_2e9_5d_postgres_maintenance">[4.9] Postgres Maintenance</a></strong>

<dd>
<p>Read the section in <em>README</em> about Database Maintenance... every once in a
while you may have to run a <code>VACUUM</code> and <code>REINDEX</code> by hand if things get too slow.
This appears to be less necessary in Postgres 8.0 and up.</p>
</dd>
</li>
<dt><strong><a name="item_database">[4.10] Remote Database (Optional)</a></strong>

<dd>
<p>If you have Postgres installed in a remote location then all you have
to do is add that host information to the <code>db_Pg</code> line in <em>netdisco.conf</em>.</p>
</dd>
<dd>
<pre>
    db_Pg = dbi:Pg:dbname=netdisco;host=HOSTNAME;port=PORT;</pre>
</dd>
<dd>
<p>On the Postgres machine, allow your remote front end to contact the back-end
database. Here is a sample line in <em>pg_hba.conf</em>.</p>
</dd>
<dd>
<pre>
 #TYPE  DATABASE          USER            IP-ADDRESS              IP-MASK           METHOD
 host   netdisco        netdisco         101.102.103.104         255.255.255.0       md5</pre>
</dd>
<dd>
<p>Don't forget to restart Postgres after changing the <em>pg_hba.conf</em> file.</p>
</dd>
</li>
</dl>
<p>
</p>
<h2><a name="5__snmp">5. SNMP</a></h2>
<p>There are three components to set up for SNMP:</p>
<p>
</p>
<h3><a name="5_1__netsnmp">5.1.  Net-SNMP</a></h3>
<p>Net-SNMP lives at <a href="http://net-snmp.sourceforge.net">http://net-snmp.sourceforge.net</a>.</p>
<p><strong>There are two known bad versions: 5.2.3 and 5.3.1 !</strong></p>
<p>Please use the older working versions 5.2.2 or 5.3.0.1, or try the
newer 5.2.4, 5.3.2 or 5.4 when they're available.  See
<a href="http://www.net-snmp.org/dev/schedule.html">http://www.net-snmp.org/dev/schedule.html</a> for release schedule
plans.  You can also use a nightly version from the appropriate
patch branch, from <a href="http://www.net-snmp.org/nightly/tarballs/">http://www.net-snmp.org/nightly/tarballs/</a>.</p>
<p>The symptom of the failure is getting an error <code>Not an ARRAY reference at SNMP/Info.pm line xxx</code>.</p>
<p>A workaround if you must use a buggy Net-SNMP version is to use SNMPv1 or turn
off bulkwalk with <code>bulkwalk_off: yes</code> -- but the best thing to do is change your
Net-SNMP version.</p>
<p>You can update the perl SNMP module seperately from the libraries and
binaries, using CPAN.  As of this writing, the current module on CPAN is 5.0301002
which does not have this bug.  Only try to use this module with a matching
Net-SNMP version - i.e., if you get a warning like this when you try to install:</p>
<pre>
        ERROR:
        Net-SNMP installed version: 5.2.3 =&gt; 5.0203
        Perl Module Version:        5.0301</pre>
<p>then please try a different method.</p>
<dl>
<dt><strong><a name="item__5b5_2e1_2e0_5d_binary_install">[5.1.0] Binary Install</a></strong>

<dd>
<p>Check the Net-SNMP page for binaries and see <a href="#os_specific_notes">OS Specific Notes</a> below for
details.</p>
</dd>
</li>
<dt><strong><a name="item__5b5_2e1_2e1_5d_source_install">[5.1.1] Source Install</a></strong>

<dd>
<p>Download Net-SNMP from <a href="http://net-snmp.sourceforge.net">http://net-snmp.sourceforge.net</a></p>
</dd>
<dd>
<p>This used to be called ucd-snmp.  However, don't download ucd-snmp; it
is too old.</p>
</dd>
</li>
<dt><strong><a name="item__5b5_2e1_2e2_5d_install_net_2dsnmp_to_include_perl">[5.1.2] Install Net-SNMP to include Perl module that comes inside the distribution.</a></strong>

<dd>
<p>When you run <code>./configure</code>, make sure you add the switch <code>--with-perl-modules</code></p>
</dd>
<dd>
<pre>
    ./configure --with-perl-modules --enable-shared
    make
    make install</pre>
</dd>
<dd>
<p>If you already have Net-SNMP installed, then go to the source directory and
in the <code>perl</code> subdirectory and run <code>perl Makefile.PL</code></p>
</dd>
<dd>
<pre>
    cd /path/to/net-snmp-5.1.x/perl
    perl Makefile.PL
    make
    make install</pre>
</dd>
<dd>
<pre>
 ********************************************************************</pre>
</dd>
<dd>
<p><strong>DO NOT</strong> INSTALL the <code>SNMP::</code> or <code>Net::SNMP</code> modules off of CPAN.  These
modules are not related to Net-SNMP and are not compatible with Netdisco.</p>
</dd>
<dd>
<pre>
 ********************************************************************</pre>
</dd>
</li>
<dt><strong><a name="item_setup">[5.1.3] Configure Net-SNMP for a non-standard setup (Optional)</a></strong>

<dd>
<p>You probably will not have to do this step unless you have installed Net-SNMP
somewhere other than <em>/usr/local/</em> or have some specific SNMP defaults to
change for these tools.   Usually the settings in <em>netdisco.conf</em> are more
than enough.</p>
</dd>
<dd>
<pre>
    snmpconf</pre>
</dd>
<dd>
<p>Make sure to set the MIB dir if non-standard or you are not using the MIBS that
come with Netdisco.</p>
</dd>
<dd>
<pre>
 (Textual mib Parsing -&gt; Specifies directories to be searched for mibs)</pre>
</dd>
<dd>
<p>Make sure this newly created <em>snmp.conf</em> lives in <em>/usr/local/share/snmp</em> or
wherever you put a custom install.</p>
</dd>
</li>
</dl>
<p>
</p>
<h3><a name="5_2__snmp__info">5.2. SNMP::Info</a></h3>
<p>SNMP::Info is one half of the Netdisco application.</p>
<p>SNMP::Info holds all the device-specific code to retrieve data from network
devices via SNMP.  A wide variety of devices are supported.  You may need to
add support for other devices if they do not follow a standard interface.  This
is not too complex.  See SNMP::Info and consult the mailing list archives for
more details.</p>
<p>SNMP::Info is available from <a href="http://snmp-info.sourceforge.net">http://snmp-info.sourceforge.net</a> and from CPAN.
You must have Net-SNMP installed before installing it.</p>
<p>You have four different options in installing SNMP::Info</p>
<dl>
<dt><strong><a name="item__5b5_2e2_2e1_5d_cpan">[5.2.1] CPAN</a></strong>

<dd>
<pre>
    perl -MCPAN -e shell
        o conf prerequisites_policy ask
        install SNMP::Info</pre>
</dd>
<dt><strong><a name="item__5b5_2e2_2e2_5d_from_source">[5.2.2] From Source</a></strong>

<dd>
<p>Download newest version from <a href="http://snmp-info.sourceforge.net">http://snmp-info.sourceforge.net</a></p>
</dd>
<dd>
<pre>
    tar xvfz SNMP-Info-1.x.tar.gz
    cd SNMP-Info-1.x
    perl Makefile.PL
    make install</pre>
</dd>
</li>
<dt><strong><a name="item__5b5_2e2_2e3_5d_from_cvs">[5.2.3] From CVS</a></strong>

<dd>
<p>If you plan to add or change device support in SNMP::Info to customize Netdisco to your devices,
you should install SNMP::Info this way.</p>
</dd>
<dd>
<pre>
    make snmp</pre>
</dd>
<dd>
<p>This will create the SNMP/ directory where SNMP::Info will live.   Periodically you should re-run</p>
</dd>
<dd>
<pre>
    make snmp</pre>
</dd>
<dd>
<p>To update to the most current CVS version.</p>
</dd>
</li>
<dt><strong><a name="item__5b5_2e2_2e4_5d_from_package">[5.2.4] From Package</a></strong>

<dd>
<p>See <a href="#os_specific_notes">OS Specific Notes</a> below for details.</p>
</dd>
</li>
</dl>
<p>
</p>
<h3><a name="5_3__mibs">5.3.  MIBs</a></h3>
<p>MIBs that are required for <em>SNMP::Info</em> are included with Netdisco in the
<em>mibs/</em> directory if you installed the <code>netdisco-1.0_with_mibs</code> package.</p>
<p>If you installed the <code>netdisco</code> package <strong>without</strong> included MIB files, then
please download the <code>netdisco-mibs</code> package from
<a href="http://sourceforge.net/project/showfiles.php?group_id=80033">http://sourceforge.net/project/showfiles.php</a>.  Place
these files in <code>/usr/local/netdisco/mibs</code>.</p>
<p>
</p>
<h2><a name="6__graphviz__optional_">6. GraphViz  (Optional)</a></h2>
<p>GraphViz is used to create the Network Map.</p>
<p>It lives at <a href="http://www.graphviz.org/">http://www.graphviz.org/</a>.</p>
<dl>
<dt><strong><a name="item__5b6_2e1_5d_download">[6.1] Download</a></strong>

<dd>
<p>Get the newest version from <a href="http://www.graphviz.org/pub/graphviz">http://www.graphviz.org/pub/graphviz</a>.
Unarchive and install.  Some binary versions are available.</p>
</dd>
</li>
<dt><strong><a name="item__5b6_2e2_5d_true_type_font">[6.2] True Type Font</a></strong>

<dd>
<p>Copy a True Type Font file (<em>.ttf</em>) into the Netdisco directory and
change <code>node_font</code> in <em>netdisco.conf</em> to match.</p>
</dd>
<dd>
<pre>
    cp /path/to/windows/fonts/lucon.ttf /usr/local/netdisco</pre>
</dd>
<dd>
<p>You can grab <em>arial.ttf</em> or <em>lucon.ttf</em> out of the <em>c:\windows\fonts</em>
directory of any Windows machine.</p>
</dd>
</li>
<dt><strong><a name="item__5b6_2e3_5d_graph_settings">[6.3] Graph Settings</a></strong>

<dd>
<p>Review other graph settings in <em>netdisco.conf</em>.  See <em>README</em> for
details on the settings.</p>
</dd>
</li>
<dt><strong><a name="item__5b6_2e4_5d_check_path">[6.4] Check Path</a></strong>

<dd>
<p>Make sure that <code>neato</code> or <code>twopi</code> is in your path, and in the path
in <em>netdisco.crontab</em>.</p>
</dd>
<dd>
<pre>
    which twopi
    which neato</pre>
</dd>
<dd>
<p>After the Perl Modules step below,
make sure the Graphviz Perl module got installed</p>
</dd>
<dd>
<pre>
    perldoc GraphViz</pre>
</dd>
<dd>
<p>NOTE: You can safely ignore all warnings about <code>size too small for label</code>.</p>
</dd>
</li>
</dl>
<p>
</p>
<h2><a name="7__setup_apache">7. Setup Apache</a></h2>
<dl>
<dt><strong><a name="item__5b7_2e1_5d_apache2">[7.1] Apache2</a></strong>

<dd>
<p>Using recent versions of Mason and mod_perl, Netdisco runs fine under
Apache2.</p>
</dd>
</li>
<dt><strong><a name="item__5b7_2e2_5d_apache1">[7.2] Apache1</a></strong>

<dd>
<p>It is strongly advised to use Apache2.   Consider section 7.2 as
historical.</p>
</dd>
<dd>
<p>See the O/S specific notes at the bottom of this document for
a binary install or install <strong>Apache 1.3.x From Scratch</strong>:</p>
</dd>
<dd>
<p>Comment out the lines at the top of <em>netdisco_apache.conf</em> that
are related to Apache2.</p>
</dd>
<dd>
<p>Install Apache 1.3.x and mod_perl 1.x and mod_ssl</p>
</dd>
<dd>
<p>Netdisco is designed to work in a secure (https) or non-secure
environment.  Due to the security and privacy concerned associated with
this data, using a secure server is recommended.</p>
</dd>
<dd>
<p>Below is my method if you haven't installed apache and mod_perl before.
I statically compile mod_perl, and mod_ssl then leave the rest of the
modules as dynamically loadable objects (DSO).</p>
</dd>
<dl>
<dt><strong><a name="item__5b7_2e2_2e1_5d_download_and_unarchive">[7.2.1] Download and Unarchive</a></strong>

<dd>
<p>Get Apache from <a href="http://httpd.apache.org">http://httpd.apache.org</a></p>
</dd>
<dd>
<p>Get mod_perl from <a href="http://perl.apache.org">http://perl.apache.org</a></p>
</dd>
<dd>
<p>Get mod_ssl from <a href="http://www.modssl.org">http://www.modssl.org</a></p>
</dd>
<dd>
<p>Unarchive all three to the same directory, maybe <em>/usr/local/src</em></p>
</dd>
</li>
<dt><strong><a name="item__5b7_2e2_2e2_5d_inital_apache_setup">[7.2.2] Inital Apache Setup</a></strong>

<dd>
<p>This step makes the framework that mod_ssl and mod_perl need.</p>
</dd>
<dd>
<pre>
 cd apache_1.3*
 ./configure</pre>
</dd>
<dd>
<p>No need to make it yet.</p>
</dd>
</li>
<dt><strong><a name="item__5b7_2e2_2e3_5d_mod_ssl">[7.2.3] mod_ssl</a></strong>

<dd>
<p>Mod_SSL gives us a secure server (https) for Netdisco to run under.</p>
</dd>
<dd>
<p>The OpenSSL library is a prerequirement for mod_ssl and may or may not already
be on your system.  See <a href="#os_specific_notes">OS Specific Notes</a> at the bottom of this document.</p>
</dd>
<dd>
<p>To use a source version, you need to point the apache1 installer to the
install.  First follow the instructions in the <em>INSTALL</em> that comes with
<code>mod_ssl</code>.  Then use the command below:</p>
</dd>
<dd>
<pre>
 SSL_BASE=/path/to/openssl-0.9.x \
 ./configure \
    --with-apache=../apache_1.3.x \
    --disable_rule=SSL_COMPAT</pre>
</dd>
</li>
<dt><strong><a name="item__5b7_2e2_2e4_5d_mod_perl">[7.2.4] mod_perl</a></strong>

<dd>
<p>This step sets up mod_perl for this copy of apache :</p>
</dd>
<dd>
<pre>
 cd ../mod_perl-1.x
 /usr/local/bin/perl Makefile.PL \
        APACHE_SRC=../apache_1.3.x/src \
        EVERYTHING=1 \
        DO_HTTPD=1 \
        USE_APACI=1 \
        PREP_HTTPD=1 \
        PERL_SECTIONS=1</pre>
</dd>
<dd>
<pre>
 make</pre>
</dd>
</li>
<dt><strong><a name="item__5b7_2e2_2e5_5d_apache_again">[7.2.5] Apache Again</a></strong>

<dd>
<p>Now we're ready to make the main apache and install all of
the above (mod_ssl, mod_perl, and Apache).</p>
</dd>
<dd>
<pre>
 cd ../apache_1.3*
 ./configure \
        --prefix=/usr/local/apache \
        --enable-module=most \
        --enable-shared=max \
        --activate-module=src/modules/perl/libperl.a \
        --with-perl=/usr/local/bin/perl \
        --enable-module=ssl
 make
 make certificate
 make install</pre>
</dd>
</li>
<dt><strong><a name="item__5b7_2e2_2e6_5d_install_mod_perl">[7.2.6] Install mod_perl</a></strong>

<dd>
<pre>
 cd ../mod_perl*
 make install</pre>
</dd>
</dl>
<dt><strong><a name="item__5b7_2e3_5d_apache_configuration_files">[7.3]  Apache Configuration Files</a></strong>

<dd>
<p>Add the following lines in your <code>httpd.conf</code>.</p>
</dd>
<dd>
<p>Your <code>httpd.conf</code> will live in <code>/usr/local/apache/conf</code> if you installed
using the method above.   For system installed packages, try <code>/etc/httpd</code>
or <code>/usr/local/etc/httpd</code>.</p>
</dd>
<dl>
<dt><strong><a name="item__5b7_2e3_2e1_5d_in_the_global_section">[7.3.1] In the Global Section</a></strong>

<dd>
<p>Add this line <strong>once</strong> in the end of <code>httpd.conf</code> not in a VirtualHost section.</p>
</dd>
<dd>
<pre>
    Include /usr/local/netdisco/netdisco_apache.conf</pre>
</dd>
</li>
<dt><strong><a name="item__5b7_2e3_2e2_5d_no_virtualhosts">[7.3.2] No virtualhosts</a></strong>

<dd>
<p>If you do not have virtual hosts setup and/or you have a main server, add this
line right after the first include :</p>
</dd>
<dd>
<pre>
    Include /usr/local/netdisco/netdisco_apache_dir.conf</pre>
</dd>
</li>
<dt><strong><a name="item__5b7_2e3_2e3_5d_in_each_virtualhost">[7.3.3] In each VirtualHost</a></strong>

<dd>
<p>If you have Virtual Hosts or are setting up a secure server, put the following
line in each of them that you want Netdisco turned on for:</p>
</dd>
<dd>
<p>If you are not using Virtual Hosts, then add this line under the
<em>netdisco_apache.conf</em> line.</p>
</dd>
<dd>
<pre>
    Include /usr/local/netdisco/netdisco_apache_dir.conf</pre>
</dd>
<dd>
<p>Make sure you have this include line for the secure server virtual host
<strong>*:443</strong> at the bottom of <em>http.conf</em>.</p>
</dd>
</li>
</dl>
<dt><strong><a name="item__5b7_2e4_5d_mason_data_directory">[7.4]  Mason Data Directory</a></strong>

<dd>
<p>Set the Mason data directory writable to the apache user that does the
requests.</p>
</dd>
<dd>
<p>Assuming <code>nobody</code> is the user that the apache web server runs under,
run this command as <code>root</code> :</p>
</dd>
<dd>
<pre>
    mkdir /usr/local/netdisco/mason
    chown nobody.netdisco /usr/local/netdisco/mason</pre>
</dd>
<dd>
<p>The name of the user is listed in <code>httpd.conf</code> under the <code>User</code> directive.
Some distros use the name <code>apache</code> or <code>www</code> as the web server unix user.</p>
</dd>
</li>
</dl>
<p>
</p>
<h2><a name="8__perl_modules">8. Perl Modules</a></h2>
<p>Below is a list of required modules for Netdisco, freely available from
CPAN <a href="http://www.cpan.org">http://www.cpan.org</a>.   Many of these modules have prerequisite
modules.  Many of these are available in distros already as packages.</p>
<p>PLEASE check that you have these in package form first to allow for
automatic updating of these dependency libraries.   A good place to start is the
Mason library.</p>
<dl>
<dt><strong><a name="item__5b8_2e1_5d_install_required_perl_modules_from_cpa">[8.1] Install required Perl modules from CPAN</a></strong>

<dd>
<p>Use the CPAN module that comes with Perl to install the modules
and their prerequisites automatically:</p>
</dd>
<dd>
<pre>
    perl -MCPAN -e shell</pre>
</dd>
<dd>
<pre>
        o conf prerequisites_policy ask
        install Digest::MD5
        install Bundle::DBI
        install Apache::DBI
        install DBD::Pg
        install DB_File      (for Apache::Session)
        install Apache::Session
        install HTML::Entities
        install HTML::Mason
        install MasonX::Request::WithApacheSession
        install Graph        ( &gt; 0.50 )
        install GraphViz     ( &gt; 2.02 )
        install Compress::Zlib (probably already have this one)
        install Parallel::ForkManager
        install Net::NBName (optional for NetBIOS lookup on devices)
        install Net::LDAP (optional for LDAP authentication)
        install Net::SSLeay (optional for encrypted LDAP authentication)
        install IO::Socket::SSL (optional for encrypted LDAP authentication)</pre>
</dd>
<dd>
<p>For Apache1 install these modules:</p>
</dd>
<dd>
<pre>
        install Apache::Test (for Apache::Request, you may need to do a 'force install')
        install Apache::Request</pre>
</dd>
<dd>
<p>For Apache2 install this module:</p>
</dd>
<dd>
<pre>
        install Apache2::Request</pre>
</dd>
<dd>
<p>Some of these you will probably already have installed. Others you may need to force
with <code>force install ModuleName</code>.  <strong>Do Not</strong> include the comments in (parens)!</p>
</dd>
</li>
<dt><strong><a name="item__5b8_2e2_5d_non_2dstandard_perl_location">[8.2] Non-Standard Perl Location</a></strong>

<dd>
<p>If you don't have Perl installed in <code>/usr/bin</code>, you will need to modify
the first lines of <em>netdisco</em> and <em>bin/doc_munge</em> to point to the
version of Perl you would like to use.</p>
</dd>
</li>
</dl>
<p>
</p>
<h2><a name="9__netdisco_configuration">9. Netdisco Configuration</a></h2>
<dl>
<dt><strong><a name="item__5b9_2e1_5d_netdisco_2econf">[9.1] netdisco.conf</a></strong>

<dd>
<p>Modify <em>netdisco.conf</em> to match your site.</p>
</dd>
<dd>
<p>See <em>README</em> for detailed configuration descriptions.</p>
</dd>
</li>
<dt><strong><a name="item__5b9_2e2_5d_netdisco_apache_2econf">[9.2] netdisco_apache.conf</a></strong>

<dd>
<p>Change the follow lines in <em>netdisco_apache.conf</em> to match
your database user name and password that you picked in
step 4.2:</p>
</dd>
<dd>
<pre>
    session_user_name
    session_password
    session_cookie_domain</pre>
</dd>
</li>
<dt><strong><a name="item__5b9_2e3_5d_netdisco_2ecrontab">[9.3] netdisco.crontab</a></strong>

<dd>
<p>Use this crontab to control the frequency of data collection done by Netdisco.
See section 15 of this document for details.</p>
</dd>
<dd>
<p>Change <code>center_network_device</code> to a network device that is well connected to the main
segment by a supported discovery protocol (CDP/FDP/SONMP/LLDP).</p>
</dd>
</li>
<dt><strong><a name="item__5b9_2e4_5d_add_a_web_user_in_netdisco">[9.4] Add a web user in Netdisco</a></strong>

<dd>
<p>Add a user to the Netdisco application that will be the administrator account.</p>
</dd>
<dd>
<pre>
    /usr/local/netdisco/netdisco -u joebob</pre>
</dd>
<dd>
<p>Add more users from the web <code>Admin Panel</code> once Netdisco is up and running.</p>
</dd>
</li>
<dt><strong><a name="item_documentation">[9.5] Make Documentation (CVS Versions Only)</a></strong>

<dd>
<p>This step is only necessary if you have installed from CVS.</p>
</dd>
<dl>
<dt><strong><a name="item_i_2e_perl_location">i. Perl Location</a></strong>

<dd>
<p>Make sure that the <code>POD2TEXT</code> lines in <em>Makefile</em> point to where your Perl binaries
are installed.</p>
</dd>
</li>
<dt><strong><a name="item_ii_2e_create_docs">ii. Create Docs</a></strong>

<dd>
<p>This step will create documentation files from the source <code>.pod</code>, <code>.pm</code>, and
<code>.pl</code> files.</p>
</dd>
<dd>
<pre>
 cd /usr/local/netdisco &amp;&amp; gmake doc</pre>
</dd>
<dd>
<p>Run this step if you would like the SNMP::Info documentation available from
Netdisco.</p>
</dd>
</li>
</dl>
<dt><strong><a name="item__5b9_2e6_5d_change_permissions_on_config_files">[9.6] Change Permissions on Config files</a></strong>

<dd>
<p>Since the config files contain SNMP community strings and database passwords,
you must make them only available to the administrators for security.</p>
</dd>
<dd>
<pre>
 chgrp netdisco /usr/local/netdisco/*.conf
 chmod 660 /usr/local/netdisco/*.conf</pre>
</dd>
</li>
</dl>
<p>
</p>
<h2><a name="10__oui_database">10. OUI Database</a></h2>
<p>The <code>Organizationally Unique Identifier</code> (OUI) database allows Netdisco to
identify the manufacture of a network card using the first 24 bits of the MAC
address.</p>
<p>Run the following command to import the contents of <em>oui.txt</em> into your
database.</p>
<pre>
    cd /usr/local/netdisco
    netdisco -O</pre>
<p>If you run into errors because of UTF-8 or other exotic characters
in oui.txt you may need to add this line to <em>netdisco.conf</em>.</p>
<pre>
    db_Pg_env = PGCLIENTENCODING =&gt; iso8859-1</pre>
<p>You may also try changing the above from <code>iso8859-1</code> to <code>UTF-8</code>.</p>
<dl>
<dt><strong><a name="item_txt">[10.1] Updating oui.txt (Optional)</a></strong>

<dd>
<p>The database of OUIs is needed by Netdisco and is available from the IEEE.</p>
</dd>
<dd>
<p>This will use <code>wget</code> to download <em>oui.txt</em> from the IEEE and import it into
the Netdisco database.</p>
</dd>
<dd>
<pre>
    cd /usr/local/netdisco
    gmake oui</pre>
</dd>
<dd>
<p>If you do not have <code>wget</code> download <em>oui.txt</em> manually and run <code>netdisco -O</code>.</p>
</dd>
</li>
</dl>
<p>
</p>
<h2><a name="11__restart_apache">11. Restart Apache</a></h2>
<p>Now that you have everything setup, ``cold'' restart the
web-server.</p>
<pre>
    apachectl stop
    apachectl start</pre>
<p>Check the apache <em>error_log</em> for errors.
See <a href="#os_specific_notes">OS Specific Notes</a> below for details.</p>
<p>
</p>
<h2><a name="12__discover_a_device_in_netdisco">12. Discover a Device in Netdisco</a></h2>
<p>Pick a device that you can access with the command <code>snmpwalk</code>.
Tell Netdisco to discover that device:</p>
<pre>
    cd /usr/local/netdisco
    ./netdisco -d devicename</pre>
<p>Make sure that this step actually works.  This is a good metric that you have
now installed Netdisco correctly.  Add the <em>-D</em> flag to get copious debugging
info.</p>
<p>
</p>
<h2><a name="13__create_network_topology">13. Create Network Topology</a></h2>
<p>See <em>README</em> for a description of <em>Topology Information</em>.</p>
<p>If your network uses a supported topology discovery protocol
(CDP/FDP/SONMP/LLDP) pick a device that you consider close to the center of the
network and start an auto-discovery from there:</p>
<pre>
    cd /usr/local/netdisco
    ./netdisco -r myrouter</pre>
<p>If your network is <em>not</em> CDP friendly, then see <em>README</em> for how to use the
manual topology file <em>netdisco-topology.txt</em>.</p>
<p>You MUST supply Netdisco with a working topology or MAC addresses will show up
on uplink ports instead of end ports.</p>
<p>
</p>
<h2><a name="14__test_web_side">14. Test Web Side</a></h2>
<p>First restart Apache so that Netdisco will see the changes that you have made
in <em>netdisco.conf</em>.  Note that a <em>graceful</em> restart will not re-read the
configuration file.  A full restart is required.  See Step 11.</p>
<p>Next, point a browser to <em>/netdisco</em> on the server you have Netdisco installed
on.</p>
<pre>
    <a href="http://localhost/netdisco">http://localhost/netdisco</a></pre>
<p>If everything is working you should be able to login with the user name and
password you added in Step 9.4.  You should also be able to access the Admin
Panel.</p>
<p>If you have problems, check the <em>error_log</em> of apache for messages.</p>
<pre>
    tail /usr/local/apache/logs/error_log</pre>
<p>
</p>
<h2><a name="15__add_cron_jobs">15. Add Cron Jobs</a></h2>
<p>Once you're sure Netdisco is setup correctly, modify
<em>netdisco.crontab</em>.</p>
<pre>
 vi netdisco.crontab</pre>
<dl>
<dt><strong><a name="item_network_discovery">Network Discovery</a></strong>

<dd>
<p>Change <code>center_network_device</code> to one of your core routers or switches.</p>
</dd>
</li>
<dt><strong><a name="item_data_collection">Data Collection</a></strong>

<dd>
<p>You may want to fine-tune these jobs to your network.  If jobs run too frequent
and overlap, nothing bad will happen, it's just higher load on your network
devices and Netdisco server.</p>
</dd>
<dd>
<p>Once Netdisco has been running for a day, look at the <code>BackEnd Log</code> in the web
browser and see how long each of the jobs is taking to finish.  If there is overlap,
for example if your arpnip is taking over 60 minutes or your macsuck is taking
over 120 minutes, then consider decreasing the frequency of these jobs as to not
cause extra load on your network devices.</p>
</dd>
</li>
</dl>
<p>Now, as <code>root</code>, load the crontab for the <code>netdisco</code> user.</p>
<pre>
    su
    crontab -u netdisco /usr/local/netdisco/netdisco.crontab</pre>
<p>
</p>
<h2><a name="16__start_the_netdisco_admin_daemon">16. Start the Netdisco Admin Daemon</a></h2>
<p>The admin deaemon performs administration jobs that are requested from the
web front-end.  See <em>README</em> for a full description of the admin daemon.</p>
<pre>
    /usr/local/netdisco/bin/netdisco_daemon start</pre>
<p>The daemon will be respawned daily in the Cron job listed above.  The restart
is not 100% necessary, it is added as a precaution in case any of the
prerequisite libraries have memory leaks.</p>
<dl>
<dt><strong><a name="item__5b16_2e1_5d_make_the_admin_daemon_start_at_every_">[16.1] Make the Admin Daemon start at every boot</a></strong>

<dd>
<p>If you would like the daemon to be started upon bootup, then do the following:</p>
</dd>
<dl>
<dt><strong>Linux</strong>

<dd>
<p>This is for Redhat/Mandrake/Fedora.  Debian and Gentoo might be a little different.</p>
</dd>
<dd>
<pre>
    ln -s /usr/local/netdisco/bin/netdisco_daemon /etc/rc.d/init.d
    chkconfig --add netdisco_daemon
    chkconfig netdisco_daemon on</pre>
</dd>
<dd>
<p>Now you should be able to use this command:</p>
</dd>
<dd>
<pre>
    service netdisco_daemon {stop,start,restart,status}</pre>
</dd>
</li>
<dt><strong><a name="item_freebsd">FreeBSD</a></strong>

<dd>
<pre>
    ln -s /usr/local/netdisco/bin/netdisco_daemon /usr/local/etc/rc.d/netdisco.sh</pre>
</dd>
<dt><strong><a name="item_other">Other</a></strong>

<dd>
<p>Add the following line to your <em>/etc/rc.d/rc.local</em> file :</p>
</dd>
<dd>
<pre>
    /usr/local/netdisco/bin/netdisco_daemon start</pre>
</dd>
</li>
</dl>
</dl>
<p>
</p>
<hr />
<h1><a name="os_specific_notes">OS Specific Notes</a></h1>
<p>
</p>
<h2><a name="freebsd">FreeBSD</a></h2>
<p>A port is available for FreeBSD in <code>/usr/ports/net-mgmt/netdisco</code>.  Make sure
that the port is up to date with this version of Netdisco.  This is the best
way to install Netdisco on FreeBSD.</p>
<ul>
<li><strong><a name="item_postgres">Postgres</a></strong>

<p>Install Postgres from ports:</p>
<pre>
    cd /usr/ports/databases/postgresql83-server
    make install</pre>
<p>Make sure Postgres is configured to start at system startup time by
putting</p>
<pre>
    postgresql_enable=&quot;YES&quot;</pre>
<p>in <em>/etc/rc.conf</em>.</p>
<p>Next initialize the database:</p>
<pre>
    /usr/local/etc/rc.d/010.pgsql.sh initdb</pre>
<p>And start the database server:</p>
<pre>
    /usr/local/etc/rc.d/010.pgsql.sh start</pre>
</li>
<li><strong>Net-SNMP</strong>

<p>Install Net-SNMP from ports.</p>
<pre>
    cd /usr/ports/net/net-snmp &amp;&amp; make install</pre>
</li>
<li><strong><a name="item_make">Make</a></strong>

<p>Anywhere in this document you see a reference to <em>make</em> you should
run <em>gmake</em>.</p>
</li>
<li><strong><a name="item_snmp_3a_3ainfo">SNMP::Info</a></strong>

<p>SNMP::Info is available on ports.  Please check that the version listed
there is as new as the version required by Netdisco.</p>
<pre>
    cd /usr/ports/net-mgmt/p5-SNMP-Info
    make install</pre>
</li>
<li><strong>GraphViz</strong>

<p>GraphViz is available on ports:</p>
<pre>
    cd /usr/ports/graphics/graphviz &amp;&amp; make install</pre>
</li>
<li><strong><a name="item_apache_restart">Apache Restart</a></strong>

<p>For the ports version of apache, to cold restart (ie. for Step 11) or for
whenever you change the config file, use this command :</p>
<pre>
    /usr/local/etc/rc.d/apache2.sh stop
    /usr/local/etc/rc.d/apache2.sh start</pre>
<p>or</p>
<pre>
    /usr/local/etc/rc.d/apache.sh stop
    /usr/local/etc/rc.d/apache.sh start</pre>
<p>Also, double-check that Apache starts on its own at reboot.  On BSD,
make sure that you've added</p>
<pre>
    apache2_enable=&quot;YES&quot;</pre>
<p>to <em>/etc/rc.conf</em>.</p>
</li>
<li><strong>Perl Modules</strong>

<p>You can install these Perl modules from Ports</p>
<pre>
    www/p5-HTML-Mason
    database/p5-DBI
    database/p5-DBD-Pg
    www/p5-Apache-DBI
    www/p5-Apache-Session
    www/p5-MasonX-Request-WithApacheSession</pre>
</li>
<li><strong><a name="item_apache2">Apache2</a></strong>

<p>Install these ports</p>
<pre>
    www/apache22
    www/mod_perl2
    www/p5-libapreq2</pre>
</li>
<li><strong><a name="item_apache1">Apache1</a></strong>

<p>If you choose to use apache1 from source you will need to
install OpenSSL to provide a secure (https) server.</p>
<p>Installing OpenSSL :</p>
<pre>
    cd /usr/ports/devel/mm &amp;&amp; make install
    cd /usr/ports/security/openssl &amp;&amp; make install</pre>
<p>Setup mod_ssl :</p>
<pre>
    cd /path/to/mod_ssl_1.x.x
    SSL_BASE=SYSTEM \
        ./configure \
            --with-apache=../apache_1.3.x \
            --disable_rule=SSL_COMPAT</pre>
</li>
</ul>
<p>
</p>
<h2><a name="mac_os_x">Mac OS X</a></h2>
<ul>
<li><strong>Postgres</strong>

<p>See <a href="http://developer.apple.com/internet/macosx/postgres.html">http://developer.apple.com/internet/macosx/postgres.html</a> for detailed instructions
on installing PostgreSQL with OS X.</p>
</li>
<li><strong>GraphViz</strong>

<p>It is reported to be in <code>DarwinPorts</code> or you can check out
<a href="http://www.phil.uu.nl/~js/graphviz/">http://www.phil.uu.nl/~js/graphviz/</a>.</p>
</li>
<li><strong>Apache1</strong>

<p>See the very old, following three links in addition to this document to use
Apache1 w/ OS X:</p>
<pre>
 <a href="http://www.oreillynet.com/pub/a/mac/2002/11/05/apache_osx.html">http://www.oreillynet.com/pub/a/mac/2002/11/05/apache_osx.html</a>
 <a href="http://www.oreillynet.com/pub/a/mac/2002/12/18/apache_modssl.html">http://www.oreillynet.com/pub/a/mac/2002/12/18/apache_modssl.html</a>
 <a href="http://www.oreillynet.com/pub/a/mac/2003/02/07/libapreq_update.html">http://www.oreillynet.com/pub/a/mac/2003/02/07/libapreq_update.html</a></pre>
</li>
</ul>
<p>
</p>
<h2><a name="linux__generic">Linux - Generic</a></h2>
<p>Here are some notes for installing Netdisco on Linux.  If your distro is not
listed here, look over the install scripts for other distros at
<a href="http://www.auburn.edu/~gouldwp/netdisco/">http://www.auburn.edu/~gouldwp/netdisco/</a> in the READMEs section.</p>
<ul>
<li><strong>Net-SNMP</strong>

<p>If you have installed the Net-SNMP RPM from an <code>old</code> Redhat or Mandrake it
<strong>does not</strong> include the Perl modules.  <strong>Uninstall it</strong> and install a newer
version by hand as below.</p>
<pre>
    rpm -e net-snmp</pre>
<p>Same goes for Debian.  DO NOT use the apt-get version of Net-SNMP,
install by hand (it's easy!).</p>
</li>
<li><strong>GraphViz</strong>

<p>For Redhat and Mandrake systems you will make sure that a lot of <code>-devel</code>
packages are installed.   For example, if  you see errors about not having a
PNG or JPEG library you must install the <code>-devel</code> packages of those libraries
as needed:</p>
<pre>
    urpmi libjpeg62-devel libpng3-devel</pre>
<p>If you get some weird error in build about not having <code>intl.la</code> then
make sure you have the <em>gettext</em> packages installed :</p>
<pre>
    urpmi gettext-devel</pre>
</li>
<li><strong>Apache Restart</strong>

<p>For most Linux distros where you use the built-in apache web server
use one of these commands to cold restart Apache in Step 11 :</p>
<pre>
  service httpd stop
  service httpd start</pre>
<p>OR</p>
<pre>
    /path/to/init.d/httpd stop
    /path/to/init.d/httpd start</pre>
<p>For the path try <em>/etc/init.d</em> or <em>/etc/rc.d/init.d</em>.</p>
</li>
<li><strong>Apache1</strong>

<p>Warning: Some Linux distributions such as Redhat 6.x install mod_perl as a
Dynamic Shared Object (DSO).  This is known to be unstable, especially with
Mason.  Compile mod_perl statically using the method listed above if your
distro compiles mod_perl1 using DSOs.  If you suspect yours is not compiled in,
run <code>httpd -l</code> and see if <code>mod_perl.c</code> is listed (it should be).</p>
<p>OpenSSL is required for a secure (https) server when using apache1.
OpenSSL is installed by default on most Linux distros.</p>
<p>You will have to tell the OS to look for the Kerberos libraries
used in this version of OpenSSL:</p>
<pre>
    ./configure \
        --with-apache=../apache_1.3.x \
        --disable_rule=SSL_COMPAT
    make C_INCLUDE_PATH=/usr/kerberos/include</pre>
<p>(Thanks to David Martin for this info)</p>
</li>
</ul>
<p>
</p>
<h2><a name="fedora___centos___redhat">Fedora / CentOS / Redhat</a></h2>
<p>Netdisco 0.95 packages are available in the Fedora 11 repositories, and the
EPEL repositories for RHEL/CentOS 5.</p>
<p>Newer releases may be available from the package author's website, at
<a href="http://www.auburn.edu/~gouldwp/netdisco">http://www.auburn.edu/~gouldwp/netdisco</a>.</p>
<p>We expect RPMs for Netdisco 1.0 and its dependencies to appear in the Fedora
and EPEL repositories in due course.</p>
<p>
</p>
<h2><a name="mandrivia_linux">Mandrivia Linux</a></h2>
<p>An RPM is available for Mandrivia Linux, but may be out of date.  Please check
that the RPM for Netdisco 0.95 is marked at least 200611 or newer.</p>
<p>
</p>
<h2><a name="debian_linux">Debian Linux</a></h2>
<p>Debian 5.0 (Lenny) contains the Netdisco 0.95 packages and all dependencies.
Newer releases may be available at <a href="http://packages.debian.org/netdisco">http://packages.debian.org/netdisco</a>.</p>
<p>We expect packages for Netdisco 1.0 and its dependencies to appear in the
official repositories for Debian ``Squeeze'' in due course.</p>
<ul>
<li><strong>GraphViz</strong>

<p>Jordi Guijarro reported that the version that comes with Woody is too old.
Install a newer version from source.</p>
</li>
</ul>
<p>
</p>
<h2><a name="mandrake_linux_9_1">Mandrake Linux 9.1</a></h2>
<p>Netdisco has been tested with Mandake 9.1</p>
<ul>
<li><strong><a name="item_perl_5_2e8_2e1">Perl 5.8.1</a></strong>

<p>Perl 5.8.1 on Mandrake 9.x may be a problem (if you get
an <code>out of memory</code> error, you may need to change to
5.6.1 or 5.8.3+).</p>
</li>
<li><strong>Postgres</strong>

<p>Installing Postgres the easy way:</p>
<pre>
    urpmi postgresql postgresql-devel postgresql-server postgresql-docs</pre>
<p>The files you will need to edit below are in <em>/var/lib/pgsql/data</em>.</p>
<p>If you lost / don't have install CDs :</p>
<p>The following line uses an FTP site that has the 9.0 RPMs because I lost
the CDs.  Check the current mirror list at <a href="http://www.mandrakelinux.com/en/ftp.php3">http://www.mandrakelinux.com/en/ftp.php3</a>
and choose a mirror close to you.</p>
<pre>
    urpmi.addmedia ftpsite <a href="ftp://mirror.mcs.anl.gov/pub/Mandrake-old/9.0/i586/Mandrake/RPMS">ftp://mirror.mcs.anl.gov/pub/Mandrake-old/9.0/i586/Mandrake/RPMS</a> \
        with ../base/hdlist.cz</pre>
<p>Now you have to add <code>--media ftpsite</code>  in each <code>urpmi</code> command like so :</p>
<pre>
    urpmi --media ftpsite postgresql postgresql-devel</pre>
<p>Remember this for the Apache setup too.</p>
</li>
<li><strong>Apache</strong>

<p>Mandrake 9.1 comes with Apache2.  It also has the option
of installing a version of Apache1/mod_perl on a different port
and then reverse-proxying it.</p>
<p>Install Apache1 and Mod_Perl 1 and their development packages :</p>
<pre>
    urpmi apache-devel-1 mod_perl-devel-1 apache-mod_perl-1 mod_perl-common-1</pre>
<p>Mandrake 9.1 - Do this for the DB_File Perl module</p>
<pre>
    ln -s /usr/include/db1/* /usr/include
    ln -s /usr/lib/libdb1.so.2 /usr/lib/libdb.so</pre>
<p><strong>Configure Both Apaches:</strong></p>
<p>Mandrake and some Redhats come with two copies of Apache installed.
The mod_perl server sits on a weird port and is reversed proxied by
a normal Apache server.</p>
<p>Mandrake 9.0 uses two Apache1 servers, while Mandrake 9.1 uses an
Apache2 server that sits in front of the apache1/mod_perl server.</p>
<p>Configuration files for Mandrake live in <em>/etc/httpd/conf</em></p>
<p>In the file <em>httpd-perl.conf</em> add the two <code>Include</code> lines:</p>
<pre>
    Include /usr/local/netdisco/netdisco_apache.conf
    Include /usr/local/netdisco/netdisco_apache_dir.conf</pre>
<p>In the file <em>httpd.conf</em> (<em>httpd2.conf</em> for 9.1) add the final <code>RewriteRule</code> line:</p>
<pre>
    &lt;IfModule mod_rewrite.c&gt;
    RewriteEngine on
    RewriteRule ^proxy:.*  -  [F]
    RewriteRule ^(.*\/perl\/.*)$  <a href="http://%">http://%</a>{HTTP_HOST}:8200$1 [P]
    RewriteRule ^(.*\/cgi-perl\/.*)$  <a href="http://%">http://%</a>{HTTP_HOST}:8200$1 [P]
    RewriteRule ^(.*\/netdisco\/.*)$  <a href="http://%">http://%</a>{HTTP_HOST}:8200$1 [P]
    &lt;/IfModule&gt;</pre>
<p>In the file <em>commonhttpd.conf</em> add the Alias line :</p>
<pre>
    Alias /netdisco /netdisco/</pre>
<p>Restart Apache.</p>
<pre>
    /etc/rc.d/init.d/httpd restart</pre>
</li>
</ul>
<p>
</p>
<h2><a name="solaris">Solaris</a></h2>
<p>See <a href="http://www.saintmarys.edu/~dmckeown/netdisco_solaris10.htm">http://www.saintmarys.edu/~dmckeown/netdisco_solaris10.htm</a> for 
a great document on getting Netdisco 0.94 to work with Solaris 10.</p>
<ul>
<li><strong>Make</strong>

<p>Anywhere in this document you see a reference to <em>make</em> you should
run <em>gmake</em>.</p>
</li>
<li><strong>GraphViz</strong>

<p>Make the JPEG and EXPAT libraries first and when making the JPEG library
make sure you have</p>
<pre>
    ./configure --enabled-shared --enabled-static</pre>
</li>
</ul>
<p>
</p>
<hr />
<h1><a name="success">SUCCESS</a></h1>
<p>Now that you have spent ten hours of your life installing this go drink a Beer,
you deserve it.</p>
<p>Once you have or have not succeeded, come join the Netdisco User's mailing list
at <a href="http://netdisco.org">http://netdisco.org</a> and pass on any hints you may have in the INSTALL
process.  It's a good place to keep up on new features and releases, and it's
<strong>the</strong> place to ask any questions.</p>
<p>The developers are now maintaining a registry of Netdisco installs.  This is
mainly for morale boosting purposes, but also helps us direct feature requests
to our target audience.  One drawback of the Source Forge system is that we
have no idea how many people are using the software compared to the number of
downloads.  So after you have Netdisco up and running please spend a minute to
let us know you're using it at <a href="http://netdisco.org/register.html">http://netdisco.org/register.html</a>.</p>

</%text>