Installing a New System

After you have installed Fedora Linux, you must create the usabatch user account. A number of Toon Boom Harmony services run in the usabatch account.

You must also set the usabatch user to use the tcsh shell and you must create a .cshrc file to launch the Toon Boom Harmony environment whenever the user logs on.

You must create user accounts for all Toon Boom Harmony family users. All user accounts you create on Fedora Linux that will also run Harmony must be set up the same way as the usabatch account, except for the user name and password.

To create user accounts:

1. In a shell, login as the "root" user.
2. Using a text editor, create the file /etc/skel/.cshrc. This file should contain the following line:

umask 0

Note that this character is a zero.

3. Create the user usabatch. In a shell, type:

useradd -m -s /bin/tcsh -r usabatch

4. Enter the password for user usabatch. In a shell, type:

passwd usabatch

Then, type usabatch as a password.

To create additional users repeat steps 3 and 4. Just replace usabatch with the user name and password of the new user.


Setting umask to zero (0) ensures that Toon Boom Harmony users are able to read and write all files in the database, which is essential for people to share their work.
5. If you are not logged in as usabatch, do so by typing the following:

su - “ usabatch

6. Once logged in, open the .cshrc file in usabatch's home. Using a text editor, add the following lines:

if ( -f /usr/local/ToonBoomAnimation/harmony_10.0/etc/usa_cshrc ) then

source /usr/local/ToonBoomAnimation/harmony_10.0/etc/usa_cshrc


The .cshrc file should now contain the following:

if ( -f /usr/local/ToonBoomAnimation/harmony_10.0/etc/usa_cshrc ) then

source /usr/local/ToonBoomAnimation/harmony_10.0/etc/usa_cshrc



umask 0

7. Save and quit.
8. Log out of usabatch to return to the root user.

Install Harmony

In a client-server network or in a stand-alone set up, you must install Harmony binaries as well as the following services:

Dbserver: Controls access to the Harmony database.
License service: Controls the number of licenses and features available to Harmony users.
Batch Processing: If you are setting up the machine for batch processing this controls batch vectorizing and rendering queues.
Link Server: If you are installing Harmony on a Linux server that will support Windows clients.

To install Harmony binaries and services, you must run the installation script.

With the product activation code from the licenser, you are ready to install Harmony.

To run the installation script:

1. Decompress the distribution file.

tar xvfz [path_to_distribution_file]/[filename].tar.gz


2. Change to the directory that was extracted from the tar.gz file.
3. Run the install script as the root user, specifying the options required for your server. There are a number of options that control the installation process. For a typical Harmony server or a stand-alone machine, you would run the installation script with the following parameters:

./install -b -d -kde

With these options, the binaries are installed, and the database server is installed and set up to start automatically. These options also add Harmony entries to the KDE application menu.

If your Linuxserver will be serving Windows clients, you must add the -l option.

If you are setting up the clients for the batch render, you will add the -p parameter. It is not recommended to configure batch processing on the server, as it will slow it down.

Here is a description of all the installation options:


Default Value





Installs binaries and configuration files required to run Harmony applications.

You must include this option when doing a fresh install or when you upgrade Harmony.

You must use this option when installing Harmony on the server.




Installs the tbdbserver as a daemon. This is the Harmony database server daemon. It processes data requests from clients on the network.

This option also creates a fresh database when there is no /USA_DB directory.

You must use this option when installing Harmony on the server and on the stand-alone machine.




Displays script usage information.



Adds Harmony entries to the KDE application menu.




Installs the link_server daemon.

This daemon is required for Linux (or SGI) servers to create symbolic links for Windows clients.

If you have Windows clients, you must install this daemon on the server.




Installs the process daemon.

The process daemon manages batch processing (vectorizing and rendering) for Harmony. Usually several computers participate in the batch processing pipeline.

This parameter is required if this computer is going to batch process any files for Harmony.




Does not output any information during installation.

-target <DIRECTORY>



Directory where the installer will install the harmony_10.0 tree.




Updates the dict files in the database. Needs to be specified when upgrading from a previous version.

Related Topics