Installing CASS

Getting CASS

Source/Binary Edition

The latest version of CASS is available from the CASS web page --> cass-0.1.0.tgz or cass-0.1.0.zip.

System Requirements

Cass has been used successfully on Linux, Windows 2000 and Windows XP. Although any platform with a Java 1.4 SDK should work, the shell scripts have only been written for Linux and Windows.

To build and use CASS, you must have the following installed:

Java SDK 1.4
Ant (version 1.5 or greater)
AspectWerkz 0.10 --> aspectwerkz-0.10.zip
Globus Toolkit 3.2.1 (available from the globus toolkit website) --> ogsa-3.2.1.tar.gz or ogsa-3.2.1.zip

Installing Dependent Packages

As listed above, CASS requires AspectWerkz 0.10 and Globus Toolkit 3.2.1. These steps are quickstart to their installation. For full details please refer to the documentation of those packages.

Ant

Before you can run ant there is some additional set up you will need to do:

Add the bin directory to your path.
Set the ANT_HOME environment variable to the directory where you installed Ant. On some operating systems the ant wrapper scripts can guess ANT_HOME (Unix dialects and Windows NT/2000) - but it is better to not rely on this behavior.

AspectWerkz

To install AspectWerkz, choose a directory and copy the distribution file there. This directory will be known as ASPECTWERKZ_HOME.

Setup

Before you can run AspectWerkz there is some additional set up you will need to do:

Add the bin directory to your path (only required if you plan to use AspectWerkz on its own).
Set the ASPECTWERKZ_HOME environment variable to the directory where you installed AspectWerkz.

Globus Toolkit

To install the Globus Toolkit, choose a directory and copy the distribution file there. This directory will be known as GLOBUS_LOCATION.

Setup

Before you can run the Globus Toolkit there is some additional set up you will need to do:

Set the GLOBUS_LOCATION environment variable to the directory where you installed the Globus Toolkit.
If you are running Java SDK 1.4.2_05, you will need to patch the JAXP that comes bundled. Java SDK 1.4.2_05 included an older version of xalan.jar, which throws an exception when some of the security code is executed. To fix this, you simply need to:
- Create an endorsed directory in JAVA_HOME/jre/lib
- Copy a stable version of xalan.jar into this directory

Installing CASS

The distribution of CASS consists of the following directory layout:

   cass
   |-- bin/  // shell scripts
   |-- build.xml // ant script to build and deploy cass
   |-- doc/  //documentation
   |-- etc/  //extra stuff
   |-- lib/  // the pre-compiled binaries
   +-- src/  // the cass source code

To install CASS, choose a directory and copy the distribution file there. This directory will be known as CASS_HOME.

Setup

Before you can run cass there is some additional set up you will need to do:

Add the bin directory to your path.
Set the CASS_HOME environment variable to the directory where you installed CASS.
Install AspectWerkz and the GlobusToolKit (described above).
Optionally, set the JAVA_HOME environment variable. This should be set to the directory where your JDK is installed.

Unix (bash)

Assume CASS is installed in /usr/local/cass. The following sets up the environment:

export CASS_HOME=/usr/local/cass
export PATH=${PATH}:${CASS_HOME}/bin

Unix (csh)

setenv CASS_HOME /usr/local/cass
set path=( $path $CASS_HOME/bin )

Windows

Assume CASS is installed in c:\cass\. The following sets up the environment:

set CASS_HOME=c:\cass
set PATH=%PATH%;%CASS_HOME%\bin

Deploying Cass

CASS runs within the Globus Toolkit. To deploy CASS to the Globus Toolkit, you must do the following:

Change to CASS_HOME directory.
Run ant config – This will deploy the CASS services and a sample service (the MathService) to the Globus Toolkit.

Testing Cass

To test cass, you must first start the server, then call the MathService. Perform the following:

Unix

1. From a command prompt (any directory)

cass 8080 9300 $CASS_HOME/etc/math.xml

You should see the following:

AspectWerkz - INFO - Pre-processor org.codehaus.aspectwerkz.transform.AspectWerkzPreProcessor loaded and initialized
[01/27/2005 21:26:27:159 ] org.globus.ogsa.server.ServiceContainer [run:582] INFO: Starting SOAP server at: http://127.0.0.1:8080/ogsa/services/ 
With the following services:
 
http://127.0.0.1:8080/ogsa/services/core/admin/AdminService
http://127.0.0.1:8080/ogsa/services/core/management/OgsiManagementService
http://127.0.0.1:8080/ogsa/services/core/registry/ContainerRegistryService
http://127.0.0.1:8080/ogsa/services/core/jmsadapter/JMSAdapterFactoryService
http://127.0.0.1:8080/ogsa/services/core/logging/OgsiLoggingManagementService
http://127.0.0.1:8080/ogsa/services/core/notification/httpg/NotificationSubscriptionFactoryService
http://127.0.0.1:8080/ogsa/services/core/ping/PingService
http://127.0.0.1:8080/ogsa/services/RemoteJoinPointService
http://127.0.0.1:8080/ogsa/services/ogsi/NotificationSubscriptionFactoryService
http://127.0.0.1:8080/ogsa/services/ogsi/HandleResolverService
http://127.0.0.1:8080/ogsa/services/MathService
http://127.0.0.1:8080/ogsa/services/gsi/AuthenticationService
http://127.0.0.1:8080/ogsa/services/gsi/SecureNotificationSubscriptionFactoryService
http://127.0.0.1:8080/ogsa/services/RemoteAdviceService

