summaryrefslogtreecommitdiff
path: root/docs/howto/IntroSMB.xml
blob: 5cb5be57efb323a03f3dcf890d2ff8d2bc1cf95b (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
<preface id="IntroSMB">
<chapterinfo>
	&author.jht;
	<pubdate>June 29, 2003</pubdate>
</chapterinfo>

<title>Preface and Introduction</title>

<para><quote>
A man's gift makes room for him before great men. Gifts are like hooks that can catch
hold of the mind taking it beyond the reach of forces that otherwise might constrain it.
</quote> --- Anon.
</para>


<para>
This is a book about Samba. It is a tool, a derived work of the labors
of many and of the diligence and goodwill of more than a few.
This book contains material that has been contributed in a persistent belief
that each of us can add value to our neighbors as well as to those who will
follow us.
</para>

<para>
This book is designed to meet the needs of the Microsoft network administrator.
UNIX administrators will benefit from this book also, though they may complain
that it is hard to find the information they think they need. So if you are a
Microsoft certified specialist, this book should meet your needs rather well.
If you are a UNIX or Linux administrator, there is no need to feel badly &smbmdash; you
should have no difficulty finding answers to your current concerns also.
</para>

<sect1>
<title>What Is Samba?</title>

	<para>
	Samba is a big, complex project. The Samba project is ambitious and exciting.
	The team behind Samba is a group of some thirty individuals who are spread
	the world over and come from an interesting range of backgrounds. This team
	includes scientists, engineers, programmers, business people, and students.
	</para>

	<para>
	Team members were drawn into active participation through the desire to help
	deliver an exciting level of transparent interoperability between Microsoft
	Windows and the non-Microsoft information
	technology world. 
	</para>

	<para>
	The slogan that unites the efforts behind the Samba project says:
	<emphasis>Samba, Opening Windows to a Wider World!</emphasis> The goal
	behind the project is one of removing barriers to interoperability.
	</para>

	<para>
	Samba provides file and print services for Microsoft Windows clients. These
	services may be hosted off any TCP/IP-enabled platform. The original deployment
	platforms were UNIX and Linux, though today it is in common use across
	a broad variety of systems.
	</para>

	<para>
	The Samba project includes not only an impressive feature set in file and print
	serving capabilities, but has been extended to include client functionality,
	utilities to ease migration to Samba, tools to aid interoperability with
	Microsoft Windows, and administration tools.
	</para>

	<para>
	The real people behind Samba are users like you. You have inspired the
	developers (the Samba Team) to do more than any of them imagined could or should
	be done. User feedback drives Samba development. Samba-3 in particular incorporates
	a huge amount of work done as a result of user requests, suggestions and direct
	code contributions.
	</para>

</sect1>

<sect1>
<title>Why This Book?</title>

	<para>
	There is admittedly a large number of Samba books on the market today and
	each book has its place. Despite the apparent plethora of books, Samba
	as a project continues to receive much criticism for failing to provide
	sufficient documentation. Samba is also criticized for being too complex
	and too difficult to configure. In many ways this is evidence of the
	success of Samba as there would be no complaints if it was not successful.
	</para>

	<para>
	The Samba Team members work predominantly with UNIX and Linux, so
	it is hardly surprising that existing Samba documentation should reflect
	that orientation. The original HOWTO text documents were intended to provide
	some tips, a few golden nuggets, and if they helped anyone then that was
	just wonderful. But the HOWTO documents lacked structure and context. They were
	isolated snapshots of information that were written to pass information
	on to someone else who might benefit. They reflected a need to transmit
	more information that could be conveniently put into manual pages.
	</para>

	<para>
	The original HOWTO documents were written by different authors. Most HOWTO
	documents are the result of feedback and contributions from numerous
	authors. In this book we took care to preserve as much original content as
	possible. As you read this book you will note that chapters were written by
	multiple authors, each of whom has his own style. This demonstrates
	the nature of the Open Source software development process.
	</para>

	<para>
	Out of the original HOWTO documents sprang a collection of unofficial
	HOWTO documents that are spread over the Internet. It is sincerely intended
	that this work will <emphasis>not</emphasis> replace the valuable unofficial 
	HOWTO work that continues to flourish. If you are involved in unofficial 
	HOWTO production then please continue your work!
	</para>

	<para>
	Those of you who have dedicated your labors to the production of unofficial
	HOWTOs, to Web page information regarding Samba, or to answering questions
	on the mailing lists or elsewhere, may be aware that this is a labor
	of love. We would like to know about your contribution and willingly receive
	the precious pearls of wisdom you have collected. Please email your contribution to
	<ulink noescape="1" url="mailto:jht@samba.org">John H. Terpstra (jht@samba.org)</ulink>.
	As a service to other users we will gladly adopt material that is technically accurate.
	</para>

	<para>
	Existing Samba books are largely addressed to the UNIX administrator.
	From the perspective of this target group the existing books serve
	an adequate purpose, with one exception &smbmdash; now that Samba-3 is out
	they need to be updated!
	</para>

	<para>
	This book, the <emphasis>Official Samba-3 HOWTO and Reference Guide</emphasis>,
	includes the Samba-HOWTO-Collection.pdf that ships with Samba.
	These documents have been written with a new design intent and purpose.
	</para>

	<para>
	Over the past two years many Microsoft network administrators have adopted
	Samba and have become interested in its deployment. Their information needs
	are very different from that of the UNIX administrator. This book has been
	arranged and the information presented from the perspective of someone with previous
	Microsoft Windows network administrative training and experience.
	</para>

</sect1>

<sect1>
<title>Book Structure and Layout</title>

	<para>
	This book is presented in six parts:
	</para>

	<variablelist>
		<varlistentry><term>General Installation</term>
			<listitem><para>
			Designed to help you get Samba-3 running quickly.
			The Fast Start chapter is a direct response to requests from
			Microsoft network administrators for some sample configurations
			that <emphasis>just work</emphasis>.
			</para></listitem>
		</varlistentry>

		<varlistentry><term>Server Configuration Basics</term>
			<listitem><para>
			The purpose of this section is to aid the transition from existing
			Microsoft Windows network knowledge to Samba terminology and norms.
			The chapters in this part each cover the installation of one type of 
			Samba server.
			</para></listitem>
		</varlistentry>

		<varlistentry><term>Advanced Configuration</term>
			<listitem><para>
			The mechanics of network browsing have long been the Achilles heel of
			all Microsoft Windows users. Samba-3 introduces new user and machine
			account management facilities, a new way to map UNIX groups and Windows
			groups, Interdomain trusts, new loadable file system drivers (VFS), and
			more. New with this document is expanded printing documentation, as well
			as a wealth of information regarding desktop and user policy handling,
			use of desktop profiles, and techniques for enhanced network integration.
			This section makes up the core of the book. Read and enjoy.
			</para></listitem>
		</varlistentry>

		<varlistentry><term>Migration and Updating</term>
			<listitem><para>
			A much requested addition to the book is information on how to migrate
			from Microsoft Windows NT4 to Samba-3, as well as an overview of what the
			issues are when moving from Samba-2.x to Samba-3.
			</para></listitem>
		</varlistentry>

		<varlistentry><term>Troubleshooting</term>
			<listitem><para>
			This short section should help you when all else fails.
			</para></listitem>
		</varlistentry>

		<varlistentry><term>Appendix</term>
			<listitem><para>
			Here you will find a collection of things that are either too peripheral
			for most users, or are a little left of field to be included in the
			main body of information.
			</para></listitem>
		</varlistentry>
	</variablelist>
		
<para>
Welcome to Samba-3 and the first published document to help you and your users to enjoy a whole
new world of interoperability between Microsoft Windows and the rest of the world.
</para>

</sect1>

</preface>