安装TDC Installer

解压TDC Installer安装包

登录到安装包所在节点，运行以下命令解压 Installer 安装包，并进到安装包所在的目录。

可以通过owncloud下载TDC installer的安装包

# 上传压缩包到master节点首节点
scp xxx.tar.gz root@master-ip:~ (xxx.tar.gz为安装包的名称，master-ip为master节点的ip地址)


# 解压出安装包目录
tar -zxvf tdc-installer-1.0.0-final.tar.gz

解压之后可以看到如下目录：

运行TDC installer

如果您是首次启动TDC installer，执行以下步骤：
1. 执行start脚本启动安装器 bash -x start.sh。Installer启动成功后，输出访问地址、用户名和密码：
2. 完成后，打开浏览器，访问 http://<节点IP>:9999/ui 打开图形化界面，使用用户名密码登录，同意许可协议后，可以看到如下界面。

安装包自带的有试用版的许可证，在生效时间内可直接使用，也可以更换上传新的许可证。

在许可证详情处点击查看详情，可以查看许可证详情：

选择同意许可协议，并点击“选择向导类型”，进入向导选择页面。

如果您不是首次启动TDC Installer，执行以下步骤：
1. 检查9999端口是否被旧的web installer占用：lsof -i :9999
  
  如果被占用,判断该进程是否可以被kill，可以被kill：kill -9 [PID]
  
  若不可给kill，联系研发给对应的方案。
2. 如果环境之前安装过tdc-installer ，环境中会有redis数据文件和缓存，若想清理tdc-installer残留数据重新安装需要在该节点上执行如下脚本：
  #!/bin/sh pids=$(ps-ef |greprudder |grep-vgrep|awk'{print $2}') if[[ ! -z"$pids"]] then foriin$pids do echo"Kill the process [$i]" kill-9 $i done else echono rudder running fi pids=$(ps-ef |grepredis |grep-vgrep|awk'{print $2}') if[[ ! -z"$pids"]] then foriin$pids do echo"Kill the process [$i]" kill-9 $i done else echono rudder running fi rm-rf/opt/tdc-installer/hack

选择安装方案

在该页面选择需要安装的产品方案，TDC Installer中定义了产品安装方案，即某个版本的产品即为一个产品方案，例：TDC3.1.0 。

首先需要选择部署架构，支持的部署架构有X86部署、ARM部署、混合部署，可以根据实际情况选择。

然后选择安装方案：

若当前集群尚未安装任何版本的TCOS、TDC，需要先安装TCOS、再安装TDC
若当前集群已经安装了某个版本的TCOS，需要安装对应版本的TDC，可直接选择安装TDC
若当前集群已经安装了某个版本的TCOS、TDC，需要扩容，可直接点击扩容进入扩容步骤

选择安装方案后，系统会检测所需安装包的状态：

若显示为绿色图标，则表明安装包可用
若显示为黄色图标，则表明未检测到可用安装包（可选上传），需要上传安装包到指定目录
若显示为红色图标，表示未检测到可用安装包（必须上传），需要上传安装包到指定目录

安装TCOS

选择安装TCOS的版本，安装包上传完成后，点击【开始向导】，进入安装流程。

系统预处理

首先，系统会自动对基础环境进行预处理。预处理完成后，您可以在页面右边查看日志。若处理有告警或错误，可以点击“重试”按钮重新处理。

若检测有错误，可点击日志查看日志，找到问题所在，此时无法点击“下一步”：

可点击下载日志将日志下载到本地，方便排查问题。

预处理都通过时，可点击“下一步”。

添加节点

这一步，可以为您的集群添加节点，至少需要添加 3 个节点。

点击【添加节点】，在弹出窗口中，您可以输入节点IP进行搜索，其中，密码不同和不连续的节点需要分批添加，如下图所示。选中要添加的节点，并点击“继续”：

若输入的IP地址存在没有有效节点、节点已经存在、网络不可达等问题，则系统会报错，无法成功搜索节点：

然后，您需要提供SSH方式访问节点使用的用户名和密码，支持非root用户，但需要具有sudo权限。

点击“完成”，成功添加节点后可以看到以下界面：

系统自动对节点进行检测。请确保节点的环境和设置满足“环境要求”和“安装前准备”小节里所列的内容。可以点击【检测详情】查看检测详细内容。

可以点击【节点详情】查看节点的架构、CPU、内存、操作系统、内核版本信息：

检测通过后，选择要添加进集群的节点，点击“下一步”。

分配节点

节点添加完成后，按角色对节点进行分配。

