Setting up Oracle

The following sections describe how to replace the default H2 databases with Oracle:

Setting up the database and users

Follow the steps below to set up an Oracle database.

Create a new database manually or by using the Oracle database configuration assistant (dbca).
Make the necessary changes in the Oracle tnsnames.ora and listner.ora files in order to define addresses of the databases for establishing connections to the newly created database.
After configuring the .ora files, start the Oracle instance using the following command:
```
$ sudo /etc/init.d/oracle-xe restart
```

Connect to Oracle using SQL*Plus as SYSDBA as follows:

$ ./$<ORACLE_HOME>/config/scripts/sqlplus.sh sysadm/password as SYSDBA

Connect to the instance with the username and password using the following command:
```
$ connect
```

As SYSDBA, create a database user and grant privileges to the user as shown below:

Create user <USER_NAME> identified by password account unlock;
grant connect to <USER_NAME>;
grant create session, create table, create sequence, create trigger to <USER_NAME>;
alter user <USER_NAME> quota <SPACE_QUOTA_SIZE_IN_MEGABYTES> on '<TABLE_SPACE_NAME>';
commit;

Exit from the SQL*Plus session by executing the quit command.

Setting up the JDBC driver

Copy the Oracle JDBC libraries (for example, <ORACLE_HOME/jdbc/lib/ojdbc14.jar) to the <IoTS_HOME>/lib directory.
Remove the old database driver from the <IoTS_HOME>/dropins directory.

If you get a timezone region not found error when using the ojdbc6.jar with WSO2 servers, set the Java property as follows: export JAVA_OPTS="-Duser.timezone='+05:30'"

The value of this property should be the GMT difference of the country. If it is necessary to set this property permanently, define it inside the wso2server.sh as a new JAVA_OPT property.

What's next

By default, all WSO2 products are configured to use the embedded H2 database. To configure WSO2 IoTS with Oracle, see Changing to Oracle.