Netdisco UPGRADE - Instructions on Upgrading between versions.
Max Baker
See INSTALL or README or http://netdisco.org
Here are some hints for upgrading between versions of Netdisco.
FIRST! Go read below where it says Backup Database and Backup Configuration Files and DO IT!.
The best way is to back everything up, move the configuration files out of the way and then follow INSTALL for all but the database steps.
Then change the configuration files back to match. If you reuse your old configuration file, check it against the new one to see what config file directives have been added / removed / changed.
You DO NOT wipe the database contents for an upgrade. But just in case, you will have of course made a backup by now.
Start checking the logs from your macwalk device (you can do it from the web page now) and look for the uplink warnings. Fix your topology file to match.
You will have to run the following command to add new tables and modify existing ones.
cd /usr/local/netdisco/sql ./pg_run upgrade-0.93-to-0.94.sql
Note that it is safe to run the upgrade.sql scripts more than once (in case you are running a CVS or RC version).
Creating CMAP : /usr/local/netdisco/html/netmap.map warning, language cmap not recognized, use one of: ps hpgl pcl mif...
You need a newer version of GraphViz
Please make sure this newest version is installed.
perl -MCPAN -e shell install GraphViz
Double check the version.
perl -MGraphViz -e 'print $GraphViz::VERSION'
Perl Modules and Mason
. If you use CPAN, it will
upgrade all the dependency modules for you too.
1
to 1.1
as they were folded into the new Nortel classes. The above
upgrade script will do the renaming for you, so you won't lose data.
cd /usr/local/netdisco/sql ./pg_run upgrade-0.92-to-0.93.sql
IGNORE the warning about nuking all the data in the table. It won't.
But even if you did, YOU ALREADY MADE A BACKUP RIGHT? (sql/pg_back
)
netdisco-mibs
package and use that.
Database Cleanup
or -K
when you
are done upgrading. The bug where the MAC address of switch
ports showing up on their own port has been fixed. SNMP::Info
Version 0.7 required.
session_*
directives.
You shouldn't have to upgrade apache, but now would be a good time to see if there are any security upgrades to apache or mod_perl.
When upgrading to any version, please make sure you have the newest version of SNMP::Info installed (at least 0.8) :
cd /usr/local/netdisco/SNMP cvs update
perl -MCPAN -e shell install SNMP::Info
cd /usr/local/netdisco/sql ./pg_back scp db_back*.gz somesafehost:
tar cvf - -C /usr/local netdisco | gzip > netdisco-back.tgz scp netdisco-back.tgz somesafehost: cp /usr/local/netdisco/*.conf /path/to/some_where_safe cp /usr/local/netdisco/*.txt /path/to/some_where_safe
This will REINDEX and VACUUM FULL your database.
On a recent Postgres 7.3 install this changed the database size from 16GB to 400 MB! Sound worth it?
cp -R /path/to/netdisco-new-0.999 /usr/local/netdisco
This step is optional, unless a certain Perl module is listed for your version.
graceful
or restart
) so that Netdisco
will use the newly installed version of netdisco.pm.
/usr/local/apache/bin/apachectl stop /usr/local/apache/bin/apachectl start
su - netdisco -c "/usr/local/netdisco -p restart"
=item Reload Crontab
Review netdisco.crontab and reload it for the netdisco
user.
su crontab -u netdisco /usr/local/netdisco/netdisco.crontab