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.2.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.
How to set up NFS exports on Mac OS X
- From the Finder, go to Applications > Utilities and double-click on Terminal.
- Create and edit the exports file in the
/etcdirectory:
sudo vi /etc/exports
- Add the following:
/USA_DB -maproot=nobody
/USADATA -maproot=nobody
- Save and exit the file.
- Verify that the file is correct by running:
sudo nfsd checkexports
If there is no return response, then it is correct.
- Start
nfsd:
sudo nfsd enable
- If nfsd was already started, notify the nfsd daemon that the /etc/exports file has changed:
sudo kill -1 `cat /var/run/mountd.pid`
- 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.2.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.2.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.
How to configure the Link Server on the server in a mixed network environment
- 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.
- Double-click on the Configuration Assistant.
- Select Create the Startup Items and deselect the other options.
- Click Continue.
- In Create Startup Item, select Create Link Server Startup Item.
- Click Create.
- Enter a user name and password of a user with administrator rights and click OK.
The installation will start Link server automatically.
- A log file is generated in /tmp/com.toonboom.LinkServer.log. Check this file to make sure there are no errors.
Start Link Server:
sudo launchctl load /Library/LaunchDaemons/com.toonboom.LinkServer.plistStop Link Server:
sudo launchctl unload /Library/LaunchDaemons/com.toonboom.LinkServer.plistConfiguring Samba on Mac OS X
Do the following:
| • | Configuring the Samba Service |
| • | Configuring the Samba Shared Files |
| • | Configuring Harmony to Share Scene Data |
Configuring the Samba Service
By default, Samba is not set up to run automatically on Mac OS X.
How to start the Samba service
- Open System Preferences.
- In the Internet & Wireless section, click Sharing.
- In the Services section, select the File Sharing option.
- In the Shared Folders section, click the plus (+) sign.
- Browse and select the /USA_DB folder.
- Repeat steps 4 and 5 for these folders:
| ‣ | /USADATA |
| ‣ | /Applications/Toon Boom Harmony [version] [edition]/tba
|
- Make sure to give the usabatch account Read and Write permissions to the USA_DB, USADATA and /Applications/Toon Boom Harmony [version] [edition]/tba folders.
- Click Options.
- Select the Share files and folders using SMB option.
- Select the usabatch option and click Done.
- Close System Preferences.
Configuring the Samba Shared Files
- Open the Terminal.
- To rename the
tbashare folder tousa:
sudo sharing -l
sudo sharing -e tba -S usa
- Verify that the
tbaname is nowusa.
sudo sharing -l |grep -A 2 “smb”
smb: {
name: usa
shared: 1
--
smb: {
name: toonboom's Public Folder
shared: 1
--
smb: {
name: USA_DB
shared: 1
--
smb: {
name: usabatch's Public Folder
shared: 1
--
smb: {
name: USADATA
shared: 1
Configuring the server.ini File
Before you install Toon Boom Harmony 12.2.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.
How to create the server.ini on the Mac server
- From the Finder, go to Applications > Toon Boom Harmony [version] [edition] > Tools and double-click on the Configuration Editor.
- In the Configuration Editor opens, click the server.ini tab.
- 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
- 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.