Harmony Server Installation > Installing on Mac OS X > Configuring Harmony to Share Scene Data

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

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.

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.

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.

Rebooting the Server

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