Installation Guide > Harmony Installation Guide > Installing on Windows > 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
2. Sharing Toon Boom Harmony Related Directories
3. Configure the License
4. Turning on the Anti-Virus Software

You can use the Toon Boom Harmony Installation 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
2. Set Up the Database Client

To launch the Toon Boom Harmony Configuration Wizard:

From the Start menu, select All Programs > Toon Boom Harmony 10.0 > Tools > Configuration Wizard.

The Toon Boom Harmony Configuration dialog box opens.


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.
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.


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.
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.

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 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.


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 10.0 > Tools > Control Panel.

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 . 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.


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 (x86)\Toon Boom Animation\Harmony10.0.
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. Click on Advanced Sharing...
6. Type usa in the Share Name field.


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.

8. Set all permissions in the Everyone group to Allow and click OK to save the settings and close the dialog box.
9. Back in the File Properties window, click the Security tab.

Click the Edit button to prompt the permissions window. Set all permissions in each group or user to all.
10. Click OK to save the settings and close the dialog box.
11. Repeat Step 3 to Step 10 with the usa_db and usadata folders.

Configuring the license server

1. Launch the License Wizard from Windows Start menu > All Programs > Toon Boom Harmony 10.0 > 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:

The Activation Options screen appears:

3. Click on Internet Activation

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.

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


It will also configure and start the License Server service.

The Activation Successful screen appears:

8. Click on Finish to exit the wizard.
9. Once finished with the License Wizard, take a look at the lmgrd.log to make sure it was started properly.


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
Setting up the License on Client Workstations

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 (x86)\Harmony 10.0\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:\ProgramData\Toon Boom Animation\Toon Boom Harmony

9. Verify that you are able to open Harmony and scenes from the server.

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 screen appears.

4. Click on Use License Server. The Server Activation 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.

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.

Turning 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.

Re-enabling the firewall

1. Click the Start menu, and select Control Panelto open the Control Panel. Click on Windows Firewall.


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


3. Click on the Turn on Windows Firewall radio buttons to turn the firewall back on.
4. Click on OK to activate the option.

Creating Inbound Rules

1. Back in the Windows Firewall window, click on the Advanced Settings link.
2. Click on Inbound Rules to display the list of Inbound Rules. Click on New Rule on the right side of the window.
3. Select the Program radio button and click Next.
4. Select the This Program Path radio button and click on the Browse button. Navigate to the Harmony installation path and select tbdbserver.exe. Click Next.
5. Select the Allow the Connection radio button and click Next.
6. Select the appropriate profiles for which this rule will be applied according to your network configuration and click Next.
7. Finish the Rule creation process by clicking Finish.
8. Repeat steps 1 to 7 for tbprocess.exe and toonboom.exe.
9. Repeat steps 1 to 7 for lmgrd.exe if this computer will be used as a License server.

Related Topics