Pre-installation
Before installing Toon Boom Harmony 11.2, you must perform the following tasks:
| • | Checking Your Minimum Requirements |
| • | Getting the Product Activation Code |
| • | Prerequisites for Harmony Installation |
Checking Your Minimum Requirements
For the most current Toon Boom Harmony 11.2 hardware requirements, refer to the white paper Harmony and Your IT Department available from:
| • | Toon Boom Animation Sales Representative |
| • | Toon Boom Animation Support at: support@toonboom.com |
Getting the Product Activation Code
You should obtain a Product Activation code from the Toon Boom licensor so that you can finish the installation process without having to wait for the activation code to arrive.
To obtain a Toon Boom Harmony 11.2 activation 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 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
How to edit the hosts 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 the Terminal, go to the /etc folder: |
cd /etc
| 4. | Create a backup copy of the hosts file. You must be logged in using the root account. If not, type sudo before launching the command. |
sudo cp hosts hosts.bak
| 5. | Edit the /etc/hosts file using the vi text editor. |
| 6. | Once the file is opened in the editor, press ito trigger the insert mode. |
| 7. | 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.
| 8. | Save the file by pressing Esc to exit the insert mode. |
| 9. | Press colon (:). |
A colon appears at the bottom of the Terminal. If not, then you are still in insert mode. Make sure you did not type the colon somewhere in the files. Press Esc again to exit insert mode.
| 10. | Type wq. |
The following appears at the bottom of the Terminal.
:wq
| 11. | Press the Return key. |
The file is written and the system returns you to /etc in the Terminal.
| 12. | Verify the content of the hosts file: |
more hosts
| 13. | Copy and paste the hosts file to all the client machines. |
Editing the launchd.conf File
How to edit the launchd.conf file
| 1. | Open the Terminal: |
/Application/Utilities/Terminal
| 2. | From the Terminal, go to the /etc folder: |
cd /etc
| 3. | If the /etc/launchd.conf file already exists, create a backup copy: |
cp launchd.conf launchd.conf.bak
| 4. | Edit the /etc/launchd.conf file using your favourite text—see Editing Files. |
| 5. | Once the file is opened in the editor, press ito trigger the insert mode. |
| 6. | At the beginning of the file, add a line with the following: |
umask 0
| 7. | Save the file by pressing Esc to exit the insert mode. |
| 8. | Press colon (:). |
A colon appears at the bottom of the Terminal. If not, then you are still in insert mode. Make sure you did not type the colon somewhere in the files. Press Esc again to exit insert mode.
| 9. | Type wq. |
The following appears at the bottom of the Terminal.
:wq
| 10. | Press the Return key. |
The file is written and the system returns you to /etc in the Terminal.
| 11. | Verify the content of the launchd.conf file: |
more launchd.conf