Question
Accenture
IN
Last activity: 14 Feb 2016 6:42 EST
Information required for Build automation
Hi,
We completed Deployment Automation for our client using Utils script from Pega and some parametrized script (Shell script).
Now need to start Build automation.
I can see a lot options in prpcUtils.properties for export / create a deployment package.
Can some one give me some scenarios like..
Is it possible to create a deployment package using only RuleSet Name & Version in prpcUtils.properties? (Multiple RuleSet Names & Versions).
If it is not possible , What are the mandatory inputs / parameters we are supposed to mention in prpcUtils.properties file ?
Please find the below highlighted parameters from Export / build part from prpcUtils.properties file.
############################### SETTINGS FOR EXPORT TOOL ##########################
###################################################################################
# FULL PATH TO ARCHIVE (REQUIRED) :
export.archive.full.path=
# Identify a Rule-Admin-Product instance by its pzInsKey (EXPORT RAP only)
export.archive.productkey=
# CLASSES TO INCLUDE (REQUIRED -- if not specifying a product key):
# classes.included : classes to include, separate classes by commas (no spaces)
# included.descendent : true (include descendants)
# NOT required if exporting a list of pzInsKeys
Hi,
We completed Deployment Automation for our client using Utils script from Pega and some parametrized script (Shell script).
Now need to start Build automation.
I can see a lot options in prpcUtils.properties for export / create a deployment package.
Can some one give me some scenarios like..
Is it possible to create a deployment package using only RuleSet Name & Version in prpcUtils.properties? (Multiple RuleSet Names & Versions).
If it is not possible , What are the mandatory inputs / parameters we are supposed to mention in prpcUtils.properties file ?
Please find the below highlighted parameters from Export / build part from prpcUtils.properties file.
############################### SETTINGS FOR EXPORT TOOL ##########################
###################################################################################
# FULL PATH TO ARCHIVE (REQUIRED) :
export.archive.full.path=
# Identify a Rule-Admin-Product instance by its pzInsKey (EXPORT RAP only)
export.archive.productkey=
# CLASSES TO INCLUDE (REQUIRED -- if not specifying a product key):
# classes.included : classes to include, separate classes by commas (no spaces)
# included.descendent : true (include descendants)
# NOT required if exporting a list of pzInsKeys
export.classes.included=
export.included.descendent=true
# CLASSES TO EXCLUDE
# classes.excluded : classes to exclude, separate classes by commas (no spaces)
# excluded.descendent : true (exclude descendants)
# For example, if including classes with descendants (Rule-) you can use this
# to filter specific classes
export.classes.excluded=
export.excluded.descendent=true
# RULESET VERSION RANGE :
# Specifies a minimum RuleSet version for Rule Resolved instances
# of Rule- (e.g. 05- or 05-01-01)
export.startVersion=
export.endVersion=
# Full path to a file which contains instances to export
# identified by pzInsKey, 1 per line.
# if exporting a list of pzInsKeys, do not provide other arguments such as export.classes.included
export.keys.file=
# RULESET NAME :
# Include instances of this RuleSet (for Rule- classes). This is case sensitive (e.g. pass Pega-Desktop, not pega-desktop)
export.ruleset.name=
# Specify application name (only one) with version for exporting ABV ruleset in this application's context.
# For example, PegaRULES!07.10
export.application.context=
# Preserve lock property on checked out instances
# Only use if moving the corresponding locked instance
export.preserve.locks=false
# MIGRATION EXPORT :
# Both of the following properties are required for a migration export
#
# full-path to the XML File containing classes to export
# example: export.migration.xml=C:/users/administrator/exportClasses.xml
export.migration.xml=
# export all instances created or updated after, uses format: YYYY MM DD hh mm ss S a
# example: for March 15, 2012 04:42:00:0 PM, set export.migration.date="2012 03 15 04 42 00 0 PM"
export.migration.date=
-
Like (0)
-
Share this page Facebook Twitter LinkedIn Email Copying... Copied!
Accepted Solution
Accenture
IN
I'm able to create deployable jar package using scripts from application.
But this is not complete automation because, some one has to create product rule in memory of application.
As of now i don't see any other option to automate rules extraction (Creating deployable jar file) using scripts.
Hi Chenna,
Have you referred to following PDN article:
https://docs-previous.pega.com/how-import-or-export-archive-command-line
Updated: 28 Dec 2015 23:49 EST
Accenture
IN
Yes Aditya,
I checked that.
I followed the same procedure.
I passed Class name, RuleSet Name, RuleSet Version Range, Package saving path.
Whenever execute the command line, it is generating the package with the whole instances of Class irrespective of RuleSet Name and Version.
So the generated package is huge, not the one which expecting.
EX: i wanted to create a package by exporting instances belongs to Pega-FW-Work class and associated to Pega (RuleSet), and versions from 01-01-01 to 01-02-04.
The package created contains the entire instances of class (Pega-FW-Work). But the package should contains only instances within the Peg-FW-Work class associated Pega (RuleSet) versions from 01-01-01 to 01-02-04.
If i pass only RuleSet name and version,command line tool is not allowing to create package and expecting class.
If i give only class (Pega-FW-Work) it is creating package with the instances of entire class.
I'm not able to create package with desired instances.
Yes Aditya,
I checked that.
I followed the same procedure.
I passed Class name, RuleSet Name, RuleSet Version Range, Package saving path.
Whenever execute the command line, it is generating the package with the whole instances of Class irrespective of RuleSet Name and Version.
So the generated package is huge, not the one which expecting.
EX: i wanted to create a package by exporting instances belongs to Pega-FW-Work class and associated to Pega (RuleSet), and versions from 01-01-01 to 01-02-04.
The package created contains the entire instances of class (Pega-FW-Work). But the package should contains only instances within the Peg-FW-Work class associated Pega (RuleSet) versions from 01-01-01 to 01-02-04.
If i pass only RuleSet name and version,command line tool is not allowing to create package and expecting class.
If i give only class (Pega-FW-Work) it is creating package with the instances of entire class.
I'm not able to create package with desired instances.
I hope my issue is clear to you
Accenture
IN
Guys,
I'm stuck with this task from 2 weeks.
Could you please help me to complete this task?
Hi Chenna,
What is the version of Pega are you using? Can you share the full prpcUtils.propeties file too?
Accenture
IN
Hi Aditya,
We are using 7.1.7 application and utils also 7.1.7 version.
Accenture
IN
I can give you generic property file as the file which we used contains client data like Database information.
Pegasystems Inc.
US
In your properties file do you have export.included.descendent property set to true? If you change it to false does that get you what you are looking for?
# CLASSES TO INCLUDE (REQUIRED -- if not specifying a product key):
# classes.included : classes to include, separate classes by commas (no spaces)
# included.descendent : true (include descendants)
# NOT required if exporting a list of pzInsKeys
export.classes.included=
export.included.descendent=true
Accenture
IN
Hi Celeste Dufresne,
I tried the way you suggested.
I used value as false for export.include.descendent parameter
Unfortunately it is not working.
Pegasystems Inc.
US
Can you go into Pega and create a product rule which has exactly what you want? Once you have that you could use that rule to run the export from prpcUtils or if you post the rule here we can try to figure out how to set the properties to match what you have in the product rule.
Accenture
IN
I created a product rule with required information within application. I tried to export that rule using prpcUtils. While exporting rule, script is expecting class name . Then I gave class name of that rule(Rule-Admin-Product). The script generated all the products from the class (Rule-Admin-Product) .
Pegasystems Inc.
US
Please post the log file from when you tried to export using the product rule as well as the prpcUtils.properties file you are using. I don't care about the database properties, just all of the properties in the section titled "SETTINGS FOR EXPORT TOOL". It would be good to see the product rule as well.
Accenture
IN
Hi Please find the below Setting for EXPORT TOOL details.
############################### SETTINGS FOR EXPORT TOOL ##########################
###################################################################################
# FULL PATH TO ARCHIVE (REQUIRED) :
export.archive.full.path=/u01/app/oracle/middleware/user_projects/scripts/utils/Build/SampleBuild.jar
# Identify a Rule-Admin-Product instance by its pzInsKey (EXPORT RAP only)
export.archive.productkey="RULE-ADMIN-PRODUCT SAMPLEPRODUCT 01-01-01 #20160112T082834.742 GMT"
# CLASSES TO INCLUDE (REQUIRED -- if not specifying a product key):
# classes.included : classes to include, separate classes by commas (no spaces)
# included.descendent : true (include descendants)
# NOT required if exporting a list of pzInsKeys
export.classes.included=RULE-ADMIN-PRODUCT
export.included.descendent=true
# CLASSES TO EXCLUDE
# classes.excluded : classes to exclude, separate classes by commas (no spaces)
# excluded.descendent : true (exclude descendants)
# For example, if including classes with descendants (Rule-) you can use this
Hi Please find the below Setting for EXPORT TOOL details.
############################### SETTINGS FOR EXPORT TOOL ##########################
###################################################################################
# FULL PATH TO ARCHIVE (REQUIRED) :
export.archive.full.path=/u01/app/oracle/middleware/user_projects/scripts/utils/Build/SampleBuild.jar
# Identify a Rule-Admin-Product instance by its pzInsKey (EXPORT RAP only)
export.archive.productkey="RULE-ADMIN-PRODUCT SAMPLEPRODUCT 01-01-01 #20160112T082834.742 GMT"
# CLASSES TO INCLUDE (REQUIRED -- if not specifying a product key):
# classes.included : classes to include, separate classes by commas (no spaces)
# included.descendent : true (include descendants)
# NOT required if exporting a list of pzInsKeys
export.classes.included=RULE-ADMIN-PRODUCT
export.included.descendent=true
# CLASSES TO EXCLUDE
# classes.excluded : classes to exclude, separate classes by commas (no spaces)
# excluded.descendent : true (exclude descendants)
# For example, if including classes with descendants (Rule-) you can use this
# to filter specific classes
export.classes.excluded=
export.excluded.descendent=true
# RULESET VERSION RANGE :
# Specifies a minimum RuleSet version for Rule Resolved instances
# of Rule- (e.g. 05- or 05-01-01)
export.startVersion=
export.endVersion=
# Full path to a file which contains instances to export
# identified by pzInsKey, 1 per line.
# if exporting a list of pzInsKeys, do not provide other arguments such as expo
export.keys.file=
# RULESET NAME :
# Include instances of this RuleSet (for Rule- classes). This is case sensitive
export.ruleset.name=
# Specify application name (only one) with version for exporting ABV ruleset in
# For example, PegaRULES!07.10
export.application.context=
# Preserve lock property on checked out instances
# Only use if moving the corresponding locked instance
export.preserve.locks=false
# MIGRATION EXPORT :
# Both of the following properties are required for a migration export
#
# full-path to the XML File containing classes to export
# example: export.migration.xml=C:/users/administrator/exportClasses.xml
export.migration.xml=
# export all instances created or updated after, uses format: YYYY MM DD hh mm ss S a
# example: for March 15, 2012 04:42:00:0 PM, set export.migration.date="2012 03 15 04 42 00 0 PM"
export.migration.date=
How can I add the log file here?, i don't see any option to add log file
Pegasystems Inc.
US
If you click on the "Use advanced editor" in top right of text area for your reply then you will see on the bottom right a paperclip Attach. Or you reply to the email notification you get for this discussion with the file attached and I think they will get attached that way as well.
Accenture
IN
Sorry I don't see any option "Use advanced editor"
Pegasystems Inc.
US
I'm not sure why you do not see it. In this box that I am typing this reply it is in the top right corner.
Anyway I just tried a product rule export on 6.3sp1 and it worked just fine. From the command line the parameter that you would use is exportRAP when trying to export a product key . And you need to specify the pega.user.username and password in the properties file for the operator to use for rule resolution.
Accepted Solution
Accenture
IN
I'm able to create deployable jar package using scripts from application.
But this is not complete automation because, some one has to create product rule in memory of application.
As of now i don't see any other option to automate rules extraction (Creating deployable jar file) using scripts.