GB／T 37982-2019 信息技术 多路径管理(API)
- word版文件下载：
-
特别提醒：word版是本站通过人工智能从pdf转换成的word版本，正确率只有90%左右（正在通过训练继续提高准确率），排版恢复的也并不完全准确，没有进行任何人工校对，VIP会员直接免费下载即可，普通会员无法通过点数下载，算是给VIP的活动。
特别提醒：word版是不完美的，错误较多，只能参考，有需要的可以少打一些字，别下载了找我们说word内容有问题，这是送给VIP会员的。
- 文档部分内容预览：
6.3本API与SCSI中的目标端口组之间的关系
T37982—2019/ISO/IEC11002:2008
工程规范表1总结了SCSIINQUIRY标识符和REPORTTARGETPORTGROUPS命令响应中针对此 阵列配置返回的信息
表1RAID阵列的配置信息
/T37982—2019/ISO/IEC11002:2008
B22019/ISO/IEC1100
在控制器A出现故障的情况下，从端口1或者端口2访问所有逻辑单元将发现没有响应或目标端 日组状态是不可用。通过端口3或者端口4，逻辑单元A和逻辑单元B将发现非最佳活跃访问状态。 注意，对于一个给定的目标端口组ID，有不同的目标端口组访问状态，具体状态取决于要向其发布 EPORTTARGETPORTGROUP命令的端口。此API中，将每个目标端口组ID和访间状态的组 合模型化为某类目标端口组的一个实例 图2是一个实例简图，它表现与上述非对称阵列对应的此API实例。其中还包含相关的API 属性。
5.3.2对称和非对称多路径访间
图2与非对称阵列对应的API实例的例子
蛋然本API提供了发现多路径设备的接口 1，但它只能通过安装的插件提供可用信息。如果客户端应用程 求全面发现所有设备.最好也使用平台特定的设备发现API
蛋然本API提供了发现多路径设备的接口 1，但它只能通过安装的插件提供可用信息。如果客户端应用程 求全面发现所有设备.最好也使用平台特定的设备发现API
T37982—2019/ISO/IEC11002:2008
路径访问。一个目标系统，当其所有的逻辑单元都具有所有端口的对称多路径访问时，该系统有可能使 用单一的目标端口组来描述，这个单一目标端口组处于与所有逻辑单元和目标端口关联的活跃/最佳访 状态。 一个逻辑单元可能经由部分而非全部目标端口执行对称多路径访问。最佳的端口可以用于负载均 衡，非最佳的端口只宜用于故障接管。这种情况用多个目标端口组来建模，这些目标端口组具有多个关 联的端口且处于活跃/最佳访问状态
5.3.3逻辑单元紧密组
此API包含了四个影响负载均衡的接口： 当多条可用的路径具有相同的访问状态时，每一个I/O请求只能向一条特定路径发出。多路 径驱动程序可能允许管理员选择一个路径选择算法，用来确定选择哪一条路径； 一些多路径驱动程序充许管理员选择可用路径的一个子集作为最高优先级路径；如果没有错误 发生，1/O将只能在最高优先级路径组中选择路径。但是不必取消非最高优先级路径，如果所 有的最高优先级路径都变为不可用状态，非最高优先级路径可能用做后备路径。这种能力完全 在主机驱动程序中实现，与目标端口组无关。一些驱动程序允许多个优先级别，此API中称其 为优先级管理权重； 驱动程序可能允许管理员指定一条“重载”路径，作为所有I/O暂时使用的路径； 驱动程序可能允许管理员禁用某条路径，使某条路径暂时不用于负载均衡。 下列各条的内容更加谨细的描述了这此接口
5.3.4.2负载均衡算法
/T37982—2019/IS0/IEC11002:2008
5.3.4.4禁用负载均衡重载路径
5.3.4.5禁用路径
此API的模型包含以下各类对象： 库一一客户端接口库，所有插件的前端访问接口； 设备产品一一驱动程序支持的特定设备的信息； 插件一实现此API的特定驱动程序库； 专用负载均衡类型 供应商名和驱动程序特定负载均衡算法的描述；对API不透明，只把算 法名称提供给应用程序：
T37982—2019/ISO/IEC11002:2008
发起者端口 插件所在系统上的端口； 目标端口 一 设备上的端口； 路径逻辑单元一一代表访问某逻辑单元的一个发起者/目标端口的组合。可以没有相应的操作 系统设备文件名； 多路径逻辑单元一虚拟设备，它聚合代表相同逻辑单元的所有路径（路径逻辑单元）； ·目标端口组 一具有共同访问状态的各目标端口的集合。 图3是一个显示不同种类对象在多路径模型中关系的UML略图
图3多路径模型中各种对象之间的关系
/T37982—2019/IS0/IEC11002:2008
B22019/ISO/IEC1100
5.4可选行为的客户端发现
图4多路径逻辑单元的驱动程序表示
5.4.2发现负载均衡行为
T37982—2019/ISO/IEC11002:2008
一类负载均衡算法，而不是MPLOADBALANCETYPEPRODUC
5.4.3客户端发现故障接管/故障恢复功能
客户端发现驱动程序创建操作系统设备文件名的
客户端发现自动故障恢复
T37982—2019/ISO/IEC11002:2008
且pluginAutofailbackEnabled为真，表示多路径逻辑单元已经启用自动故障恢复。 failbackPollingRateMax 驱动程序支持的最大轮询间隔（单位为秒）。零（0)表示驱动程序不支持此逻辑单元的自动故障轮 询，或者没有提供一个接口来设置轮询间隔。如果此属性的值和插件的failbackPollingRateMax值都 不为0，首选前者。 currentFailbackPollingRate 当前的自动故障恢复轮询间隔（单位为秒）。此属性值不能大于failbackPollingRateMax值。如果 此属性和插件的currentFailbackPollingRate属性值都不为O，首选前者
5.4.6客户端发现自动探测功能
一个长时间运行的应用程序可以订阅事件并随时通知其变化
/T37982—2019/IS0/IEC11002:2008
5.6.2操作系统无关的实现
多路径管理API可以使用库与插件的组合来实现。 库的一个功能是加载插件，并分发管理应用程序的请求到相应的插件。 在操作系统无关的实现中，操作系统供应商，HBA卡供应商，或目标设备供应商提供插件管理一组 目标设备。典型的情况是，插件得到库提供的通用格式的请求，然后将该请求转换成供应商特定格式， 转发给供应商的设备驱动程序。实际情况下插件可能使用DLL或共享库与设备驱动程序交互。也可 能同多个设备驱动程序交互。插件用于执行其工作的方式完全取决于特定的供应商。 尽管很少见，但两个插件可能对同一个物理设备都有一个实例。这种情况可能发生在发起者端口， 目标端口甚至逻辑单元上。客户端通过检测某些属性来确定这种等价情况，这些属性包含由硬件本身 报告的名称/ID（例如，用于FC端口的几个端口WWN）。如果客户端应用程序运行在多个主机上，此 方法同样适用于发现是否同一个逻辑单元目标端口连接在多个主机上。这样做，有助于客户端保留 个汇集了几个插件的信息的实例。如果实例重叠，其结果之一是，几个插件可能向客户端报告同一个 事件。 本架构对系统引导时间没有要求。插件在安装时注册到通用库。通常是在MP驱动程序（和/或客 户端管理软件）安装时完成。注册信息长久保存在注册表或配置文件中（见7.37）
多路径管理API的一个核心元素是对象标识符（OID)。OID是一种“唯一地”标识对象的结构 一地这个词加引号的原因是，同一个OID有可能被重复用于代表不同的对象，尽管很少见。 OID包含3个字段： a）对象类型。标识该OID代表的对象的类型，例如，端口，逻辑单元等。 b） 对象所有者标识符。这是一个编号，用于唯一地标识对象的所有者。所有者可能是库，或者 是拥有对象的某个插件。 对象序号。这是一个编号，对象所有者将它或可能是它与对象类型的组合用于标识某对象
T37982—2019/ISO/IEC11002:2008
上述属性的组合保证OID对所有插件而言是唯一。 使用库的客户端应将OID看做不透明的。客户端只应使用文件化的API访问该OID中的信息。 以下关于OID的规则是客户端、库和插件应遵循的：一个OID每次只能代表一个对象；一个对象 任何时候只能有一个OID来代表它。不允许同时有多个OID代表同一个对象。遵循这个规则有时比 较困难，但仍应遵循。 例如，假设某HBA端口处于某系统中。该端口会有一个OID。如果该HBA卡在与之关联的捕件 运行时做一次插拔，那么可能发生以下两种情况之一： a）该HBA端口能保留原来的OID； b）该HBA端口对象得到新的OID，原来的OID不再使用。 上例仅是同一个HBA的插拨。如果是在运行特定插件或库实例时拨下某个HBA后安装另外 个系统中以前没有的HBA，那么，应给这个新安装的HBA分配一个新的OID。 插件和库可以通过对象序号或对象类型与对象序号的组合，在自已的对象域中唯一地标识一个对 象。使用哪种方式取决于库或插件的实现。 对象序号的重用应谨慎，尽可能防止由于打包序号导致某个OID再次代表同一个插件或库实例中 的多个不同对象。这个重用规则只限于特定的插件或库实例。无论对插件或库，都不要求或期待它们 保留各个实例的对象序号， 因为不要求插件或库保留对象序号，所以使用该库的客户端不应使用保留的自已的各个实例 的OID。 同样，插件或库的不同实例可能使用不同的OID代表同一个物理实体
5.6.4 OID 列表
6.1MP WCHAR
盲编译器均支持，可能需要开启某些编译选项
6.2 MP CHAR
个8位的无符号数，类型定义为无符号字符
6.5MP XBOOI
/T37982—2019/IS0/IEC11002:2008
B22019/ISO/IEC1100
6.6 MP UINT32
6.8MP STATUS
T37982—2019/ISO/IEC11002:2008
6.9MP PATH STATE
37982—2019/ISO/IEC1
/T37982—2019/IS0/IEC11002:2008
6.10MPOBJECTVISIBILITYFN
6.11MPOBJECTPROPERTYFEN
T37982—2019/ISO/IEC11002:2008
6.12MP OBJECT TYPE
typedef structMPOID
/T37982—2019/IS0/IEC11002:2008
B22019/ISO/IEC1100
5.14MPOID LIST
止回阀标准6.15MPPORTTRANSPORTTYPE
822019/ISO/IEC1100
MP ACCESS STATE
隧道标准规范范本/T37982—2019/IS0/IEC11002:2008
B22019/ISO/IEC1100
6.17MPLOADBALANCETYPI
....- 相关专题：