Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
VFS_MEDIA_HARMONY(8)	   System Administration tools	    VFS_MEDIA_HARMONY(8)

NAME
     vfs_media_harmony - Allow multiple Avid clients to share a network drive.

SYNOPSIS
     vfs objects = media_harmony

DESCRIPTION
     This VFS module is part of the samba(7) suite.

     The  vfs_media_harmony  VFS  module  allows  Avid editorial workstations to
     share a network drive. It does this by:

	     1. Giving each client their own copy of the  Avid	msmMMOB.mdb  and
		msmFMID.pmr files and Creating directories.

	      2. Allowing  each  client to explicitly control the write time the
		Avid application sees on Avid media directories.

     This module is stackable.

CONFIGURATION
     vfs_media_harmony automatically redirects requests from  clients  for  Avid
     database  files  or an Avid Creating directory to a client-specific version
     of the file. No configuration beyond enabling the module is needed  to  get
     this portion of its functionality working.

     If  Mac  and  Windows  Avid clients will be accessing the same folder, they
     should be given separate share definitions, with hidden Mac files vetoed on
     the Windows share. See EXAMPLES.

     To allow each client to control when the Avid application	refreshes  their
     Avid  databases, create files for each client and each Avid media directory
     with  the	name  [avid_dir_name]_[client_ip_address]_[client_username].  To
     trigger  Avid database refreshes, update the write time on those files. See
     EXAMPLES.

     It is also necessary for the cache locked write times = no option to be set
     for clients to be able to control their Avid media folder write times.

EXAMPLES
     Enable media_harmony for Mac and Windows clients:

		 [avid_mac]
	      path = /avid
	      vfs objects = media_harmony
	      cache locked write times = no
		 [avid_win]
	      path = /avid
	      vfs objects = media_harmony
	      cache locked write times = no
	      veto files = /.DS_Store/._@/.Trash@/.Spotlight@/.hidden/.hotfiles@/.vol/
	      delete veto files = yes

     Create the files that will allow users david and susan to control their own
     Avid database refreshes:

	      touch '/avid/OMFI MediaFiles_192.168.1.10_david' \
		   '/avid/OMFI MediaFiles_192.168.1.11_susan' \
		   '/avid/Avid MediaFiles/MXF/1_192.168.1.10_david' \
		   '/avid/Avid MediaFiles/MXF/1_192.168.1.11_susan'

     Trigger an Avid database refresh for user david:

	      touch '/avid/OMFI MediaFiles_192.168.1.10_david' \
		   '/avid/Avid MediaFiles/MXF/1_192.168.1.10_david'

     If you have a large number of Avid media folders to manage,  you  can  give
     each  editor a suitably modified version of examples/scripts/vfs/media_har-
     mony/trigger_avid_update.py to create and update these files.

CAVEATS
     vfs_media_harmony is designed to work with Avid editing  applications  that
     look in the Avid MediaFiles or OMFI MediaFiles directories for media. It is
     not  designed to work as expected in all circumstances for general use. For
     example: It is possible to  open  a  client-specific  file  such  as  msmM-
     MOB.mdb_192.168.1.10_userx  even  though  it doesn't show up in a directory
     listing.

VERSION
     This man page is part of version 4.23.8 of the Samba suite.

AUTHOR
     The original Samba software and related utilities were  created  by  Andrew
     Tridgell.	Samba  is  now	developed  by  the  Samba Team as an Open Source
     project similar to the way the Linux kernel is developed.

Samba 4.23.8			   08/01/2026		    VFS_MEDIA_HARMONY(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=vfs_media_harmony&sektion=8&manpath=FreeBSD+Ports+15.1.quarterly>

home | help