node config show

本命令用于展示指定节点的配置信息。

选项	含义
-c, --cluster	YashanDB的集群名（必传参数）
-n, --node-id	目标节点的ID（例如1-2，可通过yasboot cluster status命令查看数据库信息取nodeid冒号前的数字串）（必传参数）
-q, --query	查询组配置中单个或多个参数（可以模糊匹配）
--parameter	配置的详情
-a, -all	查询所有参数，包括未设置的参数
-u, --username	指定数据库用户，不指定则默认使用sys用户
-p, --password	数据库用户的密码 若使用sys用户且已开启操作系统认证（安装后默认开启）则无需指定密码

示例

$ yasboot node config show -c yashandb --node-id 1-1 -a
$ yasboot node config show -c yashandb --node-id 1-1 -q SCOL_DATA_BUFFER_SIZE -a

node config set

本命令用于手动更改/设置指定节点的配置。

选项	含义
-c, --cluster	YashanDB的集群名（必传参数）
-n,--node-id	目标节点的ID（例如1-2，可通过yasboot cluster status命令查看数据库信息取nodeid冒号前的数字串）（必传参数）
-k, --key	设置参数的名称（必传参数），单机支持修改PROTECTION_MODE
-v, -value	设置参数key对应的值（必传参数）
-s, --scope	支持设置参数的范围
-w, --nowait	运行后不等待执行命令结果
-d, --child	展示任务以及子任务信息
--disable	屏蔽任务进度条展示
-u, --username	指定数据库用户，不指定则默认使用sys用户
-p, --password	数据库用户的密码 若使用sys用户且已开启操作系统认证（安装后默认开启）则无需指定密码

示例

$ yasboot node config set -c yashandb --node-id 1-1 -k UNDO_RETENTION -v 350

node config unset

本命令用于将指定节点的配置信息重设为初始默认值。

选项	含义
-c, --cluster	YashanDB的集群名（必传参数）
-n, --node-id	目标节点的ID（例如1-2，可通过yasboot cluster status命令查看数据库信息取nodeid冒号前的数字串）（必传参数）
-k, --key	重设参数的名称（必传参数）
-w, --nowait	运行后不等待执行命令结果
-d, --child	展示任务以及子任务信息
--disable	屏蔽任务进度条展示
-u, --username	指定数据库用户，不指定则默认使用sys用户
-p, --password	数据库用户的密码 若使用sys用户且已开启操作系统认证（安装后默认开启）则无需指定密码

示例

$ yasboot node config unset -c yashandb --node-id 1-1 -k UNDO_RETENTION

node status

本命令用于查看指定节点的状态。

选项	含义
-c, --cluster	YashanDB的集群名（必传参数）
-n, --node-id	目标节点的ID（例如1-2，可通过yasboot cluster status命令查看数据库信息取nodeid冒号前的数字串）（必传参数）
-d, --detail	是否展示运行状态的细节，默认为false
-u, --username	指定数据库用户，不指定则默认使用sys用户
-p, --password	数据库用户的密码 若使用sys用户且已开启操作系统认证（安装后默认开启）则无需指定密码

示例

$ yasboot node status -c yashandb -n 1-1
+---------------------------------------+
| host_id  | node_type | nodeid | pid   |
+---------------------------------------+
| host0001 | mn        | 1-1:1  | 22211 |
+----------+-----------+--------+-------+

node stop

本命令用于停止运行中的节点。

选项	含义
-c, --cluster	YashanDB的集群名（必传参数）
-n, --node-id	目标节点的ID（例如1-2，可通过yasboot cluster status命令查看数据库信息取nodeid冒号前的数字串）（必传参数）
-f, --force	是否强制停止节点，默认不强制
-w, --nowait	运行后不等待执行命令结果
-d, --child	展示任务以及子任务信息
--disable	屏蔽运行的进度信息
-s, --stop-mode	关库方式，可选[normal|immediate|abort]，默认为immediate（共享集群/分布式集群部署暂时无法使用）
-u, --username	指定数据库用户（不指定则默认使用sys用户）
-p, --password	数据库用户对应的密码
--wait-timeout	命令执行超时时间（隐藏参数）

