Pre-installation

Before installing Toon Boom Harmony, you must perform the following tasks:

• Pre-installation
• Obtaining the Product Code
• Prerequisites for Harmony Installation

Verifying the Minimum Requirements

For the most current Toon Boom Harmony hardware requirements, visit:

• toonboom.com/products/harmony/system-requirements

You can also refer to the Harmony and Your IT Department white paper available from:

• Toon Boom Animation Sales Representative
• Toon Boom Animation Support at: store.toonboom.com/contact/support.

Obtaining the Product Code

You should obtain a product code from the Toon Boom licensor, so you can finish the installation process without having to wait for the activation code to arrive.

To obtain a Harmony 12.2.1 product code, send the following information to: licensor@toonboom.com.

• Your name and the name of your company
• Email address where to send the license file

Editing Files

• When editing files, you can use your favourite text editor. In this guide, all the Mac OS X procedures use the vi text editor.
• You must be logged in using the root account. If not, type sudo before launching the command. For example:

sudo vi hosts

Prerequisites for Harmony Installation

A DNS server must be configured on the network in order to run Harmony. All the computers running Harmony must be registered with this server or Harmony cannot run properly. If a DNS server is not configured on the network or if Harmony workstations are having problems resolving the name of the server, the name of the server and each client along with their IP address should be added to the /etc/hosts file on each computer.

ClosedHow to edit the hosts file
  1. Make sure the server and all the client workstations are configured with a static (fixed) IP address.
  1. Open the Terminal:

/Application/Utilities/Terminal

  1. From the Terminal, go to the /etc folder:

cd /etc

  1. Create a backup copy of the hosts file.

cp hosts hosts.bak

  1. Edit the /etc/hosts file using the vi text editor.
  1. Go to the end of the file and add a new line. Type the static IP address and the machine name (hostname) of the server. Make sure there is a space between the IP address and the hostname.

If there is a domain configured on the network, you should also type the Fully Qualified Domain Name (FQDN) after the hostname and separate them with a space.

Example: 192.168.1.1 server server.toonboom.com

To complete this step, add the IP address and the hostname of each workstation that will be a client of the Harmony server. Each of them should be typed on a new line.

  1. Save the exit the file.

The file is written and the system returns you to /etc in the Terminal.

  1. Verify the content of the hosts file:

more hosts

  1. Copy and paste the hosts file to all the client machines.
ClosedHow to edit the launchd.conf file
  1. Open the Terminal:

/Application/Utilities/Terminal

  1. From the Terminal, go to the /etc folder:

cd /etc

  1. If the /etc/launchd.conf file already exists, create a backup copy:

cp launchd.conf launchd.conf.bak

  1. Edit the /etc/launchd.conf file using your favourite text editor—see Editing Files.
  1. At the beginning of the file, add a line with the following:

umask 0

  1. Save the file and exit.

The file is written and the system returns you to /etc in the Terminal.

  1. Verify the content of the launchd.conf file:

more launchd.conf

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