Samba-TNG						        INSTALL
-----------------------------------------------------------------------

Dependencies:
------------

Required:
  POSIX-like shell environment (basically, any Unix)
  ANSI C compiler and basic Unix compilation environment
  "make" utility

Highly recommended:
  A reasonable iconv (one is shipped with almost all Linux systems and
  some Unix systems - if in doubt, though, you can install the GNU
  version from http://www.gnu.org/software/libiconv/)

Optional:
  ldap client library (http://www.openldap.org/software/download/)
  glib 2.x (ftp://ftp.gtk.org/pub/gtk/)
  readline (http://cnswww.cns.cwru.edu/php/chet/readline/rltop.html)
  TCP wrapper (ftp://ftp.porcupine.org/pub/security/index.html)

For hacking on Samba-TNG:
  CVS (http://www.cvshome.org/)
  GNU autoconf (http://www.gnu.org/software/autoconf/)
  GNU make, specifically (http://www.gnu.org/software/make/)
  YODL (http://www.xs4all.nl/~jantien/yodl/)

See the file INSTALL.depends in this directory for explanations of
what these packages are and why you might or might not need them.


Install instructions:
--------------------

First, if you have checked this source out from CVS rather than using
a released tarball, some files will be missing.  To create them, you
must have GNU autoconf 2.59 or newer.  Go to the 'source' directory
and type:

  make -f dist.mk

If you have a released tarball, this step should not be necessary.

Now, to configure the Samba source and create a makefile, go to the
'source' directory and type:

  ./configure 

On some OSes this must be done logged in as root, so it can run various
tests related to file locking.  Run it as root unless you know your
platform isn't affected by this.

There are many options available, but due to the alpha nature of
Samba-TNG, some work and some do not.  The options relating to
directory locations (--prefix, --with-*dir, etc) should work, and LDAP
support (but not "nt5ldap"), and some others.  If in doubt, either do
not specify an option, or make sure to test that particular feature
thoroughly before putting it in production.  (But of course you do that
anyway, right?)  To see all available options, use './configure --help'.

Now type:

  make

and cross your fingers.  If all goes well, it will succeed, and you
can log in as root and type:

  make install

After installation, you will not have a usable server until you create
a config file, "smb.conf", in the config directory given to (or
determined by) the configure script.  (The default dir for this is
/usr/local/samba/etc/.)  An example smb.conf file is shipped in the
source in "examples/smb.conf.example".

You will also need to arrange to start the suite of Samba-TNG daemons
at boot time.  How to do this is rather OS-dependent, but the System
V-compatible script in "source/script/samba-init.d" should at least
get you started.  Consult the documentation for your `init' program.
