Installation Guide

Windows Operating Systems

Legal Notices

Published by Toon Boom Animation Inc.

Corporate Headquarters
7 Laurier Avenue East
Montreal, Quebec
Canada H2T 1E4
Tel: (514) 278-8666
Fax: (514) 278-2666
toonboom.com

Disclaimer
The content of this manual is covered by a specific limited warranty and exclusions and limit of liability under the
applicable License Agreement as supplemented by the special terms and conditions for Adobe® Flash® File Format
(SWF). Please refer to the License Agreement and to those special terms and conditions for details.
The content of this manual is the property of Toon Boom Animation Inc. and is copyrighted. Any reproduction in whole
or in part is strictly prohibited.
For additional copies of this manual, please contact Toon Boom Animation Inc. at the Corporate Headquarters
address.
Copyright © 2009 by Toon Boom Animation Inc. All rights reserved.

Trademarks
Toon Boom Harmony is a trademark owned by Toon Boom Animation Inc. All other trademarks are the property of
their respective owners.

Credits
Documentation Development: Toon Boom Animation Inc.
Content Development: Marie-Eve Chartrand, Anouk Whissell

Publication Date
November 2009
 Contents
Installing on Windows ............................................................................................................................................... 3
Pre-installation ............................................................................................................................................................ 4
Check Your Minimum Requirements ...................................................................................................................... 4
Prerequisites for Harmony Installation .................................................................................................................... 4
Product Code ..................................................................................................................................................... 4
Additional Network Settings .............................................................................................................................. 4
Windows 2003 Server ......................................................................................................................................... 4
Pre-installation Configuration ................................................................................................................................. 5
Turn off Anti-Virus Software ............................................................................................................................... 5
Turn off the Firewall ............................................................................................................................................ 5
Turn Off Use Simple File Sharing - Windows XP Professional ............................................................................ 6
Turn Off Use Simple File Sharing - Windows Vista ............................................................................................. 6
Get the License File ............................................................................................................................................ 6
Toon Boom Harmony Installation ............................................................................................................................... 7
Upgrading from a Previous Installation .................................................................................................................. 7
Stop Services Affecting Harmony ....................................................................................................................... 7
Stop the License Server ...................................................................................................................................... 8
Removing Harmony Related Environment Variables .......................................................................................... 9
Backing up any necessary configuration files: .................................................................................................... 9
Uninstalling the Previous Version of Toon Boom Harmony or Opus ............................................................... 10
Installing Toon Boom Harmony ............................................................................................................................ 10
Configuration ............................................................................................................................................................ 12
Configure Toon Boom Harmony .......................................................................................................................... 12
Set Up the Database Server ............................................................................................................................. 13
Set Up the Database Client .............................................................................................................................. 15
Sharing Toon Boom Harmony Related Directories .............................................................................................. 16
Configure the License ........................................................................................................................................... 18
Setting up the License on Client Workstations ................................................................................................ 22
Reactivating the Firewall and the Anti-virus Software .......................................................................................... 24
Turn on the Anti-Virus Software ....................................................................................................................... 24
Turn on the Firewall .......................................................................................................................................... 24
Troubleshooting ........................................................................................................................................................ 26
Problem: License Error When Starting Any Toon Boom Harmony Module ......................................................... 26
Problem: Unable to Import Sample Scene (Errors with the tbdbserver) .............................................................. 26
Problem: Unable to Open Sample Scene on Clients ........................................................................................... 27
Problem: resolution.conf Error Message .............................................................................................................. 27

1
Harmony Installation Guide - Windows Operating Systems

2
 Installing on Windows
This document explains how to install Toon Boom Harmony on Windows.
There are three stages required to install Toon Boom Harmony 7.8, these are covered in the following topics:
1. Pre-installation, on page 4
2. Toon Boom Harmony Installation, on page 7
3. Configuration, on page 12
After completing these stages, you can verify the integrity of the installation and resolve any configuration issues.
• Troubleshooting, on page 26

