Installation Guide > Harmony Installation Guide > Installing on Mac OS X > Harmony Installation

Harmony Installation

Now that you have verified your minimum requirements, and configured your hardware and software, you are ready to install Toon Boom Harmony.

You will perform the following tasks:

1. Upgrade from a Previous Installation
2. Creating the usabatch User
3. Install Harmony

When upgrading from a previous installation of Harmony or Opus, you should pick a time when Harmony or Opus production is slow or stopped. During the upgrade, no users can run any of the Harmony or Opus modules and all rendering jobs must be complete. To update previous installations:

1. Make sure that no one is running any versions of Harmony or Opus. All Harmony or Opus modules must be closed on the server and on all of the clients.
2. Make sure that all batch rendering and vectorizing is complete or that the queues are empty. You can check the status of the Vectorize and Render queues from the Control Center module.
In the Control Center module, use the Queue menu to open the Vectorize and Render Queue for all environments. The Queues should either be empty or the status of all jobs should be "Completed".

You must be sure to stop the queues on all rendering machines. If the queues are running, those binaries will be locked and the installer won't be able to update them.

3. Stop all services running on the server and the clients.
If you are upgrading from 7.3, 7.8, 9.2 or 10.0, type in the terminal:

sudo /sbin/SystemStarter stop ToonBoomQueueServer

sudo /sbin/SystemStarter stop ToonBoomLinkServer

sudo /sbin/SystemStarter stop ToonBoomDataBaseServer

sudo /sbin/SystemStarter stop ToonBoomLicense

If you are upgrading from Harmony or Opus 7.2, type the following into the terminal:

sudo /sbin/SystemStarter stop USAnimation_queues

sudo /sbin/SystemStarter stop USAnimation_link_srv

sudo /sbin/SystemStarter stop USAnimation_dbserver

sudo /sbin/SystemStarter stop USAnimation_flexlm

4. Go to the applicable folder:
10.0: /Applications/Toon Boom Harmony 10/tba/etc
9.2: /Applications/Toon Boom Harmony 9.2/tba/etc
7.8: /Applications/Toon Boom Harmony 7.8/tba/etc
7.3: /Applications/Toon Boom Harmony/usa.bundle/etc
7.2: /usa/etc
5. Backup any necessary configuration files.
Manager.conf
server.ini: if this server is configured to have Windows clients.
Scan.conf: if this workstation is configured to be a scanning station.
VectOptions.conf: from any machine (including the server) that is doing batch vectorization.
Any other configuration file that is required to be used later.
You can backup the whole /Harmony folder to ensure that no configuration file is missed.
6. Go to /usr/local/flexlm/licenses/ (/usa/etc/flexlm/ if you are upgrading from 7.2) folder and back up the license.dat.
7. Then you can delete the /Applications/Toon Boom Harmony folder, or rename it to keep as a backup.
8. If you are upgrading from a previous version of Harmony or Opus, you must delete Startup Items from the previous installation.

From /Library/StartupItems/, delete any folders that begin with USAnimation if you are upgrading from 7.2. For example, USAnimation_dbserver. Delete any folders that begin with ToonBoom if you are upgrading from 7.3, 7.8,9.2 or 10.0. For example, ToonBoomDatabaseServer.

 

Depending on the server and client configuration, you may not see any folders starting with Toonboom or USAnimation.

If you are upgrading from Harmony or Opus, you will also need to delete extra files that are located in each users home.

1. Open the Terminal application (/Applications/Utilities/Terminal).
2. Go to a users' home that was configured to work with Harmony. We will use the usabatch account as an example. To do so, type:

cd /Users/usabatch

3. List all the files in usabatch's home by typing:

ls -lsa

4. Look for a folder named .MacOSX in the list of files and folders that appear.
5. If the folder is there, delete it with the following command:

sudo rm -rf .MacOSX

6. Repeat these steps for each user that was configured to work with a previous version of Harmony.

Before you install Harmony you must create the usabatch user account on the server and on all the workstations that will be doing batch processing (computers that will be part of the batch rendering or vectorizing farm). A number of services, including the tbdbserver, license server and batch processing, are started using the usabatch account. In addition to the server, be sure to create the usabatch account on all machines that may perform batch processing.

The usabatch account must have administrative rights on the computer.

 

If you are upgrading from a previous version of Harmony or Opus, you may not need to create the usabatch account since you will use the same account that was created from the previous installation.

To create the usabatch user account:

1. Open System Preferences. By default, there is a shortcut for System Preferences in the Dock.
2. In the System panel of the System Preferences dialog box:
10.6 (Snow Leopard): Click Accounts.
10.7 (Lion): Click Users & Groups.

The Password tab of the Accounts window opens.

3. To be able to make changes to the accounts on a Mac OS X, you must first click the lock at the bottom of the window. A dialog box will appear asking you to type your username and password. Type the username and the password of an account that has administrative privileges.
4. Click the + sign button to add a new user.
5. Give the new user the following name, account name and password:

usabatch

The usabatch account name and password must be in all lower-case letters.

6. Select Administrator from the drop-down menu next to New Account.
7. Create the account:
10.6 (Snow Leopard): Click Create Account.
10.7 (Lion): Click Create User.
8. Once the account is created, open the terminal and login as the usabatch user:

su -l usabatch

9. Make sure you are in usabatch's home folder, then edit or create the .profile for usabatch:

vi .profile

10. Make sure the file contains the following lines:

#!/bin/bash

umask 0

11. Once done, click on [ESC] to exit the insert mode, then type :wq to write the file and exit vi.

In a client-server network or in a stand-alone set up, you must install Harmony as well as the following services on the server or the stand-alone 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.
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, you need to make sure you are currently logged in the system with administrative rights on this local computer. You can check it from System Preferences.

1. Open System Preferences. By default, there is a shortcut for System Preferences in the Dock.
2. In the System panel of the System Preferences dialog box:
10.6 (Snow Leopard): Click Accounts.
10.7 (Lion): Click Users & Groups .

The Password tab of the Accounts window opens.

3. Select your user login account and verify if Allow user to administer this computer is checked. If not, please login to the system with an administrative account and do so.

To install Harmony:

1. Double-click the Harmony dmg file.
2. Drag the Toon Boom Harmony 10 folder from the dmg file to the Applications folder.

Related Topics 

Configuration