Retrieving Monitored Data About Directory Proxy Server by Using the JVM

Directory Proxy Server runs inside a Java Virtual Machine (JVM) and depends on the memory of the JVM machine. To ensure that Directory Proxy Server is running correctly, you must monitor the memory consumption of the JVM machine.

For information about how to tune parameters for the JVM machine, see Hardware Sizing For Directory Proxy Server in Sun Directory Server Enterprise Edition 7.0 Deployment Planning Guide.

By default, the heap size of the JVM machine is 250 Mbytes. If Directory Proxy Server does not have enough physical memory, the heap size might be less than 250 Mbytes.

When Directory Proxy Server is running, you can monitor the heap size of the JVM machine to ensure that it is not running out of memory. To do this, use the standard tools delivered with the Java Development Kit (JDK). These tools are located in these directories: $JAVA_HOME/bin/jps and $JAVA_HOME/bin/jstat.

To View the Heap Size of the JVM

You cannot use DSCC to perform this task. Use the command line, as described in this procedure.

1. View the heap size of JVM.

   $ dpadm get-flags instance-path jvm-args jvm-args: -Xms250M -Xmx250M

To Monitor the Heap Size of JVM When Directory Proxy Server is Running

You cannot use DSCC to perform this task. Use the command line, as described in this procedure.

1. View the PID of your instance of Directory Proxy Server.

   $ jps

2. View the memory used by the JVM machine.

   $ jstat -gcutil PID

   • If the zero column is near to 100%, the JVM machine does not have enough memory.

   • FGC is the number of full garbage collection (GC) events. Garbage collection is expansive.

   • GCT (garbage collection time) is the amount of time spent by the GC.