使用bcmtool

bcmtool用于对BCM ZooKeeper中的全局缓存集群及加速pool等信息进行配置、查询等操作，主要功能包括：

对全局缓存集群进行增删。
对加速pool进行增删。
导入导出xml文件。
查询加速pool信息。
查询告警信息。
查询ZooKeeper集群状态。

bcmtool通过安装全局缓存闭源包获取，支持分别在服务端和客户端使用，为进行区分，工具又细分为bcmtool_s（服务端）和bcmtool_c（客户端）。

bcmtool的启动命令如下。

服务端：

export LD_LIBRARY_PATH=/opt/gcache/lib
/opt/gcache/bin/bcmtool_s

客户端：

export LD_LIBRARY_PATH=/opt/gcache_adaptor_compile/third_part/lib
/opt/gcache_adaptor_compile/third_part/bin/bcmtool_c

bcm.xml文件参考

“/opt/gcache/conf/bcm.xml”用于配置bcmtool管理的集群信息，其配置格式如下。

<?xml version="1.0"?>
<bcm zk_server_list="ceph1:2182,ceph2:2182,ceph3:2182">
    <cluster id="1" zk_server_list="ceph1:2181,ceph2:2181,ceph3:2181">
        <pool id="751">
        </pool>
    </cluster>
</bcm>

文件中各标签说明请见表1。

表1 bcm.xml文件标签释义
标签	属性	含义
bcm	zk_server_list	BCM ZooKeeper服务集群的节点列表，每个节点由主机名+端口号组成，集群新增或移除节点时需更新此项配置。
cluster	id	全局缓存集群的ID，范围[1,4]。目前最多支持4个全局缓存集群，新增集群时在BCM新增一个cluster子标签。
cluster	zk_server_list	全局缓存集群的CCM ZooKeeper集群节点列表。
pool	id	Ceph pool的ID。新增pool时在某个ZooKeeper集群下增加子pool标签，填写对应ID。新增pool前请保证其为空数据。

bcmtool命令参考

当前支持的命令行如下表，其中bcm_tool在客户端与服务端下分别为bcmtool_c及bcmtool_s，方括号[]为必选参数，()为可选参数。

命令格式	说明	输入要求
bcm_tool import	读取xml配置文件并将添加到BCM ZooKeeper集群。配置文件目录：“/opt/gcache/conf/bcm.xml”	-
bcm_tool export (filename)	导出BCM ZooKeeper集群配置信息并输出为xml格式。导出文件目录：“/opt/gcache/conf/(filename)”	(filename)缺省时为“bcm_export.xml”。
bcm_tool addpool [poolId] [clusterId]	添加pool至指定集群，并更新至BCM ZooKeeper。	[poolId]为未添加至集群的pool ID，该pool存在于Ceph且为空。 [clusterId]为已存在的集群ID。
bcm_tool delpool [poolId]	查找集群中的指定pool进行删除，并更新至BCM ZooKeeper。	[poolId]为已存在于BCM ZooKeeper的pool ID，且该pool为空。
bcm_tool addcluster [clusterId] [serverlist]	添加集群，指定服务器列表serverlist，并更新至BCM ZooKeeper。	[clusterId]取值范围为1~4。 [serverlist]格式形示例：ceph1:2181,ceph2:2181,ceph3:2181 主机名与端口号可根据环境配置进行调整。
bcm_tool delcluster [clusterid]	删除指定集群，并更新至BCM ZooKeeper。	[clusterId]为已存在的集群ID，且其中的pool均为空。
bcm_tool delall	删除全部集群，并更新至BCM ZooKeeper。	-
bcm_tool qryccm [poolId]	根据pool ID查询其所在集群的CCM IP并输出显示。	[poolId]为已添加至合法集群的pool ID。
bcm_tool qrypools [clusterId]	查找指定集群下所属的pool列表并输出显示。	[clusterId]为已存在的集群ID。
bcm_tool alarmall [clusterId]	查询全部告警信息并输出显示。	[clusterId]为已存在的集群ID。
bcm_tool alarmlevel [clusterId] [level]	查询指定告警等级的告警信息并输出显示。	[clusterId]为已存在的集群ID。 [level]为ERROR或WARN。
bcm_tool alarmcomp [cluster] [component]	查询指定组件的告警信息并输出显示。	[clusterId]为已存在的集群ID. [component]为“node/disk/network/logsystem”。
bcm_tool alarmlimit [cluster]	查询最大告警数量并输出显示。	[clusterId]为已存在的集群ID。
bcm_tool showZkStatus	查询BCM ZooKeeper和CCM ZooKeeper的集群状态。	-

bcmtool告警信息参考

支持的告警信息：

告警形式	告警说明	告警级别	组件类型
temporarily faulty and cannot provide services temporarily.	节点临时故障	ERROR	NODE
permanently faulty and removed from the cluster.	节点永久故障	ERROR	NODE
disk is faulty.	磁盘故障	ERROR	DISK
disk capacity of the ceph pool reaches 80%.	Ceph pool磁盘容量到达80%	WARN	DISK
disk capacity of the ceph pool is insufficient.	Ceph pool磁盘容量满了	ERROR	DISK
disk capacity of the log system reaches 80%.	日志空间容量到80%	WARN	DISK
disk capacity of the log system is insufficient.	日志空间容量满了	ERROR	DISK
the network connection is abnormal.	网络异常	ERROR	NETWORK
failed to open the log file.	日志文件打开失败	WARN	LOGSYSTEM
failed to write the log file.	日志文件写入失败	WARN	LOGSYSTEM
failed to rename the log file.	日志文件重命名失败	WARN	LOGSYSTEM
failed to remove the log file.	日志文件移除失败	WARN	LOGSYSTEM
the disk has fault state pt.	磁盘有异常状态pt	ERROR	DISK
disk is slow.	磁盘慢盘故障	ERROR	DISK

父主题： 特性使用