License Check

There are two types of licenses used by Carbon in Houdini: the interactive (UI) license and the non-interactive (Batch) license.

When using floating licenses through a dedicated license server, it can be useful to understand the differences between these two types of license.

UI License

The Carbon interactive licenses are the less greedy of the two type of licenses, and are checked out per machine allowing you to run simultaneously multiple sessions without requiring additional licenses.

Note

This type of license can also allow the Carbon simulation to run in non-interactive sessions.

The license is only checked out when a Carbon Simulation node is cooked. This could happen at its creation or when a scene containing such a node is loaded.

Note

Loading a scene containing a Carbon Simulation node without using a Carbon license is still possible as long as the node has been saved in a bypassed state.

When no interactive license is available, the Carbon Simulation node will then fail to cook leaving the start geometry unchanged, and the following message will get displayed in the console output:

No SIM_CarbonTool license available. Please contact support@numerion-software.com to add/renew/install your licenses.

Batch License

The Carbon batch licenses are checked out per process, therefore two different non-interactive Houdini sessions running on the same machine will require two Carbon batch licenses.

Note

Loading a Houdini scene containing multiple Carbon Simulation nodes will still only use one license as both Carbon simulations will run within the same process.

When a non-interactive Houdini session runs a Carbon simulation (through hbatch or hython for example), batch licenses are always used first in preference to UI licenses. When no Carbon batch licenses are available, the Carbon simulation will then look for a Carbon UI license and use one if there is one available.

Running a Carbon simulation using hython when no Carbon licenses are available will trigger this python exception on the first frame of the simulation:

No SIM_CarbonTool_Batch license available.
No SIM_CarbonTool license available. Please contact support@numerion-software.com to add/renew/install your licenses.
Traceback (most recent call last):
  File "<console>", line 1, in <module>
  File "C:/PROGRA~1/SIDEEF~1/HOUDIN~1.291/houdini/python2.7libs\hou.py", line 6499, in cook
    return _hou.Node_cook(*args, **kwargs)
OperationFailed: The attempted operation failed.
Error while cooking.

Similarly in hbatch, the following text is returned (which is not technically a blocking error, since the opcook hscript command only returns text strings):

No SIM_CarbonTool_Batch license available.
No SIM_CarbonTool license available. Please contact support@numerion-software.com to add/renew/install your licenses.
Error cooking /obj/simulation/merge3

Automatic Check-in

After two hours of inactivity from the Carbon Solver (no cook on the Carbon Simulation node), all licenses will get automatically returned.

Note

If after that the Carbon simulation is re-started, it could fail if all licenses have been taken by other users in the meantime.