GaussDB数据库用户指南--在本地磁盘安装实例在本地磁盘安装实例操作场景使用云数据库GaussDB管理平台（TP

在本地磁盘安装实例

操作场景

使用云数据库GaussDB管理平台（TPOPS），在本地磁盘目录下安装元数据库已纳管版本的实例，实例支持V2.0-3.226版本、V2.0-8.0及以上版本。

前提条件

首次安装实例前，需要先申请试用订购容量。具体操作可参见订购管理，申请产品许可后试用TPOPS。
如果数据节点曾进行过安装实例且之前的安装模式与本次安装不同，请先手动清理节点。具体操作可参考转换安装模式前手动清理节点方法。
如果要安装带浮动IP的集中式版非单节点实例，需要提前准备与业务IP同网段的浮动IP，保证浮动IP唯一且有效。具体准备方法可参考准备浮动IP。
若安装实例时找不到对应节点，请确认管控升级后是否有对该节点重新上线。
安装实例前需提前规划软件目录、数据目录（ETCD）、数据目录（DN）、日志目录，并对实例所有节点完成挂盘、初始化工作。可参考自定义安装实例磁盘挂载要求。
如果需要安装历史版本的实例，则需要先将历史安装包上传至安装包管理中，历史安装包配套详见GaussDB数据库引擎版本说明，具体上传操作可参考上传安装包。

约束限制

GaussDB集中式版实例仅支持4U16G、8U32G、8U64G、16U64G、16U128G、24U96G、24U192G、32U128G、32U256G、48U192G、48U384G、64U256G、64U512G、96U768G、128U512G、128U1024G、256U1024G、256U2048G十八档规格，且24U96G、24U192G、48U192G、48U384G这四档规格仅在数据库引擎版本为V2.0-8.100.0及以上才支持。
GaussDB分布式实例仅支持8U64G、16U64G、16U128G、32U128G、32U256G、64U256G、64U512G、96U768G、128U1024G九档规格。
DBMind实例支持的规格，详见规格说明。请选择硬件规格大于或等于最小实例规格的主机。
仲裁节点和日志节点可以低于计算节点规格，但不能低于对应部署形态的最小规格。
GaussDB在V2.0-8.201及以上版本支持IPv6，且安装模式需要为DM模式。IPv6实例功能约束请参见IPv6实例功能约束。

操作步骤

登录云数据库GaussDB管理平台（TPOPS）。
单击“实例管理 > 安装实例”，进入“安装实例”界面。

图1 安装实例

表1 安装实例参数说明

参数名称

参数解释

实例名称

自定义待安装实例名称。实例名称长度在4个到64个字符之间，必须以字母开头，可以包含字母、数字、中划线或下划线，不能包含其他特殊字符。

数据库引擎版本

选择待安装的GaussDB实例版本。GaussDB实例支持V2.0-3.226版本、V2.0-8.0及以上版本。

操作系统

选择操作系统类型，根据注册的主机情况进行展示。当前支持麒麟、HCE、SUSE、BCLINUX和统信系统。

操作系统版本

选择操作系统版本，根据注册的主机情况进行展示。当前支持kylin V10 SP1、kylin V10 SP2、kylin V10 SP3、uos 20、bclinux 21.10、sles 12.5、hce 2.0。不支持操作系统版本异构。

说明：
- kylin V10 SP3要求数据库引擎版本在V2.0-8.100.0及以上。
- bclinux 21.10要求数据库引擎版本在V2.0-8.210.0及以上。
- sles 12.5要求数据库引擎版本在V2.0-8.200.0及以上。
- hce 2.0要求数据库引擎版本在V2.0-8.102.0及以上。
架构类型

选择操作系统架构，根据注册的主机情况进行展示。当前支持X86、ARM。

CPU厂商

选择CPU厂商，根据注册的主机情况进行展示。当前支持鲲鹏、英特尔和海光。

主机类型

选择主机类型，根据注册的主机情况进行展示。当前支持物理机类型。

安装模式

选择安装模式，默认为DM模式。当前支持DM模式和沙箱模式：
- DM模式，为默认模式，支持网络三平面、两平面、单平面安装。
- 沙箱模式仅支持网络两平面、单平面安装。使用沙箱模式请开启白名单，特性白名单名称为：gaussdb_feature_supportChrootInstall。如何操作请参见开启特性白名单。
实例类型

