After installing Harmony, configure database parameters depending on your machine's setup, and configure third-party software.

1. Set Up Licensing
2. Configure Harmony

Set Up Licensing

Now that you have installed Harmony, you must set up the licensing so that it can run on the server and client machines.

Configuring the license server

1. As the root user, start the License Wizard by typing the following:

cd /usr/local/ToonBoomAnimation/harmony_10.0/lnx86_64/bin

Logged as root user, type:


2. Click on Activate License.

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.
Once activated, server licenses can only be returned to the activation server once. A previously returned licensed can not be re-activated. Make sure you are activating the license on the correct computer.
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


This step will also start the License Server service and will configure it to start automatically.

Both these steps can be done manually if need be. To configure the License Server service to start automatically at boot, use the following command:

$ /sbin/chkconfig USAnimation_flexlm on

To start the license server manually, type the following as the root user:

$ /etc/init.d/USAnimation_flexlm restart

The Activation Successful screen appears:

8. Click on Finish to exit the wizard.
9. Verify that the FlexLM license is working properly by using the lmutil lmstat -a command.

$ lmutil lmstat -a

You can also look at the log:

$ less /tmp/lmgrd.log

10. If the FlexLM service needs to be restarted, use the following command:

$ /etc/init.d/USAnimation_flexlm restart

Configure Harmony

After installation, you must set up the database configuration for computers running Harmony.

1. Set Up the Database Server
2. Create the Toon Boom Harmony File System

Set Up the Database Server

The Dbserver 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 can not edit them.

When installing Harmony on the server for he first time, the Harmony database folder is created automatically. Verify that the folder was created correctly. Look for the USA_DB folder in the root folder (/USA_DB).

If you do not see the folder there, you will need to create it using the create_usa_db script. Type the following command in a shell while logged in as root:

/usr/local/ToonBoomAnimation/harmony_10.0/lnx86_64/bin/create_usa_db /USA_DB

Next you need to create and edit the Dbserver.conf file to set up the Dbserver. Then you have to run a script that will start the Dbserver.

To set up the Dbserver:

1. Using a text editor, create the file Dbserver.conf in /USA_DB/.
2. Type the following in the Dbserver.conf file:

Assuming the machine name of the Dbserver is "harmonyserver", the lines in Dbserver.conf would look like this:

hostname harmonyserver

port 5678

debug_port 5680

Note: You can find the example of Dbserver.conf in /usr/local/ToonBoomAnimation/harmony_10.0/resources/samples. You can copy and paste it from there and change it accordingly.

3. Save and close the Dbserver.conf file.
4. Change the permissions on the Dbserver.conf file to 644.
In a shell, type the following:

chmod 644 Dbserver.conf

5. You must now start the Dbserver service. In a shell, type the following command:

/sbin/service USAnimation_dbserver start

A message will appear in the shell indicating that the script has been successful.

6. A log file will be generated in /tmp/tbdbserver.log. Check this file to make sure there are no errors written to the log.

Create the Toon Boom Harmony File System

After you set up and start the license and Dbserver, you are ready to create the file system for the Toon Boom Harmony database.

To create the Toon Boom Harmony file system:

1. In a shell, change directories to the root. Type:

cd /

2. Make a directory named /usadata000. Type:

mkdir usadata000

Once you have finished creating usadata000, change the permission of:

/usr/local/ToonBoomAnimation/harmony_10.0 /USA_DB and /usadata000 to 777.

chmod -R 777 /usr/local/ToonBoomAnimation/harmony_10.0 /USA_DB /usadata000

Now you are ready to test your installation on the server/stand-alone machine.

Related Topics 

Configuring Harmony to Share Scene Data