Harmony Installation
Now that you have verified the minimum requirements and configured your hardware and software, you are ready to install Toon Boom Harmony.
Here is what you will be doing:
Upgrading from a Previous Installation
When upgrading previous installations of Harmony or Opus, 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 completed.
How 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 the clients. |
|
2.
|
Verify that all batch rendering and vectorizing is completed 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". |
Be sure to stop the queues on all rendering machines. If the queues are running, those binaries will be locked and the installer cannot update them.
|
3.
|
Stop all services running on the server and the clients. |
|
‣
|
If you are upgrading from version 7.3 and later, 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 in 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: |
|
‣
|
Version 7.8 and later: /Applications/Toon Boom Harmony [version]/tba/etc |
|
‣
|
Version 7.3: /Applications/Toon Boom Harmony/usa.bundle/etc |
|
5.
|
Back up any necessary configuration files: |
|
‣
|
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 back up the entire application folder to ensure that no configuration file is missed. |
|
6.
|
Go to /usr/local/flexlm/licenses/ (/usa/etc/flexlm/ if you are upgrading from version 7.2 folder and back up the license.dat file. |
|
7.
|
Delete the /Applications/Toon Boom Harmony [version] 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. For example: |
|
‣
|
Version 7.2 and later: From /Library/StartupItems/, delete any folders that begin with USAnimation, such as USAnimation_dbserver. |
|
‣
|
Version 7.3 and later: Delete any folders that begin with ToonBoom, such as ToonBoomDatabaseServer. |
Depending on the server and client configuration, you might not see any folders starting with Toonboom or USAnimation.
Deleting Files in Each User's Home
If you are upgrading from Harmony or Opus, you must also delete extra files that are located in each user's home.
How to delete files in each user's home
/Application/Utilities/Terminal
|
2.
|
Go to a user's home that was configured to work with Harmony. Using the usabatch account as an example: |
cd /Users/usabatch
|
3.
|
List all the files in usabatch's home: |
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: |
sudo rm -rf .MacOSX
|
6.
|
Repeat these steps for each user that was configured to work with a previous version of Harmony. |
Creating the usabatch User
Before you install Harmony, you must create the usabatch user account on the server and on all the workstations that will performing 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.
The usabatch
account must have administrator 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.
How 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: |
|
‣
|
Version 10.6 (Snow Leopard): Click Accounts. |
|
‣
|
Version 10.7 (Lion): Click Users & Groups. |
|
‣
|
Version 10.8 (Mountain Lion): |
|
‣
|
Version 10.9 (Mavericks): Click Users & Groups. |
The Password tab of the Accounts window opens.
|
3.
|
To make changes to the accounts on a Mac OS X, click the lock icon at the bottom of the window. Enter your username and password for an account that has administrator privileges. |
|
4.
|
Click the plus (+) 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 menu next to New Account. |
|
‣
|
Version 10.6 (Snow Leopard): Click Create Account. |
|
‣
|
Version 10.7 (Lion): Click Create User. |
|
‣
|
Version 10.8 (Mountain Lion): |
|
‣
|
Version 10.9 (Mavericks): Click Create User. |
|
8.
|
Once the account is created, open the Terminal and log in as the usabatch user: |
su -l usabatch
|
9.
|
Make sure you are in home folder of usabatch , then edit or create the .profile for usabatch: |
.profile
|
10.
|
Press i to trigger the insert mode. |
|
11.
|
Make sure the file contains the following lines: |
#!/bin/bash
umask 0
|
12.
|
Press Esc to exit the insert mode, then type :wq to write the file and exit vi. |
Installing Harmony
In a client-server network or in a standalone setup, you must install Harmony, as well as the following services on the server or the standalone 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, make sure you are currently logged in the system with administrator rights on your local computer.
How to get administrator privileges
|
1.
|
Open System Preferences. By default, there is a shortcut for System Preferences in the Dock. |
|
2.
|
In the System Preferences dialog box, do one of the following: |
|
‣
|
Version 10.6 (Snow Leopard): Click Accounts. |
|
‣
|
Version 10.7 (Lion): Click Users & Groups. |
|
‣
|
Version 10.9 (Mavericks): Click Users & Groups. |
The Password tab of the Accounts window opens.
|
3.
|
Select your user login account and verify if the Allow user to administer this computer option is selected. To make changes to the accounts on a Mac OS X, click the lock icon at the bottom of the window. Enter your username and password for an account that has administrator privileges. |
How to install Harmony
|
1.
|
Double-click the Harmony .dmg file. |
|
2.
|
Drag the Toon Boom Harmony 11.2 folder from the .dmg file to the Applications folder. |