安装常见问题整理
其他
TDH社区版常见安装问题
在TDH社区版发布之后的这段期间，我们收到了很多反馈，并对近期遇到的关于安装TDH社区版时出现的常见问题进行了整理，例如Manager页面打不开、服务无法正常安装等。这些问题通常由操作不当或者环境不正确引发，本文将这些问题与解决办法分享出来，希望能解答各位用户的疑惑，避免在安装时出错。
1. 如何修改CentOS和Redat 操作系统中的hostname？
方法一，执行hostname xxx指令（暂时生效）。
方法二，修改/etc/sysconfig/network中的hostname（重启后生效）。
方法三，修改/etc/hosts文件，确保集群中的所有节点的hostname都正确。
例如（注意最后一行）：
127.0.0.1 localhost localhost.localdomain ::1 localhost localhost.localdomain 172.16.2.25 tw-node2025 |
Windows的hosts文件通常位于：C:\Windows\system32\drivers\etc\hosts
Linux的hosts文件通常位于：/etc/hosts
注意：尽量不要在安装完成之后更改hostname，因为许多参数和配置都与hostname挂钩。
2. Transwarp Data Hub对hostname是否有命名要求？
有要求，hostname必须由数字、字母或连接符组成，不支持使用_(下划线)和.(点)，比如TDH1.cluster.com就是不合法的命名。
3. 在执行pvcreate /dev/xxx创建逻辑卷组时出现Can't open /dev/vdb exclusively.Mounted filesystem，如何解决？
该情况表示分区被占用，需要查看是否挂载文件系统。如果已挂载需要umount掉。
4. 在执行pvcreate /dev/xxx创建逻辑卷组时出现“Can't initialize physical volume "/dev/vdb" of volume group "docker" without -ff” 如何解决？
该情况表示物理卷已经创建，不需要再重复创建。可以直接执行后面步骤。
5. 安装时在hostname检查环节失败退出，如何解决？
登入管理节点执行hostname指令，并同hosts文件中IP 后面的名字比较，检查是否匹配。如不匹配，请修改hostname，确保集群中所有节点的hostname都正确且匹配。
6. 安装时在检查操作系统版本环节失败，如何解决？
检查安装节点使用的操作系统版本，是否受社区版支持。
如果在支持范围内，查看TDH安装包的版本是否与当前OS版本匹配。比如，操作系统是CentOS6.5，安装包是centos-7-transwarp-5.0.0，则不匹配。需要重新下载对应的安装包。
7. 安装后访问http://hostname:8180出错，可能由哪些原因所致？
可能是安装出现问题：请仔细按照安装文档进行安装。
确保访问方式是http。
确保http的8180端口没有被防火墙阻止。
如果上述几项都没有问题请继续检查：
登录Manager服务器，执行
/etc/init.d/transwarp-manager status |
检查进程是否running。如果不是，请查看Manager日志：/var/log/transwarp-manager/master/transwarp-manager.log，再进一步分析原因，使之启动。
如果Manager处于running状态，请执行下述命令，
netstat -anp | grep 8180 |
查看8180端口是否被Manager占用，如果不是请停止此进程（非Manager的进程），然后执行下述语句重启Manager。
/etc/init.d/transwarp-manager restart |
8. 提交许可证后为什么提示用户名与密码错误？
请保证您输入的是注册Snowflake时使用的用户名与密码，请勿填写您申请时使用的邮箱。
请保证用户名与密码拼写正确。
9. 节点断开可能有哪些原因？
可能是硬件原因（网线，网口，交换机等问题）。
可能是机器防火墙屏蔽了ssh。
10. 如何检查防火墙是否开启？
方法一：在命令行状态下执行setup命令，按菜单指引防火墙配置→不选防火墙开启，然后保存设置。
方法二：在命令行下面执行service iptables stop关闭防火墙服务。
11. Transwarp Manager对网络延迟是否有要求？
有一定要求，如果客户端浏览器到Transwarp Manager的延迟过长会导致服务添加失败，建议在客户端ping一下Transwarp Manager服务器，如果延迟超过2ms，可能会发生安装失败的问题。
12. 在安装服务的时候，报错：No configure setting for key 'repo'，应如何处理？
首先查看检查Manager节点的/etc/transwarp-manager/master/repo.conf是否存在，或者是否损坏。
如不存在或者已损坏，请根据以下内容创建文件：
/etc/transwarp-manager/master/repo.conf： repo{ remove-exist=yes os{ type=remote url="<os_repo_url>" } transwarp{ type=local path=<transwarp_repo_path> } } |
<os_repo_url>请填写/etc/yum.repo.d/os.repo中的bashurl取值。
<transwarp_repo_path>请填写/etc/yum.repo.d/transwarp.repo中的bashurl取值。
13. 如何在社区版中用命令行下载TDH Client包？
命令行登陆Manager获取cookie：
# 登录Manager并将cookies保存在本地文件 curl -v -X POST http://<manager_ip>:8180/api/users/login --data '{"userName":"<manager_admin>","userPassword":"<manager_psw>"}' -b cookies.txt -c cookies.txt |
然后下载客户端：
# 加载cookies并下载TDH Client wget --load-cookies cookies.txt http://<manager_ip>:8180/api/manager/tdh-client |
<manager_ip> 为 Manager IP地址。
<manager_admin> 为 Manager管理员账户。
<manager_psw> 为 Manager管理员密码。
14. Manager的浏览器页面为什么会崩溃？
有些用户会遇到这样的问题，浏览器的Manager页面一段时间后崩溃：
“喔唷，崩溃啦！”
这一般是由于浏览器的稳定性问题所致，Manager的前端使用较多的JavaScript处理业务逻辑，如果浏览器的JS引擎有稳定性问题，有可能发生崩溃，我们建议：
使用Chrome 41或Safari 9以上版本的浏览器，之前版本的浏览器的JS引擎确实有一些稳定性问题；
检查浏览器中的插件，有些插件也会引起浏览器的不稳定，观察在关闭所有插件后，是否还有页面崩溃现象。
15. 提示许可证服务未正常工作，应如何解决？
在Manager页面上点击管理→许可证 页面查看许可证服务状态是否正常。如果License Server大于两个节点宕机，许可证服务将显示为“DOWN”的状态。此时请点击“启动”按钮将许可证服务启动。
16. 如何检查许可证过期时间？
点击管理→许可证，查看当前License的截止日期。
关于安装手册
为了方便用户顺利安装TDH社区版，构建集群安装节点与服务，我们提供了社区版的安装文档，并上传于星环科技官网的社区版介绍页面，可以通过阅读全文下载与浏览。
今后我们会继续整理各种关于社区版的使用问题，并陆续分享。
往期原创文章
Guardian 5.0全新架构解析:大数据安全防御之盾(二)
Guardian 5.0全新架构解析:大数据安全防御之盾(一)
大数据开放实验室由星环信息科技（上海）有限公司运营，专门致力于大数据技术的研究和传播。若转载请在文章开头明显注明“文章来源于微信订阅号——大数据开放实验室”，并保留作者和账号介绍。