#节点管理命令
# ycsctl start ycs
该命令用于启动当前服务器上的YCS及其所管理的资源。启动YCS时是否同时启动YashanDB数据库由AUTO_START参数控制。
命令格式及参数介绍如下：
ycsctl start ycs [-startoption start_options] [-p wallet_password]
| 参数选项 | 取值 | 参数描述 |
|---|---|---|
| -startoption -m | NOMOUNT、MOUNT或OPEN | 可选参数，指定数据库实例默认的启动阶段选项，省略时默认使用ycsctl add database命令指定的启动选项。 |
| -p | wallet_password | 可选参数，指定数据库实例进行密钥管理的钱包的密码。 当共享集群/分布式集群已有加密对象且需要直接启动数据库到MOUNT或OPEN模式时必须指定，否则数据库实例会启动失败。 |
Note:
请使用-startoption选项指定启动模式，-m选项已过时，保留仅用于兼容。
# ycsctl start instance
该命令用于启动当前服务器上的数据库实例。
执行此命令前，必须保证YCS已经启动。
在容器数据库集群中，系统将先启动根容器，然后根据各PDB的启动策略（由ycsctl add pdb命令的-policy参数指定）决定是否启动PDB。
命令格式及参数介绍如下：
ycsctl start instance [-startoption start_option] [-p wallet_password]
| 参数选项 | 取值 | 参数描述 |
|---|---|---|
| -startoption -m | NOMOUNT、MOUNT或OPEN | 可选参数，指定数据库实例默认的启动阶段选项，省略时默认使用ycsctl add database命令指定的启动选项。 |
| -p | wallet_password | 可选参数，指定数据库实例进行密钥管理的钱包的密码。 当共享集群/分布式集群已有加密对象且需要直接启动数据库到MOUNT或OPEN模式时必须指定，否则数据库实例会启动失败。 |
Note:
请使用-startoption选项指定启动模式，-m选项已过时，保留仅用于兼容。
# ycsctl stop instance
该命令用于关闭当前服务器上的数据库实例。
命令格式如下：
ycsctl stop instance
# ycsctl start pdb
该命令仅适用于容器数据库集群，用于在指定服务器上启动目标PDB的实例。
执行此命令前，必须保证数据库实例已经启动。
命令格式及参数介绍如下：
ycsctl start pdb -db db_unique_name -pdb pdb_name [-node nodename_list] [-startoption start_options] [-p wallet_password]
| 参数选项 | 取值 | 参数描述 |
|---|---|---|
| -db | db_unique_name | 指定待执行当前操作的目标数据库资源的唯一名称，必须是已存在的数据库资源。 可通过ycsctl show config命令查询当前集群的配置信息，其中Database unique name字段的值即为该名称。 |
| -pdb | pdb_name | 指定待启动的PDB名称。 |
| -startoption -m | NOMOUNT、MOUNT或OPEN | 可选参数，指定数据库实例默认的启动阶段选项，省略时默认使用ycsctl add pdb命令指定的启动选项。 |
| -node | nodename_list | 可选参数，指定PDB启动后需运行于哪些数据库实例（即服务器）上，多个实例名称间使用逗号（,）隔开，省略则表示PDB将运行于所有实例。可通过ycsctl show config命令查询当前集群的配置信息，其中Node name字段值即为实例节点名称。 |
在共享集群/分布式集群部署中，每个PDB可以运行多个实例（即可在每台服务器上启动0 - 1个实例）并发读写同一份数据。在实际使用中，可基于服务器资源状况、部分PDB高可用需求等因素，综合考虑均衡负载每个PDB的实例分布。
|
| -p | wallet_password | 可选参数，指定数据库实例进行密钥管理的钱包的密码。
当共享集群/分布式集群已有加密对象且需要直接启动数据库到MOUNT或OPEN模式时必须指定，否则数据库实例会启动失败。 | | |
Note:
请使用-startoption选项指定启动模式，-m选项已过时，保留仅用于兼容。
示例
# 在host0001服务器上启动PDB1
$ ycsctl start pdb -db yashandb -pdb pdb1 -node host0001 -startoption open
# ycsctl stop pdb
该命令仅适用于容器数据库集群，用于关闭目标PDB在当前服务器上的实例。
执行此命令前，必须保证数据库实例已经启动。
命令格式及参数介绍如下：
ycsctl stop pdb -db db_unique_name -pdb pdb_name
| 参数选项 | 取值 | 参数描述 |
|---|---|---|
| -db | db_unique_name | 指定待执行当前操作的目标数据库资源的唯一名称，必须是已存在的数据库资源。 可通过ycsctl show config命令查询当前集群的配置信息，其中Database unique name字段的值即为该名称。 |
| -pdb | pdb_name | 指定待关闭的PDB名称。 |
# ycsctl stop ycs
该命令用于停止当前服务器上的YCS，及其所管理的资源。
命令格式如下：
ycsctl stop ycs
# ycsctl start osw
该命令用于启动当前YCS的OS Watcher。
命令格式如下：
ycsctl start osw
# ycsctl stop osw
该命令用于停止当前YCS的OS Watcher。
Note:
关于YCS OS Watcher的详细介绍，请查阅操作系统负载监控。
命令格式如下：
ycsctl stop osw
# ycsctl start vip
该命令用于在当前YCS上启动VIP资源。
命令格式及参数介绍如下：
ycsctl start vip [-n node_name]
| 参数选项 | 取值 | 参数描述 |
|---|---|---|
| -n | node_name | 可选参数，指定需启动VIP资源的实例节点名，省略时默认启动当前节点的VIP资源。 |
# ycsctl stop vip
该命令用于在当前YCS上停止已接管的VIP资源。
命令格式及参数介绍如下：
ycsctl stop vip [-n node_name]
| 参数选项 | 取值 | 参数描述 |
|---|---|---|
| -n | node_name | 可选参数，指定需停止VIP资源的实例节点名，省略时默认启动当前节点的VIP资源。 |
# ycsctl relocate vip
该命令用于迁移指定的VIP资源到其他YCS节点。
命令格式及参数介绍如下：
ycsctl relocate vip -n home_node [-t node_name]
| 参数选项 | 取值 | 参数描述 |
|---|---|---|
| -n | home_node | 指定待迁移的目标VIP资源所属的实例节点名。 实例节点与VIP的对应关系可通过ycsctl show config查看。 |
| -n | node_name | 可选参数，指定VIP资源待迁往的目标节点名称，省略时YCS将按照高可用和均匀分布的原则自动迁移。 |
# ycsctl get
该命令用于查看当前服务器上YCS节点级参数项的值。
命令格式及参数介绍如下：
ycsctl get [parameter_name]
| 参数值 | 参数描述 |
|---|---|
| parameter_name | 指定待查看的参数名，大小写不敏感。 |
# ycsctl set [parameter_name] value
该命令用于在线设置当前服务器上YCS节点级参数项（非只读参数）的值。
Note:
对于AUTO_START，本命令仅修改其在配置文件中的值，实际生效还需重启YCS。
命令格式及参数介绍如下：
ycsctl set [parameter_name] value
| 参数值 | 参数描述 |
|---|---|
| parameter_name | 指定待修改的参数名，大小写不敏感。 |
| value | 指定为对应参数的取值范围中的某个值。 |
# ycsctl status
该命令用于查看当前集群的拓扑状态，默认以横表方式显示，显示的服务器数目等于部署的服务器数目。
命令格式及参数介绍如下：
ycsctl status [-v|vertical]
| 参数选项 | 参数描述 |
|---|---|
| -v -vertical | 可选参数，表示以竖表方式显示拓扑状态。 |
示例
$ ycsctl status
+--------------+-------------------+-----------------+---------------------------------------------+
| Self Host ID | Cluster Master ID | YasFS Master ID | Active Host Count |
+--------------+-------------------+-----------------+---------------------------------------------+
|1 |2 |2 |2 |
+--------------+-------------------+-----------------+---------------------------------------------+
+---------+---------+---------+---------+-------------+--------------------+--------------------+-----------+-----------+
| Host ID | Target | YCS | YFS | VIP | DB_NAME | PDB_NAME | DB_STATE | IS_MASTER |
+---------+---------+---------+---------+-------------+--------------------+--------------------+-----------+-----------+
|1 |online |online |online |host1.online |yashandb |cdb$root |online |FALSE |
| | | | | | +--------------------+-----------+-----------+
| | | | | | |pdb1 |online |FALSE |
| | | | | | +--------------------+-----------+-----------+
| | | | | | |yashancdb_pdb2 |online |FALSE |
| | | | | | +--------------------+-----------+-----------+
| | | | | | |yashancdb_pdb3 |online |TRUE |
+---------+---------+---------+---------+-------------+--------------------+--------------------+-----------+-----------+
|2 |online |online |online |host1.online |yashandb |cdb$root |online |TRUE |
| | | | | | +--------------------+-----------+-----------+
| | | | | | |pdb1 |online |TRUE |
| | | | | | +--------------------+-----------+-----------+
| | | | | | |yashancdb_pdb2 |online |TRUE |
| | | | | | +--------------------+-----------+-----------+
| | | | | | |yashancdb_pdb3 |offline |FALSE |
+---------+---------+---------+---------+-------------+--------------------+--------------------+-----------+-----------+
+---------------------------------------+---------------------------------------+---------------------------------------+
|SCAN VIP 1: host1.online |SCAN VIP 2: host2.online | |
+---------------------------------------+---------------------------------------+---------------------------------------+
$ ycsctl status -v
[cluster_information]
Self Host ID: 1
Cluster Master ID: 2
YasFS Master ID: 2
Active Host Count: 2
SCAN VIP 1: host1.online
SCAN VIP 2: host2.online
[host_information.host1]
Host ID: 1
Target: online
State: online
YasFS: online
VIP: host1.online
[database_information.yashancdb]
DB State: online
[database_information.pdb1]
DB State: online
[database_information.yashancdb_pdb2]
DB State: online
[database_information.yashancdb_pdb3]
DB State: online
[database_information.pdb_add2]
DB State: online
[host_information.host2]
Host ID: 2
Target: online
State: online
YasFS: online
VIP: host1.online
[database_information.yashancdb]
DB State: online(MASTER)
[database_information.pdb1]
DB State: online(MASTER)
[database_information.yashancdb_pdb2]
DB State: online(MASTER)
[database_information.yashancdb_pdb3]
DB State: offline
各项配置信息的介绍如下：
| 字段名 | 含义 |
|---|---|
| Self Host ID | 当前服务器ID。 |
| Cluster Master ID | YCS服务对应的主服务器ID。 |
| YasFS Master ID | YFS服务对应的主服务器ID。 |
| Active Host Count | 集群当前的活动服务器数。 |
| Host ID | 服务器ID。 |
| Target | 服务器启动时，表示数据库实例是否纳入YCS一起启动，根据参数AUTO_START而定，当AUTO_START=ALWAYS时，Target为online，当AUTO_START=NEVER时，Target为offline。 服务器停止时，恒为offline。 |
| YCS | YCS服务当前状态。 |
| YFS | YFS服务当前状态。 |
| VIP | 部署于此YCS节点的VIP资源的当前状态，格式为：<接管节点名.运行状态(IP地址:端口)>。 |
| DB_NAME | 数据库资源的名称。 |
| PDB_NAME | PDB的名称。 |
| DB_STATE | 数据库实例的当前状态。 |
| IS_MASTER | 是否为主库角色。 |
| SCAN VIP n | 当前YCS节点的SCAN VIP信息和运行状态，格式为：<SCAN VIP运行节点名.运行状态>。 |
# ycsctl status pdb
该命令用于查看目标PDB的信息。
命令格式及参数介绍如下：
ycsctl status pdb -db db_unique_name -pdb pdb_name
| 参数选项 | 取值 | 参数描述 |
|---|---|---|
| -db | db_unique_name | 指定待执行当前操作的目标数据库资源的唯一名称，必须是已存在的数据库资源。 可通过ycsctl show config命令查询当前集群的配置信息，其中Database unique name字段的值即为该名称。 |
| -pdb | pdb_name | 指定待查看的PDB名称。 |
示例
$ ycsctl status pdb -db yashandb -pdb pdb1
+-------------------+---------------------------------+---------------------------+-------------------------------------+
| Self Host ID | Cluster Master ID | YasFS Master ID | Active Host Count |
+-------------------+---------------------------------+---------------------------+-------------------------------------+
|1 |1 |1 |2 |
+-------------------+---------------------------------+---------------------------+-------------------------------------+
+---------+---------+---------+---------+-------------+--------------------+--------------------+-----------+-----------+
| Host ID | Target | YCS | YFS | VIP | DB_NAME | PDB_NAME | DB_STATE | IS_MASTER |
+---------+---------+---------+---------+-------------+--------------------+--------------------+-----------+-----------+
|1 |online |online |online | |yashandb |pdb1 |online |TRUE |
+---------+---------+---------+---------+-------------+--------------------+--------------------+-----------+-----------+
|2 |online |online |online | |yashandb |pdb1 |online |FALSE |
+---------+---------+---------+---------+-------------+--------------------+--------------------+-----------+-----------+
各项配置信息的介绍如下：
| 字段名 | 含义 |
|---|---|
| Self Host ID | 当前服务器ID。 |
| Cluster Master ID | YCS服务对应的主服务器ID。 |
| YasFS Master ID | YFS服务对应的主服务器ID。 |
| Active Host Count | 集群当前的活动服务器数。 |
| Host ID | 服务器ID。 |
| Target | 服务器启动时，表示数据库实例是否纳入YCS一起启动，根据参数AUTO_START而定，当AUTO_START=ALWAYS时，Target为online，当AUTO_START=NEVER时，Target为offline。 服务器停止时，恒为offline。 |
| YCS | YCS服务当前状态。 |
| YFS | YFS服务当前状态。 |
| VIP | 部署于此YCS节点的VIP资源的当前状态，格式为：<接管节点名.运行状态(IP地址:端口)>。 |
| DB_NAME | 数据库资源的名称。 |
| PDB_NAME | PDB的名称。 |
| DB_STATE | 数据库实例的当前状态。 |
| IS_MASTER | 是否为主库角色。 |
| SCAN VIP n | 当前YCS节点的SCAN VIP信息和运行状态，格式为：<SCAN VIP运行节点名.运行状态>。 |
# ycsctl show parameter
该命令用于查看当前服务器上所有YCS节点级参数项的配置。
命令格式如下：
ycsctl show parameter
# ycsctl show fence
该命令用于查看集群所有服务器是否有权限读写数据盘，需要YCSRA进程在线以提供查询服务。
命令格式如下：
ycsctl show fence
示例
$ ycsctl show fence
Fence Type: SCSI I/O Fencing
----------------------
Host ID |Permission
0 ALLOW
1 BAN
2 ALLOW
3 ALLOW
各项配置信息的介绍如下：
| 字段名 | 含义 |
|---|---|
| Fence Type | 当前集群使用的I/O Fencing类型。 |
| Host ID | 服务器ID。 |
| Permission | 服务器访问数据盘的权限，包括：ALLOW（可读写）、BAN（不可写）以及UNDEFINED（未定义）。 |
# ycsctl query disk
该命令用于查看SYSTEM磁盘组的信息。
命令格式如下：
ycsctl query disk
示例
$ ycsctl query disk
ID |STATUS |PATH |DG
0 ONLINE /dev/yfs/sdd SYSTEM
1 ONLINE /dev/yfs/sdc SYSTEM
2 ONLINE /dev/yfs/sdf SYSTEM
各项配置信息的介绍如下：
| 字段名 | 含义 |
|---|---|
| ID | SYSTEM磁盘组中磁盘的序号。 |
| STATUS | SYSTEM磁盘组中磁盘的状态。 |
| PATH | SYSTEM磁盘组中磁盘的路径。 |
| DG | SYSTEM磁盘组的名称。 |
下载文档
复制链接
