You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@directory.apache.org by pl...@apache.org on 2015/08/05 14:14:54 UTC
svn commit: r1694197 - in /directory/site/trunk/content/kerby:
developer-guide.mdtext user-guide/1-how-to-begin.mdtext
user-guide/2.4-simplekdcserver.mdtext
Author: plusplusjiajia
Date: Wed Aug 5 12:14:54 2015
New Revision: 1694197
URL: http://svn.apache.org/r1694197
Log:
Refine the guide of Kerby.
Modified:
directory/site/trunk/content/kerby/developer-guide.mdtext
directory/site/trunk/content/kerby/user-guide/1-how-to-begin.mdtext
directory/site/trunk/content/kerby/user-guide/2.4-simplekdcserver.mdtext
Modified: directory/site/trunk/content/kerby/developer-guide.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/kerby/developer-guide.mdtext?rev=1694197&r1=1694196&r2=1694197&view=diff
==============================================================================
--- directory/site/trunk/content/kerby/developer-guide.mdtext (original)
+++ directory/site/trunk/content/kerby/developer-guide.mdtext Wed Aug 5 12:14:54 2015
@@ -31,19 +31,18 @@ To get the source, you will need to have
The git repository is mirrored to Github: <https://github.com/apache/directory-kerby/>.
-## Build
+## Build Requirements:
-###Requirements:
* JDK 1.7+
* Maven 3.0 or later
* Findbugs 1.3.9 (if running findbugs)
* Internet connection for first build (to fetch all Maven and Kerby dependencies)
-###Where to run Maven from?
+##Where to run Maven from?
It should be run at the top directory of Kerby.
-###Maven build goals:
+##Maven build goals:
* Clean : mvn clean [-Preleasedocs]
* Compile : mvn compile [-Pnative]
@@ -54,7 +53,7 @@ It should be run at the top directory of
* Build distribution : mvn package [-Pdist][-Pdocs][-Psrc][-Pnative][-Dtar][-Preleasedocs]
* Run findbugs : mvn compile findbugs:findbugs
-###Build options:
+##Build options:
* To run findbugs without running tests : mvn clean package -DskipTests findbugs:findbugs [site]
* Building distributions without running tests : mvn package -Pdist -DskipTests (tar package in /kerby/kerby-dist/kdc-dist/target/ & /kerby/kerby-dist/tool-dist/target/)
Modified: directory/site/trunk/content/kerby/user-guide/1-how-to-begin.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/kerby/user-guide/1-how-to-begin.mdtext?rev=1694197&r1=1694196&r2=1694197&view=diff
==============================================================================
--- directory/site/trunk/content/kerby/user-guide/1-how-to-begin.mdtext (original)
+++ directory/site/trunk/content/kerby/user-guide/1-how-to-begin.mdtext Wed Aug 5 12:14:54 2015
@@ -43,19 +43,19 @@ The distribution of Kerby.
* Run kadmin to add principals:
$ cd kerby-dist/kdc-dist
- $ sh bin/kadmin.sh [server-conf-dir]
+ $ sh bin/kadmin.sh [server-conf-dir] [-k keytab]
In kadmin, you can type "?" for help.
* Start kerby-kdc-server:
$ cd kerby-dist/kdc-dist
- $ sh bin/start-kdc.sh Âstart [server-conf-dir] [work-dir]
+ $ sh bin/start-kdc.sh [server-conf-dir] [work-dir]
* Run kinit:
$ cd kerby-dist/tool-dist
- $ sh bin/kinit.sh [principal-name]
+ $ sh bin/kinit.sh [-conf client-conf-dir] [principal-name]
* Run klist:
@@ -70,7 +70,7 @@ An example of kdc.conf:
[kdcdefaults]
kdc_host = localhost
kdc_tcp_port = 8015
- kdc_realm = TEST.COM
+ kdc_realm = EXAMPLE.COM
An example of json backend backend.conf:
@@ -86,5 +86,6 @@ An example of zookeeper backend backend.
An example of krb5.conf:
[libdefaults]
- kdc_realm=TEST.COM
+ kdc_realm = EXAMPLE.COM
+ kdc_tcp_port = 8015
Modified: directory/site/trunk/content/kerby/user-guide/2.4-simplekdcserver.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/kerby/user-guide/2.4-simplekdcserver.mdtext?rev=1694197&r1=1694196&r2=1694197&view=diff
==============================================================================
--- directory/site/trunk/content/kerby/user-guide/2.4-simplekdcserver.mdtext (original)
+++ directory/site/trunk/content/kerby/user-guide/2.4-simplekdcserver.mdtext Wed Aug 5 12:14:54 2015
@@ -27,7 +27,6 @@ A simplified Kdc server. It can be impor
## Kdc server
-</pre>
* Start simple kdc server.
<pre>
start();
@@ -55,10 +54,10 @@ setAllowTcp(allowTcp);
* Set to allow UDP or not.
<pre>
setAllowUdp(allowUdp);
+</pre>
-### Kadmin
+## Kadmin
-</pre>
* Create principle with principal name.
<pre>
createPrincipal(principal);
@@ -79,12 +78,10 @@ createAndExportPrincipals(keytabFile pri
<pre>
deletePrincipal(principal);
</pre>
-</pre>
* Delete principles with principal names.
<pre>
deletePrincipals(principals);
</pre>
-</pre>
* Export principles to keytab file.
<pre>
exportPrincipals(keytabFile);