#节点管理命令

# ycsctl start ycs

该命令用于启动当前服务器上的YCS，及其所管理的资源（是否启动YashanDB资源由AUTO_START参数控制），命令格式如下：

ycsctl start ycs [-F]

-F

初始化模式，带上此参数会同时初始化数据盘，如数据盘已存在数据，将全部被破坏，请谨慎使用。

# ycsctl start instance

该命令用于启动当前服务器上的数据库实例，命令格式如下：

ycsctl start instance

执行此命令前，必须保证YCS已经启动。

# 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 get <parameter>

该命令用于查看当前服务器上的配置参数值，命令格式如下：

ycsctl get <parameter>

parameter

参数名称，来自于YCS所允许的配置参数，当前可指定查询如下参数：

AUTO_START
LOG_LEVEL
LOG_NUMBER
LOG_SIZE
RESTART_TIMES
RESTART_INTERVAL
WAIT_STOP_FIN_TIME

# ycsctl set <parameter> value

该命令用于在线设置当前服务器上的配置参数，命令格式如下：

ycsctl set <parameter> value

parameter

参数名称，来自于YCS所允许的配置参数，当前可指定设置如下参数：

AUTO_START
LOG_LEVEL
LOG_NUMBER
LOG_SIZE
RESTART_TIMES
RESTART_INTERVAL
WAIT_STOP_FIN_TIME

说明：AUTO_START只修改配置文件中的值，实际生效需要重启YCS。

value

目标参数值，必须为YCS所允许范围内的值，见YCS配置参数所述。

# ycsctl status

该命令用于查看当前集群的YCS拓扑状态，以横表方式显示，显示的服务器数目等于部署的服务器数目，命令格式如下：

ycsctl status

示例

$ 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
-----------------------------------------------------------------------------------------
1          online     online     online     online
2          online     online     online     online

# ycsctl status vertical

该命令用于查看当前集群的YCS拓扑状态，以竖表方式显示，显示的服务器数目等于部署的服务器数目，命令格式如下：

ycsctl status vertical

示例

$ ycsctl status vertical
[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

[host_information.host2]
Host ID: 2
Target: online
State: online
YasFS: online
YasDB: 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

数据库实例的当前状态。

# 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
YCR_DISK            /dev/mapper/storraid10

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