前提条件

• 分布式部署模式下替换故障实例的前提条件：
  • 故障节点不能存在CN实例。
  • 集群中不能存在GTS实例。
  • 集群状态可查，主CM Server状态正常，集群状态不能为Unavailable。
  • 替换前不能锁定集群。
  • 实例替换必须在正常主机上执行。
  • 在修复实例时，各主机必须互信正常。
  • 替换实例操作会修复故障节点下的全部故障实例。
  • 替换实例期间集群不能执行DDL和DML操作。
  • 各节点的系统时间必须同步。
• 主备部署模式下替换故障实例的前提条件：
  • 集群状态可查，且主CM Server状态正常。
  • 替换前，故障节点上的DN所在的group不能被锁定。
  • 实例替换必须在一个正常主机上执行。
  • 在修复实例时，各主机必须互信正常。
  • 替换实例操作会修复故障节点下的全部故障实例。
  • 替换实例期间故障节点上的DN所在的group不能执行DDL和DML操作。
  • 各节点的系统时间必须同步。

注意事项

• 替换过程中，请勿执行数据的增删改等DML操作以及DDL操作，否则有可能数据丢失导致数据不一致。
• 如果故障实例所在主机的安装目录下（$GAUSSHOME/bin/）的二进制文件损坏或丢失，则不能通过替换实例进行修复。需要复制其他正常主机对应的二进制文件到该主机，或者将该主机卸载后，再通过替换主机修复。
• 在前一次替换结束后才能再次执行替换。因此请不要同时在多个主机上同时执行替换操作。
• 在替换实例的config阶段，先将CM Agent组件修复好，这样才能获取到集群中所有实例的状态。如果主机上的某些实例被人为停止，在CM Agent组件修复好之后，这些原来正常的实例会被正常拉起，而不会被替换。如果在一定时间内拉起失败，这些实例将会被替换。

操作步骤

以替换主机plat1、plat2上的实例为例。

1. 以omm用户身份登录GaussDB 100待替换实例所在服务器。
2. 使用如下命令在需要替换实例的主机上完成配置操作。

   omm@plat1:~> gs_replace -t config -h plat1,plat2

   配置操作会清理替换实例的空间，初始化替换实例，配置替换实例。
   

   如果收到提示：“GAUSS_50201: The XXX does not exist.”，则请检查对应的实例数据目录是否存在。如果不存在，请重新创建目录后再次执行上述命令。

3. 使用如下命令在需要替换实例的主机上完成启动操作。

   omm@plat1:~> gs_replace -t start -h plat1,plat2

   启动操作会启动集群替换实例的主机。
   

4. 使用如下命令查询集群状态。

   omm@plat1:~> gs_om -t status

   示例
   

示例1：替换故障实例。

1. 配置替换的实例。

   omm@plat1:/opt/software/gaussdb/script> gs_replace -t config -h plat1
   Check cluster status for replace.
   Check the status of ETCD cluster.
   Successfully check the status of ETCD cluster.
   Successfully check cluster status.
   Filter out all valid hosts for replacing.
   Distributing configuration to remote host.
   Successfully distributed configuration to remote host.
   Configuring
   Stopping replace instances.
   Successfully stopped replace instances.
   Configuring replacement instances.
   Config replace instances.
   Successfully config replace instances.
   Config standby DN of new instances.
   .......67s
   Config standby DN of new instances successfully.
   Successfully configured replacement instances.
   Configuration succeeded.
   ==============================
   Time statistics:
           Config replacement nodes: 95s
   total: 95s

2. 启动替换实例所在主机。

   omm@plat1:/opt/software/gaussdb/script> gs_replace -t start -h plat1
   Starting.
   ==============================
   ..
   Start cm agent on new nodes.
   Successfully start cm agent for new nodes.
   Starting the cluster.
   .
   Successfully started instance process. Waiting to become Normal.
   ==============================
   Successfully started cluster.
   ==============================
   Time statistics:
           Start replacement nodes: 27s
   total: 27s