MARS installation procedure

Applicable for Release 0.9.9

 

1. Requirements

Hardware requirements:

Server with at least 1 GBytes of main memory

Software requirements:

Oracle 9i or PostgreSQL 7.3 for MARS
MySQL 4.0.xx for the Usermanagement
Java JDK 1.4.x or JDK 1.5.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_Oracle.sql to create tables in Oracle and to insert required data

2. or PostgreSQL installation

2.1. Create user new user e.g.

username: marsdummy
password: marsdummy

2.2. Create a new database for MARS (e.g. marsdummy)


2.3. Use initializeMARS_PostgreSQL.sql to create tables in PostgreSQL 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 or PostgreSQL and MySQL servers
4.0 jboss stands either for jboss_oracle or for jboss_postgresql
4.1. Go to jboss/server/default
4.2. Edit oracle-ds.xml or postgres-ds.xml and enter the required connection settings for Oracle or PostgreSQL
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

./run.sh -c usermanagement

6.3. Start MARS using

./run.sh

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

arg0 = DATAROOTDIRECTORY
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/marsWEB

10. Get access to MARS-QM

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