Installation Guide > Harmony Installation Guide > Installing on Mac OS X > Pre-installation
Download Toon Boom DocumentationDownload Documentation

Pre-installation

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

Check Your Minimum Requirements
Get the Product Activation Code
Prerequisites for Harmony Installation

For the most current Toon Boom Harmony 10.3 hardware requirements, refer to the white paper Harmony and Your IT Department. This is available from:

Toon Boom Animation Sales Representative
Toon Boom Animation Support at: support@toonboom.com

You should obtain a Product Activation code from the Toon Boom licenser so that you can finish the installation process without having to wait for the activation code to arrive.

To obtain a Harmony 10.3 activation code, please send the following information to: licensor@toonboom.com.

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

A DNS server must be configured on the network to be able to run Harmony. All the computers running Harmony must be registered with this server or Harmony will not be able to 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.

Editing the hosts File
Editing the launchd.conf File

Editing the hosts File

To edit the host file:

1. Make sure the server and all the client workstations are configured with a static (fixed) IP address.
2. Open the Terminal (/Application/Utilities/Terminal).
3. From Terminal go to /etc folder by typing the following:

cd /etc

4. Create a backup copy of the hosts file. You need to be logged in using the root account to be able to do this. If you are not logged in as the root user, you will need to type sudo before launching the command.

sudo cp hosts hosts.bak

5. Edit the /etc/hosts file using the vi text editor. To do this, you need to be logged in with the root account. If not, you must type sudo before launching the command.
For example: sudo vi hosts
6. Once the file is opened in the editor, press the [i] key to trigger the insert mode.
7. Go to the end of the file and add a new line. On this new line, type the static IP address and the machine name (hostname) of the server.

For example, if the server name is server and the IP address is 192.168.1.1, type 192.168.1.1 server on this new line. 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). Add the FQDN after the hostname separating them with a space.

For example, 192.168.1.1 server server.toonboom.com

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

8. Once all the IP and hostnames have been typed, you will need to save the file. To do this, press [ESC] to exit the insert mode.
9. Press the [:] button. The [:] should appear on the bottom of the Terminal, if it does not then you are still in insert mode. Make sure you did not type the colon somewhere in the files and press the ESC key again to exit insert mode.
10. Type the letter w. You should now have the following typed at the bottom of the Terminal:

:w

11. Press the return key. The file was written.
12. To exit vi type: followed by the letter q. You should now have the following at the bottom of the Terminal:

:q

13. Press the return key to quit vi.

The system will return you to /etc in the Terminal.

14. Verify the content of the hosts file by typing:

more hosts

15. Once this is verified, copy and paste the hosts file to all of the client machines.

Editing the launchd.conf File

1. Open the Terminal (/Application/Utilities/Terminal).
2. From Terminal, go to /etc folder by typing the following:

cd /etc

3. If the /etc/launchd.conf file already exists, create a backup copy of it by typing:

cp launchd.conf launchd.conf.bak

4. Edit the /etc/launchd.conf file using the vi text editor. To do this, you must be logged in with the root account. If not, you must type sudo before launching the command.
For example: sudo vi launchd.conf
5. Once the file is opened in the editor, press the [i] key to trigger the insert mode.
6. At the beginning of the file, add a line with the following text:

umask 0

7. Once finished, you will need to save the file. To do this, press [ESC] to exit the insert mode.
8. Press the [:] button. The : should appear on the bottom of the Terminal,: if it does not, then you are still in insert mode. Make sure you did not type the colon anywhere in the file and press the [ESC] key again to exit insert mode.
9. Type the letter w. You should now see the following at the bottom of the Terminal:

:w

10. Press the return key. The file is written.
11. To exit vi type :q. You should now see the following at the bottom of the Terminal:

:q

12. Press the return key to quit vi.

The system will return you to /etc in the Terminal.

13. Verify the content of the launchd.conf file by typing:

more launchd.conf

Related Topics 

Harmony Installation