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 Jan 16, 2023

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 AM admin UI (running server only)

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

  • Check the footer at the bottom of the AM admin UI. 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 AM admin UI by navigating to: Configure > Server Defaults > Advanced.
  • Navigate directly to the /json/serverinfo/version endpoint once you are logged into the AM admin UI as amAdmin, for example: https://am.example.com:8443/am/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/am/WEB-INF/classes/serverdefaults.properties | grep am.version $ find /path/to/tomcat/webapps/am -name openam*.jar | grep openam-core $ cat /path/to/am/.version

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

$ cat /opt/am/.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" https://am.example.com:8443/am/json/realms/root/authenticate?authIndexType=service&authIndexValue=adminconsoleserviceExample response:{ "tokenId": "AQIC5wM2LY4SfcxsuvGEjcsppDSFR8H8DYBSouTtz3m64PI.*AAJTSQACMDIAAlNLABQtNTQwMTU3NzgxODI0NzE3OTIwNAEwNDU2NjE0*", "successUrl": "/am/console", "realm": "/" }
  2. Request the server version using the following curl command: $ curl -X GET -H "iPlanetDirectoryPro: AQIC5wM2LY4Sfcxs...EwNDU2NjE0*" https://am.example.com:8443/am/json/serverinfo/versionExample 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=am,dc=forgerock,dc=org -f pwd.txt -s default | grep am.version
  • AM 6.x: $ ./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 Trademarks Copyright © 2023 ForgeRock, all rights reserved.