DocTeger

OpenSSO Technical Information

And a Spoonful of Music

To Make the Medicine Go Down

Generating Specialized WARs with Generation X

Here are the instructions in the README found in the /deployable-war directory of the extracted opensso.zip. It describes how to generate a specialized WAR for deployment. I've added some explanations to the procedure.

1. Create a new directory as the staging area for the WAR you want to generate. For example:

   % mkdir /noconsolewar

2. Extract the contents of opensso.war into it.

   % cd /noconsolewar
   % jar xvf /opensso/deployable-war/opensso.war

3. Create the WAR using the appropriate .list file. For example:

   % cd /noconsolewar
   % jar cvf /opensso/deployable-war/fam-nocon.war @/opensso/deployable-war/fam-noconsole.list

   .list files included are:
   • fam-idpdiscovery.list lists the files needed to generate a WAR to deploy the Identity Provider Discovery Service.
   • fam-distauth.list lists the files needed to generate a WAR to deploy the Distributed Authentication User Interface.
   • fam-console.list lists the files needed to generate a WAR to deploy a Federated Access Manager console only.
   • fam-noconsole.list lists the files needed to generate a WAR to deploy a Federated Access Manager server without the console.
4. Update the generated WAR with the additional files found in the appropriate directory. For example:

   % cd /opensso/deployable-war/noconsole
   % jar uvf /opensso/deployable-war/fam-nocon.war *

   Directories included are:
   • idpdiscovery contains additional files for the Identity Provider Discovery Service WAR.
   • distauth contains additional files for the Distributed Authentication User Interface WAR.
   • console contains additional files for the console only WAR.
   • noconsole contains additional files for the Federated Access Manager server without a console WAR.
5. Deploy your specialized WAR.
6. Access the WAR deployment URL from your browser to configure. For example:

   http://machine-name:port/URI

And now that we are done generatin' WARs, how about Generation X - with a very young and brunette Billy Idol singing New Order at the Marquee Club.

Posted at 12:00AM Jun 16, 2008 by Michael Teger in Sun  |  Comments[0]