Harmony Server Installation > Installing on Linux > Installing a New System

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.

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.

In a client-server network or in a standalone setup, you must install Harmony binaries and 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 in hand, you are ready to install Harmony.

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.

-cloudserver

-c

Inactive

Installs Harmony Cloud as a service. This parameter is required if this machine is the Harmony Cloud web 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_12.1

Directory where the installer will install the harmony_12.1 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.