aboutsummaryrefslogtreecommitdiffstats
path: root/docs/mcc-help/en/draksambashare.xml
blob: 0878d11e036f6a23327fa6b7c9bb32c4d30f3be1 (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
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
<?xml version="1.0" encoding="utf-8"?>
<section version="5.0" xml:id="draksambashare"
         xmlns="http://docbook.org/ns/docbook"
         xmlns:ns5="http://www.w3.org/1998/Math/MathML"
         xmlns:ns4="http://www.w3.org/2000/svg"
         xmlns:ns3="http://www.w3.org/1999/xhtml"
         xmlns:ns2="http://www.w3.org/1999/xlink"
         xmlns:ns="http://docbook.org/ns/docbook">
  <info>
    <title xml:id="draksambashare-ti1">Share directories and drives with
    Samba</title>

    <subtitle>draksambashare</subtitle>
  </info>

  <mediaobject>
    <imageobject>
      <imagedata align="center"  fileref="draksambashare.png"
                 format="PNG" revision="1" 
                 xml:id="draksambashare-im1"/>
    </imageobject>
  </mediaobject>

  <para/>

  <section>
    <title>Introduction</title>

    <para>Samba is a protocol used in different Operating Systems to share
    some resources like directories or printers. This tool allows you to
    configure the machine as a Samba server using the protocol SMB/CIFS. This
    protocol is also used by Windows(R) and workstations with this OS can
    access the resources of the Samba server.</para>
  </section>

  <section>
    <title>Preparation</title>

    <para>To be accessed from other workstations, the server has to have a
    fixed IP address. This can be specified directly on the server, for
    example with <xref linkend="draknetcenter"/>, or at the DHCP server
    which identifies the station with its
    MAC-address and give it always the same address. The firewall has also to
    allow the incoming requests to the Samba server.</para>

    <para/>
  </section>

  <section>
    <title>Wizard - Standalone server</title>

    <para>At the first run, the tools <footnote>
        <para>You can start this tool from the command line, by
        typing<emphasis role="bold"> draksambashare</emphasis> as root.</para>
      </footnote> checks if needed packages are installed and proposes to
    install them if they are not yet present. Then the wizard to configure
    the Samba server is launched.</para>

    <mediaobject>
      <imageobject>
        <imagedata align="center"  fileref="draksambashare0.png"
                   format="PNG" revision="1" 
                   xml:id="draksambashare0-im1"/>
      </imageobject>
    </mediaobject>

    <para>In the next window the Standalone server configuration option is already selected.</para>

    <mediaobject>
      <imageobject>
        <imagedata align="center"  fileref="draksambashare1.png"
                   format="PNG" revision="1" 
                   xml:id="draksambashare1-im1"/>
      </imageobject>
    </mediaobject>

    <para>Then specify the name of the workgroup. This name should be the same
    for the access to the shared resources.</para>

    <para>The netbios name is the name which will be used to designate the
    server on the network.</para>

    <mediaobject>
      <imageobject>
        <imagedata align="center"  fileref="draksambashare2.png"
                   format="PNG" revision="1" 
                   xml:id="draksambashare2-im1"/>
      </imageobject>
    </mediaobject>

    <para>Choose the security mode:</para>

    <itemizedlist>
      <listitem>
        <para><guilabel>user</guilabel>: the client must be authorized to
        access the resource</para>
      </listitem>

      <listitem>
        <para><guilabel>share</guilabel>: the client authenticates itself
        separately for each share</para>
      </listitem>
    </itemizedlist>

    <para>You can specify which hosts are allowed to access the resources,
    with IP address or host name.</para>

    <mediaobject>
      <imageobject>
        <imagedata align="center" fileref="draksambashare3.png" format="PNG"
                   revision="1" xml:id="draksambashare3-im1"/>
      </imageobject>
    </mediaobject>

    <para>Specify the server banner. The banner is the way this server will be
    described in the Windows workstations.</para>

    <mediaobject>
      <imageobject>
        <imagedata align="center"  fileref="draksambashare4.png"
                   format="PNG" revision="1" 
                   xml:id="draksambashare-im4"/>
      </imageobject>
    </mediaobject>

    <para>The place where Samba can log information can be specified at the
    next step.</para>

    <mediaobject>
      <imageobject>
        <imagedata align="center"  fileref="draksambashare5.png"
                   format="PNG" revision="1" 
                   xml:id="draksambashare-im5"/>
      </imageobject>
    </mediaobject>

    <para>The wizard displays a list of the chosen parameters before you accept
    the configuration. When accepted, the configuration will be written in
    <code>/etc/samba/smb.conf</code>.</para>

    <mediaobject>
      <imageobject>
        <imagedata align="center"  fileref="draksambashare6.png"
                   format="PNG" revision="1" 
                   xml:id="draksambashare-im6"/>
      </imageobject>
    </mediaobject>
  </section>

  <section>
    <title>Wizard - Primary domain controller</title>

    <para><mediaobject>
        <imageobject>
          <imagedata fileref="draksambashare13.png"/>
        </imageobject>
      </mediaobject>If the "Primary domain controller" option is selected, the
    wizard asks for indication if Wins is to support or not and to provide
    admin users names. The following steps are then the same as for standalone
    server, except you can choose also the security mode:</para>

    <itemizedlist>
      <listitem>
        <para><guilabel>domain</guilabel>: provides a mechanism for storing
        all user and group accounts in a central, shared, account repository.
        The centralized account repository is shared between (security)
        controllers.</para>
      </listitem>
    </itemizedlist>
  </section>

  <section>
    <title>Declare a directory to share</title>

    <para>With the <guibutton>Add</guibutton> button, we get:</para>

    <mediaobject>
      <imageobject>
        <imagedata align="center" fileref="draksambashare15.png" format="PNG"
                   revision="1" xml:id="draksambashare-im7"/>
      </imageobject>
    </mediaobject>

    <para>A new entry is thus added. It can be modified with the
    <guibutton>Modify</guibutton> button. Options can be edited, such as
    whether the directory is visible to the public, writable or browseable.
    The share name can not be modified.</para>

    <mediaobject>
      <imageobject>
        <imagedata align="center"  fileref="draksambashare16.png"
                   format="PNG" revision="1" 
                   xml:id="draksambashare-im8"/>
      </imageobject>
    </mediaobject>

    <para/>
  </section>

  <section>
    <title>Menu entries</title>

    <para>When the list has at least one entry, menu entries can be
    used.</para>

    <formalpara>
      <title>File|Write conf</title>

      <para>Save the current configuration in
      <code>/etc/samba/smb.conf</code>.</para>
    </formalpara>

    <formalpara>
      <title>Samba server|Configure</title>

      <para>The wizard can be run again with this command.</para>
    </formalpara>

    <formalpara>
      <title>Samba server|Restart</title>

      <para>The server is stopped and restarted with the current configuration
      files.</para>
    </formalpara>

    <formalpara>
      <title>Samba Server|Reload</title>

      <para>The configuration displayed is reloaded from the current
      configuration files.</para>
    </formalpara>
  </section>

  <section>
    <title>Printers share</title>

    <para>Samba also allows you to share printers.</para>

    <para><mediaobject>
        <imageobject>
          <imagedata fileref="draksambashare17.png"/>
        </imageobject>
      </mediaobject></para>
  </section>

  <section>
    <title>Samba users</title>

    <para>In this tab, you can add users who are allowed to access the shared
    resources when authentication is required. You can add users from <xref
    linkend="userdrake"/><mediaobject>
        <imageobject>
          <imagedata fileref="draksambashare18.png"/>
        </imageobject>
      </mediaobject></para>
  </section>
</section>