|On this page|
You can use the hkey application to view and manage licenses and license server options using a graphical user interface. This utility lets you perform the same actions from the command line, allowing you to automate license server setup.
The Non-Graphical Houdini License Administrator requires all connected license servers version to be 18.0.287 or greater.
Sesictrl is moving towards a more svn style command line interface where you specify a command and its corresponding options. To obtain help information about a specific command run
sesictrl <command> --help. If you need help information from the legacy sesictrl interface enter
sesictrl --legacy-help into the terminal.
Test whether a sesinetd server is reachable.
Print all the licenses found on a connected sesinetd server. This is similar to legacy options
Print server information about all connected sesinetd servers. This is similar to legacy option
Install a license key string to a connected sesinetd server. This option is similar to legacy option
Manually redeem entitlements. A list of entitlements and their quantities can be specified. If no entitlements are specified then all the available entitlements will be presented with the available options to redeem entitlements. This option is similar to legacy option
Remove a server code from the connected server. This option is similar to legacy option
Return a used license back to its connected server for use by another client. This command should be used in cases where a stuck license occurs as this will return a specific license instead of the alternative of restarting sesinetd. Restarting the license server is a last resort to a stuck license as every client has to fight over licenses and could cause clients to lose work if there is not enough licenses to go around. This option is similar to legacy option
Return an installed license back to the license accounts entitlement pool. To return multiple licenses provide a comma separated list of licenes that need to be returned (i.e.
sesictrl return-license aaa,bbb,ccc,...).
Shutdown a running sesinetd server.
List a set of usernames to query checkout information about the specified users.
Create a server diagnostic. This is similar to legacy option
Installation and redemption
Manually install a license. Option
-A can be optionally specified.
-L entitlement_name quantity
Manually redeem entitlements. A list of entitlements and their quantities
can be specified. If no entitlements are specified then all the available
entitlements will be presented with the available options to redeem
-A can optionally be specified.
-A email password
Specifies your SideFX login information with which to perform the current action.
Check-out and check-in
Relinquish a license, returning it to the pool.
Return a license back to your entitlements.
Optionally specify the http proxy host for returning licenses. If
$HTTP_PROXY is set, this option is not needed.
Optionally specify the HTTP proxy port for returning licenses. If
is set, this option is not needed.
Print the license list of the currently connected sesinetd servers.
When printing the license lists include the expired licenses as well.
Only include licenses with expiry days less than or equal to the number of days specified.
Print a brief license list.
Print the server codes from the connected license servers.
Print the connected license server(s) version.
Print the connected license servers diagnostic information.
Shutdown the license server(s). This will prompt you for confirmation before shutdown.
-Q in a script to avoid having to confirm.
Shutdown the license server(s). This does not prompt you for confirmation.
-r server_name server_code
Remove a server code from the connected license server file.
Generate a server code.
Specify the log level.
0 – no logging
1 – errors
2 – messages
3 – info
4 – debug
Specify the connected license servers maximum log file size.
Specify the connected license servers license log file.
Specify the connected license servers license log level.
0 – off
1 – on
Specify the connected license servers maximum license log file size.
Login Licensing Support
Login based licensing requires an active internet connection.
In Houdini 18.5 and later, Houdini has the option to use login licensing. Login licensing requires the user to be constantly logged in with their sidefx account otherwise it works similar to traditional licensing setups.
The recommended users for login licensing are indie and education users. In a studio setup the requirement to be constantly logged in may pose as a challenge and a traditional license server does not have this requirement.
Follow these steps to start using login licensing:
Login to your sidefx account File menu ▸ Login….
Change the license server to https://www.sidefx.com/license/sesinetd File ▸ Change License Server….
All uninstalled entitlements act as login licenses. This gives you freedom to customize your configuration to use all licenses in the cloud, on-site, or a mix using server chaining.
Browser based Houdini License Administrator
In addition to login licenses, you can view your licenses through the browser and control your license setup.
If you go to https://www.sidefx.com/services/sesinetd, this page uses your currently logged in profile as the login licensing profile. This webpage will also display all of your licenses both from your server list prior to visiting sidefx.com and all of your unredeemed entitlements.
Browser based Houdini License Administrator requires an active internet connection and a running hserver.
API Key licensing
API key licensing gives you the freedom of login licensing without the need login through hkey. This is a great option for render farms or other setups that do not have an artist sitting at the machine that can keep logging in when required. To generate api keys either open hkey to Help ▸ View Api Keys Online or go to https://www.sidefx.com/oauth2/applications/ and select
Register a new application.
These keys will get refreshed when needed as long as the credentials are valid.
To enable api key support for hkey and sesictrl add
HOUDINI_API_KEY_FILE="<file location>" to the houdini.env file. The format of the file is
www.sidefx.com <client id> <client secret>.
To use API keys with hserver place the api key in the options file. See hserver for further details on how to setup API keys for hserver.