安装 Transwarp Data Hub

Hippo 的安装通过 Transwarp Manager 管理平台（以下简称 Manager）完成，可以在第一次安装 Transwarp Data Hub 集群时安装，也可以向安装好的集群另外安装 Hippo 服务。Transwarp Data Hub 集群的安装在《Transwarp DataHub 安装手册》中有详细的介绍，这里不再赘述。

安装 Hippo

上传产品包

登陆 Manager，点开左侧“应用市场”下拉框，选择“产品包”。在右侧对应页面的右侧点击“上传”，找到 Hippo 产品包所在的目录选择对应产品包，点击“确定”，然后等到上传完成。

图 2. 上传产品包

添加服务

在 Manager 的“集群”页面上，点击“+添加服务”。

图 3. 添加服务
在新弹出的“选择服务”页面，选择“其他/其他”，然后在显示的服务中选择 HIPPO，点击“+添加”。确认服务相关信息无误后，右下角点击“下一步”。

图 4. 选择 Hippo

配置安全

目前 Hippo 服务无需通过 Manager 配置安全，在“配置安全”这一步直接点击“下一步”即可。

图 5. 配置安全

分配角色

在“分配角色”页面，可以查看即将被安装的 Hippo 服务对应的信息，包括：服务名称，各个角色对应的节点分配情况等。服务名称可自定义，不过需注意不要和已安装的 Hippo 服务名称重复，否则会报错。另外如果角色分配节点与之前已安装的 Hippo 服务也有重复，需注意端口冲突问题。

图 6. 分配角色

配置服务

“配置服务”页面显示当前要安装的 Hippo 服务对应的各个配置信息。需注意如果之前已安装了其他 Hippo 服务，并且当前在安装的服务相比之前有角色使用重复的节点，需注意端口冲突问题。用户可在当前页面进行端口修改。有关 Hippo 服务默认端口信息，请参考下方 3.1. 默认端口信息章节。

图 7. 配置服务

服务总览

可在“服务总览”页面检查所有配置信息，如果需要修改，可以点击“上一步”。无需可直接点击“下一步”，点击“确定”进入“安装”页面。

图 8. 服务总览

图 9. 确定安装

安装服务

在“安装”界面等待服务安装完成，如遇到问题，可点击报错一行的“查看日志”选项确认更多报错信息。

图 10. 安装服务

Hippo 单机版安装部署

前提条件

安装docker-compose： https://docs.docker.com/compose/reference/
本地已下载tddms-standalone Image；本文档中，将假设Image路径为transwarp/tddms-standalone:develop

配置文件准备

从tddms-standalone镜像中，将/usr/local/standalone-template目录拷贝到本地，本例假设本地目录为/root/standalone-template：

docker cp $(docker create --name tc transwarp/tddms-standalone:develop):/usr/local/standalone-template . && docker rm tc

cd进standalone-template目录，将看到以下目录结构：

[root@tw-node46 example]# ll
total 8
drwxr-xr-x 3 root root 4096 Jul 12 19:39 conf
-rw-r--r-- 1 root root 591 Jul 12 19:39 docker-compose.yml
drwxr-xr-x 2 root root 6 Jul 12 19:39 log

其中，conf目录下是Hippo需要的配置文件；docker-compose.yml为Docker Compose Service配置文件；log目录是一个空目录，仅为挂载日志目录使用。

容器网络部署

容器网络部署是最简单、最常见的单机版部署模式，也是 standalone-template 里展示的模式。但容器模式部署有以下限制：

后续无法扩容成集群模式
无法使用Hippo跨集群相关功能，包括
- 跨集群copy by query
- 跨集群复制（CCR）

如果这些限制在您的应用场景中无法接受(或者您在部署 ArgoDB、TimeLyre、Scope)，请使用主机网络模式进行部署。

Docker compose 配置

容器网络的docker-compose.yml内容如下：

version: "3"
services:
  hippo:
    ports:
      - "7788:18902"
      - "7789:18822"
    volumes:
      - /mnt/disk1/hippo-standalone-master/data:/vdir/mnt/disk1/shiva-master-hippo/data/
      - /mnt/disk1/hippo-standalone-tserver/data:/vdir/mnt/disk1/shiva-tabletserver-hippo/data
      - /mnt/disk2/hippo-standalone-tserver/data:/vdir/mnt/disk2/shiva-tabletserver-hippo/data
      - /root/standalone-template/log:/var/log/hippo
      - /root/standalone-template/conf:/etc/hippo/conf
    environment:
      CONF_DIR: "/etc/hippo/conf"
      LOG_DIR: "/var/log/hippo"
      image: "transwarp/tddms-standalone:develop"

该配置文件定了一个名为hippo的service，关键部分如下：

ports
- 将Hippo HTTP Server与Webserver的容器内端口映射到容器外
- 18902为HTTP Server端口，需要与conf/elasticsearch.yml里定义匹配
- 18822为Webserver端口，需要与conf/shiva-restful.sh里定义匹配

volumes

第一行，定义Master数据目录挂载，将本地目录/mnt/disk1/hippo-standalone-tserver/data挂载到容器的/vdir/mnt/disk1/shiva-master-hippo/data。注意，在第一次部署时，需要手工创建本地目录

第二、三行，定义TServer数据目录挂载，本例中TServer使用disk1和disk2两块磁盘，分别挂载到容器的/vdir/mnt/disk1/shiva-tabletserver-hippo/data和/vdir/mnt/disk2/shivatabletserver-hippo/data目录。

在第一次部署时，需要手工创建本地目录。磁盘块数可以根据实际需求定义

