Support Article
503 error when launching PRWeb
Summary
Issues with the post deployment instructions of Pega 7.3.1.
After installing the DB component using the UI installer and configuring the application server by modifying the context.xml and tomcat users.xml, the three war files, prweb, prhelp and prsysmgmt are deployed.
However seeing 503 error when trying to access prweb application.
Guides referenced:
https://pdn.pega.com/documents/pega-731-platform-installation-guide-apache-tomcat-and-postgresql
https://pdn.pega.com/documents/platform-support-guide
Error Messages
For prweb: http://your_host:your_port/prweb/
HTTP Status 503 – Service Unavailable
Type Status Report
Message PegaRULES server not available
Description The server is currently unable to handle the request due to a temporary overload or scheduled maintenance, which will likely be alleviated after some delay.
Steps to Reproduce
1. Setup DBname in Postgres: Pega731.
2. Create split scheme PegaDATA and PegaRULES and added the search path in the DB properties in parameters.
3. Install MSVC 2012 Runtime components (already installed).
4. Confirm Path and Java Home points to JDK root.
5. Copy plJava.dll and jar to C:\Program Files\PostgreSQL\9.6\lib
6. Decide on Standard Edition along with NO Kerberos Authentication.
7a.) Run the install.sql to create the schema required for install.
b.) Modify postgresql.conf with the appropriate variables:
pljava.classpath='C:\\Program Files\\PostgreSQL\\9.6\\lib\\pljava.jar'
pljava.vmoptions = '-Xms32M -Xmx64M -XX:ParallelGCThreads=2'
work_mem = 5MB
pljava.libjvm_location = 'C:\\Program Files\\Java\\jdk1.8.0_144\\jre\\bin\\server\\jvm.dll'
8. Install UI, do not bypass DDL, and setup with default security, system name pega731, prod level 1.
Note: Duration 53 minutes 53 sec's of installation.
9. Modify context.xml in Tomcat8.5/conf/ as per instructions in mentioned guide.
10. Install using dual user configuration and create two schema's rules and and data.
11. Modify tomcat-users.xml and add the require roles and user.
12. Set tomcat java parameters tomcat8.exe //US//Tomcat8 ++JvmOptions=-Xms4096m
–Xmx8192m;-XX:PermSize=512m;-XX:MaxPermSize=1024m
13. Copy Pega war files to tomcat\webapps and restart the Tomcat application server.
14. Stop Tomcat and remove the preweb.war and start the service.
Root Cause
A software use or operation error:
Review PegaRULES log to find that Pega Engine initialization fails due to java.lang.OutOfMemoryError: GC overhead limit exceeded. Min and Max values were set too low (128 and 256 respectively).
Resolution
Perform the following local-change:
Increase Initial memory pool to 4096 and Maximum memory pool to 8192.
Published March 23, 2018 - Updated October 8, 2020
Have a question? Get answers now.
Visit the Collaboration Center to ask questions, engage in discussions, share ideas, and help others.