...
NMIS 8.3.24G is being released for general availability, This release provides many bug fixes and a few new features.
Install CPAN Modules
NMIS8 now requires Net::Syslog, see the 8.3.9G patch for info on SMTP::SSL
Code Block | ||
---|---|---|
| ||
cpan install Net::SMTP::SSL # (required for 8.3.9G) install Net::Syslog |
Patch NMIS8 code with the NMIS8.
...
4.
...
1G
Code Block | ||
---|---|---|
| ||
#Backup current NMIS code and config including models DATE=`date "+%Y-%m-%d-%H%M"` cd /usr/local/nmis8 tar cvf ~/nmis8-backup-$DATE.tar ./admin ./bin ./cgi-bin ./conf ./install ./lib ./menu ./mibs ./models #Make sure NMIS is working before you patch it. /usr/local/nmis8/bin/nmis.pl type=collect debug=true node=<node to test> #Get CP working right. (no prompts) unalias cp #Set NMIS version nmisver=8.4.2g #Unarchive the NMIS tarball cd ~ tar xvf nmis-8.3.24g$nmisver.tar.gz mkdir /usr/local/nmis8/models-install # Patch the Code Base cp nmis8.3.24gnmis$nmisver/admin/* /usr/local/nmis8/admin cp nmis8.3.24gnmis$nmisver/bin/* /usr/local/nmis8/bin cp nmis8.3.24gnmis$nmisver/cgi-bin/* /usr/local/nmis8/cgi-bin cp -r nmis8.3.24gnmis$nmisver/mibs/* /usr/local/nmis8/mibs cp -r nmis$nmisver/install/* /usr/local/nmis8/install cp -r nmis8.3.24gnmis$nmisver/lib/* /usr/local/nmis8/lib cp -r nmis8.3.24gnmis$nmisver/menu/* /usr/local/nmis8/menu cp nmis8.3.24gnmis$nmisver/models-install/* /usr/local/nmis8/models-install |
Checking Model Changes
NMIS 8.3.24g includes many device modelling enhancements, improved graphs and more, if you have made no changes to your models you can overwrite your existing models, otherwise you will need to merge the new models with the existing models, that requires consideration outside this document. To overwrite your existing models:
Code Block |
---|
cp /usr/local/nmis8/models-install/* /usr/local/nmis8/models |
Patch NMIS8 Config
Your NMIS installation may have settings that you have changed from the default installation. If you would like to keep these changes you will need to merge the additional fields that have been added into the stock configuration into your custom configuration. NMIS provides a tool called updateconfig.pl to help you do this:
...
Code Block |
---|
# copy newer configuration files (check that you don't have local changes to these files before running) cp /usr/local/nmis8/install/Tables.nmis /usr/local/nmis8/conf cp /usr/local/nmis8/install/Table-*.nmis /usr/local/nmis8/conf cp /usr/local/nmis8/install/Logs.nmis /usr/local/nmis8/conf cp /usr/local/nmis8/install/UsersServices.nmis /usr/local/nmis8/conf cp /usr/local/nmis8/install/ServicesLicense.nmis /usr/local/nmis8/conf cp /usr/local/nmis8/install/LicenseModules.nmis /usr/local/nmis8/conf cp /usr/local/nmis8/install/ModulesEscalations.nmis /usr/local/nmis8/conf cp /usr/local/nmis8/install/EscalationsPortal.nmis /usr/local/nmis8/conf cp /usr/local/nmis8/install/Portallogrotate.nmisconf /usr/local/nmis8/conf |
If you haven't changed your users you can update these:
Code Block |
---|
cp /usr/local/nmis8/install/logrotateUsers.confnmis /usr/local/nmis8/conf cp /usr/local/nmis8/install/users.dat /usr/local/nmis8/conf |
Update Server Configuration
Crontab
The new crontab which you generate by running this command /usr/local/nmis8/bin/nmis.pl type=crontab
Code Block |
---|
MAILTO=WhoeverYouAre@yourdomain.tld ###################################################### # NMIS8 Config ###################################################### # Run Statistics Collection */5 * * * * /usr/local/nmis8/bin/nmis.pl type=collect mthread=true maxthreads=10 ###################################################### # Run Summary Update every 2 minutes */2 * * * * /usr/local/nmis8/bin/nmis.pl type=summary ##################################################### # Run the interfaces 4 times an hour with Thresholding on!!! # if threshold_poll_cycle is set to false, then enable cron based thresholding #*/15 * * * * nice /usr/local/nmis8/bin/nmis.pl type=threshold mthread=true maxthreads=10 ###################################################### # Run the update once a day 30 20 * * * nice /usr/local/nmis8/bin/nmis.pl type=update mthread=true maxthreads=10 ###################################################### # Check to rotate the logs 4am every day UTC 5 20 * * * /usr/sbin/logrotate /usr/local/nmis8/conf/logrotate.conf ################################################## # save this crontab every day 0 8 * * * crontab -l > /usr/local/nmis8/conf/crontab.root ######################################## # Run the Reports Weekly Monthly Daily # daily 0 0 * * * /usr/local/nmis8/bin/run-reports.pl day health 010 0 * * * /usr/local/nmis8/bin/run-reports.pl day top10 030 0 * * * /usr/local/nmis8/bin/run-reports.pl day outage 040 0 * * * /usr/local/nmis8/bin/run-reports.pl day response 045 0 * * * /usr/local/nmis8/bin/run-reports.pl day avail 050 0 * * * /usr/local/nmis8/bin/run-reports.pl day port # weekly 0 01 * * 0 /usr/local/nmis8/bin/run-reports.pl week health 010 01 * * 0 /usr/local/nmis8/bin/run-reports.pl week top10 030 01 * * 0 /usr/local/nmis8/bin/run-reports.pl week outage 040 01 * * 0 /usr/local/nmis8/bin/run-reports.pl week response 050 01 * * 0 /usr/local/nmis8/bin/run-reports.pl week avail # monthly 0 02 1 * * /usr/local/nmis8/bin/run-reports.pl month health 010 02 1 * * /usr/local/nmis8/bin/run-reports.pl month top10 030 02 1 * * /usr/local/nmis8/bin/run-reports.pl month outage 040 02 1 * * /usr/local/nmis8/bin/run-reports.pl month response 050 02 1 * * /usr/local/nmis8/bin/run-reports.pl month avail ########################################### |
NMIS Configuration
You will need to verify the following configuration options have been set correctly or removed. You can edit the configuration through the NMIS UI or with your favorite editor "vi /usr/local/nmis8/conf/Config.nmis"
nmis_summary_poll_cycle
There are some updates to improve UI and polling synchronisation. Check the following configuration option for nmis_summary_poll_cycle, it should be set to false and the summary update added to the crontab.
Code Block |
---|
'nmis_summary_poll_cycle' => 'false', |
global_nocollect_noDescription
This needs to be set to blank unless you intentionally want it to be "true"
Code Block |
---|
'global_nocollect_noDescription' => '', |
fastping_node_poll
We have found this is better set to a lower number, but if your experience has been otherwise, you do not need to change it.
Code Block |
---|
'fastping_node_poll' => '200', |
tables_case_sensitive_keys
This config setting "tables_case_sensitive_keys" is redundant, it is being done in the Tables.nmis file now.
File Permissions
Change Config.nmis to tell NMIS to use the new file permission scheme
Code Block |
---|
%hash = ( --SNIP-- 'system' => { --SNIP-- 'os_execperm' => '0770', 'os_fileperm' => '0660', |
Authentication
We recommend updating the authentication system from apache to htpasswd (so NMIS does authentication instead of Apache). 3 steps need to be taken to change this.
Change Config.nmis to tell NMIS to use htpasswd
Code Block %hash = ( --SNIP-- 'authentication' => { --SNIP-- 'auth_method_1' => 'htpasswd', # <= change this FROM apache TO htpasswd
Backup old apache configGenerate new apache configuration (if you have customised yours edit it and remove the auth portions instead of generating a new one)
Code Block #backup old config cd /etc/httpd/conf.d/ cp 00nmis.conf 00nmis.conf.pre-8.3.24G.bak
Create new config to replace old config and restart apache
Code Block /usr/local/nmis8/bin/nmis.pl type=apache > /etc/httpd/conf.d/00nmis.conf service httpd restart
Setup SNMP Trap Daemon
NMIS 8.4.1 has included some Cisco and Generic MIBS and added the ability to view the SNMP traps in the NMIS logging tool.
You will need to copy the options file to the right location and restart the daemon.
Code Block |
---|
cp /usr/local/nmis8/install/snmptrapd.options /etc/sysconfig/snmptrapd service snmptrapd restart |
You can test the MIB resolution with this command
Code Block |
---|
snmptranslate -m ALL -M /usr/local/nmis8/mibs/traps 1.3.6.1.4.1.9.9.43.1.1.6.1.5.34 |
Which should result in:
Code Block |
---|
CISCO-CONFIG-MAN-MIB::ccmHistoryEventConfigDestination.34 |
Fix Data Type for Some Counters
Fix Data Type on mib2ip Counters
Run this command to make all the DS's COUNTER instead of GAUGE
...
Code Block |
---|
/usr/local/nmis8/admin/rrd_tune_topo.pl run=true change=true |
Restart Daemons
Code Block |
---|
/usr/local/nmis8/bin/fpingd.pl restart=true |
Update the Font Cache
In order to make RRD run faster it really helps to update the font cache
Code Block |
---|
fc-cache -f -v |
Clean up and Test
Code Block |
---|
# optionally audit your config /usr/local/nmis8/bin/nmis.pl type=audit # fix your config /usr/local/nmis8/bin/nmis.pl type=config # fix permissions /usr/local/nmis8/admin/fixperms.pl # test polling /usr/local/nmis8/bin/nmis.pl type=collect debug=true node=<node to test> |