Page Operations
Browse SpaceIndex
Introduction
This guide will walk you through the steps to get a JOSSO 1.8.2 Gateway (IdP) build up and running in JBoss 6.
Prerequisites
To make a quick JOSSO setup we will need:
- JDK 1.5 : For optimal results, confirm that your JDK version matches a JDK listed at http://java.sun.com/javase/downloads/index_jdk5.jsp
- JBoss 6.x
- JOSSO 1.8.2
For the purposes of this guide, we will assume the following facts:
- JDK 1.5.0 16 is located at /opt/jdk1.5.0_16
- JBoss 6.0.0.GA is located at /opt/jboss-6.0.0.Final
- JOSSO 1.8.2 is located at /opt/josso-1.8.2
Install
First we will start JOSSO Deployment Console.
$ cd /opt/josso-1.8.2/bin
$ ./josso-gsh
__ _____ _____ _____ _____
__| | | __| __| |
| | | | |__ |__ | | |
|_____|_____|_____|_____|_____|
JOSSO (1.8.2)
Type 'help' for more information.
--------------------------------------
josso>
Now we have to execute the gateway install command as shown below:
josso> gateway install --target /opt/jboss-6.0.0.Final --jboss-instance default --platform jb5
You should see something like this :
josso> gateway install --target /opt/jboss-6.0.0.Final --jboss-instance default --platform jb5 Deploying JBoss AS 5.x JOSSO Gateway v.1.8.2 Verify Target JBoss AS 5.x JBoss AS 5.x [OK ] Directory Layout JBossHome [OK ] Install JOSSO Gateway Configuration Generating ['Remember Me' AES key] [OK ] Created file:///tmp/josso-auth.properties Installing [josso-auth.properties] [OK ] Created file:///opt/jboss-6.0.0.Final/server/default/conf/josso-auth.properties Using ['memory' default configuration] [OK ] Installing josso-gateway-memory-stores.xml as josso-gateway-stores.xml Installing [josso-gateway-memory-stores.xml] [OK ] Created file:///opt/jboss-6.0.0.Final/server/default/conf/josso-gateway-stores.xml Installing [josso-gateway-memory-stores.xml] [OK ] Created file:///opt/jboss-6.0.0.Final/server/default/conf/josso-gateway-memory-stores.xml Installing [josso-gateway-ldap-stores.xml] [OK ] Created file:///opt/jboss-6.0.0.Final/server/default/conf/josso-gateway-ldap-stores.xml Installing [josso-gateway-web.xml] [OK ] Created file:///opt/jboss-6.0.0.Final/server/default/conf/josso-gateway-web.xml Installing [josso-gateway-selfservices.xml] [OK ] Created file:///opt/jboss-6.0.0.Final/server/default/conf/josso-gateway-selfservices.xml Installing [josso-gateway-jmx.xml] [OK ] Created file:///opt/jboss-6.0.0.Final/server/default/conf/josso-gateway-jmx.xml Installing [josso-gateway-auth.xml] [OK ] Created file:///opt/jboss-6.0.0.Final/server/default/conf/josso-gateway-auth.xml Installing [josso-users.xml] [OK ] Created file:///opt/jboss-6.0.0.Final/server/default/conf/josso-users.xml Installing [josso-credentials.xml] [OK ] Created file:///opt/jboss-6.0.0.Final/server/default/conf/josso-credentials.xml Installing [josso-gateway-db-stores.xml] [OK ] Created file:///opt/jboss-6.0.0.Final/server/default/conf/josso-gateway-db-stores.xml Installing [josso-gateway-config.xml] [OK ] Created file:///opt/jboss-6.0.0.Final/server/default/conf/josso-gateway-config.xml Deploy JOSSO Gateway Application Installing [] [OK ] Created file:///opt/jboss-6.0.0.Final/server/default/deploy/josso.war Unjar [josso-gateway-web-1.8.2.war] [OK ] file:///opt/jboss-6.0.0.Final/server/default/deploy JBoss AS 5.x JOSSO Gateway v.1.8.2 Overall Installation [OK ] Successful! Congratulations! You successfully installed the gateway. Now Follow the JOSSO Gateway Configuration guide and setup JOSSO for your needs! josso>
You can see all the console activity, this information will also be recorded in a log file created in josso-1.8.2/log/.
Remove conflicting artifacts
You need to manually remove $JBOSS_HOME/server/default/deploy/josso.war/WEB-INF/lib/commons-logging-1.0.3.jar and $JBOSS_HOME/server/default/deploy/josso.war/WEB-INF/lib/commons-logging-api-1.0.4.jar
In case of hosting the JOSSO Agent in addition to the JOSSO Gateway, manually remove $JBOSS_HOME/server/default/lib/commons-logging-api-1.0.4.jar and $JBOSS_HOME/server/default/lib/commons-logging-1.1.1.jar