#节点管理命令

# 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:

  • YCS通过执行脚本来启停数据库实例,脚本保存的路径为$YASCS_HOME/scripts/,脚本名称可通过"ycsctl show config"命令查询。
  • 关闭数据库实例的脚本内容通常是:yasql登录到数据库实例并执行"shutdown immediate"命令。为了提高安全性,推荐完成操作系统认证配置并通过yasql免密登录
  • 通过yasboot安装部署共享集群时,yasboot工具会自动完成上述配置并生成免密登录的执行脚本。

# 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

磁盘组的名字。

如上参数的具体描述见共享集群配置章节。

edit-icon
反馈
coperate-icon
coperate
合作
communication-icon
communicate
交流