breaking into the unknown…

Installing openam on ubuntu

1 Comment

OpenAM provides open source Authentication, Authorization, Entitlement and Federation software. You can setup it to provide single sign on ( SSO ) for your different website. For example, say you are a banking organization having different sites for catering different vertical of your business (insurance, loans, deposits etc). Now, your user is same for all these sites, so no need to maintain separate user database for them. It can be manage by openam. You can create, update, delete and validate users of all your site with openam.

With, the short introduction of openam above, we will now proceed to install it on our ubuntu system. Detail installation instruction is available here.

STEP 1: Prerequisite

-> create fqdn for your system

fqdn is fully qualified domain name. You can read more on fqdn here on wiki. In simple word I can say that, You system should be accessible from browser. For your local system localhost(127.0.01) is fqdn. when you do localhost in browser it load a page with message “Its working”. Since, we are experimenting with openam in local, If localhost in your browser give “Its working” message, you are ready to proceed to next step

-> Install java # I will write a blog on this soon. For , now manage it yourself  🙂

-> Installing Application Server

A no of application server is available which work with openam. We will go with tomcat.  You can find detail instruction on tomcat installation in this post.

STEP 2: Downloading openam

You can download latest stable version from here.  extract the downloaded folder. The extracted folder have name like openam_10.1.3, where 10.1.3 is the version number. remove the version number i,e rename to just call it openam. If you do not, in url you have to type openam_10.1.3  instead of openam.

STEP  3: Put openam in tomcat container.

Copy the openam folder of step 2 into /var/lib/tomcat7/webapps/

STEP 4: configuration change

openam will try to use usr/share/tomcat folder, So we must grant all access to this folder. So, run below command on the terminal

$ chmod 777 -R /usr/share/tomcat7 # this will give all permission to this directory

STEP 5: Running openam in browser

Assuming, you have installed tomcat as described here, and is running at port 8080. go to the browser and type below url.

http://localhost:8080/openam . It will take you to the basic configuration page http://localhost:8080/openam/config/options.htm , as you have yet not set username and password. It will give you two options : basic configuration and custom configuration . We will go with basic configuration to create a password and will do advance custom configuration from openam UI itself later on when needed. So , click on Default Configuration. Fill in your password and submit on successful password creation, you will be taken to the login page. Note that, you have only set password no username. It’s O.K as for default configuration the username is always amadmin. You can Login with below credential

username : amadmin

password: your_password.

Great…..You are loged in to openam, up and running.  Make configuration and other settings as per your need.


Author: arunyadav4u

over 7 years experience in web development with Ruby on Rails.Involved in all stage of development lifecycle : requirement gathering, planing, coding, deployment & Knowledge transfer. I can adept to any situation, mixup very easily with people & can be a great friend.

One thought on “Installing openam on ubuntu

  1. Thanks for helping me out with Openam installation.

    I have a very small Query

    I need little assistance about Open DJ. I believe I am having a small issue here.

    a- I have installed open AM 11.0 with Embedded open DJ.

    b- The Installation was fine.

    c- I then started directory service and also OpenAM.It all came up fine.

    d- The ports are as follows listener: 50389, admin:5444, baseDn: dc=openam,dc=forgerock,dc=org

    e- This base DN is set in the Setting of Open AM when I go under access control tab. I am also able to Setup users in OpenAM with these setting under Subject tab. I have created a user called “test”.

    f- When I go to Open DJ and try to do an ldap search I get no results while I expect to get some results. This is my command

    ./ldapsearch –port 50389 –baseDN dc=openam,dc=forgerock,dc=org “(uid=test)” uid

    Can someone assist with what Can be the possible issue? I shall be extremely thankful for the help?

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s