bit_Qt用户手册
Last updated
Last updated
BIT软件提供LRU集中管理/集中监控功能。
通过将LRU组合为视图，可计算和展示系统整体的健康状态。
BIT软件采用SqlLite数据库存储用户的配置数据，每个不同的项目对应一个不同的.db文件。
初次运行bit软件时，使用者将进行项目的选择，如下图所示。
选择项目对应的db文件后，即可进入BIT软件进行该项目相关的操作。
如果勾选“设为默认”选项，则下次打开软件不进行项目选择，直接进入默认项目。
如果需要再次更改默认项目的选择，可在软件路径下./db/dbConfig.ini文件中将default参数更改为0即可。
点击“管理”→“基础信息”，进入基础配置页面，在基础配置页面可以设置软件的运行模式和数据监听。
BIT软件客户端支持三种运行模式，更改运行模式后重启软件，软件会按照指定的模式运行。
运行模式
功能
管理端
可进行软件各项功能的配置。
展示端
展示配置后的树形结构，以及LRU运行情况。
单页展示
展示某个视图，配置时需要指定展示的视图。
BIT软件支持通过3种方式监听LRU数据，并且都配置有监听的开关。
客户端形式与监听配置如下图所示
LRU是BIT软件从外部获取数据的最小单元。系统中LRU的列表如下图
LRU可以通过手动添加或文件导入两种形式录入系统，手动添加表单如下图
表单内容
含义
名称
该LRU的名称，方便使用者区分不同LRU
通讯类型
该LRU数据监听的来源，有三个选项
1. UDP
2. Redis
3. UDP组播
通讯标识
该LRU的唯一标识符，BIT软件接受外部数据时采用此字段识别LRU
备注
描述性信息，在进行LRU批量操作时可以根据备注进行检索
检测项
LRU中的可检测项，数量为0-32个
LRU导入文件模板
树形结构就像操作系统的文件目录一样，由文件夹和文件组成。
其中，文件夹类似于BIT种的视图，可以作为其他视图和LRU的容易，可以进行绘图和展示。而文件就类似于LRU，不能再包含其他内容，不过可以通过接口获取LRU真实状态。
树形结构展示在树形配置菜单的左侧，点击左侧节点即可查看详细状态，并且进行相应的操作。树形结构菜单如下图所示（以物理结构图为例，逻辑结构图配置相同）
子视图创建，首先要选择父文件夹，点选父文件夹后点击添加视图按钮，即可弹出添加子视图表单。如下图所示
在视图中可以关联LRU，关联后的LRU会成为该视图的子节点。
先点选视图，再点击关联LRU按钮，即可弹出LRU关联表单。可以通过多选的形式一次关联多个LRU，可以对每个LRU设置权重值和权重分组。可以支持按照名称或备注模糊搜索LRU。表单如下图所示
在BIT系统中，以根视图作为根节点，每一个视图和LRU都拥有唯一的编号。视图和LRU在树形结构中根据序列号排序。视图层级越深，编号长度越长，每增加一个视图深度，就增加四位十进制的序列号。
编号的操作是BIT软件自动完成的，用户无需直接操作编号。
BIT软件给用户提供了一些排序或改变树形结构的功能。包括上移/下移/剪切/粘贴
上下移功能可以改变选中节点在当前视图下的序列号
剪切粘贴功能可以将选中视图或者LRU移动到另一个视图中 序列号展示和操作菜单如下图所示
在BIT软件中，“视图”具有三种含义：
在真实世界里，“视图”对应的是真实的容器，例如机柜，机房。容器的内部可以有其他容器，或者LRU
在树形结构中，“视图”可以类比成文件系统中的文件夹，文件夹中可以放置子文件夹或者文件（LRU）
在展示客户端中，“视图”是一个可以展示的单元，经过配置的视图可以展示其中的子视图与LRU的组成，位置信息，健康信息等。
视图的展示样式需要经过软件使用者的配置，下面是配置步骤。
每张视图都可以配置为展示的画布，在进行视图内容的配置之前，需要先配置视图的尺寸和背景。
在树形菜单页面选择视图，点击“尺寸背景”按钮，即可进行视图的背景编辑。
可以在弹出的表单中编辑视图的宽度高度，背景色，或上传背景图片。
操作表单如下图所示
视图背景设置完成后，点击“页面布局”按钮，即可进入视图内容编辑界面。
在界面中，我们可以看到之前配置的背景尺寸与背景色已经生效。
视图内容编辑界面如下图所示
上图中的三个红色区域有各自不同的作用
绘图菜单，可以进行绘图元素的添加，快捷操作，保存或退出等
画板区，展示实际的绘图结果，所见即所得。可以使用拖动的方式更改元素的位置和大小。
元素菜单，对于一个选定的元素，该区域会展示选定元素的基本信息，并且提供功能操作菜单。
在画板区，我们看到若干可拖动的LRU或子视图。这些元素在树型结构中是本视图的子集，所以在图形展示中直接被放置在了画布上。左键选中一个LRU或者子视图，我们可以进行各种样式编辑工作
操作名称
操作方法
位移
1.直接拖动元素
2.点击右侧“修改尺寸”按钮
3.使用键盘方向键
缩放
1.拖动元素右下角红色角标
2.点击右侧“修改尺寸”按钮
更改图标
点选元素，点击右键菜单“选择图例”按钮
设置名称样式
点选元素，点击右键菜单“名称样式”按钮
视图与LRU元素的各项操作表单与功能可参考下面几张表单截图
注意：在视图编辑界面不可删除LRU或者子视图，因为他们继承于树形结构。如果需要删除只能在树形结构菜单中删除。
在BIT软件中，我们内建了其他5种基础绘图元素，用来辅助图形的绘制。它们分别是：
箭头
矩形
文本
连线
外部图片
各种绘图元素都通过左侧绘图菜单创建，可以通过拖拽更改大小和尺寸。拥有自己的特殊功能菜单，在此不再详细介绍。灵活使用多种绘图元素，可以让我们的视图更加具有视觉效果。绘制后的效果展示如下
实际操作中，经常出现多个同类的元素，在视图上需要展示为共同的大小，并排列。
为了简化尺寸设置的复杂操作，BIT软件提供了对齐和尺寸复制两种功能。
功能
操作
结果
尺寸复制
1.点选某个元素，点击尺寸复制按钮
2.多选需要操作的元素，点击尺寸粘贴按钮
所有被选中的元素具有了同样的尺寸
水平对齐
多选多个元素，点击水平对齐
所有元素排在同一水平线上
垂直对齐
多选多个元素，点击垂直对齐
所有元素排在同一垂直线上
视图的隐藏/显示功能，是为了满足如下场景需求出现的。
例如：有一个父视图机柜，机柜内有子视图机箱，机箱内有若干LRU，关系如图：
这种树形结构，是符合现实情况的，在我们软件后续运行并进行健康度计算的时候，也能得到正确的结果。
但这种树形结构会带来一个问题，如果我们将机柜作为展示画布，我们在机柜中只能看到机箱，无法看到机箱中的LRU（因为机箱是另一个视图）。
用户需要点进每一个机箱才能看到LRU的状况，使用中十分不灵活。我们需要的是用户可以在机柜视图中直接看到机柜内所有的机箱以及内部LRU的情况。
上述场景的根本情况，是因为真实世界的包含结构与我们需要展示的结构并不相同。在真实世界中，包含结构是这样的：
机柜→机箱→LRU
但在展示需求上，需要展示的内容是这样的
机柜→(机箱和LRU)
为了解决这种问题，可以采用BIT软件提供的视图隐藏/显示功能。
右键点击树形结构中的视图，在弹出菜单中单击“隐藏”按钮，之后在树形菜单中可以看到该视图名称变为灰色。
处于隐藏状态的视图，会将自己和自己的子节点（包括视图和LRU）全部绘制到自己的父节点中。
在上面的场景中，只需将机箱设置为隐藏属性，就可以在机柜视图中直接绘制机箱以及其中的LRU，如下图
如果想取消隐藏设置，只需在属性菜单中右键点击视图，单击“显示”按钮即可
被隐藏的视图依然作为一个元素在父级的画板中显示，例如上图中的机箱
隐藏属性是可以递归的，可以设置多级隐藏
视图模板是一个进行视图配置的便携功能，考虑到如下场景：
假设软件中配置了许多机柜，每个机柜有相同的树形结构，也需要配置相同的视图样式。但是，如果每个机柜的视图样式都手工配置，则需要操作人员付出大量的重复劳动。
为避免重复劳动，BIT软件提供了视图模板功能，使用流程如下：
手工配置一个机柜的展示样式并保存
在树形菜单中右键单击配置好的视图，点选“设为模板”按钮
在树形菜单中右键单击需要配置的视图，点选“应用模板”按钮
视图模板功能会自动将视图样式配置好，与之前手工配置的视图完全相同。
注意：视图模板只能在两个树形结构完全相同的视图间复制。两个视图内的元素数量要相同，类型要相同，顺序也要相同，其内部递归的视图也需要完全相同。
BIT软件的核心功能之一，就是接受外部的数据输入，根据用户设置的计算规则，进行健康度的计算。
大部分情况下，健康度的计算是根据树形结构层级/元素的权重分组/元素的权重值 三个因素自动完成的（详细配置与计算方式点击右侧“健康度计算”标签）。
但在某些情况中，有一些更复杂的逻辑，软件无法自动处理。
例如，某个电源计划性停电，软件的操作人员知道这会导致相关的LRU进入关机状态，但外部数据告诉BIT软件这些LRU进入了故障状态。这样就会造成误报警，带来不必要的麻烦。
BIT软件为此类情况提供了综合脚本功能。软件使用者可以通过脚本功能设置一系列的逻辑关系，从而处理比普通健康度计算更加复杂的情况。
BIT软件支持配置多个综合脚本，综合脚本将按照配置顺序逐个执行，配置列表如下图
综合脚本配置表单如下图
在图中我们可以看到，综合脚本表单分为五个区域，它们分别是：
树形结构
判断条件LRU
判断结果LRU
判断结果视图
判断结果视图子项
实际的综合脚本设置操作应该如下：
在树形结构中选择设置为判断条件的LRU，右键添加到“判断条件LRU”区域中
在”判断条件LRU“区域为LRU设置状态，当LRU处于设置的状态时该脚本就会被触发
在树形结构中选择设置为判断结果的LRU，右键添加到“判断结果LRU”区域中
在“判断结果LRU”区域为LRU设置状态，当脚本触发后该LRU就会被置为设置的状态
在树形结构中选择视图，右键添加到“判断结果视图”区域中
在“判断结果视图”区域为视图设置健康度，当脚本触发后该视图会被设定为指定的健康度
在树形结构中选择视图，右键添加到“判断结果视图子项”区域中
在“判断结果视图子项”区域为该视图下的所有LRU设置状态，当脚本触发后该视图下的所有LRU都会被置为指定状态。如果勾选级联选项，则该视图的子孙视图中的LRU也会被置为指定的状态。
BIT软件运行后，就会根据用户的配置监听外部数据。在软件内部维护LRU的运行状态，视图的健康度。
通过用户配置的视图画布，软件可以将各项数据通过可视化的方式呈现出来。
进行视图展示的入口有三个，配置客户端的“视图预览”视图预览功能，展示客户端和单幅客户端。
需要注意的是，程序进行数值计算的树形结构是程序打开时创建的。
配置的树形结构变化不会实时影响到数值计算的结构。
如果配置的树形结构发生变化，需要重启软件再进行视图展示。
三种展示入口的内容大同小异，以展示客户端为例。首先用户将软件配置为展示客户端，然后重启软件，即可打开如下窗口
在展示模式，页面分为左侧展示区和右侧树形结构区，下面分别介绍：
可选择物理结构树或逻辑结构树，并且直接点选树形结构。
点选视图时，左侧区域就会展示当前视图内容。
视图展示为黑色名称，LRU展示为蓝色名称。
视图右侧显示健康度，并且根据健康度不同有绿黄红三个颜色的指示灯。
LRU的右侧显示LRU的当前状态，根据状态不同有绿，红，灰，黑四个颜色的指示灯。
可以使用鼠标滚轮进行缩放操作，按住鼠标左键进行拖动操作。
当鼠标悬停到LRU后，会显示该LRU内的检测项状态，绿色为正常，红色为异常。
LRU的颜色也会根据外部数据进行试试改变。
健康度计算是BIT软件的核心功能之一，要理解健康度计算方法我们需要先了解健康度计算的相关名词
名称
释义
健康度
只有视图才拥有健康度，健康度体现了一个视图整体的健康状态。
健康度的取值范围为0-1，0代表完全故障，1代表完全健康。
LRU状态
在系统中完成LRU录入后，系统运行时会监听外部数据，维护每个LRU当前的运行状态。
LRU在运行时的实际状态有四种（正常/故障/关机/未知）。
在进行健康度计算时，LRU只考虑为两种状态，正常或不正常。
权重值
在建立树形结构时，LRU和子视图都需要设置权重值。
权重值代表着当前节点对上级节点的影响。
权重值的取值范围为0-1，0代表完全没有影响，1代表完全有影响。
权重分组
在进行权重设置时同时需要指定的一个字符串，称为权重分组。
相同权重分组的节点，会联合起来计算对父节点的健康度影响。
不同权重分组的节点，会独立计算对父节点的健康度影响。
如果对某个视图进行健康度计算，算法流程如下：
如果该视图存在子视图，则先用此算法进行子视图的健康度计算
遍历该视图的子节点，记录每个子节点的权重分组，获得权重分组总数
以某个权重分组为标记将自身健康度设置为1
如果权重分组中有不正常的LRU，则将自身健康度减去此LRU的权重值
如果权重分组中有子视图，则将自身健康度减去子视图的权重值乘以1减去子视图健康度的差
获得当前权重分组中的健康度
更换另一个权重分组，重复3-6的过程，直到完成所有权重分组的计算
将所有权重分组计算结果中得到的最低健康度设置为当前视图的健康度，如果该值小于0，则认为当前视图健康度为0
将当前视图的健康度返回给父视图
根据算法流程我们可以获得如下结论：
视图健康度的取值范围永远在0-1之间
视图的健康度由最不健康的权重分组决定
BIT软件内建了用户/权限体系，在使用BIT软件进行项目配置前，用户需要先登录账号获取权限，登录页面如下图。
用户登录账号后，有操作权限的功能菜单为彩色，可正常点击使用。无操作权限的功能菜单为灰色，不可使用，如下图
用户配置包括账号/密码/角色选择，角色的配置包括角色名称/拥有权限。
