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 |
| • | Stage Will Not Open or Crashes on Startup |
| • | Unable to Display Images in Stage |
| • | Unable to Open Scene on Linux Clients |
| • | Resolving Keyboard Shortcut Conflicts and Tweaking KDE |
| • | 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.
How to verify the setup and configuration of the license service
- If you are using a license server, verify that the
license.datfile is in the following directory:/usr/local/flexlm/licenses
- Open the
license.datfile. It should contain the following:
SERVER this_host 0 ANY
VENDOR toonboom
USE_SERVER
this_host.- Verify that the license service is running on the license server.
/sbin/service USAnimation_flexlm status
- If it is not running, start the service.
/sbin/service USAnimation_flexlm start
- Restart the Dbserver if the license server was not properly installed or activated.
/sbin/service USAnimation_dbserver restart
- If you continue having problems with the license server, locate the file
lmgrd.logand send it to:
support@toonboom.com. This file is usually in/tmp.
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.
How to configure the start sequence of ypbind and nfs
- Turn the service off and remove it from the startup configuration.
/sbin/service ypbind stop
/sbin/chkconfig ypbind off
- Edit the
ypbindstartup script located in/etc/init.d/ypbind. Find the following line:
chkconfig: 27 73
Change it to:
chkconfig: 24 73
- Restart the service.
/sbin/service ypbind start
/sbin/chkconfig ypbind on
Stage Will Not Open or Crashes on Startup
Periodically, 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:
/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.
Unable to Display Images in Stage
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.
Resolving Keyboard Shortcut Conflicts and Tweaking KDE
Some KDE default keyboard shortcuts conflict with the shortcuts in Harmony and can prevent normal user operation.
How to change the keyboard shortcuts and tweak KDE
- In the KDE menu, select Computer > System Settings. In earlier versions of KDE, you may need to open the KDE Control Center.
- In the System Settings window, select Windows Behavior in the Desktop section (in earlier versions of KDE, open the Look & Feel > Window Behavior menu instead).
- Select the WindowActions tab.
- In the Inner window, title bar and frame section, do one of the following:
| ‣ | Change your keyboard layout to choose Meta key from the Modifier Key option. The Meta key is the Windows Start button on a 104-key keyboard. You must have this type of keyboard to use this option. Go to Desktop > Window Behavior (in earlier versions, open the Look & Feel > Window Behavior menu). Select the Actions tab. In the Inner window, title bar and frame section, select Meta as the Modifier Key. |
| • | If the Meta key is not available in the Modifier Key list, you must change your keyboard layout. This is set in Control Center > Regional and Accessibility > Keyboard Layout (in earlier versions, open the Control Center > Peripherals > Keyboard menu). Select the Enable keyboard layouts option and then select a Keyboard Model that includes 104 keys. |
| ‣ | Set all the Modifier Key + options to Nothing. |
- There are a few KDE preferences you should update to optimize Harmony.
| ‣ | In the KDE menu, select Computer > System Settings > Window Behavior. Select the Moving tab to disable these two options. Harmony reacts better and faster when these are disabled. |
| • | Display content in moving windows |
| • | Display content in resizing windows |
| ‣ | In the KDE menu, select Computer > System Settings > Appearance and select the Colors menu. Under the Options tab, disable the following option: Apply colours to non-KDE4 applications. |
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.
How to obtain a copy of the resolution.conf file
- Open the following folder:
/usr/local/ToonBoomAnimation/harmony[edition]_12/resources/samples
- Copy the
resolution.conffile to one of the following folder:
| ‣ | /USA_DB/resolution |
| ‣ | /USA_DB/environments/[environment_name]
|
| ‣ | /USA_DB/jobs/[jobs_name] |