选择待安装的GaussDB实例类型，支持“分布式版”和“集中式版”。
- 分布式版：分布式形态能够支撑较大的数据量，且提供了横向扩展的能力，可以通过扩容的方式提高实例的数据容量和并发能力。
- 集中式版：适用于数据量较小且不会大幅度增长，对数据的可靠性、业务的可用性有一定诉求的场景。
部署形态

选择GaussDB实例部署形态，不同实例类型支持的部署形态如下：
- 分布式版：
  - 单节点（3分片）：包含三个分片。
  - 单节点（4分片）：包含四个分片。
  - 3节点：采用一主两备三节点的部署模式，包含三个分片。
  - 4节点：采用一主一备四节点的混合部署模式，包含四个分片。
  - 5节点：采用一主三备五节点的混合部署模式，包含四个分片和一个仲裁节点。
  - 9节点：采用一主三备九节点的混合部署模式。包含四个分片和一个仲裁节点。
- 集中式版：
  - 单节点：包含一个分片。
  - 2节点：采用一主一备一日志两节点的部署模式，其中日志节点和数据节点合并部署，包含一个分片。仅支持V2.0-3.301及以上的GaussDB数据库引擎版本。
  - 3节点（1主1备1日志）：采用一主一备一日志三节点的部署模式。
  - 3节点（1主2备）：采用一主两备三节点的部署模式，包含一个分片。
  - 5节点（1主3备1仲裁）：采用一主三备五节点的部署模式，包含一个分片，一个仲裁节点。
  - 5节点（1主4备）：采用一主四备五节点的部署模式，包含一个分片。
“单节点”需要开启白名单，特性白名单名称为：gaussdb_feature_supportSingleMode。如何操作请参见开启特性白名单。

“3节点（1主1备1日志）”需要开启白名单，特性白名单名称为：gaussdb_feature_supportLoggerSolution。如何操作参见开启特性白名单。

鼠标停留可查看各形态的数据库架构图。

V2.0-8.102版本开始，集中式版“2节点”、“3节点”、“5节点（1主3备1仲裁）”、“5节点（1主4备）”可使用去ETCD形态，开启特性白名单：gaussdb_feature_supportDccCluster即可启用。如何操作请参见开启特性白名单。

说明：

去ETCD形态下集中式版“2节点”实例，其中一个节点发生故障后，由于不满足多数派，整个实例会异常。可以通过AZ强启恢复业务，操作可参考AZ故障操作。

副本一致性协议

该参数在“实例类型”配置为“集中式版”时为必选参数。仅支持V2.0-3.200及以上的GaussDB数据库引擎版本。
- Quorum：Quorum模式主备同步复制机制。客户端发起事务后，必须要等待对应的WAL日志复制到多个副本后，主库才会响应给客户端，少数节点的宕机不影响全局可用性，保证数据的一致性。
- Paxos：Paxos模式解决了Quorum模式下日志复制过程中日志分叉的问题，提高日志复制吞吐量，增加DN自仲裁能力。
集中式版“2节点”形态仅支持Paxos协议。

集中式版“3节点（1主1备1日志）”形态仅支持Paxos协议。

集中式版V2.0-3.226版本单节点不支持Paxos协议。

启用去ETCD形态后，集中式版“2节点”、“3节点”、“5节点（1主3备1仲裁）”、“5节点（1主4备）”仅支持Paxos。

事务一致性

该参数在“实例类型”配置为“分布式版”时为必选参数。
- 强一致性：应用更新数据时，用户都能查询到全部已经成功提交的数据，对性能有影响。
- 最终一致性：应用更新数据时，用户查询到的数据可能不相同，有可能是更新后的值，也有可能是更新前的值，但经过一段时间后，查询到的数据是更新后的值，该种类型通常具有较高的性能。注意，不支持分布式事务强一致性的读操作；不支持insert into、select * from等依赖于查询结果的事务一致性；不支持拆分成多语句的写操作；不支持涉及多个节点执行的写操作；不支持搭建容灾。
切换策略

该参数在“实例类型”配置为“集中式版”且“部署形态”配置为“2节点”时开放。
- 数据高可靠：对数据一致性要求高的系统推荐选择数据高可靠，在故障切换的时候优先保障数据一致性。该策略下，日志节点将部署在备节点上。
- 业务高可用：对业务在线时间要求高的系统推荐使用业务高可用，在故障切换的时候优先保证数据库可用性。该策略下，日志节点将部署在主节点上。
默认选择为数据高可靠，实例安装后如需修改切换策略，请参考修改切换策略。

说明：