3
Harmony Installation Guide - Windows Operating Systems

Pre-installation
Before installing Toon Boom Harmony, you must perform the following task:
• Pre-installation Configuration, on page 5

Check Your Minimum Requirements

For the most current Toon Boom Harmony hardware requirements, refer to the white paper
Harmony and Your IT Department. This is available from:
• Toon Boom Animation Sales Representative
• Toon Boom Animation Support at: [email protected]

Prerequisites for Harmony Installation

For a fast database connection, it is necessary to set up extra network settings so that the clients can perform a fast
Name Resolution of the server as well as the server to the clients.

Product Code
You must have your Harmony Product Code (license key) in front of you before you begin the installation.

Additional Network Settings

NOTE: These steps for editing the hosts file are only required if there are problems or slowness when a computer is
resolving names. DO NOT edit the hosts file unless there are problems resolving names on the network.
1. Setup the server and clients’ IP with a static (fixed) IP address.
2. Go to C:\WINDOWS\system32\drivers\etc\ folder and open the hosts file using a plain text editor.
For Windows 2000 server, the path is C:\WINNT not C:\WINDOWS.
3. Go to the end of the file, on a new line add the static IP address and the machine name accordingly. If you are
using a domain, you need to use the fully qualified domain name (FQDN).
For example, if the server name is server.toonboom.com in the domain and the IP address of the server is
192.168.1.1, the line should be:
192.168.1.1 server.toonboom.com
4. Add the rest of the client’s IP and hostname on a new line and click Save.
5. Once the list is complete, you can copy and paste the hosts file to all of the machines including the server under
the C:\WINDOWS\system32\drivers\etc\ folder.

Windows 2003 Server

For a Windows 2003 server, you need to perform some additional steps to complete the task.
If you have a domain, you need to add a usabatch user on the global group where all the Harmony users are, this user
should have administrator account rights.
• The user name is usabatch
• The password is usabatch
If an error due to the password policy occurs, you can change the password policies for both Domain Controller
Security Policy and Domain Security Policy. You also need to do this from the Domain server if the Domain server is
different from the Harmony database server.
1. From the Windows start menu, select Control Panel.
2. In Control Panel, double-click on Administrative Tools.
3. In Administrative Tools, select Domain Controller Security Policy.
4. In Domain Controller Security Policy, choose Account Policies.
5. Choose Password Policy.
6. In the right panel, double-click on Password Must Meet Complexity Requirement to disable it.
7. In Administrative Tools, select Domain Security Policy.
8. Go to Password Must Meet Complexity Requirement and disable it.

4
 Installing on Windows

Wait for the changes to take effect or restart the Server. It can take several minutes for the domain controller to
update and use the new settings.
Once this is done you will be able to create the user usabatch, this user should be inside of the Harmony user
group.

Pre-installation Configuration
Configure your computer before installation by performing the following tasks:
1. Turn off Anti-Virus Software, on page 5
2. Turn off the Firewall, on page 5
3. Turn Off Use Simple File Sharing - Windows XP Professional, on page 6.
NOTE:
Inform your System Administrator before proceeding with these tasks.

Turn off Anti-Virus Software

Inform your System Administrator before proceeding with this task.
To disable your anti-virus software:
1. Click the Start menu and select Settings > Control Panel. The Control Panel opens.
 Vista Users: Click the Start menu and select Control Panel.

2. Double-click the Security Center icon in the Control Panel window. The Windows Security Center dialog
box opens.
 Vista users must turn off Malware Protection.

3. If your anti-virus software is not detected, open all anti-virus software applications on your computer and disable
each one manually.

Turn off the Firewall

Inform your System Administrator before proceeding with this task.
To disable the Windows Firewall:
1. Open the Windows Firewall dialog box.

a From the Security Center window, click the Windows Firewall icon on the left side panel.

b Click the Start menu, and select Control Panel to open the Control Panel. Double-click the Windows

Firewall icon.

