Houdini Apprentice FAQs


How do I install Houdini Apprentice?

For a more detailed description, please refer to Download and Installation FAQs on the Support->FAQs web page.

How do I install licenses (with internet access)?
  1. If using Windows, run a Houdini product from the Start Menu (eg. Houdini FX). If using Mac, run Houdini from the Applications folder in Finder. If using Linux, run one of:
    • houdini to start Houdini FX
    • hescape to start Houdini (known as Houdini Escape till version 11)
  2. When a window appears saying This Software Requires a License, click on Install a Non-Commercial License.
  3. After the license has been installed, another window will appear. Click on Run Houdini FX to start the Houdini product.

Notes:

  • Once a Houdini Apprentice product has been activated, the license is valid for 30 days, after which time you can reactivate it again.
  • Each Houdini product (Houdini FX, Houdini) needs to be activated separately.
  • The reactivation process is automated. When you try to run a Houdini product that must be reactivated, you will again be prompted to install a non-commercial license.
How do I setup an HTTP proxy in the License Administrator?

If you are behind a firewall and you need to use an HTTP proxy to access the internet, you can tell the Houdini License Administrator to use one.

Note that if you need to authenticate to your proxy, this will not work. You will need to follow the section "How do I install licenses (without internet access)?".

  1. Find out your HTTP proxy host name and port by looking at your web browser's settings.
  2. Select File -> Preferences... in the License Administrator. Turn on the toggle to use an HTTP proxy, and enter the proxy host name and port. These settings will be saved for the next time you use the License Administrator.
How do I start and stop the License Server?

Windows:

  • Go to the Control Panel -> Administrative Tools -> Services
  • There is a service called HoudiniLicenseServer that you can stop/start/restart

Linux:

  • Run the sesinetd startup script located in /etc/init.d
  • Usage: /etc/init.d/sesinetd {start|stop}

Mac OSX:

  • Type commands in the Applications > Utilities > Terminal

To start (type all on one line): sudo launchctl load /Library/LaunchDaemons/com.sidefx.sesinetd.plist
To stop (type all on one line): sudo launchctl unload /Library/LaunchDaemons/com.sidefx.sesinetd.plist

What do I do if I receive the error: "Unable to connect to hserver for licence acquisition"?

On Windows, verify that you have the service HoudiniServer listed in Services and that it has started. You can go to Services through Control Panel->Administrative Tools. If it's not listed, ensure that there is a program called hserver.exe located in C:\Windows\system32. If there is, you can try manually adding it to Services:

On Linux, make sure that hserver is listed in the process list. If not, you can start it by typing hserver when you've sourced the Houdini environment.

How do I install HDK?

Starting with Houdini 9.5, the HDK is automatically installed during the Houdini installation process.

For the earlier versions, you need to run the hdkinstall command first, before you can use HDK.

Windows:

  • Run the Command-Line Tools and then run the command hdkinstall Note: The Command-Line Tools can be started by Start Menu -> Programs -> Side Effects Software -> Houdini 9.0.x -> Command Line Tools

Linux:

  • After sourcing the Houdini environment (source houdini_setup), run the command hdkinstall
  • If running the Bash shell, type: source houdini_setup_bash
How do I install licenses (without internet access)?

If you do not have internet access from the machine running Houdini, you will need to use a second machine with internet access to acquire your licenses.

  1. Start the Houdini License Administrator from the Start Menu if using Windows or from the Applications folder in Finder if using Mac. If using Linux, run hkey after sourcing the houdini environment (source houdini_setup or houdini_setup_bash if using the bash shell)
  2. Click on the Server Information tab and record the license server host and the server code.
  3. From the machine with internet access, go to http://license.sidefx.com/get_nc_license.php. Enter the server name and server code and select the Houdini product to activate.
  4. Cut and paste the SERVER and LICENSE keys and and save them to a file on a disk.
  5. On the machine running Houdini, select File -> Manually Enter Keys.... Paste each key into a text box using Ctrl+V and press OK.
  6. You can now run the Houdini product.

If installing licenses in local licensing mode, you may need to set the read-write permissions on the license directory (C:\Windows\keys or /usr/lib/sesi or /Library/Preferences/sesi/) so that the License Administrator utility can create the "licenses.local" file. Otherwise you may get grayed out fields in the License Administrator dialog box.

The License Administrator (hkey) doesn't have valid licenses anymore. It is reporting: License server server code: 00000000. What do I do?

On Linux, the server code is dependent on the MAC address of the ethernet card. In particular, eth0. Verify that there is a valid eth0 device in the system. You can do this by typing /sbin/ifconfig -a to list the network devices.

Why do I receive this error in the console?: NT_GeneratorThread::queueEvent eventqueuefull.Event dropped

This is due to using an older graphics card. Tell Houdini to use software OpenGL rather than hardware OpenGL. This is done by setting an environment variable:

HOUDINI_OGL_SOFTWARE = 1

Apprentice is installed but cannot use it in network mode (floating license). What should I do?

There is a restriction on Apprentice licenses. Apprentice licenses are node-locked (+.+.+.+). This means that you can run Houdini only on the machine that the licenses are installed on.

License Administrator (hkey) says that it has an "Invalid Server Key". What should I do?

The SERVER license key in the licenses file has become invalid. This can happen when hardware changes are made to the machine hosting the licenses. For the free Apprentice users, the easiest solution is to delete the licenses file and to follow the instructions in the section "Installing Licenses With the License Administrator (with Internet Access)" or the section "Installing Licenses Without Internet Access" to reinstall the license keys.

The licenses file (or licenses.local file, if Houdini is configured for local licensing) is located: Windows:

  • C:\WINDOWS\keys\licenses

Linux:

  • /usr/lib/sesi/licenses

Mac:

  • /Library/Preferences/sesi/licenses

If the above solution doesn't work then delete the licenses file again and follow these steps:

  1. Start the Houdini License Administrator (hkey)
  2. Click on the Server Information tab and record the license server host and the server code.
  3. Go to http://license.sidefx.com/get_nc_license.php. Enter the server name and server code and select the Houdini product to activate.
  4. In the License Administrator, select File -> Manually Enter Keys
  5. Copy and Paste each SERVER and LICENSE key into the text box using Ctrl+V and press OK.
  6. You can now run the Houdini product.
I receive errors when sourcing houdini_setup. What should I do?

[user@linux]% source houdini_setup
bash: houdini_setup: line 26: syntax error near unexpected token `set'
bash: houdini_setup: line 26: ` if ( ! $?cwd ) set cwd=`/bin/pwd`'

The houdini_setup file is for those using the either csh or tcsh. Try sourcing houdini_setup_bash. To find out what shell you are using type: echo $SHELL

What communicates with the License Server?

The Houdini License Client is called hserver (HoudiniServer service on Windows). This program communicates with the license server called sesinetd (HoudiniLicenseServer service on Windows) for license acquisition.

Windows:

  • Control Panel -> Administrative Tools -> Services -> HoudiniServer stop/start/restart

You may also use the Command-Line Tools on Windows:

  • Start -> Program Files -> Side Effects Software -> Houdini 9.0.x -> Command Line Tools
  • Type hserver -q to stop the client
  • Type hserver to start the client

Linux:

  • Make sure that you have sourced the houdini environment (source houdini_setup) (If using the Bash shell, source houdini_setup_bash)
  • Type hserver -q stops the client
  • Type hserver starts the client

Mac:

  • Start Houdini Shell.terminal in the Applications folder in Finder
  • Type hserver -q to stop the client
  • Type hserver to start the client