|Check the Rhino Compatibility Guide to ensure you’ve got a supported Java version.
|Check the Rhino Compatibility Guide to ensure you’re using a compatible database version.
The Rhino SLEE requires an RDBMS database for persisting the main working memory to non-volatile memory (the main working memory in Rhino contains the runtime state, deployments, profiles, resource adaptor entity configuration state, and so on). While a successful connection to the database is required in order to start the first node in a cluster, the Rhino SLEE remains available whether or not the database remains available after the first node has successfully completed bootup procedures.
The database does not affect or limit how Rhino SLEE applications are written or operate — it provides a backup of the working memory only, so that the cluster can be restored if it has entirely failed and needs to be restarted.
The database can be installed on any network-reachable host. When using Savanna clustering mode only a single database is required for the entire Rhino SLEE cluster (the Rhino SLEE can replicate the main working memory across multiple servers). When using pool clustering mode, each node will require its own database, further information can be found in the Pool clustering management database section.
Detailed instructions for the installation of Oracle are outside the scope of this documentation. Contact your Oracle database administrator for assistance.
Download and install PostgreSQL
To download and install the PostgreSQL platform:
Create a user for the SLEE
Once you have installed PostgreSQL, the next step is to create or assign a database user for the Rhino SLEE. This user will need permissions to create databases, but does not need permissions to create users.
To create a new user for the database, use the
For versions of PostgreSQL prior to 9.2
[rhino]$ su - postgres [postgres]$ createuser rhino Shall the new user be allowed to create databases? (y/n) y Shall the new user be allowed to create more new users? (y/n) n CREATE USER 120
For PostgreSQL version 9.2 and later
[rhino]$ su - postgres [postgres]$ createuser -P -E -d -R rhino
Enter the password for the database user as prompted. (If you do not wish to configure a password, omit the
Configure access-control rules
Instructions for configuring access-control rules differ depending on whether Rhino SLEE and PostgreSQL are on the same or separate hosts:
Restart the server
Once these changes have been made, you must completely restart the PostgreSQL server.
To restart PostgreSQL, use one of the following:
An Apache Cassandra database is required if any of the following are true:
The Rhino SLEE will be using the pool clustering mode rather than the Savanna clustering mode.
A key/value store will be enabled for application state replication.
A session ownership store will be enabled to store application session ownership data.
Detailed instructions for the installation and configuration of Cassandra are outside the scope of this documentation. Contact your database administrator for assistance.