How To

How do I check if a particular AM/OpenAM (All versions) instance is running?

Last updated Sep 14, 2020

The purpose of this article is to provide information on checking whether a particular AM/OpenAM instance is running in your web application container and who the process owner is for that instance. This information applies to Linux® and Unix® systems.

Checking if an AM/OpenAM instance is running

You can check if a particular AM/OpenAM instance is running using the ps command to display process information. The following example assumes AM/OpenAM is deployed on a Apache Tomcat™ web application container:

  1. Enter the following command:
    $ ps –ef |grep tomcat
    Observe the result, which will indicate if the instance is running:
    • Example output for an AM5 instance running on Tomcat (shows the path as /opt/tomcat/am5, which is the path to AM5 instance in this example):
      forgero+  2240     1  3 10:34 pts/1    00:01:31 /usr/lib/jvm/java-8-oracle/bin/java -Djava.util.logging.config.file=/opt/tomcat/am5/conf/ -Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager -Xms2048m -Xmx2048m -XX:MaxPermSize=512m -Xss256k -XX:+UseParallelGC -XX:MaxGCPauseMillis=1500 -XX:GCTimeRatio=9 -server -XX:+DisableExplicitGC -Djava.endorsed.dirs=/opt/tomcat/am5/endorsed -classpath /opt/tomcat/am5/bin/bootstrap.jar:/opt/tomcat/am5/bin/tomcat-juli.jar -Dcatalina.base=/opt/tomcat/am5 -Dcatalina.home=/opt/tomcat/am5 org.apache.catalina.startup.Bootstrap start
      forgero+  2966  2193  0 11:14 pts/1    00:00:00 grep --color=auto tomcat
      You can also see the process id (2240), the process owner (forgero+) and the current JVM options.
    • Example output when the instance is not running:
      forgero+  3025  2193  0 11:15 pts/1    00:00:00 grep --color=auto tomcat

This command will show details for all instances running if you have multiple instances running on the same Tomcat web application container.

See Also

How do I check if AM/OpenAM (All versions) is up and running?

How do I check that an Agent (All versions) can connect to AM/OpenAM?

How do I perform a heartbeat check against DS/OpenDJ (All versions)?

Related Training

ForgeRock Access Management Core Concepts (AM-400)

Related Issue Tracker IDs


Copyright and TrademarksCopyright © 2020 ForgeRock, all rights reserved.