← Back to branch summary

~zulcss/samba/server-dailies-3.4

« back to all changes in this revision

Viewing changes to docs-xml/Samba3-HOWTO/TOSHARG-IntroSMB.xml

  • Committer: Chuck Short
  • Date: 2010-09-28 20:38:39 UTC
  • Revision ID: zulcss@ubuntu.com-20100928203839-pgjulytsi9ue63x1
Initial version

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs-xml/Samba3-HOWTO/TOSHARG-IntroSMB.xml
 
1
<?xml version="1.0" encoding="iso-8859-1"?>
 
2
<!DOCTYPE preface PUBLIC "-//Samba-Team//DTD DocBook V4.2-Based Variant V1.0//EN" "http://www.samba.org/samba/DTD/samba-doc">
 
3
<preface id="IntroSMB">
 
4
<prefaceinfo>
 
5
        &author.jht;
 
6
        <pubdate>June 29, 2003</pubdate>
 
7
</prefaceinfo>
 
8
 
 
9
<title>Introduction</title>
 
10
 
 
11
<para><quote>
 
12
A man's gift makes room for him before great men. Gifts are like hooks that can catch
 
13
hold of the mind taking it beyond the reach of forces that otherwise might constrain it.
 
14
</quote> --- Anon.
 
15
</para>
 
16
 
 
17
 
 
18
<para>
 
19
This is a book about Samba. It is a tool, a derived work of the labors
 
20
of many and of the diligence and goodwill of more than a few.
 
21
This book contains material that has been contributed in a persistent belief
 
22
that each of us can add value to our neighbors as well as to those who will
 
23
follow us.
 
24
</para>
 
25
 
 
26
<para>
 
27
This book is designed to meet the needs of the Microsoft network administrator.
 
28
UNIX administrators will benefit from this book also, though they may complain
 
29
that it is hard to find the information they think they need. So if you are a
 
30
Microsoft certified specialist, this book should meet your needs rather well.
 
31
If you are a UNIX or Linux administrator, there is no need to feel badly &smbmdash; you
 
32
should have no difficulty finding answers to your current concerns also.
 
33
</para>
 
34
 
 
35
<sect1>
 
36
<title>What Is Samba?</title>
 
37
 
 
38
        <para>
 
39
        Samba is a big, complex project. The Samba project is ambitious and exciting.
 
40
        The team behind Samba is a group of some thirty individuals who are spread
 
41
        the world over and come from an interesting range of backgrounds. This team
 
42
        includes scientists, engineers, programmers, business people, and students.
 
43
        </para>
 
44
 
 
45
        <para>
 
46
        Team members were drawn into active participation through the desire to help
 
47
        deliver an exciting level of transparent interoperability between Microsoft
 
48
        Windows and the non-Microsoft information
 
49
        technology world. 
 
50
        </para>
 
51
 
 
52
        <para>
 
53
        The slogan that unites the efforts behind the Samba project says:
 
54
        <emphasis>Samba, Opening Windows to a Wider World!</emphasis> The goal
 
55
        behind the project is one of removing barriers to interoperability.
 
56
        </para>
 
57
 
 
58
        <para>
 
59
        Samba provides file and print services for Microsoft Windows clients. These
 
60
        services may be hosted off any TCP/IP-enabled platform. The original deployment
 
61
        platforms were UNIX and Linux, though today it is in common use across
 
62
        a broad variety of systems.
 
63
        </para>
 
64
 
 
65
        <para>
 
66
        The Samba project includes not only an impressive feature set in file and print
 
67
        serving capabilities, but has been extended to include client functionality,
 
68
        utilities to ease migration to Samba, tools to aid interoperability with
 
69
        Microsoft Windows, and administration tools.
 
70
        </para>
 
71
 
 
72
        <para>
 
73
        The real people behind Samba are users like you. You have inspired the
 
74
        developers (the Samba Team) to do more than any of them imagined could or should
 
75
        be done. User feedback drives Samba development. Samba-3 in particular incorporates
 
76
        a huge amount of work done as a result of user requests, suggestions and direct
 
77
        code contributions.
 
78
        </para>
 
79
 
 
80
</sect1>
 
81
 
 
82
<sect1>
 
83
<title>Why This Book?</title>
 
84
 
 
85
        <para>
 
86
        There is admittedly a large number of Samba books on the market today and
 
87
        each book has its place. Despite the apparent plethora of books, Samba
 
88
        as a project continues to receive much criticism for failing to provide
 
89
        sufficient documentation. Samba is also criticized for being too complex
 
90
        and too difficult to configure. In many ways this is evidence of the
 
91
        success of Samba as there would be no complaints if it was not successful.
 
92
        </para>
 
93
 
 
94
        <para>
 
95
        The Samba Team members work predominantly with UNIX and Linux, so
 
96
        it is hardly surprising that existing Samba documentation should reflect
 
97
        that orientation. The original HOWTO text documents were intended to provide
 
98
        some tips, a few golden nuggets, and if they helped anyone then that was
 
99
        just wonderful. But the HOWTO documents lacked structure and context. They were
 
100
        isolated snapshots of information that were written to pass information
 
101
        on to someone else who might benefit. They reflected a need to transmit
 
102
        more information that could be conveniently put into manual pages.
 
103
        </para>
 
104
 
 
105
        <para>
 
106
        The original HOWTO documents were written by different authors. Most HOWTO
 
107
        documents are the result of feedback and contributions from numerous
 
