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.
| • | Problem: Unable to Open Sample Scene on Clients |
| • | Problem: License Error When Starting Any Harmony Node |
| • | Problem: Unable to Import Sample Scene (Errors with the Dbserver) |
| • | Problem: resolution.conf Error Message |
Problem: Unable to Open Sample Scene on Clients
On the Toon Boom Harmony 12.2.1 server, verify the following:
| • | The database and data directories were exported using NFS. |
| • | Link Server, Samba and server.ini configurations for Windows clients. |
| • | On Mac OS XToon Boom Harmony 12.2.1 clients, verify that the database and data directories were mounted using NFS. |
Problem: License Error When Starting Any Harmony Node
If you are getting license errors when you start a Toon Boom Harmony 12.2.1 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.- On the Mac license server, open the Activity monitor and make sure that the lmgrd and Toon Boom processes are running. If both of them are missing, start the license service by typing the following in the Terminal:
sudo launchctl load /Library/LaunchDaemons/com.toonboom.LicenseServer.plist
- If you get an error message when you try to start the license service, it is possible that you did not install the license Startup Item. Use the LicenseWizard to install the license server Startup Item.
- If you continue having problems with the license server, locate the file ToonBoomLicense.log and send it to store.toonboom.com/contact/support. The file is located in: /tmp.
Problem: Unable to Import Sample Scene (Errors with the Dbserver)
| • | Verify the com.toonboom.DatabaseServer.log file located in /tmp. If there is no log file, start the Dbserver. Type the following in the Terminal: |
sudo launchctl load /Library/LaunchDaemons/com.toonboom.DatabaseServer.plist
If there is a log file, the last few lines will give you some 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 Toon Boom Harmony 12.2.1 server. |
| • | If you get errors about the port number, another service might be using port 5680. You can change the port number in Dbserver.conf to any unused number above 5000. |
| • | Restart the Dbserver. Type the following in the Terminal: |
sudo launchctl unload /Library/LaunchDaemons/com.toonboom.DatabaseServer.plist
sudo launchctl load /Library/LaunchDaemons/com.toonboom.DatabaseServer.plist
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:
/Applications/Toon Boom Harmony [version][edition]/tba/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] |