Installation > Installing on Linux > Troubleshooting

Troubleshooting

If you have any outstanding issues running Toon Boom 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.

License Error When Starting Any Harmony Node
Unable to Import Scene (Errors with the Dbserver)
Exported Directories Not Mounting on Clients
Harmony Will Not Open or Crashes on Startup
Unable to Display Images in Harmony
Unable to Open Scene on Linux Clients
Fixing the Alt Key Keyboard Shortcut Conflict Between Harmony and Linux
Problem: resolution.conf Error Message

License Error When Starting Any Harmony Node

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

Unable to Import Scene (Errors with the Dbserver)

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

Exported Directories Not Mounting on Clients

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.

Harmony Will Not Open or Crashes on Startup

Periodically, Harmony 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:

/usr/share/doc/NVIDIA_GLX-1.0/README.txt

Problems with the security node 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.

Unable to Open Scene on Linux Clients

On the Harmony server, verify that all the Harmony directories were exported. The /USA_DB, /usr/local/ToonBoomAnimation/harmony[edition]_12, 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[edition]_12

ls

A list appears of the directories in harmony[edition]_12. 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.

Fixing the Alt Key Keyboard Shortcut Conflict Between Harmony and Linux

On GNOME 2 and KDE, by default, clicking anywhere on a window while pressing the Alt key will move the window. Because the Alt key is used as a modifier for many drawing and animation tools in Harmony, it is highly recommended to configure your desktop environment to use the Super key (ie: The Windows Logo key, on many keyboards) for this purpose instead.

Problem: resolution.conf Error Message

When you open a scene, you might get an error message that says that the resolution.conf file cannot be found. This file is usually stored in the environment or job directory of your database. There is a resolution.conf file you can copy.