Chapter 3. Installation guide

Table of Contents

3.1. Orchestra Tomcat distribution
3.1.1. Installation
3.1.2. Database Management
3.1.3. Orchestra directory structure
3.2. Orchestra OSGI Felix distribution
3.2.1. Installation
3.2.2. Database Management
3.2.3. Orchestra directory structure

Nova Orchestra comes in two distributions:

3.1. Orchestra Tomcat distribution

3.1.1. Installation

Unzip the orchestra-axis distribution package.

>unzip orchestra-tomcat-4.0.11.zip

A new directory orchestra-tomcat-4.0.11 will be created. It contains an ant file to install and start Orchestra.

Remark : Nova Orchestra runs in Apache Tomcat servlet container. Tomcat 5.5.23 is delivered with the Orchestra Package.

To install Orchestra, go to orchestra directory and launch the install by running ant:

>cd orchestra-tomcat-4.0.11
  		>ant install

The install script installs Tomcat and Nova Orchestra. The default installation activates the persistence using the H2 Database.

[Important] Important

if your network is based on a proxy, please change the file conf/conf.properties. Set in this file the proxy host, port and non proxy hosts. Then run ant configure under the installation directory.

3.1.2. Database Management

The default configuration of Nova Orchestra uses the Database persistence service and the HSQL Database. Nova Orchestra has also been tested with Oracle, MySQL and Postgres database system. To change to mysql, postgres or Oracle, you need to put the corresponding JDBC driver in the directory catalina_base/webapps/orchestra/WEB-INF/lib and modify the hibernate.properties file (see Section 4.2.4.1, “Database Access Configuration”)

3.1.3. Orchestra directory structure

Hereafter is detailled the structure of Orchestra installation. The installation directory contains the following structure :

README
  build.xml
  install.xml
  Licence.txt
  catalina_base/
  catalina_home/
  conf/
  doc/
  examples/
  lib/

Let's present those items :

  • README

    This file gives the basic information related to Nova Orchestra

  • build.xml

    This file is an ant file that provides tasks to install and use Nova Orchestra. Just typing ant will result giving you the usage.

  • install.xml

    This file is an ant file that is called when you run ant install (no need to specify the use of this file)

  • License.txt

    The license of Nova Orchestra. All of Nova Orchestra is available under the LGPL license.

  • conf/

    This directory contains all the configuration files of Nova Orchestra.

    [Warning] Warning

    The modifications made to the configuration files are only taken into account after running the ant configure command.

  • catalina_base/ & catalina_home/

    Those directories are the installation and configuration directories of Tomcat

  • doc/

    This directory contains the documentation of Nova Orchestra. It contains :

    • userGuide.pdf

      For PDF documentation

    • html/userGuide.html

      For HTML documentation in a single page

    • html/userGuide/userGuide.html

      For HTML documentation in different pages

  • examples/

    This directory contains the examples provided with Nova Orchestra package. See Section 5.4, “Running the examples”

  • lib/

    This directory contains the libraries used in Nova Orchestra.