Installation guide of tYNA (written by Kevin Yip, Dec 6 2005 version)
-----------------------------------------------------------------------

tYNA is implemented in Java. It consists of Java Server Pages (JSP) and
servlets that need to be run in a servlet engine. tYNA requires a backend
MySQL database for storing data. It also requires some third-party libraries.

There are two ways to install tYNA, either using the "deploy" Ant task, or
copy the compiled files to the servlet engine directly. The following procedures
are required by both methods:

. Install or configure a web server and a servlet engine
  (recommended: Apache Tomcat http://tomcat.apache.org/index.html, tested
   version: 5.0. Below the directory structure of Tomcat will be assumed). The
   directory where the server is installed will be called the {SERVER_HOME}
   directory.
. To avoid others listing the files in a directory, please disable the directory
  listing feature. For Tomcat, this is done by editing the web.xml file in the
  {SERVER_HOME}/conf directory, and setting the "listings" parameter to false.

. Unpackage the distribution file "tyna.jar" to a local directory. Below it
  will be called the {LOCAL} directory.
. In the webapps directory of the servlet engine, create the directory "tyna".
  Below it will be called the {TYNA_HOME} directory.

. Install or configure a MySQL database server
  (http://www.mysql.com/, tested version: 4.0.21).
. Open the file tables.sql.example in the {LOCAL}/sql directory, and modify
  "example.org" and "foo" to the hostname of the MySQL server and a password you
  want to use for a MySQL user respectively.
. Run the SQL script.

. Install aiSee.
  (http://www.aisee.com/, tested version: 2.2.07)

. Install or configure the tool "ps2pdf" for converting postscript files into
  PDF format.

. Copy the file "tyna.config.example" in the {LOCAL}/conf directory to
  "tyna.config" and place it in the same directory.
. Modify the settings in {LOCAL}/conf/tyna.config.

. Download the following library files to the {LOCAL}/WEB-INF/lib directory:
  . Java API for servlets
    (http://java.sun.com/j2ee/index.jsp, tested version: 2.4)
  . MySQL connector
    (http://www.mysql.com/products/connector/j/, tested version: 3.0.16)
  . Oreilly servlet utilities
    (http://servlets.com/cos/)

. Download the Blueshoes JavaScript library to the {LOCAL}/scripts directory
  (http://www.blueshoes.org/en/javascript/)


The following procedures are only for method 1: using Ant task
. Install or setup Apache Ant
  (http://ant.apache.org/)

. Copy the file "ant.properties.example" in the {LOCAL}/conf directory to
  "ant.properties" and place it in the same directory.
. Modify the settings in {LOCAL}/conf/ant.properties (be consistent with
  tyna.config).
. At {LOCAL} directory, run the command "ant deploy".

. Restart the servlet engine.


The following procedures are only for method 2: direct copying
. Create the following empty directories:
  . {TYNA_HOME}/WEB-INF
  . {TYNA_HOME}/WEB-INF/data/category
  . {TYNA_HOME}/WEB-INF/data/network
  . {TYNA_HOME}/temp
. Copy the following files (or whole directory, with files inside) to the
  servlet engine:
  . {LOCAL}/*.jsp -> {TYNA_HOME}/*.jsp
  . {LOCAL}/conf/tyna.config -> {TYNA_HOME}/WEB-INF/classes/tyna.config
  . {LOCAL}/css -> {TYNA_HOME}/css
  . {LOCAL}/examples -> {TYNA_HOME}/examples
  . {LOCAL}/javadoc -> {TYNA_HOME}/javadoc
  . {LOCAL}/media -> {TYNA_HOME}/media
  . {LOCAL}/scripts -> {TYNA_HOME}/scripts
  . {LOCAL}/WEB-INF/web.xml -> {TYNA_HOME}/WEB-INF/web.xml
  . {LOCAL}/WEB-INF/lib -> {TYNA_HOME}/WEB-INF/lib

. Restart the servlet engine.