Skip to main content


         This documentation site is for previous versions. Visit our new documentation site for current releases.      
 

Packaging an application

Updated on December 22, 2021

To migrate a new application to a different environment, you must package the application before you can import it to the new environment.

Pega Knowledge Implementation Guide Pega Knowledge Implementation Guide Pega Knowledge Implementation Guide

Merging application changes

If you develop your application features in separate branches, use the Merge Branches wizard to merge the branches before you package the application. The wizard shows any merge conflicts so that you can correct them before you merge the branches.

Additionally, the Pega 1:1 Operations Manager application allows business users to make controlled changes in a Business Operations Environment (BOE), and test the changes in a production environment within boundaries defined by your organization's IT department. For more information, see Revision management.

Packaging an application for migration

Before you migrate a new application to a different environment, package the relevant data instances and rulesets into a product rule. The product rule is an instance of Rule-Admin-Product, which Pega Platform refers to as the RAP file.

Before you begin: If you develop your application features in separate branches, merge the branches. For more information, see Developing applications, merging branches, and deploying changes in a distributed development environment.
  1. In the header of Dev Studio, click ConfigureApplicationDistributionPackage to start the Application Packaging wizard.
    For more information about using the wizard, see Packaging your application in a product rule.
  2. Complete each page of the Application Packaging wizard.
  3. On the last page of the wizard, click Preview.
  4. Review the contents of the generated RAP file.
  5. If you want to make any changes, on the last page of the wizard, click Modify. Ensure that the following class instances and individual instances are present in the RAP file.
  6. When you have completed your review of the RAP file, click Export.
    Result: The wizard creates a .zip file in the ServiceExport directory on the current application server node.

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best.

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us