Date: Thu, 28 Mar 2024 17:38:16 +0000 (UTC) Message-ID: <562945721.3924.1711647496745@skald.opmantek.com> Subject: Exported From Confluence MIME-Version: 1.0 Content-Type: multipart/related; boundary="----=_Part_3923_1795929251.1711647496744" ------=_Part_3923_1795929251.1711647496744 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Content-Location: file:///C:/exported.html
There is one major change to the upgrade process which is in the instruc= tions below, the rest of the guide is the same as previous upgrade instruct= ions. The new script, install/update_config_defaults.pl needs to be run at = the end of the configuration upgrade to ensure required changes to Config.n= mis are made (specifically for this release a newer version of jQuery is be= ing used.
#Backup current N= MIS code and config including models DATE=3D`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=3Dcollect debug=3Dtrue node=3D<node to= test> #Get CP working right. (no prompts) unalias cp #Set NMIS version nmisver=3D8.4.6g =20 #Unarchive the NMIS tarball cd ~ tar xvf nmis$nmisver.tar.gz mkdir /usr/local/nmis8/models-install =20 # Patch the Code Base cp nmis$nmisver/admin/* /usr/local/nmis8/admin cp nmis$nmisver/bin/* /usr/local/nmis8/bin cp nmis$nmisver/cgi-bin/* /usr/local/nmis8/cgi-bin cp -r nmis$nmisver/mibs/* /usr/local/nmis8/mibs=20 cp -r nmis$nmisver/install/* /usr/local/nmis8/install cp -r nmis$nmisver/lib/* /usr/local/nmis8/lib cp -r nmis$nmisver/menu/* /usr/local/nmis8/menu cp nmis$nmisver/models-install/* /usr/local/nmis8/models-install
Recent releases have included many device modelling enhancements, improv= ed graphs and more, if you have made no changes to your models you can over= write your existing models, otherwise you will need to merge the new models= with the existing models, that requires consideration outside this documen= t (git could be your friend here). To overwrite your existing models:=
cp /usr/local/nmi= s8/models-install/* /usr/local/nmis8/models
Your NMIS installation may have settings that you have changed from the = default installation. If you would like to keep these changes you wil= l need to merge the additional fields that have been added into the stock c= onfiguration into your custom configuration. NMIS provides a tool cal= led updateconfig.pl to help you do this:
# merge changes f= or new NMIS Config options.=20 /usr/local/nmis8/admin/updateconfig.pl /usr/local/nmis8/install/Config.nmis= /usr/local/nmis8/conf/Config.nmis /usr/local/nmis8/admin/updateconfig.pl /usr/local/nmis8/install/Access.nmis= /usr/local/nmis8/conf/Access.nmis=20 # update default config options that have been changed: /usr/local/nmis8/install/update_config_defaults.pl /usr/local/nmis8/conf/Co= nfig.nmis
Most of the config files will likely be the same as the install version,= for these you can just copy the new versions
# copy newer conf= iguration files (check that you don't have local changes to these files bef= ore running)=20 cp /usr/local/nmis8/install/Tables.nmis /usr/local/nmis8/conf=20 cp /usr/local/nmis8/install/Table-*.nmis /usr/local/nmis8/conf=20 cp /usr/local/nmis8/install/Logs.nmis /usr/local/nmis8/conf=20 cp /usr/local/nmis8/install/Services.nmis /usr/local/nmis8/conf cp /usr/local/nmis8/install/License.nmis /usr/local/nmis8/conf cp /usr/local/nmis8/install/Modules.nmis /usr/local/nmis8/conf cp /usr/local/nmis8/install/Escalations.nmis /usr/local/nmis8/conf cp /usr/local/nmis8/install/Portal.nmis /usr/local/nmis8/conf cp /usr/local/nmis8/install/logrotate.conf /usr/local/nmis8/conf
If you haven't changed your users you can update these:
cp /usr/local/nmi= s8/install/Users.nmis /usr/local/nmis8/conf=20 cp /usr/local/nmis8/install/users.dat /usr/local/nmis8/conf
The new crontab w= hich you generate by running this command /usr/local/nmis8/bin/nmis.pl= type=3Dcrontab
MAILTO=3DWhoeverY= ouAre@yourdomain.tld=20 ###################################################### # NMIS8 Config ###################################################### # Run Statistics Collection */5 * * * * /usr/local/nmis8/bin/nmis.pl type=3Dcollect mthread=3Dtrue maxt= hreads=3D10 ###################################################### # Run Summary Update every 2 minutes */2 * * * * /usr/local/nmis8/bin/nmis.pl type=3Dsummary ##################################################### # Run the interfaces 4 times an hour with Thresholding on!!! # if threshold_poll_cycle is set to false, then enable cron based threshold= ing #*/15 * * * * nice /usr/local/nmis8/bin/nmis.pl type=3Dthreshold ###################################################### # Run the update once a day=20 30 20 * * * nice /usr/local/nmis8/bin/nmis.pl type=3Dupdate mthread=3Dtrue = maxthreads=3D10 ###################################################### # 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 10 0 * * * /usr/local/nmis8/bin/run-reports.pl day top10 30 0 * * * /usr/local/nmis8/bin/run-reports.pl day outage 40 0 * * * /usr/local/nmis8/bin/run-reports.pl day response 45 0 * * * /usr/local/nmis8/bin/run-reports.pl day avail 50 0 * * * /usr/local/nmis8/bin/run-reports.pl day port # weekly 0 1 * * 0 /usr/local/nmis8/bin/run-reports.pl week health 10 1 * * 0 /usr/local/nmis8/bin/run-reports.pl week top10 30 1 * * 0 /usr/local/nmis8/bin/run-reports.pl week outage 40 1 * * 0 /usr/local/nmis8/bin/run-reports.pl week response 50 1 * * 0 /usr/local/nmis8/bin/run-reports.pl week avail # monthly 0 2 1 * * /usr/local/nmis8/bin/run-reports.pl month health 10 2 1 * * /usr/local/nmis8/bin/run-reports.pl month top10 30 2 1 * * /usr/local/nmis8/bin/run-reports.pl month outage 40 2 1 * * /usr/local/nmis8/bin/run-reports.pl month response 50 2 1 * * /usr/local/nmis8/bin/run-reports.pl month avail ###########################################
You will need to verify the following configuration options have been se= t correctly or removed. You can edit the configuration through the NM= IS UI or with your favorite editor "vi /usr/local/nmis8/conf/Config.nmis"= p>
There are some updates to improve UI and polling synchronisation. &= nbsp;Check the following configuration option for nmis_summary_poll_cycle, = it should be set to false and the summary update added to the crontab.
'nmis_summary_po= ll_cycle' =3D> 'false',
This needs to be set to blank unless you intentionally want it to be "tr= ue"
'global_nocollect= _noDescription' =3D> '',
We have found this is better set to a lower number, but if your experien= ce has been otherwise, you do not need to change it.
'fastping_node_po= ll' =3D> '200',
This config setting "tables_case_sensitive_keys" is redundant, it is being done in the Table= s.nmis file now.
Change Config.nmis to tell NMIS to use the new file permission scheme
%hash =3D ( --SNIP--=20 'system' =3D> { --SNIP-- 'os_execperm' =3D> '0770', 'os_fileperm' =3D> '0660',
We recommend updating the authentication system from apache to htpasswd = (so NMIS does authentication instead of Apache). 3 steps need to be taken t= o change this.
Change Config.nmis to tell NMIS to use htpasswd
%hash =3D ( --SNIP--=20 'authentication' =3D> { --SNIP-- 'auth_method_1' =3D> 'htpasswd', # <=3D change this FROM apache T= O htpasswd
Backup old apache configGenerate new apache configuration (if you ha= ve customised yours edit it and remove the auth portions instead of generat= ing a new one)
#backup old confi= g cd /etc/httpd/conf.d/ cp 00nmis.conf 00nmis.conf.pre-8.4.6G.bak
Create new config to replace old config and restart apache
/usr/local/nmis8/= bin/nmis.pl type=3Dapache > /etc/httpd/conf.d/00nmis.conf service httpd restart
NMIS 8.4.6 includes some Cisco and Generic MIBS and has the ability to v= iew the SNMP traps in the NMIS logging tool.
You will need to copy the options file to the right location and restart= the daemon.
cp /usr/local/nmi= s8/install/snmptrapd.options /etc/sysconfig/snmptrapd=20 service snmptrapd restart
You can test the MIB resolution with this command
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:
CISCO-CONFIG-MAN-= MIB::ccmHistoryEventConfigDestination.34
Run this command to make all the DS's COUNTER instead of GAUGE
/usr/local/nmis8/= admin/rrd_tune_mib2ip.pl run=3Dtrue change=3Dtrue
Fix Data = Type on TopChanges Counters
Run this command to make TopChanges the DS's= COUNTER instead of GAUGE
/usr/local/nmis8/= admin/rrd_tune_topo.pl run=3Dtrue change=3Dtrue
/usr/local/nmis8/= bin/fpingd.pl restart=3Dtrue
In order to make RRD run faster it really helps to upda= te the font cache
fc-cache -f -v
# optionally audi= t your config /usr/local/nmis8/bin/nmis.pl type=3Daudit # fix your config /usr/local/nmis8/bin/nmis.pl type=3Dconfig # fix permissions /usr/local/nmis8/admin/fixperms.pl # test polling /usr/local/nmis8/bin/nmis.pl type=3Dcollect debug=3Dtrue node=3D<node to= test>