Updating Previous Versions on Linux

1. Verify that no one is running any versions of USAnimation, Opus or Toon Boom Harmony. All of their nodes must be closed on the server and all the clients.

2. Verify that all batch rendering and vectorizing are completed or that the queues are empty. You can check the status of Vectorize and Render queues from the Control Center module.

‣

In the Control Center module, use the Queue menu, Environment > Vectorize Queue or Render Queue to open the Vectorize queue or Rendering queue for each environment. The queue should either be empty or the status of all jobs should be Completed.

3. Stop all services running on the server and the clients. Depending on the services you have running, type the following commands in the order presented:

/etc/init.d/USAnimation_queues stop

/etc/init.d/USAnimation_link_srv stop

/etc/init.d/USAnimation_dbserver stop

/etc/init.d/USAnimation_webcc stop

/etc/init.d/USAnimation_flexlm stop

4. Back up Harmony's configuration files by copying them to a location where you can recover them later. Go to the folder where the previous version of Harmony is installed and back up the configuration files in the etc folder:

• Version 12 and later: /usr/local/ToonBoomAnimation/harmony[edition]_[version]/etc
• Version 7.8 to 11.2: /usr/local/ToonBoomAnimation/harmony_[version]/etc
• Version 7.5 and earlier:/usa/etc

Back up the following configuration files:

Manager.conf

Scan.conf (If a scanner was configured to run with the Harmony Scan node on this computer)

server.ini (If the server is configured to receive connections from Windows clients)

VectOptions.conf (If a vectorization preset had been added to it)

If plug-ins were added to the Harmony installation, back up these files as well.

• Version 12 and later:/usr/local/ToonBoomAnimation/harmony[edition]_[version]/lnx86_64/plugins
• Version 10.0 to 11.2: /usr/local/ToonBoomAnimation/harmony_[version]/lnx86_64/plugins
• Version 7.8 and 9.2: /usr/local/ToonBoomAnimation/harmony_[version]/lnx86/plugins
• Version 7.5 and earlier: /usa/lnx86/plugins

You can back up the entire Harmony folder by renaming it to make sure all config files are kept.

5. Clean the menu. The shortcut to start the previous application should be removed from the menu. There are two ways to do this:

• Delete them from the command line by doing the following:

Change to:

cd /usr/share/applnk

• Delete the old shortcuts:

Version 7.8 and later: rm ToonBoom-Harmony_*

Version 7.5 and earlier: rm USAnimation-*

The shortcuts will be removed from the menu the next time you log in.

6. Uncompress the distribution file:

tar xvfz [path_to_distribution_file]/[filename].tar.gz

7. Switch to the directory that was extracted from the tar.gz file.

8. Run the install script specifying the options required for your server.
   ./install -b -d -l -p -u -kde

Option	Default Value	Details
-binaries -b	Inactive	Installs binaries and configuration files required to run Harmony applications. Include this option when performing a fresh install or when you upgrade Harmony. Use option when installing Harmony on the server.
-dbserver -d	Inactive	Installs the tbdbserver as a daemon. This is the Harmony database server daemon. It processes data requests from clients on the network. This option also creates a fresh database when there is no /USA_DB directory. Use this option when installing Harmony on the server and on the standalone machine.
-help -h	Inactive	Displays script usage information.
-kde	Inactive	Adds Harmony entries to the KDE application menu.
-linkserver -l	Inactive	Installs the link_server daemon. This daemon is required for Linux or IRIX servers to create symbolic links for Windows clients. If you have Windows clients, you must install this daemon on the server.
-process -p	Inactive	Installs the process daemon to manage batch processing (vectorizing and rendering) for Harmony. Usually several computers participate in the batch processing pipeline. This parameter is required if this computer is going to batch process files for Harmony.
-quiet -q	Inactive	Does not output any information during installation.
-schemeregister -s	Inactive	Registers Harmony URLs to open in harmony[edition]_14 with the compatible desktop specified in the DE environment variable (using xdg-open).
-target <DIRECTORY> -t <DIRECTORY>	/usr/local/ ToonBoomAnimation/harmony[edition]_14	Directory where the installer will install the harmony[edition]_14 tree.
-updatedict -u	Inactive	Updates the dict files in the database. Needs to be specified when upgrading from a previous version.
-webccserver -w	Inactive	Installs the Web Control Center as a daemon.