Transwarp StellarDB 安装教程

1. 在Transwarp TDH平台安装StellarDB

1.1. 环境要求

通过Transwarp TDH平台安装StellarDB，对硬件和操作系统的环境要求与TDH环境要求相同，详细参数参考TDH官方文档 《TDH安装手册》中环境要求相关内容。 安装StellarDB前请确认TDH已经部署并安装StellarDB依赖的基础服务，包括HDFS，YARN，Zookeeper，TxSQL或KUNDB。

1.2. 平台和组件兼容性要求

StellarDB 4.1版本支持在TDH 6.2.2版本及以上版本安装部署，如果集群中已安装了TDH 6.0或6.2版本，且希望在不升级原有服务的基础上部署StellarDB 4.1版本或升级StellarDB 4.0版本至最新版本，则需要借助混部脚本，可咨询星环科技相关技术人员。

1.3. 安装StellarDB服务

推荐在TDH Manager 8.0及以上版本安装StellarDB 4.1版本，若TDH Manager版本低于8.0请先进行升级或咨询StellarDB技术人员。

1.3.1. 安装服务所需组件

1. 必要组件：
   1. Quark(必须)：计算引擎。图查询语言（TEoC）入口（安装包使用StellarDB自带版本，非TDH自带版本）。
   2. StellarDB Storage(必须)：存储引擎。用于图数据存储。
2. 非必要组件（推荐安装）：
   1. DBAService（推荐）：计算引擎监控。提供每个查询的执行监控和统计等功能。
   2. KG Explorer（推荐）：2D/3D图展示。提供存储引擎监控，bulkload工具等功能。
3. 非必要组件（按需安装）：
   1. QuarkGateway：连接客户端与Quark Server的一个中间件，是客户请求Quark服务的总入口。

1.3.2. 使用TDH Manager 8或TDH Manager 9安装服务

由于TDH Manager 8和TDH Manager 9安装页面无差别。下面安装示例基于TDH Manager 9.1和TDH 9.0安装StellarDB 4.1版本。如需安装其他版本，请咨询StellarDB技术人员。

1. 上传产品包：

• 如下图所示，在Manager中点击左侧 产品包 按钮进入产品包管理页面，通过 上传 按钮将所有产品安装包的tar文件包上传至Manager所在节点。产品包包括StellarDB、DBAService和KG Explorer的安装包。
• 

1. metainfo修改与License申请：

• 在使用TDH Manager 8.0进行安装时，还需要修改metainfo并且重启TDH Manager使修改生效。如果使用更高版本TDH Manager，可以跳过此步骤。
  1. 删除 UpgradePreStop，不进行TxSQL到KUNDB迁移
  • sed -i '290,302d' /var/lib/transwarp-manager/master/content/meta/services/QUARK/quark-8.30.0-final/metainfo.yaml
  1. 重启TDH Manager
  • /etc/init.d/transwarp-manager restart
  1. 在Guardian上创建StellarDB用户，并给该用户在HDFS的备份目录赋上可写和可读的权限，与Hive用户保持一致即可
  2. 申请新的License

1. 安装StellarDB组件：

• 在TDH Manager中通过 集群 按钮进入服务管理页面，并点击 添加服务 按钮跳转至下一步进行服务选择和服务配置。
• 
• 在可选择服务列表中选择Transwarp StellarDB，并选择对应的版本。
• 
• 选择需要安装的StellarDB组件。必要组件和可选组件的详细信息可参阅前文《安装StellarDB服务所需要的组件》。
• 
• 添加StellarDB组件后，在界面右侧对所选择服务进行相关配置，然后点击 下一步 跳转至下一步安装操作。
• 

1. 安全配置：根据产品使用需求进行相应的安全配置。

1. 角色分配：根据集群配置情况和所选服务，参照以下图示步骤，对所选服务分配其在集群中的角色。
   1. 可选择任一节点安装DBAService Server。
   • 
   1. 分配StellardbStorage的Master和Worker的角色。
   • StellardbStorage选择多个节点的Master做高可用，多节点推荐Master数量 大于等于 3且为奇数个，选择相应组件时注意右侧选择对应安装依赖。推荐集群所有节点全部安装Worker，若非所有节点全部安装Worker，则在后面安装Quark时，Executor的节点推荐与安装StellarDB的Worker的节点一一对应且为奇数个。
   • 
   • 
   1. 为Quark分配相应角色。Quark包含Metastore、Quark server和Executor。Metastore节点数量固定为2个，与集群节点总数量无关。
   • 
   • Quark Server可安装在任一节点。
   • 
   • 推荐在集群中所有节点安装Executor。若需要仅在部分节点中安装Executor，推荐安装Executor的节点与前面安装StellarDB的Worker的节点一一对应，并且为奇数个节点。
   • 
   1. 为KG Explorer分配角色。KG Explorer Server可安装在任一节点，一般情况不需要安装KG Explorer Prometheus和KG Explorer Grafana。选择完成后点击 下一步 跳转至下一步安装操作。
   • 
2. 配置服务：首次安装时，默认参数无需修改。若部署多套StellarDB服务，务必修改 所有组件基础参数中结尾带 .port 的参数，防止端口号冲突。

1. 总览及安装：服务总览 和 安装 步骤无需操作，点击 下一步 → 安装 按钮即可，此处不做赘述。

1. 安装校验（可选）:

• StellarDB及其组件安装完成后，可进行安装校验。过程详见《StellarDB安装校验》。

2. StellarDB安装校验

StellarDB及其组件安装完成后，可以参阅下述步骤进行校验验证产品能否正常使用。

1. 登入KG Explorer Home页面：
   1. 从TDH平台入口登入，在 集群 服务中点击KG Explorer服务。
   • 
   • 查看并点击 服务链接 所示服务地址跳转至KG Explorer页面。
   • 
   1. 或者从TDC平台入口登入
   • 
2. 使用KG Explorer进行服务测试：

• 进入KG Explorer页面后，如下图示点击 3D 按钮跳转至Stellar3D页面。选择运行KG Explorer内置测试语句。若语句执行成功，则说明StellarDB安装成功。步骤如下图：
• 
• 
•