source: trunk/INSTALL-PACKAGE @ 458

How to install the TNTBase Debian package
Prerequisites

    * You should have Java of version 1.6 or later installed on your machine. The system variable JAVA_HOME should be set and point to the directory with JRE/JDK. 
    * You should have Tomcat installed on your system. TNTBase has been tested with Tomcat 6.0. But it also works with 5.5 or 5.0. For successful installation of TNTBase you should set CATALINA_HOME system variable pointing to the root directory of the Tomcat installation. 
    * Install Apache Ant and put Tomcat's catalina-ant.jar library to the ant lib directory. Typically, it is /usr/share/ant/lib. This is needed for deployment of Java web applications via ant tasks. 

Notes

    * TNTBase comes with Apache HTTP Server 2.2. WARNING: One should not use apache installed from Debian packages, since it is linked against libdb4.6, but TNTBase uses libdb4.8 

Installation

    * Run dpkg -i tntbase-0.1.deb. It will unpack all necessary files. For successful installation be sure that you have CATALINA_HOME and JAVA_HOME system variables set. 

    * After installing a package be sure that /usr/local/lib directory is in LD_LIBRARY_PATH. Otherwise, a TNTBase web application will fail during deployment. 

    * Edit tomcat-users.xml file to add a user with a role manager. E.g.

      <user username="manager" password="secret" roles="tomcat,admin,manager"/>

    * Run Tomcat and Apache http Server, if they are not yet running. Run Tomcat as www-data, but not as root. This is very important. But if you have some permissions problems, run chown -R www-data:www-data /var/www/tntbase
 The very common problem is when SVN returns "Could not open the requested SVN filesystem". 

Adding a TNTBase repository

    * A /var/www/tntbase/bin/init-tntbase-repository script is responsible for creating all environment for a TNTBase repository. But first of all, you have to configure the /var/www/tntbase/conf/deploy.properties file. It tells init-tntbase-repository script how to deploy web-applications. The fields are pretty self-explanatory:

      manager.url=http://localhost:8080/manager --- the url of a Tomcat manager
      manager.username=manager --- a user name with the ''manager'' role. You should have set it up in Section "Installation".
      manager.password=secret --- a password for a manager user

    * Run init-tntbase-repository script. Usage: init-tntbase-repository <name> <svn_user> <svn_password> <default_namespace> where:
          o <name> is the name of your TNTBase repository. It will be accessible by two urls:
                + http://<your_host>/repos/<name> - an SVN interface
                + http://<your_host>/tntbase/<name> - an entry point for other TNTBase services 
          o <svn_user> and <svn_password> - an SVN user that will have access to the TNTBase repository. Note that this user will be used internally by TNTBase as well. So do not remove this user in any case. dav_svn.passwd and dav_svn.authz files are located in /usr/local/apache2 directory (if there is Apache that came from TNTBase package). 

    * <default_namespace> - Here you can provide a default namespace for the XQuery context. E.g. if your documents are in http://ns.org namespace, then you can provide this namespace to the script, and later on use the empty prefix for querying documents with this namesapce without explicitly binding your namespace to the empty prefix. 

    * Configure access to your repositories in /usr/local/apache2/dav_svn.authz file. This is a usual authz file for SVN repositories hosted in Apache. For more information follow this link. 

Note: If you have error messages like: "The call failed on the server; see server log for details" or "Resource null not found!", be sure that you have some content in your TNTBase repository. In future nicer and more self-explanatory warnings will be added.

*Futher tuning

    * You might want to set up Tomcat so that it will put TNTBase web applications for your repositories into /var/www/tntbase/webapps, and logs of those applicatios to /var/www/tntbase/webapps. 

*United authentication

You might want to have both TNTBase interface on the same url. It is done via integrating mod_jk into the Apache Server. The configuration files should redirect requests like http://<your_host>/tntbase/<repository> to Tomcat. Setting this up is not integrated yet into scripts of the TNTBase package.