Deploying Rhino
Rhino installs from a single executable installer, and can be fully automated.
Applies to Rhino 9, 8, 7, 6
rhino_en-us_9.0.#####.#####.exe [Action] [Option] [Parameters]
Offline Installation:
If you are deploying in an environment where the client computers do not have internet access, follow these instructions for installing offline before deployment.
Command line options:
| Action | Description |
|---|---|
| -package | (default) install |
| -uninstall | uninstall |
| -repair | repair (or install if not installed) |
| -layout | create a local image of the bootstrapper for offline install |
| Option | Description |
| -quiet | perform action without any user interface. |
| if a reboot is required, system will restart without prompting | |
| -passive | perform action with progress bar interface |
| -norestart | suppress any restarts |
| -promptrestart | (default) prompt if a restart is required |
| Parameters | Description |
| All parameters are optional | |
| LICENSE_METHOD | One of: STANDALONE, ZOO (leave blank for Cloud Zoo) |
| LICENSE_KEY | The license key to install (required if LICENSE_METHOD=STANDALONE) |
| LICENSE_VALIDATION_CODE | Validation code for your Rhino license |
| ZOO_SERVER | IP or FQDN of Zoo server to query |
| INSTALLDIR | Full path to folder where Rhino will be installed |
| CUSTOMER_NAME | Customer name to show in splash screen |
| COMPANY_NAME | Company name to show in splash screen |
| SEND_STATISTICS | 1 = send anonymous installation statistics to McNeel (default) |
| 0 = do not send | |
| ENABLE_AUTOMATIC_UPDATES (New in Rhino 6.15) | 1 = allow the installer to check for and download updates. |
| 0 = do not allow automatic updates and sending usage statistics | |
| DISABLE_INTERNET_ACCESS (new in Rhino 6.15) | 1 = Disable all internet access for the installer, Rhino, and McNeel Updates. This disables all internet access from Rhino, including automatic updates detection and download, sending anonymous usage statistics, online help, splash screen news and tips, downloading of rendering textures, access to the Cloud Zoo, and other features that try to access the internet. |
| 0 (default) = allow all internet access |
Language Options
Rhino 9 ships with all languages, so the install options have been removed.
The language of the installer you downloaded will install by default unless set to 0. If you download the French installer and run it with only INSTALL_EN=1, you will get both English and French.
| Language Parameters | Description |
|---|---|
| INSTALL_EN | 1 = Install English |
| 0 = Do Not Install English | |
| INSTALL_CN | 1 = Install Simplified Chinese |
| 0 = Do Not Install Simplified Chinese | |
| INSTALL_CS | 1 = Install Czech |
| 0 = Do Not Install Czech | |
| INSTALL_DE | 1 = Install German |
| 0 = Do Not Install German | |
| INSTALL_ES | 1 = Install Spanish |
| 0 = Do Not Install Spanish | |
| INSTALL_FR | 1 = Install French |
| 0 = Do Not Install French | |
| INSTALL_IT | 1 = Install Italian |
| 0 = Do Not Install Italian | |
| INSTALL_JA | 1 = Install Japanese |
| 0 = Do Not Install Japanese | |
| INSTALL_KO | 1 = Install Korean |
| 0 = Do Not Install Korean | |
| INSTALL_PL | 1 = Install Polish |
| 0 = Do Not Install Polish | |
| INSTALL_PT | 1 = Install Portuguese |
| 0 = Do Not Install Portuguese | |
| INSTALL_RU | 1 = Install Russian |
| 0 = Do Not Install Russian | |
| INSTALL_TW | 1 = Install Traditional Chinese |
| 0 = Do Not Install Traditional Chinese |
Examples
rhino_en-us_9.#.#####.#####.exe -package -passive LICENSE_METHOD=ZOO ZOO_SERVER=10.0.0.1 INSTALL_FR=1 INSTALL_DE=1
- Install Rhino for Mac on one computer, and license it to use your LAN Zoo server.
- Rhino creates the license file
- Rhino 9:
Folder:/Users/Shared/McNeel/Rhinoceros/9.0/License Manager/Licenses/
File:9fd57e3c-6a27-4151-a408-e9c7487cbfc4.lic - Rhino 8:
Folder:/Users/Shared/McNeel/Rhinoceros/8.0/License Manager/Licenses/
File:868c63f5-3760-4a45-8600-5399cc57b47c.lic - Rhino 7:
Folder:/Users/Shared/McNeel/Rhinoceros/7.0/License Manager/Licenses/
File:59ff75c9-9c71-4ef8-a290-6b590f3fc63a.lic
- Rhino 9:
- Copy the whole license folder to the same location on the target computers.
- Set the file and folder permissions to match (chmod 644).
- Deploy Rhino to the target computers.
Notes:
- The License Manager folder also contains LicensesZooClient.Settings.xml, which holds the host name or IP address of your LAN Zoo server. Copying the whole folder deploys both. See How Does Rhino for Mac Find a LAN Zoo Server?
- LAN Zoo and Cloud Zoo license files are plain text and can be copied from one computer to another. Single-computer license files are encrypted and unique to each computer, so they can’t be deployed this way.
Testing a Scripted Install for Windows
Prepare for the Install
- If Rhino is already installed, uninstall it.
- Delete old license (.lic) files:
- LAN Zoo: C:\ProgramData\McNeel\Rhinoceros\6.0\License Manager\Licenses
- Cloud Zoo:
C:\Users\<user>\AppData\Roaming\McNeel\Rhinoceros\6.0\License Manager\Licenses, where<user>is the current user name.
- For easy updates, use your LAN Zoo server’s fully qualified domain name (FQDN) rather than its IP address.
Run the Test
-
Open the Windows Terminal app as Administrator. The scripted install requires administrator rights.
-
CD to the folder where the installer is located.
-
Run the scripted install. Below is an example LAN Zoo installation:
rhino_en-us_9.#.#####.#####.exe -package -norestart LICENSE_METHOD=ZOO ZOO_SERVER=your_zoo_server.your_domain.com -
Uninstall Rhino after every test run. While troubleshooting, consider leaving out -passive so you can see any messages from the installer (for example, “Rhino is already installed”).
- In a manual install, the license (.lic) file is created the first time Rhino runs.
- In a scripted install, the license file is created during installation, and Rhino starts without asking you to configure licensing.
- For a LAN Zoo, the license file is written to C:\ProgramData\McNeel\Rhinoceros\6.0\License Manager\Licenses.
Read How Does Rhino for Windows Find a LAN Zoo Server?.
Uninstalling Rhino for Windows
- Download the BurnOut.exe utility.
- Run BurnOut.exe with the ID for your version of Rhino:
- Rhino 9:
BurnOut.exe /uninstall {9FD57E3C-6A27-4151-A408-E9C7487CBFC4} - Rhino 8:
BurnOut.exe /uninstall {851D74A0-D029-4AC7-9CBE-E50455C24237} - Rhino 7:
BurnOut.exe /uninstall {F7D93B42-988E-462F-8D0B-4CFE68701F6D} - Rhino 6:
BurnOut.exe /uninstall {730997CF-7DB0-427E-A829-16BCCBCF569D}
- Rhino 9:
BurnOut finds and uninstalls every installation of that version of Rhino on the computer. It doesn’t remove per-user files created during or after installation.
