Check Hardware and Operating System Prerequisites

Rhino SDK requires a platform capable of running Oracle’s JDK or OpenJDK for Java Standard Edition (SE) 11 or 17 and scripts written for the Bash shell.

The system requirements for running Java can be found on www.oracle.com.

The Bash shell is available on the majority of UNIX distributions and can be run on Windows using the Windows Subsystem for Linux.

Note The Rhino SDK has been tested on Red Hat, CentOS and Ubuntu Linux distributions and the WSL variant of Ubuntu Linux. No support is provided for running Rhino on other UNIX systems, although it is expected that the Rhino SDK will function on any POSIX system that can run a compatible JDK.

Install Java

Follow the instructions on docs.oracle.com for installing Java. Ensure you download and install the JDK not the JRE. The JRE does not contain all the tools needed to run Rhino.

Warning Check the Rhino Compatibility Guide to ensure Rhino 3.2 is supported on your version of Java.

Install System Utilities

To install the Rhino SDK a program capable of unzipping the SDK archive is required. The installation instructions assume the use of the unzip utility.

Set the JAVA_HOME environment variable (Optional)

You can set the JAVA_HOME environment variable to point to your Java installation, or you can specify the Java home directory the first time you start the Rhino SDK. It is useful to export this variable to ensure it is available to all scripts and subshells and add it to your user config ~/.profile to make it available in future login sessions. Similarly, the path $JAVA_HOME/bin is useful in the PATH environment variable for running Java based development tools.

export JAVA_HOME="<path to installed jdk>"
export PATH="$JAVA_HOME/bin:$PATH"

Configure Network Features

Before installing Rhino, ensure that:

  • the system has an IP address and is visible on the network.

  • the system can resolve localhost to the loopback interface, and that the host name of the machine resolves to an external IP address, not a loopback address.

Download Installation Files

To install the Rhino SDK, download its installation package.

If you want to use the Rhino Element Manager (REM) to manage the SDK, download the relevant REM installation package as well.

Two versions of REM are available:

  • The standalone version: This version runs independently and works with both the SDK and the production versions of Rhino TAS.

  • The embeddable version: This version only runs inside the Rhino SDK. It doesn’t support the production version of Rhino. To use it in Rhino SDK 3.1 or later, you must manually embed the REM files into the SDK.

Make sure that you download the installation package for the version of REM you need.

Previous page Next page