Rhino uses a persistent datastore to keep a backup of the current state of the SLEE. Before you can use Rhino, you must initialise this datastore; and if it’s an Oracle database, you’ll need to reconfigure Rhino for it.

Initialise Postgres

Rhino is configured to use the Postgres database by default. To initialise it, execute the init-management-db.sh shell script from a node directory (see Create New Nodes).

For example:

$ cd $RHINO_HOME/node-101
$ ./init-management-db.sh
Note

This script only needs to be run once for the entire cluster.
The SLEE administrator can also use this script to wipe all state held within the SLEE.

The init-management-db.sh script produces the following console output:

$ ./init-management-db.sh
Initializing database..
Connected to jdbc:postgresql://localhost:5432/template1 (PostgreSQL 8.4.8)
Connected to jdbc:postgresql://localhost:5432/rhino (PostgreSQL 8.4.8)
Database initialized.

Reconfigure for Oracle

To use Oracle as Rhino’s persistent datastore, reconfigure before initialising:

1
Edit the config_variables file

In the file $RHINO_HOME/config/config_variables, update the following parameters with the appropriate values for your Oracle installation:

MANAGEMENT_DATABASE_NAME=rhino
MANAGEMENT_DATABASE_HOST=localhost
MANAGEMENT_DATABASE_PORT=1521
MANAGEMENT_DATABASE_USER=username
MANAGEMENT_DATABASE_PASSWORD=changeit

2
Edit the $RHINO_HOME/config/persistence.xml file

The $RHINO_HOME/config/persistence.xml only exists after the node has been started at least once. If the file does not yet exist, edit $RHINO_HOME/config/defaults.xml instead.

Find the <persistence-resource> elements in the file with the names management and profiles and change their <persistence-resource-ref> sub-elements to reference the persistence resource with the name oracle instead of postgres.

Note The external database configuration can also be changed while Rhino is running. For more information on this, refer to the External Databases section of the Rhino Administration and Deployment Guide.

3
Run init-management-db.sh

To initialise the database, execute the init-management-db.sh shell script from a node directory (see Create New Nodes), passing oracle as a parameter.

For example:

$ cd $RHINO_HOME/node-101
$ ./init-management-db.sh oracle
Note

This script only needs to be run once for the entire cluster.
The SLEE administrator can also use this script to wipe all state held within the SLEE.

The init-management-db.sh oracle script produces the following console output:

$ ./init-management-db.sh oracle
Initializing database..
Connected to jdbc:oracle:thin:@vortex1:1521:rhino (Oracle Oracle Database 11g Release 11.2.0.1.0 - 64bit Production)
Database initialized.
Previous page Next page