Page History
...
Info |
---|
This KB article only applies if you are upgrading to Uptime Infrastructure Monitor version 7.1 or earlier. If you are upgrading to Uptime Infrastructure Monitor 7.2 or later, please refer to Upgrading to Uptime Infrastructure Monitor UIM 7.2 through 7.5. |
Upgrade considerations
Warning |
---|
|
Please contact IDERA Support prior to attempting an upgrade if any of the following conditions applies:
...
Info |
---|
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, upgrades are not designed for rollback capability. Upgrade failures are rare but it is very important to stop all Uptime Infrastructure Monitor 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 service pack in order or do Uptime Infrastructure Monitor upgrades include all previous updates? A: Upgrades include all previously released functionality; however, there is a specific list of supported upgrade paths. Please review the following section for further details on the correct order to install service packs. Q: Can I install a test environment prior to upgrading my production environment? A: Yes, this process is recommended. To retrieve a test license key, login to the License Portal and click the Test Drive link for your deployment. |
Supported upgrade paths
The officially supported Uptime Infrastructure Monitor upgrade paths are listed below. Please note that the general rule is that you should not skip more than one point release when applying service packs. For example, upgrading from UIM 5.2 to 5.4 is possible but upgrading from UIM 5.2 to 5.5 is not supported.
- 5.2 -> 5.3
- 5.2 -> 2 5.4
- 5.3 -> 3 5.4
- 5.3 -> 3 5.5
- 5.4 -> 4 5.5
- 5.4 -> 4 6.x
- 5.5 -> 5 6.x
- 6.x -> x 7.0
- 7.0 -> 70 7.1
Applying UIM upgrades and service packs
...
- Download the upgrade or service pack file from the Upgrade Installer section of the Support site. The current UIM upgrade installer file names are listed below (please Please contact IDERA Support if you require an older service pack version to facilitate an interim upgrade).
- Copy the upgrade installer file to your monitoring station. If using FTP, ensure you use binary mode.
- Review the version release notes for any specific upgrade instructions.
- If you are upgrading to a new major release version (e.g. from 5.x to 6.x or from 6.x to 7.0), you will need to retrieve a new license key from the License Portal (login required). To complete this process, login :
- Log in to the License Portal
- .
- Identify the deployment that you plan to upgrade
- .
- Click Upgrade my Deployment
- and follow the instructions.
- Back up your current Uptime Infrastructure Monitor 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 Recoveringrecovering Uptime Infrastructure Monitor for for additional backup suggestions.
- Generate a Problem Report by navigating to the Config - > Problem Reporting tab. This will generate a copy of your configuration.
- Copy <install_dir>/wrapper.conf (Windows systems only).
- Copy <install_dir>/uptime.conf.
- Copy <install_dir>/uptime.lax (all non-Windows systems).
- Copy <install_dir>/mysql/my.ini (if running on the default MySQL DataStore).
- Copy <install_dir>/apache/conf/httpd.conf.
- Copy <install_dir>/apache/conf/php.ini.
- Back up any scripting files related to plug-in monitors, custom actions, custom alerts or custom monitors.
Info To guarantee full retention of historical performance data, perform a full database backup prior to upgrading.
- Log out of the Uptime Infrastructure Monitor User Interface UIM user interface before proceeding with the upgrade. Note that if this step is not followed, you may receive a "Database is Not Responding not responding" error when attempting to restart Uptime Infrastructure Monitor UIM after the upgrade.
- Stop the Uptime Infrastructure Monitor UIM services before executing the Service Packservice pack.
- For Red Hat, SUSE, and Solaris installations, run the following:
Code Block language sql # /etc/init.d/uptime_httpd stop # /etc/init.d/uptime_core stop
# /etc/init.d/uptime_datastore stop
For Windows installations, run the following:Code Block language sql > net stop "up.time Web Server"
> net stop "up.time Data Collector"
> net stop "up.time Data Store"
- Continue to apply the Uptime Infrastructure Monitor UIM upgrade.
- For Red Hat, SUSE and Solaris installations, run the following commands.
Note that this example assumes a 7.1 Red Hat upgrade so substitute your file name as appropriate.Code Block language sql # cd /to/your/upgrade/file/path
# gunzip -d up.time-7.1.0-rhes-upgrade.bin.gz # chmod +x up.time-7.1.0-rhes-upgrade-bin
# ./up.time-7.1.0-rhes-upgrade.bin
Follow the directions presented during the upgrade script.- Windows installations; double click on the service pack upgrade executable and follow the instructions on screen.
- For Red Hat, SUSE and Solaris installations, run the following commands.
- Depending on your specific environment, you may need to reapply certain changes to the httpd.conf, wrapper.conf, php.ini and/or uptime.conf files. Confirm that these files are correct by comparing to your backup copies.
- Note that after upgrading to Uptime Infrastructure Monitor UIM 7.0, users should update the global SNMP settings found on the Config panel (please refer to the Release Notes for further details).
- Note that several new parameters were added or moved to the uptime.conf file in the 5.5 release to simplify and facilitate tuning of performance parameters. If these parameters were previously modified in your wrapper.conf or uptime.lax file, you will need to reapply those changes to the uptime.conf file after upgrading to the 5.5 (or later) release.
- If any custom files have been removed, copy them back to their respective folders (e.g. plug-in monitors reside in the Uptime Infrastructure Monitor core folder). Ensure that any custom monitors, custom alerts, custom actions, or plug-in service monitors are compatible with the new service pack.