#	角色	定义	说明
1	TCOS Master节点	指定 TCOS 的控制节点，用于TCOS 组件的部署。	至少选择3个节点（包含当前节点），并且必须是奇数
2	TCOS Worker节点	指定TCOS的工作节点，用于部署业务组件，不会部署控制面的组件。	为实际负载运行的节点
3	镜像仓库节点	指定镜像仓库所在节点，用于存放部署时所需系统镜像，一般默认部署在安装器所在节点。	默认第一台mater节点，不可修改
4	Harbor节点	指定 harbor 组件所在节点，主要用于存放系统组件和应用市场 chart 。	至少选择两个，不选自动将harbor部署在master节点
5	Monitor节点	指定监控组件节点，主要基于开源的 Prometheus 提供集群级指标监控。	至少选择两个，不选自动将monitor部署在master节点
6	GPU节点	指定 krux 组件所在的节点，此节点上必须有 GPU 插件，对接除 Sophon 之外的应用。	-
7	GPU-share节点	指定 GPU 共享组件所在的节点，此节点上必须有 GPU 插件，主要用于对接 Sophon 应用。	主要用于对接sophon，不选的话表示不部署gpu-share
8	GPU-exclusive节点	指定 GPU 独占组件所在的节点，此节点上必须有 GPU 插件，主要用于对接 Sophon 应用。	主要用于对接sophon，不选的话表示不部署gpu-exclusive
9	SGX节点	安装 Intel CPU 指令的节点	部署 SGX 应用的节点，不选表示不部署 SGX

角色

定义

说明

TCOS Master节点

指定 TCOS 的控制节点，用于TCOS 组件的部署。

至少选择3个节点（包含当前节点），并且必须是奇数

TCOS Worker节点

指定TCOS的工作节点，用于部署业务组件，不会部署控制面的组件。

为实际负载运行的节点

镜像仓库节点

指定镜像仓库所在节点，用于存放部署时所需系统镜像，一般默认部署在安装器所在节点。

默认第一台mater节点，不可修改

Harbor节点

指定 harbor 组件所在节点，主要用于存放系统组件和应用市场 chart 。

至少选择两个，不选自动将harbor部署在master节点

Monitor节点

指定监控组件节点，主要基于开源的 Prometheus 提供集群级指标监控。

至少选择两个，不选自动将monitor部署在master节点

GPU节点

指定 krux 组件所在的节点，此节点上必须有 GPU 插件，对接除 Sophon 之外的应用。

GPU-share节点

指定 GPU 共享组件所在的节点，此节点上必须有 GPU 插件，主要用于对接 Sophon 应用。

主要用于对接sophon，不选的话表示不部署gpu-share

GPU-exclusive节点

指定 GPU 独占组件所在的节点，此节点上必须有 GPU 插件，主要用于对接 Sophon 应用。

主要用于对接sophon，不选的话表示不部署gpu-exclusive

SGX节点

安装 Intel CPU 指令的节点

部署 SGX 应用的节点，不选表示不部署 SGX

配置存储池

在这一步，需要对每个节点进行存储池配置：

目前提供四种默认类型的存储池配置：

#	存储池类型	最佳实践	说明
1	silver	建议存储介质为RAID5 + HDD 一般在需要部署txsql，mysql的节点上创建	1.既是master节点又是worker节点必须配置一块silver存储池，否则会导致部署失败 2.若在分配节点那步，gpu角色所选的节点和master角色所选节点不相同，需要为gpu的节点全部配置一块silver存储池，否则会导致部署失败
2	gold	建议存储介质为SSD 一般在需要部署高性能存储需求的业务（如argodb）的节点上创建	-
3	linear	建议底层磁盘不做RAID，或者单盘做RAID0 一般在部署自身具有高可用、对存储性能要求不高的业务（如hdfs datanode）的节点创建	-
4	raid1	建议存储介质为RAID1 + HDD 一般在部署敏感且不易恢复的业务（如hdfs namenode）的节点创建	-

注意：上面描述的“最佳实践”均为“建议”：

现场存储资源充足的情况下，建议严格遵守最佳实践定义的存储池类型和存储介质的对应关系；
如果现场环境无法满足最佳实践标准，可灵活调整，代价是带来额外的运维成本；

选择服务

这一步，您可以选择需要部署的服务，如下图，标注了“必选”的服务默认全部勾选，且不可取消。

参数配置

您可以在此步对参数进行配置，其中内容框里填了默认值得，一般不建议更改：

需要配置的参数项：

