#节点管理命令
# ycsctl start ycs
该命令用于启动当前服务器上的YCS，及其所管理的资源（是否启动YashanDB资源由AUTO_START参数控制；数据库实例启动模式由可选参数-m控制），命令格式如下：
ycsctl start ycs [-m mode] [wallet_password]
mode
指定数据库实例的启动模式，可选值为NOMOUNT、MOUNT或OPEN，省略时默认为OPEN。
wallet_password
指定数据库实例进行密钥管理的钱包的密码。当共享集群/分布式集群已有加密对象且需要直接启动数据库到MOUNT或OPEN模式时必须指定，否则数据库实例会启动失败。
# ycsctl start instance
该命令用于启动当前服务器上的数据库实例，可选参数-m指定数据库启动模式，命令格式如下：
ycsctl start instance [-m mode] [-p wallet_password]
执行此命令前，必须保证YCS已经启动。
mode
指定数据库实例的启动模式，可选值为NOMOUNT、MOUNT或OPEN，省略时默认为OPEN。
wallet_password
指定数据库实例进行密钥管理的钱包的密码。当共享集群/分布式集群已有加密对象且需要直接启动数据库到MOUNT或OPEN模式时必须指定，否则数据库实例会启动失败。
# ycsctl stop instance
该命令用于关闭当前服务器上的数据库实例，命令格式如下：
ycsctl stop instance
Note:
# ycsctl start pdb
该命令仅适用于容器数据库集群，用于在当前服务器上启动目标PDB的实例，命令格式如下：
ycsctl start pdb -db db_unique_name -pdb pdb_name [-m mode] [-p wallet_password]
执行此命令前，必须保证数据库实例已经启动。
-db
目标PDB所在数据库的名称，应指定为该数据库在当前集群中的唯一名称。
可通过ycsctl show config命令查询当前集群的配置信息，其中Database unique name字段的值即为该名称。
-pdb
已存在的PDB名称。
mode
指定数据库实例的启动模式，可选值为NOMOUNT、MOUNT或OPEN，省略时默认为OPEN。
wallet_password
指定数据库实例进行密钥管理的钱包的密码。当共享集群已有加密对象且需要直接启动数据库到MOUNT或OPEN模式时必须指定，否则数据库实例会启动失败。
示例
$ ycsctl start pdb -db yashandb -pdb pdb1
# ycsctl stop pdb
该命令仅适用于容器数据库集群，用于关闭目标PDB在当前服务器上的实例，命令格式如下：
ycsctl stop pdb -db db_unique_name -pdb pdb_name
执行此命令前，必须保证数据库实例已经启动。
-db
目标PDB所在数据库的名称，应指定为该数据库在当前集群中的唯一名称。
可通过ycsctl show config命令查询当前集群的配置信息，其中Database unique name字段的值即为该名称。
-pdb
已存在的PDB名称。
示例
$ ycsctl stop pdb -db yashandb -pdb pdb1
# ycsctl stop ycs
该命令用于停止当前服务器上的YCS，及其所管理的资源，命令格式如下：
ycsctl stop ycs
# ycsctl start osw
该命令用于启动当前YCS的OS Watcher，命令格式如下：
ycsctl start osw
# ycsctl stop osw
该命令用于停止当前YCS的OS Watcher，命令格式如下：
ycsctl stop osw
Note:
关于YCS OS Watcher的详细介绍，请查阅操作系统负载监控。
# ycsctl start vip
该命令用于在当前YCS上启动VIP资源，命令格式如下：
ycsctl start vip [-n name]
-n
待启动的VIP资源的部署节点名，未指定时默认启动当前YCS节点配置的VIP资源。
# ycsctl stop vip
该命令用于在当前YCS上停止已接管的VIP资源，命令格式如下：
ycsctl stop vip [-n name]
-n
待停止的VIP资源的部署节点名，未指定时默认停止当前YCS节点所有已接管的VIP资源。
# ycsctl relocate vip
该命令用于迁移指定的VIP资源到其他YCS节点，命令格式如下：
ycsctl relocate vip -n name1 [-t name2]
-n
待迁移的VIP资源的部署节点名，必须指定。
-t
迁移的目标节点名，未指定时YCS将按照高可用和均匀分布的原则自动迁移。
# ycsctl get
该命令用于查看当前服务器上的配置参数值，命令格式如下：
ycsctl get [parameter_name]
parameter_name
参数名称，来自于YCS所允许的配置参数，当前可指定查询如下参数：
- AUTO_START
- LOG_LEVEL
- LOG_NUMBER
- LOG_SIZE
- RESTART_TIMES
- RESTART_INTERVAL
- WAIT_STOP_FIN_TIME
- OSW_AUTO_START
- OSW_INTERVAL
- OSW_FILE_NUM
- OSW_FILE_SIZE
# ycsctl set [parameter_name] value
该命令用于在线设置当前服务器上的配置参数，命令格式如下：
ycsctl set [parameter_name] value
parameter
参数名称，来自于YCS所允许的集群参数，当前可指定设置如下参数：
- AUTO_START
- LOG_LEVEL
- LOG_NUMBER
- LOG_SIZE
- RESTART_TIMES
- RESTART_INTERVAL
- WAIT_STOP_FIN_TIME
- OSW_AUTO_START
- OSW_INTERVAL
- OSW_FILE_NUM
- OSW_FILE_SIZE
说明：AUTO_START只修改配置文件中的值，实际生效需要重启YCS。
value
目标参数值，必须为YCS所允许范围内的值，详情请查阅集群参数配置。
# ycsctl status
该命令用于查看当前集群的拓扑状态，默认以横表方式显示，显示的服务器数目等于部署的服务器数目，命令格式如下：
ycsctl status [-v|vertical]
-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
服务器停止时，恒为offline。
服务器启动时，表示数据库实例是否纳入YCS一起启动，根据参数AUTO_START而定，当AUTO_START=ALWAYS时，Target为online，当AUTO_START=NEVER时，Target为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
目标PDB所在数据库的名称，应指定为该数据库在当前集群中的唯一名称。
可通过ycsctl show config命令查询当前集群的配置信息，其中Database unique name字段的值即为该名称。
-pdb
已存在的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 |
+---------+---------+---------+---------+-------------+--------------------+--------------------+-----------+-----------+
# ycsctl show parameter
该命令用于查看YCS的配置参数信息，命令格式如下：
ycsctl show parameter
示例
$ ycsctl show parameter
Name Value
------------------- ----------------------
AUTO_START NEVER
LOG_LEVEL INFO
LOG_NUMBER 10
LOG_SIZE 20MB
RESTART_TIMES 3
RESTART_INTERVAL 30s
WAIT_STOP_FIN_TIME 90s
OSW_AUTO_START ON
OSW_INTERVAL 20s
OSW_FILE_NUM 20
OSW_FILE_SIZE 20MB
YCR_FILE_NAME +SYSTEM/ycr
VOTING_FILE_NAME +SYSTEM/voting
# 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
集群配置的FENCE_TYPE的具体说明。
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
磁盘组的名字。
如上参数的具体描述见集群参数配置章节。
下载文档
复制链接
