Migrating synthetic configurations

11.3.03 version note for ConfigurationMigrationTool and ReplaceCertificateTool

From version 11.3.03 of the product, BMC no longer ships the ConfigurationMigrationTool and ReplaceCertificateTool. The following procedures are not applicable for versions 11.3.03 and later.

You can migrate configurations to TrueSight Presentation Server from BMC Transaction Management Application Response Time (BMC TM ART). Migrating is especially helpful because it allows you to reuse existent configurations. This saves time in getting started with synthetic transaction monitoring in the TrueSight Presentation Server.

The BMC Transaction Execution Adapter Agent (TEA Agent) installation files include a command-line utility for migrating your scripts and configurations from your existing BMC TM ART installation to the TrueSight Presentation Server. The migration is divided into two stages: export from BMC TM ART and import to the TrueSight Presentation Server. 

Notes

  • To perform the migration, you must have write access to your TEA Agent installation file folders of the latest version, and you must have administrator permissions in BMC TM ART.
  • BMC TM ART migration is supported only from version 4.2.

The following topics are included:

To export a self-signed certificate for secure BMC TM ART

If your installation of BMC TM ART is secured using a self-signed certificate, perform the following procedure before starting your export.

  1. Open the BMC TM ART client in a browser.
  2. From the web browser, export the certificate for BMC TM ART and save it.
  3. Open a command prompt and change the directory to the ...\Disk1\files\jre\bin folder.
  4. Run the following command:

    keytool -import -alias "<alias name>" -file "<.cer file path>" -keystore "<cacerts path>"
    • <.cer file path> is the full path of the .cer file that you saved.
    • <cacerts path> is the full path to the cacerts file: ...\Disk1\files\jre\lib\security\cacerts

To export from BMC TM ART (applicable to versions 11.3.02 and earlier)

  1. Run the migration_tool batch file from the ...\Disk1\utility\ConfigurationMigrationTool folder of your TEA Agent installer files.
  2. Enter 1 to select export from BMC TM ART.
  3. Enter the required parameters for your BMC TM ART connection, or press Enter to accept the default values.

    Parameter

    Description

    Enter TM ART host name / IP:

    Enter the host name or IP address of the computer where BMC TM ART is installed.

    Enter TM ART port number (default 19120):

    Enter the port number that your BMC TM ART uses, or press Enter to accept the default value.

    Default: 19120

    Enter TM ART user name:

    Enter the user name that you use to connect to BMC TM ART.

    Enter TM ART password:

    Enter the password for your BMC TM ART user name.

    Does TM ART use a secure connection? (Yes/No):

    Enter Yes if your BMC TM ART installation uses a secure connection. Enter No if it does not.

  4. Enter the required parameters for your BMC TM ART database, or press Enter to accept the default values.

    Parameter

    Description

    Choose database type (1 - Oracle, 2 - MS SQL):

    Enter 1 or 2 to choose the database type that you use for BMC TM ART.

    Enter database host name / IP:

    Enter the host name or IP address of the computer used for your BMC TM ART database.

    Enter database port number:

    Enter the port number that BMC TM ART uses to connect to the database, or press Enter to accept the default value.

    Default:

    • Oracle: 1521
    • MS SQL: 1433
    Enter database SID name: Enter database name:(Oracle) Enter your SID.
    (MS SQL) Enter your database name.

    Enter database user name:

    Enter the user name that BMC TM ART uses to connect to the database.

    Note

    If you are using an MS SQL database you cannot use a domain windows account..

    Enter database password:

    Enter the password for your BMC TM ART database user.

    The export starts running. This may take some time. The amount of time depends on the amount of data that you are exporting.
    The migration files are created in the ConfigurationMigrationTool\Migration_output folder.

    Notes

    • Of the Essential scripts supplied with BMC TM ART, only the Pinger group of scripts and the URL Checker script are supported in BMC TrueSight. Customized Essential scripts are migrated as well.
    • All of the Monitor settings that are necessary to set up corresponding Execution Plans in TrueSight are migrated.

    Blackout migration export

    • The Monitor Exclusions configured in TM ART are migrated to the new Synthetic Blackouts.
    • The Monitor Exclusion start time are converted into the UTC time according to the configured time zone in TM ART. The UTC conversion might change the selected days of the week and move it one day forward or one day backward accordingly. For example, If the configured monitor exclusion start time is 1:00 A.M. and time zone is Athens (UTC +2:00) and the selected days are Wednesday and Saturday, the blackout start time after the UTC conversion will be 11:00 P.M. on Tuesday and Friday.

    Not migrated

     The following are not migrated:

    • Locations that have no assigned Monitors or Projects
    • Projects that have no assigned Monitors
    • Monitors that are not scheduled to run on any Locations

    Character replacement

    The migration utility makes the following character substitutions automatically:

    • In Project Descriptions, all carriage return (CR) characters are replaced with semicolons (;).
    • In Locations and Script names, all non-alphanumeric characters are replaced with underscores(_) as follows:
      • Groups of consecutive non-alphanumeric characters are replaced with a single underscore.
      • If as a result of this character substitution, scripts would have the same name, the TM ART database IDs of the scripts are appended to the script names.
    • Script file names (.ltz files) that are longer than sixty four characters are truncated.

