MARS installation procedure

Applicable for Release 0.9


1. Requirements

Hardware requirements:

Server with at least 1 GBytes of main memory

Software requirements:

Oracle 9i for MARS
MySQL 4.0.xx for the Usermanagement
Java JDK 1.4.x
be sure that JAVA_HOME points to your JDK installation


2. Installation Instructions

To install MARS properly you have to execute the following steps on the server:

1. Installing MARS

1.1. Unpack mars.tar.gz

2. Oracle installation

2.1. Create a new tablespace for MARS

2.2. Create user like 'Scott' e.g.

username: marsdummy
password: marsdummy

2.3. Use initializeMARS.sql to create tables in Oracle and to insert required data

3. MySQL installation

3.1 Create a schema

3.2. Create a new user

3.3. Use initializeAAS.sql to create necessary tables for the Authentication and Authorization System (AAS) and to insert required data

4. Adjusting JBoss settings according to your ORACLE and MySQL servers

4.1. Go to jboss/server/default
4.2. Edit oracle-ds.xml and enter the required connection settings for Oracle
4.3. Go to jboss/server/usermanagement
4.4. Edit mysql-ds.xml and enter the required connection settings for MySQL

5. Create data root

5.1 Create your DATAROOTDIRECTORY. The DATAROOTDIRECTORY is the root path where all the files which are uploaded or can be downloaded from MARS are stored. Pay attention! This volume should be very large since all the scanned files are stored there, too!
e.g. /home/marsdata/

5.2. Copy the file FileUploadTypes.xml to the created directory into a new subfolder called 'config'

6. Start the applications

6.1. Go to jboss/bin

6.2. Start supplied Authentication and Authorization System (AAS) with

./ -c usermanagement

6.3. Start MARS using


7. Change the MARS settings and insert the path to the newly created DATAROOTDIRECTORY

7.1. Open http://localhost:8080

7.2. Click on JMX-Console

7.3. Click on service=MARSServerSettings

7.4. Use the method setProperty

arg1 = /home/marsdata/

7.5. Click on invoke
7.6. To check the properties use method „listProperties“

8. Get access to the AAS

8.1. Open your Web browser and type http://localhost:17080/UsermanagementWeb

8.2. Login using admin/12345

(change the password afterwards, since this is the ADMINISTRATOR account)

8.3. Create a new user account and add user to one of the available MARS groups

a testuser account has already been created:
username: testmars
password: test!!

9. Get access to MARS

9.1. Open your Web browser and type http://localhost:8080/mars

10. Get access to MARS-QM

10.1. Open your Web browser and type http://localhost:8080/marsQM