How To
ForgeRock Identity Platform
Does not apply to Identity Cloud

How do I check what version of AM (All versions) I have installed?

Last updated Feb 24, 2021

The purpose of this article is to provide information on finding the AM product version whether the server is running or not.


Finding the AM version

There are a number of different ways to find the product version. The following sections demonstrate how you can find the version number using different options, with the ones that require a running server noted:

Using the console (running server only)

You can find the version number using the admin console by navigating to any of the following places:

  • Check the footer at the bottom of the AM console. The footer shows the version number once you are logged in as amAdmin (unless you have customized your pages to remove it). For example:
  • Check the value of the com.iplanet.am.version property in the console by navigating to: Configure > Server Defaults > Advanced.
  • Navigate directly to the /json/serverinfo/version endpoint once you are logged into the console as amAdmin, for example:  http://host1.example.com:8080/openam/json/serverinfo/version

Using standard Unix and Linux commands

You can use any of the following CLI commands to find the version number:

$ cat /path/to/tomcat/webapps/openam/WEB-INF/classes/serverdefaults.properties | grep am.version $ find /path/to/tomcat/webapps/openam -name openam*.jar | grep openam-core $ cat /path/to/openam/.version 

Example: the following is a hidden .version file located in the /path/to/openam directory:

$ cat /opt/openam/.version  ForgeRock Access Management 6.5.1 Build 24e379e3e1 (2019-April-05 09:02)

Using REST (running server only)

You can use the REST API to find the version number as follows:

  1. Authenticate as an admin user. For example:$ curl -X POST -H "X-OpenAM-Username: amadmin" -H "X-OpenAM-Password: cangetinam" -H "Content-Type: application/json" -H "Accept-API-Version: resource=2.1" http://host1.example.com:8080/openam/json/realms/root/authenticate?authIndexType=service&authIndexValue=adminconsoleservice Example response:{ "tokenId": "AQIC5wM2LY4SfcxsuvGEjcsppDSFR8H8DYBSouTtz3m64PI.*AAJTSQACMDIAAlNLABQtNTQwMTU3NzgxODI0NzE3OTIwNAEwNDU2NjE0*", "successUrl": "/openam/console", "realm": "/"
  2. Request the server version using the following curl command: $ curl -X GET -H "iPlanetDirectoryPro: AQIC5wM2LY4Sfcxs...EwNDU2NjE0*" http://host1.example.com:8080/openam/json/serverinfo/version Example response: {"_id":"version","_rev":"-1907117234","version":"6.5.1","fullVersion":"ForgeRock Access Management 6.5.1 Build 24e379e3e1 (2019-April-05 09:02)","revision":"24e379e3e1","date":"2019-April-05 09:02"}

Using the patchinfo utility

You can use the patchinfo utility to find the version number if you have it installed. See How do I use the patchinfo utility to check what patches are installed for AM or IG (All versions)? for further information.

Using ssoadm (running server only)

You can use the following ssoadm command to find the version number, for example:

  • AM 7 and later: $ ./ssoadm list-server-cfg -u uid=amAdmin,ou=People,dc=openam,dc=forgerock,dc=org -f pwd.txt -s default | grep am.version
  • Pre-AM 7: $ ./ssoadm list-server-cfg -u amadmin -f pwd.txt -s default | grep am.version

Example response:

com.iplanet.am.version=ForgeRock Access Management 6.5.1 Build 24e379e3e1 (2019-April-05 09:02)

See Also

AM (All versions) upgrade fails when com.iplanet.am.version is empty or corrupted

Unable to parse product versions for comparison error after restarting AM (All versions)

Related Training

N/A

Related Issue Tracker IDs

N/A



Copyright and TrademarksCopyright © 2021 ForgeRock, all rights reserved.
Loading...