在业务高可用场景下需要谨慎修改如下数据库参数，参数如何修改，可参见修改实例参数：
- recovery_time_target：不当修改该参数会导致实例频繁进行强制切换，请联系技术支持指导修改。
- audit_system_object：不当修改该参数会导致丢失DDL审计日志，请联系技术支持指导修改。
存储类型

根据注册的主机情况进行展示。当前支持本地SSD磁盘和闪存存储，这里需要选择本地SSD磁盘。

是否支持浮动IP

选择待安装实例是否支持浮动IP功能。该参数在“实例类型”配置为“集中式版”且“部署形态”不为“单节点”时展示。
- 不支持：不支持浮动IP功能。
- 支持：需要输入一个浮动IP，实例安装后可以通过浮动IP访问DN节点数据。如针对主备切换场景：集中式版三节点设置了相同的浮动IP，通过浮动IP连接了数据节点，主备切换后，仍然可以通过配置的浮动IP连接数据节点。
具体验证方法请参考准备浮动IP。

说明：
- 浮动IP功能需选择503.1.0.SPC1200、503.1.0.SPC1300版本或者503.2.0及以后版本的内核安装包。
- 配置浮动IP时需保证配置的IP有效、唯一；若IP无效，实例安装后无法通过浮动IP进行访问，浮动IP地址必须和virtualIp使用同一网段，必须和manageIp以及dataIp使用同一网络协议栈。
- 实例安装后，浮动IP不支持修改。
- 服务器业务平面IP不支持配置在带VLAN子接口网卡上，如下图红色矩形框所示即为VLAN子接口（VLAN子接口单浮动IP场景下，DN主备切换后网络可能不通，影响业务侧快速切换）。执行如下命令查看网卡信息：
  
  ip a
  
  不带VLAN网卡子接口命名如：bond0、eth1
  
  带VLAN网卡子接口命名如（小数点后数字为VLAN ID）：bond0.1392、bond0.1382、eth1.235、bond0.123
- 不支持浮动IPv6。
- iputils的版本必须大于等于iputils-20190709-5.p02.ky10，如不满足，请升级到该版本或更高版本。执行以下命令查看当前版本：
  
  rpm -qa | grep iputils
- 浮动IP不支持bond1组网模式。
参数模板

数据库参数模板就像是数据库引擎配置值的容器，参数模板中的参数可应用于一个或多个相同类型的数据库实例。实例创建成功后，参数模板可进行修改。

实例创建完成之后可以根据业务需要进行调整。具体请参见参数模板管理。

M兼容表名大小写

该参数在“实例类型”配置为“集中式版”且“数据库引擎版本”为V2.0-8.210及以上版本时展示。

在M-Compatibility模式的数据库中，控制查询用户表名（含表别名）、用户视图名、Schema名（即内部库名）以及information_schema系统视图中上述对象对应字段值的大小写敏感性。

须知：
- M兼容表名大小写仅支持在创建实例时配置，创建后无法修改。默认值：区分大小写。
- 目标实例与原实例参数不一致，可能会导致以下操作失败：容灾搭建、备份恢复、导入导出、逻辑解码。
多租容器

数据库版本需要为V2.0-8.200以上，且主机规格需要在16U128G以上支持开启。创建完成之后可以创建彼此物理及资源隔离的租户，提升资源数据库系统的资源利用率。

说明：
- 开启后暂不支持取消纳管和纳管。
- 分布式版及集中式版2节点不支持开启。
- 暂不支持后台创建租户，否则管理控制台界面不会展示，且对资源的相关校验会失效。
- 暂不支持SQL限流。
- 不建议直接在多租容器实例上进行创库建表等相关操作，需要创建租户后使用租户再进行相关的操作。否则会导致多租容器资源计算不准确。
可用区
- 分布式版：
  - 单节点仅支持部署在一个可用区。
  - 3节点支持部署在一个或者三个可用区。
  - 4节点仅支持部署在一个可用区。
  - 5节点和9节点仅支持部署在三个可用区。
- 集中式版：
  - 单节点仅支持部署在一个可用区。
  - 2节点支持部署在两个可用区。
  - 3节点（1主1备1日志）支持部署在一个或者三个可用区。
  - 3节点支持部署在一个或者三个可用区。
  - 5节点（1主3备1仲裁）仅支持部署在三个可用区。
  - 5节点（1主4备）支持部署在一个或三个可用区。
