This document contains official content from the BMC Software Knowledge Base. It is automatically updated when the knowledge article is modified.
BMC Performance Assurance for Servers
TrueSight Capacity Optimization (Gateway Server) 10.7, 10.5, 10.3, 10.0 ; BMC Performance Assurance 9.5
Unlike the TrueSight Capacity Optimization (TSCO) Gateway Server or BMC Performance Assurance (BPA) Windows console the Linux console does not automatically migrate active Manager runs from the old console version to the new console version during an upgrade.
The $BEST1_HOME/bgs/bin/migrateManagerRuns.pl script can be used to migrate active Manager runs from the existing TSCO Gateway Server/BPA console installation to the new TSCO Gateway Server/BPA console installation as a separate post-upgrade step.
TrueSight Capacity Optimization (Gateway Server)
BMC Performance Assurance for Servers
Section I: BPA Unix console upgrade Manager run migration
The TrueSight Capacity Optimization (TSCO) Gateway Server/BMC Performance Assurance (BPA) console includes a migration script that can be used to migrate the existing Manager runs to the new console version.
The Information here is also available in the TSCO Gateway Server document here: https://docs.bmc.com/docs/display/btco107/Migrating+Manager+runs+on+Linux or in the BPA documentation in the Manager run migration after console upgrade section.
IMPORTANT: To use the migration script you must leave the old version of the TSCO Gateway Server or BMC Performance Assurance version console installed on the machine when you install the new TSCO Gateway Server console version. Therefore, do not select the Remove existing version of Perform option on the Performance Migration Options page when you install the new console version.
After installing the new TSCO Gateway Server console change directory to $BEST1_HOME/bgs/scripts.
Run the migrate script './migrateManagerRuns.pl' command.
Output will look something like this:
INFO: There are currently 1 old manager runs and 0 new manager runs scheduled
Select Which Manager Run to Migrate
 ALL : Migrate All Manager Runs
 NONE : Do not migrate any runs (Exit) ENTER A NUMBER [1..3] followed by <Enter> key ?
In the above example there is only one Manager run scheduled called 'operations_daily.vcmds'.
Select the specific Manager runs to migrate from the old console version to the newly installed console version by entering the number associated with the Manager run, or select the ALL option to migrate all Manager runs.
Verify the migration of the old manager run. The script migrates any Manager runs you select by executing a run.quit for the old Manager run, and submitting the run to the version 7.4.00 console. Once the migration is complete you can verify that the Manager runs have been scheduled in the new console by executing the following script:
where $BEST1_HOME is set to the installation directory path for the new version of the console (for example, /usr/adm/best1_10.7.00 for the TSCO Gateway Server version 10.7. The script returns a list of Manager runs that are now scheduled for version 10.7.00.
When the Manager run is migrated to the new console, the new console assumes ownership of the existing data collection request that was registered on the remote node by the previous console version. The migrated Manager run transfers that data to the console and process it using the new console version.
This migration path results in a seamless migration to the new console version without any loss of data.
Section II: Windows console upgrade
All releases of the TrueSight Capacity Optimization (TSCO) Gateway Server Windows console automatically handle the migration of the previously installed version of the Perform product during the installation of the new version of the product.
During the installation of the new version of the Perform product be sure to select the "Migrate all console data files during upgrade the .plc, .vmn, .msc, best1analyze.ini, best1user.hrw, best1user.hrw, license, files and scheduled scripts" options. This will ensure the previous manager runs and scripts are migrated to the new version of the console for the TSCO Gateway Server product.
- TrueSight Capacity Optimization (Gateway Server)
- BMC Performance Assurance for Servers