Troubleshooting

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: No Batch Vectorization or Rendering (Linux)
Problem: No Batch Vectorization or Rendering (Windows)
Problem: No Batch Vectorization or Rendering (Mac OS X)

If drawings are not being vectorized or rendered you should check the setup and configuration of batch processing.

To check the status of the batch processing machines:

1. In a shell, type Status and press [Enter] twice. The machines that are set up to batch process should appear in the report. There should be an "R" next to the machine name and the status must be "On" to be able to batch process.
If no machines appear in the list, make sure the
/USA_DB/schedules/machine-list file lists all of the computers that will do batch vectorization or rendering. Re-try sending elements to the render queue.
If you still have problems vectorizing and rendering, perhaps the processes were not installed when you installed Harmony. Re-install Harmony running the -p option. In a shell, change to the directory where the installation script is stored and type:

./install -p

Make sure that the queues are started. Type the following in a shell:

/sbin/service USAnimation_queues start

To learn more about the Linux installation process, refer to the Toon Boom Harmony LinuxInstallation guide.

If drawings are not being vectorized or rendered you should check the status of batch processing machines.

To check the status of the batch processing machines:

1. From the Start menu, select All Programs > Accessories > Command Prompt to open a command prompt.
2. Type Status and press [Enter] twice. The machines that are set up to batch process should appear in the report. There should be an "R" next to the machine name and the status must be "On" to be able to batch process.
If machines are missing from the report, run the Harmony Configuration Wizard to set up batch processing on each machine that will vectorize drawings or render scenes. See, Installing Batch Processing and Configuring the machine-list File (Windows)
If a machine is in the report, but is set to "Off", you must define a default schedule for the machine. See, Setting Up Default Schedules
If a machine is in the report, but is missing the "R", re-start the batch processing queues.

To re-start the batch processing queues:

1. From the Windows Start menu, select Control Panel from the Settings sub-menu.

The Control Panel window appears.

2. Double-click the Toon Boom Harmony Control Panel icon in the Control Panel window.

TheToon Boom HarmonyControl Panel dialog box appears.

3. From the Process Starter drop-down list, select the tbprocess-schedule entry.

4. Click on the Start button to re-start the service. If the Start button is disabled, click Stop first, wait a couple of seconds, then click Start.

If you continue to have problems with batch processing, locate the tbprocess.log file and send it to support@toonboom.com.

This file is usually in
\Program Files\Toon Boom Animation\Harmony\nt

If drawings are not being vectorized or rendered you should check the setup and configuration of batch processing.

To check the status of the batch processing machines:

In the Terminal, type Status and press [Enter] twice.

The machines that are set up to batch process should appear in the report.

There should be an R next to the machine name and the status must be On to be able to batch process.

If no machines appear in the list, make sure the /USA_DB/schedules/machine-list file lists all of the computers that will do batch vectorization or rendering. Re-try sending elements to the render queue.
If your machine appears in the list, but that there is no R next to it, the tbprocess service may not be running. Verify that the tbprocess is active by using the steps described in the Verify that a tbprocess Session is active.
If there is no tbprocess session active, perhaps the processes were not installed when you installed configured your installation. Verify that the ToonBoomQueueServer folder exists in the /Library/StartupItems folder. If it does not exist, see the section Starting a tbprocess Session on Mac OS X.
If the folder exists, start the tbprocess session by typing the following:
sudo /sbin/SystemStarter start ToonBoomQueueServer
The Terminal prompts you to type your password. Your user needs to be allowed to administer this computer for this command to work.