Page Operations
Browse SpaceIntroduction
This guide will walk you through the steps to get JOSSO 1.8 up and running. Keep in mind that SSO deployments can be complex and require planning. This document is intended for test driving JOSSO within a simple single sign-on setting using Tomcat as the target platform.
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
- Tomcat 6.0 : Download Tomcat at http://tomcat.apache.org/download-60.cgi
- JOSSO 1.8 Binaries : Download
We will install and run tomcat in our Desktop computer to simplify configuration steps.
Starting JOSSO Deployment Console
First, we will create a folder to unpack Tomcat and JOSSO distributions using the appropriate archive expander. Once all archives are unpacked, we have to start JOSSO's Deployment Console. Before running the console, make sure that the JAVA_HOME environment variable is pointing to the JDK installation folder.
In Windows Systems
c:\> set JAVA_HOME=c:\jdk1.5.0_16 c:\> cd josso-1.8.0\bin c:\> josso-gsh
You should see something like this
In Unix Systems
$ export JAVA_HOME=/opt/jdk1.5.0_16 $ cd josso-1.8.0/bin $ ./josso-gsh.sh
You should see something like this
Installing JOSSO
The deployment console will do all the hard work for you. It will deploy and perform a basic configuration of the target platform and SSO Components. You will be able to see installation progress as the installer works.
Also a log file recording console activity will be created at josso-1.8.0/logs/
 | Target The target parameter specifies where JOSSO will be deployed, normally the target platform install folder. |
 | File Separator Because this console is platform idependent, make sure you always use a '/' slash as file separator, even in Windows environments. |
