Platform compatibility

This book provides information on compatibility between ForgeRock products (AM, DS, IDM and IG).


What versions of DS are compatible with AM?

The purpose of this article is to provide compatibility information between DS and AM versions. This includes the embedded DS versions shipped with AM and, the supported Java® versions for each combination.

DS and AM compatibility

Embedded DS

Embedded DS versions are shipped with AM and cannot be upgraded; however, when you upgrade to a newer version of AM, the embedded DS instance is also upgraded. The following embedded DS versions are included with AM:

AM versions Embedded DS version
AM 7.1 DS 7.1
AM 7.0.1  DS 7
AM 7 DS 7
AM 6.5.3 DS 6.5.4
AM 6.5.2.x DS 6.5.2
AM 6.5.1 DS 6.5.1
AM 6.5.0.x DS 6.5
AM 6.0.0.x DS 6
AM 5.5.2 DS 5.5.3
AM 5.5 and 5.5.1 DS 5.5
AM 5 and 5.1.x DS 5

External DS

The following matrix indicates compatibility between AM and external DS versions:

  DS 7.x DS 6.x DS 5.x
AM 7.x Yes Yes Yes
AM 6.x Yes Yes Yes
AM 5.5.x -- Yes Yes
AM 5 and 5.1.x -- Yes Yes
Note

It is strongly recommended that you always upgrade to the latest maintenance releases for whichever versions of AM and DS you have deployed.

Java Compatibility

Java 11

  • AM 6.5 and later.
  • DS 6.5 and later.

Java 9

  • DS 6 only.

Java 8

  • AM 5.x and 6.x
  • DS 5.x and 6.x.

Java 7

  • AM 5 and 5.1.x.
  • DS 5 (but support for it is deprecated).

Software and Hardware requirements

AM

DS

See Also

What operating systems are ForgeRock products supported on?

Checking your product versions are supported

FAQ: Installing AM

FAQ: Upgrading AM

FAQ: Installing and configuring DS

Installing and configuring AM

Installing and Administering DS

Related Training

N/A

Related Issue Tracker IDs

N/A


What versions of Agents are compatible with AM?

The purpose of this article is to provide compatibility information between Agents and AM versions. Also included is the supported Java® versions for each combination.

Agents and AM compatibility

Web Agents

The following matrix indicates compatibility between AM and Web Agent versions:

  Web Agents 5.x
AM 7.x Yes (5.0.1 or later)
AM 6.5.x Yes (5.0.1 or later)
AM 6 Yes (5.0.1 or later)
AM 5.5.x Yes
AM 5 and 5.1.x --

Java Agents

The following matrix indicates compatibility between AM and Java Agent versions:

  Java Agents 5.x
AM 7.x Yes (5.0.1 or later)
AM 6.5.x Yes (5.0.1 or later)
AM 6 Yes (5.0.1 or later)
AM 5.5.x Yes
AM 5 and 5.1.x --
Note

It is strongly recommended that you always upgrade to the latest maintenance releases for the specific versions of AM and Agents you have deployed.

Java Compatibility

Java 11

  • AM 6.5 and later.
  • Java Agents 5.6 and later.

Java 8

  • AM 5.x and 6.x
  • Java Agents 5.x

Java 7

  • AM 5.0 and 5.1.x

Software and Hardware requirements

AM

Web Agents

Java Agents

See Also

What versions of DS are compatible with AM?

Checking your product versions are supported

What operating systems are ForgeRock products supported on?

FAQ: Configuring Agents in Identity Cloud and AM

Installing and configuring AM

Related Training

N/A

Related Issue Tracker IDs

N/A


What versions of IG are compatible with AM?

The purpose of this article is to provide compatibility information between IG and AM versions. Also included is the supported Java® versions for each combination.

IG and AM compatibility

The following matrix indicates compatibility between AM and IG versions:

  IG 7.x IG 6.5.1, 6.5.2, IG 6.5.3 IG 6.5 IG 6, 6.1 IG 5.5.x IG 5
AM 7.x Yes Yes Yes -- -- --
AM 6.5.3 Yes Yes Yes Yes -- --
AM 6.5.1, 6.5.2 Partly * (most features) Yes Yes Yes -- --
AM 6.5 Partly * (most features) All features except mTLS Yes Yes -- --
AM 6 Partly * (most features) All features except mTLS Yes Yes -- --
AM 5.5.x Partly * (most features) All features except mTLS Yes Yes Yes --
AM 5, 5.1.x Partly * (limited features) Partly * (most features) Partly * (most features) Partly * (most features) Yes Yes

* For details of the specific features supported in these versions, please refer to the relevant IG release notes:

Note

It is strongly recommended that you always upgrade to the latest maintenance releases for whichever versions of AM and IG you have deployed.

Java Compatibility

Java 11

  • AM 6.5 and later.
  • IG 7; IG 6.5 on OpenJDK only.

Java 8

  • AM 5.x and 6.x
  • IG 5.x and 6.x

Java 7

  • AM 5 and 5.1.x
  • IG 5

Software and Hardware requirements

