Karamba3D v3
  • Welcome to Karamba3D
  • New in Karamba3D 3.1
  • See Scripting Guide
  • See Manual 2.2.0
  • 1 Introduction
    • 1.1 Installation
    • 1.2 Licenses
      • 1.2.1 Cloud Licenses
      • 1.2.2 Network Licenses
      • 1.2.3 Temporary Licenses
      • 1.2.4 Standalone Licenses
  • 2 Getting Started
    • 2 Getting Started
      • 2.1 Karamba3D Entities
      • 2.2 Setting up a Structural Analysis
        • 2.2.1 Define the Model Elements
        • 2.2.2 View the Model
        • 2.2.3 Add Supports
        • 2.2.4 Define Loads
        • 2.2.5 Choose an Algorithm
        • 2.2.6 Provide Cross Sections
        • 2.2.7 Specify Materials
        • 2.2.8 Retrieve Results
      • 2.3 The Karamba3D Menu
      • 2.4 User Settings
      • 2.5 Physical Units
      • 2.6 Asynchronous Execution of Karamba3D Components
      • 2.7 Quick Component Reference
  • 3 In Depth Component Reference
    • 3.0 Settings
      • 3.0.1 License
    • 3.1 Model
      • 3.1.1 Assemble Model
      • 3.1.2 Disassemble Model
      • 3.1.3: Modify Model
      • 3.1.4: Connected Parts
      • 3.1.5: Activate Element
      • 3.1.6 Create Linear Element
        • 3.1.6.1 Line to Beam
        • 3.1.6.2 Line to Truss
        • 3.1.6.3 Connectivity to Beam
        • 3.1.6.4: Index to Beam
      • 3.1.7 Create Surface Element
        • 3.1.7.1: Mesh to Shell
        • 3.1.7.2: Mesh to Membrane
      • 3.1.8: Modify Element
      • 3.1.9: Point-Mass
      • 3.1.10: Disassemble Element
      • 3.1.11: Make Element-Set
      • 3.1.12: Orientate Element
      • 3.1.13: Dispatch Elements
      • 3.1.14: Select Elements
      • 3.1.15: Support
    • 3.2: Load
      • 3.2.1: General Loads
      • 3.2.2: Beam Loads
      • 3.2.3: Disassemble Mesh Load
      • 3.2.4 Load-Case-Combinations
        • 3.2.5.1 Load-Case-Combinator
        • 3.2.5.2 Disassemble Load-Case-Combinaton
        • 3.2.5.3 Load-Case-Combination Settings
    • 3.3: Cross Section
      • 3.3.1: Beam Cross Sections
      • 3.3.2: Shell Cross Sections
      • 3.3.3: Spring Cross Sections
      • 3.3.4: Disassemble Cross Section
      • 3.3.5: Eccentricity on Beam and Cross Section
      • 3.3.6: Modify Cross Section
      • 3.3.7: Cross Section Range Selector
      • 3.3.8: Cross Section Selector
      • 3.3.9: Cross Section Matcher
      • 3.3.10: Generate Cross Section Table
      • 3.3.11: Read Cross Section Table from File
    • 3.4: Joint
      • 3.4.1: Beam-Joints
      • 3.4.2: Beam-Joint Agent
      • 3.4.3: Line-Joint
    • 3.5: Material
      • 3.5.1: Material Properties
      • 3.5.2: Material Selection
      • 3.5.3: Read Material Table from File
      • 3.5.4: Disassemble Material
    • 3.6: Algorithms
      • 3.6.1: Analyze
      • 3.6.2: AnalyzeThII
      • 3.6.3: Analyze Nonlinear WIP
      • 3.6.4: Large Deformation Analysis
      • 3.6.5: Buckling Modes
      • 3.6.6: Eigen Modes
      • 3.6.7: Natural Vibrations
      • 3.6.8: Optimize Cross Section
      • 3.6.9: BESO for Beams
      • 3.6.10: BESO for Shells
      • 3.6.11: Optimize Reinforcement
      • 3.6.12: Tension/Compression Eliminator
    • 3.7 Results
      • 3.7.1 General Results
        • 3.7.1.1 ModelView
        • 3.7.1.2 Result Selector
        • 3.7.1.3 Deformation-Energy
        • 3.7.1.4 Element Query
        • 3.7.1.5 Nodal Displacements
        • 3.7.1.6 Principal Strains Approximation
        • 3.7.1.7 Reaction Forces
        • 3.7.1.8 Utilization of Elements
        • 3.7.1.9 ReactionView
      • 3.7.2 Results on Beams
        • 3.7.2.1 BeamView
        • 3.7.2.2 Beam Displacements
        • 3.7.2.3 Beam Forces
        • 3.7.2.4 Node Forces
      • 3.7.3 Results on Shells
        • 3.7.3.1 ShellView
        • 3.7.3.2 Line Results on Shells
        • 3.7.3.3 Result Vectors on Shells
        • 3.7.3.4 Shell Forces
        • 3.7.3.5 Shell Sections
    • 3.8 Export
      • 3.8.1 Export Model to DStV
      • 3.8.2 Json/Bson Export and Import
      • 3.8.3 Export Model to SAF
      • 3.8.4 Export/Import Model to and from Speckle (WIP)
    • 3.9 Utilities
      • 3.9.1: Mesh Breps
      • 3.9.2: Closest Points
      • 3.9.3: Closest Points Multi-dimensional
      • 3.9.4: Cull Curves
      • 3.9.5: Detect Collisions
      • 3.9.6: Get Cells from Lines
      • 3.9.7: Line-Line Intersection
      • 3.9.8: Principal States Transformation
      • 3.9.9: Remove Duplicate Lines
      • 3.9.10: Remove Duplicate Points
      • 3.9.11: Simplify Model
      • 3.9.12: Element Felting
      • 3.9.13: Mapper
      • 3.9.14: Interpolate Shape
      • 3.9.15: Connecting Beams with Stitches
      • 3.9.16: User Iso-Lines and Stream-Lines
      • 3.9.17: Cross Section Properties
      • 3.9.18 Surface To Truss
    • 3.10 Parametric UI
      • 3.10.1: View-Components
      • 3.10.2: Rendered View
  • Troubleshooting
    • 4.1: Miscellaneous Questions and Problems
      • 4.1.0: FAQ
      • 4.1.1: Installation Issues
      • 4.1.2: Purchases
      • 4.1.3: Licensing
      • 4.1.4: Runtime Errors
      • 4.1.5: Definitions and Components
      • 4.1.6: Default Program Settings
    • 4.2: Support
  • Appendix
    • A.1: Release Notes
      • Work in Progress Versions
      • Older Versions
      • Version 2.2.0
      • Version 2.2.0 WIP
      • Version 1.3.3
      • Version 1.3.2 build 190919
      • Version 1.3.2 build 190731
      • Version 1.3.2 build 190709
      • Version 1.3.2
    • A.2: Background information
      • A.2.1: Basic Properties of Materials
      • A.2.2: Additional Information on Loads
      • A.2.3: Tips for Designing Statically Feasible Structures
      • A.2.4: Performance Optimization in Karamba3D
      • A.2.5: Natural Vibrations, Eigen Modes and Buckling
      • A.2.6: Approach Used for Cross Section Optimization
    • A.3: Workflow Examples
    • A.4: Bibliography
