Page Operations
Browse SpaceIndex
Introduction
This guide will walk you through the steps to get a JOSSO 1.8.4 Gateway (IdP) build up and running in Tomcat 7.0.x.
Prerequisites
To make a quick JOSSO setup we will need:
- JDK 1.6
- Tomcat 7.0.x
- JOSSO 1.8.4
For the purposes of this guide, we will assume the following facts:
- JDK 1.6.0 is located at /opt/jdk1.6.0
- Tomcat 7.0.8 is located at /opt/apache-tomcat-7.0.8
- JOSSO 1.8.4 is located at /opt/josso-1.8.4
Install
First we will start JOSSO Deployment Console.
$ cd /opt/josso-1.8.4/bin
$ ./josso-gsh
__ _____ _____ _____ _____
__| | | __| __| |
| | | | |__ |__ | | |
|_____|_____|_____|_____|_____|
JOSSO (1.8.4)
Type 'help' for more information.
--------------------------------------
josso>
Now we have to execute the gateway install command as shown below:
josso> gateway install --target /opt/apache-tomcat-7.0.8 --platform tc70
You should see something like this :
josso> gateway install --target /opt/apache-tomcat-7.0.8 --platform tc70 Deploying Apache Tomcat 7.0.x JOSSO Gateway v.1.8.4 Verify Target Apache Tomcat 7.0.x Apache Tomcat 7.0.x [OK ] Directory Layout CatalinaHome [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/apache-tomcat-7.0.8/lib/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/apache-tomcat-7.0.8/lib/josso-gateway-stores.xml Installing [josso-gateway-memory-stores.xml] [OK ] Created file:///opt/apache-tomcat-7.0.8/lib/josso-gateway-memory-stores.xml Installing [josso-gateway-ldap-stores.xml] [OK ] Created file:///opt/apache-tomcat-7.0.8/lib/josso-gateway-ldap-stores.xml Installing [josso-gateway-web.xml] [OK ] Created file:///opt/apache-tomcat-7.0.8/lib/josso-gateway-web.xml Installing [josso-gateway-selfservices.xml] [OK ] Created file:///opt/apache-tomcat-7.0.8/lib/josso-gateway-selfservices.xml Installing [josso-gateway-jmx.xml] [OK ] Created file:///opt/apache-tomcat-7.0.8/lib/josso-gateway-jmx.xml Installing [josso-gateway-auth.xml] [OK ] Created file:///opt/apache-tomcat-7.0.8/lib/josso-gateway-auth.xml Installing [josso-users.xml] [OK ] Created file:///opt/apache-tomcat-7.0.8/lib/josso-users.xml Installing [josso-credentials.xml] [OK ] Created file:///opt/apache-tomcat-7.0.8/lib/josso-credentials.xml Installing [josso-gateway-db-stores.xml] [OK ] Created file:///opt/apache-tomcat-7.0.8/lib/josso-gateway-db-stores.xml Installing [josso-gateway-config.xml] [OK ] Created file:///opt/apache-tomcat-7.0.8/lib/josso-gateway-config.xml Deploy JOSSO Gateway Application Installing [] [OK ] Created file:///opt/apache-tomcat-7.0.8/webapps/josso Unjar [josso-gateway-web-1.8.4.war] [OK ] file:///opt/apache-tomcat-7.0.8/webapps Apache Tomcat 7.0.x JOSSO Gateway v.1.8.4 Overall Installation [OK ] Successfull! 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.4/log/.