- Patch NMIS8 code with the NMIS8.4.6G
- Patch NMIS8 Config
- Update Server Configuration
- Setup SNMP Trap Daemon
- Fix Data Type for Some Counters
- Restart Daemons
- Update the Font Cache
- Clean up and Test
There is one major change to the upgrade process which is in the instructions below, the rest of the guide is the same as previous upgrade instructions. 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.nmis are made (specifically for this release a newer version of jQuery is being used.
Patch NMIS8 code with the NMIS8.4.6G
Checking Model Changes
Recent releases have included 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 (git could be your friend here). To overwrite your existing 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:
Most of the config files will likely be the same as the install version, for these you can just copy the new versions
If you haven't changed your users you can update these:
Update Server Configuration
The new crontab which you generate by running this command /usr/local/nmis8/bin/nmis.pl type=crontab
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"
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.
This needs to be set to blank unless you intentionally want it to be "true"
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.
This config setting "tables_case_sensitive_keys" is redundant, it is being done in the Tables.nmis file now.
Change Config.nmis to tell NMIS to use the new file permission scheme
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
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)
Create new config to replace old config and restart apache
Setup SNMP Trap Daemon
NMIS 8.4.6 includes some Cisco and Generic MIBS and has 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.
You can test the MIB resolution with this command
Which should result in:
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
Fix Data Type on TopChanges Counters
Run this command to make TopChanges the DS's COUNTER instead of GAUGE
Update the Font Cache
In order to make RRD run faster it really helps to update the font cache