Powered by GitBook
On this page
  • Installation on Server End
  • 1. Unblock License Package
  • 2. Unzip License Package
  • 3. Zoo Administrator
  • 4. Move License Files
  • 5. Start Zoo Service
  • 6. Add License
  • 7. Enter License Key
  • 8. License Loaded
  • 9. Check License Status
  • Installation on Client End (User)
  • 1. Run Rhino as Administrator
  • 2. Load Grasshopper
  • 3. Locate License Component
  • 4. Load License
  • 5. Locate the License File
  • 6. Load License
  • 7. Restart Rhino
  • 8. Fetch the license
  • 9. Load Zoo License
  • 10. Locate Zoo Server
  • 11. License Loaded
  • 12. Check License Status
  • 13. Automate License Load
  • Check License
  • Perform a remote installation of the Zoo network license
  • Installation on Server End
  • Installation on Client End
  • Error Message: The product ID is not correct
  1. 1 Introduction
  2. 1.2 Licenses

1.2.2 Network Licenses

Previous1.2.1 Cloud LicensesNext1.2.3 Temporary Licenses

Last updated 6 months ago

Guide to running Karamba3D with a network license (PRO or LAB users only); also known as LAN Zoo. A network license can only be installed with the McNeel Zoo 6 (or 7) License network server (only for Rhino7 or Rhino6). Find out more on on McNeel.

