一、环境准备
1、找到服务器路径下的hosts文件：1 概述
本文介绍了如何连接带kerberos认证的星环数据库。
2 数据连接
2.1 环境准备
（1）找到服务器路径下的hosts文件：
- Windows环境路径：C:\Windows\System32\drivers\etc
- Linux环境路径：/etc/hosts
2、打开hosts文件，添加映射，映射格式为：IP+机器名。例如：
10.10.204.59 tdh01
10.10.204.60 tdh02
10.10.204.61 tdh03
二、上传Kerberos认证文件
1、点击下载Kerberos认证需要的文件：
2、上传文件到Smartbi的服务器上（Smartbi对此路径要有读权限）。
三、Smartbi连接星环数据库
1、启动星环数据库。
2、获取驱动文件：
（1）进入星环数据管理界面，点击进入Inceptor服务界面。
（2）进入Inceptor服务界面后，点击右上角 （2）打开hosts文件，添加所有星环集群节点服务器、kerberos认证服务器的IP跟主机名映射关系。
2.2 上传Kerberos认证文件
联系星环数据库管理员获取Krb5文件、KeyTab文件，并上传到Smartbi的服务器上。
| 注意 |
|---|
1）注意：需要确保smartbi服务器时间和星环数据库集群的时间同步。 |
2.3 配置自定义驱动包
操作步骤 | 说明 |
|---|---|
| 1、登录星环web端 | 启动并登录星环数据库，输入用户名、密码，登陆界面如图：
|
| 2、下载jdbc驱动客户端 | 1）进入星环数据管理界面，点击进入Inceptor服务界面。
2）点击右上角 更多操作 > 下载JDBC驱动 。
|
（3）下载的驱动如下：
| 3、加载驱动 | （1）访问Smartbi的配置界面，URL为“http://server: port/Smartbi/vision/config.jsp”，在“业务库驱动”中配置驱动的路径。
以上路径为默认的相对路径，其绝对路径为 “Smartbi启动目录/dynamicLibraryPath”；如果使用exe安装，对应目录即为 “Smartbi安装目录/ |
tomcat/bin/dynamicLibraryPath”；也可自行制定路径。 关于该设置项说明请参考：Smartbi Config页面介绍 。 |
（2）在dynamicLibraryPath目录下新建一个文件夹，然后将驱动文件放到新建文件夹下：
|
10秒左右Smartbi系统会自动检测到该jar文件，并加载。
4、连接星环数据库：
无需重启服务器，直接在浏览器中访问Smartbi，新建关系数据源，连接信息如下：
10秒左右Smartbi系统会自动检测到该jar文件并加载，无需重启服务器。 |
2.4 连接步骤
（1）在数据连接的关系数据库中，选择新建星环数据源。
（2）配置连接信息如图：
主要配置信息说明：
配置项 | 说明 |
|---|---|
| 名称 | 数据源连接名称，不可为空 |
| 驱动程序存放目录 | 选择“自定义”并在下拉框中选择”XINGHUAN" |
| 连接字符串 | jdbc:hive2://10.10.204.60:10000/default;principal=hive/tdh02@TDH;kuser=hive@TDH;keytab=/ |
opt/ |
kerberos/xinghuan/hive.keytab; |
krb5conf=/ |
opt/kerberos/xinghuan/krb5.conf;auth=kerberos | |
| 连接方式 | Kerberos认证 |
| 客户端PR | keytab文件对应的principal，由星环数据库集群管理员提供，如果连接字符串配置了principal参数，此处可以不填写 |
| Krb5文件路径 | krb5.conf的存放路径，krb5.conf文件由星环数据库集群管理员提供，如果连接字符串配置了krb5conf文件路径，此处可以不填写 |
| KeyTab文件路径 | keytab的存放路径，keytab文件由星环数据库集群管理员提供，如果连接字符串配置了keytab文件路径，此处可以不填写 |
| Kuser | 系统用户，由星环数据库集群管理员提供，如果连接字符串配置了kuser参数，此处可以不填写 |
| 注意 |
|---|
1）keytab与krb5conf文件路径更换成Smartbi所在机器的路径，Linux与Windows分隔只能使用 1）keytab与krb5conf文件路径更换成Smartbi所在机器的路径，Linux与Windows分隔符都只能使用 "/"； 2）若不添加磁盘路径，可将认证文件与Smartbi放在同一个磁盘下，路径可修改为：keytab=/root/tdh_Kerberos/TDH-Client/hive.keytab 。 |
2）keytab文件、krb5.conf文件、principal信息必须互相匹配。 |
（3）点击 测试连接 按钮，提示连接成功后保存，连接星环数据库完成。
