Debian Codegraph @

upstream/opensuse-tumbleweed/man8/vfs_media_harmony.8

raw
1 '\" t
2 .\" Title: vfs_media_harmony
3 .\" Author: [see the "AUTHOR" section]
4 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
5 .\" Date: 05/26/2026
6 .\" Manual: System Administration tools
7 .\" Source: Samba 4.23.8-git.477.f78166bceedSUSE-oS16.9-x86_64
8 .\" Language: English
9 .\"
10 .TH "VFS_MEDIA_HARMONY" "8" "05/26/2026" "Samba 4\&.23\&.8\-git\&.477\&.f78166bcee" "System Administration tools"
11 .\" -----------------------------------------------------------------
12 .\" * Define some portability stuff
13 .\" -----------------------------------------------------------------
14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
15 .\" http://bugs.debian.org/507673
16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
18 .ie \n(.g .ds Aq \(aq
19 .el .ds Aq '
20 .\" -----------------------------------------------------------------
21 .\" * set default formatting
22 .\" -----------------------------------------------------------------
23 .\" disable hyphenation
24 .nh
25 .\" disable justification (adjust text to left margin only)
26 .ad l
27 .\" -----------------------------------------------------------------
28 .\" * MAIN CONTENT STARTS HERE *
29 .\" -----------------------------------------------------------------
30 .SH "NAME"
31 vfs_media_harmony \- Allow multiple Avid clients to share a network drive\&.
32 .SH "SYNOPSIS"
33 .HP \w'\ 'u
34 vfs objects = media_harmony
35 .SH "DESCRIPTION"
36 .PP
37 This VFS module is part of the
38 \fBsamba\fR(7)
39 suite\&.
40 .PP
41 The
42 vfs_media_harmony
43 VFS module allows Avid editorial workstations to share a network drive\&. It does this by:
44 .RS
45 .sp
46 .RS 4
47 .ie n \{\
48 \h'-04' 1.\h'+01'\c
49 .\}
50 .el \{\
51 .sp -1
52 .IP " 1." 4.2
53 .\}
54 Giving each client their own copy of the Avid msmMMOB\&.mdb and msmFMID\&.pmr files and Creating directories\&.
55 .RE
56 .sp
57 .RS 4
58 .ie n \{\
59 \h'-04' 2.\h'+01'\c
60 .\}
61 .el \{\
62 .sp -1
63 .IP " 2." 4.2
64 .\}
65 Allowing each client to explicitly control the write time the Avid application sees on Avid media directories\&.
66 .RE
67 .sp
68 .RE
69 .PP
70 This module is stackable\&.
71 .SH "CONFIGURATION"
72 .PP
73 vfs_media_harmony
74 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\&.
75 .PP
76 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\&.
77 .PP
78 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\&.
79 .PP
80 It is also necessary for the
81 cache locked write times = no
82 option to be set for clients to be able to control their Avid media folder write times\&.
83 .SH "EXAMPLES"
84 .PP
85 Enable media_harmony for Mac and Windows clients:
86 .sp
87 .if n \{\
88 .RS 4
89 .\}
90 .nf
91 \fI[avid_mac]\fR
92 \m[blue]\fBpath = /avid\fR\m[]
93 \m[blue]\fBvfs objects = media_harmony\fR\m[]
94 \m[blue]\fBcache locked write times = no\fR\m[]
95 \fI[avid_win]\fR
96 \m[blue]\fBpath = /avid\fR\m[]
97 \m[blue]\fBvfs objects = media_harmony\fR\m[]
98 \m[blue]\fBcache locked write times = no\fR\m[]
99 \m[blue]\fBveto files = /\&.DS_Store/\&._@/\&.Trash@/\&.Spotlight@/\&.hidden/\&.hotfiles@/\&.vol/\fR\m[]
100 \m[blue]\fBdelete veto files = yes\fR\m[]
101 .fi
102 .if n \{\
103 .RE
104 .\}
105 .PP
106 Create the files that will allow users david and susan to control their own Avid database refreshes:
107 .sp
108 .if n \{\
109 .RS 4
110 .\}
111 .nf
112 touch \*(Aq/avid/OMFI MediaFiles_192\&.168\&.1\&.10_david\*(Aq \e
113 \*(Aq/avid/OMFI MediaFiles_192\&.168\&.1\&.11_susan\*(Aq \e
114 \*(Aq/avid/Avid MediaFiles/MXF/1_192\&.168\&.1\&.10_david\*(Aq \e
115 \*(Aq/avid/Avid MediaFiles/MXF/1_192\&.168\&.1\&.11_susan\*(Aq
116 .fi
117 .if n \{\
118 .RE
119 .\}
120 .PP
121 Trigger an Avid database refresh for user david:
122 .sp
123 .if n \{\
124 .RS 4
125 .\}
126 .nf
127 touch \*(Aq/avid/OMFI MediaFiles_192\&.168\&.1\&.10_david\*(Aq \e
128 \*(Aq/avid/Avid MediaFiles/MXF/1_192\&.168\&.1\&.10_david\*(Aq
129 .fi
130 .if n \{\
131 .RE
132 .\}
133 .PP
134 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_harmony/trigger_avid_update\&.py to create and update these files\&.
135 .SH "CAVEATS"
136 .PP
137 vfs_media_harmony
138 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 msmMMOB\&.mdb_192\&.168\&.1\&.10_userx even though it doesn\*(Aqt show up in a directory listing\&.
139 .SH "VERSION"
140 .PP
141 This man page is part of version 4\&.23\&.8\-git\&.477\&.f78166bceedSUSE\-oS16\&.9\-x86_64 of the Samba suite\&.
142 .SH "AUTHOR"
143 .PP
144 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\&.