Setting Arguments

Use these instructions for each P6 EPPM application that you deploy in a managed or clustered server. To continue configuring WebLogic for P6, you must add the following arguments to your managed or clustered server in the WebLogic Administration console.

To set WebLogic Server arguments:

In the Change Center pane of the Administration Console, click Lock & Edit.
On the Domain Structure pane, expand Environment and then click Servers.
In the Summary of Servers page, click the managed server on which you deployed your application or Help.
In Configuration tab, on the Settings for <managed server name> page, navigate to the Server Start tab.
In the Arguments field, enter the following arguments as necessary in the order that they appear:
- -server
- -Dprimavera.bootstrap.home=<P6_EPPM_BootStrap_Home>
  where <P6_EPPM_BootStrap_Home> is the home directory of BREBootStrap.xml. If you do not have a BREBootStrap.xml file for your P6 EPPM implementation, you can create one by creating a P6 EPPM configuration using the Database Configuration wizard. For more information about using the Database Configuration wizard, see the P6 EPPM Database Administration Guide.
- -Ddatabase.instance=db_id
  Include this argument to establish a default database connection for P6 Team Member, P6 EPPM Web Services, and P6 Integration API if you use more than one database instance. You do not need to set this argument for P6.
- -Dweblogic.webservice.i18n.charset=utf-8
  (Optional) Include this argument to allow WebLogic to process UTF-8 characters.
- -Djava.awt.headless=true
  (With UNIX only) Include this argument if you are deploying P6 EPPM on a non-graphical UNIX environment. This argument sets the server's JVM to bypass server-side rendering optimizations. If you do not add the argument, you may not be able to see graphics on pages and the server logs will report NoClassDefFoundError errors.
- -Djavax.xml.stream.XMLInputFactory=com.ctc.wstx.stax.WstxInputFactory
  (Optional) Include this argument for improved performance when starting the WebLogic domain.
- -XX:MaxPermSize=
  (Optional) Include this argument to set the new generation heap size. The MaxPermSize setting should be set to at least 256m. You can modify memory settings to maximize performance.
- -XX:NewSize=
  (Optional) Include this argument to set the maximum size of the new generation heap size. As a general rule, set -XX:NewSize to be one-fourth the size of the heap size. Increase the value of this option for larger numbers of short-lived objects. Be sure to increase the new generation as you increase the number of processors. Memory allocation can be parallel, but garbage collection is not parallel.
- -XX:MaxNewSize=
  (Optional) Include this argument to set the maximum size of the new generation heap size.
- -XX:SurvivorRatio=
  (Optional) Include this argument to set new heap size ratios.
  
  The New generation area is divided into three sub-areas: Eden, and two survivor spaces that are equal in size. Configure the ratio of the Eden/survivor space size. Try setting this value to 8, and then monitor your garbage collection.
- -Xms -Xmx
  (Optional) Include this argument to set the initial and maximum heap size.
  
  As a general rule, set the initial heap size (-Xms) equal to the maximum heap size (-Xmx) to minimize garbage collection.
- -XX:+UseParallelGC -XX:+UseParallelOldGC -XX:GCTimeRatio=19
  (Optional) Include this argument if you are running Publication Services on a larger database.
- -Xloggc:<Log_Path>
  Include this argument to collect garbage logs if you have memory issues on JVM.
For example:

(With Windows)

-server -Dprimavera.bootstrap.home=<P6_EPPM_Home> -Djavax.xml.stream.XMLInputFactory=com.ctc.wstx.stax.WstxInputFactory -XX:MaxPermSize=256m -XX:NewSize=256m -XX:MaxNewSize=256m -XX:SurvivorRatio=8 -Xms2048m -Xmx2048m -XX:+UseParallelGC -XX:+UseParallelOldGC -XX:GCTimeRatio=19 -Xloggc:<Log_Path>

(With UNIX)

-server -Dprimavera.bootstrap.home=<P6_EPPM_Home> -Djava.awt.headless=true -Djavax.xml.stream.XMLInputFactory=com.ctc.wstx.stax.WstxInputFactory -XX:MaxPermSize=256m -XX:NewSize=256m -XX:MaxNewSize=256m -XX:SurvivorRatio=8 -Xms2048m -Xmx2048m -XX:+UseParallelGC -XX:+UseParallelOldGC -XX:GCTimeRatio=19 -Xloggc:<path to the log file>

Note: If you use additional arguments that are not listed here, be sure to list them in the correct sequence for your environment.
Click Save.
Add arguments to the managed servers on which applications or Help are deployed.
In the Change Center pane, click Activate Changes.
Restart your managed servers.

Related Topics