About Deployment Steps

download About Deployment Steps

of 13

Transcript of About Deployment Steps

  • 7/30/2019 About Deployment Steps

    1/13

    Deploying an Application

    After an application is developed, it is typically deployed on a test system or on a production system. To

    help you with the deployment process, Process Commander provides application rules and utilities to help

    you package an application and import it to the another system.

    About Roles and Responsibilities

    Application deployment typically involves several roles that are responsible for performing key tasks.

    These roles and responsibilities include:

    System architect and technical lead

    - Acts as lead developer on project

    - Assists in defining rules and RuleSets to be exported

    - Ensures that other developers have checked in all the rules

    - Completes development test cases prior to deployment to QA

    Release engineer

    - Receives export files that are imported into the deployment system

    - Imports rules and data into the deployment system

    - Installs other necessary components (external to Process Commander)

    - Runs verification test programs developed by the technical lead

    Administrator

    - Runs reports to plan for rules move

    - Oversees creation of export files

    - Verifies version numbers of exported RuleSets

    - Coordinates transfer of rules with release engineering

    - Performs additional system configuration, if necessary, according to technical lead requirements

    Note: These roles are functional descriptions; specific job and role titles in your organization may be

    different. For example, one individual may perform tasks for several roles, or more than one individual may

    perform a single role.

    Before You Begin

    Before you move an application to another Process Commander system, consider the following guidelines:

    You must have administrator privileges on both the source and destination systems.

    It is best if the versions of Process Commander are the same on both systems. The version of

    Process Commander on the destination system must be the same or higher than that of the

    source system. For example, you cannot move a RuleSet created in version 05-03-06 to a system

    based on version 05-03-01.

    Determine the RuleSet prerequisites of the RuleSet(s) you want to move. Determine whether the

    dependencies are already present on the destination system or whether you must move them,

  • 7/30/2019 About Deployment Steps

    2/13

    too. If you do need to move them, be sure to do so in the order that matches the dependency

    relationship. Also, ensure that these dependencies are maintained after uploading the application.

    Note: See "Step 6: Upload and Import Rules and Data" on page 4-31 for more information.

    [HowTo]

    Step 4: Create a Product Rule

    A product rule (Rule-Admin-Product rule type) identifies all the RuleSets, versions, data objects, and other

    parts of an application, such as an organizational hierarchy, workbaskets, access groups, and operators.

    When you define a product rule instance, you specify the following information:

    The intended name and version of the product. The name must start with a letter and contain only

    alphanumeric characters. The version can include only alphanumeric characters, periods (.), and

    hyphens (-); it need not match a RuleSet version.

    The RuleSets and versions to include.

    The data instances used in the application.

    Perform these steps to create a product rule instance.

    Step 1: Open the form and create a new instance

    1. From the Rules by Type explorer, select SysAdmin > Product.

    2. Click New. The New form appears.

    3. Enter the name and version of the product. The .zip extension is not required.

    4. Select your RuleSet name and version.

    5. Click Create. The Product form appears.

    Step 2: Specify the RuleSets and Versions

    On the Contents tab of the form, specify the RuleSets and versions.

    1. Enter the RuleSets and versions that together define the application or product.

    2. Specify the RuleSet version to export. You can choose only RuleSet versions that are direct or

    indirect prerequisites of the RuleSet and version of this rule.

    Here is an example of a completed RuleSet and Version array (Figure 4-10):

    http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp24.asp#bk55http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp24.asp#bk55http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp24.asp#bk55http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp22.asp#bk57http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp22.asp#bk57http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp22.asp#bk57http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp22.asp#bk57http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp24.asp#bk55
  • 7/30/2019 About Deployment Steps

    3/13

    Figure 4-10. Order of RuleSets

    The versions you enter designate the highest version within a revision level you want to export; the value

    you enter includes all lower revisions. For example, in Figure 4-10, the entries have the following meaning:

    ALL - Export all the versions belonging to the MyCo RuleSet.

    02 - Export all versions equal to and lower than major version 02 of MyCoIns.

    01-03 - Export all versions equal to or lower than minor version 01-03 of MyCoUtilities.

    05-03-10 - Export all versions equal to or lower than 05-03-10 of Pega-ProCom.

    When to use a product patch rule

    Use a product patch rule instance (Rule-Admin-Product-Patch rule type) to package a single minor version

    identified by a full 6-digit version number in the form NN-NN-NN. For example, if you enter version 01-01-

    10 in the Product form, the ZIP file can include rules from versions 01-01-01 through 01-01-10. If you enter

    01-01-10 in this field of the Product Patch form, only rules from a single exact version 01-01-10 are placed

    in the ZIP file.

    Creating a product patch rule is like creating a product rule (as described in this section), with the following

    exceptions:

    The New form requires a revision number as a third key part.

    You must identify the data instances with a when rule.

    The patch rule does not contain a Query Data Instances section.

    Step 3: Specify the data classes and instances

    For an application to run correctly on the destination system, you must specify the data classes and

    instances that you are exporting, including all the data classes that are part of the product. The technical

    lead should specify these class names for you, because they vary for each installation. The classes

    include instances for the organization structure, security (access groups), connections to databases,external systems, and other Process Commander system-related instances.

    You specify the data classes and instances in the Data Instances to Include section, as shown inFigure 4-

    11.

    Figure 4-11. Data Instances to Include Section

    To include data classes:

    You must include the following:

    Database table names (see Chapter 5, "Managing the Data")

    Class groups and database table maps (see Chapter 5)

    Access groups (see Chapter 6, "Configuring Access Rights")

    http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp22.asp#bk57http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp22.asp#bk57http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp22.asp#bk57http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp22.asp#bk59http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp22.asp#bk59http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp22.asp#bk59http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp22.asp#bk59http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp22.asp#bk59http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp22.asp#bk59http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp22.asp#bk57
  • 7/30/2019 About Deployment Steps

    4/13

  • 7/30/2019 About Deployment Steps

    5/13

    Figure 4-12. When Rule for a Product Archive

    The entire string in the Value field is:

    @(Pega-RULES:String).contains(.pxInsName, MYCO)

    You could also use this when rule for each data class that has instances you want to include in your

    product rule, as shown inFigure 4-13.

    Figure 4-13. Using One When Rule in a Product Rule

    [HowTo]To use the Query Data Instances feature:

    The Query Data Instances feature allows you to pick a set of instances from a list. Pegasystems suggests

    that you use Query Data Instances only when specifying a small number of instances, because the when

    rule method can more efficiently handle large numbers of instances and is less prone to error.

    1. Click the top field in the Query Data Instances section and select the data class of the instanceyou want to include.

    2. Click Query.

    3. Select the instance you want from the list that appears, and then click OK in the list.

    Information about the instance is set in the InsKey, Label, and ObjClass fields. You can edit the value of

    the Label field, but do not change the values in the InsKey or ObjClass fields. For example,Figure 4-

    14shows the entry for an operator named [email protected]:

    http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp22.asp#bk61http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp22.asp#bk61http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp22.asp#bk61http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp22.asp#bk62http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp22.asp#bk62http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp22.asp#bk62http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp22.asp#bk62http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp22.asp#bk62http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp22.asp#bk62http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp22.asp#bk61
  • 7/30/2019 About Deployment Steps

    6/13

    Figure 4-14. Example of a Queried Data Instance Listed in a Product Rule

    Step 4: Complete and save the rule

    1. On the History tab, enter a full description of the rule and information on its use.

    2. Save the rule.

    Step 5: Create an Archive ZIP File

    You package product or product patch rules in archive ZIP files to move applications from one Process

    Commander server to another. A product or product patch ZIP archive contains the following elements:

    All the RuleSets specified, including the product or patch rule, the RuleSet rules, the RuleSet

    version rules, versions, and the application rules associated with RuleSets.

    All the data instances identified by the queries or when rules (Rule-Obj-When) used by the product

    or patch rule, such as data objects, and other parts of an application, including an organizational

    hierarchy, workbaskets, access groups, and operators.

    To create an archive ZIP file from the rule form:

    1. Select View > Rules > Checkouts to reconfirm that all the rules are checked in, including the

    product rule. An error is reported identifying each checked-out rule. Neither the original version

    nor the checked-out version of the rule is included in the ZIP archive.

    2. On the Contents tab in the Product or Product Rule form, click Create Zip File.

    3. Enter a file name and click OK.

    The system displays the message "Getting records from the database. Please wait.", and then an in-

    progress display appears. (This step can take several minutes to finish.)

    4. If there are errors, click on the Total Number of Errors link to display a list of them. Correct the

    errors and retry the export process.

    5. When the export process is successful (0 errors), click on the Zip File Created link to save the file

    to a local directory.

    6. To confirm that the operation was successful, use the Class explorer to examine the most recent

    instance of Log-PegaRULESMove.

    Note: See "Using the Export Rules/Data Tool" on page 4-34 for more information.

    Step 6: Upload and Import Rules and Data

    After you have created an archive ZIP file, you upload it to the ServiceDirectory directory in the destination

    Process Commander server. You then import the file by extracting its contents and inserting them in the

    PegaRULES database as rules and data instances.[HowTo]

    http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp27.asp#bk63http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp27.asp#bk63http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp27.asp#bk63http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp27.asp#bk63
  • 7/30/2019 About Deployment Steps

    7/13

    To upload and import the ZIP archive file:

    1. Select File > Import Archive to open the Import Rules/Data tool.

    2. In the Select Import Mode field, do either of the following:

    - Select Local Zip File if the file is located on a local directory. Click the Browse button next to the

    File Name field to select the file. Click Upload File. The wizard uploads the file to the ProcessCommander ServiceDirectory directory and displays the message "File Uploaded

    Successfully."

    - Select Zip File on Serverif the file is already on the server directory (typically the

    ServiceDirectory).

    3. Select one or more of the following options as appropriate:

    - Compile Libraries - Select this option when the RuleSet contains utility function or utility library

    rules, and you want the wizard to compile the libraries as soon as the rules are loaded. You

    can recompile all the libraries later by using the Extract Files option in the System

    Management application.

    - Overwrite Existing Data - Select this option to overwrite with the data instance in the archive ZIP

    file any existing data instances with the same ID (pzInsKey) that are already present in this

    destination Process Commander database.

    - Overwrite Existing Rules - Select this option to overwrite with the rule instance from the archive

    ZIP file any rule instances with the same RuleSet name, RuleSet version, and ID (pzInsKey)

    that are already present in the destination Process Commander database.

    Note: See "About the Import Process" on page 4-37 for more information about using the Overwrite Existing

    Rules/Data options.

    4. Click Import. The import process may take several minutes.

    5. If there are errors, click Total Number of Errors in the lower-right corner of the display form to see

    the error message(s). Correct the errors and create a new ZIP archive file for import.

    Step 7: Verify the Import

    After the import is complete, perform the following actions:

    1. Adjust your access group, if necessary, to give yourself access to the uploaded rules, data, work

    pools, and application rules.

    2. Log out and then log in again with the adjusted access group to review the results.

    (Optional) Step 8: Rebuild LibrariesIf the product rule, patch rule, or a RuleSet ZIP included library rules and you did not select the Compile

    Libraries option when you imported the ZIP, you must rebuild the libraries now.[HowTo]To rebuild the libraries:

    1. From the menu, select Tools > System Management Application.

    2. In the System Management application, select Administration > Rule Utility Library Extractor.

    http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp29.asp#bk64http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp29.asp#bk64http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp29.asp#bk64http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp29.asp#bk64
  • 7/30/2019 About Deployment Steps

    8/13

    3. Enter the name of the RuleSet and the name of the library rule.

    4. Click Extract Libraries. Process Commander extracts the rule, generates Java source files for the

    rule, and compiles the source file into a Java class.

    Using the Export Rules/Data Tool

    In addition to using the product or product patch rule forms, you can create an archive ZIP file using the

    Export Rules/Data tool. The ZIP file can contain:

    All rules in a RuleSet and Version (or all versions). The archive contains all the rules from the

    RuleSet specified, including the RuleSet rule, the RuleSet version rule, and the application rule

    associated with the RuleSet (if any). Data is not included in the file. A class instance is not

    created.

    Rules and data defined by an existing product rule (Rule-Admin-Product rule type).

    Rules and data defined by an existing product patch rules (Rule-Admin-Product-Patch rule type).

    You can also use the tool to copy a previously created ZIP file from the Process Commander server to a

    local directory.[HowTo]To create a ZIP archive file:

    1. Verify that the rules designated for the archive are checked out.

    2. From the menu, select File > Export Archive to open the Export Rules/Data tool.

    3. In the Select Export Mode field, select a mode to determine the scope of the contents of the ZIP

    file:

    - By RuleSet/Version- To create a ZIP archive containing all rules in a RuleSet and Version

    (or all versions).

    - By Product - To create a ZIP archive containing rules and data defined by an existing product

    rule (Rule-Admin-Productrule type).

    - By Patch - To create a ZIP archive containing rules and data defined by an existing product

    page rules (Rule-Admin-Product-Patch rule type).

    4. Do one of the following:

    - If you selected By RuleSet/Version, select a RuleSet and version from the lists in the

    RuleSet and RuleSet Version fields. Select a single version for that RuleSet, orAll

    Versions.

    - If you selected By Product, orBy Patch, select the name and version from the field lists. Note

    that the product and patch rule version is not necessarily related to RuleSet Versions.

    5. Enter a filename for your ZIP file in the File Name field. Use 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. The ".zip" suffix is optional. Do not include spaces or an equals sign character (=) in

    the file name.

    6. Click Create ZIP File. The system displays the progress of the extraction, which may require one

    to several minutes. A progress bar shows the count of rules extracted.

  • 7/30/2019 About Deployment Steps

    9/13

    7. If errors are reported, click the Total Number of Errors link in the lower right corner of the display

    form to see the error messages. You can print the list for later analysis. Errors are logged as

    instances of Log-PegaRULESMove-Error.

    8. To save the file to a local directly, click the Zip file created link. Choose Save in the pop-up

    window. (You can download the file later using the ZIP File on Server option.)

    9. Click Close.[HowTo]To download a previously zipped file from the ServiceExport directory:

    1. From the menu, select File > Export Archive.

    2. In the Select Export Mode field, select Zip File on Server.

    3. Select the file to download and click Download Zip File. The standard Windows File Download

    window appears.

    Note: The tool locates only files with the .zip extension in lowercase letters.

    4. Specify a name and location for the downloaded file and click Save. The ZIP file is saved to your

    system.

    About the Import Rules/Data Tool

    The Import Rules/Data tool lets you import into a Process Commander system the contents of an archive

    ZIP files produced by the following Process Commander features:

    Export Rules/Data tool. See page 4-34.

    Purge/Archive wizard. See chapter 5, Purging and Archiving Work Objects.

    Product Package wizard. See page 4-44.

    Product or Product Patch rule forms. See pages 4-30.

    See Step 6: Upload and Import Rules and Data on page 4-31 for a description of how to use the tool.

    http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp24.asp#bk55http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp24.asp#bk55http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp24.asp#bk55http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp24.asp#bk55
  • 7/30/2019 About Deployment Steps

    10/13

    Application Deployment: Walking Through the Steps

    The application deployment process comprises the following steps (Figure 4-9):

    Step Description Page

    1 Check in rules to be deployed 4-22

    2 Run rule reports to confirm that the appropriate rules are checked in 4-22

    3 Lock the RuleSet versions 4-23

    4 Create a product rule 4-23

    5 Create a product archive ZIP file 4-30

    6 Upload and import the archive file to the system 4-31

    7 Verify the import 4-32

    8 (Optional) Rebuild libraries 4-33

    Figure 4-9. Application Deployment Steps

    The procedures on the indicated pages describe product rule deployment. Product patch rule deployment

    is similar, with the exceptions described on page 4-25.

    Step 1: Check In Rules

    As the system administrator, work with the technical lead to ensure that all the rules are checked in to their

    respective RuleSets before you lock them for export. Checked-out rules will not be included in the export

    file and, therefore, will not be moved from the source system.

    Step 2: Run Rule Reports

    Run rule reports to ensure that all the rules are checked in and to ascertain the number of rules to be

    moved. To see all the rules that are checked out, select View > Rules > All Checkouts from the menu. This

    report also indicates the developer who has the rule checked out. You can view the checked-out rules

    organized by RuleSet and version or by version and RuleSet.

    Step 3: Lock the RuleSet Versions

    As a best practice, lock the RuleSets and the application rules to prevent unexpected changes. For

    RuleSet versions, the locking fields are on the Security tab. For application rules, the locking fields are on

    the Publish tab. Lock each RuleSet version and supply a password. Note the password in a safe location.

    Caution: Do not unlock and make changes to a RuleSet after deploying it to a new location. Doing so will

    likely invalidate the versioning process.

    http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp18.asp#bk56http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp18.asp#bk56http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp18.asp#bk56http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp18.asp#bk56
  • 7/30/2019 About Deployment Steps

    11/13

    About Deployment Steps

    There are four overall steps for deploying a Process Commander application. It is important to note that

    verification testing occurs at each step of the process. Such testing involves a technical lead who provides

    an activity or process to ensure that the system is functionally correctly.

    Typically, you use archive ZIP files to implement your deployment strategy as follows:

    Product archives to build the initial implementation or deploy an application that contains a large

    number of rule updates.

    Product patch archives to deploy bug-fix versions on subsequent production releases. If there are a

    large number of patch versions, it is suggested that you skim them to the next major or minor

    version. See "Skimming to a New Version on the Same System" on page 4-56.

    Step 1: First Deployment to Acceptance Testing

    The first deployment to a new acceptance test server involves creating a new product rule, which captures

    the locked application RuleSets and data elements in a product archive (.zip).

    The ZIP file is imported to the destination server and verification is performed to ensure that theapplication is performing correctly. This step involves three tasks:

    1. Follow the application deployment steps to create a new product archive.

    2. Import the product archive to acceptance test.

    3. Add the RuleSets/Versions to the acceptance test profiles.

    Step 2: Development Continues

    Because the RuleSets sent to testing are locked, development increments them to the next version and

    continues work on the development server. This step involves four tasks:

    1. Create a new RuleSet Version on the development server.

    2. Enter the correct prerequisites.

    3. Adjust the Access Groups to reflect the new RuleSet Version.

    4. Save the new rules (or changes) in a higher revision (performed by the developer).

    Figure 4-22illustrates the tasks involved in the first deployment and continuation of development. Note

    that the product archive also contains application data.

    Figure 4-22. First Deployment to Acceptance Testing

    Step 3: Rule Revisions Deployed to Testing

    http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp40.asp#bk74http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp40.asp#bk74http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp40.asp#bk74http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp37.asp#bk75http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp37.asp#bk75http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp37.asp#bk75http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp40.asp#bk74
  • 7/30/2019 About Deployment Steps

    12/13

    When subsequent rules and fixes need to be deployed to acceptance testing, create a product patch

    archive that stores all the rules of the new locked RuleSet (for example, APPRuleSet:01-01-02).

    A product patch contains only the rules from a single version of a RuleSet.

    You also need to adjust any data configurations and access to the new RuleSet Versions.

    Note: Access is discussed in Chapter 6 "Configuring Access Rights."

    This step involves four tasks:

    1. Lock the RuleSet to be deployed (APPRuleSet:01-01-02).

    2. Deploy a product patch ZIP file to capture only APPRuleSet:01-01-02 and any additional data.

    3. Upload and import the product patch for an acceptance test.

    4. Continue development.

    Figure 4-23illustrates the tasks involved in rule revision deployments and continuation of development.

    Note that the product patch archive also contains application data.

    Figure 4-23. Rule Revision Deployments to Acceptance Testing

    Note: If there are large numbers of rule updates, you can choose to migrate the application in a product

    archive.

    Step 4: Production Deployment

    When an application goes into production, all the RuleSets that make up the application are locked

    (including all the prerequisite RuleSets if the production system is empty). The product archive is initially

    moved to the production system. Use product patches for subsequent updates.

    Note: See Chapter 6 "Configuring Access Rights," for information on configuring access rights.

    Figure 4-24illustrates the tasks involved in deploying the final application to the production system. Note

    that the product archive also contains necessary application data.

    http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp37.asp#bk76http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp37.asp#bk76http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp37.asp#bk77http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp37.asp#bk77http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp37.asp#bk77http://pdn.pega.com/ProductSupport/Products/PegaRULESProcessCommander/documents/PRPC/V5/503/HTMLdocs/AdminSecurityGuide53_html/AdminSec_04_Rulesetsp37.asp#bk76
  • 7/30/2019 About Deployment Steps

    13/13

    Figure 4-24. Final Deployment to Production

    Note: This example assumes that no previous applications are deployed on the production server.