Instructions for installing the Inheritance Chase game and the End point Application Server
-------------------------------------------------------------------------------------------

1) Copy the "matrix_server" folder (further on referred to as '+') to a machine that will run the game server application.
2) Create "C:\Documents and Settings\User\Desktop" destination folder, if one already does not exist, and copy "sdpcontent.txt"
   and "sdpParameters.txt" files from the "+\sdpmediadescription" folder to the destination folder.
3) Edit the "configuration.properties" file, in the "matrix_server" folder, to respond to IP address of the computer and
   wanted port number.

In order to run the prototype application, the computer furthermore needs to have the following software installed:
- Apache Tomcat Web server (version 5.5 preferred),
- Cortona VRML Client (version 4.2 preferred), and
- Java Media Framework (JMF) API (version 2.1.1e preferred).

Apache Tomcat Web server can be downloaded from [1]. The VRML Client can be downloaded from [2]. The JMF can be obtained
from [3].

When the VRML Client is installed, the "classes.zip" and the "corteai.zip" files from the "C:\Program Files\Common Files\ParallelGraphics\Cortona"
folder need to be copied to the "+\lib\cortona" folder. When the JMF is installed, the "jmf.jar" file from the
"<JMF_folder>\lib" folder needs to be copied to the "+\lib" folder.

After installation of the Web server:
1) Modify the "gallery<1,2,3>.xml" files in the "+\serviceprofilerepository\gallery\profiles" folder so that IP address
   in the "url" parameters responds to IP address of the computer used as the game server.
2) Complete folder named "DeepMatrix" (contained in "DeepMatrix.rar") needs to be copied into the "<Tomcat_folder>\Apache Software Foundation\Tomcat 5.5\webapps\ROOT"
   folder (further on marked as '*').
3) Class file "EventManager" from the "+\bin\nvrcontentserver\vrserviceprocessor" folder needs to be copied into the
   "*\WEB-INF\classes\nvrcontentserver\vrserviceprocessor" folder.
4) Class file "GalleryServlet" from the "+\bin\nvrcontentserver\vrserviceprocessor\galleryservice" folder needs to
   be copied into the "*\WEB-INF\classes\nvrcontentserver\vrserviceprocessor\galleryservice" folder.
5) File "web.xml" in the "<Tomcat_folder>\Apache Software Foundation\Tomcat 5.5\conf" folder needs to be modified
   so that the comments "around" servlet "org.apache.catalina.servlets.InvokerServlet" and "around" servlet mapping
   for the invoker servlet (tag "servlet-name" equals to "invoker") are deleted.
6) Files "Matrix.html" and "Matrix1.html" in the "*\DeepMatrix" folder have to be modified so the IP addresses correspond
   to the machine that hosts the game server.
7) File "matrix.wrl" in the "*\DeepMatrix\world" folder has to be modified in scripts "calling" and "calling2" so
   the IP address/computer name corresponds to the machine that hosts the game server. If an IP address is used, input
   format must be complied. Furthermore, modify IP address in the first two "url" parameters of the "Anchor" node
   in the "Object3" Transform node to match the computer being used as the game server.

After successful installation and configuration,
1) ensure that the Web server is running and
2) start the game server application by running "matrix_server/start.bat".

References:
[1] The Apache Software Foundation, Apache Tomcat [On-line: http://tomcat.apache.org/]
[2] ParallelGraphics, Cortona VRML Client [On-line: http://www.parallelgraphics.com/products/cortona/]
[3] Sun Microsystems, Inc., Java Media Framework API (JMF) [On-line: http://java.sun.com/products/java-media/jmf/]


This product includes Xerces software (the "Xerces software") developed by the Apache Software Foundation (http://www.apache.org/).
The Xerces software is licensed under the Apache Software License, Version 1.1 (the "Xerces license"). See the file
"licenses/xerces.LICENSE" for the Xerces license.

This product includes JDOM software (the "Jdom software") developed by the JDOM Project (http://www.jdom.org/). The
Jdom software is licensed under the "Jdom license". See the file "licenses/jdom.LICENSE" for the Jdom license.