Karamba3D v1.3.3
English 英文
English 英文
  • Welcome to Karamba3D
  • 1: Introduction
    • 1.1: Installation
    • 1.2: Licenses
      • 1.2.1: Cloud Licenses
      • 1.2.2: Network Licenses
        • 1.2.2.1: Network license (archived)
      • 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: Physical Units
      • 2.4: Quick Component Reference
  • 3: In Depth Component Reference
    • 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: Line to Beam
      • 3.1.7: Connectivity to Beam
      • 3.1.8: Index to Beam
      • 3.1.9: Mesh to Shell
      • 3.1.10: Modify Element
      • 3.1.11: Point-Mass
      • 3.1.12: Disassemble Element
      • 3.1.13: Make Beam-Set 🔷
      • 3.1.14: Orientate Element
      • 3.1.15: Select Element
      • 3.1.16: Support
    • 3.2: Load
      • 3.2.1: Loads
      • 3.2.2: Disassemble Mesh Load
      • 3.2.3: Prescribed displacements
    • 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: Beam-Joint Agent 🔷
      • 3.3.6: Beam-Joints 🔷
      • 3.3.7: Eccentricity on Beam and Cross Section 🔷
      • 3.3.8: Modify Cross Section 🔷
      • 3.3.9: Cross Section Range Selector
      • 3.3.10: Cross Section Selector
      • 3.3.11: Cross Section Matcher
      • 3.3.12: Generate Cross Section Table
      • 3.3.13: Read Cross Section Table from File
    • 3.4: Material
      • 3.4.1: Material Properties
      • 3.4.2: Material Selection
      • 3.4.3: Read Material Table from File
      • 3.4.4: Disassemble Material 🔷
    • 3.5: Algorithms
      • 3.5.1: Analyze
      • 3.5.2: AnalyzeThII 🔷
      • 3.5.3: Analyze Nonlinear WIP
      • 3.5.4: Large Deformation Analysis
      • 3.5.5: Buckling Modes 🔷
      • 3.5.6: Eigen Modes
      • 3.5.7: Natural Vibrations
      • 3.5.8: Optimize Cross Section 🔷
      • 3.5.9: BESO for Beams
      • 3.5.10: BESO for Shells
      • 3.5.11: Optimize Reinforcement 🔷
      • 3.5.12: Tension/Compression Eliminator 🔷
    • 3.6: Results
      • 3.6.1: ModelView
      • 3.6.2: Deformation-Energy
      • 3.6.3: Nodal Displacements
      • 3.6.4: Principal Strains Approximation
      • 3.6.5: Reaction Forces 🔷
      • 3.6.6: Utilization of Elements 🔷
      • 3.6.7: BeamView
      • 3.6.8: Beam Displacements 🔷
      • 3.6.9: Beam Forces
      • 3.6.10: Resultant Section Forces
      • 3.6.11: ShellView
      • 3.6.12: Line Results on Shells
      • 3.6.13: Result Vectors on Shells
      • 3.6.14: Shell Forces
    • 3.7: Export 🔷
      • 3.7.1: Export Model to DStV 🔷
    • 3.8 Utilities
      • 3.8.1: Mesh Breps
      • 3.8.2: Closest Points
      • 3.8.3: Closest Points Multi-dimensional
      • 3.8.4: Cull Curves
      • 3.8.5: Detect Collisions
      • 3.8.6: Get Cells from Lines
      • 3.8.7: Line-Line Intersection
      • 3.8.8: Principal States Transformation 🔷
      • 3.8.9: Remove Duplicate Lines
      • 3.8.10: Remove Duplicate Points
      • 3.8.11: Simplify Model
      • 3.8.12: Element Felting 🔷
      • 3.8.13: Mapper 🔷
      • 3.8.14: Interpolate Shape 🔷
      • 3.8.15: Connecting Beams with Stitches 🔷
      • 3.8.16: User Iso-Lines and Stream-Lines
  • Troubleshooting
    • 4.1: Miscellaneous Questions and Problems
      • 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
      • 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: Hints on Reducing Computation Time
      • A.2.5: Natural Vibrations, Eigen Modes and Buckling
      • A.2.6: Approach Used for Cross Section Optimization
    • A.3: Bibliography
Powered by GitBook
On this page
  • Installation
  • 1. Unblock License Package
  • 2. Unzip License Package
  • 3. Zoo Administrator
  • 4. Move License Files
  • 5. Start Zoo Service
  • 6. Install License
  • 7. Copy Rhino Plugin Files
  • 8. Install Rhino Plugin
  • 9. Select Network Server
  • 11. Load License
  • 11. Automate License Load
  • 12. Check License Status
  • Check License
  • Perform a remote installation of the Zoo network license
  • Update an existing license
  • 1. Unblock License Package
  • 2. Unzip License Package
  • 3. Zoo Administrator
  • 4. Stop Zoo Server
  • 5. Replace License Files
  • 6. Start Zoo Service
  • 7. Install License
  • 8. Load License
  • 9. Automate License Load
  • 10. Check License Status

Was this helpful?

  1. 1: Introduction
  2. 1.2: Licenses
  3. 1.2.2: Network Licenses

1.2.2.1: Network license (archived)

Previous1.2.2: Network LicensesNext1.2.3: Temporary Licenses

Last updated 4 years ago

Was this helpful?

Guide to running Karamba3D with a network license. Network licenses are only available for companies or institutions.

This guide is for network licenses generated before 18/05/2020.

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

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 us should you wish to run your existing network licenses with Rhino6.

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.

Installation

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

  • Karamba_1_x_x_ZooPlugin.dll

  • Karamba_1_x_x_Rhino5Plugin.rhp

  • Karamba_1_x_x_Rhino6Plugin.rhp

  • README.txt

3. Zoo Administrator

Open the Zoo Administrator. The Zoo Administrator needs to be first stopped before installing the license. Click on the Stop Icon.

4. Move License Files

Copy the "Karamba_1_x_x_ZooPlugin.dll" into 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. 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.

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.

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.

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.

11. Load License

Close Rhino Options and in the Command Prompt type karamba.

The license will initialize and output the License information.

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.

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.

Check License

Restart Rhino and your PRO or EDU license should run.

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.

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

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.

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

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.

4. Stop Zoo Server

The Zoo Administrator needs to be first stopped before installing the license. Click on the Stop Icon.

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.

6. Start Zoo Service

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

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.

8. Load License

Open Rhino and in the Command Prompt type karamba.

The license will initialize and output the License information.

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.

10. Check License Status

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 .

The old Rhino plugin files will work with the new Zoo license. To reinstall the Rhino plugin see above.

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 .

check definition
email
Zoo6
Upgrade
Step 8
test script
installed