directory-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From plusplusjia...@apache.org
Subject directory-kerby git commit: Update Readme.
Date Fri, 31 Jul 2015 06:33:04 GMT
Repository: directory-kerby
Updated Branches:
  refs/heads/master b9fc6d673 -> 01fe4fc43


Update Readme.


Project: http://git-wip-us.apache.org/repos/asf/directory-kerby/repo
Commit: http://git-wip-us.apache.org/repos/asf/directory-kerby/commit/01fe4fc4
Tree: http://git-wip-us.apache.org/repos/asf/directory-kerby/tree/01fe4fc4
Diff: http://git-wip-us.apache.org/repos/asf/directory-kerby/diff/01fe4fc4

Branch: refs/heads/master
Commit: 01fe4fc43a44ba87c30a862f829d2fa126c80e9f
Parents: b9fc6d6
Author: plusplusjiajia <jiajia.li@intel.com>
Authored: Fri Jul 31 14:36:21 2015 +0800
Committer: plusplusjiajia <jiajia.li@intel.com>
Committed: Fri Jul 31 14:36:21 2015 +0800

----------------------------------------------------------------------
 README.md            |  4 +++-
 kerby-dist/README.md | 35 ++++++++++++++++++++++++++---------
 2 files changed, 29 insertions(+), 10 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/directory-kerby/blob/01fe4fc4/README.md
----------------------------------------------------------------------
diff --git a/README.md b/README.md
index 1f3f0e7..2901a02 100644
--- a/README.md
+++ b/README.md
@@ -86,8 +86,10 @@ A standalone KDC server that can integrate various identity back ends including:
   - With better throughput, lower latency.
 
 ### Tools
+- kdcinit:
+  - This is used to initialize and prepare all kinds of KDC side materials, like initializing
concrete back end, setting up master keys, necessary principals (tgs, kadmin) and etc.
 - kadmin:
-  -Command-line interfaces to the Kerby administration system.
+  - Command-line interfaces to the Kerby administration system.
 - kinit:
   - Obtains and caches an initial ticket-granting ticket for principal.
 - klist:

http://git-wip-us.apache.org/repos/asf/directory-kerby/blob/01fe4fc4/kerby-dist/README.md
----------------------------------------------------------------------
diff --git a/kerby-dist/README.md b/kerby-dist/README.md
index 35be8db..533bba8 100644
--- a/kerby-dist/README.md
+++ b/kerby-dist/README.md
@@ -3,31 +3,48 @@ Kerby-dist
 
 The distribution of Kerby.
 
-### To run with a standalone kdc server, kinit and kadmin
+### To run with a standalone kdc server, kdcinit, kadmin, kinit and klist
 
-* Generate libraries for distribution:
+* 1. Generate libraries for distribution:
 ```
 mvn package -Pdist
 ```
 
-* Run kadmin to add principals:
+* 2. Run kdcinit:
 ```
-sh kerby-dist/tool-dist/bin/kadmin.sh [server-conf-dir]
+cd kerby-dist/kdc-dist
+sh bin/kdcinit.sh [server-conf-dir] [keytab]
+```
+The admin principal will be exported into [keytab], it will be used by kadmin tool for the
authentication. 
+
+* 3. Run kadmin to add principals:
+```
+cd kerby-dist/kdc-dist
+sh bin/kadmin.sh [server-conf-dir] -k [keytab]
 ```
 
   In kadmin, you can type "?" for help. For now, the kadmin only supports to add principals
to json-backend. (Working in progress).
 
-* Start kerby-kdc-server:
+* 4. Start kerby-kdc-server:
+```
+cd kerby-dist/kdc-dist
+sh bin/start-kdc.sh –start [server-conf-dir] [work-dir]
+```
+
+* 5. Run kinit:
 ```
-sh kerby-dist/kdc-dist/bin/start-kdc.sh –start [server-conf-dir] [work-dir]
+cd kerby-dist/tool-dist
+sh bin/kinit.sh -conf [client-conf-dir] [principal-name]
 ```
 
-* Run kinit:
+* 6. Run klist:
 ```
-sh kerby-dist/tool-dist/bin/kinit.sh [principal-name]
+cd kerby-dist/tool-dist
+sh bin/klist.sh -c [credentials-cache]
 ```
 
-  If you don't specify [server-conf-dir] in step 2 or 3, it will be set as /etc/kerby. In
[server-conf-dir], there should be kdc.conf, backend.conf. And in /etc/, there should be krb5.conf.
+  If you don't specify [server-conf-dir] in step 2, 3 or 4, it will be set as /etc/kerby.
In [server-conf-dir], there should be kdc.conf, backend.conf. 
+  And if you don't specify [client -conf-dir] in step 5, it will be set as /etc/, there should
be krb5.conf.
 
 An example of kdc.conf:
 ```


Mime
View raw message