r7990: An attempt at documenting the current state of cludges required to get
[ira/wip.git] / howto.txt
index 76acc19d9be4b6fa4242a559939c7b2adff0398d..cc728b904a27dc423fc4d58c93491294f7848d01 100644 (file)
--- a/howto.txt
+++ b/howto.txt
@@ -29,6 +29,29 @@ version at some future date using:
   $ cd samba4
   $ svn up
 
+Step 1a: Use Lorikeet/Heimdal
+-----------------------------
+
+If you want to use Kerberos in Samba4, you must use
+'Lorikeet/heimdal', and place a checkout into samba4/source/heimdal
+
+There are 2 methods of doing this:
+
+  method 1:  
+    $ cd samba4/source
+    $ rsync -avz samba.org::ftp/unpacked/lorikeet-heimdal heimdal
+
+  method 2:  
+
+    $ cd samba4/source
+    $ svn co svn://svnanon.samba.org/lorikeet/trunk/heimdal heimdal
+
+both methods will create a directory called "heimdal" in the samba4/source
+directory. 
+
+(Long-term, we will either import Heimdal from 'lorikeet', or setup a
+reference between the repositories, so this and svn update works
+automaticly. In the short term, you must manually update this directory). 
 
 Step 2: compile Samba4
 ----------------------
@@ -38,8 +61,13 @@ Run this:
   $ cd samba4/source
   $ ./autogen.sh
   $ ./configure.developer -C
+
+If you did not include heimdal, run this:
   $ make
 
+If you did include Heimdal, a different step is required:
+  $ make HEIMDAL_EXTERNAL all
+
 If you have gcc 3.4 or newer, then run "make pch" before "make" to
 greatly speed up the compile process (about 5x faster).