本文主要记录使用 yum 源安装 Hue 以及配置 Hue 集成 Hdfs、Hive、Impala、Yarn、Kerberos、LDAP、Sentry、Solr 等的过程。

安装环境：

• 操作系统：CentOs6.5
• Hadoop：cdh5.2.0
• Hue：3.6.0+cdh5.2.0

安装 Hue

在 Hadoop 集群的一个节点上安装 Hue server，这里我是在我的测试集群中的 cdh1 节点上安装：

$ yum install hue hue-server

配置 Hue

配置hue server

[desktop]
    http_host=cdh1
    http_port=8888
    secret_key=qpbdxoewsqlkhztybvfidtvwekftusgdlofbcfghaswuicmqp
    time_zone=Asia/Shanghai

如果想配置 SSL，则添加下面设置：

ssl_certificate=/path/to/certificate
ssl_private_key=/path/to/key

并使用下面命令生成证书：

# Create a key
$ openssl genrsa 1024 > host.key
# Create a self-signed certificate
$ openssl req -new -x509 -nodes -sha1 -key host.key > host.cert

配置 DB Query

DB Query 的相关配置在 hue.ini 中 databases 节点下面，目前共支持 sqlite, mysql, postgresql 和 oracle 四种数据库，默认使用的是 sqlite 数据库，你可以按自己的需要修改为其他的数据库。

[[database]]
    engine=sqlite3
    name=/var/lib/hue/desktop.db

配置 Hadoop 参数

HDFS 集群配置

在 hadoop.hdfs_clusters.default 节点下配置以下参数：

• fs_defaultfs：
• logical_name： NameNode 逻辑名称
• webhdfs_url：
• security_enabled：是否开启 Kerberos
• hadoop_conf_dir： hadoop 配置文件路径

完整配置如下：

[hadoop]
  [[hdfs_clusters]]
    [[[default]]]
      # Enter the filesystem uri
      fs_defaultfs=hdfs://mycluster

      # NameNode logical name.
      logical_name=mycluster

      # Use WebHdfs/HttpFs as the communication mechanism.
      # Domain should be the NameNode or HttpFs host.
      # Default port is 14000 for HttpFs.
      ## webhdfs_url=http://localhost:50070/webhdfs/v1
      webhdfs_url=http://cdh1:14000/webhdfs/v1

      # Change this if your HDFS cluster is Kerberos-secured
      security_enabled=true

      hadoop_conf_dir=/etc/hadoop/conf

配置 WebHDFS 或者 HttpFS

Hue 可以通过下面两种方式访问 Hdfs 中的数据：

• WebHDFS：提供高速的数据传输，客户端直接和 DataNode 交互
• HttpFS：一个代理服务，方便与集群外部的系统集成

两者都支持 HTTP REST API，但是 Hue 只能配置其中一种方式；对于 HDFS HA部署方式，只能使用 HttpFS。

• 1、对于 WebHDFS 方式，在每个节点上的 hdfs-site.xml 文件添加如下配置并重启服务：

<property>
  <name>dfs.webhdfs.enabled</name>
  <value>true</value>
</property>

• 2、 配置 Hue 为其他用户和组的代理用户。对于 WebHDFS 方式，在 core-site.xml 添加：

<!-- Hue WebHDFS proxy user setting -->
<property>
  <name>hadoop.proxyuser.hue.hosts</name>
  <value>*</value>
</property>
<property>
  <name>hadoop.proxyuser.hue.groups</name>
  <value>*</value>
</property>

对于 HttpFS 方式，在 /etc/hadoop-httpfs/conf/httpfs-site.xml 中添加下面配置并重启 HttpFS 进程：

<!-- Hue HttpFS proxy user setting -->
<property>
  <name>httpfs.proxyuser.hue.hosts</name>
  <value>*</value>
</property>
<property>
  <name>httpfs.proxyuser.hue.groups</name>
  <value>*</value>
</property>

对于 HttpFS 方式，在 core-site.xml 中添加下面配置并重启 hadoop 服务：

<property>
    <name>hadoop.proxyuser.httpfs.hosts</name>
    <value>*</value>
</property>
<property>
    <name>hadoop.proxyuser.httpfs.groups</name>
    <value>*</value>
</property>

• 3、修改 /etc/hue/conf/hue.ini 中 hadoop.hdfs_clusters.default.webhdfs_url 属性。

对于 WebHDFS：

webhdfs_url=http://cdh1:50070/webhdfs/v1/

对于 HttpFS：

webhdfs_url=http://cdh1:14000/webhdfs/v1/

YARN 集群配置

在 hadoop.yarn_clusters.default 节点下配置：

[hadoop]
  [[yarn_clusters]]
    [[[default]]]
        resourcemanager_host=cdh1
        resourcemanager_port=8032
        submit_to=True
        security_enabled=true
        resourcemanager_api_url=http://cdh1:8088
        proxy_api_url=http://cdh1:8088
        history_server_api_url=http://cdh1:19888

集成 Hive

在 beeswax 节点下配置：

[beeswax]
    hive_server_host=cdh1
    hive_server_port=10000
    hive_conf_dir=/etc/hive/conf

