Activate License

This page explains how to activate the license you obtained. Tunny licenses come in two types, floating and node-locked. Each is described below in turn.

The license is checked when the Tunny UI window is opened. Activating the license after the window is already open does not change the result of that check. If you forget to obtain the license, close the Tunny UI window, run the TunnyGetLicense command, and open it again.

To apply for a LAN Zoo or Node-Locked license, you need to submit your Machine ID with your application. For a LAN Zoo license this is the machine ID of the PC that acts as the server, and for a Node-Locked license it is the machine ID of the PC where you use Tunny.

The easiest way to get the Machine ID is the TunnySaveMachineId command, which saves it to a file. See the Rhino Commands page for details. The Machine ID is the MachineGuid value under HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Cryptography on Windows, so you do not necessarily need to use the TunnySaveMachineId command if you can obtain that value.

Floating License

A floating license is managed by a license server and can be shared across multiple machines. There are two options depending on where the server runs: Cloud Zoo and LAN Zoo.

With a floating license, running the TunnyGetLicense command in Rhino activates the license in Grasshopper. Registering the license on the server alone does not make Grasshopper recognize it, so do not forget to run this command.

Cloud Zoo

Cloud Zoo manages licenses with the Rhino Cloud Zoo server provided by McNeel. Activation is a two-step process: register the license in your Rhino account, and then reflect it in Grasshopper.

First, use the given license code starting with TUNY- to register the Tunny license in your Rhino account.

LAN Zoo

LAN Zoo manages licenses with a Zoo server on your local network instead of Cloud Zoo. Even in environments with restricted outbound internet access, you can share licenses within your organization by hosting the license server yourself.

To use LAN Zoo, install the Zoo server on one machine in your network, and add the given license code to it with the Zoo administration tool. See McNeel's LAN Zoo documentation for how to set up the server and add licenses.

Next, select LAN Zoo as the license method in Rhino on each client, and specify the host name or IP address of the Zoo server. Running the TunnyGetLicense command after that reflects the LAN Zoo license in Grasshopper.

Place the license file along with the TunnyZoo.dll and TunnyZoo.pdb files in the Plugins folder of the Zoo server. Then enter the license code in the Zoo server app, and it is verified against the license file.

Node-Locked License

A node-locked license is tied to a specific machine, so it can be used in environments with restricted internet access.

The rights.fishing file is the license file for a node-locked license. Saving this file in the [USERPROFILE]\.tunny_env directory authenticates the license automatically.