Running a BIX command-line extraction in on-premises systems
After you configure your source database environment, you can run the Business Intelligence Exchange (BIX) command-line extraction process.
- In the command line, begin a Java call by specify your initial and maximum JVM memory
with the Xms and Xmx parameters.
- Set the initial Java heap size to 512m (-Xms512m).
- Set the maximum heap size to at least 768m (-Xmx768m).
- Reference the file path for the BIX
prconfig.xml
,prbootstrap.properties
, and (if used)prlog4j2.xml
files by using the following parameters:- For the
prconfig.xml
file, enter -Dpegarules.config=<prconfig_filepath>. - For the
prbootstrap.properties
file, enter -Dcom.pega.pegarules.bootstrap.properties.url=<bootstrap.properties_filepath>. - Optional: For the
prlog4j2.xml
file, enter -Dpegarules.logging.configuration=<prlog4j2_filepath>.
- For the
- If you enabled password encryption, add the file path for the
pegarules.keyring
file.For more information, see Enabling password encryption for BIX command-line extractions in on-premises systems. - Disable Java Naming and Directory Interface (JNDI) databases to extract from the
configured source Java Database Connectivity JDBC URL database by using the following
parameter:
-Dcom.pega.pegarules.bootstrap.ignorejndi=true
- Specify the location of .JAR files that are used in the BIX source database library
(
lib
) directory by setting the classpath with the parameter -classpath.Include quotes (" ") around the classpath value. - Optional: To use a username and password with the
-a
and-p
parameters for the extract files according to your source database configuration, call com.pega.pegarules.pub.PegaRULES - Call the Extract Java class
com.pega.pegarules.data.internal.access.ExtractImpl and specify an
Extract rule label with the
-i
parameter. - Enter the node type and node type and node settings for the extract process.
- Optional: To customize your configuration, include additional command-line extraction parameters. For more information, see BIX parameters and command-line arguments.
- Optional: To use an external XML file for the extraction process, perform the following actions:
- In the navigation pane of Dev Studio, click , and then select the Extract rule to run.
- On the rule form, click .
- Copy the resulting page and save the content as an XML file.
- Begin the command-line extraction method as in step 1.
- When you call
com.pega.pegarules.data.internal.access.ExtractImpl to specify an
Extract rule label, provide the file path in which you created the XML file and the
XML file name with the parameter and arguments
-I <filepath> <DDL filename>
.
- Perform the command-line extraction by running the Java method.
Previous topic Enabling password encryption for BIX command-line extractions in on-premises systems Next topic Generating a DDL file for command-line database schema extractions