Shakespeare Text Actors and Web interfaces
Installation Instructions

Ralph Moulton
MIR WUSM
moultonr@mir.wustl.edu

System Requirements

Linux (developed on Fedora 11)
Should run on other systems and Windows

Windows note: You may have to reset file permissions, as there is no currently
available portable way to map Linux file permissions to Windows file permissions

java version 1.6.0_0 or higher. Make sure $JAVA_HOME is defined and that
$JAVA_HOME/bin is in your PATH.
postgresql 8.4 or higher

To run the Web interfaces:

JBoss 5.1.0.GA  
jboss seam 2.2.0.GA

Note: Copy the postgresql jdbc driver jar to the JBoss lib directory for the
domain you are going to use: $JBOSS_HOME/server/$JBOSS_DOMAIN/lib

Note: In order to correct an incompatibility between JBoss 5 and Java 1.6 
relating to support of JAX-WS 2.1, before starting your server, you need to copy
the following jars to ${JBOSS_HOME}/lib/endorsed from 
${JBOSS_HOME}/common/lib:

jbossws-native-jaxrpc.jar
jbossws-native-jaxws-ext.jar
jbossws-native-jaxws.jar
jbossws-native-saaj.jar


Installation

1. Unzip the shakespeare.zip file to a directory of your choosing, which these
notes will refer to as $SHAKESPEARE_HOME. Set the environment variable
$SHAKESPEARE_HOME to this directory 

2. To run the Web interfaces, 

   A. copy the contents of $SHAKESPEARE_HOME/lib to 
      $JBOSS_HOME/server/$JBOSS_DOMAIN/lib.
   
   B. copy the contents of $SHAKESPEARE_HOME/webapp to 
      $JBOSS_HOME/server/$JBOSS_DOMAIN/deploy
      
   C. Start the JBoss server.
   
   D. Access the Web interfaces at http://JbossIP:port/MessageManager
   
3. To run the Actors from the command prompt:

   A. Make the appropriate client directory under the $SHAKESPEARE_HOME 
      directory current, (PIXConsumer or PDQConsumer).
   
   B. run tcsh ./scripts/run---.csh for the client, or make your own.