更新日期：2024年09月11日
使用replace.py 命令对要替换的节点进行替换安装。必须在集群中Coordinator 节点
上使用集群安装用户dbauser 执行命令。
命令格式：
replace.py [options]
表4- 39 参数说明
参数名称
说
明
-h，--help
显示replace.py 的帮助信息。
-a
不提示用户确认信息。
---host=HOSTLIST
指定将要替换的节点IP 列表，用逗号分隔。
--type=NODETYPE
被替换的节点类型：
Coor：替换管理节点；
Data：替换数据节点。
--freenode=FREENODE
指定将要被替换的空闲的数据节点ip，与--host 中
指定得IP 一一对应。
在替换纯数据节点时，
使未被
任何虚拟集群使用的空闲数据节点来替换损坏的纯
数据节点。
--dbaUser
集群运行时使用的操作系统DBA 用户名。
--dbaUserPwd
操作系统DBA 用户的密码，
要求所有节点DBA 密
码一致。
--generalDBUser
数据库DBA 用户名，可选参数，不输入时默认为
数据库root 用户。
--generalDBPwd
数据库DBA 用户密码，目前密码中不支持单引号，
其它特殊符号用单引号包围。
--overwrite
强制替换标志，如果设置了这个标志，被替换节点
上残留的集群软件将被强制卸载，重新安装新的集
群。这个参数可选。
--sync_coordi_metadata_timeout
执行节点替换时,每次拷贝coordinator 节点元数据
的超时时间，
单位为分钟，
默认为15 分钟，
最小值
GBase 8a MPP Cluster 产品手册
4 管理员指南
文档版本953（2022-04-10）
南大通用数据技术股份有限公司
287
参数名称
说
明
为1，最大值为2147483647。
--parallel_pack
备份拷贝coordinator 节点元数据的模式，取值为0
或1, 默认为0。0--各节点全量备份；1--每个节点
备份一部分，最后在目的节点汇总。
--retry_times
替换过程中单步操作失败的重试次数，默认为3，
最小值为1，最大值为2147483647。
--use_shm
使用共享内存存放数据包，使用该参数需先确认每
个coordinator 节点的/dev/shm 有足够空间存放所有
集群层元数据。取值为0 或1，默认值为0。
--use_shm_save_temp
是否使用/dev/shm 存储替换过程中产生的临时文件
数据，使用/dev/shm 可以提高效率，但是如果
/dev/shm 空间不足，效率可能会更低，并影响系统
运行。
取值为0 或1，
默认为1，
现场根据表以及列
的数量自行评估是否使用。0--不使用/dev/shm；1--
使用/dev/shm。
--vcname
被替换数据节点的vc name，每次替换只能替换一
个vc。
--passwordputMode
用于指定密码获取的方式，通过不同的参数实现不
同的获取方式。若指定该参数，则demo.options 中
的密码不必再修改。取值范围为file、pwdsame、
pwddiff，默认值为file。
取值说明如下：
file：表示从文件或命令行参数获取，和原有
的方式一致，
该方式下，
文件中的密码是明文
的；
Pwdsame：表示从终端由用户输入密码，并且
所有节点的密码一致情况下使用该参数，
对于
不同用户密码只输入一次；
pwddiff:：表示从终端由用户输入密码，并且
节点间的密码不一致情况下使用该参数，
对于
不同用户密码每个节点分别输入一次。
GBase 8a MPP Cluster 产品手册
4 管理员指南
文档版本953（2022-04-10）
南大通用数据技术股份有限公司
288
注意
use_shm_save_temp 参数默认值为1，会在/dev/shm 空间内
产生临时文件，若/dev/shm 空间不足，可能会效率更低或
操作系统报错。
节点替换相关日志说明：
replace.log 记录了安装、卸载被替换节点和替换中执行的
gcadmin 详细调用操作和登录各节点的检查信息和ssh 交互
操作等信息；
gcware 节点gcware/liblog/下gadm_cp_codi_tbl.log 和
gcware/gadm_cp_sys_tbl.log 中记录了同步元数据和数据的
相关信息。