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 |
- 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.
- 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. |
- 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
/etc/init.d/
as the Harmony install script will update them automatically. It's important to stop the queues on all rendering machines. If the queues are running, those binaries will be locked and the installer cannot update them.
- 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.
- 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.
- Uncompress the distribution file:
tar xvfz [path_to_distribution_file]/[filename].tar.gz
- Switch to the directory that was extracted from the
tar.gz
file. -
Run the install script specifying the options required for your server.
./install -b -d -l -p -u -kde
Option |
Default Value |
Details |
|
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. |
|
Inactive |
Installs the This option also creates a fresh database when there is no Use this option when installing Harmony on the server and on the standalone machine. |
|
Inactive |
Displays script usage information. |
|
Inactive |
Adds Harmony entries to the KDE application menu. |
|
Inactive |
Installs the 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. |
|
Inactive |
Installs the The This parameter is required if this computer is going to batch process files for Harmony. |
|
Inactive |
Does not output any information during installation. |
|
|
Directory where the installer will install the |
- - |
Inactive |
Updates the |
- - |
Inactive | Installs the Web Control Center as a daemon. |
Restoring Backed Up Files
‣ | Copy the server.ini , Manager.conf and any other files you backed up to the new installation: |
/usr/local/ToonBoomAnimation/harmony[edition]_12/etc/
Editing usabatch's .cshrc
Before you can start the Harmony services, you must make modifications to the .cshrc
in usabatch
's home.
- If you are not logged in as
usabatch
, type the following:
su - usabatch
- Open the .
cshrc
file in usabatch's home:
vi .cshrc
- Edit
.cshrc.
if ( -f /usr/local/ToonBoomAnimation/harmony[edition]_12/etc/usa_cshrc ) then
source /usr/local/ToonBoomAnimation/harmony[edition]_12/etc/usa_cshrc
endif
umask 0
- Save and quit.
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
.
‣ | 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
‣ | 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.
-
Start the License Wizard:
/usr/local/ToonBoomAnimation/harmony[edition]_12.1/lnx86_64/bin/LicenseWizard
- Start Harmony.
The Welcome screen appears.
- Click Activate License.
The Activation Options screen appears.
- Click Internet Activation.
The Internet Activation Options screen appears.
- Click Network License.
The Internet Activation - Network License screen appears.
- 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. |
- Click Activate.
The Install License Server screen appears.
- 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
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.
- Click Finish to exit the wizard.
- 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
- Once the license is properly configured and started, start the Harmony services that are required on your server in the following order:
/etc/init.d/USAnimation_dbserver restart
/etc/init.d/USAnimation_link_srv restart
/etc/init.d/USAnimation_queues restart
- Check the logs to verify that the services started properly.
/tmp/lmgrd.log
/tmp/tbdbserver.log
/tmp/tbprocess.log
/tmp/Link_srv.log
- Start Harmony and open a scene to see if the server works properly.
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.
- Open the file
/etc/exports
. If it exists, change the path of :/usa
to/usr/local/ToonBoomAnimation/harmony[edition]_12
/USA_DB *(rw,sync)
/usadata000 *(rw,sync)
/usr/local/ToonBoomAnimation/harmony[edition]_12 *(rw,sync)
- Run the following command to apply the change:
/usr/sbin/exportfs -r
- Test the exports:
/usr/sbin/showmount -e
Export list for [hostname].toonboom.com:
/USA_DB *
/usadata000 *
/usr/local/ToonBoomAnimation/harmony[edition]_12 *
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.
- Edit
/etc/samba/smb.conf
and and change the path under the[usa]
share to the path of the new Harmony install.
[usa]
comment = Harmony binaries & stuff
browseable = yes
read only = no
guest ok = no
create mask = 0777
directory mask = 0777
path = /usr/local/ToonBoomAnimation/harmony[edition]_12
- Once the file is saved, verify that you have not made any basic syntax errors:
testparm
The shell output should look like this:
Load smb config files from /etc/samba/smb.conf
Processing section "[homes]"
Processing section "[printers]"
Processing section "[USA_DB]"
Processing section "[usa]"
Processing section "[usadata000]"
Processing section "[tmp]"
Loaded services file OK.
Server role: ROLE_STANDALONE
- Press Enter to see a dump of your service definitions.
If the smb.conf
was configured according to the 7.3 documentation, the testparm
command may return the following error:
Level II oplocks can only be set if oplocks are also set.
To get rid of this error, add the level2 oplocks = No
parameter in the global section of the smb.conf
—see Verifying the Parameters Required in the smb.conf File for all the parameters required in the smb.conf
.
- Restart
smb
:
/etc/init.d/smb restart
Verifying the Parameters Required in the smb.conf File
It is always a good idea to verify the configuration of the smb.conf
file.
- Verify the configuration of the
smb.conf
.
/etc/samba/smb.conf
Parameters needed in the [global] section:
encrypt passwords = no
blocking locks = no
oplocks = no
level2 oplocks = no
follow symlinks = yes
unix extensions = no
wide links = yes
Default parameters for the shares:
[USA_DB]
comment = Toon Boom Harmony Database
browseable = yes
read only = no
guest ok = no
create mask = 0777
directory mask = 0777
path = /USA_DB
[usa]
comment = Toon Boom Harmony binaries & stuff
browseable = yes
read only = no
guest ok = no
create mask = 0777
directory mask = 0777
path = /usr/local/ToonBoomAnimation/harmony[edition]_12
[usadata000]
comment = Toon Boom Harmony data 000
browseable = yes
read only = no
guest ok = no
create mask = 0777
directory mask = 0777
path = /usadata000
- Always perform a
testparm
after making changes to thesmb.conf
.
testparm
- Restart the
smb
service.
/sbin/service smb restart
- Reboot the server, if possible, to verify that all the services are properly started.
- Once the server is booted, check all the logs to see if the services are running properly.
/tmp/lmgrd.log
/tmp/tbdbserver.log
/tmp/tbprocess.log
/tmp/Link_srv.log