GB/T 37982-2019 信息技术 多路径管理(API)

ICS35.200

L65

中华人民共和国国家标准

/—//:

GBT379822019ISOIEC110022008

信息技术多路径管理()

API

—()

InformationtechnoloMultiathmanaementAPI

gypg

(/:,)

ISOIEC110022008IDT

2019-08-30发布2020-03-01实施

国家市场监督管理总局

发布

中国国家标准化管理委员会

/—//:

GBT379822019ISOIEC110022008

目次

前言…………………………Ⅰ

1范围………………………1

2规范性引用文件…………………………1

、………………………

3术语定义和缩略语1

4文件约定…………………4

5背景技术信息……………4

6常量和结构………………16

7API………………………36

8实现规则…………………72

9实现………………………72

()…………

附录资料性附录设备名称

A74

()…………………

附录资料性附录合成目标端口组

B75

()………………

附录资料性附录传输层多路径方法

C77

()…………

附录资料性附录编码示例

D78

()/………………

附录资料性附录接口库插件

EAPI81

参考文献……………………82

/—//:

GBT379822019ISOIEC110022008

前言

本标准按照/—给出的规则起草。

GBT1.12009

本标准使用翻译法等同采用/:《信息技术多路径管理()》。

ISOIEC110022008API

与本标准中规范性引用的国际文件有一致性对应关系的我国文件如下:

———/—程序设计语言(/:)。

GBT152721994CidtISOIEC98991990

。。

请注意本文件的某些内容可能涉及专利本文件的发布机构不承担识别这些专利的责任

本标准由全国信息技术标准化技术委员会(/)提出并归口。

SACTC28

:、、

本标准起草单位浪潮电子信息产业股份有限公司深圳赛西信息技术有限公司四川长虹佳华信

、、、、

息产品有限责任公司中国电子技术标准化研究院华中科技大学西北工业大学广东省东莞市质量监

、、()。

督检测中心杭州海康威视数字技术股份有限公司特斯联北京科技有限公司

:、、、、、、、、、、

本标准主要起草人耿芳忠赵江赵向阳文中领杨宏何霞杜文宾冯丹于金玉史泽雁

、、、、、、、、、、、、、、

张森林张晓赵晓南黎慧庄雄华汪渭春李杨袁鹏飞公维锋陈宇王琪梅林军陈俭喜彭渌

、。

施展王芳

Ⅰ

/—//:

GBT379822019ISOIEC110022008

信息技术多路径管理()

API

1范围

本标准规定了对/()定义的标准能力和供应商扩展的常用能力的管理接

ISOIEC14776-453SPC-3

。,。

口本标准适用于交付驱动程序的供应商这些驱动程序提供上述能力本标准与SCSI多路径特性

,()(

有关但不包括互连设备如光纤信道交换机之间的多路径方法和传输特定的多路径方法如iSCSI的

每个会话的多个连接)。

:,,,

注为便于标准使用者理解和实施本标准附录给出了设备名称附录给出了合成目标端口组附录给出了

ABC

,,

传输层多路径方法附录给出了如何使用多路径管理的示例附录给出了描述接口库与插件之间必

DAPIE

需的独立于操作系统的实现的接口。

2规范性引用文件

。,

下列文件对于本文件的应用是必不可少的凡是注日期的引用文件仅注日期的版本适用于本文

。,()。

件凡是不注日期的引用文件其最新版本包括所有的修改单适用于本文件

/:程序设计语言()

ISOIEC98991999CProramminlanuaes-C

gggg

/:()[

信息技术光纤信道第部分光纤信道交换机结构

ISOIEC14165-133133-3FC-SW-3In-

——:()]

formationtechnoloFibrechannelPart133Switchfabric-3FC-SW-3

gy

/:()[

信息技术光纤信道第部分光纤信道组帧和信令

ISOIEC14165-251251FC-FSInfor-

—:()]

mationtechnolo-FibrechannelPart251FraminandsinallinFC-FS

gyggg

/():()

信息技术小型计算机系统接口第部分并行接口

ISOIEC14776-115SCSI115-5SPI-5