5
Harmony Installation Guide - Windows Operating Systems

c In the Windows Firewall window, click on the Change Settings link.

 On Windows Vista:
 From the Security Center window, click the Windows Firewall icon on the left side panel. In the Windows
Firewall window, click on the Change settings link.

4. Select the OFF option to turn the firewall off.

5. Click OK to confirm your selection.

Turn Off Use Simple File Sharing - Windows XP Professional

Inform your System Administrator before proceeding with this task.
If you are installing Toon Boom Harmony on Windows XP Professional, the Use Simple File Sharing feature should be
disabled before beginning the installation.
To turn off Use Simple File Sharing in Windows XP Professional:
1. Open Windows Explorer.
2. Select Tools > Folder Options.
3. In the Folder Options dialog box, press the View tab.
4. If the option Use Simple File Sharing is on, deselect it.

Turn Off Use Simple File Sharing - Windows Vista

1. Open Windows Explorer.
2. Select Organize > Folder and Search Options.
3. In the View tab, if the option Use Sharing Wizard (Recommended) is on, deselect it.

Get the License File

You should get a license.dat file from the Toon Boom licenser so that you can finish the installation process without
having to wait for the license file to arrive.
To obtain a Toon Boom Harmony license, please email the following information to [email protected].
• Your name and the name of your company
• Platform the system is running on
• Email address where to send the license file

6
 Installing on Windows

Toon Boom Harmony Installation

Now that you have verified your minimum requirements, and configured your hardware and software, you are ready
to install Toon Boom Harmony.
You will perform the following tasks:
1. Upgrading from a Previous Installation, on page 7
2. Installing Toon Boom Harmony, on page 10

Upgrading from a Previous Installation

If you are not upgrading from a previous installation of Toon Boom Harmony, go directly to Installing Toon Boom
Harmony, on page 10.
If you are performing an upgrade, you should pick a time when Toon Boom Harmony production is slow or stopped.
During the upgrade, no users can run any of the Toon Boom Harmony modules and all rendering jobs must be stopped
and complete.
Before you can update a previous installation of Toon Boom Harmony, you must stop all services, including:
• The database server
• Batch processing
• The license server

Stop Services Affecting Harmony

To stop all services affecting Toon Boom Harmony:
1. Make sure that no one is running Toon Boom Harmony.
All Toon Boom Harmony modules must be closed on the server and on all of the clients.
2. Make sure that all batch rendering or vectorizing is complete or that the queues are empty.
You can check the status of the Vectorize and Render queues from the Control Center module.
3. In the Control Center module, use the Queue menu to open the Vectorize and Render Queue for all
environments. The queues should either be empty or the status of all jobs should be “Completed”.
Upgrading from V7.2 or earlier:
 Click the Start menu, select Programs > Toon Boom Harmony (or Opus) > Configuration Tools > usa_cfg.
The USAnimation® Properties window opens.
Upgrading from a previous version of V7.3:
 Click the Start menu, select Programs > Toon Boom Animation > Toon Boom Harmony > Tools >
Harmony Control Panel. The Harmony Properties window opens.
Upgrading from a previous version of V7.8:
 Click the Start menu, select Programs > Toon Boom Harmony 7.8 > Tools > Control Panel. The Harmony
Control Panel window opens.
4. Select a process from the Process Starter drop-list and click Stop. Do this for every Toon Boom Harmony
related process running on the machine.

7
Harmony Installation Guide - Windows Operating Systems

During this process, you will be able to stop the tbdbserver on the server and tbprocess on workstations
that are set as a batch render.

5. Turn off all of the client machines and the render farm.

Stop the License Server

6. On the License server computer:
a First, click the Start menu, and select Programs > Harmony > Configuration Tools > FLEXlm - lmtools.
The LMTOOLS window opens.
D If you are upgrading from version 7.3 click the Start menu, and select Programs > Toon Boom
Animation > Harmony > Tools > Flexlm Tools.
D If you are upgrading from version 7.8 click the Start menu, and select Programs > Toon Boom
Harmony 7.8 > License Tools > Flexlm Tools.
b Next, in the Start/Stop/Reread tab, select the license server in the Remote Server List.

