Generating the GC Log

The Watchdog utility requires that a Java GC log file be present.

To enable verbose GC logging when starting OpenText PPM:

  1. Go to the <PPM_Home>/bin directory and open the kStart.sh file in a text editor.

  2. Locate the following SYSTEM_PROPS lines in the script:

    SYSTEM_PROPS="$SYSTEM_PROPS -Djava.io.tmpdir=$KNTA_HOME/server/$SERVER_NAME/tmp"
    SYSTEM_PROPS="$SYSTEM_PROPS -Djava.security.auth.login.config=$KNTA_HOME/server/$SERVER_NAME/deploy/admin-jmx.war/conf/auth.conf"
  3. Add the following line to generate the GC metric output file:

    SYSTEM_PROPS="$SYSTEM_PROPS -Xloggc:gclog_"$SERVER_NAME"_`date +%Y%m%d_%H%M`.gc -XX:+PrintGCTimeStamps - XX:+PrintGCDetails"
  4. Stop, and then start the PPM Server in debug mode by running:

    sh ./kStart.sh -debug

The <PPM_Home> directory now contains a file with garbage collection metrics, and the <PPM_Home>/bin directory contains the PPM Server log.

Note: On Windows systems, you may need to start the PPM Server using kStart.sh. If you start the PPM Server in service mode, the Watchdog utility may not work.