[—()—:

InformationtechnoloSmallcomuterssteminterfaceSCSIPart115Parallelinterface-5

gypy

()]

SPI-5

/():

信息技术小型计算机系统接口第部分串行附加

ISOIEC14776-150SCSI150SCSI

()[—()—:

SASInformationtechnoloSmallcomuterssteminterfaceSCSIPart150Serialattached

gypy

()]

SCSISAS

/():

信息技术小型计算机系统接口第部分体系结构模型

ISOIEC14776-413SCSI4133

()[—()—:

SAM-3InformationtechnoloSmallcomuterssteminterfaceSCSIPart413Architecture

gypy

()]

model-3SAM-3

/():()

信息技术小型计算机系统接口第部分主要指令

ISOIEC14776-453SCSI453SPC-3

[—()—:

InformationtechnoloSmallcomuterssteminterfaceSCSIPart453Primarcommands-3

gypyy

()]

SPC-3

互联网小型计算机系统接口()[

RFC3720iSCSIInternetSmallComuterSstemsInterface

py

()]

iSCSI

、

3术语定义和缩略语

3.1术语和定义

下列术语和定义适用于本文件。

1

/—//:

GBT379822019ISOIEC110022008

3.1.1

自动故障恢复auto-failback

某些多路径驱动程序所具有的重新使用由不可用状态恢复为可用状态的路径的能力。

3.1.2

自动探测auto-robin

pg

某些多路径驱动程序所具有的查验当前未使用的工作路径的能力。

3.1.3

可用路径availableaths

p

一个逻辑单元的可用于选做/请求路线的路径集合。

IO

:,。,

注对于对称访问设备所有的路径都认为是可用的对于非对称访问设备所有在活跃目标端口组上的路径都认

为是可用的。

3.1.4

设备文件devicefile

(、……)。

便于与系统硬件和外围设备通信的操作系统文件如UNIXLinux等的实例

3.1.5

设备标识页

VPDdeviceidentificationVPDae

pg

、。

提供检索SCSI设备逻辑单元和SCSI端口的标识信息的方法的VPD页

3.1.6

十六进制编码二进制数据hexadecimal-encodedbinardata

y

(/—)。

用来表示二进制位组字串的十六进制编码的对应于字符串

8ASCIIGBT19881998

:,。。

注它只包含ASCII字符中0-9A-F以及a-f两个十六进制字符代表二进制数据的一个字节

3.1.7

主机host

连接到存储区域网()的计算节点。

SAN

3.1.8

发起者initiator

,。

发起请求的SCSI设备也称为客户端

:,。

注在本标准中发起者指某发起者端口

3.1.9

逻辑单元loicalunit

g

SCSI目标设备中的可寻址实体。

:,。,“”“

注例如RAID阵列将每一个虚拟磁盘卷展现为一个逻辑单元在本标准中术语逻辑单元不是指多路径逻辑

”“”,。

单元或路径逻辑单元而是指目标设备中的逻辑单元

3.1.10

多路径逻辑单元multiathloicalunit

pg

“”,

本标准中代表虚拟的逻辑单元的对象类型它针对作为基础的同一个设备逻辑单元将多个路径

逻辑单元合并在一起。

3.1.11

对象IDobectID

j

在多路径API中分配给任何对象的唯一标识符。

:,;,。

注对象有时代表物理实体例如发起者端口有时代表逻辑实体如目标端口组

3.1.12

路径ath

p

、。。

发起者端口目标端口和逻辑单元之间的关联见3.1.13

2

/—//:

GBT379822019ISOIEC110022008

3.1.13

路径逻辑单元athloicalunit

pg

本标准中的通过一个发起者端口和一个设备端口提供对一个逻辑单元进行访问的对象类型。

:,()。,

注在本标准中每一条路径见3.1.12模块化为路径逻辑单元多路径驱动程序将产生一个操作系统设备文件

它代表聚合多个路径逻辑单元的一个多路径逻辑单元。

3.1.14

持久性ersistent

p

数据的非易失特性。

:。

注持久意味着相关数据被记录到诸如闪存或者磁盘之类非易失媒介并且这些数据在系统重启后仍然存在暗

1

指数据可以从非易失媒介上读取。