#	配置项	定义	格式/注意事项
1	nodeReservedMemory	每个节点kubelet组件预留的内存资源	string
2	ClusterCIDR	tos集群service ip网段	如果需要跨集群通信，请确保该集群的Pod网段和其他集群不一样
3	PodCIDR	tos集群pod ip网段	-
4	ApiserverPort	API Server安全端口	不允许修改
5	clusterDomainName	集群域名	-
6	nodeMaxPods	节点最大POD数	默认110
7	virtual_ip_enabled	是否开启虚拟IP功能	若此处开启了虚拟IP
8	virtual_ip	VIP地址，用于外部 ingress 访问要求：可用IP地址	若virtual_ip_enabled开启了，则该配置必填
9	defaultPodSecondaryCIDR	Pod第二块网卡默认网段，该参数不能和 Pod 网段、service网段、节点MacVlan网段冲突，同时需要确保同一个二层内的多个集群使用不同的网段，否则发生地址冲突后会导致 Pod 网络不正常	-
10	defaultMacvlanNodeCIDR	节点MacVlan 默认网段，实现Pod第二块网卡service所需的参数，该参数不能和Pod网段、Pod第二块网卡默认网段、service网段、物理网段冲突，需要确保同一个二层内的多个集群使用不同的网段，否则发生地址冲突后会导致Pod第二块网卡service网络不正常	高级参数
11	pubilcCloud	是否有公有云环境	若有公有云环境，选择 true；若没有，选择 false

配置项

定义

格式/注意事项

nodeReservedMemory

每个节点kubelet组件预留的内存资源

string

ClusterCIDR

tos集群service ip网段

如果需要跨集群通信，请确保该集群的Pod网段和其他集群不一样

PodCIDR

tos集群pod ip网段

ApiserverPort

API Server安全端口

不允许修改

clusterDomainName

集群域名

nodeMaxPods

节点最大POD数

默认110

virtual_ip_enabled

是否开启虚拟IP功能

若此处开启了虚拟IP

virtual_ip

VIP地址，用于外部 ingress 访问要求：可用IP地址

若virtual_ip_enabled开启了，则该配置必填

defaultPodSecondaryCIDR

Pod第二块网卡默认网段，该参数不能和 Pod 网段、service网段、节点MacVlan网段冲突，同时需要确保同一个二层内的多个集群使用不同的网段，否则发生地址冲突后会导致 Pod 网络不正常

defaultMacvlanNodeCIDR

节点MacVlan 默认网段，实现Pod第二块网卡service所需的参数，该参数不能和Pod网段、Pod第二块网卡默认网段、service网段、物理网段冲突，需要确保同一个二层内的多个集群使用不同的网段，否则发生地址冲突后会导致Pod第二块网卡service网络不正常

高级参数

pubilcCloud

是否有公有云环境

若有公有云环境，选择 true；若没有，选择 false

高级参数：

#	配置项	定义	格式
1	ratioCpu	CPU超配，数字代表超配系数，正常为1，非测试环境不建议超配	1
2	ratioMemory	Memory超配，数字代表超配系数，正常为1，非测试环境不建议超配	1
3	ratioStorage	存储超配，数字代表超配系数，正常为1，非测试环境不建议超配	1

参数配置完成后，点击【下一步】会提示进入安装后，不可再返回之前步骤修改参数，因此需要再次确认之前每一步的配置是否正确。 image::tco-14.png[scaledwidth=95%]

安装

参数配置完成后，开始安装：

安装项目如上，若失败可点击重试，也可点击日志查看安装日志。

在安装开始后，不可点击浏览器的后退键。若通过其他方式进入安装前的步骤，可能会导致重复安装，重复安装时若修改系统服务的配置，可能会导致整个集群不可用。

可用性检查

安装完成后，会对系统进行可用性检查，这里主要是对TCOS的可用性进行检查。

安装TDC

若选择安装方案时选择了TCOS+TDC，直接点击下一步即可进入安装TDC步骤；若选择安装方案时仅选择了安装TCOS，此时需要返回安装向导页，选择TDC安装方案来进入安装TDC步骤。选择将要安装的TDC的产品版本，进入安装流程。

系统预处理

首先，系统自动进入预处理过程：

如果检测都通过点击“下一步”进行服务选择，如果有处理异常未通过的项目可以点击“重试”重新检查，也可以点击“日志”查看错误原因。

选择服务

这一步，选择需要安装的服务：

标注了“必选”的服务如没有安装则必须勾选，如已安装则可以不再勾选。重新选择已安装的服务则会重新安装或更新该服务。未安装的服务后续可以在后台进行补充安装。

TDC包含以下服务：

TDC系统组件：TDC系统组件的安装，必选
TDC-APPMarket组件：TDC-APPMarket组件安装，包括redis、kafka的安装，必选

