These are the instructions to run the demo. They are somewhat artificial
in that they show off all the ways that clients and servers can be
configured. You could choose to run them differently. For example,
you could make both servers be RMI-based.


1.0 Running all pieces of the demo locally on a PC

Prerequisites and notes:
1) Install JDK 1.1.5+ or J2SDK 1.2.1+.
2) Install the Java Servlet Development Kit(JSDK) v2.1 or greater,
   which can be downloaded from Sun's web site. (Alternately you can
   adapt the servlet-related instructions below to your web server).
3) If port 2000 or 2001 is unavailable, specify a different port in each 
   xxxURL property in: the command lines below, retire.properties, and
   retire_applet.html.
4) 101 is the only account number in the Get Portfolio database.

Common actions:
1) Include <jdk root dir>\bin in PATH.
   (For example, set path=%path%;c:\jdk1.1.7\bin)
2) Include <servit root dir>\servit.jar;<servit root dir>\demo in CLASSPATH.
   (For example, set classpath=c:\servit\servit.jar;c:\servit\demo)

Start an RMI-based CalcRet server (and RMI registry).
1) Create a DOS window and do the common actions
2) Do: java com.compaq.servit.StartServers 2000 CalcRet

Start and use a client application.
1) Create a DOS window and do the common actions
2) Do: java -DDefaultURL=inprocess retire
3) Try out features of the stand-alone application and then close it.
4) Do: java -DCalcRetURL=rmi://:2000 -DBrokerURL=socket://:2001 retire
5) Now that it is accessing remote servers, press the Get Portfolio button
   and then press OK in the Get Portfolio box. This will display an error
   message box because the Broker server has not been started yet.
6) Leave the error message box up, and go to the next set of instructions.

Start a framework for running a socket-based Broker server.
(Normally this would be done before starting any clients. The demo does
it afterwards to demonstrate network error recovery).
1) Create a DOS window and do the common actions
2) Do: java com.compaq.servit.StartServers 2001 socket
3) Press OK in the client's error message box and repeat the Get Portfolio 
   request.

Start and use a servlet-based client.
1) Create a DOS window and do the common actions
2) Do: cd <JSDK root dir>
3) Append <servit root dir>\demo\retire.properties to
   webpages\web-inf\servlets.properties (if you have not already done so).
4) Do: startserver  (which starts the servlet runner)
5) Run a browser and open this file:
   <servit root dir>\demo\retire_ui.html
6) Click on links on this web page to try out this form of the client.

Start and use a client applet.
1) Create a DOS window
2) Do: cd <servit root dir>\demo
3) Do: copy ..\servit_applet.jar (if you have not already done so).
   (servit_applet.jar is not included in the demo directory of the Servit 
   kit since this step, or something like it, must be done for all applets).
4) Do: <jdk 1.2 root dir>\bin\appletviewer retire_applet.html
5) Try out this form of the client. Note that since the appletviewer puts
   its own trim directly into applet windows, you will first need to use 
   the mouse to increase the size of some of the applet's windows.

Shutdown the demo.
1) Do: Ctrl-C in the client application's DOS window (or do a Close in
   the application window).
2) Do: Ctrl-C in the appletviewer's DOS window (or do a Close in the
   applet window).
3) Do: Ctrl-C in the two StartServers DOS windows.
4) Do: stopserver in the DOS window in which "startserver" was done.
5) Do: exit in each the DOS window you want to close.


2.0 Overview of how to use other nodes for pieces of the demo

This section assumes the other nodes are UNIX systems. Note that all these
steps could be performed on a single node.

General:
1) Install the Servit kit on each desired node.
2) Some of the steps below use a web-accessible directory. If you have
   an account on this node, one way to have a web-accessible directory 
   is to create your-home/public_html. If you do this, this directory
   can be accessed in browsers via this-node/~your-home.

Setup and run an RMI-based server and/or a socket-based server.
1) Include <servit root dir>/servit.jar:<servit root dir>/demo in your
   classpath. (Note that : is the separator character instead of ;).
2) Do: java com.compaq.servit.StartServers ... (see 1.0 for details).
   (Note that you can suffix & to a command line to run a program in the 
   background. In this way, you can run both servers from the same window).

Setup and use servlets.
1) This node must be running a web server that can run servlets.
2) Adapt the configuration info in retire.properties into the form needed 
   for your web server. Also if you are running the CalcRet server or the
   Broker server on a node other than this-node, replace the localhost in 
   its xxxURL property value with the name of the node where it is running.
3) Include <servit root dir>/servit.jar in the classpath your web server 
   uses.
4) Do: cp <servit root dir>/demo/*.class <your web server's servlet dir>.
   (This is for the sake of simplicity. You actually do not need to copy 
   the server-only files, namely *SocketSkel.class).
5) Do: cp <servit root dir>/demo/*_ui.html <web-accessible dir>.
6) In the copied getport_ui.html and calcret_ui.html, replace 
   localhost:8080 with this-node.
7) Run a browser on the client system and open this URL:
   this-node/<web address of web-accessible dir>/retire_ui.html

Setup and use a client applet.
1) This node must be running a web server.
2) Do: cp <servit root dir>/servit_applet.jar <web-accessible dir>.
3) Do: cp <servit root dir>/demo/*_applet.* <web-accessible dir>.
4) If you are running the CalcRet server or the Broker server on a node 
   other than this-node, modify the copied retire_applet.html to identify
   that node in its xxxURL property value.
5) Run a browser on the client system and open this URL:
   this-node/<web address of web-accessible dir>/retire_applet.html