How do I increase the amount of memory allocated for the VigilEnt Policy Center service? (NETIQKB47119)

goal
How do I increase the amount of memory allocated for the VigilEnt Policy Center service?

goal
What does a java.lang.OutOfMemoryError mean?

goal
How do I prevent the VigilEnt Policy Center service from terminating?

fact
VigilEnt Policy Center 3.x

fact
VigilEnt Policy Center 4.0

fact
VigilEnt Policy Center 4.1

symptom
Error: ' java.lang.OutOfMemoryError
<<no stack trace available>>
[ERROR] ThreadPool - -Caught exception executing org.apache.tomcat.util.net.TcpWorkerThread@1ef158, terminating thread <java.lang.OutOfMemoryError> '

cause
The VigilEnt Policy Center service requires more memory than the 256 megabytes used by default. 

fix

The following procedure uninstalls your VigilEnt Policy Center service and re-installs it with new memory settings you specify.

1. Using a text editor, navigate to the following location:
•  <installation directory>\NetIQ\VigilEnt Policy Center\bin\installVPCService.bat (On VigilEnt Policy Center 4.0 and later)
• <installation directory>\PentaSafe\VigilEnt Policy Center\bin\installVPCService.bat (On VigilEnt Policy Center 3.x or an installation upgraded from 3.x)
2. Locate the following line of commands:

tomcat -install "VigilEnt Policy Center" "%JVM%" -Djava.endorsed.dirs="%JAVA_ENDORSED_DIRS%" -Djava.class.path="%CLASSPATH%" -Xincgc ?Xms256m ?Xmx256m -Dcatalina.base="%CATALINA_BASE%" -Dcatalina.home="%CATALINA_HOME%" -Djava.io.tmpdir="%CATALINA_TMPDIR%" -Xrs -start %MAINCLASS% -params start -stop %MAINCLASS% -params stop -out "%OUT_LOG_FILE%" -err "%ERR_LOG_FILE%" -current "%CATALINA_HOME%"5.

3. Edit the installVPCService.bat file:

1. Insert the following command on the line preceding the command that begins tomcat -install "VigilEnt Policy Center":

tomcat -uninstall "VigilEnt Policy Center"

2. Locate the following section: -Xms256m ?Xmx256m.
3. Change both instances of 256 to the maximum memory, in megabytes, that you want to allocate to the VigilEnt Policy Center service.  For example, to increase the memory allotment to one gigabyte, change -Xms256m ?Xmx256m to ?Xms1024m ?Xmx1024m.
4. Save and close the file. 

4. Stop the VigilEnt Policy Center service.
5. Run the installVPCService.bat file.
6. After the installVPCService.bat file is complete, restart the VigilEnt Policy Center service.

note

Example
A modified entry in an  installVPCService.bat file that allows the VigilEnt Policy Center service to use up to 1 gigabyte of memory:

tomcat -uninstall "VigilEnt Policy Center"
tomcat -install "VigilEnt Policy Center" "%JVM%" -Djava.endorsed.dirs="%JAVA_ENDORSED_DIRS%" -Djava.class.path="%CLASSPATH%"  -Xincgc ?Xms1024m ?Xmx1024m -Dcatalina.base="%CATALINA_BASE%" -Dcatalina.home="%CATALINA_HOME%" -Djava.io.tmpdir="%

Formerly known as NETIQKB47119