- 在选择完实例部署的可用区之后，9节点和5节点（1主3备1仲裁）形态支持自主选择主、备、仲裁可用区，并且主、备、仲裁可用区不能相同。3节点（集中式版）仅支持选择主可用区。
- 可用区指在同一区域下，电力、网络隔离的物理区域，可用区之间内网互通，不同可用区之间物理隔离。
管理IP

用户已完成添加的主机，且只展示当前未被纳管的主机。

数据库端口

数据库对外开放的端口，默认为8000，可选范围为：1024~~39989。限制端口为2378~~2380、2400、4999~~5001、5100、5500、5999~~6001、6009~~6010、6500、8015、8097、8098、8181、9090、9100、9180、9187、9200、12016、12017、20049、20050、21731、21732、32122~~32126、39001。

如果为管理节点与数据节点合部的实例，则限制端口为2161~~2181、2378~~2380、2400、3868~~3888、4868~~5002、5100、5500、5999~~6001、6009~~6010、6500、8001~~9099、9100、9180、9187、9200、10020~~10022、12016、12017、20049、20050、21731、21732、21991~~22888、30160~~30180、31180~~31320、32122~~32126、39001。
填写NAS配置信息。

图2 NAS设备信息

表2 NAS设备信息参数说明

参数名称

参数解释

存储设备

可以选择对应的存储设备进行挂载，自定义路径为备份文件的存储路径。存储设备与实例的网络协议需要一致。

若当前平台未配置NAS设备，需要先在存储设备管理中完成存储设备配置。
填写自定义安装路径。

安装模式为DM模式必须配置自定义安装目录。
- 目录长度不能大于90个字符。
- 软件目录，数据目录（ETCD），数据目录（DN），日志目录不能相同。
- 目录需要以“/”为开头，各级目录名仅包含数字、字母和下划线。
- 目录不能以“/home”为开头，不能以“/”为结尾。
- 目录不能是“/”，“/var/chroot”。
图3 DM模式安装路径配置

表3 自定义安装路径参数说明

参数名称

参数解释

软件目录

除ETCD、DN、LOG组件之外所有组件都安装在该目录下。默认值：/opt/cluster。

数据目录（ETCD）

ETCD数据目录。默认值：/opt/cluster/usr/local/etcd。

数据目录（DN）

数据库数据目录。默认值：/opt/cluster/var/lib/engine/data1/data。

日志目录（LOG）

数据库日志目录。默认值：/opt/cluster/var/lib/log。
进行节点设置。

安装模式为DM模式可进行节点设置，“节点设置”需要开启白名单，特性白名单名称为：gaussdb_feature_supportDiyComponent。如何操作请参见开启特性白名单。

图4 DM模式节点设置
填写数据库配置信息。

图5 数据库信息

表4 数据库信息参数说明

参数名称

参数解释

管理员账户名

数据库的登录名称默认为root。

管理员密码

请您输入高强度密码并定期修改，以提高安全性，防止出现密码被暴力破解等安全风险。

新密码符合如下复杂程度要求：
- 密码不能少于8个字符且不超过32个字符。
- 密码必须至少由如下四类字符中的三类组合而成：
  - 至少包含一个大写字母（A-Z）。
  - 至少包含一个小写字母（a-z）。
  - 至少包含一个数字字符（0-9）。
  - 至少包含1个特殊字符（~!@#%^*-_=+?,）。
请妥善管理您的密码，因为系统将无法获取您的密码信息。

实例创建成功后，如需重置密码，请参见重置管理员密码。

确认密码

必须和管理员密码相同。
单击“立即申请”，进入信息确认页，确认实例信息。
- 如果需要重新选择实例规格，单击“上一步”，回到上个页面修改实例信息。
- 如果规格确认无误，单击“提交”，完成安装实例的申请。安装过程约10分钟，请耐心等待。
实例创建成功后，用户可以在“实例管理”页面对其进行查看和管理。
- 可依据实例名称/ID、业务IP等信息进行查询。
- 单击实例名称后面的，可修改已创建的实例名称。
- 单击实例名称下面的，可复制已创建的实例ID。

创建GaussDB实例过程中，状态显示为“创建中”。
在实例列表的右上角，单击刷新列表，可查看到创建完成的实例状态显示为“正常”。
数据库端口默认为8000，仅支持创建时设置，后期不可修改。
若已配置NAS服务器，实例创建完成后将自动开启“自动备份”功能，并会自动进行一次全量备份，用于记录实例的初始状态。

更多详情请参考GaussDB 文档中心：doc.hcs.huawei.com/db/zh-cn/ga…