Installing and running the event migration utility

Follow the instructions in this topic to download and install the utility.

Minimum requirements

• Java 11. Recommended version openjdk 11.0.7
• BMC Helix Operations Management 
• TrueSight Operations Management

To install and run the event migration utility

1. Ensure that you perform all the actions given the Preparing-for-event-data-migration topic.
2. On the server where you downloaded the migration utility, create the mcell_home\etc directory.
3. Copy the Knowledge Base (KB) files in the mcell_home\etc\<cell_name>\kb directory.
4. In the mcell_home\etc directory, ensure that the Knowledge Base (KB) files are present in the <cell_name>\kb directory.

5. Go to the <migration_utility_home_folder>/conf/migration.properties file and change the values in the executionOrder column if the precedence is incorrect; otherwise, leave them as is. 
   The policy precedence can be between 0 and 9999.

   Important

   • Confirm that the <migration_utility_home_folder>/ExecutionOrderDetails_<cell_name>.csv file is created. If you do see the file, go to the <migration_utility_home_folder>/event_migration​.log file to evaluate the cause.
   • If the execution order of the rule is not specified in the <migration_utility_home_folder>/ExecutionOrderDetails_<cell_name>.csv file, or if the file is not generated, the policy precedence number in the kb/policies.baroc file is used to grant policy precedence.

   The following image displays an example <migration_utility_home_folder>/ExecutionOrderDetails_<cell_name>.csv file:
   

6. Make sure that you can access the internet from the server where you are running the utility.
7. Open command prompt and navigate to the directory where you downloaded the migration utility jar file.

8. Run the following command:

   java -jar <jar_name>.jar --truesight.mcellhome="<mcell_home dir location>" --truesight.conf="<conf folder location>"   
   

   For example:
   java -jar migratekb-22.4.2.jar --truesight.mcellhome="C:\eventmigration\mcell_home" --truesight.conf="C:\migratekb-utility\target\migratekb-22.4.2-bin\migratekb-22.4.2\conf"

   The command can include the option --server.port=xxxx. The port number defaults to 8080. However, it can be any port if 8080 is already in use.

   The following message appears:
   

   Use: http://localhost:8080 to connect to the GUI.
9. Specify the precedence settings for the policies that you want to migrate.
   1. Go to the <migration_utility_home_folder>/conf/migration.properties file.

   2. Specify the cell start and end indexes as shown below:

      <cell_name>_start_index = <value between 0 and 9999>
      <cell_name>_end_index = <value between 0 and 9999>

      If multiple Cells are present, define the execution order of each Cell separately.
      The values must be between 0 and 9999 because these values are used in BMC Helix Operations Management to determine the policy precedence.

   3. Specify spacing between Cells as shown below:

      <cell_name>_spacing = <can be between 2 and 5>
10. Open the migration utility by navigating to http://localhost:8080/ from any browser.
11. On the migration utility Home page in your browser, navigate to the Classes tab.
    
    
    
12. On the BHOM tenant Details tab, provide the BMC Helix Operations Management tenant details.
    For information about obtaining the tenant details, see Preparing-for-event-data-migration.
    
    
    
13. Click Next.

14. On the List Event classes tab, select the classes to migrate.
    If you select a subclass, the event migration utility automatically searches for the parent class. If the parent class was not migrated earlier, it is also migrated with the subclass,

    
    
    Event classes can be filtered by status and category. To see the list of available statuses and categories, see Key-considerations-for-migrating-event-data-to-BMC-Helix-Operations-Management.

    Yes.

    The Internal Deprecated class type is not required in BMC Helix Operations Management. To migrate this class, you must change its class type in the configuration file of the migrate utility. 

    For example, the SIM_RELATIONSHIP_DELETE is an event class of the type Internal Deprecated. To migrate this event class to  BMC Helix Operations Management, change its class type to INTERNAL_THIRD_PARTY by performing the following steps:

    1. Open the <migration_utility_download_directory>conf\classcategory.properties file.
    2. Look for SIM_RELATIONSHIP_DELETE event class.

    3. Change its class type as shown below:

       The [confluence_table-plus] macro is a standalone macro and it cannot be used inline. Click on this message for details.
       This macro generates standalone content. As a consequence you need to make sure to use a syntax that separates your macro from the content before and after it so that it's on a line by itself. For example in XWiki Syntax 2.0+ this means having 2 newline characters (a.k.a line breaks) separating your macro from the content before and after it.
       

    4. Save the conf\classcategory.properties file.

    
    

15. Click Next.
16. On the Selection Summary tab, review the options that you have selected. 
    
    
17. Click Migrate.

Where to go from here

See the migration summary report for the migration status and other details.