If you are updating an existing network license, simply skip to the section.

For network licenses generated before 18/05/2020 please refer to this .

Installation on Server End

1. Unblock License Package

Make sure you have Karamba3D and 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.

2. Unzip License Package

Unzip the contents of the network license package. It should contain the following files:

  • ActivationKey.txt

  • Karamba3D_LicensePlugin_Zoo6.dll

  • README.txt

  • XXX_License.lic

3. Zoo Administrator

Click on the Stop Icon.

Remove Existing Licenses

If you are updating an existing network license.

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.

4. Move License Files

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.

5. Start Zoo Service

Start the Zoo Service in the Zoo Administrator. Click on the Start Icon.

6. Add License

Click on the Add Product Icon or select Add from the Edit Menu.

7. Enter License Key

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.

8. License Loaded

The license will be added and you will see the Karamba3D licenses in the list of Products.

9. Check License Status

Double click on the license to check the license status.

Installation on Client End (User)

After the license has been installed on the server, you need to install the license file for each user:

1. Run Rhino as Administrator

Right click and select ‘Run as Administrator’. You will need to have administrator rights on your computer.

2. Load Grasshopper

Type "Grasshopper" in the Command Line to load Grasshopper.

3. Locate License Component

Place (drag and drop) the "License"-component on the grasshopper canvas. This can be found in the Karamba3D tab.

4. Load License

Right click on the red “K” icon or the "License" label. Select "Load license file" from the menu.

5. Locate the License File

Locate the "XXX_License.lic" that you received in the license package. Click "Open" to load the license.

6. Load License

7. Restart Rhino

Close Rhino and Grasshopper and open Rhino once more, this time in standard mode.

8. Fetch the license

Type "Karamba3DGetLicense" in the Command line

9. Load Zoo License

A window should pop up. Select "Use the Zoo".

10. Locate Zoo Server

Try to Detect the Zoo automatically. Often, you will need to enter the network name manually. Once the network has been found, click Continue.

11. License Loaded

The license will load from the zoo and the license information will be displayed in the Command Line.

12. Check License Status

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.

13. Automate License Load

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.

Congratulations, the license has been successfully installed and you are free to use the full features of Karamba3D!

Make sure to run the "Karamba3DGetLicense" command opening Grasshopper.

Check License

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 the below definition:

Perform a remote installation of the Zoo network license

Installation on Server End

  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 ('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)

  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.

Rhino 7 licenses are stored also in the Rhino 6 folder.

Installation on Client End

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. This is typically C:\Program Files\Rhino 6\Plug-ins\Karamba\License

Open Rhino, use "Karamba3DGetLicense" to request a license, and when prompted, enter your server name or IP address.

Error Message: The product ID is not correct

Should you receive the following error message, check that the licensePRO.lic file has been properly installed, and that you are directing to the correct IP address.

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 ).

The license should be successfully copied. If the license does not load successfully, make sure that you have the files as well as opened Rhino as .

below
unblocked
administrator
LAN Licenses
guide
Zoo6 (or above)
Upgrade
installed
27KB
LicenseTest.gh