Modifying setDomainEnv for Applications Deployed on Administration Servers

Use these instructions for each P6 EPPM application that you deploy on an administration server.

To edit the setDomainEnv file:

Navigate to <WebLogic_Home>/user_projects/<Domain_Home>/bin and make a backup copy of the setDomainEnv.cmd (on Windows) setDomainEnv.sh (for UNIX).
Edit the setDomainEnv file.
After %WL_HOME%/common/bin/commEnv.cmd" (on Windows) ${WL_HOME}/common/bin/commEnv.sh (on UNIX), 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.
Save and Close the file.
Restart the admin server.

Modifying setDomainEnv for Applications Deployed on Administration Servers

Related Topics