Network Licenses

Please note that all network licenses generated before 19.08.2015 run with Zoo 5.0 only.

Licenses generated after 19.08.2015 run with Zoo 6.0 only.

A guide to installing your STUDENT or PRO network license for Karamba.

  1. A network license can only be installed with the McNeel Zoo License network server (only for Rhino5 64bit and McNeel Zoo 6.0).
    Download and install Zoo 6.0 from wiki.mcneel.com/zoo/home.
  2. Install the latest version of grasshopper from grasshopper3d.com.
  3. Download the latest karamba and install the FULL version.


    Make sure it is installed in the Plugins folder of the Rhino installation. This is often C:\Program Files\Rhinoceros 5.0 (64-bit)\Plug-ins, however it can also be C:\Program Files\Rhinoceros 5 (64-bit)\Plug-ins. Make sure the folders correlate otherwise Karamba will not appear in Grasshopper.
  4. Unzip the contents of the network license package. It should contain 4 files.
    – ActivationKey.txt
    – Karamba_1_x_x.rhp
    – Karamba_1_x_x_ZooPlugin.dll
    – README.txt
  5. Open the Zoo Administrator. The Zoo Administrator needs to be first stopped before installing the license. Click on the Stop Icon.

  6. Copy the Karamba_1_x_x_ZooPlugin.dll into C:\Program Files (x86)\Zoo 6.0\Plugins folder.

    karamba3d-zoo_3
  7. Make sure that the file is not blocked by the computer for security reasons. Right click on the file and go to Properties. At the bottom of the window there a button to Unblock the file.

    karamba3d-zoo_4
  8. Start the Zoo Service in the Zoo Administrator. Click on the Start Icon.

    karamba3d-zoo_5
  9. Click on the Add Product Icon or select Add from the Edit Menu. A window will pop up where you can select Karamba_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 OK and the license should now be loaded.
    If the Karamba_Zoo License 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. If the Activation Key does not work, please email us at [email protected]

    karamba3d-zoo_6
  10. Copy the Karamba_1_x_x.rhp into the Plugins folder of the Rhino 5 installation on each of the computers which will use the licenses. This is typically C:\Program Files\Rhinoceros 5 (64-bit)\Plug-ins.


    karamba3d-zoo_7
  11. Open Rhino and open the Plug-ins Manager in Rhino Options (Tools/Options/Rhino Options/Plug-ins). Click on Install and select the Karamba_1_x_x.rhp in the Plug-ins Folder.

    karamba3d-zoo_8
  12. A window will pop up to initiate the plugin. Select the Network Node and either select Detect Zoo Server automatically or enter you Zoo server name in the Use the following Zoo Server:. Select Test Connectivity and another window will pop up to confirm a successful license installation.

    karamba3d-zoo_9
  13. Close Rhino Options and in the Command Prompt type karamba.

    karamba3d-zoo_11
  14. The license will initialize and output the License information.

    karamba3d-zoo_12
  15. The Karamba license can simply be loaded by typing karamba each time Rhino loads, but this process can be automated in the Tools/Options/Rhino Options/General. Type karamba into the Command Lists textbox. The license will then be automatically loaded upon opening Rhino.

    karamba3d-zoo_13
  16. The Karamba license should now be successfully installed and all functions of the PRO or STUDENT versions are available. To check this, place a Karamba License component onto the Grasshopper canvas and plug it into a Panel.

    karamba3d-zoo_14
  17. 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 Karamba version are installed by opening this check definition.

  18. If you have any troubles installing your license file, please email us at [email protected] or see our Support page.

 

A license includes all updates for a period of one year after purchase. Purchase a karamba3d PRO or STUDENT license now if you haven’t already. The PRO-Unlimited version can be updated after one year at a reduced cost (depending on the amount of additional program features made available).

To run Karamba with a standalone license, see the guide in installing standalone licenses.

Contact

Email

For licensing or purchasing enquires please send us an email:

[email protected] karamba3d.com

Contact us if you would like to use karamba for teaching at your university or institution, or if you are interested in setting up a karamba workshop.

 

Discussions

For user support and questions about developing your scripts see the

Grasshopper Forums

You can search for or share your questions or problems with the large Grashopper community.