Updated for 2.0beta1.
[samba.git] / docs / textdocs / UNIX_INSTALL.txt
index 3ba38bf59916614f1c1a9da48acbf8fa302fe251..074693acc84c59a6d54c36356bacc8efe9f6258d 100644 (file)
@@ -1,10 +1,10 @@
 !==
-!== UNIX_INSTALL.txt for Samba release 1.9.18alpha2 22 Oct 1997
+!== UNIX_INSTALL.txt for Samba release 2.0.0-alpha11 09 Oct 1998
 !==
 Contributor:   Andrew Tridgell <samba-bugs@samba.anu.edu.au>
 Date:          Unknown
 Status:                Current
-Updated:       August 25, 1997
+Updated:       November 13, 1998       <jra@samba.anu.edu.au>
 
 Subject:       HOW TO INSTALL AND TEST SAMBA
 ===============================================================================
@@ -16,22 +16,15 @@ try something like:
 
        nroff -man smbd.8 | more
 
-Unfortunately, having said this, the man pages are sadly out of date and
-really need more effort to maintain them. Other sources of information 
-are pointed to by the Samba web site, http://samba.anu.edu.au/samba.
+Other sources of information are pointed to by the Samba web 
+site, http://samba.anu.edu.au/samba.
 
 STEP 1. Building the binaries
 
-To do this, first edit the file source/Makefile. You will find that
-the Makefile has an entry for most unixes and you need to uncomment
-the one that matches your operating system.
-
-You should also edit the section at the top of the Makefile which
-determines where things will be installed. You need to get this right
-before compilation as Samba needs to find some things at runtime
-(smbrun in particular). There are also settings for where you want
-your log files etc. Make sure you get these right, and that the
-directories exist.
+To do this, first run the program ./configure in the source
+directory. This should automatically configure Samba for your
+operating system. If you have unusual needs then you may wish to run
+"./configure --help" first to see what special options you can enable.
 
 Then type "make". This will create the binaries.
 
@@ -50,7 +43,7 @@ At this stage you must fetch yourself a coffee or other drink you find
 stimulating. Getting the rest of the install right can sometimes be
 tricky, so you will probably need it.
 
-If you have installed samba before then you can skip this step.
+If you have installed samba before then you can skip this step. 
 
 STEP 3. Create the smb configuration file. 
 
@@ -79,6 +72,9 @@ in the Makefile for the logs etc, such as /usr/local/samba.
 Make sure you put the smb.conf file in the same place you specified in
 the Makefile.
 
+For more information about security settings for the [homes] share please
+refer to the document UNIX_SECURITY.txt
+
 STEP 4. Test your config file with testparm
 
 It's important that you test the validity of your smb.conf file using
@@ -94,7 +90,9 @@ You must choose to start smbd and nmbd either as daemons or from
 inetd. Don't try to do both!  Either you can put them in inetd.conf
 and have them started on demand by inetd, or you can start them as
 daemons either from the command line or in /etc/rc.local. See the man
-pages for details on the command line options.
+pages for details on the command line options. Take particular care 
+to read the bit about what user you need to be in order to start Samba.
+In many cases you must be root.
 
 The main advantage of starting smbd and nmbd as a daemon is that they
 will respond slightly more quickly to an initial connection
@@ -177,7 +175,7 @@ non-Samba servers)
 
 STEP 7. try connecting with the unix client. eg:
 
-smbclient '\\yourhostname\aservice'
+smbclient //yourhostname/aservice
 
 Typically the "yourhostname" would be the name of the host where you
 installed smbd. The "aservice" is any service you have defined in the
@@ -187,10 +185,7 @@ in smb.conf.
 For example if your unix host is bambi and your login name is fred you
 would type:
 
-smbclient '\\bambi\fred'
-
-NOTE: The number of slashes to use depends on the type of shell you
-use. You may need '\\\\bambi\\fred' with some shells.
+smbclient //bambi/fred
 
 STEP 8. Try connecting from a dos/WfWg/Win95/NT/os-2 client. Try
 mounting disks. eg: