python: Build shared python modules for generic use.
[ira/wip.git] / howto.txt
index 4c0797e4637ee25511a52c00adf9ce8d07b48632..7b10b5960a4571933ea191b7828c894b47ba7d34 100644 (file)
--- a/howto.txt
+++ b/howto.txt
@@ -4,6 +4,9 @@ Samba4 developer howto
 tridge@samba.org, December 2004
 
 
+A more up to date version of this howto can be found in the wiki 
+at http://wiki.samba.org/index.php/Samba4/HOWTO.
+
 This is a very basic document on how to setup a simple Samba4
 server. This is aimed at developers who are already familiar with
 Samba3 and wish to participate in Samba4 development. This is not
@@ -22,6 +25,12 @@ There are 2 methods of doing this:
 both methods will create a directory called "samba4" in the current
 directory. If you don't have rsync or svn then install one of them. 
 
+Since only released versions of Samba contain a pregenerated configure script, 
+you will have to generate it by hand:
+
+ $ cd samba4/source
+ $ ./autogen.sh
+
 Note that the above rsync command will give you a checked out svn
 repository. So if you also have svn you can update it to the latest
 version at some future date using:
@@ -32,17 +41,20 @@ version at some future date using:
 Step 2: compile Samba4
 ----------------------
 
+Recommended optional development libraries:
+- acl and xattr development libraries
+- gnutls
+- readline
+
 Run this:
 
   $ cd samba4/source
-  $ ./autogen.sh
-  $ ./configure.developer
+  $ ./configure
   $ make proto all
 
-If you have gcc 3.4 or newer, then substitue "pch" for "proto" to
+If you have gcc 3.4 or newer, then substitute "pch" for "proto" to
 greatly speed up the compile process (about 5x faster).
 
-
 Step 3: install Samba4
 ----------------------
 
@@ -62,7 +74,12 @@ It is presumed it's available just like any other commands from your shell.
 Must be run as a user with permission to write to the install directory.
 
   # cd source
-  # ./setup/provision --realm=YOUR.REALM --domain=YOURDOM --adminpass=SOMEPASSWORD
+  # ./setup/provision --realm=YOUR.REALM --domain=YOURDOM \
+  #  --adminpass=SOMEPASSWORD --server-role='domain controller'
+
+REMINDER: Add the "bin" directory of the path you installed to
+          (e.g. /usr/local/samba/bin) to your path, or the provision command
+          will not work.
 
 'YOURDOM' is the NT4 style domain name. 'YOUR.REALM' is your kerberos
 realm, which is typically your DNS domain name.