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

Sharing Harmony Directories for Mac OS X and Linux Clients

Toon Boom Harmony 12.1 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

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

ClosedHow to set up NFS exports on Mac OS X
  1. From the Finder, go to Applications > Utilities and double-click on Terminal.
  1. Create and edit the exports file in the /etc directory:

sudo vi /etc/exports

  1. Add the following:

/USA_DB -maproot=nobody

/USADATA -maproot=nobody

  1. Save and exit the file.
  1. Verify that the file is correct by running:

sudo nfsd checkexports

If there is no return response, then it is correct.

  1. Start nfsd:

sudo nfsd enable

  1. If nfsd was already started, notify the nfsd daemon that the /etc/exports file has changed:

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

NOTE: 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.
  1. Verify that the folders exported correctly:

/usr/bin/showmount -e

The following should appear:

/USA_DB Everyone

/USADATA Everyone

Once the export file is created, client systems can mount /USA_DB and /USADATA located on the Mac OS X server system.

Setting Up the Server for Windows Clients

If Windows clients are going to access the Toon Boom Harmony 12.1 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
• Configuring the server.ini File
• Rebooting the Server

Configuring and Starting the Link Server

If you are running Toon Boom Harmony 12.1 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.

ClosedHow 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 [version] [edition] > Tools.
  1. Double-click on the Configuration Assistant.
  1. Select Create the Startup Items and deselect the other options.
  1. Click Continue.
  1. In Create Startup Item, select Create Link Server Startup Item.
  1. Click Create.
  1. Enter a user name and password of a user with administrator rights and click OK.

The installation will start Link server automatically.

  1. A log file is generated in /tmp/com.toonboom.LinkServer.log. Check this file to make sure there are no errors.
NOTE: To help troubleshoot, you might need to stop or start Link server.

Start Link Server: sudo launchctl load /Library/LaunchDaemons/com.toonboom.LinkServer.plist

Stop Link Server: sudo launchctl unload /Library/LaunchDaemons/com.toonboom.LinkServer.plist

Configuring Samba on Mac OS X

Do the following:

• Configuring the Samba Service
• Configuring the Samba Shared Files
• Configuring the smb.conf File
IMPORTANT: Mac 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 Windows Harmony clients.
Configuring the Samba Service

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

ClosedHow to start the Samba service
  1. Open System Preferences.
  1. In the Internet & Wireless section, click Sharing.
  1. In the Services section, select the File Sharing option.

  1. In the Shared Folders section, click the plus (+) sign.
  1. Browse and select the /USA_DB folder.

  1. Repeat steps 4 and 5 for the /USADATA folder.
  1. Make sure to give the usabatch account Read and Write permissions to the USA_DB and USADATA folders.
  1. Click Options.
  1. Select the Share files and folders using SMB option.

  1. Select the usabatch option and click Done.
  1. Close System Preferences.
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.
  1. In the Finder, go to Application > Utilities and double-click on Terminal.
  1. Go to the samba directory:

cd /var/db/samba/

  1. Open the smb.shares file.

sudo vi smb.shares

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

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

path = /Applications/Toon Boom Harmony 12.1/tba

comment = Harmony binaries and configuration files

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

[usa]

comment = Harmony binaries and configuration files

path = /Applications/Harmony 12.1/tba

available = yes

guest ok = no

directory mask = 777

create mask = 777

browseable = yes

read only = no

  1. Save and exit the file.
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

  1. Open the smb.conf file.

sudo vi /etc/smb.conf

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

NOTE: 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.
  1. Save and exit the file.
  1. Verify that you have not made any basic syntax errors:

testparm

  1. Notify the smbdservice of the changes:

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

NOTE: 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 12.1 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.

NOTE: When creating the server.ini file, be attentive to spelling, character spacing and case.
ClosedHow to create the server.ini on the Mac server
  1. From the Finder, go to Applications > Toon Boom Harmony [version] [edition] > Tools and double-click on the Configuration Editor.
  1. In the Configuration Editor opens, click the server.ini tab.
  1. Copy and paste the following example and modify it accordingly:

This is an example of the server.ini file whose server name is harmonyserver. Also there is one directory named USADATA.

[WizardConfig]

ServerName=harmonyserver

InstallationDrive=C

UsaShare=usa

UsadbDrive=C

UsadbShare=USA_DB

FileSystem0=C USADATA harmonyserver

NOTE: The references to the C: drive in this example are necessary for Windows clients and will be ignored by Mac OS X.
  1. From the File menu, select Save and quit the Configuration Editor.

Rebooting the Server

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

The content reflects the features found in the latest Harmony 12.1 release. To download the latest upgrade, go to toonboom.com/members > My Downloads

For comments and feedback, contact: ...

© 1994–2015 Toon Boom Animation Inc. All rights reserved
Toon Boom Animation Inc., a Corus® Entertainment Inc. Company