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

License Error When Starting Any Harmony Module
Unable to Import Scene (Errors with the Dbserver)
Exported Directories Not Mounting on Clients
Harmony Stage Will Not Open or Crashes on Startup
Unable to Display Images in Harmony Stage
Unable to Open Scene on Linux Clients
Resolving Keyboard Shortcut Conflicts and Tweaking KDE

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

Verify the Dbserver.log file. It is usually stored in /tmp.

If there is no log file, restart the Dbserver.

/sbin/service USAnimation_dbserver restart

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

If you get an error in the log about the machine name, verify 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, verify that the port name in the Dbserver.conf file is not used by another service. Type netstat -a to see a list of port numbers used by the machine. If another service is using port 5678, change the port number in Dbserver.conf to any unused number above 5000.
Restart the Dbserver.

/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 verify that the ypbind service is started before nfs.

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

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


Problems with the security module of the PAM system can cause these periodic problems. Follow the instructions in the NVIDIA Readme 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-bits per pixel.

Verify your current settings.

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

Verify that the directories have been exported.

/usr/sbin/exportfs -r

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

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

cd /usr/local/ToonBoomAnimation/harmony_11.2


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

etc help lang lnx_86 lnx86_64 Plugins resources

If you do not see anything in the exported directories, verify that the server directories are 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, verify the start up sequence of ypbind and NFS to verify that NFS is started first—see Exported Directories Not Mounting on Clients .

Resolving Keyboard Shortcut Conflicts and Tweaking KDE

Some KDE default keyboard shortcuts conflict with the shortcuts in Harmony and can prevent normal user operation.