Initial import of the swiftkerbauth

Imported code till commit f64a3354185f32928e2568d9ece4a52fa4746c05
Changed a code bit to import correct definitions.
kerbauth unit tests do run along with gluster-swift.
Install script does install swiftkerbauth.
import swiftkerbauth from http://review.gluster.org/swiftkrbauth.git

Change-Id: Ia89f2b77cc68df10dee2f41ce074f3381ac3c408
Signed-off-by: Chetan Risbud <crisbud@redhat.com>
Reviewed-on: http://review.gluster.org/6597
Reviewed-by: Prashanth Pai <ppai@redhat.com>
Reviewed-by: Luis Pabon <lpabon@redhat.com>
Tested-by: Luis Pabon <lpabon@redhat.com>

1 files changed, 80 insertions, 0 deletions

diff --git a/doc/markdown/swiftkerbauth/ipa_client.md b/doc/markdown/swiftkerbauth/ipa_client.md
new file mode 100644
index 0000000..f6afc42
--- /dev/null
+++ b/doc/markdown/swiftkerbauth/ipa_client.md
@@ -0,0 +1,80 @@
+#IPA Client Guide
+
+##Contents
+* [Setup Overview] (#setup)
+* [Configure Network] (#network)
+* [Installing IPA Client] (#ipa-client)
+
+<a name="setup" />
+##Setup Overview
+We have used a F18 box as IPA client machine and used FreeIPA client.
+This document borrows instructions from the following more detailed guide.
+[RHEL 6 Identity Management Guide][]
+
+
+<a name="network" />
+## Configure network
+
+Set hostname (FQDN) to client.rhelbox.com
+> hostnamectl set-hostname "client.rhelbox.com"
+>
+> hostname "client.rhelbox.com"
+
+Add following to /etc/sysconfig/network:
+
+    HOSTNAME=client.rhelbox.com
+
+Add the following to /etc/hostname
+
+    client.rhelbox.com
+
+Add the following to /etc/hosts
+
+    192.168.56.110 server.rhelbox.com server
+    192.168.56.101 client.rhelbox.com client
+
+Logout and login again and verify hostname :
+> hostname --fqdn
+
+Edit */etc/resolv.conf* to add this at beginning of file
+
+    nameserver 192.168.56.110
+
+Warning: NetworkManager changes resolv.conf on restart
+
+Turn off firewall
+> service iptables stop
+>
+> chkconfig iptables off
+
+<a name="ipa-client" />
+## Installing IPA Client
+
+Install IPA client packages:
+
+For RHEL:
+> yum install ipa-client ipa-admintools
+
+For Fedora:
+> yum install freeipa-client freeipa-admintools
+
+Install IPA client and add to domain:
+>ipa-client-install --enable-dns-updates
+
+    Discovery was successful!
+    Hostname: client.rhelbox.com
+    Realm: RHELBOX.COM
+    DNS Domain: rhelbox.com
+    IPA Server: server.rhelbox.com
+    BaseDN: dc=rhelbox,dc=com
+
+    Continue to configure the system with these values? [no]: yes
+    User authorized to enroll computers: admin
+
+Check if client is configured correctly:
+> kinit admin
+>
+> getent passwd admin
+
+
+[RHEL 6 Identity Management Guide]: https://access.redhat.com/site/documentation/en-US/Red_Hat_Enterprise_Linux/6/html/Identity_Management_Guide/