How to create a ZIP archive file from a product rule

You can create a ZIP archive file from a product rule for use in archive tools such as the Import Archive tool, the Export Archive tool, or the Migration Wizard.

Procedure

1. Identify the RuleSets and Versions that comprise your product. As a best practice, choose View > Rules > All Checkouts to list all rules checked out. Confirm that none of the rules in these RuleSets are checked out and being worked on. Errors are reported if you create a ZIP archive at time when any of the rules designated for it are checked out.
2. Although not required, you may want to review these RuleSet Version rules to confirm that each RuleSet version is locked. See RuleSet Version form — Completing the Security tab.
3. Confirm that the destination Process Commander system holds all the RuleSets and versions listed as prerequisites to the RuleSets and versions to be imported. If they are not present, include them in your product rule or create a product rule that contains them and export the ZIP archive to the destination system first. For example, if Alpha Corp:01-01-01 is a prerequisite to OrderEntry:01-01-01, the AlphaCorp RuleSet must be on the destination system before you can import the OrderEntry RuleSet.
4. When the product rule form is complete, save it.
5. At any time after you save this rule, click  Create Zip File   to start the assembly of a Zip archive. Enter a file name (with no file type). Processing may take several minutes to complete. Choose a file name that is valid for both the destination server and the current server; they may be hosted on different Windows or UNIX platforms. Many special characters are allowed, but you can't include an equals sign character (=) in the file name.
6. The system places the Zip archive in the ServiceExport directory. Right-click to download the file to your workstation or a network drive.
7. To confirm correct operation or review errors, open the newest instance of the Log-PegaRULESMove class.

Command-line migration using UNIX shell script or Windows BAT file

You can extract a ZIP file based on a product rule from one Process Commander system and import the ZIP file into a destination Process Commander system using UNIX or Windows command-line facilities. See Pega Developer Network article PRKB-24185 How to import and export ZIP archives from a command line. (Note that ZIP archives created by the PRDBUTL utility servlet have a different internal format than ZIP archives created by the Export Archive utility.)

ZIP files from older Process Commander versions

The internal format of ZIP archives created by V5.5 systems differs from previous versions to facilitate smaller packages and provide more efficient uploads. In order to create a ZIP archive that is compatible with v5.4 and earlier, select the 5.4 Compatibility? check box on Contents tab on the product rule form.

	internal key, major version, patch version
	About the Product Migration wizard About Product rules About Product Patch rules About Archive tools

SysAdmin category