Skip to main content

This content has been archived and is no longer being updated. Links may not function; however, this content may be relevant to outdated versions of the product.

Support Article

503 error when launching PRWeb



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:

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
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).


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

Was this useful?

0% found this useful

Have a question? Get answers now.

Visit the Collaboration Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best.

Pega Community has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice
Contact us