3.2. Orchestra Tomcat distribution
| Chapter 3. Installation guide |

## 3.2. Orchestra Tomcat distribution

### 3.2.1. Installation

Unzip the orchestra-tomcat distribution package.

    >unzip orchestra-tomcat-4.2.1.zip

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

#### 3.2.1.1. Basic installation

Remark : 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.2.1
    >ant install

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

| Important
if your network is based on a proxy, please specify the proxy settings in your JAVA_OPTS environment property. The system properties to specify are described in the java documentation.

#### 3.2.1.2. Advanced installation: Using another tomcat distribution.

Orchestra is shipped with a lightweight Apache Tomcat Servlet container. This section explains how to install Orchestra in an existing tomcat distribution.

The install.properties file in the conf directory contains the information used by Orchestra installation. The default content is:

    			catalina.home=${orchestra.dir}/tomcat
    			catalina.base=${catalina.home}

To use another tomcat installation, just update the catalina.home and catalina.base properties before calling:

    >ant install

#### 3.2.1.3. Advanced installation: into JOnAS

Orchestra is shipped with a ligthweight Apache Tomcat Servlet container. This section explains how to install Orchestra in a JOnAS Application Server.

##### 3.2.1.3.1. JOnAS 5

- Copy Orchestra conf into $JONAS_BASE/conf (copy all files from orchestra conf directory to $JONAS_BASE/conf).

- Copy jdbc jar driver into $JONAS_BASE/lib/ext

- In orchestra.properties, change orchestra.servlet.port value to your JOnAS's tomcat port configuration (cf $JONAS_BASE/conf/tomcat6-server.xml)

- Copy Orchestra war (available in orchestra lib/ directory) to $JONAS_BASE/deploy and start JOnAS

##### 3.2.1.3.2. JOnAS 4

- Delete or upgrade xml-apis.jar and xalan-xxx.jar from $JONAS_ROOT/lib/endorsed. These libraries are needed for J2EE compatibility, but JOnAS4 can run fine without them. JOnAS4 has old versions of these libraries, which creates incompatibility issues with Orchestra.

- Copy Orchestra conf into $JONAS_BASE/conf (copy all files from orchestra conf directory to $JONAS_BASE/conf).

- Copy jdbc jar driver into $JONAS_BASE/lib/ext

- In orchestra.properties, change orchestra.servlet.port value to your JOnAS's tomcat port configuration (cf $JONAS_BASE/conf/server.xml)

- Copy Orchestra war (available in orchestra lib/ directory) to $JONAS_BASE/webapps and start JOnAS

Chapter 3. Installation guide |  | 3.2.2. Database Management