-HOW TO INSTALL AND TEST SAMBA
-=============================
+Contributor: Andrew Tridgell <samba-bugs@samba.anu.edu.au>
+Date: Unknown
+Status: Current
+
+Subject: HOW TO INSTALL AND TEST SAMBA
+===============================================================================
STEP 0. Read the man pages. They contain lots of useful info that will
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.canberra.edu.au/pub/samba.
+
STEP 1. Building the binaries
To do this, first edit the file source/Makefile. You will find that
The simplest useful configuration file would be something like this:
-[homes]
- workgroup = MYGROUP
- guest ok = no
- read only = no
+ workgroup = MYGROUP
+
+ [homes]
+ guest ok = no
+ read only = no
which would allow connections by anyone with an account on the server,
using either their login name or "homes" as the service name. (Note
underscore) in /etc/services. You must either edit /etc/services or
/etc/inetd.conf to make them consistant.
-NOTE: On many systems you may need to give the nmbd a -B parameter to
-specify the broadcast address of your interface. Run ifconfig as root
-if you don't know what the broadcast is for your net. nmbd tries to
-determine it at run time, but fails on some unixes. See the section on
-"testing nmbd" for a method of finding if you need to do this.
+NOTE: On many systems you may need to use the "interfaces" option in
+smb.conf to specify the IP address and netmask of your interfaces. Run
+ifconfig as root if you don't know what the broadcast is for your
+net. nmbd tries to determine it at run time, but fails on some
+unixes. See the section on "testing nmbd" for a method of finding if
+you need to do this.
!!!WARNING!!! Many unixes only accept around 5 parameters on the
command line in inetd. This means you shouldn't use spaces between the
To kill it send a kill signal to the processes nmbd and smbd.
+NOTE: If you use the SVR4 style init system then you may like to look
+at the examples/svr4-startup script to make Samba fit into that system.
-STEP 7. Try listing the shares available on your server
+STEP 6. Try listing the shares available on your server
smbclient -L yourhostname
adding the option -U% to the command line. This will not work with
non-Samba servers)
-STEP 8. try connecting with the unix client. eg:
+STEP 7. try connecting with the unix client. eg:
smbclient '\\yourhostname\aservice'
NOTE: The number of slashes to use depends on the type of shell you
use. You may need '\\\\bambi\\fred' with some shells.
-STEP 9. Try connecting from a dos/WfWg/Win95/NT/os-2 client. Try
+STEP 8. Try connecting from a dos/WfWg/Win95/NT/os-2 client. Try
mounting disks. eg:
net use d: \\servername\service
CHOOSING THE PROTOCOL LEVEL
===========================
-The SMB protocol has many dialects. Currently Samba supports 4, called
+The SMB protocol has many dialects. Currently Samba supports 5, called
CORE, COREPLUS, LANMAN1, LANMAN2 and NT1.
-You can choose what protocols to support in the smb.conf file. The
-default is NT1 and that is the best for the vast majority of sites.
+You can choose what maximum protocol to support in the smb.conf
+file. The default is NT1 and that is the best for the vast majority of
+sites.
In older versions of Samba you may have found it necessary to use
COREPLUS. The limitations that led to this have mostly been fixed. It
You can disable share modes using "share modes = no". This may be
useful on a heavily loaded server as the share modes code is very
-slow.
+slow. See also the FAST_SHARE_MODES option in the Makefile for a way
+to do full share modes very fast using shared memory (if your OS
+supports it).
MAPPING USERNAMES
If you have different usernames on the PCs and the unix server then
take a look at the "username map" option. See the smb.conf man page
for details.
+
+
+OTHER CHARACTER SETS
+====================
+
+If you have problems using filenames with accented characters in them
+(like the German, French or Scandinavian character sets) then I
+recommmend you look at the "valid chars" option in smb.conf and also
+take a look at the validchars package in the examples directory.