若不安装此模块，{tcc} 页面上没有【应用市场】入口：
TDC-DevOps 组件：TDC-DevOps 组件安装，可选

若不安装此模块，{tcc} 页面上没有【应用开发】入口：
TDC-SpringCloud 组件：TDC-SpringCloud 组件安装，可选

若不安装此模块，{tcc} 页面上没有【SpringCloud引擎】和【SpringCloud管理】入口
TDC-Aquila开源组件：TDC-Aquila开源组件的安装，可选，根据是否需要使用 Aquila 服务选择。如果在这一步没有选择，您也可以后续在需要的时候再安装。手动部署方式见：tdc-operator 部署 aquila 2.0.1

若不安装此模块，{tcc} 页面上没有【Aquila】入口：
TDC-Datamall 组件：数据市场组件的安装，可选，根据是否需要使用数据市场选择

若不安装此模块，{tcc} 页面上没有【数据市场】入口：
TDC-Audit 组件：可选

若不安装此模块，{tcc} 页面上没有【Audit】入口

参数配置

这一步，您需要进行参数配置，带星号的为必填项，置灰框里的内容无法修改：

分为三种类型的参数：

TDC系统组件

#	配置项	含义	取值	是否必填
1	defaultLanguage	默认语言	zh_CN	是
2	galaxy-actor.enableVip	galaxy 是否开启 VIP 代理访问	是/否
3	galaxy-actor.vip	为 galaxy 组件配置 VIP	可用IP地址	VIP enable后必填
4	guardian-federation.adminPwd	为Guardian Federation admin用户指定初始密码。		默认
5	guardian.adminPwd	为Guardian admin用户指定初始密码。	至少8位以上，不能含有admin字样与"!"符号。注意：这里指定的初始密码，只有在Guardian首次安装有效，不能修改密码；在进行升级时不可以修改该配置。	默认
6	hamurapi.userSystemMode	用户管理模式选择，分为：独立租户用户管理模式（LEGACY）：TDC 原有用户管理模式统一用户管理模式（UNIFIED）：新增用户管理模式，ECO、{tcc} 用户统一管理	-	是
7	kundb.rootPwd			默认
8	ockle.gatewayURL	外部网关。在一些场景中，可能需要使用其他地址（而不是当前集群的某个节点的地址）来作为TDC网关的地址，比如网关节点已经被映射到某个外网地址（或者域名），需要将该参数配置为映射的地址。	默认为空，安装时系统自动配置。如有映射到外部地址，请配置为正确的网关地址。	否
9	simmail.authEnabled	邮箱服务器是否开启验证。	* 若为独立用户管理模式（LEGACY），邮箱默认关闭 * 若为统一用户管理模式（UNIFIED），邮箱默认开启	是
10	simmail.account	服务邮箱帐号，用于使用TDC的邮件通知服务。必须是邮箱服务器上的有效帐号。	您公司指定的服务账号	是
11	simmail.host	服务邮箱服务器地址，用于使用TDC的邮件通知服务。邮件服务器必需是从部署的集群可访问的。	您公司指定的服务器地址	是
12	simmail.mailForm	服务邮箱帐号的显示名称。如果配置，则发件人显示为该名称，否则直接显示邮箱地址。	需要显示的邮箱帐号名称	是
13	simmail.pwd	服务邮箱帐号的登录密码，用于使用TDC的邮件通知服务。	您公司指定服务邮箱帐号的登录密码	是
14	simmail.smsBackend		默认值为MOSUMP	否
15	simmail.smsDownstreamHost			否
16	simmail.smsDownstreamPort			否
17	simmail.smsEnabled			否
18	simmail.smsPassword			否
19	simmail.smsUpstreamHost			否
20	simmail.smsUpstreamPort			否
21	simmail.smsUpstreamPort			否
22	simmail.tlsEnabled	邮件服务是否开启TLS通信。	根据邮箱服务器是否要求使用TLS协议来填写，如要求使用则为 true，否则为 false。	否
23	simmail.tlsRequired	服务器是否使用TLS来通信。	根据邮箱服务器是否支持TLS协议来填写，如支持则为 true，否则为 false。	否

配置项

含义

取值

是否必填

截图/说明

defaultLanguage

默认语言

zh_CN

是

tdc 11

galaxy-actor.enableVip

galaxy 是否开启 VIP 代理访问

是/否

tdc 13

galaxy-actor.vip

为 galaxy 组件配置 VIP

可用IP地址

VIP enable后必填

guardian-federation.adminPwd

为Guardian Federation admin用户指定初始密码。

默认

tdc 12

guardian.adminPwd