c Click the Stop Server button.

8
 Installing on Windows

d In the Config Services tab, click the Remove Service button to remove the license service.

5. Close FLEXlm – lmtools.

Removing Harmony Related Environment Variables

To complete the installation, you need to remove some environment variables set by the previous installation.
Please do this with caution.
1. Click the Start menu and select Settings > Control Panel.
The Control Panel opens.
 On Windows Vista:
 Click the Start menu and select Control Panel.
The Control Panel opens.
2. Double-click on System and select the Advanced tab.
 On Windows Vista:
 Double-click on System and select the Advanced system settings in the left panel.
3. In the Advanced tab, click on the Environment Variables button.
4. From Environment Variables, select the variable called Path and click the Edit button to open the Edit System
Variable window.
5. In the Path variable value field, click OK to go back to Environment Variables window.
6. In the System Variables panel, select:
LM_LICENSE_FILE if it is listed,
and then click Delete button to delete LM_LICENSE_FILE.
7. Delete any of the following variables if they appear in the System or User variables lists:
TOONBOOM_LICENSE_FILE, USADB, USADIR or USAROOT.

Backing up any necessary configuration files:

You also need to back up any necessary configuration files from the machine in case you want to reuse them. You can
also back up the license.dat during this procedure.
1. Do one of the following:
 For V7.8, go to \Program Files\Toon Boom Animation\Harmony 7.8\etc.
 For V7.3, go to \Program Files\Toon Boom Animation\Harmony\etc.
 For V7.2 and earlier, go to the \usa\etc folder.
2. Back up any necessary configuration files:
 Scan.conf if this workstation is to be configured as a scanning station.
 VectOptions.conf from any machine (including the server) that is doing a batch vectorization.
 Any other.conf file that is required to be used later.
NOTE: You can back up the whole /usa or harmony folder to ensure all configuration file are backed up.
3. Go to the/usa/etc/flexlm folder and back up the license.dat

9
Harmony Installation Guide - Windows Operating Systems

Uninstalling the Previous Version of Toon Boom Harmony or Opus

Once you finish all the steps above, you should uninstall the previous version of Harmony or Opus.

On Windows Vista
1. Click the Start menu and select Control Panel. The Control Panel opens.
2. Double-click Program and Features and choose Harmony or Opus from the program list. And then, click
Uninstall from the top menu.
3. Reboot the machine.
NOTE: Backup the database
For the server upgrading process, please backup the database by exporting the whole database. This will prevent
you from losing any data during the upgrading process. You can, however, back up current /usa_db and /usadata
by renaming them (this procedure can only be used when installing on the same server). But this will require extra
caution, if you are at all unsure contact your system administrator or Toon Boom Animation Support.

On Windows XP
1. Click the Start menu, and select Settings > Control Panel. The Control Panel opens.
2. Double-click Add or Remove Programs and choose Harmony or Opus from the change or remove program list.
And then, click the Change/Remove button to uninstall.
3. Reboot the machine.

Installing Toon Boom Harmony

To run the installation script:
1. Download the build of Harmony that you are going to install.
2. After downloading the installation package, extract the package using a utility such as WinZip. The setup.exe
file is one of the extracted files.
3. Select the language in which you want the installer to execute and click OK. This will only affect the installer and
will not change the language of the actual software.
4. In the InstallShield Welcome window, click Next to continue with the installation. The License Agreement
dialog box appears.
5. Read the license agreement and decide if you accept its terms.
 If you accept the terms in the license agreement, select I accept the terms in the license agreement then
click the Next button.
 If you do not accept the terms in the license agreement, click I do not accept the terms in the license
