Upgrading From a Previous Installation of Toon Boom Harmony

At this point, it is assumed that the USAnimation, Opus or Toon Boom Harmony binaries (program files) are installed on the Toon Boom Harmony server and are mounted by all the Linux clients. When you update the installation on the server, all clients will load the new binaries from the central mount point.

When 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.

Restoring Backed Up Files
Editing usabatch's .cshrc
Editing Other Users' .cshrc
Editing the /etc/skel/.cshrc
Configuring the License Server
Restarting the Harmony Services
Updating the nfs Export
Updating the smb.conf
Verifying the Parameters Required in the smb.conf File

Restoring Backed Up Files

Copy the server.ini, Manager.conf and any other files you backed up to the new installation:


Editing usabatch's .cshrc

Before you can start the Harmony services, you must make modifications to the .cshrc in usabatch's home.

Editing Other Users' .cshrc

The.cshrc of all other users of Harmony should be edited to remove the lines that are used to source the usa_cshrc file. It is not required to source this file any longer as the path to the application was added to the PATH variable via the files in /etc/profile.d.

Editing the /etc/skel/.cshrc

Open the file /etc/skel/.cshrc (if it exists) and remove the lines that source the usa_cshrc file.

Configuring the License Server

Now that you have installed Harmony, you must set up the licensing so it can run on the server and client machines.

  1. Do one of the following:

Start the License Wizard:


Start Harmony.

The Welcome screen appears.

  1. Click Activate License.

The Activation Options screen appears.

  1. Click Internet Activation.

The Internet Activation Options screen appears.

  1. Click Network License.

The Internet Activation - Network License screen appears.

  1. Do the following:
In the Product Code field, enter your product code.
In the License Count field, enter the number of licenses the product code grants you.

NOTE: Once activated and returned to the activation server, a server license cannot be activated again. Make sure you are activating the license on the correct computer with the proper license count.
  1. Click Activate.

The Install License Server screen appears.

  1. Click Install License Server.

The license.dat file is created in /usr/local/flexlm/licenses/license.dat. The License Server is also configured and started.

The license.dat created contains the following:

SERVER this_host 0 ANY

VENDOR toonboom



Both steps can be done manually if needed.

To configure the License Server to start automatically at boot:

/sbin/chkconfig/USAnimation_flexlm on

To start the License Server manually:

/etc/init.d/USAnimation_flexlm start

The Activation Successful screen appears.

  1. Click Finish to exit the wizard.
  1. Verify that the FlexLM license is working properly:

lmutil lmstat -a

You can can also look at the log:

less /tmp/lmgrd.log

If the FlexLM service needs to be restarted:

/etc/init.d/USAnimation_flexlm restart

Restarting the Harmony Services

Updating the nfs Export

If the Linux server has Linux or Mac OS X clients, the nfs exports need to be updated with the path of the new Harmony binaries.

Updating the smb.conf

When upgrading a Linux server, a small modification must be made to the usa share path to point to the new install. "/etc/samba/smb.conf" and change the path under the [usa] share to the path of the new Harmony install.