ORBADA - Dokumentacja
Author: Andrzej Kałuża, ORBADA
Description: Organizer Bazy Danych, Db Pages

2016-12-06 08:15
ORBADA » Documentation in English » Running the application

### 4.1.1. Running the application

To run the program requires Java (JRE) is at least version 1.6. You can download them here.

Windows
To run the ORBADA on Windows operating system, should be used runtime script `orbada.bat` located in the root directory of the program. Its contents should look like this:
`start javaw -Xmx200M -Djava.system.class.loader=pl.mpak.startup.StartupClassLoader -jar startup.jar %1 %2 %3 %4`
Startup parameters:
`javaw` – executable Java. The `PATH` environment variable should contain the path to the Java environment is at least version 1.6. Here you can specify a full path to the program javaw. The program will run in this environment, regardless of the environment variable `PATH`
`-Xmx200M` - parameter specifies the maximum amount of memory that can be reserved by the program. More environment parameters of Java can be found at the manufacturer's Java - SUN.
`%1 %2 %3 %4` - to the program ORBADA may be transferred four parameters.

Linux/Unix
To run ORBADA on Linux/Unix, should be used runtime script `orbada.sh` located in the root directory of the program. Its contents should look like:
`/usr/java/jdk1.6/jre/bin/java -Xmx200M -Djava.system.class.loader=pl.mpak.startup.StartupClassLoader -jar startup.jar`
Startup parameters:
`/usr/java/jdk1.6/jre/bin/java` - Java runtime program. If Java is installed in a different path than specified, this parameter needs to be changed.
`-Xmx200M` - parameter specifies the maximum amount of memory that can be reserved by the program. More environment parameters of Java can be found at the manufacturer's Java - SUN.

### 4.1.2. Program call parameters

`-config:<file name>`
This parameter allows you to run the program with an alternative main configuration. The name should indicate the file in the directory of the "user home/.orbada/config" without the extension. This configuration file extension is .properties.

`-log4j:<file name xml>`
This parameter allows you to specify an alternate configuration of the logger program. The name should indicate the file in the directory of the "user home/.orbada/config".

### 4.1.3. Configuration to run from a USB Drive

ORBADA program and Java environment can configured that the entire program, all its settings, were on a USB Drive.
The required minimum on portable disk space is 150MB.

For this purpose, is required to edit the boot BAT or SH, and putting all the required files in one main directory.

An example directory layout:

- orbada – root directory of the program

- app - directory to which you should upload all the files and libraries of the ORBADA program
- jre6 - directory where you should upload a Java environment from Sun.
- usr - directory where application put all the settings and temporary files

- temp - temporary files directory
- home - home directory settings for the files and local database

The contents of the startup file `orbada.bat` should look like:

    start ../jre6/bin/javaw -Xmx200M -Duser.home=../usr/home -Djava.io.tmpdir=../usr/temp
      -Djava.system.class.loader=pl.mpak.startup.StartupClassLoader -jar startup.jar %1 %2 %3 %4

The contents of the startup file `orbada.sh` should look like:

    ../jre6/bin/java -Xmx200M -Duser.home=../usr/home -Djava.io.tmpdir=../usr/temp
      -Djava.system.class.loader=pl.mpak.startup.StartupClassLoader -jar startup.jar

It is important that the locations of folders in bold were the same as folders on a USB Drive

### 4.1.4. Database serwer

• Embeded mode • HSQLDB Server • Oracle Server • PostgreSQL server •
ORBADA » Documentation in English » Running the application
• © 2007–2016 • Andrzej Kałuża • Powered By DBPAGES • Hostet at •