Before installing the Rhino SDK, you need to:
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.
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.
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.