AM

IG

See Also

What operating systems are ForgeRock products supported on?

Checking your product versions are supported

FAQ: Installing AM

FAQ: Upgrading AM

FAQ: Installing and configuring IG

Installing and configuring AM

Installing and configuring IG


What versions of DS are compatible with IDM?

The purpose of this article is to provide compatibility information between DS and IDM versions. This includes connecting to DS as an external resource (LDAP connector), the embedded DS repositories shipped with later versions of IDM and the supported Java® versions for each combination.

External resources compatibility

You can connect to DS as an external resource using the LDAP connector (the LDAP connector works with any LDAPv3 compliant servers). The following matrix indicates compatibility between IDM and DS when using the LDAP connector:

  DS 7.x DS 6.x DS 5.x
IDM 7.x Yes Yes Yes
IDM 6.x Yes Yes Yes
IDM 5.x Yes Yes Yes
Note

It is strongly recommended that you always upgrade to the latest maintenance releases for whichever versions of IDM and DS you have deployed.

Repositories compatibility

Embedded DS

Embedded DS repositories have been shipped with IDM since IDM 5.5; these repositories are for testing purposes only and cannot be used in production. The following embedded DS versions are included with IDM:

IDM versions Embedded DS version
IDM 7.1 DS 7.1
IDM 7 DS 7
IDM 6.5.x  DS 6.5
IDM 6 DS 6
IDM 5.5.x DS 5.5

External DS

IDM 6 introduced a new feature where an external DS instance can now be used as a supported repository in production environments. The following matrix indicates compatibility between IDM and external DS repositories:

  DS 7.x DS 6.5.x DS 6
IDM 7.x Yes -- --
IDM 6.5.x -- Yes --
IDM 6 -- -- Yes
Note

It is strongly recommended that you always upgrade to the latest maintenance releases for whichever versions of IDM and DS you have deployed.

Java Compatibility

Java 11

  • IDM 6.5 and later.
  • DS 6.5 and later.

Java 9

  • DS 6 only.

Java 8

  • IDM 5.x and 6.x
  • DS 5.x and 6.x

Java 7

  • IDM 5
  • DS 5 (but support for it is deprecated).

Software and Hardware requirements

IDM

DS

See Also

What operating systems are ForgeRock products supported on?

Checking your product versions are supported

FAQ: Upgrading IDM

FAQ: Installing and configuring IDM

FAQ: Installing and configuring DS

Administering and configuring IDM

Installing and Administering DS

Related Training

N/A

Related Issue Tracker IDs

N/A


What versions of AM are compatible with IDM?

The purpose of this article is to provide compatibility information between AM and IDM versions. This includes the supported Java® versions for each combination.

Compatibility

The following matrix indicates compatibility between IDM and AM for integration purposes:

  AM 7.x AM 6.5.x AM 6 AM 5.5.x AM 5, 5.1
IDM 7.x Yes  --  --  -- --
IDM 6.5.x  -- Yes -- -- --
IDM 6  -- -- Yes -- --
IDM 5.5.x  -- -- -- Yes --
IDM 5  -- -- -- -- Yes
Note

It is  strongly recommended  that you always upgrade to the latest maintenance releases for whichever versions of IDM and AM you have deployed.

The authentication modules available for integration vary according to product versions as follows:

  IDM 7.x IDM 6.x IDM 5.5.x IDM 5
rsFilter Yes -- -- --
OAUTH_CLIENT -- Yes Yes --
OPENID_CONNECT -- -- -- Yes
OPENAM_SESSION -- -- Yes Yes

Java Compatibility

Java 11

  • IDM 6.5 and later.
  • AM 6.5 and later.

Java 8

  • IDM 5.x and 6.x
  • AM 5.x and 6.x

Java 7

  • IDM 5
  • AM 5 and 5.1.x

Software and Hardware requirements

IDM

AM

See Also

FAQ: Upgrading IDM

FAQ: Installing and configuring IDM

FAQ: Upgrading AM

FAQ: Installing AM

Administering and configuring IDM

Installing and configuring AM

What operating systems are ForgeRock products supported on?

What Java versions are ForgeRock products supported on?

Checking your product versions are supported

Security Guide › Authentication and Session Modules

Platform Setup Guide

Related Training

N/A

Related Issue Tracker IDs

N/A


What operating systems are ForgeRock products supported on?

The purpose of this article is to provide a summary of the currently supported operating systems for the latest ForgeRock products: AM 7.1, DS 7.1, IDM 7.1 and IG 7.1.

AM

Operating System Version
Red Hat® Enterprise Linux®, CentOS™ 7, 8
Amazon Linux Amazon Linux 2018.03
SuSE Linux 12, 15
Ubuntu® Linux 18.04 LTS, 20.04 LTS
Microsoft® Windows® Server 2016, 2019

Information derived from: Release Notes › Operating System Requirements

Web application containers

ForgeRock supports customers using AM server software in the following web application container versions:

Web Container Version
Apache Tomcat™ 8.5, 9
IBM® WebSphere Liberty 20.0.0.1
JBoss Enterprise Application Platform 7.3
WildFly® AS 15, 19