为Guardian admin用户指定初始密码。

至少8位以上，不能含有admin字样与"!"符号。注意：这里指定的初始密码，只有在Guardian首次安装有效，不能修改密码；在进行升级时不可以修改该配置。

默认

tdc 12

hamurapi.userSystemMode

用户管理模式选择，分为：

独立租户用户管理模式（LEGACY）：TDC 原有用户管理模式统一用户管理模式（UNIFIED）：新增用户管理模式，ECO、{tcc} 用户统一管理

是

tdc legacy

kundb.rootPwd

默认

tdc 12

ockle.gatewayURL

外部网关。在一些场景中，可能需要使用其他地址（而不是当前集群的某个节点的地址）来作为TDC网关的地址，比如网关节点已经被映射到某个外网地址（或者域名），需要将该参数配置为映射的地址。

默认为空，安装时系统自动配置。如有映射到外部地址，请配置为正确的网关地址。

否

simmail.authEnabled

邮箱服务器是否开启验证。

* 若为独立用户管理模式（LEGACY），邮箱默认关闭

* 若为统一用户管理模式（UNIFIED），邮箱默认开启

是

simmail.account

服务邮箱帐号，用于使用TDC的邮件通知服务。必须是邮箱服务器上的有效帐号。

您公司指定的服务账号

是

simmail.host

服务邮箱服务器地址，用于使用TDC的邮件通知服务。邮件服务器必需是从部署的集群可访问的。

您公司指定的服务器地址

是

simmail.mailForm

服务邮箱帐号的显示名称。如果配置，则发件人显示为该名称，否则直接显示邮箱地址。

需要显示的邮箱帐号名称

是

simmail.pwd

服务邮箱帐号的登录密码，用于使用TDC的邮件通知服务。

您公司指定服务邮箱帐号的登录密码

是

simmail.smsBackend

默认值为MOSUMP

否

tdc 14

simmail.smsDownstreamHost

否

simmail.smsDownstreamPort

否

simmail.smsEnabled

否

tdc 15

simmail.smsPassword

否

simmail.smsUpstreamHost

否

simmail.smsUpstreamPort

否

simmail.smsUpstreamPort

否

simmail.tlsEnabled

邮件服务是否开启TLS通信。

根据邮箱服务器是否要求使用TLS协议来填写，如要求使用则为 true，否则为 false。

否

tdc 15

simmail.tlsRequired

服务器是否使用TLS来通信。

根据邮箱服务器是否支持TLS协议来填写，如支持则为 true，否则为 false。

否

tdc 15

TDC-Aquila开源组件

#	配置项	含义	取值	是否必填	截图/说明
1	aquilaModules	设置部署 aquila的模块： · aquila-basic：基础模块 · aquila-log：日志模块 · aquila-analysis：根因分析模块 · *：所有模块其中，日志模块依赖基础模块，根因分析模块依赖日志和基础模块，系统会自动安装依赖模块	aquila-basic	是
2	clusterDomainName	默认集群域名	transwarp.local	是	不可修改
3	elasticsearch.searchDataStorage	search data存储大小，单位为GB	200	是

配置项

含义

取值

是否必填

截图/说明

aquilaModules

设置部署 aquila的模块：

· aquila-basic：基础模块

· aquila-log：日志模块

· aquila-analysis：根因分析模块

· *：所有模块

其中，日志模块依赖基础模块，根因分析模块依赖日志和基础模块，系统会自动安装依赖模块

aquila-basic

是

tdc 10

clusterDomainName

默认集群域名

transwarp.local

是

不可修改

elasticsearch.searchDataStorage

search data存储大小，单位为GB

200

是

tdc datastorage

TDC-Datamall组件

配置项

含义

取值

是否必填

截图/说明

adminPwd

admin 管理员密码

Transwarp@123

是

tdc 12

corporationName

企业名

星环科技

是

tdc transwarp

creditCode

企业社会信用代码

是

tdc creditcode

securityKey

256 位 AES 数据加密密钥

是

tdc securitykey

参数配置完成后，点击【下一步】进入安装步骤，进入安装步骤后无法再返回之前的步骤。

安装

服务配置完成后，开始安装。

开始安装后，注意不要按浏览器的后退键，否则可能导致重复安装。重复安装时若修改系统服务的配置，可能会导致整个集群不可用。

可用性检查

这一步可检查TDC关键服务是否可用。若检测成功，结果栏显示“检测正常”，若检测有缺陷，会在结果栏日志中进行提示，并给出处理建议。

部署完成

部署完成后，根据需要，您可以按照如上图提示，注册用户或者登陆管理员门户。