提前配置项

安装前，请您提前配置好以下配置项。

操作系统

请确保 x86 系统为 CentOS/RedHat Red Hat Enterprise Linux 7.6 及以上版本，建议用较新的版本，且 Kernel 版本为 3.10.0-957.1.3.el7.x86_64 及以上版本。

暂不支持 Red Hat Enterprise Linux Server release 7，若有适配需求，请联系支持人员。

支持主流国产系统。

资源容量

建议根据集群规划来确定资源容量大小，此处给出每台服务器建议规划的最小资源容量：

200 G / 磁盘
200 G docker 磁盘，并单独挂载
8 Core CPU
64 GB 内存
2个 500G 容量以上的单独硬盘

此外，master 节点的服务器还建议有 1个 SSD 硬盘用于 ETCD 的存储和读写；registry 节点建议单独配置一块 1T 大小的硬盘做镜像仓库的存储。

数据磁盘

数据磁盘是用于 warpdrive 创建 pv pvc 的，在安装 TDC 集群之前，需要预留磁盘资源作为存储池，具体磁盘容量配置可参考存储容量规划，并满足以下条件：

为 silver 存储池至少分配一块磁盘，并且磁盘内没有旧数据。若是之前使用过该磁盘，可以通过 wipefs -a 擦除文件系统确保磁盘没有旧数据残留。
磁盘为不挂载、无分区的裸盘，推荐使用 Raid5 存储格式；
建议每个存储池大小（用于该存储池的硬盘总大小）不小于 2TB；
gold 存储池建议使用 SSD 硬盘，用于 Inceptor Exector 等对性能要求较高的组件。

日志磁盘配置

生产场景下，日志磁盘/var/log必须单独挂载，且建议大小超过500G。

docker 磁盘分区

确保 docker 有一块单独的磁盘进行挂载，磁盘的类型为 xfs 格式，挂载目录为 /var/lib/docker ；

可以通过 xfs_info /var/lib/docker 进行查看，并确保 ftype=1

# xfs_info /var/lib/docker
meta-data=/dev/vdb1              isize=512    agcount=4, agsize=32767872 blks
         =                       sectsz=512   attr=2, projid32bit=1
         =                       crc=1        finobt=0 spinodes=0
data     =                       bsize=4096   blocks=131071488, imaxpct=25
         =                       sunit=0      swidth=0 blks
naming   =version 2              bsize=4096   ascii-ci=0 ftype=1
log      =internal               bsize=4096   blocks=63999, version=2
         =                       sectsz=512   sunit=0 blks, lazy-count=1
realtime =none                   extsz=4096   blocks=0, rtextents=0
#
# xfs_info /var/lib/docker | grep ftype=1
naming   =version 2              bsize=4096   ascii-ci=0 ftype=1

如果上一步的检测未通过，请通过以下步骤找一块硬盘并将其格式化为 xfs 格式，并写入 /etc/fstab：
1. 将分配给 docker 的硬盘格式化为 xfs，并指定 ftype=1：
  # mkfs.xfs -n ftype=1 /dev/sdxx
2. 可通过 xfs_info /dev/sdxx 命令检查格式化是否成功，如果结果中有 ftype=1，表示初始化成功；
3. 获取分区 UUID：
  # blkid /dev/sdxx
  比如：
  # blkid /dev/sdb1 /dev/sdb1: UUID="8c467b5e-de8f-49b2-a19f-5ab0e34760f0" TYPE="xfs" PARTLABEL="primary" PARTUUID="94235e01-eeb3-4927-aa54-6ccb4b4124b1"
4. 编辑 /etc/fstab，写入：
  UUID=8c467b5e-de8f-49b2-a19f-5ab0e34760f0 /var/lib/docker xfs defaults,uquota,pquota 0 0
5. 执行命令
  # mount -a
6. 检查 /var/lib/docker 是否成功挂载，若是有返回，代表成功挂载。
  # df -h | grep /var/lib/docker
7. 继续进行后面几项检查。
  
  确保 docker 磁盘挂载信息写入到 /etc/fstab，保证后续节点重启 docker 磁盘挂载仍会生效，可以通过以下命令检查，若是有返回，表示符合要求：
  # grep /var/lib/docker /etc/fstab

