An installation error is happening at a Windows terminal from which I am trying to setup Pega Platform 8.3 onto a remote database using IUA (see below screenshot).
This is happening because system could not find or load a main class "Xmx4g" for JVM arguments. Below is the installation error log file.
[echo] *** JVM Arguments Xmx4g -XX:+HeapDumpOnOutOfMemoryError ***
Found 12399928KB of free space on 'C:\Users\ADMINI~1\AppData\Local\Temp\2\'
This terminal is a valid JRE installed one as we have been using this for installation of prior Pega Platform version that includes 7.4, and 8.2 and it was always successful. So nothing is fundamentally wrong with its desktop environments. I have actually investigated where this "Xmx4g" guy comes from, and I identified it is in the setupDatabase.properties file. Although installation guide does not say anything about the changes about this file, but there are lots of changes made in this file between 8.3 and prior version. Below is the example of additional section that did NOT exist in 7.4.
# CUSTOM JVM ARGUMENTS
# To add custom JVM arguments, add a space-delimited list of JVM arguments in the format:
# Xmx4g <jvm1> <jvm2>
# When setting custom.jvm.args, the max heap size must be set to a minimum of 4g.
I have experimented to see what happens if I comment out the last line to enable to reduce the memory size from 4g to 2g, but the result was the same (failure). We have enough memory available in this terminal. The installation guide says, required memory is 1.25GB to run IUA.
My question is, what is wrong with the settings and how can I proceed further. More importantly, the installation guide is incorrect in that all the changes in the setupDatabase.properties are not reflected and it has to be updated accordingly. Insights from product team is much appreciated.
I would never use that little memory to run installation. To control how much memory to run, I normally start the IUA as "java -Xmx 4096m -jar PRPC_Setup.jar", that should be enough. Also make sure the JDK is at least java 1.8+.
Hi, thanks for your response. After I added 8 more gigabytes to make it 16GB but the result was the same. At the same time, I just figured this is not really because of out-of-memory but the error says: "Main class Xmx4g was not found or loaded". I am starting to think this may be coming from JRE environments. Anyone has any idea? We are using JRE 1.8.0_171 but I want to check exact version requirements. The installation guide does not say but where can I find those information?
Support Guide only talks about the Java version for application server. In my case, I am running Java from a relay Windows PC that is different from application server. The purpose of doing this is for customer to use GUI based wizard as application is UNIX and does not have X Window. JRE version for running IUA is not described in the platform support guide.
FYI, we have installed JRE 1.8.0_171 which is supported according to platform support guide.