Skip to Content
Information
Announcement Support for this product will end on November 3, 2025. We recommend that you use PATROL for Linux, PATROL for AIX, or PATROL for Solaris to monitor operating systems.

Migrating Customizations Manually

If you have made customizations to the PATROL Script Language (PSL) code, you must manually migrate those customizations. This task contains a procedure for manually migrating each kind of customization.

To Migrate Customizations to KM Files Manually

  1. Ensure that you have made a record of your customizations and have backed up the customized files in the PATROL_HOME and PATROL_CACHE directories.
  2. Uninstall the old version of PATROL KM for UNIX.
  3. Install the later version of PATROL KM for UNIX as described in the section Installing for the First Time.
  4. Identify and record the coding changes, which represent your customizations, in PATROL KM for UNIX by comparing the content of the ASCII files in the newly installed PATROL KM for UNIX version with the content of the customized ASCII files with the same name that is saved in the directory to which you moved the old version.
  5. Incorporate your customizations to the new PATROL KM for UNIX by performing the following steps:
    1. Restart the PATROL console.
    2. Load the newly installed PATROL KM for UNIX.
    3. Using a PATROL console in developer mode, enter the customizations that you identified in step 4, one by one.

To Migrate Customized PSL Code

Customizations made to PATROL Script Language (PSL) code are not automatically migrated. These customizations might be embedded in .km files or stored in separate .psl files. Migrate these customizations manually, using the following guidelines:

  • If you modified .psl files that were shipped by BMC Software, you must manually re-edit the PSL code in the new KM by using a PATROL console in developer mode to reapply your changes.
  • If you modified PSL code embedded in a .km file, that code will be overwritten when you install a later version of the product. You must manually edit the new .km files by using a PATROL console in developer mode to reapply your changes.
  • If you created a new PSL file (not shipped by BMC Software) outside of a .km file, or if you created new PSL code (not shipped by BMC Software) and embedded it in a .km file that was shipped by BMC Software, use the psl search utility to search your .km, .psl, and .ctg files for terms that you might have used that have since been adopted by BMC Software as PSL keywords. Rename any terms that psl search identifies as matching existing keywords. Reapply your changes by using a PATROL console in developer mode.

 

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

BMC PATROL for UNIX and Linux 9.13