You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@hudi.apache.org by yi...@apache.org on 2022/09/26 14:13:02 UTC

[hudi] branch asf-site updated: [HUDI-4718] Docs for Adding Kerberos kinit command support for cli. (#6790)

This is an automated email from the ASF dual-hosted git repository.

yihua pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/hudi.git


The following commit(s) were added to refs/heads/asf-site by this push:
     new 7de938f2cc [HUDI-4718] Docs for Adding Kerberos kinit command support for cli. (#6790)
7de938f2cc is described below

commit 7de938f2cc2c1e85df58d599c83e734a5d176ae0
Author: Paul Zhang <xz...@126.com>
AuthorDate: Mon Sep 26 22:12:55 2022 +0800

    [HUDI-4718] Docs for Adding Kerberos kinit command support for cli. (#6790)
---
 website/docs/cli.md | 44 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 44 insertions(+)

diff --git a/website/docs/cli.md b/website/docs/cli.md
index 9d1e98198b..1d64d96e12 100644
--- a/website/docs/cli.md
+++ b/website/docs/cli.md
@@ -41,6 +41,50 @@ Once these are set, you are good to launch hudi-cli and access S3 dataset.
 ./hudi-cli/hudi-cli.sh
 ```
 
+
+## Connect to a Kerberized cluster
+
+Before connecting to a Kerberized cluster, you can use **kerberos kinit** command. Following is the usage of this command.
+
+```shell
+hudi->help kerberos kinit
+NAME
+       kerberos kinit - Perform Kerberos authentication
+
+SYNOPSIS
+       kerberos kinit --krb5conf String [--principal String] [--keytab String]
+
+OPTIONS
+       --krb5conf String
+       Path to krb5.conf
+       [Optional, default = /etc/krb5.conf]
+
+       --principal String
+       Kerberos principal
+       [Mandatory]
+
+       --keytab String
+       Path to keytab
+       [Mandatory]
+```
+
+For example:
+
+```shell
+hudi->kerberos kinit --principal user/host@DOMAIN --keytab /etc/security/keytabs/user.keytab
+Perform Kerberos authentication
+Parameters:
+--krb5conf: /etc/krb5.conf
+--principal: user/host@DOMAIN
+--keytab: /etc/security/keytabs/user.keytab
+Kerberos current user: user/host@DOMAIN (auth:KERBEROS)
+Kerberos login user: user/host@DOMAIN (auth:KERBEROS)
+Kerberos authentication success
+```
+
+If you see "Kerberos authentication success" in the command output, it means Kerberos authentication has been successful.
+
+
 ## Using hudi-cli
 
 To initialize a hudi table, use the following command.