To begin the Rhino installation:


Unpack the Rhino tar file

The Rhino SLEE comes as an uncompressed tar file. To unpack it, use the tar command:

$ tar xvf rhino-install-x.x.x.tar

This creates the distribution directory, rhino-install, in the current working directory.

Warning The rhino-install distribution directory is temporary — you create the actual program directory as part of the installation. You may remove rhino-install, if it is no longer required, after the installation is complete.
$ cd rhino-install


Read the release notes

Be sure to read any instructions and changes included with your release of Rhino.

  • Rhino Changelog - what’s changed between the previous version of Rhino and this one.


Gather information required for installation

The Rhino installation will prompt for the following information:

Parameter Default Comment

Database settings

The Rhino SLEE install requires access to a PostgreSQL database server for storing persistent configuration and deployment information. The database settings you enter here are required for the Rhino SLEE config files. The install script can optionally configure the database for you — you will be prompted for this later in the install process.

Postgres host


Postgres port


Postgres user


Postgres password

Database name


Will be created in your Postgres server and configured with the default tables for Rhino SLEE support.

Session ownership

The Rhino SLEE provides an optional session ownership facility backed by a Cassandra database cluster. See Replication Support Services for more information.

Enable Session Ownership Facility?


This will enable (True) or disable (False) this facility for the default namespace.

Replicated storage

The Rhino SLEE can optionally use an external key value store backed by a Cassandra database cluster for its replicated storage. See Replication Support Services for more information.

Replicated storage resource


This will configure the default namespace to use either the DomainedMemoryDatabase or the Cassandra-backed KeyValueDatabase.

Cassandra database settings

These questions will only be asked if the session ownership facility has been enabled or the KeyValueDatabase has been selected as the replicated storage resource.

Cassandra contact points


Comma-separated list of contact points (as host:port pairs) for your Cassandra database cluster.

Cassandra local datacentre name


The name of the local datacentre present at the specified contact points.

General Rhino configuration

Directory to install Rhino SLEE


Where to install Rhino (~ = the user’s home directory on Linux/Unix).

Location of license


The Rhino SLEE requires a license file. Please enter the full path to your license file. You may skip this step by entering '-', but you will need to manually copy the license file to the Rhino SLEE installation directory.

Management interface remote method invocation (RMI) registry port


Used for accessing the Management MBeans from a Java RMI client, such as the Rhino command-line utilities.

Interface JMX remote service port


Used for accessing the JMX remote server. REM uses this for remote management.

Interface JMX remote service port (for SSL)


Used for accessing the JMX remote server via SSL. REM uses this for remote management.

Profile snapshot base port


The profile snapshot utility (client/bin/rhino-snapshot) requires a range of ports to operate correctly. The ports in this range are tested sequentially (starting at the base port) until a non-conflicting port is successfully bound. The bound port is later queried by the snapshot client via JMX to determine where to collect snapshot data from. In almost all cases, the default port will be suitable.

Java installation directory

Value of the JAVA_HOME environment variable (if it is set)

Location of your Java J2SE/JDK installation. (see Install Required Software).

Java heap size


An argument passed to the JVM to specify the amount of main memory (in megabytes) which should be allocated for running Rhino. To prevent extensive disk swapping, this should be set to less than the total physical memory installed in the machine.

Cluster configuration

Cluster communication mode


Networking implementation to send clustering traffic over. One of MULTICAST or SCATTERCAST.

Cluster ID


An integer ID that uniquely identifies this cluster.

Multicast configuration

These questions will only be asked if MULTICAST has been selected for the cluster communication mode.

Address Pool Start

A pool of multicast addresses that will be used for group communication by Rhino services.

Address Pool End

Scattercast configuration

These questions will only be asked if SCATTERCAST has been selected for the cluster communication mode.

Scattercast Base Port


Base port used for automatic endpoint port assignment in scattercast mode

Scattercast Port Offset


Offset used for automatic endpoint port assignment in scattercast mode

Scattercast Initial Endpoints

The scattercast initial endpoints, specified in the format: <node,ip-address[,port]>* As an example: 101, 102, 103,,12500 In this example node 101 will use the defined Base Port and offset for the port (e.g. 12000 - offset + nodeID = 12000) and node 102 is doing the same (e.g. 12000 - offset + nodeID = 12001). Node 103 has explicitly set the port to 12500.

Previous page Next page