Guide to running Karamba3D with a network license. Network licenses are only available for companies or institutions. A network license can only be installed with the McNeel Zoo 6 License network server (only for Rhino7, Rhino6 or Rhino5 64bit).
You will have received a license package upon purchasing the license. Make sure to unblock the license package before unpacking it. Right click on the file in Windows Explorer and go to Properties. If the file is blocked, there will be an option to ‘Unblock’ the file at the bottom of the Properties Window. You may need to adjust your Administrator or Security settings to be able to unblock the file.
Unzip the contents of the network license package. It should contain the following files:
Open the Zoo Administrator. You will need administrator rights to perform this installation. The Zoo Administrator needs to be first stopped before installing the license. Make sure you do not have any existing Kamba3D licenses installed (If you are updating an existing license see below).
Click on the Stop Icon.
Select the Karamba3D license from the list of network licenses. Click the Delete License Icon. Make sure all users are not currently using the license otherwise you will not be able to remove them.
Copy the "Karamba3D_LicensePlugin_Zoo6.dll" into C:\Program Files (x86)\Zoo 6\Plugins folder. This can also be C:\Program Files (x86)\Zoo 6.0\Plugins folder.
Start the Zoo Service in the Zoo Administrator. Click on the Start Icon.
Click on the Add Product Icon or select Add from the Edit Menu.
A window will pop up where you can select "Karamba3D_ZooLicense" from the Product type. Enter your personal details for Registered owner and organisation. Both entries need to be filled in. The Product license code or CD key can be found in the ActivationKey.txt located in the ZIP package. This should be a 12 digit code. Click Add and the license should now be loaded.
If the "Karamba_ZooLicense" is not listed in the dropdown menu, close and reopen the Zoo Administrator and check if the file is located in the correct folder. Make sure the Zoo License Server is updated.
The license will be added and you will see the Karamba3D licenses in the list of Products.
Double click on the license to check the license status.
After the license has been installed on the server, you need to install the license file for each user:
Right click and select ‘Run as Administrator’. You will need to have administrator rights on your computer.
Type "Grasshopper" in the Command Line to load Grasshopper.
Place (drag and drop) the "License"-component on the grasshopper canvas. This can be found in the Karamba3D tab.
Right click on the red “K” icon or the "License" label. Select "Load license file" from the menu.
Locate the "XXX_License.lic" that you received in the license package. Click "Open" to load the license.
Close Rhino and Grasshopper and open Rhino once more, this time in standard mode.
Type "Karamba3DGetLicense" in the Command line
A window should pop up. Select "Use the Zoo".
Try to Detect the Zoo automatically. Often, you will need to enter the network name manually. Once the network has been found, click Continue.
The license will load from the zoo and the license information will be displayed in the Command Line.
Open Grasshopper and place the "License"-component onto the canvas and connect a panel to it. The panel displays the status and expiration of the license.
The Karamba3D license can simply be loaded by typing "Karamba3DGetLicense" each time Rhino loads, but this process can be automated in the Tools/Options -> Rhino Options/General.
Type "Karamba3DGetLicense" into the Command Lists textbox. The license will then be automatically loaded upon opening Rhino.
Upon successful installation of the license you should be able to open example files which have more than 20 beam elements or 50 shell elements. Double check if the license and correct Karamba3D version are installed by opening this check definition.
On a test machine, install Karamba3D.
Run Rhino and Karamba3D.
When prompted for a Karamba3D license, enter the name of your Zoo server.
Open this folder in Explorer: %allusersprofile%\McNeel\Rhinoceros\6.0\License Manager\Licenses
In this folder you should see at least two .lic files. The '55500d41-3a41-4474-99b3-684032a4f4df.lic' file is for Rhino 6. The other ('06bb1e79-5456-47a1-ad6d-111118cd894b.lic') should be for Karamba3D. Note, the file name will make the Id of the Karamba3D plug-in (Tools > Options > Plug-ins)
When using the Zoo, the license file is plain text and can be viewed from Notepad. It can also be copied from machine to machine.
So in addition to pushing out the required registry key, required by the Rhino licensing system to find the Zoo, copy the Karamba3D license folder - with the file 'licensePRO.lic' in it - to each machine.