Installing the Gateway (IdP)
Run the gateway install command. For details on this command refer to JOSSO Deployment Console.
josso> gateway install --target c:/apache-tomcat-6.0.18 --platform tc60
You should see something like :
josso> gateway install --target c:/apache-tomcat-6.0.18 --platform tc60 Deploying Apache Tomcat 6.0.x JOSSO Gateway v.1.8.0 Verify Target Apache Tomcat 6.0.x Apache Tomcat 6.0.x [OK ] Directory Layout CatalinaHome [OK ] Install JOSSO Gateway Configuration Generating ['Remember Me' AES key] [OK ] Created file:///C:/DOCUME~1/atricore/CONFIG~1/Temp/josso-auth.properties Using ['memory' default configuration] [OK ] Installing josso-gateway-memory-stores.xml as josso-gateway-stores.xml Installing [josso-auth.properties] [OK ] Created file:///c:/apache-tomcat-6.0.18/lib/josso-auth.properties Installing [josso-credentials.xml] [OK ] Created file:///c:/apache-tomcat-6.0.18/lib/josso-credentials.xml Installing [josso-gateway-auth.xml] [OK ] Created file:///c:/apache-tomcat-6.0.18/lib/josso-gateway-auth.xml Installing [josso-gateway-config.xml] [OK ] Created file:///c:/apache-tomcat-6.0.18/lib/josso-gateway-config.xml Installing [josso-gateway-db-stores.xml] [OK ] Created file:///c:/apache-tomcat-6.0.18/lib/josso-gateway-db-stores.xml Installing [josso-gateway-jmx.xml] [OK ] Created file:///c:/apache-tomcat-6.0.18/lib/josso-gateway-jmx.xml Installing [josso-gateway-ldap-stores.xml] [OK ] Created file:///c:/apache-tomcat-6.0.18/lib/josso-gateway-ldap-stores.xml Installing [josso-gateway-memory-stores.xml] [OK ] Created file:///c:/apache-tomcat-6.0.18/lib/josso-gateway-stores.xml Installing [josso-gateway-memory-stores.xml] [OK ] Created file:///c:/apache-tomcat-6.0.18/lib/josso-gateway-memory-stores.xml Installing [josso-gateway-selfservices.xml] [OK ] Created file:///c:/apache-tomcat-6.0.18/lib/josso-gateway-selfservices.xml Installing [josso-gateway-web.xml] [OK ] Created file:///c:/apache-tomcat-6.0.18/lib/josso-gateway-web.xml Installing [josso-users.xml] [OK ] Created file:///c:/apache-tomcat-6.0.18/lib/josso-users.xml Deploy JOSSO Gateway Application Installing [] [OK ] Created file:///c:/apache-tomcat-6.0.18/webapps/josso Unjar [josso-gateway-web-1.8.0.war] [OK ] file:///c:/apache-tomcat-6.0.18/webapps Apache Tomcat 6.0.x 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>
Installing the Agent (SP)
Run the agent install command. For details on this command refer to JOSSO Deployment Console.
josso> agent install --target c:/apache-tomcat-6.0.18 --platform tc60
You should see something like :
josso> agent install --target c:/apache-tomcat-6.0.18 --platform tc60 Installing Apache Tomcat 6.0.x JOSSO Agent v.1.8.0 Verify Target Apache Tomcat 6.0.x Apache Tomcat 6.0.x [OK ] Directory Layout CatalinaHome [OK ] Installing JOSSO 3rd party JARs Installing [aopalliance-1.0.jar] [OK ] Created file:///c:/apache-tomcat-6.0.18/lib/aopalliance-1.0.jar Installing [axis-1.4.jar] [OK ] Created file:///c:/apache-tomcat-6.0.18/lib/axis-1.4.jar Installing [axis-ant-1.4.jar] [OK ] Created file:///c:/apache-tomcat-6.0.18/lib/axis-ant-1.4.jar Installing [axis-jaxrpc-1.4.jar] [OK ] Created file:///c:/apache-tomcat-6.0.18/lib/axis-jaxrpc-1.4.jar Installing [axis-saaj-1.4.jar] [OK ] Created file:///c:/apache-tomcat-6.0.18/lib/axis-saaj-1.4.jar Installing [axis-wsdl4j-1.5.1.jar] [OK ] Created file:///c:/apache-tomcat-6.0.18/lib/axis-wsdl4j-1.5.1.jar Installing [commons-beanutils-1.6.1.jar] [OK ] Created file:///c:/apache-tomcat-6.0.18/lib/commons-beanutils-1.6.1.jar Installing [commons-codec-1.3.jar] [OK ] Created file:///c:/apache-tomcat-6.0.18/lib/commons-codec-1.3.jar Installing [commons-collections-3.0.jar] [OK ] Created file:///c:/apache-tomcat-6.0.18/lib/commons-collections-3.0.jar Installing [commons-digester-1.5.jar] [OK ] Created file:///c:/apache-tomcat-6.0.18/lib/commons-digester-1.5.jar Installing [commons-discovery-0.2.jar] [OK ] Created file:///c:/apache-tomcat-6.0.18/lib/commons-discovery-0.2.jar Installing [commons-lang-2.0.jar] [OK ] Created file:///c:/apache-tomcat-6.0.18/lib/commons-lang-2.0.jar Installing [commons-logging-1.0.4.jar] [OK ] Created file:///c:/apache-tomcat-6.0.18/lib/commons-logging-1.0.4.jar Installing [commons-logging-api-1.0.4.jar] [OK ] Created file:///c:/apache-tomcat-6.0.18/lib/commons-logging-api-1.0.4.jar Installing [commons-modeler-1.1.jar] [OK ] Created file:///c:/apache-tomcat-6.0.18/lib/commons-modeler-1.1.jar Installing [spring-aop-2.5.5.jar] [OK ] Created file:///c:/apache-tomcat-6.0.18/lib/spring-aop-2.5.5.jar Installing [spring-beans-2.5.5.jar] [OK ] Created file:///c:/apache-tomcat-6.0.18/lib/spring-beans-2.5.5.jar Installing [spring-context-2.5.5.jar] [OK ] Created file:///c:/apache-tomcat-6.0.18/lib/spring-context-2.5.5.jar Installing [spring-core-2.5.5.jar] [OK ] Created file:///c:/apache-tomcat-6.0.18/lib/spring-core-2.5.5.jar Installing [xbean-spring-3.4.3.jar] [OK ] Created file:///c:/apache-tomcat-6.0.18/lib/xbean-spring-3.4.3.jar Installing JOSSO Agent JARs Installing [josso-agent-shared-1.8.0.jar] [OK ] Created file:///c:/apache-tomcat-6.0.18/lib/josso-agent-shared-1.8.0.jar Installing [josso-agents-bin-1.8.0.jar] [OK ] Created file:///c:/apache-tomcat-6.0.18/lib/josso-agents-bin-1.8.0.jar Installing [josso-tomcat60-agent-1.8.0.jar] [OK ] Created file:///c:/apache-tomcat-6.0.18/lib/josso-tomcat60-agent-1.8.0.jar Installing JOSSO Agent JARs from Source Configuring Container Removed [Tomcat default Realm ] [OK ] org.apache.catalina.realm.UserDatabaseRealm Configured [JOSSO JAAS Realm ] [OK ] org.josso.tc60.agent.jaas.CatalinaJAASRealm Configured [JOSSO Agent Valve ] [OK ] org.josso.tc60.agent.SSOAgentValve Backup [server.xml] [OK ] file:///c:/apache-tomcat-6.0.18/conf/server.xml.bkp.1 Save [server.xml] [OK ] file:///c:/apache-tomcat-6.0.18/conf/server.xml Installing JOSSO Agent Configuration files Installing [jaas.conf] [OK ] Created file:///c:/apache-tomcat-6.0.18/conf/jaas.conf Installing [josso-agent-config.xml] [OK ] Created file:///c:/apache-tomcat-6.0.18/lib/josso-agent-config.xml Installing [setenv.bat] [OK ] Created file:///c:/apache-tomcat-6.0.18/bin/setenv.bat Installing [setenv.sh] [OK ] Created file:///c:/apache-tomcat-6.0.18/bin/setenv.sh Apache Tomcat 6.0.x JOSSO Agent v.1.8.0 Overall Installation [OK ] Successfull! Congratulations! You successfully installed the agent. Now Follow the JOSSO Agent Configuration guide and setup your SSO Partner applications ! josso>
Installing the Samples
Run the samples install command. For details on this command refer to JOSSO Deployment Console.
josso> samples install --target c:/apache-tomcat-6.0.18 --platform tc60
You should see something like :
josso> samples install --target c:/apache-tomcat-6.0.18 --platform tc60 Deploying Apache Tomcat 6.0.x JOSSO Gateway v.1.8.0 Verify Target Apache Tomcat 6.0.x Apache Tomcat 6.0.x [OK ] Directory Layout CatalinaHome [OK ] Install JOSSO Samples Configuration Deploy JOSSO Samples Applications Installing [] [OK ] Created file:///c:/apache-tomcat-6.0.18/webapps/partnerapp Unjar [josso-partner-tomcat-web-1.8.0.war] [OK ] file:///c:/apache-tomcat-6.0.18/webapps Apache Tomcat 6.0.x JOSSO Samples v.1.8.0 Overall Installation [OK ] Successfull! Congratulations! You successfully installed the samples. josso>
Running and Testing
Now exit the deployment console and start Tomcat. You have to go to Tomcat's bin folder and run catalina script.
In Windows Systems
c:\> cd apache-tomcat-6.0.18\bin c:\> catalina run Using CATALINA_BASE: C:\apache-tomcat-6.0.18 Using CATALINA_HOME: C:\apache-tomcat-6.0.18 Using CATALINA_TMPDIR: C:\apache-tomcat-6.0.18\temp Using JRE_HOME: c:\jdk1.5.0_13 02/01/2009 15:06:32 org.apache.tomcat.util.digester.SetPropertiesRule begin ... 02/01/2009 15:06:37 org.apache.catalina.startup.Catalina start INFO: Server startup in 4974 ms
In Unix Systems
$ cd apache-tomcat-6.0.18/bin $ ./catalina.sh run Using CATALINA_BASE: /opt/apache-tomcat-6.0.18 Using CATALINA_HOME: /opt/apache-tomcat-6.0.18 Using CATALINA_TMPDIR: /opt/apache-tomcat-6.0.18/temp Using JRE_HOME: /opt/jdk1.5.0_13 Jan 2, 2009 3:09:18 PM org.apache.catalina.core.AprLifecycleListener init ... Jan 2, 2009 3:09:26 PM org.apache.catalina.startup.Catalina start INFO: Server startup in 7916 ms
That's all! Now access the sample partner application at http://localhost:8080/partnerapp/ and follow instructions. You should reach the login page:
Next Steps
The next thing to do would be to configure the JOSSO Gateway (IdP) and Agent (SP) to meat your needs. Take a look at the Setup JOSSO Gateway (IdP) and Setup JOSSO Agent (SP) guides.