108
        authors. In this book we took care to preserve as much original content as
 
109
        possible. As you read this book you will note that chapters were written by
 
110
        multiple authors, each of whom has his own style. This demonstrates
 
111
        the nature of the Open Source software development process.
 
112
        </para>
 
113
 
 
114
        <para>
 
115
        Out of the original HOWTO documents sprang a collection of unofficial
 
116
        HOWTO documents that are spread over the Internet. It is sincerely intended
 
117
        that this work will <emphasis>not</emphasis> replace the valuable unofficial 
 
118
        HOWTO work that continues to flourish. If you are involved in unofficial 
 
119
        HOWTO production then please continue your work!
 
120
        </para>
 
121
 
 
122
        <para>
 
123
        Those of you who have dedicated your labors to the production of unofficial
 
124
        HOWTOs, to Web page information regarding Samba, or to answering questions
 
125
        on the mailing lists or elsewhere, may be aware that this is a labor
 
126
        of love. We would like to know about your contribution and willingly receive
 
127
        the precious pearls of wisdom you have collected. Please email your contribution to
 
128
        <ulink noescape="1" url="mailto:jht@samba.org">John H. Terpstra (jht@samba.org)</ulink>.
 
129
        As a service to other users we will gladly adopt material that is technically accurate.
 
130
        </para>
 
131
 
 
132
        <para>
 
133
        Existing Samba books are largely addressed to the UNIX administrator.
 
134
        From the perspective of this target group the existing books serve
 
135
        an adequate purpose, with one exception &smbmdash; now that Samba-3 is out
 
136
        they need to be updated!
 
137
        </para>
 
138
 
 
139
        <para>
 
140
        This book, the <emphasis>Official Samba-3 HOWTO and Reference Guide</emphasis>,
 
141
        includes the Samba-HOWTO-Collection.pdf that ships with Samba.
 
142
        These documents have been written with a new design intent and purpose.
 
143
        </para>
 
144
 
 
145
        <para>
 
146
        Over the past two years many Microsoft network administrators have adopted
 
147
        Samba and have become interested in its deployment. Their information needs
 
148
        are very different from that of the UNIX administrator. This book has been
 
149
        arranged and the information presented from the perspective of someone with previous
 
150
        Microsoft Windows network administrative training and experience.
 
151
        </para>
 
152
 
 
153
</sect1>
 
154
 
 
155
<sect1>
 
156
<title>Book Structure and Layout</title>
 
157
 
 
158
        <para>
 
159
        This book is presented in six parts:
 
160
        </para>
 
161
 
 
162
        <variablelist>
 
163
                <varlistentry><term>General Installation</term>
 
164
                        <listitem><para>
 
165
                        Designed to help you get Samba-3 running quickly.
 
166
                        The Fast Start chapter is a direct response to requests from
 
167
                        Microsoft network administrators for some sample configurations
 
168
                        that <emphasis>just work</emphasis>.
 
169
                        </para></listitem>
 
170
                </varlistentry>
 
171
 
 
172
                <varlistentry><term>Server Configuration Basics</term>
 
173
                        <listitem><para>
 
174
                        The purpose of this section is to aid the transition from existing
 
175
                        Microsoft Windows network knowledge to Samba terminology and norms.
 
176
                        The chapters in this part each cover the installation of one type of 
 
177
                        Samba server.
 
178
                        </para></listitem>
 
179
                </varlistentry>
 
180
 
 
181
                <varlistentry><term>Advanced Configuration</term>
 
182
                        <listitem><para>
 
183
                        The mechanics of network browsing have long been the Achilles heel of
 
184
                        all Microsoft Windows users. Samba-3 introduces new user and machine
 
185
                        account management facilities, a new way to map UNIX groups and Windows
 
186
                        groups, Interdomain trusts, new loadable file system drivers (VFS), and
 
187
                        more. New with this document is expanded printing documentation, as well
 
188
                        as a wealth of information regarding desktop and user policy handling,
 
189
                        use of desktop profiles, and techniques for enhanced network integration.
 
190
                        This section makes up the core of the book. Read and enjoy.
 
191
                        </para></listitem>
 
192
                </varlistentry>
 
193
 
 
194
                <varlistentry><term>Migration and Updating</term>
 
195
                        <listitem><para>
 
196
                        A much requested addition to the book is information on how to migrate
 
197
                        from Microsoft Windows NT4 to Samba-3, as well as an overview of what the
 
198
                        issues are when moving from Samba-2.x to Samba-3.
 
199
                        </para></listitem>
 
200
                </varlistentry>
 
201
 
 
202
                <varlistentry><term>Troubleshooting</term>
 
203
                        <listitem><para>
 
204
                        This short section should help you when all else fails.
 
205
                        </para></listitem>
 
206
                </varlistentry>
 
207
 
 
208
                <varlistentry><term>Reference Section</term>
 
209
                        <listitem><para>
 
210
                        Here you will find a collection of things that are either too peripheral
 
211
                        for most users, or are a little left of field to be included in the
 
212
                        main body of information.
 
213
                        </para></listitem>
 
214
                </varlistentry>
 
215
        </variablelist>
 
216
                
 
217
<para>
 
218
Welcome to Samba-3 and the first published document to help you and your users to enjoy a whole
 
219
new world of interoperability between Microsoft Windows and the rest of the world.
 
220
</para>
 
221
 
 
222
</sect1>
 
223
 
 
224
</preface>