2. From another command prompt

cd $CASS_HOME/lib
. $GLOBUS_LOCATION/etc/globus-devel-env.sh
java MathClient 100 5

You should see the following:

Added 100 to 5, received 94 Multiplied 100 to 5, received 450

Windows

1. From a command prompt (any directory)

cass 8080 9300 %CASS_HOME%/etc/math.xml

Since the windows command prompt does not support background processes, you must open another window to complete the start-up. After step 2, you should see.

AspectWerkz - INFO - Pre-processor org.codehaus.aspectwerkz.transform.AspectWerkzPreProcessor loaded and initialized
[01/27/2005 21:26:27:159 ] org.globus.ogsa.server.ServiceContainer [run:582] INFO: Starting SOAP server at: http://127.0.0.1:8080/ogsa/services/ 
With the following services:
 
http://127.0.0.1:8080/ogsa/services/core/admin/AdminService
http://127.0.0.1:8080/ogsa/services/core/management/OgsiManagementService
http://127.0.0.1:8080/ogsa/services/core/registry/ContainerRegistryService
http://127.0.0.1:8080/ogsa/services/core/jmsadapter/JMSAdapterFactoryService
http://127.0.0.1:8080/ogsa/services/core/logging/OgsiLoggingManagementService
http://127.0.0.1:8080/ogsa/services/core/notification/httpg/NotificationSubscriptionFactoryService
http://127.0.0.1:8080/ogsa/services/core/ping/PingService
http://127.0.0.1:8080/ogsa/services/RemoteJoinPointService
http://127.0.0.1:8080/ogsa/services/ogsi/NotificationSubscriptionFactoryService
http://127.0.0.1:8080/ogsa/services/ogsi/HandleResolverService
http://127.0.0.1:8080/ogsa/services/MathService
http://127.0.0.1:8080/ogsa/services/gsi/AuthenticationService
http://127.0.0.1:8080/ogsa/services/gsi/SecureNotificationSubscriptionFactoryService
http://127.0.0.1:8080/ogsa/services/RemoteAdviceService

2. From another command prompt (any directory)

cass 9300

You can close this command prompt when it returns

3. From another command prompt

cd %CASS_HOME%/lib
%GLOBUS_LOCATION%/etc/globus-devel-env
java MathClient 100 5

You should see the following:

Added 100 to 5, received 94 Multiplied 100 to 5, received 450

Shutting down Cass

To shut down CASS, you just kill the process.

Unix

Since CASS runs in the background on Unix, you must find the process id and kill it.

Windows

Since CASS runs in the foreground on Windows, you simply press ctrl-C in the command window that is running CASS.

Troubleshooting

One problem you may encounter is with Java SDK 1.4.2_05. If you are running this version of the Java SDK, and have not followed all of the steps in the Globus Toolkit installation section of this document, you will receive the following error:

Exception in thread "main" java.lang.IllegalAccessError: tried to access field org.apache.xpath.compiler.FunctionTable.m_functions from class org.apache.xml.security.Init
        at org.apache.xml.security.Init.init(Unknown Source)
        at org.globus.ogsa.impl.security.authentication.wssec.WSSecurityEngine.(WSSecurityEngine.java:57)
        at org.globus.ogsa.impl.security.authentication.wssec.WSSecurityClientHandler.handleResponse(WSSecurityClientHandler.java:52)
        at org.apache.axis.handlers.HandlerChainImpl.handleResponse(HandlerChainImpl.java:153)
        at org.apache.axis.handlers.JAXRPCHandler.invoke(JAXRPCHandler.java:84)
        at org.globus.ogsa.utils.JAXRPCHandler.invoke(JAXRPCHandler.java:16)
        at org.apache.axis.strategies.InvocationStrategy.visit(InvocationStrategy.java:71)
        at org.apache.axis.SimpleChain.doVisiting(SimpleChain.java:150)
        at org.apache.axis.SimpleChain.invoke(SimpleChain.java:120)
        at org.apache.axis.client.AxisClient.invoke(AxisClient.java:193)
        at org.apache.axis.client.Call.invokeEngine(Call.java:2564)
        at org.apache.axis.client.Call.invoke(Call.java:2553)
        at org.apache.axis.client.Call.invoke(Call.java:2248)
        at org.apache.axis.client.Call.invoke(Call.java:2171)
        at org.apache.axis.client.Call.invoke(Call.java:1691)
        at edu.iit.concur.cass.testservices.math.stubs.bindings.MathServiceSOAPBindingStub.add(MathServiceSOAPBindingStub.java:1115)
        at MathClient.main(Unknown Source)

To fix this, error apply the JAXP patch as described in the Globus Toolkit installation section of this document.

Building Cass

Building CASS is very easy. Assuming you have completed the setup, then simply run ant build from the root cass directory. This will build CASS and place all binaries into <CASS_HOME>/lib, replacing the binaries that were included with the distribution.