To generate rules and conditions report from BMC TM ART (applicable to versions 11.3.02 and earlier)

  1. Run the migration_tool batch file from the ...\Disk1\utility\ConfigurationMigrationTool folder your TEA Agent installer files.
  2. Enter 2 to select generate report.

    Note

    The utility generates html report file and equivalent csv file.

  3. Enter the required parameters for your BMC TM ART connection, or press Enter to accept the default values.

Parameter

Description

Enter TM ART host name / IP:

Enter the host name or IP address of the computer where BMC TM ART is installed.

Enter TM ART port number (default 19120):

Enter the port number that your BMC TM ART uses, or press Enter to accept the default value.

Default: 19120

Enter TM ART user name:

Enter the user name that you use to connect to BMC TM ART.

Enter TM ART password:

Enter the password for your BMC TM ART user name.

Does TM ART use a secure connection? (Yes/No):

Enter Yes if your BMC TM ART installation uses a secure connection. Enter No if it does not.


4. Enter the required parameters for your BMC TM ART database, or press Enter to accept the default values.

Parameter

Description

Choose database type (1 - Oracle, 2 - MS SQL):

Enter 1 or 2 to choose the database type that you use for BMC TM ART.

Enter database host name / IP:

Enter the host name or IP address of the computer used for your BMC TM ART database.

Enter database port number:

Enter the port number that BMC TM ART uses to connect to the database, or press Enter to accept the default value.

Default:

  • Oracle: 1521
  • MS SQL: 1433
Enter database SID name: Enter database name:(Oracle) Enter your SID.
(MS SQL) Enter your database name.

Enter database user name:

Enter the user name that BMC TM ART uses to connect to the database.

Note

If you are using an MS SQL database you cannot use a domain windows account..

Enter database password:

Enter the password for your BMC TM ART database user.


To import configurations and scripts into the TrueSight Presentation Server (applicable to versions 11.3.02 and earlier)

Notes

  • Do not modify any of the files in the ConfigurationMigrationTool\Migration_output folder. Modifying these files is likely to cause the migration process to fail.
  • The migration utility retrieves your TrueSight App Visibility Manager portal details from the TrueSight Presentation Server. Before running this procedure, verify that your TrueSight App Visibility Manager portal is properly installed and connected to the TrueSight Presentation Server.
  • Before running the import BMC recommends that you back up all of the files in the Migration_output folder.
  1. Run the migration_tool batch file from the ...\Disk1\utility\ConfigurationMigrationTool folder of your TEA Agent installation files.
  2. Enter 3 to select import.
  3. Enter the required parameters for your TrueSight Presentation Server connection, or press Enter to accept the default values.

    Parameter

    Description

    Enter host name / IP:

    Enter the host name or IP address of the computer where TrueSight Presentation Server is installed.

    Does TrueSight use a secure connection? (Yes/No, default Yes):

    Enter Yes if your TrueSight Presentation Server uses a secure connection. Enter No if it does not.

    Enter port number (default 443):

    Enter the port number that your TrueSight Presentation Server uses, or press Enter to accept the default value.

    Enter user name:

    Enter the user name that you use to connect to your TrueSight Presentation Server.

    Note

    Enter user name without tenant name.

    Enter password:

    Enter the password for your TrueSight Presentation Server user name.

    Enter Realm ID:

    Enter the Realm ID for your TrueSight Presentation Server.

    All of the configurations and scripts are imported into the TrueSight Presentation Server. The files that were created as part of the export process are deleted automatically.

    Blackout migration import

    The page .Migrating synthetic configurations v11.3.02 was not found  -- Please check/update the page name used in the MultiExcerpt-Include macro

    • The Monitor Exclusions that use similar configuration across all monitors and projects are configured within a single Time Frame in the new Synthetic Blackout.

Related topics

Upgrading a synthetic TEA Agent silently

Upgrading a synthetic TEA Agent using the wizard

Was this page helpful? Yes No Submitting... Thank you

Comments