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

Postgres host

localhost

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

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

Address Pool Start
(MULTICAST only)

224.0.50.1

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

Address Pool End
(MULTICAST only)

224.0.50.8

Scattercast Base Port
(SCATTERCAST only)

12000

Base port used for automatic endpoint port assignment in scattercast mode

Scattercast Port Offset
(SCATTERCAST only)

101

Offset used for automatic endpoint port assignment in scattercast mode

Scattercast Initial Endpoints
(SCATTERCAST only)

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