Hotfix Manager

Hotfixes are .zip packages of files that address issues in the Pega 7 Platform and participating Pega-supplied applications. Hotfix Manager includes both a user-interface tool and a command-line tool. You can perform the same actions from both tools. To use Hotfix Manager, you must have administrator rights.

Use Hotfix Manager to perform the following actions:

• Scan your system to identify necessary hotfixes and help you communicate with Pegasystems Inc. support
• Install hotfixes
• Roll back uncommitted hotfixes
• Manage hotfixes that include schema changes or require other special handling

Hotfix life cycle

The hotfix life cycle includes these states:

• Not installed- Hotfixes that are not yet installed on your system. Pega 7 Platform cannot use these hotfixes.
• Installed but uncommitted- Uncommitted hotfixes are installed in your system; Pega 7 Platform can use these hotfixes, however they can still be rolled back to remove them from the system.
• Rolled back - Rolled back hotfixes were installed, but have been removed from the system. Pega 7 Platform cannot use these hotfixes.
• Committed - Committed hotfixes are permanent on the system. You cannot rollback a committed hotfix.

Managing hotfix packages

Follow these steps to use Hotfix Manager to manage hotfixes to your system:

1. Obtain a hotfix catalog on-line or from Pegasystems Global Customer Support.
2. Scan your system to compare the current inventory of rules, code, and hotfixes to the latest hotfix catalog. The scan identifies hotfixes that are:
• Installed
• Not installed
• Incorrectly installed
• Superseded by more recent hotfixes
3. Send the scan results to Pegasystems Global Customer Support. Pegasystems Global Customer Support sends you the needed hotfixes and notifies you if you cannot use Hotfix Manager for a hotfix.
4. Install the hotfix.
5. Before you commit, test the uncommitted hotfix.
6. When you are sure the hotfix meets your needs, commit the hotfix. If the hotfix does not meet your needs, roll back the hotfix.

Hotfixes supported by Hotfix Manager

Hotfix Manager supports these types of hotfixes:

• Rule changes including data instances and non-versioned rules that do not go through rule resolution
• Code and engine changes
• Some schema changes:
  • Adding tables
  • Adding views
  • Adding or modifying columns
  • Adding or modifying indexes

Hotfix Manager does not support the following types of hotfixes. If you attempt to use Hotfix Manager for these hotfixes, you will see an error and the hotfix will not install:

• Changes to EAR or WAR files
• Changes to scripts in the distribution: install, upgrade or command line scripts
• Other schema changes not listed above

Related information

Open topic with navigation