Skip to Content
Information
Unsupported content This version of the product is in limited support. However, the documentation is available for your convenience. You will not be able to leave comments.

 

Migrating customizations with the PATROL migration tools

Use the following steps to migrate BMC PATROL for Internet Servers by using the PATROL migration tools. The PATROL migration tools identify, preserve, and merge customizations from your current version of BMC PATROL for Internet Servers before you install the later version of BMC PATROL for Internet Servers. The migration probe identifies and preserves customizations; the merge tool merges your customizations into the later version of BMC PATROL for Internet Servers.

Warning

Note

For a detailed explanation and instructions for using the migration tools, see the PATROL Migration Tools User Guide.

Before you begin

  • Verify that the PATROL migration tools version 3.5 have been installed.
  • Verify that you have the latest version of the KM archive, available from the BMC FTP site atftp://ftp.bmc.com/pub/patrol/patches/p_migration_tools.
    If you do not have the latest version of the KM archive, download it and download the latest installer from ftp://ftp.bmc.com/pub/patrol/patches/COMMON_INSTALL v.r.mm/operating_system. Then extract both the KM archive and the installer and run the installer.
  • Verify that you know the version release number of the KM product that you want to probe and merge customizations from. To determine the KM version, check the application InfoBox or view the header in the any of the .km files that compose the product.
    The migration probe lists the versions of the KM packages in the syntax KMPackageName: v.r.mm_mm-yyyy.
  • If you are using an EPD image of the product, ensure that the files for BMC PATROL for Internet Servers and the associated installation utility have been extracted into a temporary directory.
  • ( UNIX only) Set the environment variables for the migration tools by running the following scripts from the directory where the migration tools and the KM archives are installed:

 The [confluence_table-plus] macro is a standalone macro and it cannot be used inline.

To use the PATROL migration probe (Windows only

The PATROL migration probe compares your customized BMC PATROL for Internet Servers and the original version of BMC PATROL for Internet Servers to determine the differences.

  1. Start the migration probe by using the menu command (Start > Programs > BMC PATROL > New PATROL KM Migration Probe ) or by executing the wmigprobe.exe file from the PATROL_HOME\bin directory.
  2. From the Specify how to find KM files to be migrated dialog box, select one of the following methods to locate the KMs that you want to migrate:The [confluence_table-plus] macro is a standalone macro and it cannot be used inline.
  3. Enter the PATROL_CACHE and the PATROL_HOME directories for the modified KMs that you want to migrate and click Next.
  4. In the Select KM Packages to Migrate dialog box, in the Available KM Packages list box, highlight the modified KM package that you want to migrate and click Select.
    The probe lists all the archive versions of that KM product that are in the KM archives.
  5. Select the version of the KM that is the same version as the KM that you customized and click Next.
  6. Repeat step 4 and step 5 for all the KMs that you want to migrate. Then, click Next on the Select KM Packages to Migrate dialog box.
    The probe prepares the selected KMs for output.

  7.  In the Output Probe Results dialog box, enter the directory for the image (either CD or EPD) for the later version of your KM product in the Location of new CD Image field, and then navigate to the Productsdirectory.

    Warning

    Note

    If you are using an EPD image, ensure that the files for BMC PATROL for Internet Servers and the associated installation utility have been extracted into a temporary directory.

  8. In the Output Probe Results dialog box, enter the directory where you want to place the probe results in the Destination of Probe results field.
    The following directories are created by the migration probe under the results directory that you enter:The [confluence_table-plus] macro is a standalone macro and it cannot be used inline.
  9. To start the migration process, click Copy Files.
  10. After the migration probe finishes, exit from the migration probe.

To use the PATROL Merge Tool (Windows only)

  1. Start the PATROL merge tool by using the menu command (Start > Programs > BMC PATROL > New PATROL KM Merge Tool ) or by executing the wmigmerge.exe file from thePATROL_HOME\bin directory.
  2. In the Location of product files page, enter in the Directory Path field the results directory that you specified in step 8.

  3. Select the Use KM Merge Map file check box, and enter the directory and file for the KM merge map file.

    Error
    Warning

    Ensure that you use the merge map file that is created by the PATROL migration probe. The location is specified in step 8. The location is resultsDirectoryName\packageNname\new\lib\kmmergemap.

  4. Click Merge KM to start the merge process.
  5. Click Create Product Image to start creating a product image.
  6. When the product image is created and the process is complete, exit from the PATROL merge tool.
    The PATROL merge tool creates the following additional directories under the results directory that was created by the migration probe:The [confluence_table-plus] macro is a standalone macro and it cannot be used inline.

To  use the PATROL migration probe (UNIX only)

The PATROL migration probe compares your customized BMC PATROL for Internet Servers and the original version of the BMC PATROL for Internet Servers to determine the differences.

  1. Start the migration probe by executing the tmigprobe file from the PATROL_HOME directory. The migration probe has a text-based interface.
  2. Select a method for locating the KMs that you want to migrate by entering the appropriate option number:The [confluence_table-plus] macro is a standalone macro and it cannot be used inline.
  3. Enter the PATROL_CACHE and the PATROL_HOME directories for the modified KMs that you want to migrate.
  4. Accept your selection of directories and continue.
    The probe searches in the directories that you specified for KM packages.
  5. At the Select KM Packages to Migrate prompt, select the KM package for which you want to migrate customizations.
    The probe now lists all the archive versions of that KM product that are in the KM archives.
  6. At the Select version of Archive KM prompt, select the version of the KM that is the same version as the one that you customized KM.
  7. Review your selections and then accept the selected version and continue.
  8. At the Specify Target and CD Path prompt, select 1) ChangeTARGET PATH and enter the directory where you want the probe to place its results.
    The following directories will be created by the migration probe under the results directory that you entered:The [confluence_table-plus] macro is a standalone macro and it cannot be used inline.

  9. At the Specify Target and CD Path prompt, select 2) ChangeCD PATH and enter the directory for the image (either CD or EPD) for the later version of your KM product, and then navigate to theProductsdirectory.

    Warning

    Note

    If you are using an EPD image of the product, ensure that the files for BMC PATROL for Internet Servers and the associated installation utility have been extracted into a temporary directory.

  10. Press Enter to start the migration process.
    The probe reports the location of its output.
  11. After the migration probe finishes, exit from the migration probe.

 (UNIX only) To use the PATROL Merge Tool

  1. Start the PATROL merge tool by executing the xmigmerge file from the PATROL_HOME directory. The merge tool has a GUI-based interface and must be run from a computer that supports X windows.
  2. Enter the results directory that was you specified in step 8. This directory contains the subdirectories: /base, /modified, /new.

  3. Select Use KM Merge Map file, and enter the directory and file for the KM merge map file

    Error
    Warning

    Ensure that you use the merge map file that is created by the PATROL migration probe. The location is specified in step 8. The location is results_directory_name/package_name/new/lib/kmmergemap.

  4. Click Merge KM to start the Merge KM process.
  5. Click Create Product Image to start creating a product image.
    The PATROL merge tool creates the following additional directories under the results directory that was created by the migration probe:The [confluence_table-plus] macro is a standalone macro and it cannot be used inline.
  6. When the product image is created and the process is complete, exit from the PATROL merge tool.

Where to go from here

You must create an installation package of the merged BMC PATROL for Internet Servers, as described in Creating-an-installation-package-of-the-merged-BMC-PATROL-for-Internet-Servers.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC PATROL for Internet Server 9.0