示例

$ yasboot node stop -c yashandb -n 4-1

node start

本命令用于启动节点。

选项	含义
-c, --cluster	YashanDB的集群名（必传参数）
-n, --node-id	目标节点的ID（例如1-2，可通过yasboot cluster status命令查看数据库信息取nodeid冒号前的数字串）（必传参数）
-m, --start-mode	启动方式，可选[mount|nomount|open]，默认为open（共享集群/分布式集群部署暂无法启动到mount模式）
-w, --nowait	运行后不等待执行命令结果
-d, --child	展示任务以及子任务信息
--disable	屏蔽运行的进度信息
-u, --username	指定数据库用户，不指定则默认使用sys用户
-p, --password	数据库用户的密码 若使用sys用户且已开启操作系统认证（安装后默认开启）则无需指定密码
--wait-timeout	命令执行超时时间（隐藏参数）
--wallet-password	数据库钱包密码

示例

$ yasboot node start -c yashandb -n 4-1
$ yasboot node start -c yashandb -n 4-1 -m nomount

node restart

本命令用于重启节点。

选项	含义
-c, --cluster	YashanDB的集群名（必传参数）
-n, --node-id	目标节点的ID（例如1-2，可通过yasboot cluster status命令查看数据库信息取nodeid冒号前的数字串）（必传参数）
-m, --start-mode	启动方式，可选[mount|nomount|open]，默认为open（共享集群/分布式集群部署暂无法启动到mount模式）
-f, --force	是否强制停止节点，默认不强制
-w, --nowait	运行后不等待执行命令结果
-d, --child	展示任务以及子任务信息
--disable	屏蔽运行的进度信息
-s, --stop-mode	关库方式，可选[normal|immediate|abort]，默认为immediate（共享集群/分布式集群部署暂时无法使用）
-u, --username	指定数据库用户（不指定则默认使用sys用户）
-p, --password	数据库用户对应的密码
--wait-timeout	命令执行超时时间（隐藏参数）
--wallet-password	数据库钱包密码

示例

$ yasboot node restart -c yashandb -n 4-1

node switchover

本命令用于手动进行switchover主备切换（共享集群只适用主备共享集群）。

选项	含义
-c, --cluster	YashanDB的集群名（必传参数）
-n, --node-id	要升主的目标节点的ID（例如1-2，可通过yasboot cluster status命令查看数据库信息取nodeid冒号前的数字串）（必传参数）
-f, --force	是否确认，默认不
-w, --nowait	运行后不等待执行命令结果
-d, --child	展示任务以及子任务信息
--disable	屏蔽运行的进度信息
-u, --username	指定数据库用户，不指定则默认使用sys用户
-p, --password	数据库用户的密码 若使用sys用户且已开启操作系统认证（安装后默认开启）则无需指定密码
--wait-timeout	命令执行超时时间（隐藏参数）

示例

$ yasboot node switchover -c yashandb -n 4-1

node failover

本命令用于手动进行failover主备切换（共享集群只适用主备共享集群）。

选项	含义
-c, --cluster	YashanDB的集群名（必传参数）
-n, --node-id	要升主的目标节点的ID（例如1-2，可通过yasboot cluster status命令查看数据库信息取nodeid冒号前的数字串）（必传参数）
-w, --nowait	运行后不等待执行命令结果
-d, --child	展示任务以及子任务信息
--disable	屏蔽运行的进度信息
-u, --username	指定数据库用户，不指定则默认使用sys用户
-p, --password	数据库用户的密码 若使用sys用户且已开启操作系统认证（安装后默认开启）则无需指定密码
--wait-timeout	命令执行超时时间（隐藏参数）

示例

$ yasboot node failover -c yashandb -n 4-1

