LISA Demo Server

-------------------------------------------------The LISA Demo Server is a JBoss 4.2.3 application server that has several
applications installed to demonstrate LISA features. Example test cases that
exercise the LISA Demo Server are in LISA_HOME/examples.
Requirements
-------------------------------------------------Java 7 is required to run the Demo Server.
If you have installed lisa-demo-server stand alone, you must have Java 7
installed separately on your system. See notes specific to your platform.
LISA Agent
-------------------------------------------------For information on LISA Agent in general, including what artifacts are needed
to use LISA Agent, see the LISA Agent Guide in the user documentation.
If lisa-demo-server resides inside a LISA_HOME, it will start the Demo Server
with LISA Agent enabled by default. It will use the LISA Agent libraries
located at LISA_HOME/agent. See below to override this behavior.
If lisa-demo-server is installed stand alone, it will start the Demo Server
with the agent from JBOSS_HOME/agent
The Demo Server startup scripts can accept options to change LISA Agent
behavior:
--noagent : Forces Demo Server to start without LISA Agent
--agentdir=<directory> : Start Demo Server using the LISA Agent artifacts
located at <directory>. See LISA Agent documentation for what is needed.
--javaagent
Start with the LISA java agent
Platform Specific Instructions
-------------------------------------------------lisa-demo-server in a Windows LISA install
-------------------------------------------------Simply run start-windows.bat located in this directory to start the
Demo Server.
If using Ctrl-C to shut down the Demo Server, when prompted:
Terminate batch job (Y/N)?
Answer "n". This will allow the script to continue and shut down the Derby
database.
lisa-demo-server standalone on Windows
-------------------------------------------------Identify the location of Java 7 on your system in one of three ways:
- set LISA_JAVA_HOME=<location of your Java 7 install>
- set JAVA_HOME=<location of your Java 7 install>
- Ensure that "java.exe" in somewhere in your PATH

Then run start-windows.bat located in this directory

If using Ctrl-C to shut down the Demo Server, when prompted:
Terminate batch job (Y/N)?
Answer "n". This will allow the script to continue and shut down the Derby
database.
lisa-demo-server standalone on OSX, Linux, any other Unix
-------------------------------------------------Identify the location of Java 7 on your system in one of three ways:
- export LISA_JAVA_HOME=<location of your Java 7 install>
- export JAVA_HOME=<location of your Java 7 install>
- Ensure that "java" in somewhere in your PATH
Make the startup executable:
- OSX : chmod a+x start-osx.command
- Unix : chmod a+x start-unix-linux.sh
Then run start-osx.command or start-unix-linux.sh located in this directory.
Notes
-------------------------------------------------The EncryptedCalculatorService that demonstrates encrypted SOAP
request / response, and the example test case ws_security.tst that exercises
it, will work as expected if Demo Server is using the built-in LISA_HOME/jre.
However, if you are using an external Java install, you will need to install
the Java Cryptography Extension (JCE) package into your Java installation for
this example application to work. See:
http://www.oracle.com/technetwork/java/javase/downloads/index.html
for information on JCE.