::

注持久性存储的例子

2

●,();

在系统下注册表可能是一个找到持久存储值假设该值不是以易失方式存储的公共地方在

Windows

,。

任何操作系统下硬盘上的文件都是持久的

●

,。

在任何操作系统下磁盘上的文件可能都是持久的

3.1.15

插件luin

pg

为操作系统、或者设备提供商开发的支持一个或多个多路径驱动程序的软件。

HBA

:。,

注插件的作用在于为库的接口和供应商的多路径驱动程序之间搭桥插件通常是一个可加载的模块例如Win-

。。

dows的动态链接库和UNIX的共享对象应用程序通过多路径管理API库访问插件

3.1.16

()()

产品或设备产品roductordeviceroduct

pp

,、

特定型号的目标设备该型号由标准命令的响应返回的供应商产品和修

SCSIINQUIRYIDID

订版本标识。

ID

3.1.17

目标taret

g

包含逻辑单元和接收SCSI发起者命令的SCSI目标端口的SCSI设备。

3.1.18

目标端口组taretortrou

gpgp

任何时候都处于同一目标端口访问状态的目标端口的集合。

3.1.19

通用多八位编码字符集;

universalmultile-octetcodedcharactersetUCS

p

(),。

唯一地标识编号字符的系统几乎标识了任何语言中的任何字符

3.1.20

重要产品数据;

vitalroductdataVPD

p

[/()]

为响应SCSIINQUIRY命令而使用EVPD位组见ISOIEC14776-453SPC-3返回的供应商

关于某设备的具体信息。

3.2缩略语

下列缩略语适用于本文件。

应用编程接口()

APIAlicationProramminInterface

ppgg

动态链接库()

DLLDnamicLinkLibrar

yy

主机总线适配器()

HBAHostBusAdater

p

逻辑单元号()

LUNLoicalUnitNumber

g

对象标识符()

OIDObectIdentifier

j

3

/—//:

GBT379822019ISOIEC110022008

操作系统()

OSOeratinSstem

pgy

通用多八位编码字符集()

UCSUniversalMultile-octetCodedCharacterSet

p

统一建模语言()

UMLUnifiedModelinLanuae

ggg

重要产品数据()

VPDVitalProductData

4文件约定

()()。

用一组类型和结构见第章及后随的一组功能定义见第章来详细说明本章讨论在

67API

第章和第章中使用的格式及定义时使用的约定。

67API

()。

常量用一系列及紧随其后的用于整数型的即类型定义予以定义各个语

#defineCtedefC

yp

;,

言枚举没有特定的长度使用#define而不是枚举有助于确保客户端代码跨平台和跨编译器的互操作

,。

性特别是在C++应用程序中使用时

API描述格式

每个API的描述都划分为以下七条:

1简介

本条对API执行的动作做简要的描述。

2原型

,()。

本条给出功能的原型其格式为语言功能原型和接口定义语言原型的组合原型用以

CIDL

下各项显示:

———API名称;

———API返回类型;

———,、、。

API的每个参数每个参数的类型和该参数是输入参数输出参数或者是输入和输出参数

3参数

本条列出每个参数以及该参数代表的事物的解释。

4典型返回值

,。,

本条列出API的典型的返回值以及返回特定类型返回值的理由说明注意该列表不是所有

。,___,

可能返回值的完备列表存在某些错误例如MPSTATUSINSUFFICIENTMEMORY任何

API都可能返回它们。

5备注

。,

本条包含一些可能对用户有用的关于该API的说明特别是本项包含一些关于该API返回

的信息的额外信息。

6支持

、。

本条指出某个API为强制性支持选择性支持或者在某些条件下强制性支持

———,;

如果一个API是强制支持的客户端可以在任何情况下依赖API的功能

———,;

如果API是选择性支持的客户端不能依赖API的功能

———,

如果API在某些条件下是强制性支持的客户端可以在条件得到满足的情况下依赖API

。,。

的功能否则客户端宜假定该API是没有得到支持的

7参见

,。

本条列出其他相关的API或者读者可能感觉有用的相关的规则示例

5背景技术信息

5.1概述

。

