hb_report 简单建模

hb_report crmsh suse实习

确定参与者

• 集群节点

hb_report执行流程

检查并解析参数

• 参数是边解析边检查，如果用户输入了不能解析的参数或者输入了多余的参数，调用usage函数打印提示信息并退出。创建work directory(测试创建是否成功)，
• 获取pacemaker daemon等一些 directory（shell函数名是compatibility_pcmk，hb_report line 271）
• 获取cluster type（用户输入或者自己found out）
• 记录需要收集信息的文件名（hb_report line 1340）
• 获取需要收集信息的node（utillib.sh line 42 getnodes()）（允许用户指定收集某些节点的信息）和node数目。如果不指明node list，缺省值是全部节点（缺省时候需要打印提示信息提示用户使用-n参数）。

ssh相关工作

• 找到ssh用户：如果用户指定了ssh用户，测试是否能连接。如果用户没有指定ssh用户，尝试使用root登陆
• test ssh是否可用
• master节点收集analyze.txt等信息
• collector节点如何压缩出来的tarball不清楚，等会在collector节点上运行时候仔细看。

在对应的节点上得到相应log

• master节点开始收集Collector.g节点的log：测试collector节点ssh是否需要密码，开始收集collector节点的log（通过ssh到节点上运行hb_report __collector收集）。如果此节点不需要password，创建新进程后台运行收集collector节点的信息，父进程等待子进程退出（这里多进程运行为了提高收集信息的速度，如果有10个节点需要收集信息，可以创建10个进程，这样会节省很多时间）。

收尾工作

• 当每一个节点信息都收集完成后（每一个负责收集信息进程都已经结束），创建新进程分析收集到的log文件
• 检查收集到的log文件是否为空
• 等待所有子进程结束
• 查看是否需要压缩，需要则压缩在指定目录下。如果不需要，则移动到指定目录下
• 打印提示信息

hb_report实现参数

• -d：不要压缩得到的结果
• -f: 开始时间
• -t：结束时间
• -n：节点列表。多个节点有两个使用方法（）：-n node1 -n node2或者 -n "node1 node2"
• -l：log file的路径（绝对路径）
• -E：要收集的其他文件，
• -M：不要从journalctl中收集log（不明白从哪里收集？）
• -L：
• -p：
• -Q：快速收集（不收集很耗时的informations）
• -A：这是一个OpenAIS集群（不明白OpenAIS是什么？）
• -u：指明ssh的user name，默认是先不用user登陆，如果失败使用root，最后使用hacluster。
• -X：指明ssh的option
• -S：只收集运行hb_report节点的information
• -Z：如果指定目标目录已经存在，删除目录然后重新生成一个
• -V：打印最后一次升级
• -v：详细程度。常用来表示这是一个debug level的收集，收集出来的信息详细一些。
• -h：打印提示信息和运行示例
• -e：指定编辑器
• -C：
• -D：

hb_report模块划分

按照数据模型进行模块划分的主要步骤

• 根据系统框架抽象出系统的核心数据模型；
• 根据核心数据模型将系统功能细化，并将数据模型与视图等剥离，细化数据的流向；
• 依据数据的流向制定模块和接口，完成模块划分。

定义类

node类

master节点和collector节点的父类，抽象了每个节点的共性。

成员变量描述

成员函数描述

master类

描述master节点特性的类，继承了node类

成员变量描述

注：
1.假设这样一个场景，用户并不是以root身份运行hb_report，这是被允许的。但是当需要ssh到collector节点上时，要求使用root用户，因为收集使用journalctl收集信息要求是root用户。因此在测试ssh之前，需要测试当前用户是否是root用户，如果不是root用户，需要保存切换到root用户命令，SUDO保存ssh到collector节点时候切换root用户命令，LOCAL_SUDO保存收集master节点时候切换到root用户的命令

成员函数描述

注：
1.collector节点都是复制的master节点（不是copy master节点的标志都定义在了collector类中），因此获取这些变量值是在master类中
2.master类创建的WORKDIR是是$tmpdir/$DEST（DEST是用户输入的生成report name）
3.start_collect函数只是开始收集动作并触发收集函数，真正收集的是collector类中的collect_info函数，所有信息的收集都是collector类的collect_info方法完成。此方法通过node类型（collector节点或者master节点）
4.创建新线程运行analyzed和events方法
5.如果cluster node不需要password，为了提升性能创建新进程分别去收集各个节点log，父进程等待子进程结束。
6.在master node上为envir成员变量每个成员赋值，然后用send_envir方法创建对应的xml文件，并使用socket发送给collector node（可以传送xml字符串或者对应的xml文件）。
7.需要创建一个init方法是有一个成员变量是另一个类的实例，因此需要在init方法中给这个成员赋值，
8.

collector类

描述collector节点特性的类，继承了node类

成员变量描述

注：
1.此成员为了保存envir类的实例中存储的一些环境变量，收集信息需要用到这些变量。

成员函数描述

注：
1.collector类创建的的WORKDIR是$tmpdir/$DEST/$WE，创建动作完成后需要测试结果
2.collector node返回结果给master节点时候，打成tarball，通过流或者其他方式返回给master节点，master节点再解压缩（压缩是为了降低网络造成的瓶颈）。
3.master node ssh到collector node，实例一个对象，然后执行collector类的某个函数（此处存疑，不确定是执行collector脚本还是执行某一个入口函数）
4.collector类和master类都有一个成员是envir的实例，为了保存整个hb_report运行过程中的每一个全局的环境变量。
5.需要实现一个collector脚本，这个脚本就是调用collector类的run函数

envir类

关于定义为模块还是类存疑：模块可以作为一个全局参数不用在每个类和函数之间传递，但是模块在各个节点之间共享麻烦;类可以当作参数从一个节点传递到另外一个节点，但是类在对成员变量修改的函数必须作为参数传递进去，这个还要斟酌一下

根据不同的参数需要设置的不同的全局变量，以及一些其他的标志变量。倾向于把这些变量全部放在同一个类中，这样结构简单。envir类是每个节点都需要一份，因此在调用collector节点上hb_report之前，需要先复制这些变量。

成员变量及描述

| 成员变量|描述|相关|缺省值|

成员函数及描述

类图

注意事项

• 在Collector.g节点上的变量COLLECTOR是1,Master节点上COLLECTOR变量是0.因此在Slave节点上test COLLECTOR结果是true。
• 如果用户指明了打成一个tarball，
• 不明白为什么不根据用户输入的时间去log中匹配，需要转换以下这个时间
• -f参数的CTS表示什么意思？
• 还是使用ssh登陆到collector节点，创建一个collector类的实例，运行起来收集节点的log。因此要注意的是collector类也需要实现一个main模块。
• 为了类的定义更加精简（避免两个类有方法功能重复），信息收集都是collector类的collect_info方法完成的，即便是master节点的信息收集也是。

集群文件系统和分布式文件系统的区别：
集群文件系统管理的是一块共享盘，实际上是同一块盘，并且数据都是一样的，集群文件系统因为要互斥每个节点对share storage的读写访问，需要使用DLM加锁。分布式文件系统管理的是每个pc下的不同的盘。