agreement then click the Next button. The installation will stop immediately and Toon Boom Harmony will
not be installed on your computer.
The Destination Folder dialog box appears. You can click Cancel to interrupt the installation and then click Yes
to stop the installation completely.
NOTE:
You can install Toon Boom Harmony to any location. In this installation guide, it assumes that the installation process
is done to the default location.
6. Select the drive on which you want to install Toon Boom Harmony and click Next. The Setup Type dialog box
appears.
7. Select the type of installation you want to do. Click on the Complete radio button to install all of the Harmony
components.
When installing a server, it is possible to do a custom install and install only the server component. However, it is
recommended to always do a full install, this will give access to all the applications from the server if need be.
8. Click the Next button. The Ready to Install the Program dialog appears.
9. Click Install again to begin the installation.
When this process is complete, select the Launch Configuration Wizard checkbox and click Finish to run the Toon
Boom Harmony Configuration Wizard.
For more information on the Toon Boom Harmony Configuration Wizard, see Configure Toon Boom Harmony, on
page 12 .

10
 Installing on Windows

10. If you don’t want to configure Toon Boom Harmony right away, you can:
 Uncheck the Run Toon Boom Harmony Configuration Wizard and click the Finish button to close the
installer.
OR
 Click Exit on the Toon Boom Harmony Configuration dialog box if you are already in the configuration
window.

11
Harmony Installation Guide - Windows Operating Systems

Configuration
After installing Toon Boom Harmony, you need to configure database parameters depending on your machine’s setup
and third-party software, and reinstate your anti-virus settings.
1. Configure Toon Boom Harmony, on page 12
2. Configure the License, on page 18
3. Reactivating the Firewall and the Anti-virus Software, on page 24

Configure Toon Boom Harmony

When you run the installation wizard, the Toon Boom Harmony Configuration wizard appears automatically at the
end of the installation process. You can launch this wizard at any time to:
• Modify the Toon Boom Harmony server or client configuration
• Configure batch processing
• Configure scanners
• Prepare a client to be the client of a Linux server
• Add Harmony's path to the Path environment variable
After installation, you must set up the database configuration for computers running Toon Boom Harmony.
1. Set Up the Database Server, on page 13
2. Set Up the Database Client, on page 15
To launch the Toon Boom Harmony Configuration Wizard:
 From the Start menu, select Programs > Toon Boom Harmony 7.8 > Tools > Configuration Wizard.
The Toon Boom Harmony Configuration dialog box opens.

12
 Installing on Windows

Set Up the Database Server

The Database Server controls all interactions with the contents of the Toon Boom Harmony database. It processes all
requests to open, read or update files, keeping track of files that are locked so that others cannot edit them.
To set up the Database Server:
1. In the Toon Boom Harmony Configuration dialog box, click the Database button.

2. Select Server/Standalone and click Next.

3. Select the location of the database from the drop-list and select a username and a password for the user that
will be running the database services.
The default account is usabatch. If the account specified does not exist, it will be created by the wizard.
NOTE: Make sure to take note of the account name and password if an account other than the default one is
used. This information will be required later on for client workstations to connect to the server.
4. Click Next.
The configuration program creates the database, /USA_DB, in the location you select. The /USA_DB tracks the
location of the scene data on the file system. You can have multiple file systems, but only one /USA_DB.
NOTE:
If you are upgrading from a previous version of Harmony or Opus and you have renamed
/usa_db for back-up, you need to create new usa_db at the same location where the previous /usa_db was
located.

13
Harmony Installation Guide - Windows Operating Systems

5. In the Scene Data Location window, you create the storage locations for the database.
 From the File system drop-list, you select the file system you want to add. The first File system is already
created for you. If you want to create additional file systems, you must click Add. For example, if you want
to store scene data across multiple drives or computers, you can create them here.
 From the Drive drop-list, select the drive where you want to create the file system.
 In the Share field is the name of the file system that will be created. You can change this value. However, it is
recommended to leave the default name, which increments from usadata000.
 In the Host Computer field, enter the name of the computer on which this file system will be created. By
