-
Notifications
You must be signed in to change notification settings - Fork 8
Migrating from v1.6.x to v2.x.x
Since version 2.0.0 the project has undergone a logical update in the way it works, the separation of front-end and back-end has been made, allowing greater organization, ease of maintenance and greater agility and scalability.
Based on this update, modern development techniques were applied, because of this, the functional API of the project was changed, making it no longer compatible between v1.6.x and v2.x.x.
In order to migrate to version v2.x.x from a version v1.6.x some interventions are necessary, as follows:
- The pattern for indicating the latitude and longitude of hosts:
Where it used to be:
latlng: 66.174082,-13.119136
Must be changed to:
<latlng>66.174082,-13.119136</latlng>
ATTENTION: this information should remain in the 'notes' line, the complete line should look like this:
notes <latlng>66.174082,-13.119136</latlng>
- Configuration file:
The configuration file has been changed, now instead of using separate variables for each option, a single array is used for all definitions. The old configuration file is not compatible with this new version.
Making it necessary to transcribe your settings to the new format. To assist in this task, the Migration Tool was created, which transcribes the configuration file saving your options and avoiding manual transcription.
After accessing, just paste your current settings and press migrate then the configuration in the new pattern will be generated.
You should note that some options have been renamed, some have been removed and others added, here is the comparison between the options in v1.6.x and v2.x.x:
| v1.6.x | v2.x.x |
|---|---|
| $nagios_cfg_file | general.cfg_file |
| $nagios_status_dat_file | general.status_file |
| $nagMapR_Debug | general.debug |
| $nagMapR_IsNagios | X |
| $nagMapR_MapAPI | X (Google Maps API removed due to low usage) |
| $nagMapR_MapCentre | map.centre |
| $nagMapR_MapZoom | map.zoom |
| $nagMapR_LeafletStyle | map.style |
| $nagMapR_MapType | X |
| $nagMapR_Mapkey | X |
| $nagMapR_Lang | ngreborn.language |
| $nagMapR_FilterHostgroup | ngreborn.filter_hostgroup |
| $nagMapR_FilterService | ngreborn.filter_service |
| $nagMapR_ChangesBar | X (Embedded in 'mode') |
| $nagMapR_ChangesBarMode | ngreborn.changes_bar.mode |
| $nagMapR_ChangesBarSize | ngreborn.changes_bar.size |
| $nagMapR_FontSize | ngreborn.changes_bar.font_size |
| $nagMapR_BarFilter | ngreborn.changes_bar.filter |
| X | ngreborn.priorities.unknown |
| X | ngreborn.priorities.up |
| X | ngreborn.priorities.warning |
| X | ngreborn.priorities.critical |
| X | ngreborn.priorities.down |
| $nagMapR_DateFormat | X (Now it's based on the language) |
| $nagMapR_PlaySound | ngreborn.play_sound |
| X | ngreborn.update_animation |
| $nagMapR_IconStyle | ngreborn.default_icon_style |
| $nagMapR_Lines | ngreborn.lines |
| $nagMapR_TimeUpdate | ngreborn.time_update |
| $nagMapR_Reporting | ngreborn.reporting |
| $nagMapR_key | security.key |
| X | security.allow_overwrite |
| $nagMapR_useAuth | security.use_auth |
| $nagMapR_User | security.user |
| $nagMapR_UserKey | security.user_pass |
*The explanation for each option is available in the file config.php.example
Along with all the technological improvements, some new features have also been implemented.
Besides the new interface made from scratch and better back-end performance, other new features worth highlighting are:
- New icon styles have been added, now with wi-fi symbols and routers, to better represent what is being monitored;
- The possibility to create custom icon styles natively, you can follow a tutorial here;
- It is now possible to override parameters via the URL, thus providing an easy way for when using more than one monitor or monitoring different hostgroups at the same time, you can find a tutorial here;
João Carlos.
Veja aqui em Português.