#节点管理命令
# 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 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所允许范围内的值,见YCS配置参数所述。
# ycsctl status
该命令用于查看当前集群的拓扑状态,默认以横表方式显示,显示的服务器数目等于部署的服务器数目,命令格式如下:
ycsctl status [-v|vertical]
-v|vertical
可选项,指定-v(或vertical)时将以竖表方式显示拓扑状态。
示例
$ ycsctl status
---------------------------------------------------------------------------------------------
Self Host ID|Cluster Master ID|YasFS Master ID|YasDB Master ID|Active Host Count
---------------------------------------------------------------------------------------------
1 1 1 1 2
---------------------------------------------------------------------------------------------
Host ID |Target |State |YasFS |YasDB |VIP
---------------------------------------------------------------------------------------------
1 online online online online host1.online
2 online online online online host2.online
---------------------------------------------------------------------------------------------
SCAN VIP 1: host2.online SCAN VIP 2: host1.online SCAN VIP 3: host1.online
$ ycsctl status -v
[cluster_information]
Self Host ID: 1
Cluster Master ID: 1
YasFS Master ID: 1
YasDB Master ID: 1
Active Host Count: 2
[host_information.host1]
Host ID: 1
Target: online
State: online
YasFS: online
YasDB: online
VIP: host1.online
[host_information.host2]
Host ID: 2
Target: online
State: online
YasFS: online
YasDB: online
VIP: host1.online
Self Host ID
当前服务器ID。
Cluster Master ID
YCS服务对应的主服务器ID。
YasFS Master ID
YFS服务对应的主服务器ID。
YasDB Master ID
数据库实例对应的主服务器ID。
Active Host Count
集群当前的活动服务器数。
Host ID
服务器ID。
Target
服务器停止时,恒为offline。
服务器启动时,表示数据库实例是否纳入YCS一起启动,根据参数AUTO_START而定,当AUTO_START=ALWAYS时,Target为online,当AUTO_START=NEVER时,Target为offline。
State
YCS服务当前状态。
YasFS
YFS服务当前状态。
YasDB
数据库实例的当前状态。
VIP
部署于此YCS节点的VIP资源的当前状态,格式为:<接管节点名.运行状态(IP地址:端口)>。
SCAN VIP n
当前YCS节点的SCAN VIP信息和运行状态,格式为:<SCAN VIP运行节点名.运行状态>。
# ycsctl show parameter
该命令用于查看YCS的配置参数信息,命令格式如下:
ycsctl show parameter
示例
$ ycsctl show parameter
Name Value
------------------- ----------------------
AUTO_START NEVER
LOG_LEVEL DEBUG
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
磁盘组的名字。
如上参数的具体描述见共享集群配置章节。