node remove

本命令用于进行节点级别的缩容，节点可能为：

• 单机主备部署中的备库

• 共享集群部署中的实例

• 存算一体分布式集群部署中的CN节点、DN备节点或MN备节点

选项	含义
-c, --cluster	YashanDB的集群名（必传参数）
-n, --node-id	待删除的节点ID（例如1-2，可通过yasboot cluster status命令查看数据库信息取nodeid冒号前的数字串），仅允许指定一个ID 如需一次性删除多个节点请使用--node-ids参数
--node-ids	待删除的节点ID清单（例如1-3,1-4，可通过yasboot cluster status命令查看数据库信息取nodeid冒号前的数字串），允许指定一个或多个ID，ID间使用逗号分隔
-f, --force	跳过确认直接执行命令
--purge	删除目标节点的data数据
-w, --nowait	运行后不等待执行命令结果
-d, --child	展示任务以及子任务信息
--disable	屏蔽运行的进度信息
--clean	清理所有扩容失败的节点，默认为false
--ce-clean	备份恢复后删除多余文件，本参数仅适用于共享集群部署
--no-primary	是否在单机主备部署中允许在无主库的情况下执行操作（此参数仅对单机部署有效），默认为false
-u, --username	指定数据库用户，不指定则默认使用sys用户
-p, --password	数据库用户的密码 若使用sys用户且已开启操作系统认证（安装后默认开启）则无需指定密码
--with-host	成功删除节点后，继续删除当前集群中无数据库节点、无yasom进程的空服务器的信息（如果使用了--nowait，则该参数失效）
--with-unconnected-host	如果被删除节点的服务器已经无法连接，使用该参数可以跳过部分任务，强制删除节点。

示例

$ yasboot node remove -c yashandb -n 4-1 --purge

node add

本命令用于进行节点级别的扩容，节点可能为：

• 单机主备部署中的备库

• 共享集群部署中的实例

• 分布式集群部署中的CN节点或DN节点

• 存算一体分布式集群部署中的CN节点、DN备节点或MN备节点

选项	含义
-c, --cluster	集群名称（必传参数）
-t, --toml	扩容节点的配置文件（必传参数）
-d, --child	展示任务以及子任务信息
--disable	屏蔽运行的进度信息
--no-primary	是否在单机主备部署中允许在无主库的情况下执行操作（此参数仅对单机部署有效），默认为false
-p, --password	数据库sys用户对应的密码 若已开启操作系统认证（安装后默认开启）则无需指定密码
--max-protection-timeout	修改保护模式的超时时间（单位：秒），默认值为7200，超过该值未修改成功视为任务失败并中断操作
--wait-timeout	命令执行超时时间（隐藏参数）
--no-backend	将所有后台任务放到前台运行
--wallet-password	数据库钱包密码

示例

$ yasboot node add -t yashandb_add.toml -c yashandb -d

node build

本命令用于对备节点进行重建处理。

选项	含义
-c, --cluster	集群名称（必传参数）
-w, --nowait	运行后不等待执行命令结果
-d, --child	展示任务以及子任务信息
--node-ids	需要重建的节点ID，多个ID间使用逗号，分隔（必传参数）
--disable	屏蔽运行的进度信息
-u, --username	指定数据库用户，不指定则默认使用sys用户
-p, --password	数据库用户的密码 若使用sys用户且已开启操作系统认证（安装后默认开启）则无需指定密码
--wait-timeout	命令执行超时时间（隐藏参数）
-f, --force	无需确认，默认false
--parallelism	并行度，范围为1-16，默认为4
--skip-validate	指定该参数时表示跳过建立备库时的预检查，默认为检查
--overwrite	指定该参数时表示在建立备库过程中覆盖同名文件（REDO文件和归档文件不会覆盖，需人工检查并手动清理），默认不覆盖
--wallet-password	数据库钱包密码

示例

$ yasboot node build -c yashandb --node-ids 1-2,1-3