1VFS_MEDIA_HARMONY(8)      System Administration tools     VFS_MEDIA_HARMONY(8)
2
3
4

NAME

6       vfs_media_harmony - Allow multiple Avid clients to share a network
7       drive.
8

SYNOPSIS

10       vfs objects = media_harmony
11

DESCRIPTION

13       This VFS module is part of the samba(7) suite.
14
15       The vfs_media_harmony VFS module allows Avid editorial workstations to
16       share a network drive. It does this by:
17
18               1. Giving each client their own copy of the Avid msmMMOB.mdb
19                  and msmFMID.pmr files and Creating directories.
20
21               2. Allowing each client to explicitly control the write time
22                  the Avid application sees on Avid media directories.
23
24
25       This module is stackable.
26

CONFIGURATION

28       vfs_media_harmony automatically redirects requests from clients for
29       Avid database files or an Avid Creating directory to a client-specific
30       version of the file. No configuration beyond enabling the module is
31       needed to get this portion of its functionality working.
32
33       If Mac and Windows Avid clients will be accessing the same folder, they
34       should be given separate share definitions, with hidden Mac files
35       vetoed on the Windows share. See EXAMPLES.
36
37       To allow each client to control when the Avid application refreshes
38       their Avid databases, create files for each client and each Avid media
39       directory with the name
40       [avid_dir_name]_[client_ip_address]_[client_username]. To trigger Avid
41       database refreshes, update the write time on those files. See EXAMPLES.
42
43       It is also necessary for the cache locked write times = no option to be
44       set for clients to be able to control their Avid media folder write
45       times.
46

EXAMPLES

48       Enable media_harmony for Mac and Windows clients:
49
50                   [avid_mac]
51                path = /avid
52                vfs objects = media_harmony
53                cache locked write times = no
54                   [avid_win]
55                path = /avid
56                vfs objects = media_harmony
57                cache locked write times = no
58                veto files = /.DS_Store/._@/.Trash@/.Spotlight@/.hidden/.hotfiles@/.vol/
59                delete veto files = yes
60
61       Create the files that will allow users david and susan to control their
62       own Avid database refreshes:
63
64                touch '/avid/OMFI MediaFiles_192.168.1.10_david' \
65                     '/avid/OMFI MediaFiles_192.168.1.11_susan' \
66                     '/avid/Avid MediaFiles/MXF/1_192.168.1.10_david' \
67                     '/avid/Avid MediaFiles/MXF/1_192.168.1.11_susan'
68
69       Trigger an Avid database refresh for user david:
70
71                touch '/avid/OMFI MediaFiles_192.168.1.10_david' \
72                     '/avid/Avid MediaFiles/MXF/1_192.168.1.10_david'
73
74       If you have a large number of Avid media folders to manage, you can
75       give each editor a suitably modified version of
76       examples/scripts/vfs/media_harmony/trigger_avid_update.py to create and
77       update these files.
78

CAVEATS

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

VERSION

88       This man page is part of version 4.19.3 of the Samba suite.
89

AUTHOR

91       The original Samba software and related utilities were created by
92       Andrew Tridgell. Samba is now developed by the Samba Team as an Open
93       Source project similar to the way the Linux kernel is developed.
94
95
96
97Samba 4.19.3                      11/27/2023              VFS_MEDIA_HARMONY(8)