Extract the downloaded Oberon Platform zip file with the latest Oberon release into a folder on a server or a client machine.
You can find the following scripts:

- startdesign run the Enterprise Context Design client
- startobjects run the Domain Object Manipulatiion client
- rmistart1079, rmistart1089 .. run the Oberon RMI server on port 1079,1089 ..

The previous applications don't work until the underground database is not installed and configured; you can choose to:

- install on a MySQL database
- install on an Oracle database

MySQL Installation

1. Install the MySQL server

Download and install MySql 5.1.23 or a more recent version. After the Wizard completed the installation, configure the server as follow:

choose the detailed configuration



select the server type depending on the performance requirements



set the InnoDB tablespace installation Path (the location for the database data)



set the number of concurrent connections to the server:
if the server is used for the production purpose choose the OLTP type
otherwise should be sufficient the OLAP option.



set the networking options: if it is necessary, you can change the port number
and open the firewall for this port



select the UTF8 character set (support for multilingualism)



set the Windows service options



set the root password

2. Create the OBERON schema

Using the MySQL Administrator (included into the MySQL Tools for 5.0) create a new database schema named OBERON:

3. Set the JAVA_HOME

Edit the config.bat (or .sh) file and set the JAVA_HOME path with the Java Development Kit (JDK) installed on the server (and client) machine. Oberon requires the JDK 1.5 or more. Check if the PLATFORM name is correctly set.

4. Configure and run the Installation process

The Oberon installation process can be performed with the Enterprise Context Design client; before run it we must configure the relative oberon.ini file inside the etc folder. [If necessary, copy the oberon_MySQL.ini from the etc/samples sub-folder and overwrite the oberon.ini in the etc folder]
Open the oberon.ini file and set the server parameter with the MySQL server IP or name and the port parameter with the MySQL port for this server.

The installation process creates a default Oberon user named ADMIN; the ADMIN's password can't be changed after this user is created, so for a security reason the ADMIN's password should be set at this point.
In the oberon.ini set uid=ADMIN and pwd=the ADMIN's password   before run the installer.

To open the Enterprise Context Design client run the startdesign script.
When this console recognizes that Oberon is not installed on the declared database server it enables the Install command in the Connection / Database.. dialog window.

Insert the database administration user (root) and its password and click the Install button to launch the process.
Wait until the confirm message appears at the end:

Oracle Installation

1. Install the Oracle server

With the Oracle Database Configuration Assistant create a new database which support the UTF8 character set (for multilingualism). You can use also an already defined database with the same character set.

2. Set the JAVA_HOME

Edit the config.bat (or .sh) file and set the JAVA_HOME path with the Java Development Kit (JDK) installed on the server (and client) machine. Oberon requires the JDK 1.5 or more. Check if the PLATFORM name is correctly set.

3. Configure and run the Installation process

The Oberon installation process can be performed with the Enterprise Context Design client: before run it we must configure the relative oberon.ini file inside the etc folder.
Copy the oberon_ORACLE_OCI.ini from the etc/samples sub-folder and overwrite the oberon.ini in the etc folder; open the oberon.ini file and set the drvurl parameter with the database related Oracle SID.

The installation process creates a new schema named OBERON with the associated database user and a default Oberon user named ADMIN; the ADMIN's password can't be changed after this user is created, so for a security reason the ADMIN's password should be set at this point.
In the oberon.ini set uid=ADMIN and pwd=the ADMIN's password   before run the installer.

To open the Enterprise Context Design client run the startdesign script.
When this console recognizes that Oberon is not installed on the declared database server it enables the Install command in the Connection / Database.. dialog window.

Insert the database sys@sysdba user and its password and click the Install button to launch the process.
Wait until the confirm message appears at the end:

After the installation it's possible to connect the DB using the Oracle thin driver (avoiding to install the Oracle client): copy the oberon_ORACLE.ini from the etc/samples sub-folder and overwrite the oberon.ini in the etc folder; set the server parameter with the Oracle server IP (or name), the port parameter with the Oracle port for this server and the database name.