这里是配置为连接一个 Hive Server2 节点，如有需要可以配置负载均衡，连接一个负载节点。

集成 Impala

在 impala 节点下配置

[impala]
  # Host of the Impala Server (one of the Impalad)
  server_host=cdh1

  # Port of the Impala Server
  server_port=21050

  # Kerberos principal
  impala_principal=impala/cdh1@JAVACHEN.COM

  # Turn on/off impersonation mechanism when talking to Impala
  impersonation_enabled=True

这里是配置为连接一个 Impala Server 节点，如有需要可以配置负载均衡，连接一个负载节点。

参考 Configuring Per-User Access for Hue 和 Use the Impala App with Sentry for real security，在配置 impersonation_enabled 为 true 的情况下，还需要在 impalad 的启动参数中添加 authorized_proxy_user_config 参数，修改 /etc/default/impala中的 IMPALA_SERVER_ARGS 添加下面一行：

-authorized_proxy_user_config=hue=*  \

另外，如果集群开启了 Kerberos，别忘了配置 impala_principal 参数。

集成 kerberos

首先，需要在 kerberos server 节点上生成 hue 用户的凭证，并将其拷贝到 /etc/hue/conf 目录。：

$ kadmin: addprinc -randkey hue/cdh1@JAVACHEN.COM
$ kadmin: xst -k hue.keytab hue/cdh1@JAVACHEN.COM

$ cp hue.keytab /etc/hue/conf/

然后，修改 hue.ini 中 kerberos 节点：

[[kerberos]]
    # Path to Hue's Kerberos keytab file
    hue_keytab=/etc/hue/conf/hue.keytab

    # Kerberos principal name for Hue
    hue_principal=hue/cdh1@JAVACHEN.COM

    # Path to kinit
    kinit_path=/usr/bin/kinit

接下来，修改 /etc/hadoop/conf/core-site.xml，添加：

<!--hue kerberos-->
<property>
    <name>hadoop.proxyuser.hue.groups</name>
    <value>*</value>
</property>
<property>
    <name>hadoop.proxyuser.hue.hosts</name>
    <value>*</value>
</property>
<property>
    <name>hue.kerberos.principal.shortname</name>
    <value>hue</value>
</property>

最后，重启 hadoop 服务。

集成 LDAP

开启 ldap 验证，使用 ldap 用户登录 hue server，修改 auth 节点：

[desktop]
    [[auth]]
        backend=desktop.auth.backend.LdapBackend

另外修改 ldap 节点：

[desktop]
    [[ldap]]
        base_dn="dc=javachen,dc=com"
        ldap_url=ldap://cdh1

        # ldap用户登陆时自动在hue创建用户
        create_users_on_login = true

        # 开启direct bind mechanism
        search_bind_authentication=false

        # ldap登陆用户的模板，username运行时被替换
        ldap_username_pattern="uid=<username>,ou=people,dc=javachen,dc=com"

注意：在开启ldap验证前，先普通方法创建一个ldap存在的用户，赋超级用户权限，否则无法管理hue用户。

集成 Sentry

如果 hive 和 impala 中集成了 Sentry，则需要修改 hue.ini 中的 libsentry 节点：

[libsentry]
  # Hostname or IP of server.
  hostname=cdh1

  # Port the sentry service is running on.
  port=8038

  # Sentry configuration directory, where sentry-site.xml is located.
  sentry_conf_dir=/etc/sentry/conf

另外，修改 /etc/sentry/conf/sentry-store-site.xml 确保 hue 用户可以连接 sentry：

<property>
  <name>sentry.service.allow.connect</name>
  <value>impala,hive,solr,hue</value>
</property>

集成 Sqoop2

在 sqoop 节点配置 server_url 参数为 sqoop2 的地址即可。

集成 HBase

在 hbase 节点配置下面参数：

• truncate_limit：Hard limit of rows or columns per row fetched before truncating.
• hbase_clusters：HBase Thrift 服务列表，例如：Cluster1|cdh1:9090,Cluster2|cdh2:9090，默认为：Cluster|localhost:9090

集成 Zookeeper

在 zookeeper 节点配置下面两个参数：

• host_ports：zookeeper 节点列表，例如：localhost:2181,localhost:2182,localhost:2183
• rest_url：zookeeper 的 REST 接口，默认值为 http://localhost:9998

集成 Oozie

未使用，暂不记录。

管理 Hue

如果配置了 kerberos，则先获取 hue 凭证：

kinit -k -t /etc/hue/conf/hue.keytab hue/cdh1@JAVACHEN.COM

启动 hue server：

$ service hue start

停止 hue server：

$ service hue stop

hue server 默认使用 8888 作为 web 访问端口，故需要在防火墙上开放该端口。

你可以在 /var/log/hue 目录查看 hue 的日志，或者通过 http://cdh1:8888/logs 查看。

测试

在开启了 LDAP 后，使用 LDAP 中的管理员用户登录 hue，根据提示向导进行设置并将 LDAP 中的用户同步到 Hue Server，然后依次测试每一个功能是否运行正常。

关于 Hue 的使用向导，请参考 http://archive.cloudera.com/cdh5/cdh/5/hue/user-guide/index.html。

Enjoy it !