Examples: Deploying OpenSSO Enterprise on JBoss Application Server

This section describes two additional methods to deploy OpenSSO Enterprise. Each method uses JBoss Application Server as the web container, but you can also use these methods on other web containers, if the container support the method.

• Method 1: Deploying OpenSSO Enterprise Server on JBoss Application Server Using the Exploded Archive Method

• Method 2: Deploing OpenSSO Enterprise Server on JBoss Application Server Using the Traditional Single Archive Method

Method 1: Deploying OpenSSO Enterprise Server on JBoss Application Server Using the Exploded Archive Method

To Deploy OpenSSO Enterprise Server on JBoss Application Server Using the Exploded Archive Method

1. Create a subdirectory under JBOSS_HOME/server/instance/deploy/name_of_war_file. For example:

   # mkdir /opt/jboss-4.2.2.GA/server/opensso/deploy/opensso.war

2. Explode the opensso.war file in this new directory. For example:

   # cd /opt/jboss-4.2.2.GA/server/opensso/deploy/opensso.war
   # jar xvf /tmp/opensso.war

   Your don't need to restart the container, because JBoss Application Server will automatically hot-deploy it.

3. Point your browser to http://host.domain:port/opensso or http://host:port/openssoand start configuring OpenSSO Enterpriseserver.

4. The OpenSSO Enterprise Configurator will write a bootstrap file in your home directory. For example:

   /.openssocfg/AMConfig_opt_jboss-4.2.2.GA_server_opensso_._deploy_opensso.war_

Method 2: Deploing OpenSSO Enterprise Server on JBoss Application Server Using the Traditional Single Archive Method

To Deploy OpenSSO Enterprise Server on JBoss Application Server Using the Traditional Single Archive Method

1. Explode the opensso.war file in a temporary directory. For example:

   # cd /tmp/sun
   # jar xvf zip-root/opensso/deployable-war/opensso.war

   where zip-root is where you unzipped the opensso_enterprise_80.zip file.

2. In the WEB-INF/classes/bootstrap.properties file, uncomment the configuration.dir property and set the property to the configuration directory that you plan to use for the OpenSSO Enterprise installation. For example:

   configuration.dir=/opt/opensso-server1

3. Create a new opensso.war with the extracted contents. For example:

   # cd /tmp/sun
   # jar cvf /tmp/opensso.war *

4. Hot-deploy this new WAR file on the JBoss Application Server container instance by copying the opensso.war from Step 3 to the JBoss deploy directory. For example:

   # cp /tmp/opensso.war /opt/jboss-4.2.2.GA/server/opensso/deploy

5. Start configuring OpenSSO Enterprise by pointing your browser to http://host.domain:port/opensso or http://host:port/opensso.

   Note: Because you pre-configured the OpenSSO Enterprise configuration directory in the opensso.war file in Step 4, you won't be able to change it during the configuration process.