docs/Samba-HOWTO-Collection/IntroSMB.xml

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