# 1.2.2.1: Network license (archived) Guide to running Karamba3D with a network license. Network licenses are only available for companies or institutions. {% hint style="danger" %} This guide is for network licenses generated before 18/05/2020. {% endhint %} {% hint style="info" %} If you are updating an existing network license, simply skip to the [Upgrade ](#update-an-existing-license)section. {% endhint %} A network license can only be installed with the **McNeel Zoo 6 License** network server (only for Rhino7, Rhino6 or Rhino5 64bit). Network licenses generated before **14.02.2018** run with **Rhino5 64 bit** only. Please [email](mailto:info@karamba3d.com) us should you wish to run your existing network licenses with Rhino6. {% hint style="info" %} 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. {% endhint %} ## **Installation** ### **1. Unblock License Package** Make sure you have Karamba3D [installed](https://manual-1-3.karamba3d.com/a.2-installation#standard-installation) and [Zoo6 ](https://wiki.mcneel.com/zoo/home)License Administrator installed. 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. ![](https://1646753513-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M9XteyGDAU3Odla53cC%2Fsync%2Fde2c44e0a28141170b1b0c3a78fba4a3e96fedef.jpg?generation=1591871185996009\&alt=media) ### **2. Unzip License Package** Unzip the contents of the network license package. It should contain the following files: * *ActivationKey.txt* * *Karamba\_1\_x\_x\_ZooPlugin.dll* * *Karamba\_1\_x\_x\_Rhino5Plugin.rhp* * *Karamba\_1\_x\_x\_Rhino6Plugin.rhp* * *README.txt* ![](https://1646753513-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M9XteyGDAU3Odla53cC%2Fsync%2F7264f61637f2674ab557e55dcb9df77867287ebf.jpg?generation=1591871187676642\&alt=media) ### **3. Zoo Administrator** Open the Zoo Administrator. The Zoo Administrator needs to be first stopped before installing the license. Click on the **Stop** Icon. ![](https://1646753513-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M9XteyGDAU3Odla53cC%2Fsync%2F2c3dca526ef19edc9ca326a15ed4274ab360b66a.jpg?generation=1591871187109387\&alt=media) ### **4. Move License Files** Copy the "***Karamba\_1\_x\_x\_ZooPlugin.dll"*** into *C:\Program Files (x86)\Zoo 6.0\Plugins* folder. ![](https://1646753513-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M9XteyGDAU3Odla53cC%2Fsync%2F789846ebed4be9d9c1cbc9e53a31122af63d0bd0.jpg?generation=1591871186122327\&alt=media) ### **5. Start Zoo Service** Start the Zoo Service in the Zoo Administrator. Click on the **Start** Icon. ![](https://1646753513-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M9XteyGDAU3Odla53cC%2Fsync%2Fa79f4429f85cf6bb389a72eb8fc0b673b7cd7336.jpg?generation=1591871187513462\&alt=media) ### **6. Install License** 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\_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. ![](https://1646753513-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M9XteyGDAU3Odla53cC%2Fsync%2Fa4252d0c41a1ed2c06dd5a9fb985682c76c4d108.jpg?generation=1591871186768168\&alt=media) ### **7. Copy Rhino Plugin Files** Copy the *"**Karamba\_1\_x\_x\_RhinoPlugin.rhp"*** into the **Plugins** folder of the Rhino installation on each of the computers which will use the licenses. This is typically *C:\Program Files\Rhino 6\Plug-ins*. or *C:\Program Files\Rhinoceros 5 (64-bit)\Plug-ins* or alternatively *C:\Program Files\Rhinoceros 5.0 (64-bit)\Plug-ins*. ![](https://1646753513-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M9XteyGDAU3Odla53cC%2Fsync%2Ffe48ef6475cd3839c1feaf1251659e21b3cc9c87.jpg?generation=1591871186010929\&alt=media) ### **8. Install Rhino Plugin** 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\_RhinoPlugin.rhp"*** file in the Plug-ins Folder. ![](https://1646753513-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M9XteyGDAU3Odla53cC%2Fsync%2Fd2c88482b84c8c8b88d01be53a7a4edad22b9551.jpg?generation=1591871186725876\&alt=media) ### **9. Select Network Server** 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. ![](https://1646753513-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M9XteyGDAU3Odla53cC%2Fsync%2F14550cde4d358948a13bd2436c5092fac663f81c.jpg?generation=1591871187057299\&alt=media) ### **11. Load License** Close Rhino Options and in the Command Prompt type **karamba**. ![](https://1646753513-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M9XteyGDAU3Odla53cC%2Fsync%2Fc77db8bea851462f7d0246804bfe8dd28bc5c5af.jpg?generation=1591871187450121\&alt=media) The license will initialize and output the License information. ![](https://1646753513-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M9XteyGDAU3Odla53cC%2Fsync%2Fafddf212615d3afb0df73ad003ee83c99b37a638.jpg?generation=1591871186542583\&alt=media) ### **11. Automate License Load** The Karamba3D 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. ![](https://1646753513-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M9XteyGDAU3Odla53cC%2Fsync%2Fe889da890a4ee62253adeca490b9af4950a2675e.jpg?generation=1591871187734563\&alt=media) ### **12. Check License Status** Place the **"License"**-component onto the grasshopper canvas and connect a panel to it. The panel displays the status and expiration of the license. ![](https://1646753513-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M9XteyGDAU3Odla53cC%2Fsync%2Fa09a4a9c6e66fa9a3ffe5b33876e2372fc05726a.jpg?generation=1591871188271026\&alt=media) ## **Check License** Restart Rhino and your ***PRO*** or ***EDU*** license should run. 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](https://www.karamba3d.com/download/pro-license-check/?wpdmdl=4987\&masterkey=58592ba49301d). ![](https://1646753513-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M9XteyGDAU3Odla53cC%2Fsync%2F667180dfbf17fde90a97ed36f138f4401727086e.jpg?generation=1591871186759034\&alt=media) ## **Perform a remote installation of the Zoo network license** 1. On a test machine, install Karamba3D. 2. Run Rhino and Karamba3D. 3. When prompted for a Karamba3D license, enter the name of your Zoo server. 4. Close Rhino. 5. Open this folder in Explorer: *%allusersprofile%\McNeel\Rhinoceros\6.0\License Manager\Licenses* 6. 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 should be for Karamba3D. Note, the file name will make the Id of the Karamba3D plug-in (Tools > Options > Plug-ins) 7. 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. 8. So in addition to pushing out the required registry key, required by the Rhino licensing system to find the Zoo, copy the Karamba3D license file to each machine. {% hint style="info" %} Rhino 7 licenses are stored also in the Rhino 6 folder. {% endhint %} ## **Update an existing license** ### **1. Unblock License Package** You will have received a new license package. 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. ![](https://1646753513-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M9XteyGDAU3Odla53cC%2Fsync%2Fde2c44e0a28141170b1b0c3a78fba4a3e96fedef.jpg?generation=1591871185996009\&alt=media) ### **2. Unzip License Package** Unzip the contents of the network license package. It should contain the following files: * *ActivationKey.txt* * *Karamba\_1\_x\_x\_ZooPlugin.dll* * *Karamba\_1\_x\_x\_Rhino5Plugin.rhp* * *Karamba\_1\_x\_x\_Rhino6Plugin.rhp* * *README.txt* ![](https://1646753513-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M9XteyGDAU3Odla53cC%2Fsync%2F7264f61637f2674ab557e55dcb9df77867287ebf.jpg?generation=1591871187676642\&alt=media) ### **3. Zoo Administrator** Open the Zoo Administrator. Select the *"**Karamba 1.x.x License"*** from the list of network licenses. Click the **Delete License** Icon. ![](https://1646753513-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M9XteyGDAU3Odla53cC%2Fsync%2Fdd70e6a2aea97ae1185d337d852cd10e471b9d13.jpg?generation=1591871186536557\&alt=media) ### **4. Stop Zoo Server** The Zoo Administrator needs to be first stopped before installing the license. Click on the **Stop** Icon. ![](https://1646753513-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M9XteyGDAU3Odla53cC%2Fsync%2F2c3dca526ef19edc9ca326a15ed4274ab360b66a.jpg?generation=1591871187518974\&alt=media) ### **5. Replace License Files** Copy the *"**Karamba\_1\_x\_x\_ZooPlugin.dll"*** into *C:\Program Files (x86)\Zoo 6.0\Plugins* folder. Make sure to replace the existing file. ![](https://1646753513-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M9XteyGDAU3Odla53cC%2Fsync%2F789846ebed4be9d9c1cbc9e53a31122af63d0bd0.jpg?generation=1591871186122327\&alt=media) ### **6. Start Zoo Service** Start the Zoo Service in the Zoo Administrator. Click on the **Start** Icon. ![](https://1646753513-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M9XteyGDAU3Odla53cC%2Fsync%2Fa79f4429f85cf6bb389a72eb8fc0b673b7cd7336.jpg?generation=1591871187513462\&alt=media) ### **7. Install License** 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\_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. ![](https://1646753513-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M9XteyGDAU3Odla53cC%2Fsync%2Fa4252d0c41a1ed2c06dd5a9fb985682c76c4d108.jpg?generation=1591871186490877\&alt=media) ### **8. Load License** The old Rhino plugin files will work with the new Zoo license. To reinstall the Rhino plugin see [Step 8](https://manual-1-3.karamba3d.com/1-introduction/1.2-licenses/1.2.2-network-licenses/..#8-install-rhino-plugin) above. Open Rhino and in the Command Prompt type **karamba**. ![](https://1646753513-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M9XteyGDAU3Odla53cC%2Fsync%2Fc77db8bea851462f7d0246804bfe8dd28bc5c5af.jpg?generation=1591871187332595\&alt=media) The license will initialize and output the License information. ![](https://1646753513-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M9XteyGDAU3Odla53cC%2Fsync%2Fafddf212615d3afb0df73ad003ee83c99b37a638.jpg?generation=1591871186542583\&alt=media) ### **9. Automate License Load** The Karamba3D 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. ![](https://1646753513-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M9XteyGDAU3Odla53cC%2Fsync%2Fe889da890a4ee62253adeca490b9af4950a2675e.jpg?generation=1591871188041068\&alt=media) ### **10. Check License Status** Place the **"License"**-component onto the grasshopper canvas and connect a panel to it. The panel displays the status and expiration of the license. Additional checks can be performed with the [test script](https://manual-1-3.karamba3d.com/1-introduction/1.2-licenses/1.2.2-network-licenses/..#check-license). ![](https://1646753513-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M9XteyGDAU3Odla53cC%2Fsync%2Fa09a4a9c6e66fa9a3ffe5b33876e2372fc05726a.jpg?generation=1591871188152461\&alt=media)