Installing Toon Boom Harmony
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:
Upgrading from a Previous Installation
If you are not upgrading from a previous installation of Toon Boom Harmony, go to Installing Toon Boom Harmony.
If you are performing an upgrade, pick a time when Toon Boom Harmony production is slow or stopped. During the upgrade, no users can run any of the Toon Boom Harmony modules and all rendering jobs must be stopped or completed.
Before you can update a previous installation of Toon Boom Harmony, you must stop all services, including:
Stopping Services Affecting Harmony
How to stop all services affecting Toon Boom Harmony
|
1.
|
Make sure that no one is running Toon Boom Harmony. All Toon Boom Harmony modules must be closed on the server and on all the clients. |
|
2.
|
Make sure that all batch rendering or vectorizing is complete or that the queues are empty. In the Control Center module, use the Queue menu to open the Vectorize and Render Queue for all environments. The queues should be empty or the status of all jobs should be "Completed". |
Upgrading from version 7.2 or earlier:
|
‣
|
From the Start menu, select All Programs > Toon Boom Harmony (or Opus) > Configuration Tools > usa_cfg. |
The USAnimation Properties window opens.
Upgrading from a previous version of 7.3:
|
‣
|
From the Start menu, select All Programs > Toon Boom Animation > Toon Boom Harmony > Tools > Harmony Control Panel. |
The Harmony Properties window opens.
Upgrading from versions 7.8, 9.2 or a previous version of 10:
|
‣
|
From the Start menu, select All Programs > Toon Boom Harmony > Tools > Control Panel. |
The Harmony Control Panel dialog box opens.
|
3.
|
From the Process Start menu, select Stop. Do this for every Toon Boom Harmony-related process running on the machine. |
You can also stop tbdbserver on the server and tbprocess on workstations that are set as a batch render.
|
4.
|
Turn off all the client machines and the render farm. |
Stopping the License Server
How to stop the license server
|
1.
|
On the License server computer, from the Start menu, select All Programs > Harmony > Configuration Tools > FLEXlm - lmtools. |
The LMTOOLS window opens.
Upgrading from version 7.3: Click the Start menu and select All Programs > Toon Boom Animation > Harmony > Tools > Flexlm Tools.
Upgrading from version 7.8: Click the Start menu and select All Programs > Toon Boom Harmony 7.8 > License Tools > Flexlm Tools.
|
2.
|
In the Start/Stop/Reread tab, select the license server from the FLEXnet license services installed on this computer list. |
|
4.
|
In the Config Services tab, click Remove Service to remove the license service. |
|
5.
|
Close the LMTOOLS window. |
Removing Harmony Related Environment Variables
To complete the installation, you need to remove some environment variables set by the previous installation.
Please do this with caution.
|
1.
|
Click the Start menu and select Control Panel. |
The Control Panel opens.
|
2.
|
Double-click on System and select the Advanced system settings link in the left panel. |
|
3.
|
In the Advanced tab, click Environment Variables. |
|
4.
|
In the System Variables panel, select LM_LICENSE_FILE if it is listed, and then click Delete button to delete LM_LICENSE_FILE. |
|
5.
|
Delete any of the following variables if they appear in the System or User variables lists: TOONBOOM_LICENSE_FILE, USADB, USADIR or USAROOT. |
Backing Up Configuration Files
You also need to back up any necessary configuration files from the machine in case you want to reuse them. You can also back up the license.dat file as well.
How to back up any necessary configuration files
|
1.
|
Do one of the following: |
|
‣
|
Version 7.8: Go to \Program Files (x86)\Toon Boom Animation\Harmony 7.8\etc. |
|
‣
|
Version 7.3: Go to \Program Files (x86)\Toon Boom Animation\Harmony\etc. |
|
‣
|
Versions 7.2 and earlier: Go to the \usa\etc folder. |
|
2.
|
Back up any of the following configuration files: |
|
‣
|
Scan.conf if this workstation is to be configured as a scanning station. |
|
‣
|
VectOptions.conf on any machine (including the server) that is doing batch vectorization. |
|
‣
|
Any other.conf file that is required to be used later. |
You can back up the entire /usa or harmony folder to ensure all configuration file are backed up.
|
3.
|
Go to the/usa/etc/flexlm folder and back up the license.dat file. |
Uninstalling the Previous Version of Toon Boom Harmony or Opus
Now you will uninstall the previous version of Harmony or Opus.
How to uninstall the previous version of Harmony or Opus.
|
1.
|
From the Start menu, select Control Panel. |
The Control Panel opens.
|
2.
|
Double-click on Program and Features and select Harmony or Opus. |
|
3.
|
From the top menu, click Uninstall. |
|
5.
|
Back up the database. For the server upgrading process, back up the database by exporting the entire database. This will prevent you from losing any data during the upgrading process. You can, however, back up the current /usa_db and /usadata by renaming them (this procedure can only be used when installing on the same server). This requires extra caution. If you are at all unsure, contact your system administrator or Toon Boom Support. |
Installing Toon Boom Harmony
How to run the installation script
|
1.
|
Download the build of Harmony that you are going to install. |
|
2.
|
Double-click on the Harmony InstallShield executable. |
|
3.
|
Select the language for the installer and click OK. This will only affect the language of the installer, not the Harmony software. |
|
4.
|
In the InstallShield Welcome window, click Next to continue with the installation. |
The License Agreement dialog box opens.
|
5.
|
Read the license agreement and decide if you accept its terms. |
|
‣
|
If you accept the terms in the license agreement, select I accept the terms in the license agreement and click Next. |
|
‣
|
If you do not accept the terms in the license agreement, click I do not accept the terms in the license agreement and then click Next. |
The installation will stop immediately and Toon Boom Harmony will not be installed on your computer.
The Destination Folder dialog box appears. You can click Cancel to interrupt the installation and then click Yes to stop the installation completely.
You can install Toon Boom Harmony to any location. This document assumes that the installation will be done at the default location.
|
6.
|
Select the drive on which you want to install Toon Boom Harmony and click Next. |
The Setup Type dialog box appears.
|
7.
|
Select the type of installation you want to do. Select the Complete option to install all the Harmony Network components. When installing a server, it is possible to do a custom install and install only the server component. However, it is recommended to always do a full install as this will give you access to all the applications from the server if need be. |
The Ready to Install the Program dialog appears.
|
9.
|
Click Install again to begin the installation. |
|
10.
|
When this process is complete, click Finish. |