开放系统平台使应用程序通过展示一组代表物理设备的专用文件名访问这些设备尽管末端用户

4

/—//:

GBT379822019ISOIEC110022008

,“”(、)

通常不使用这些专用的设备文件但聪明的应用程序如文件系统数据库和备份软件会运行这些设

。,,

备文件并提供熟悉的用户存储接口这些设备文件按层次结构组织可以采用文件和目录方式也可以

采用命名约定的方式。

()。

设备文件的层次结构有时称为设备树为简单的桌面设备配置提供有效的接口在开放系统内核

,。

内部利用层次结构能使不同的驱动程序在设备树的不同部分运行当操作系统发现已连接的设备且

,。

构建设备树时同一个物理设备的多个路径在设备树中可以呈现为若干单独的设备文件各个单独的

,,。

存储应用程序它们使用这些设备文件代表通往同一个设备的多条路径时将重写彼此的数据

(),。

存储产品特别是磁盘阵列为了提供更好的可靠性和性能添加了多路径的支持对于缺少多路

,。

径支持的操作系统设备供应商和逻辑卷管理工具供应商提供多路径驱动程序设备标准缺少标识多

,。,,

路径设备的标准接口因此多路径驱动程序通常局限于特定的设备产品最近已经定义了这些标准

并且操作系统商已经开始将多路径支持集成到其绑定的驱动程序当中。

。

这些驱动程序创建代表多路径设备的特殊设备文件诸如文件系统之类存储应用程序可以像使用

,。,

单路径设备文件一样使用这些多路径设备文件同时又受益于可靠性和性能的改善另外多路径驱动

,。

程序提供了一些仅用在多路径设备中的管理功能例如故障接管和负载均衡

。。

本标准着重于通过SCSI命令访问的设备SCSI命令由发起者发送给目标设备目标设备可能由

。,。

多个逻辑单元组成例如RAID阵列对外表示虚拟磁盘为若干单独的逻辑单元支持多个路径和多

。、

个所依附的主机的目标设备几乎总是有多个端口发起者端口目标端口和逻辑单元的每个排列就是

。,。

通常所说的路径如果操作系统不支持多路径每一个路径将被该操作系统当作若干单独的逻辑单元

,。

那么多路径驱动程序的功能就是创建一个聚合所有这些路径逻辑单元的虚拟多路径设备

5.2目标端口组

。(),

一个逻辑单元可能只能通过某些目标端口访问如果设备支持非对称访问见5.3.2某些端口可

()。/()

能是访问的首选端口有时称为紧密组ISOIEC14776-453SPC-3引入了目标端口组作为目标设

。。

备呈现逻辑单元访问特性的一种方法目标端口组是端口的集合所有与该目标端口组关联的逻辑单

(/、/、)。

元具有相同的访问状态活跃最佳活跃非最佳备用或不可用

,(,

目标端口组是一些抽象的元素可能等同于也可能不等同于该目标系统的某个元素如某个控制

器)。

,。

目标端口组的概念可以应用到所有的设备即使它们并未实际实现SCSI标准接口本标准不要

;,/(),

求SPC-3兼容阵列它包含目标端口组且以ISOIEC14776-453SPC-3的术语作为起点但做了扩

,。

展以反映通常的供应商实现

,/。,

为了简化客户端软件的任务所有插件驱动程序表现为其底层硬件使用目标端口组接口例如

,()。/

考虑一个非对称阵列该阵列有两个端口且每个端口是一半逻辑单元的主端口最佳插件驱动程序

;,

将创建四个虚拟的目标端口组每一个逻辑单元都是两个目标端口组的组成部分一个目标端口组处于

,,,

最佳访问状态用于该逻辑单元的主控制器另一个目标端口组处于非最佳访问状态用于该逻辑单元

。,。

的辅助控制器更多细节参见附录B

本与中的目标端口组之间的关系

5.3APISCSI

5.3.1概述

本条描述/()标准中定义的目标端口组与本定义的目标端口组之间

ISOIEC14776-453SPC-3API

的关系。

(,)

的设备标识页即和命令允许命令发

SCSIVPDae83hREPORTTARGETPORTGROUPS

pg

起