Page Operations
Browse SpaceLabels:
Index
Introduction
This guide will walk you through the steps to get a JOSSO 1.8 Gateway (IdP) build up and running in a JEE Application Server.
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
- JEE Application Server
- JOSSO 1.8
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
- JOSSO 1.8.0 is located at /opt/josso-1.8.0
Install
First we will start JOSSO Deployment Console.
$ cd /opt/josso-1.8.0/bin
$ ./josso-gsh
__ _____ _____ _____ _____
__| | | __| __| |
| | | | |__ |__ | | |
|_____|_____|_____|_____|_____|
JOSSO (1.8.0)
Type 'help' for more information.
--------------------------------------
josso>
Now we have to execute the gateway install command as shown below:
josso> gateway install --target /opt/j2ee-container/deploy --platform jee
You should see something like this :
josso> gateway install --target /opt/j2ee-container/deploy --platform jee Deploying JEE Generic Application Server any JOSSO Gateway v.1.8.0 Verify Target JEE Generic Application Server any JEE Generic Application Server any [OK ] Directory Layout Install JOSSO Gateway Configuration Generating ['Remember Me' AES key] [OK ] Created file:///tmp/josso-auth.properties Installing [josso-auth.properties] [WARN ] Configuration must be manually installed for this platform Using ['memory' default configuration] [OK ] Installing josso-gateway-memory-stores.xml as josso-gateway-stores.xml Installing [josso-gateway-memory-stores.xml] [WARN ] Configuration must be manually installed for this platform Installing [josso-gateway-memory-stores.xml] [WARN ] Configuration must be manually installed for this platform Installing [josso-gateway-ldap-stores.xml] [WARN ] Configuration must be manually installed for this platform Installing [josso-gateway-web.xml] [WARN ] Configuration must be manually installed for this platform Installing [josso-gateway-selfservices.xml] [WARN ] Configuration must be manually installed for this platform Installing [josso-gateway-jmx.xml] [WARN ] Configuration must be manually installed for this platform Installing [josso-gateway-auth.xml] [WARN ] Configuration must be manually installed for this platform Installing [josso-users.xml] [WARN ] Configuration must be manually installed for this platform Installing [josso-credentials.xml] [WARN ] Configuration must be manually installed for this platform Installing [josso-gateway-db-stores.xml] [WARN ] Configuration must be manually installed for this platform Installing [josso-gateway-config.xml] [WARN ] Configuration must be manually installed for this platform Deploy JOSSO Gateway Application Installing [josso-gateway-web-1.8.0.war] [OK ] Created file:///opt/j2ee-container/deploy/josso-gateway-web-1.8.0.war JEE Generic Application Server any JOSSO Gateway v.1.8.0 Overall Installation [OK ] Successfull! Congratulations! You successfully installed the gateway. Now Follow the JOSSO Gateway Configuration guide and setup JOSSO for your needs! josso>
This will copy josso.war into the target directory. No configuration will be installed, you have to make sure that you copy configuration resources including the generated josso-auth.properties file in your container so that the gateway application can access them. In JBoss you can use the $JBOSS_HOME/server/<instance>/conf folder
You can see all the console activity, this information will also be recorded in a log file created in josso-1.8.0/log/.