ForgeRock OpenAM Custom Configuration Installation on Windows

In this article, I am going to sharing ForgeRock OpenAM Custom Configuration Installation on Windows. OpenAM installation on Windows and Linux is almost similar so mentioned required changes wherever required according OS dependency, But in this article OpenAM installation showing on Windows system. Here there are two ways of OpenAM installation they are

1. OpenAM Default Configuration

2. OpenAM Custom Configuration

 

OpenAM Default Configuration installation already explained in the other article. In this article, I am going to sharing OpenAM Custom Configuration installation on Windows

 

ForgeRock OpenAM Custom Configuration Installation on Windows

Before going to OpenAM installation we need to do setup prerequisites. Click here to see prerequisites instructions.

Prerequisites to be installed before going to install OpenAM Custom Configuration

  1. Java 1.8 to be installed
  2. Tomcat 8.0.36 to be installed
  3. OpenDJ 3.0 to be installed
  4. Host name to be configured (openam.example.com)

 

OpenAM 13.0.war Download

You can download OpenAM13.0.war file from official ForgeRock backstage site. For more details Click here.

suppose you have folder D:\forgerock\blog

Copy the downloaded war file into D:\forgerock\blog\openam13.0.war

And rename it to D:\forgerock\blog\openam.war

Tomcat webapps folder: D:\forgerock\blog\apache-tomcat-8.0.36-openam-rnd\webapps

Copy openam.war file into webapps

Tomcat folder structure as follows

 

tomcat-folder-structure

tomcat-folder-structure2

 

Before going to start Tomcat server, we have to start OpenDJ.

OpenDJ Installation Video

 

How to start OpenDJ

Microsoft Windows [Version 10.0.18363.418]
(c) 2019 Microsoft Corporation. All rights reserved.

C:\Users\swamy>d:

D:\>cd forgerock

D:\forgerock>cd blog

D:\forgerock\blog>cd opendj

D:\forgerock\blog\opendj>cd bat

D:\forgerock\blog\opendj\bat>start-ds.bat

The Directory Server has started successfully.

 

Now open windows command or Linux terminal and then go to Tomcat bin folder and execute

How To Start Tomcat Server

Microsoft Windows [Version 10.0.18363.418]
(c) 2019 Microsoft Corporation. All rights reserved.

C:\Users\swamy>d:

D:\>cd forgerock

D:\forgerock>cd blog

D:\forgerock\blog>cd apache-tomcat-8.0.36-openam-rnd

D:\forgerock\blog\apache-tomcat-8.0.36-openam-rnd>cd bin

D:\forgerock\blog\apache-tomcat-8.0.36-openam-rnd\bin>catalina.bat run

Tomcat server has started and openam.war application deployed successfully.

Now you can access the openam installation home page URL http://openam.example.com:8087/openam

 

OpenAM Installation Home

OpenAM-Installation-Home-1

OpenAM-Installation-Home-1

Click on Create Custom Configuration

 

License Agreement

OpenAM-Installation-Licence-2

OpenAM-Installation-Licence-2

 

Click on I accept the license agreement

 

Default User Password

OpenAM-Installaiton-Password-Setup-3

OpenAM-Installaiton-Password-Setup-3

Here Default Username : amAdmin

Enter Default User Password: Admin1234

Click on Next

 

Server Settings With Default Configuration Directory

OpenAM-Installaiton-Install-Directory-4

OpenAM-Installaiton-Install-Directory-4

Server URL: http://openam.example.com:8087

Cookie Domain : .example.com

Default Configuration Directory: C:/Users/swamy/openam

 

I am going changing the default configuration directory to C:/Users/swamy/openam-blog-rnd

 

Server Settings With Custom Configuration Directory

OpenAM-Installaiton-Install-Custom-Directory-5

OpenAM-Installaiton-Install-Custom-Directory-5

 

Click on Next

 

Configuration Data Store Details

OpenAM-Installaiton-Config-Store-6

OpenAM-Installaiton-Config-Store-6

 

Here we are going to using Configuration Store as OpenAM. It means that it’s embedded OpenDJ using as Configuration Store.

No need to change any details, you can leave it as it is default values. If you want change, you can change.

Click on Next

 

User Store Details With Default OpenDJ Details

OpenAM-Installaiton-UserData-Store-7

OpenAM-Installaiton-UserData-Store-7

 

Here I am going to using OpenDJ as User Store Details i.e. End User Details will be stored

So Enter the OpenDJ details here. Already we have installed OpenDJ.

So Default OpenDJ details needs to be updated to as follows.

 

User Store Details With External OpenDJ Details

OpenAM-Installaiton-Custom-Data-Store-OpenDJ-8

OpenAM-Installaiton-Custom-Data-Store-OpenDJ-8

 

Already Installed OpenDJ Details

Directory Name: opendj.example.com

Port: 389

Root Suffix: dc=example,dc=com

Login ID: cn=Directory Manager

Password: Admin1234

 

Site Configuration

OpenAM-Installaiton-Site-Configuration-LoadBalance-9

OpenAM-Installaiton-Site-Configuration-LoadBalance-9

 

Currently I am going to installing without load balance i.e. Single Instance, so we need to select No

 

Default Policy Agent User

OpenAM-Installaiton-Agen-Configuration-10

OpenAM-Installaiton-Agen-Configuration-10

 

Give password for default policy agent user, but the password should not be same as default user(amAdmin) password.

Here agent password given: Admin12345

 

Configuration Summary Details

OpenAM-Installaiton-Summary-11

OpenAM-Installaiton-Summary-11

 

You can validate configuration details, if you find any incorrect configuration or want to changes details you can click on Edit on respective configuration details.

Click on Create Configuration

 

Installation In-Progress

OpenAM-Installaiton-Status-12

OpenAM-Installaiton-Status-12

 

OpenAM-Installaiton-Status-12-1

OpenAM-Installaiton-Status-12-1

 

Installation Completed

OpenAM-Installaiton-Completed-13

OpenAM-Installaiton-Completed-13

 

OpenAM Login

Click on Proceed to Login in the above step

OpenAM-Installaiton-Login-14

OpenAM-Installaiton-Login-14

 

Enter OpenAM User Credential

Username: amadmin ( Username not case sensitive here)

Password: Admin1234

OpenAM-Installaiton-Login-14-1

OpenAM-Installaiton-Login-14-1

 

OpenAM Login Successful

OpenAM-Installaiton-Login-Successful-15

OpenAM-Installaiton-Login-Successful-15

 

 

 

Leave a Reply