第四行挂载容器内日志目录，如果希望更换本地日志目录，可按需调整；默认保留在standalone-template的log目录下
第五行挂载容器内配置目录，standalone-template/conf目录下是Hippo需要的配置文件

Master、TServer的数据目录，需要与conf下配置文件中内容匹配，详见下节。

environment
- CONF_DIR和LOG_DIR环境变量，需要与volumes里配置、目录的容器内挂载点对应。
image
- 定义Service使用的Image，如果镜像名不是“transwarp/tddms-standalone:develop”，请按实际情况调整

磁盘路径配置

在容器网络部署模式下，只需要为Master、TServer配置磁盘路径：

master.conf配置文件，“data_path=/vdir/mnt/disk1/shiva-master-hippo/data”，表示Master数据将存储在容器内的/vdir/mnt/disk1/shiva-master-hippo/data路径。注意，此处必须与Docker Compose配置文件的挂载路径对应(volumes节)；Master只使用一个磁盘路径
store.conf配置文件配置TServer使用的磁盘路径，默认模板里定义了两个Store，Store的data_dir配置表示容器内路径；注意，此处同样必须与Docker Compose配置文件的挂载路径对应 (volumes节)

启停服务

当完成关键配置后，在standalone-template目录下通过docker-compose up既可以启动服务，当输出“Hippo standalone start successfully” 后，服务启动完成。

通过docker-compose up -d以Detached模式后台启动
通过docker-compose ps查看服务状态
通过docker-compose stop hippo停止服务

主机网络模式（推荐）

使用主机网络部署，除了配置磁盘路径外，您还需要配置 Hippo 服务的 IP、端口以及 Master Group。

Docker compose 配置

其中docker-compose.yml为Docker Compose Service配置文件，内容如下：

version: "3"
services:
  hippo:
    network_mode: "host"
    volumes:
      - /mnt/disk1/hippo-standalone-master/data:/vdir/mnt/disk1/shiva-master-hippo/data/
      - /mnt/disk1/hippo-standalone-tserver/data:/vdir/mnt/disk1/shiva-tabletserver-hippo/data
      - /mnt/disk2/hippo-standalone-tserver/data:/vdir/mnt/disk2/shiva-tabletserver-hippo/data
      - /root/standalone-template/log:/var/log/hippo
      - /root/standalone-template/conf:/etc/hippo/conf
    environment:
      CONF_DIR: "/etc/hippo/conf"
      LOG_DIR: "/var/log/hippo"
      image: "transwarp/tddms-standalone:develop"

与之前区别在于：

network_mode，设置为host，使用主机模式

IP 配置

需要在以下两个配置文件中，配置Hippo使用的IP信息，本示例假设使用10.0.0.46。

master.conf配置文件，配置public_host=10.0.0.46
topology.conf配置文件，配置public_host=10.0.0.46

端口配置

需要为Master、TServer、HTTP Server以及Webserver配置端口。这里以具体的端口为例，端口均为可调节的。

Master端口，在master.conf配置文件中，配置"master_service_port=18650"，表示Master将使用从18650开始的连续四个端口
TServer端口，在tabletserver.conf中，配置"manage_service_port=18702"，表示TServer将使用从18702开始的连续四个端口
HTTP Server端口，在elasticsearch.yml配置文件中，配置"http.port: 18902"，表示HTTP Server将监听在18902端口
Webserver端口，在shiva-restful.sh配置文件中，"-Dhttp_port=18822"，表示webserver将监听在18822端口
需要注意的是，Master和TServer端口第一次部署时需要固定好，后续不可调整

Master Group 配置

在shiva-env.sh中，配置“export MASTER_GROUP=10.0.0.46:18650”，Master Group其实是Master的服务地址，因为是Standalone，其实该配置就是IP加Master端口。

MISC

更改容器内日志目录

Standalone模板中，容器内日志挂载目录为/var/log/hippo，如果希望修改这个配置，可以通过修改如下配置完成：

修改docker-compose.yml中，volumes与environment，日志目录对应项
修改master.flags配置文件中，--log_dir配置项
修改log4j2.xml.webserver配置文件中，log4j的fileName、filePattern配置
修改search.yml配置文件中，path.logs配置项
修改jvm.options配置文件中，HeapDumpPath与ErrorFile配置
修改log4j2.xml.tserver配置文件中，log4j的fileName、filePattern配置
修改log4j2.xml.httpserver配置文件中，log4j的fileName、filePattern配置

更改容器内配置文件目录

Sandalone模板中，容器内配置文件挂载目录为/etc/hippo/conf，如果希望修改这个配置，可以通过修改如下配置完成：

修改docker-compose.yml中，volumes与environment，配置目录对应项
修改tabletserver.conf中：
- topology_conf
- store_conf
- dynamic_config_path
- jvm_options_file
- log4j_file
- search_conf_file
- plugin_path

JVM 堆参数配置

Hippo Standalone模式会启动一个HTTP Server、一个Webserver进程，HTTP Server与Webserver是Java进程，在节点内存受限的情况下，可能需要调整JVM堆大小。

HTTP Server的堆大小在shiva-http-server.sh文件配置 (见JAVA_OPTS)，HTTP Server堆大小不宜过小，推荐最少分配8GB，默认31GB
Webserver的堆大小在shiva-restful.sh文件配置 (通用在JAVA_OPTS)

服务端 JVM 子进程配置

Scope会在TServer启动子进程，子进程中的JVM启动参数由jvm.options文件配置，其中堆大小默认31GB。

Windows 配置

我们支持在Windows的容器环境下部署我们的服务，但在Windows下，需要配置一个参数：

tabletserver.flags，配置参数" --workaround_for_docker_on_windows = true"