default, the current computer’s name will appear here. You can create file systems on other computers if
necessary.
 Specify the username and the password that will be used to connect to that file system. It is recommended
to use the same username and password as the one used for the database, in the previous step.
6. Click Next. The Toon Boom Harmony: Review window opens.

7. Review the information in the window. If it is correct, click Finish.

When the configuration wizard is finished, a dialog box opens which indicates the success of the process.

14
 Installing on Windows

Set Up the Database Client

After you have configured your server, you can configure all of the client machines that will connect to the server. Use
the Toon Boom Harmony Configuration Wizard to connect client computers to the database.
To set up the Database Client:
1. In the Toon Boom Harmony Configuration dialog box, click the Database button.

2. Select Client and click Next.

3. Enter the name of the Toon Boom Harmony server and click Next. The Review window opens.
4. Verify the database changes and click Finish.
A message will appear when the client computer is successfully connected to the database server.
NOTE:
It is possible to change the user account used to connect to the USA_DB or the different file systems using the Toon
Boom Control Panel, which can be started from
Start > Programs > Toon Boom Harmony 7.8 > Tools > Control Panel.

15
Harmony Installation Guide - Windows Operating Systems

Sharing Toon Boom Harmony Related Directories

These steps don't have to be done in a typical installation. This is required only when the shares were not created
correctly during the server configuration procedure. For example, this situation could happen when Simple file sharing
was not turned off before running the Configuration Wizard on the server or if it was installed on a Windows XP Home
edition equipped computer. Other cases would be when you have backed-up your USADB and usadata folders prior
to installation, you may have to share them when putting them back into place.
NOTE:
If you are upgrading from a previous version and you have changed the /usa_db and /usadata during upgrade,
please roll back to the normal name before continuing.
To activate file sharing for the Toon Boom Harmony folder:
1. Open Windows Explorer.
2. Locate the Toon Boom Harmony folder C:\Program Files\Toon Boom Animation\Harmony 7.8.
3. Right-click the folder and select Properties from the pop-up menu to open the Properties dialog box.

4. Click the Sharing tab.

5. Verify that Harmony7.8 is written in the Share Name field.

16
 Installing on Windows

6. Type Harmony7.8 it if it is not the case.

NOTE:
Changing the name of the share to usa must only be done when sharing the Harmony folder. The USA_DB and
USADATA folders should keep their original name.
7. Click the Permissions button to display the Permissions dialog box.
 For Vista users, click the Advance sharing button. The Advanced Sharing window opens.
 In this window, type usa in the Share Name field.
 Click the Permissions button to get to the Permissions window.

8. Set all permissions in the Everyone group to Allow and click OK to save the settings and close the dialog box.
9. Click the Security tab.

10. Set all permissions of each group to Allow.

 For Vista users, you need to click Edit button to prompt the permissions window. Then set all permissions in
each group or user to all.
11. Click OK to save the settings and close the dialog box.
12. Repeat Step 3 to Step 11 with the usa_db and usadata folders.

17
Harmony Installation Guide - Windows Operating Systems

Configure the License

Configuring the license server
1. Launch the License Wizard from Windows Start menu > Toon Boom Harmony 7.8 > License Tools >
LicenseWizard.
2. Depending on how the License Wizard was started, the first page of the License Wizard will be one of the
following:

If this screen appears: If this screen appears:

• Click on Quick Activation • Click on Activate License

The Activation Options screen appears:

3. Click on Internet Activation

18
 Installing on Windows

The Internet Activation Options screen appears:

4. Click on Network License.

The Internet Activation - Network License screen appears:

5. Type or copy/paste the Product Code and type in the number of licenses this product code grants you.
NOTE: Once activated, server license cannot be returned to the activation server. Make sure you are activating
the license on the correct computer with the proper license count.
6. Click on Next.

19
Harmony Installation Guide - Windows Operating Systems

The Install License Server screen appears:

7. Click on Install License Server.

