Moving an existing Uptime Infrastructure Monitor monitoring station deployment to a new system involves a number of steps to prepare for the move and complete the system migration. Before moving to a new platform, answer the questions in this article regarding your migration objectives.
Can the new platform manage the workload produced by the UIM monitoring station?
Take a few days to determine the average workload that UIM places on the system that hosts your monitoring station. Next, determine if the new system will be able to handle this additional workload (factoring in any other applications that may be running on the same platform). Also consider if the new system has sufficient disk capacity to handle the historical performance data and new data being gathered from the monitored elements.
Will the new monitoring station belong to the same network space as the original system?
Determine if the new monitoring station is able to resolve the hostnames or IP addresses that you have used for your UIM agents. If not, consider updating the hosts file on the new monitoring station to ensure that you do not have a gap in performance data caused by UIM being unable to contact agents after being installed on the new system.
Do you need to maintain all configuration settings on the new monitoring station?
If you do not need to migrate configuration settings to the new monitoring station, consider performing a clean UIM install on the new platform.
Do you need to request a new license key for the new monitoring station?
The license key used on your current monitoring station is node locked to the HostID of the monitoring station system. A new key must be generated for the new platform. To receive a new key you must find the HostID of the new monitoring station, and then follow the instructions in Moving your license key.
If there is a requirement to run the new monitoring station in a test environment before disabling the original monitoring station, please contact uptime-support@idera.com to request a temporary test license key.
After reviewing these questions, continue with the monitoring station migration process described below.
Migrating UIM to the new platform
Before migrating the monitoring station, you must have the following:
- The license key for the new Monitoring Station.
- The UIM service pack installation package for the same version that is being migrated (available from the Downloads section of the Support site ).
- The full UIM installation package for the same version that is being migrated (available from the Downloads section of the Support site ).
Migration Progress Checklist
| Step # | Task | Done? |
|---|---|---|
| 1 | Back up your current configuration | |
| 2 | Download and install the same UIM version on the new monitoring system | |
| 3 | Add your new license to the new monitoring station | |
| 4 | Shut down UIM on both the current and new monitoring stations | |
| 5 | Move the DataStore | |
| 6 | Start UIM on the new monitoring station | |
| 7 | Set up other settings | |
| 8 | Validate the configuration |
Back up your current configuration
Review Backing up and recovering Uptime Infrastructure Monitor for full instructions.
Download and install the same UIM version on the new monitoring station
Use the full UIM installation package to install a clean but same version of UIM on the new monitoring station.
Add your new license to the new monitoring station
Log in to UIM on the new monitoring station. Because it will be a fresh UIM install, it will ask you to set the admin password and SMTP server. These values will be reset once the configuration is copied from the old monitoring station.
Enter the new license key when prompted.
Shut down UIM on both the current and new monitoring stations
To stop the UIM services, see Starting (or restarting) and stopping UIM.
Move the DataStore
The UIM datastore contains all relevant configuration information for your UIM installation. To move the datastore, copy the following directory to the same location on your new monitoring station:
<uptime_dir>/datastore
Consider compressing the data within this directory before moving the configuration information to minimize transfer time. Also ensure that file transfers are completed in BINARY mode as datastore files may be corrupted if they are transferred in ASCII.
Delete ib_logfile* files
If the MySQL ib_logfile* size on the old monitoring station server differs from the new one, MySQL will fail to start. To avoid this issue, it is best to delete the <uptime_dir>/datastore/data/ib_logfile* files. They will be automatically recreated when the UIM DataStore service starts next.
Start UIM on the new monitoring station
After the datastore directory is moved to the new monitoring station, start UIM on the new monitoring station. For more information, see Starting (or restarting) and stopping UIM .
Set up other settings
Some settings may not be included with the configuration and performance data and may need to be individually configured. These parameters may include:
- SMTP/Email Settings (under Config > SMTP Server)
- Java Heap Size
- Scripts and/or plug-in monitors
- UI Only / Reporting Instance Setting
Validate the configuration
When the monitoring station is running on the new system, ensure that all agent systems continue to return new performance data and that UIM is registering alerts.
If any functionality stops working after moving to the new system, please contact uptime-support@idera.com and provide a description of what is not working along with a Problem Report (Config > Problem Reporting).