确保 docker 的挂载参数里面有 uquota，pquota；
1. 检查 /etc/fstab 中有没有配置 uquota pquota 信息，若是返回信息有 xfs、uquota pquota，表示符合要求：
  # grep /var/lib/docker /etc/fstab /dev/sdb1 /var/lib/docker xfs defaults,uquota,pquota 0 0
2. 检查 docker 挂载参数是否生效，若是返回有 usrquota 和 prjquota，表示符合要求：
  # mount | grep xfs | grep /var/lib/docker /dev/sdb1 on /var/lib/docker type xfs (rw,relatime,seclabel,attr2,inode64,usrquota,prjquota)

默认路由

所有节点默认会有一条默认路由，在安装 TDC 集群之前若是有多条默认路由，使用 ip route delete xxx 删除默认路由只留一条。

OS 时间

时区选择(亚洲/上海)，时间与北京时间一致。

主机名（加检测）

主机名只能由英文、数字和 “-” 组成。请注意，集群的节点名称 不能重复，且必须符合DNS-1123规范，由数字、小写字母或“-”组成，不能包含大写字母，长度小于63。

用户名密码

即将要加入到 TDC 集群中的节点，密码中包含的特殊字符只支持 # $ ! @ % ^ & * ，若包含其他特殊字符会导致安装过程中报错。

网络

即将要加入到 TDC 集群中的所有节点必须属于统一内网，确保网络互通，保证延迟在正常范围内；

安装 TCOS 需要最低的网络为千兆以太网，当一台机器上有多个网络适配器时，用户可以在安装 TCOS 之前对其进行绑定配置，优先选择万兆网卡。

浏览器

版本

Google Chrome(推荐)

85.0.4183 及以上

FireFox

92.0及以上

Safari

12.0.1及以上

建议使用最新版本的浏览器。

VIP配置

VIP 配置提供集群外 ingress 访问的能力。

提前准备好一个可用的 ip，用来设置为 ingress 组件的 vip（可选）。

安装检查项

安装过程中，会对以下项目进行检查，不满足要求则会检查不通过。

操作系统

版本	操作系统
TDC 3.1.0	CentOS/RedHat Red Hat Enterprise Linux 7.6 及以上版本
TDC 3.0.1	CentOS/RedHat Red Hat Enterprise Linux 7.6 及以上版本
TDC 3.0.0	CentOS/RedHat Red Hat Enterprise Linux 7.6 及以上版本
TDC 2.5.1	麒麟v10及以上、 CentOS/RedHat Red Hat Enterprise Linux 7.6 及以上版本
TDC 2.5.0	麒麟v10及以上、 CentOS/RedHat Red Hat Enterprise Linux 7.6 及以上版本

版本

操作系统

TDC 3.1.0

CentOS/RedHat Red Hat Enterprise Linux 7.6 及以上版本

TDC 3.0.1

CentOS/RedHat Red Hat Enterprise Linux 7.6 及以上版本

TDC 3.0.0

CentOS/RedHat Red Hat Enterprise Linux 7.6 及以上版本

TDC 2.5.1

麒麟v10及以上、 CentOS/RedHat Red Hat Enterprise Linux 7.6 及以上版本

TDC 2.5.0

麒麟v10及以上、 CentOS/RedHat Red Hat Enterprise Linux 7.6 及以上版本

数据磁盘

数据磁盘是用于 warpdrive 创建 pv pvc 的，若是节点没有符合要求的数据磁盘，检查脚本会报错退出。

具体要求如下：

为 silver 存储池至少分配一块磁盘，并且磁盘内没有旧数据。若是之前使用过该磁盘，可以通过 wipefs -a 擦除文件系统确保磁盘没有旧数据残留。
建议磁盘为不挂载、无分区的裸盘，测试环境也可以为一块分区，推荐使用 Raid5 存储格式；
建议每个存储池大小（用于该存储池的硬盘总大小）不小于 2TB；
gold 存储池建议使用 SSD 硬盘，用于 Inceptor Exector 等对性能要求较高的组件。

docker 磁盘

docker 磁盘信息符合以下要求之一检查脚本会报错退出：

/var/lib/docker 目录没有被挂载
docker 磁盘不是 xfs 格式
docker 磁盘 xfs_info 信息 ftype 不为 1
/etc/fstab 下没有 docker 磁盘挂载信息
/etc/fstab 下 docker 挂载参数没有 uquota 或 pquota
mount 命令过滤 docker 挂载信息没有 usrquota prjquota 参数

