On macOS this application is in the Houdini install folder, in the
Administrative Tools folder, as
Licence Administrator X.X.X.
On Windows this application is in Start menu ▸ Side Effects Software ▸ License Administrator X.X.X.
On Linux this application is
bin/hkey inside the install directory.
The Houdini License Administrator requires all connected license servers version to be 18.0.287 or greater.
You can use this application to view and manage licenses and license server options using a graphical user interface. To manage licenses and set options from the command-line, use sesictrl.
Using the interface you can:
Show all license servers and their installed licenses.
Re-install licenses and redeem entitlements.
Manage license servers and set license server options.
If you have licensing problems, try launching this application. It may be able to show the problem. You can email diagnostic information and crash reports to SideFX Support from within this application.
For more information on how to setup licensing for your use case see Installation and Licensing guide.
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….
Open the dialog Change License Server File ▸ Change License Server….
Clear all entries from the table
Search these license server(s). To clear an entry click the
-sign on each row.
Found Server(s)table add
www.sidefx.com (SideFX Login Server). To add an entry to the list of servers to use click the
+button on the desired row.
www.sidefx.com (SideFX Login Server)is the only entry listed in the
Search these license server(s)table press the
ACCEPTbutton at the button right of the dialog.
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
<client id> <client secret>.
HOUDINI_API_KEY_FILE is only meant for hkey and sesictrl. Hserver uses option
APIKeyFile instead. See hserver for further details on how to setup API keys for hserver.