Applying hotfixes from the command line

All Hotfix Manager operations are available from both the user interface and the command line:

• Scan - compare your system to the hotfixes listed in a hotfix catalog and generate a zip file with the results of the scan. You can share this file with Pegasystems Global Customer Support.
• Generate DDL - create a zip file containing the SQL schema changes for a hotfix archive so a database administrator can review the changes. If you do not manually apply these SQL changes, the hotfix installation process applies the chances.
• Install - install a hotfix on your system.
• Rollback - rollback all uncommitted hotfixes and remove them from the system.
• Commit - commit all hotfixes and make them permanent on the system.

To run Hotfix Manager from the command line:

1. Open the command-line console for your platform and navigate to the scripts/utils directory.
2. Open the prpcUtils.properties file. The comments in the file include information about valid values for each property.
3. Configure the database properties:
   • pega.jdbc.driver.jar=<path to your database jar file>
   • pega.jdbc.driver.class=<your database driver class>
   • pega.database.type=<Database vendor type>
     Enter udb, db2zos, mssql, oracledate, or postgres.
   • pega.jdbc.url=<URL of your current database>
   • pega.jdbc.username=<Deployment user name>
     
   • pega.jdbc.password=<Deployment user password>
4. Configure the hotfix operation:

   hotfix.operation=<action>
   Valid values are scan, install, rollback, commit, and GenerateDDL.

5. Configure the required hotfix parameters:

   Hotfix operation	Required parameters
   scan	hotfix.CatalogPath= <full path to the Catalog.zip file> hotfix.scan.downloadPath= <full path and .zip file name> where you plan to save the scan results
   install	hotfix.DLFilePath=<hotfix package DL file name and path>
   rollback	There are no additional parameters. If you run rollback, all uncommitted hotfixes uninstall.
   commit	There are no additional parameters. If you run commit, all uncommitted hotfixes become a permanent part of the system. You cannot rollback committed hotfixes.
   GenerateDDL	hotfix.DLFilePath=<hotfix package DL file name and path>

6. Save the file.
7. Run the prpcUtils.bat/sh utilities script with the manageHotfixes option. For example:
   run prpcUtils.bat/.sh manageHotfixes
8. Review the log file. Command-line actions may succeed but still result in partially-installed hotfixes. If the log file lists any additional required actions, complete the action and then repeat step 7.

Related information

Open topic with navigation