Installing a New System

After you have installed CentOS Linux, you must create the usabatch user account in which many Toon Boom Harmony services run.

Then you can install Harmony. There are a number of options you can choose from when installing Harmony.

Creating the usabatch User

With CentOS Linux installed, you will create the usabatch user account. You must also set the usabatch user to use the tcsh shell and create a .cshrc file to start the Toon Boom Harmony environment whenever the user logs on.

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

ClosedHow to create user accounts
  1. In a shell, log in as the root user.
  1. Using a text editor, create the file /etc/skel/.cshrc. This file should contain the following line:

umask 0

NOTE: The above character is a zero.
  1. Create the user usabatch.

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

NOTE: Make sure tcsh is installed in /bin/tcsh. If it is not, install it using yum install tcsh.
  1. Enter the password for user usabatch.

passwd usabatch

Then, type usabatch as a password.

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

NOTE: Setting umask to zero (0) ensures that Toon Boom Harmony users can read and write all files in the database, which is essential for sharing their work.
  1. If you are not logged in as usabatch:

su - usabatch

  1. Open the .cshrc file in usabatch's home. The .cshrc file should contain the following:

if ( -f /usr/local/ToonBoomAnimation/harmony[edition]_12/etc/usa_cshrc ) then

source /usr/local/ToonBoomAnimation/harmony[edition]_12/etc/usa_cshrc

endif

 

umask 0

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

Installing Harmony

In a client-server network or in a standalone setup, you must install Harmony, as well as the following services on the server or the standalone computer:

tbdbserver Controls access to the database.
License service Controls the number of licenses and features available to Harmony users.
Batch processing Controls batch vectorizing and rendering queues.
Web Control Center Allows download and upload of scenes from the database.
Link server If you are installing Harmony on a Mac OS X server that will support Windows clients, you must install the Link server.

To install Harmony programs and services, you must run the installation package. Before you start the installation, make sure you are currently logged in the system with administrator rights on your local computer.

ClosedHow to run the installation script
  1. Uncompress the distribution file.

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

  1. Change to the directory that was extracted from the tar.gz file.
  1. 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 standalone machine, 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 application menu.

If your Linux server will be serving Windows clients, add the -l option.

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

Installation Options

Option

Default Value

Details

-binaries

-b

Inactive

Installs binaries and configuration files required to run Harmony applications.

Include this option when performing a fresh install or when you upgrade Harmony.

Use option when installing Harmony on the server.

-dbserver

-d

Inactive

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.

Use this option when installing Harmony on the server and on the standalone machine.

-help

-h

Inactive

Displays script usage information.

-kde

Inactive

Adds Harmony entries to the KDE application menu.

-linkserver

-l

Inactive

Installs the link_server daemon.

This daemon is required for Linux or IRIX servers to create symbolic links for Windows clients.

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

-process

-p

Inactive

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 files for Harmony.

-quiet

-q

Inactive

Does not output any information during installation.

-target <DIRECTORY>

-t <DIRECTORY>

/usr/local/
ToonBoomAnimation/harmony[edition]_12

Directory where the installer will install the harmony[edition]_12 tree.

-udatedict

-u

Inactive

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

-webccserver

-w

 Inactive Installs the Web Control Center as a daemon.

The content reflects the features found in the latest Harmony 12.2.1 release. To download the latest upgrade, go to https://www.toonboom.com/my-downloads

For comments and feedback, contact: ...

© 1994–2015 Toon Boom Animation Inc. All rights reserved
Toon Boom Animation Inc., a Corus® Entertainment Inc. Company