Upgrading from an Earlier Version
If you have a previous version of PATROL HL KM installed on the target computer, you have the following options for upgrading to the new version of PATROL HL KM:
The flowchart on Upgrade Scenarios for PATROL HL KM describes the general process of upgrading to a new version of PATROL HL KM and migrating any customizations.
Automatic Migration of Console and Agent Customizations
Only customizations to Knowledge Modules must be migrated. Whether you choose to save and migrate your KM customizations or not, the customizations you have made to
- agents - stored in the agent configuration file
- consoles - stored in the console cache files are preserved and incorporated into the new version automatically
Note
Customized Knowledge Modules and PSL files are also stored in the cache but they are not automatically preserved and incorporated.
Conditions for Upgrading
Use the following table to help you choose an upgrade procedure.
Use This Procedure | If You Have This Situation |
|---|---|
| |
Made customizations to the KM files in your previously installed version of PATROL HL KM and want to save those customizations and migrate them to the new version of PATROL HL KM |
Note
The PATROL HL KM does not support installing the new version of the product over an existing version (over-the-top installation). You must uninstall the product before installing a new version, or use the migration tools if you are keeping any customizations.
Determining the Location of PATROL
During the installation process, the PATROL Installation Utility records where it installs PATROL components in environment variables. To function properly, various components of the PATROL product, such as the migration tools, require the information stored in these variables. Two important variables are PATROL_HOME and PATROL_CACHE.
For Windows
Throughout this section, all references to PATROL_HOME represent %PATROL_HOME% and all references to PATROL_CACHE represent %PATROL_CACHE%.
Default Values for PATROL Location Variables
If you do not specify a location for the PATROL installation, the installer uses the following preprogrammed default locations and stores these locations in environment variables.
Variable | Default Value |
|---|---|
PATROL_HOME | C:\Program Files\BMC Software\<patrol_directory>a |
PATROL_CACHE | %HOMEDRIVE%%HOMEPATH%\<patrol_directory> a |
a - The <patrol_directory> is typically \PATROL3 or \PATROL7.
Viewing Environment Variables Set by PATROL
To view the value of PATROL_HOME, PATROL_CACHE and other environment variables, perform the appropriate procedure for your operating system:
Operating System | Procedure |
|---|---|
Microsoft Windows NT 4.x | Using the Control Panel tools
Note: The System application displays PATROL_CACHE only if it is set to a value other than its default value. |
Using the PATROL Environment Probe
| |
Microsoft Windows 2008 and above | Using the Control Panel tools
Note: The System application displays PATROL_CACHE only if it is set to a value other than its default value. |
Using the PATROL Environment Probe
|
For UNIX
Throughout this section, all references to PATROL_HOME represent $PATROL_HOME and all references to PATROL_CACHE represent $HOME/patrol.
Default Values for PATROL Location Variables
If you do not specify a location for the PATROL installation, the installer uses the following pre programmed default locations and stores these locations in environment variables.
Default Values for PATROL Location Variables on UNIX
Variable | Default Value |
|---|---|
PATROL_HOME | /opt/bmc/<patrol_directory>a |
PATROL_CACHE | $HOME/<patrol_directory> a |
a The <patrol_directory> is typically /PATROL3 or /PATROL7.
Viewing Environment Variables Set by PATROL
To view the value of PATROL_HOME, PATROL_CACHE, and other environment variables, perform the appropriate procedure for your shell type:
Type of Shell | Procedure |
|---|---|
Bourne and Korn | At the shell command prompt, type export and press ENTER. The shell displays a list of environment variables and their values. Note: If PATROL_HOME is not set, run patrolrc.sh. |
C | At the shell command prompt, type setenv and press ENTER. The shell displays a list of environment variables and their values. Note: If PATROL_HOME is not set, run patrolrc.sh. |
Comments