Configuring Harmony to Share Scene Data
This section shows you how to share the Harmony scene data for different network configurations.
| • | Exporting Harmony Directories for Mac OS X and Linux Clients |
| • | Configuring the Link Server |
| • | Configuring Samba |
Exporting Harmony Directories for Mac OS X and Linux Clients
Before you can install Harmony on Linux clients, you must export the Toon Boom Harmony directories from the server. The NFS and NFS locking services must be running so that all machines can access the data directories you export.
How to start NFS services and export data directories from the server
| 1. | To share files with other Linux machines, start the NFS service: |
/etc/init.d/nfs restart
/sbin/chkconfig nfs on
| ‣ | If you are using Fedora 16: |
systemctl start nfs-server.service
/sbin/chkconfig nfs-server on
| 2. | The NFS lock manager must run on all Linux stations on your network. Without this service, users cannot access the database without receiving numerous "read lock" error messages. |
/etc/init.d/nfslock restart
/sbin/chkconfig nfslock on
| ‣ | If you are using Fedora 16: |
systemctl start nfs-lock.service
/sbin/chkconfig nfs-lock on
Now you are ready to export the Toon Boom Harmony directory.
| 3. | Use a text editor to edit the /etc/exports file. Add the names /USA_DB, /usadata000 and /usr/local/ToonBoomAnimation/harmony_11.2 directories to the file: |
/USA_DB *(rw,sync)
/usadata000 *(rw,sync)
/usr/local/ToonBoomAnimation/harmony_11.2 *(rw,sync)
| 4. | Run the export command to finalize the exports: |
/usr/sbin/exportfs -r
| 5. | Verify what is being exported from the server: |
/usr/sbin/showmount --exports
A report appears listing all the shares exported from the server.
Configuring the Link Server
If you are running Harmony in a mixed environment where the server is on Fedora Linux and some of the clients are running Windows, you must start the Link Server.This server makes it possible for Windows machines to communicate with the database.
How to configure the Link Server on the server in a mixed network environment
| 1. | Use a text editor to create the Link_srv.conf file in the /USA_DB directory. This file must contain the following: |
hostname harmonyserver
port 5679
Replace harmonyserver with the name of the database server. You can find the name of a computer by using the uname -n command.
Link_srv.conf under /usr/local/ToonBoomAnimation/harmony_11.2/resources/samples/. Copy and paste it from there and change it accordingly.| 2. | Change the permissions on the Dbserver.conf file to 644. |
chmod 644 Link_srv.conf
| 3. | Start the Link Server. |
/etc/init.d/USAnimation_link_srv start
A message appears in the shell indicating that the script was successful. A log file is generated in /tmp/Link_srv.log.
| 4. | Verify this file to ensure there are no errors written to it. |
Configuring Samba
Finally, modify the /etc/samba/smb.conf file. To do this, add entries for each database directory you want to share with Windows clients in the /etc/samba/smb.conf file. Then, add options to the [global] section of the file.
| • | Configuring the Samba Service to Start at Boot Time |
| • | Configuring the server.ini File |
| • | Rebooting |
| • | Setting Up Linux Clients |
| • | Installing the Start Application Menu Entries and Batch Processing on Clients |
The following is an example of entries in the smb.conf file. You can add these to the end of the file.
[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_11.2
[usadata000]
comment = Toon Boom Harmony data 000
browseable = yes
read only = no
guest ok = no
create mask = 0777
directory mask = 0777
path = /usadata000
[usadata001]
comment = Toon Boom Harmony data 001
browseable = yes
read only = no
guest ok = no
create mask = 0777
directory mask = 0777
path = /usadata001/
You must also add or modify the following entries to the [global] section of smb.conf:
[global]
encrypt passwords = no
blocking locks = no
oplocks = no
level2 oplocks = no
follow symlinks = yes
unix extensions = no
wide links = yes
| 5. | Once you have made all the changes and saved the smb.conf file, validate the file for internal correctness: |
testparm
Configuring the Samba Service to Start at Boot Time
By default, Samba is not set up to run automatically.
How to start the Samba service
| 1. | Configure Samba to run as a service at boot time: |
/sbin/chkconfig smb on
| 2. | Start the Samba service: |
/sbin/service smb start
Configuring the server.ini File
Before you install Harmony on Windows clients, you must create the /usr/local/ToonBoomAnimation/harmony_11.2/etc/server.ini file on the database server. The server.ini file provides information necessary for the Windows Configuration Wizard to set up a Windows client.
When creating the server.ini file, pay attention to the spelling, character spacing and case.
The following is an example of the/usr/local/ToonBoomAnimation/harmony_11.2/etc/server.ini file. In this example, the database server name is harmonyserver and there are two usadata directories: usadata000 and usadata001.
[WizardConfig]
ServerName=harmonyserver
InstallationDrive=C
UsaShare=usa
UsadbDrive=C
UsadbShare=USA_DB
FileSystem0=C usadata000 harmonyserver
FileSystem1=C usadata001 harmonyserver
Do not worry about the references to Drive = C. They are necessary for Windows clients and will be ignored by Linux.
You can find the example of server.ini under /usr/local/ToonBoomAnimation/harmony_11.2/resources/samples.
You can copy and paste it from there and change it accordingly.
Any sharing folder name should be case sensitive.
Rebooting
At this point, you should reboot the Toon Boom Harmony server to verify that all the Harmony services are properly configured to start automatically.
Setting Up Linux Clients
To run Toon Boom Harmony on Linux clients, you must mount the binaries and data directories stored on the server. To access the directories exported from the server, the network file server (NFS) and NFS locking services must be running.
How to start NFS services and mount Toon Boom Harmony directories on clients
| 1. | To access the mounted directories, start the NFS service: |
/etc/init.d/nfs restart
/sbin/chkconfig nfs on
If you are using Fedora 16:
systemctl start nfs-server.service
/sbin/chkconfig nfs-server on
| 2. | The NFS lock manager must run on all Linux stations on your network. Without this service, users cannot access the database without receiving numerous "read lock" error messages. |
/etc/init.d/nfslock restart
/sbin/chkconfig nfslock on
If you are using Fedora 16:
systemctl start nfs-lock.service
/sbin/chkconfig nfs-lock on
You are now ready to mount the directories from the server.
| 3. | On each client computer, create directories for: |
/usr/local/ToonBoomAnimation/harmony_11.2
/USA_DB
/usadata000
The directory names must match the names on the Toon Boom Harmony server.
mkdir /usr/local/ToonBoomAnimation/harmony_11.2
mkdir /USA_DB
mkdir /usadata000
| 4. | To mount the directories on the client machine, edit the /etc/fstab file. In the following example, the server is the machine name of the database server. |
server:/USA_DB /USA_DB nfs rw,soft,intr,bg 0 0
server:/usadata000 /usadata000 nfs rw,soft,intr,bg 0 0
server:/usr/local/ToonBoomAnimation/harmony_11.2 /usr/local/ToonBoomAnimation/harmony_11.2 nfs rw,soft,intr,bg 0 0
This will make the Toon Boom Harmony directories mount with the default version of NFS on your system.
If you encounter errors, try using NFS version 2. In this case, you should modify the fstab file to match the following:
server:/USA_DB /USA_DB nfs rw,soft,intr,bg,vers=2 0 0
server:/usadata000 /usadata000 nfs rw,soft,intr,bg,vers=2 0 0
server:/usr/local/ToonBoomAnimation/harmony_11.2 /usr/local/ToonBoomAnimation/harmony_11.2 nfs rw,soft,intr,bg,vers=2 0 0
| 5. | At a command line, type the mount all command. |
mount -av
To verify that all shares are mounted:
mount
A report appears listing all the shares mounted on the client.
| 6. | To test that the mount works, open one of the mounted directories and list the contents. |
cd /usr/local/ToonBoomAnimation/harmony_11.2
ls
A list appears of the directories in Harmony 11:
etc help lang lnx86 lnx86_64 Plugins resources
Installing the Start Application Menu Entries and Batch Processing on Clients
To make it easier for users to start Toon Boom Harmony, install the application menu entries for KDE. You should also include the -p installation option to start batch processing services on rendering machines.
How to install menu entries and batch processing
| 1. | Go to the directory that contains the Linux installation files. |
| 2. | Run the install script with the -p and -kde options. |
./install -p -kde