docs/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>