Configuring Harmony to Share Scene Data

Before you can share scene data between a Mac OS X database and Mac OS X, Linux, and Windows clients, you must configure the Mac OS X database server appropriately.

Sharing Harmony Directories for Mac OS X and Linux Clients
Setting Up the Server for Windows Clients

Toon Boom Harmony 11.2 uses NFS (Network File System) to share files between Mac OS X and Linux computers. You must use NFS to export directories from the server so clients can mount them and share the contents.

Sharing the Database for Mac OS X and Linux Clients

If your Mac OS X server will have Mac OS X or Linux clients, you must export the USA_DB and USADATA folders using NFS. The clients will then need to be configured to mount those exported folders from the server.

Setting Up NFS Exports on Mac OS X 10.7 and 10.6

The following procedure shows you how to export the /USADATA and /USA_DB directories on a Mac OS X workstation, as NFS shared points.

If Windows clients are going to access the Toon Boom Harmony 11 database on a Mac OS X server, you must set up the Link Server, Samba and the server.ini file. These allow the server and clients to communicate and share data.

Configuring and Starting the Link Server
Configuring Samba on Mac OS X 10.6 and 10.7
Configuring the server.ini File
Rebooting the Server

Configuring and Starting the Link Server

If you are running Toon Boom Harmony 11 in a mixed environment where the server is on Mac OS X and some of the clients are running Windows, you must start the Link Server, which 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. If you did not already install the Link Server during the server installation, you must do it now. From the Finder, go to Applications > Toon Boom Harmony 11.2 > Tools.
2. Double-click on the Configuration Assistant.
3. Select Create the Startup Items and deselect the other options.
4. Click Continue.
5. In Create Startup Item, select Create Link Server Startup Item.
6. Click Create.
7. Enter a user name and password of a user with administrator rights and click OK.
8. To start the Link Server, restart the server or type the following in the Terminal.

sudo /sbin/SystemStarter start ToonBoomLinkServer

A message appears in the Terminal indicating that the script was successful.

9. A log file is generated in /Library/Logs/ToonBoomLinkServer.log. Check this file to make sure there are no errors.

Configuring Samba on Mac OS X 10.6 and 10.7

Do the following:

Configuring the Samba Service
Configuring the Samba Shared Files
Configuring the smb.conf File
Mac OS X 10.7 (Lion) no longer uses the open source Samba software to share folders for Windows workstations. It has been replaced by Apple's own Windows file sharing software, which does not include some of the options required to support WindowsHarmony clients.

Configuring the Samba Service

By default, Samba is not set up to run automatically on Mac OS X.

Configuring the Samba Shared Files

Next, modify the /USA_DB and /USADATA shares in the /var/db/samba/smb.shares and add a usa section to the file.

1. Open the Terminal.
2. In the Finder, go to Application > Utilities and double-click on Terminal.
3. Go to the samba shares directory:

cd /var/db/samba/

4. Open the smb.shares file.

sudo vi smb.shares

5. Press i  to enter the insert mode.
6. Add or modify options in the file.

The following is an example of entries in the smb.shares shared file. You can add missing options at the end of the list.

[USA_DB]

comment = Harmony database folder

path = /USA_DB

available = yes

guest ok = no

directory mask = 777

create mask = 777

browseable=yes

read only=no

[USADATA]

comment = Harmony USADATA filesystem

path = /USADATA

available = yes

guest ok = no

directory mask = 777

create mask = 777

browseable=yes

read only=no

7. Create a [USA] share by making a copy of the [USA_DB] section and pasting it underneath.
8. Rename [USA_DB] to [USA].
9. Modify the following lines under [USA]:

path = /Applications/Toon Boom Harmony 11/tba

comment = Harmony binaries and configuration files

10. Verify that the [USA] section looks like the following:

[usa]

comment = Harmony binaries and configuration files

path = /Applications/Harmony 11.2/tba

available = yes

guest ok = no

directory mask = 777

create mask = 777

browseable = yes

read only = no

11. Press Esc and type :wq to save the changes and quit the vi editor.

Configuring the smb.conf File

You must also add or modify the following entries to the [global] section of the /etc/smb.conf file.

1. Create a backup copy of your current /etc/smb.conf file:

cd /etc

sudo cp smb.conf smb.conf.bak

2. Open the smb.conf file.

sudo vi /etc/smb.conf

3. Press i  to enter the insert mode.
4. Add or modify options in the file:

[global]

 

map to guest = Never

 

dos charset = 437

unix charset = UTF-8-MAC

display charset = UTF-8-MAC

 

blocking locks = false

oplocks = false

 

mangled names = no

When set to no, the mangled names parameter will prevent older smb clients (DOS, Win9X and Windows NT clients) from accessing files and folders that do not have an 8.3 file name.
5. Press Esc to quit the insert mode.
6. Type :wq to save the changes and quit the text editor.
7. Verify that you have not made any basic syntax errors:

testparm

8. Notify the smbdservice of the changes:

sudo kill -1 `cat /var/run/smbd.pid`

The back quote (`) character is located at the top-left of the Mac OS X keyboard on the same key as the tilde (~) character. Or simply reboot the computer.

Configuring the server.ini File

Before you install Toon Boom Harmony 11 on Windows clients, you must create the server.ini file on the server. The server.ini file provides information necessary in Windows for the Configuration Wizard to set up a Windows client.

When creating the server.ini file, be attentive to spelling, character spacing and case.

Rebooting the Server

At this point, reboot the server so all of the services which you have just configured will start up.