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

SA-46999

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.
Suggest Edit

Published March 23, 2018 - Updated October 8, 2020

Did you find this content helpful? Yes No

Have a question? Get answers now.

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

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