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