To begin the Rhino installation:

1
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

2
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.

3
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

 
 localhost

Postgres port

 
 5432

Postgres user

 
 user

Postgres password

 










Database name




 rhino




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?




 False




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




 DomainedMemoryDatabase




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




 localhost




Comma-separated list of contact points for your Cassandra database cluster.










Cassandra port




 9042




The port that your Cassandra database cluster is configured to listen on.








General Rhino configuration








Directory to install Rhino SLEE




 ~/rhino




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




 1199




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










Interface JMX remote service port




 1202




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










Interface JMX remote service port (for SSL)




 1203




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










Profile snapshot base port




 22000




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




 1024




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




 MULTICAST




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










Cluster ID




 100




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




 224.0.50.1




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










Address Pool End




 224.0.50.8








Scattercast configuration








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










Scattercast Base Port




 12000




Base port used for automatic endpoint port assignment in scattercast mode










Scattercast Port Offset




 101




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,192.168.1.1 102,192.168.1.2 103,192.168.1.3,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