Migrating the data format before upgrading the Presentation Server

This topic is applicable only if you are upgrading the Presentation Server from a version earlier than 11.0.00.

Before starting the upgrade, you must run the dataUpgrade utility located at Disk1\utility\DataUpgradeUtility. This utility migrates the TrueSight Presentation Server data format to the format required after the upgrade.

Running this utility does not require downtime and does not impact the state of the TrueSight Presentation Server.

Notes

The duration of the migration process depends on the amount of event data. In a test environment of 2.4 million events, the process took 45 minutes.

Before you begin
To obtain the utility and prepare the Presentation Server for the data format migration
To migrate the data format before upgrading the Presentation Server
Troubleshooting

Before you begin

Complete all the preupgrade tasks listed in Preparing-to-upgrade-the-Presentation-Server.

To obtain the utility and prepare the Presentation Server for the data format migration

Download and extract the Presentation Server installation file.
On the TrueSight Presentation Server host, locate the dataUpgrade utility at Disk1\utility\DataUpgradeUtility.
Ensure that port 9335 is available.
If port 9335 is already in use, provide a custom port number by updating the target.http.port=<custom port> property in the config.properties file, located in the DataUpgradeUtility/config directory.
Because the utility migrates data over the HTTP protocol, temporarily enable the HTTP port on the existing Index Server.

To migrate the data format before upgrading the Presentation Server

Run the following utility. If you are operating in a high-availability environment, run the utility on the primary host only.
RAM requirement
Before your run this utility, at least 2 GB RAM must be available.
- (Windows): dataUpgrade.bat
- (Linux - as a non-root user): dataUpgrade.sh
  If you get a message prompting you to ensure minimum required values for the configuration properties, you need to first configure the required settings. For more information, see Preparing-to-upgrade-the-Presentation-Server.
If you did not enable the HTTP port on the existing Index Server, respond to the prompt.
- To enable the utility to enable the HTTP port and continue running the utility, type y.
- To exit the utility and run it at a later time, type n.

Data migration starts and the migration completion is displayed as a percentage. Do not start the Presentation Server upgrade until the data format migration is completed.

Recommendation

BMC recommends upgrading the Presentation Server immediately after migrating the data format.

Troubleshooting

You can find the dataupgrade.log file in the DataUpgradeUtility/logs/ folder. This log file contains details of errors that occurred during the execution of the dataUpgrade utility.

For more information about troubleshooting scenarios, see Troubleshooting data format migration for the Presentation Server.