Updated samba appliance example.
[kai/samba.git] / examples / appliance / README
1 This directory provides build tools for building a Samba based domain
2 appliance.
3
4 A appliance is a box that gets its username and group database from a
5 domain controller, and does its authentication via a domain
6 controller. Right now this is only supported by combining two CVS
7 branches of Samba, which is what the files in this directory do.
8
9 SETUP
10 -----
11
12 To setup an appliance do the following:
13
14 1) build and install Samba using the .spec file or Makefile in this
15    directory.
16
17 2) setup winbindd by following the directions in the winbindd man
18    page.
19
20 3) test winbindd, validating that domain users and groups are visible
21    and that domain authentication works, both using unix tools and
22    smbclient. 
23
24 for appliance printing support also do this:
25
26 4) create a print$ share with write permission for print
27    administrators.
28
29 4) create the "nt printer driver" directory (by default
30    /usr/local/samba/lib/ntprinters) and make it writable by print
31    adminisrators.
32
33 5) populate your /etc/printcap printer database
34
35 6) add printers using the NT "add printer wizard" in the Printers
36    network folder.
37
38
39 PACKAGING
40 ---------
41
42 - Checkout the Samba CVS head branch into a directory call 
43   samba-appliance-0.2/head
44
45 - Checkout the source subdirectory of the Samba CVS SAMBA_TNG branch
46   into a directory call samba-appliance-0.2/tng
47
48 - Copy Makefile and smb.conf-appliance to samba-appliance-0.2/
49
50 - run build.sh
51
52 That should build source and binary RPMs in /usr/src/redhat/{RPMS,SRPMS}