Page History
Table of Contents | ||||
---|---|---|---|---|
|
Upgrade considerations
Info |
---|
Upgrading to Uptime Infrastructure Monitor 7.2 through 7.5 Contents
...
Verify your monitoring station can access the following page so will be able to get new plugins and upgrade existing ones: http:// |
...
...
Info |
---|
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
Downloading
...
installer files
The most recent Uptime Infrastructure Monitor Installer UIM installer packages are available from the Downloads page on the Uptime Infrastructure Monitor UIM Support site (login required). Note, that Uptime Infrastructure Monitor UIM 7.2 or later releases use the same package for both new installations and upgrades. Anchor
Upgrade FAQ
Q: Do I need to upgrade my agents?
A: Agent updates are generally not required unless specifically noted in the version release notes.
Q: Can I roll back an upgrade?
A: No, Installers are not designed for rollback capability. Upgrade failures are rare but it is very important to stop all
...
UIM services and backup your configuration before proceeding with any upgrade.
Q: How long will an upgrade take?
A: Upgrades can generally be applied in less than 30 minutes.
Q: Do I need to install each Uptime Infrastructure Monitor Installer in order or do they include all previous updates?
A: Upgrades include all previously released functionality; however, there is a specific list of supported upgrade paths. Please review the Supported Upgrade Paths section below for further details on the correct order to install Uptime Infrastructure Monitor packages.
Q: Can I install a test environment prior to upgrading my production environment?
A: Yes, this process is recommended. Please contact Uptime Infrastructure Monitor Support to request a test license key.
Supported upgrade paths
Officially supported UIM upgrade paths include:
Current Version | Upgrade Version |
---|---|
7.1 | 7.2 |
7.3 | |
7.2 | 7.3 |
7.4 | |
7.3 | 7.4 |
7.5 | |
7.4 | 7.5 |
If you are running an earlier version of Uptime Infrastructure Monitor, please refer to Upgrading to UIM 7.1 or earlier and complete your upgrade to UIM 7.1 before proceeding.
Version-specific upgrade advisories
Info |
---|
|
Applying UIM installers
- Download the Installer file from the UIM 7.6 Monitoring Station Installer Files (includes up.time Controller) section of the Support site. The current names of the UIM installer files are listed below.
UIM version: 7.5Info On earlier UIM versions, there were separate installers for Red Hat & SUSE, as well as separate packages for upgrading vs. a full installation. Going forth is now a single installer that covers both versions of Linux, as well both upgrades and full installs.
Platform & installer files:- Windows: up.time-7.5.0-windows.exe
- Linux: up.time-7.5.0-linux.bin
- Copy the installer file to your monitoring station. If using FTP, ensure you use binary mode.
- Review the version release notes for any specific upgrade instructions.
- Back up your current UIM deployment. We recommend at least the following steps, which will back up the configuration information but not the historical performance data. Please review Backing up and recovering UIM for additional backup suggestions.
- Generate a Problem Report with full configuration data.
- From within the Uptime Infrastructure Monitor web gui, navigate to the Config tab & select ‘Problem Reporting’ from the left side menu
- Make sure the box for “Include configuration and service monitor status history for the past” is checked.
- Change the default option of 3 months of configuration data to 120 months.
- Click ‘Generate Report’ and wait for the Problem Report to complete
- Download and make a copy of the resulting .zip file somewhere other than the Monitoring Station.
- The problem report will make a copy of all the various config files & configuration data used by Uptime Infrastructure Monitor. But you should also make a back-up of the following files/directories as these maybe overwritten during the upgrade process
- Any Scripts/Plugin Monitors configured on the Monitoring Station. Typically located in subdirectories in the <uptime_dir>/scripts/ directory. (i.e. <uptime_dir>/scripts/MonitorLogScanner etc etc)
- Any custom Dashboards downloaded from ‘The Grid’ typically located as sub-directories in the <uptime_dir>/GUI/ directory. (i.e. <uptime_dir>/GUI/mobile or <uptime_dir>/GUI/world_map etc)
- If you made any customization's to the <uptime_dir>/logging.conf, this will needed to be backed up, as this file has been revised in the new release.
Note
Icon
To guarantee full retention of historical performance data, perform a full database backup prior to upgrading using one of the options from the Knowledge Base article Backing up and Recovering Uptime Infrastructure Monitor.
Log out of the Uptime Infrastructure Monitor User Interface before proceeding with the upgrade. Note that if this step is not followed, you may receive a Database is Not Responding error when attempting to restart Uptime Infrastructure Monitor after the upgrade.
Stop the Uptime Infrastructure Monitor services before executing the Installer: Starting (or restarting) and Stopping Uptime Infrastructure Monitor.
If you've previously installed the separate "up.time Controller" while running Uptime Infrastructure Monitor 7.1, you will need to manually un-install this before proceeding as the up.time Controller is now integrated into Uptime Infrastructure Monitor 7.2 and later Installer packages.
Uninstalling the up.time Controller on Windows:
Open the Programs and Features Control Panel
Select the up.time Controller.
Click Uninstall.
Follow the on-screen prompts.
Uninstalling the up.time Controller on Linux:
Navigate to the /controller/uninstaller directory ( The default Uptime Infrastructure Monitor install directory is /usr/local/uptime/ )
Run the uninstaller.sh shell script.
Continue to apply the Uptime Infrastructure Monitor upgrade.
For Linux installations, run the following commands.
Note
On earlier Uptime Infrastructure Monitor versions, there were separate installers for Redhat & SUSE, as well as separate packages for upgrading vs. a full installation. Going forth is now a single installer that covers both versions of Linux, as well both upgrades and full installs.
# cd /to/your/upgrade/file/path
# chmod +x up.time-7.5.0-linux.bin
# ./up.time-7.5.0-linux.bin
Follow the directions presented during the upgrade script.
Windows installations; Right click on the installer, and click on 'Run As Administrator', this will ensure that the installer runs as a local administrator account and has the permissions needed.
Depending on your specific environment you may need to re-apply certain changes to the config files that were backed up as part of Step #4. Do not directly re-apply the backed up copies though, as there are various changes to these config files between versions. If you are unsure of what changes to do after the upgrade, please contact Uptime Infrastructure Monitor Support directly, and provide the PR taken before the upgrade.
If any custom files have been removed, copy them back to their respective folders (e.g. plug-in monitors reside in the uptime scripts folder). Do not overwrite any files that already exist within the scripts directory after the upgrade. Because like the config files, there are intended changes to these files between Uptime Infrastructure Monitor versions. If you are unsure of what scripts to re-apply after the upgrade, please contact Uptime Infrastructure Monitor Support directly, and provide of the PR taken before the upgrade. (ex. SSL lines in httpd.conf will need to be readded after an upgrade.)
If your Uptime Infrastructure Monitor deployment includes a UI instance, please review the additional steps required for Gadgets/Dashboards to work correctly across both instances as outlined in the Release Notes here.