The web application container must be able to write to its own home directory, where AM stores configuration files. 

Information derived from: Release Notes › Web Application Container Requirements

DS

Operating System Version
Red Hat Enterprise Linux, Centos 7, 8
Amazon Linux Amazon Linux 2018.03
SuSE Linux 12, 15
Ubuntu Linux 18.04 LTS, 20.04 LTS
Microsoft Windows Server 2016, 2019

Information derived from: Release Notes › Operating Systems

IDM

Operating System Version
Red Hat Enterprise Linux (and CentOS Linux) 7.0, 8.0
Ubuntu Linux 16.04 LTS, 18.04 LTS, 20.04 LTS
Microsoft Windows Server 2012 R2, 2016, 2019

Information derived from: Release Notes › Before You Install

IG

IG is tested on Windows and Linux operating systems.

Information derived from Release Notes › Operating Systems 

Web application containers

IG runs in standalone mode or in web container mode in the following containers:

Web Container Version
Apache Tomcat 9
Jetty 9
JBoss EAP 7.3

Deploy IG to the root context of a container. Deployment in other contexts causes unexpected results and is not supported.

Information derived from Release Notes › Web Application Containers

See Also

What Java versions are ForgeRock products supported on?

FAQ: AM compatibility with third-party products

FAQ: DS compatibility with third-party products

FAQ: IDM compatibility with third-party products

What versions of DS are compatible with AM?

What versions of Agents are compatible with AM?

What versions of IG are compatible with AM?

What versions of AM are compatible with IDM?

What versions of DS are compatible with IDM?


What Java versions are ForgeRock products supported on?

The purpose of this article is to provide information on the supported Java® versions across the ForgeRock platform (AM, DS, IDM and IG).

Java 11 Known Issues

You should ensure you always use a supported Java version as summarized below and as detailed in all release notes.

Additionally, there are some known issues with certain Java 11 versions and ForgeRock products. The main ones to be aware of when upgrading are:

Product Details
All There are known issues when using ForgeRock products and an HSM with Java 11. If you want to use ForgeRock products with an HSM, you should ensure you upgrade to Java 11.0.6 or later. See SSLHandshakeException or ClassCastException when using an HSM and Java 11 with ForgeRock products for further information.
Platform 6.5.x There are known issues with using Groovy 2.x with Java 11. See An illegal reflective access operation has occurred when using Java 11 with ForgeRock products for further information.
AM 6.5.x Federation-related pages do not display when using Java 11. See Federation related pages do not display in the console with a java.lang.NoClassDefFoundError: sun/misc/CharacterEncoder error in AM 6.5.x for further information.
DS 6.5, 6.5.1 and 6.5.2 There are known issues when using TLS 1.3 with Java 11. Unless you are using at least DS 6.5.3  and Java 11.0.6, you should disable TLS 1.3 as described in How do I disable TLS 1.3 when running DS 6.5, 6.5.1 or 6.5.2 with Java 11.0.5 and earlier, or Java 1.8.0_272 and later?

OpenJDK

Platform

  Platform 7 Platform 6.5 Platform 6 Platform 5.5 Platform 5
Access Management   11 8, 11 8 8 8
Directory Services  11 8, 11 8, 9 8 7, 8
Identity Management  11 8, 11 8 8 7, 8
Identity Gateway  11 8, 11 8 8 8

Agents

  OpenJDK 11 OpenJDK 8
Java Agent 5.8 Yes Yes
Java Agent 5.7 Yes Yes
Java Agent 5.6  Yes Yes
Java Agent 5.5  -- Yes
Java Agent 5  -- Yes

Web Agents do not have any Java dependencies.

Oracle® JDK

Platform

  Platform 7 Platform 6.5 Platform 6 Platform 5.5 Platform 5
Access Management  11 8, 11 8 8 7, 8
Directory Services  11 8, 11 8, 9 8 7, 8
Identity Management  11 8, 11 8 8 7, 8
Identity Gateway  11 8 8 8 7, 8

Agents

  Oracle JDK 11 Oracle JDK 8
Java Agent 5.8 Yes Yes
Java Agent 5.7 Yes Yes
Java Agent 5.6  Yes Yes
Java Agent 5.5  -- Yes
Java Agent 5  -- Yes

Web Agents do not have any Java dependencies.

IBM® Java (Websphere® only)

Note

Only AM and Java Agents have been validated with the IBM Java.

AM

  IBM Java 8 IBM Java 7
AM 7.x -- --
AM 6.x  Yes --
AM 5.5  Yes --
AM 5  -- Yes

Java Agents

  IBM Java 8
Java Agent 5.x Yes

See Also

What operating systems are ForgeRock products supported on?

Platform compatibility

AM Release Notes › Java Requirements

DS Release Notes › Java

IDM Release Notes › Before You Install

IG Release Notes › Java


Copyright and Trademarks Copyright © 2021 ForgeRock, all rights reserved.

This content has been optimized for printing.

Loading...