默认路由

默认路由信息符合以下要求之一检查脚本会报错退出：

没有默认路由
有2条或是多条默认路由

system版本

system版本小于219.78会有WARNING 提示，提示用户升级。

安装节点数量

安装节点前需要根据节点数量提前申请licence，默认licence节点数量限制为30个，若是实际部署节点大于licence下的节点数量会报错。

flannel 路由残留

节点若是存在以下flannel路由信息之一，检查脚本会报错退出：

ip route返回信息中有fl字段
ip addr返回信息中有fl字段

端口检查

tdc-installer在安装tcos时，为了避免端口已被占用导致安装失败的情况，在节点检测模块加入了端口检测，检测的端口列表如下：

["80", "443", "1235", "2191", "2379", "2380", "3777", "5000", "60907", "8080", "8082", "8808", "8809", "9100", "9911", "10248", "10249", "10250", "10251", "10252", "10254", "10255", "10256", "10257", "10259", "10256", "10430", "15443", "16443", "20256", "20257"]

ovs 组件

节点上若是有如下组件在运行，检查脚本会报错退出：

ovsdb-server
ovs-vswitchd
openvswitch === 安装包准备 ==== TDC和安装器 Installer对应关系各个版本TDC和TDC Installer对应关系如下，请按照对应关系下载安装包。

TDC	TDC Installer
TDC 2.5.0	1.0.0
TDC 2.5.1（AMD）	1.1.0
TDC 2.5.1（ARM）	1.2.0
TDC 3.0.0	1.2.0
TDC 3.0.1	1.3.0
TDC 3.1.0	1.4.0

TDC3.1.0安装包列表

TDC 3.1.0需要以下安装介质，获取途径：https://wiki.transwarp.io/pages/viewpage.action?pageId=63427885。请联系星环科技技术支持获取。

同时，您需要手动下载安装包到 TDC-installer 对应目录（ /opt/tdc-installer/packages ）下，这样系统才可以识别到该已经上传的安装包。

TCOS所需安装包如下：

TCOS安装包：TCOS-v3.2.0-final-installer.tar.gz
TCOS-installer 安装包：TCOS-v3.2.0-final-package.tar.gz

TDC所需安装包列表如下:

tdc-operator：tdc-operator-1.4.0-final.tar.gz
tdc-basic：TDC-Basic-Component-Transwarp-3.1.0-final.tar.gz
tdc-addones：TDC-Basic-Addons-Transwarp-3.1.0-final.tar.gz
guardian：GUARDIAN-Image-Registry-Transwarp-3.2.3-final.tar.gz
kundb：KUNDB-Image-Registry-2.1.2-X86_64-final.tar.gz
tdc-appmarket：TDC-AppMarket-Transwarp-3.1.0-final.tar.gz（非必须）
aquila：AQUILA-Image-Registry-2.0.1-TDC-X86_64-final.tar.gz（非必须）
datamall： DATAMALL-Image-Registry-1.3.0-X86_64-final.tar.gz （非必须）
audit：AUDIT-Image-Registry-Transwarp-2.1.0-final.tar.gz（非必须） TDH-Image-Registry-Transwarp-6.2.2-final.tar.gz（非必须）

云产品镜像的安装包通过正则匹配（"([\\w-.]+).(tar.gz|tar)"）, 所有符合正则的安装包（且不属于TCOS和TDC部署所需的安装包）都会在TDH阶段解压并上传镜像。

tdc-installer安装TCOS和TDC时，除了自身tdc-installer的安装包和解压需要占用一定的存储空间外，还需要两个目录分别做安装包的存储和解压：

packages目录:用于存放TCOS，TDC， TDH安装包
product_releases目录：用于存放安装包解压后产生文件目录

安装前需要根据安装的场景提前预留好目录空间：

场景

TDCInstaller自身工具大小

安装包大小

安装包解压后的大小

合计

部署TCOS

10G

约18G

部署TCOS + TDC

15G

38G

42G

约95G

部署TCOS + TDC + TDH

15g

根据所选装的TDH版本，在TCOS+TDC基础上增加5-15G

约130G