TASKPM/INSTALL

Installation instructions
=========================


Database creation
-----------------

* Current databases supported: PostgreSQL (default), MySQL, and HSQLDB
  (In-Process/Standalone Mode).

* For PostgreSQL and MySQL:

  - Create a database with name ``navaldev`` (for development)::

      CREATE DATABASE navaldev;

  - Create a database with name ``navaldevtest`` (for the test fase in
    development)::

      CREATE DATABASE navaldevtest;

  - Create user ``naval`` with password ``naval`` with necessary privileges for
    accessing (creating tables, selecting data from tables, etc.) the
    previous databases:

    + PostgreSQL::

        CREATE USER naval WITH PASSWORD 'naval';
        GRANT ALL PRIVILEGES ON DATABASE navaldev TO naval;
        GRANT ALL PRIVILEGES ON DATABASE navaldevtest TO naval;

    + MySQL::

        GRANT ALL ON navaldev.* to 'naval'@'localhost' identified by 'naval';
        GRANT ALL ON navaldevtest.* to 'naval'@'localhost' identified by 'naval';

  - For HSQLDB. There is nothing to do.


Compilation
-----------

* Download Spring Framework 2.5.6 (http://www.springsource.org/download).

* Execute the following commands::

    mvn install:install-file -DgroupId=javax.transaction -DartifactId=jta \
      -Dversion=1.0.1B -Dpackaging=jar \
      -Dfile=<<spring-framework-2.5.6>>/lib/j2ee/jta.jar

    cd xestion-producion

    mvn install

    cd navalplanner-webapp

    mvn jetty:run

* Access to http://localhost:8080/navalplanner-webapp.

* To install the web application in a web container, use the WAR file:
  ``navalplanner-webapp/target/navalplanner-webapp.war``.

* *Notes for using other databases*:

  + MySQL:

    - Remember to start MySQL with ``--default-table-type=InnoDB`` option for
      enabling support for transactions.

    - Use ``mvn -Pdev,mysql <<goal|fase>>``::

        e.g. mvn -Pdev,mysql install

  + HSQLDB:

    - Use ``mvn -Pdev,hsqldb <<goal|fase>>``::

        e.g. mvn -Pdev,hsqldb install


Profiles
--------

Check ``<profiles>`` section in the root ``pom.xml`` to see the profile-based
approach used in the project. The default profiles (the one assumed by the above
instructions) are ``dev`` and ``postgresql`` (meaning "use PostgreSQL assuming a
development environment").

Print
-----

Printing system is based on a tool that produces several output formats rendering
the specified URLs with the WebKit engine. To be able to print local diagrams this
tool and a lightweight X server must be installed.

The capturing tool is CutyCapt [1], which has to be either compiled or installed from
an external package. Once compiled from the tarball the binary CutyCapt must be located
under /usr/bin/ to be available to the application.

X virtual framebuffer xvfb[2] package needs to be installed for the application running on
a non-desktop server is capable of launching an X instance to create the print capture of
the selected page.

[1] http://cutycapt.sourceforge.net/
[2] http://www.xfree86.org/4.0.1/Xvfb.1.html