Harmony Server Installation Guide > Installing on Linux > Upgrading From a Previous Version of Toon Boom Harmony

Upgrading From a Previous Version 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 upgrading previous installations of USAnimation, Opus or Harmony, pick a time when Harmony 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.

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
1. Copy the server.ini, Manager.conf and any other files you backed up to the new installation: /usr/local/ToonBoomAnimation/harmony_11.2/etc/

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.

1. Remove the following line if it exists:

Versions 7.8 and 9.2:

source /usr/local/ToonBoomAnimation/harmony_[version]/etc/usa_cshrc

Version 7.3:

source /usa/etc/usa_cshrc

Editing the /etc/skel/.cshrc

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

Configuring the License Server

1. Depending on how the License Wizard was started, the first page will be as follows:
If this screen appears, click More Options.

If this screen appears, click Activate License.

The Activation Options screen appears.

2. Click Internet Activation

The Internet Activation Options screen appears.

3. Click Network License.

The Internet Activation - Network License screen appears.

4. In the Product Code fields, enter your product code.
5. In the License Count field, enter the number of licenses the product code grants you.
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.
6. Click Activate.

The Install License Server screen appears.

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

USE_SERVER

8. Click Finish to exit the wizard.
9. 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

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 restart

The Activation Successful screen appears.

10. Click Finish to exit the wizard.
11. 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.

/etc/exports

Updating the smb.conf