安装和配置Hue
本文主要记录使用 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。
- 对于 WebHDFS 方式,在每个节点上的 hdfs-site.xml 文件添加如下配置并重启服务:
<property>
<name>dfs.webhdfs.enabled</name>
<value>true</value>
</property>
- 配置 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>
- 修改 /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/[email protected]
# 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/[email protected]
$ kadmin: xst -k hue.keytab hue/[email protected]
$ 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/[email protected]
# 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/[email protected]
启动 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 !