If you have any problems running Harmony after installation, review the installation and configuration instructions to make sure you have followed them completely. If you continue to have problems, consult the following list to troubleshoot common installation and configuration problems.

Problem: License Error When Starting Any Harmony Module
Problem: Unable to Import Sample Scene (Errors with the Dbserver)
Problem: Exported Directories Not Mounting on Clients
Problem: Harmony Stage Will Not Open or Crashes on Startup
Problem: Unable to Display Images in Harmony Stage
Problem: Unable to Open Sample Scene on Linux Clients

If you are getting license errors when you start a Toon Boom Harmony module, check the set up and configuration of the license service.

Make sure that the license.dat file is in the following directory:
/usr/local/flexlm/licenses if you are using a license server.
Open the license.dat file.

The license.dat should contain the following information:

SERVER this_host 0 ANY

VENDOR toonboom



Note that on a client workstation, the hostname of the server should be listed on the first line instead of this_host.


Make sure that the license service is running on the license server. To see if the service is running on the server. In a shell type:

/sbin/service USAnimation_flexlm status

If it is not running, start the service with the following command:

/sbin/service USAnimation_flexlm start

You will have to re-start the Dbserver if the license server was not properly installed or activated. Type the following in a shell:

/sbin/service USAnimation_dbserver restart

If you continue having problems with the license server, locate the file lmgrd.log and send it to This file is usually in
Check the Dbserver.log file. It is usually stored in /tmp.
If there is no log file, re-start the Dbserver. Type the following in a shell:

/sbin/service USAnimation_dbserver restart

If there is a log file, the last few lines in the log file will give you some indication as to the problem with the Dbserver.

If you get an error in the log about the machine name, check the
/USA_DB/ Dbserver.conf file and make sure the hostname matches the machine name of the Harmony server.
If you get errors about the port number, check that the port name in the Dbserver.conf file is not used by another service. Type netstat -a in a shell to see a list of port numbers used by the machine. If another service is using the port 5678, you can change the port number in Dbserver.conf to any unused number above 5000.
Re-start the Dbserver. Type the following in a shell:

/sbin/service USAnimation_dbserver restart

On most Fedora Linux distributions, the ypbind service is started after nfs by default. This causes directory mounting to fail when your system boots up. This will prevent Linux clients from mounting Toon Boom Harmony directories from the server.

You must make sure the ypbind service is started before nfs.

To configure the start sequence of ypbind and nfs:

1. Turn the service off and remove it from the startup configuration. Type the following in a shell:

/sbin/service ypbind stop

/sbin/chkconfig ypbind off

2. Edit the ypbind startup script located in /etc/init.d/ypbind. Find the line reading:

chkconfig: 27 73

Change it for:

chkconfig: 24 73

3. Restart the service. Type the following in a shell:

/sbin/service ypbind start

/sbin/chkconfig ypbind on

Periodically, the Harmony Stage refuses to open, printing an NVIDIA error message in the shell. This may not happen all of the time. Users may report this error after running the application several times successfully.

The NVIDIA error message directs users to instructions in the Read Me file:


Problems with the security module of the PAM system can cause these periodic problems. Follow the instructions in the NVIDIA Read Me to resolve this error.

If you continue to experience problems, verify that the xorg.conf file (in /etc/X11/) contains the correct driver information (the driver should be nvidia, not nv).

If this does not resolve the problem, reinstall your NVIDIA driver.

Your monitor's screen settings must be set to 24-bit per pixel.

Verify your current settings.

If you are using Fedora, verify the file /etc/X11/xorg.conf.
On the Harmony server, check that all of the Harmony directories were exported. The /USA_DB, /usr/local/ToonBoomAnimation/harmony_10.0, and /usadata directories must appear in the /etc/exports file. Make sure that the entries in this file match the name of the directories you created on the server.

In a shell, type the following to make sure the directories have been exported:

/usr/sbin/exportfs -r

For more information, .

On the Linux client, check that you created the data directories and mounted the server directories into those directories. Check the /etc/fstab file to see that the data directories are listed and spelled the same way as the directories on the client and on the server.

List the contents of the mounted directories to see that there are some contents.

cd /usr/local/ToonBoomAnimation/harmony_10.0


A list appears of the directories in /usa. They are:

etc help lang lnx86_64Plugins resources

If you do not see anything in the exported directories, type the following in a shell to make sure the server directories have been mounted:

mount -a

If you are able to list the contents of the exported directories and open the sample scene after manually mounting all shares, check the start up sequence of ypbind and nfs to make sure that nfs is started first. For more information, Problem: Exported Directories Not Mounting on Clients .