This step will create the license.dat file and place it in /usr/local/flexlm/licenses/license.dat. The license.dat
created contains the following information:
SERVER this_host 0 ANY
VENDOR toonboom
USE_SERVER
This step will also add an exception to Windows’ firewall to allow communications to the lmgrd and the
toonboom daemon. This will be listed as FLEXnet License Manager and ToonBoom License Daemon.
It will also configure and start the License Server service.
The Activation Successful screen appears:

8. Click on Finish to exit the wizard.

20
 Installing on Windows

9. Once finished with the License Wizard, take a look at the lmgrd.log to make sure it was started properly.
C:\flexlm\lmgrd.log
10. You can now go in LMTOOLS to verify that the License server has been configured properly and that it is
running.
Below are the default parameters for the license service.

11. It is good practice to verify that the license service it properly running by going in the Server Status tab and
clicking Perform Status Enquiry.

Restore backed up data

1. Stop the tbdbserver by opening the Toon Boom Harmony Control Panel. There select the HarmonyStart0-
tbdbserver from the list and click the Stop button.
You can verify that the tbdbserver was properly stopped by looking to see if the service is gone in the process
tab of the task manager.
2. Open the File Explorer and rename the new empty USA_DB database folder to USA_DB_NEW .
3. Rename the USA_DB_BAK (the one that was backed up earlier) to USA_DB to restore the previous database.
4. Copy the dicts files from the new database (USA_DB_NEW/dicts) to the one you have restored (USA_DB/
dicts).
NOTE: Dicts files can also be copied from C:\Program Files\Toon Boom Animation\Harmony
7.8\etc\USADB_templates\dicts
5. Share the USA_DB folder giving full control every one. Make sure that simple file sharing is turned off before
doing this.
If you cannot set permissions per use for the share, it means that the simple file sharing is turned on.
6. Rename the new empty usadata000 folder (and any other file system folder) to usadata000_NEW.
7. Share the usadata000 folder (and any other folder you have restored) giving full control everyone.
8. Start the tbdbserver by opening the Toon Boom Harmony Control Panel. There select the HarmonyStart0-
tbdbserver from the list and click the Start button. After starting the tbdbserver, look at the
tbdbserver.log to make sure it was started properly.
C:\Program Files\Toon Boom Animation\Harmony 7.8\nt\
9. Verify that you are able to Open Harmony and scenes from the server.

21
Harmony Installation Guide - Windows Operating Systems

Setting up the License on Client Workstations

An Admin account is required to set this up. After activation you can login as client.
To set up the license on a client workstation do the following:
1. Open the License Wizard on the Client machine. The License Wizard appears.

2. Click on Activate License. The Activation Options screen appears.

3. Click on Alternative Activation. The Alternative Activation Options screen appears.

22
 Installing on Windows

4. Click on Use License Server. The Server Activation Options screen appears.

5. Click on Connect to Server. The Server Activation - Shared License dialog appears.

6. Enter the hostname or the IP Address in the License Server address field.
7. Click Connect. You will be prompted for a password.
8. Enter the password and click ok. The Activation Successful screen appears.
9. Click Finish to close the License Wizard.

23
Harmony Installation Guide - Windows Operating Systems

Reactivating the Firewall and the Anti-virus Software

Turn on the Anti-Virus Software
Inform your System Administrator before proceeding with this task.
To turn the anti-virus software back on:
 Reactivate virus protection. If your anti-virus software is not detected, open any anti-virus software applications
on your computer and reactivate each one manually.

Turn on the Firewall

The process to do this is basically the reverse of the procedure used to deactivate the firewall.
Inform your System Administrator before proceeding with this task.

On Windows Vista
1. Click the Start menu, and select Settings > Control Panel to open the Control Panel.

24
 Installing on Windows

2. Click on Turn Windows Firewall on or off. The Windows Firewall Setting dialog box appears.

3. Click on the ON radio button to turn the firewall back on.

