------------------------------------------------------------------------------

README file for OpenSSO stand alone client sdk samples

------------------------------------------------------------------------------

DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.

Copyright (c) 2007 Sun Microsystems Inc. All Rights Reserved

The contents of this file are subject to the terms

of the Common Development and Distribution License

(the License). You may not use this file except in

compliance with the License.

You can obtain a copy of the License at

https://opensso.dev.java.net/public/CDDLv1.0.html or

See the License for the specific language governing

permission and limitations under the License.

When distributing Covered Code, include this CDDL

Header Notice in each file and include the License file

at opensso/legal/CDDLv1.0.txt.

If applicable, add the following below the CDDL Header,

with the fields enclosed by brackets [] replaced by

your own identifying information:

"Portions Copyrighted [year] [name of copyright owner]"

$Id: README,v 1.6 2008/10/30 19:12:18 bigfatrat Exp $

------------------------------------------------------------------------------

This README file provides brief instructions on running OpenSSO

client sdk samples that would run in a stand alone JVM, outside of any

container.

1. Unzip the opensso-client.zip. You would find a directory samples/sdk.

This directory has all that is required to try out OpenSSO

client sdk samples.

The directory is laid out as below:

+ sdk

|- source (contains source files that require compilation)

|- scripts (contains scripts to compile and run samples)

|- resources (contains resources required to run the samples)

|- lib (contains jar files required to use the OpenSSO clientsdk)

|- classes (contains the compiled classes from the source files)

2. To compile the samples:

-- Make scripts/compile-samples.sh executable using chmod command for

UNIX system.

-- Execute scripts/compile-samples.sh

3. To run the sample:

-- Make all sh scripts under "scripts" directory executable,

e.g. chmod 755 scripts/*.sh

-- Run scripts/setup.sh (or setup.bat)

This will setup AMConfig.properties to point to the OpenSSO server.

This only need to be run this once for the all client SDK samples.

-- Run individual client SDK samples by executing the shell or bat scripts

under "scripts" directory, e.g. scripts/run-xacml-client-sample.sh

Sample runtime may require additional property files to be correctly set

up under resoruces directory. This would be specifically mentioned in the

comments included in corresponding scripts.