Migrating the Infrastructure Management policies and user data to the Presentation Server

You can migrate the BMC TrueSight Infrastructure Management policies and data to the Presentation Server using the upgrade installer or the command-driven migration utility.

During migration, the following data is moved to the Presentation Server and Atrium Single Sign-On Server:

• Policies
  • Monitoring policies, blackout policies, staging policies, time frames, Integration Service clusters, global thresholds
• User management data

  • Users and user groups are migrated to Atrium Single Sign-On Server

  • Roles and objects (Views, Monitor Groups, CI's, Components Folder, Event Folder & Report) are migrated to Presentation Server

    Service Level Objects (SLOs) are not migrated.

• Agent Query Tool (AQT) commands, Monitoring Installation Packages

While upgrading to Infrastructure Management 10.5, when you select Yes on the TrueSight Presentation Server Integration and Registration page, the installer UI prompts you to enter Presentation Server and Atrium Single Sign-On Server information, and provides flexibility to migrate everything at the same time. For information about the TrueSight Presentation Server Integration and Registration page on the Upgrade installer, see Integrating with TSPS. 

If you select NO, the installer exports only policies to the /pw/pronto/lib/Datamigrator/exported_policies folder. Later, you can opt to migrate these policies as well as user data to the Presentation Server using the migration utility. 

This topic contains the following procedures and supporting information about the migration utility: 

Before you begin

Ensure that you have the following:

• admin credentials for Presentation Server
• amadmin credentials for Atrium Single Sing-On Server
• REST interface for Presentation Server and Atrium Single Sign-On Server on the HTTPS protocol is accessible 
• Infrastructure Management database details

Location of Migration Utility

• Windows: InstallationDirectory\pw\pronto\lib\Datamigrator\migration.bat
• Linux: InstallationDirectory/pw/pronto/lib/Datamigrator/migration.sh

Command syntax

• Windows: migration.bat
• Linux: migration.sh

The available options for the migration command are:

• export_policies

• export_users

• export_files

Migrating Infrastructure Management policies 

The migration.bat export_policies command migrates the policies to the Presentation Server. 

The syntax for this command is as follows:

migration.bat export_policies  -presentation_host <presentation_host_name> [-presentation_port <presentation_port_num>] 
-presentation_username <presentation_adminuser>  [-presentation_passwd <presentation_admin_passwd> ] -d <dir_name> [-sso_tenant <tenant name>]

• -d <dir_name> - Directory that contains the exported policies to be imported to the Presentation Server. Typically includes -d <exported_policies>. 

Migrating user management data

The migration.bat export_users command migrates the user management data to the Presentation Server. 

The syntax for this command is as follows:

migration.bat export_users  -sso_host <hostname> -sso_port <port> -sso_user amadmin -sso_passwd <passwd> -sso_tenant <tenant> 
[-presentation_host <presentation_host_name>] [-presentation_port <presentation_port_num>] [ -presentation_username <presentation_adminuser> ] 
[-presentation_passwd <presentation_admin_passwd> ]

The Presentation Password and SSO Password values will be prompted to allow the password hiding.

Migrating files

The migration.bat export_files command migrates the TrueSight Infrastructure Management data files such as Agent Query Tool (AQT) commands, Monitoring Installation Packages to the Presentation Server. 

The syntax for this command is as follows:

migration.bat export_files  -file_list_xml <filePath.xml> [-presentation_host <presentation_host_name>] [-presentation_port <presentation_port_num>]  [ -presentation_username <presentation_adminuser> ] [ -presentation_passwd <presentation_admin_passwd> ]

• -file_list_xml <filePath.xml> — Exports user information to the file you specify. By default, the pw\pronto\lib\DataMigrator\conf\files_to_export.xml file is used.