4. Click on Apply to activate the option.
5. Click on the Exceptions tab and select the exceptions which were already created on the server
 tbdbserver
 tbprocess
 ToonBoom License Daemon (toonboom.exe)
6. Click on Apply to activate the option.
7. Click OK to complete the procedure.

On Windows XP
1. Open the Windows Firewall dialog box.

a From the Security Center window, click the Windows Firewall icon on the left side panel.

b Click the Start menu, and select Control Panel to open the Control Panel. Double-click the Windows

Firewall icon.
c In the Windows Firewall window, click on the Change settings link.
4. Select the On option to turn the firewall on.
5. Click on Apply to activate the option.
6. Click OK to complete the procedure.

25
Harmony Installation Guide - Windows Operating Systems

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: License Error When Starting Any Toon Boom Harmony Module, on page 26
• Problem: Unable to Import Sample Scene (Errors with the tbdbserver), on page 26
• Problem: Unable to Open Sample Scene on Clients, on page 27
• Problem: resolution.conf Error Message, on page 27

Problem: License Error When Starting Any Toon Boom Harmony

Module
If you are getting license errors when you start any Toon Boom Harmony module, check the set up and configuration
of the license service.
• Make sure that the license.dat file is in the following directory:
C:\flexlm
• Open the license.dat file.
The license.dat should contain the following information:
SERVER this_host 0 ANY
VENDOR toonboom
USE_SERVER
• Make sure that the license service is running.
• If you continue having problems with the license server, locate the file ToonBoomLicense.log and send it
to [email protected]. In Windows, this file is usually in C:\flexlm;.

Problem: Unable to Import Sample Scene (Errors with the tbdbserver)

Check the tbdbserver.log file. It is usually stored in C:\Program Files\Toon Boom
Animation\Harmony7.8\nt.
If there is no log file, re-start the tbdbserver.
To restart the tbdbserver:
1. Open the Control Panel.

2. Double-click the Toon Boom Harmony Control Panel icon. The Toon Boom Harmony Control Panel dialog
box opens.

3. From the Process Starter drop-list, select the tbdbserver entry.

4. Click Start.

26
 Installing on Windows

If you continue to have problems with the database server, locate the tbdbserver.log file and send it to
[email protected]. This file is usually in C:\Program Files\Toon Boom
Animation\Harmony7.8\nt.
You can also run the Dbserver from the command shell in debug mode to receive additional information about the
process.
To run the tbdserver in debug mode:
1. Open Dbserver.conf.
2. Add the following line to the file:
debug_port 5681
3. Stop the tbdbserver service. Click the Start menu and select Programs > Toon Boom Harmony7.8 >
Configuration Tools > Control Panel. When the Toon Boom Harmony Control Panel window opens, select the
tbdbserver from the Process Starter drop-list and then click Stop.
4. Open a command prompt by selecting Start > Programs > Accessories > Command Prompt.
5. Type the following:
tbdbserver -debug
NOTE:
While you are running the tbdbserver in debug mode, messages will be written to the shell for each operation the
tbdbserver performs. This is additional information to what is written to the tbdbserver.log file.
 To output this information to a new file, type the following:
tbdbserver -debug > "C:\Program Files\Toon Boom
Animation\Harmony7.8\nt\tbdbserver_debug.log"
If you still cannot determine the nature of the problem, send this file to support@ toonboom.com with a detailed
description of the problem.

Problem: Unable to Open Sample Scene on Clients

If clients cannot open the sample scene, it is possible that they are not connected to the database server. Follow the
instructions in Set Up the Database Client, on page 15 to connect to the server.

Problem: resolution.conf Error Message

When you open the sample scene, you might get an error message that says that the resolution.conf file can’t
be opened. This file is usually stored in the environment or job directory of your database.
There is a sample resolution.conf file in:
\Program Files\Toon Boom Animation\Harmony7.8\resources\samples directory.
You can copy that into either of the following directories:
• \USA_DB\environments\[environment_name]
• \USA_DB\jobs\[job_name]
• \USA_DB\resolution\

27