重复语法元素

重复语法元素是脚本命令中可以使用的通用参数和选项类别。下表列出了重复语法元素中使用的约定。

约定	定义
a \| b	二选一（“a”或“b”）
italicized-words	需要用户输入来实现参数（变量的响应）
[ ...] （方括号）	出现零次或一次（方括号也用作某些命令参数的定界符）
{ ...} （花括号）	出现零次或多次
(a \| b \| c)	只选择其中一个备选项

下表列出了重复语法参数以及可以与重复语法参数一起使用的值。

重复语法	语法值
`autoconfigure-vols-attr- value-list`	`autoconfigure-vols-attr-value-pair` {`autoconfigure-vols-attr-value-pair` }
`autoconfigure-vols-attr- value-pair`	driveType=<var id="GUID-27B44A94-CF78-4A35-85BA-0E3466B9AB1F__V1231482" className="keyword varname">drive-type</var> \| driveMediaType=<var id="GUID-27B44A94-CF78-4A35-85BA-0E3466B9AB1F__V1231483" className="keyword varname">drive-media-type</var> \| raidLevel=<var id="GUID-27B44A94-CF78-4A35-85BA-0E3466B9AB1F__V1231484" className="keyword varname">raid-level</var> \| volumeGroupWidth=<var id="GUID-27B44A94-CF78-4A35-85BA-0E3466B9AB1F__V1231485" className="keyword varname">integer-literal</var> \| volumeGroupCount=<var id="GUID-27B44A94-CF78-4A35-85BA-0E3466B9AB1F__V1231486" className="keyword varname">integer-literal</var> \| volumesPerGroupCount=<var id="GUID-27B44A94-CF78-4A35-85BA-0E3466B9AB1F__V1231487" className="keyword varname">integer-literal</var><sup className="ph sup">6</sup>\| hotSpareCount=<var id="GUID-27B44A94-CF78-4A35-85BA-0E3466B9AB1F__V1231488" className="keyword varname">integer-literal</var> \| segmentSize=<var id="GUID-27B44A94-CF78-4A35-85BA-0E3466B9AB1F__V1231489" className="keyword varname">segment-size-spec</var> \| cacheReadPrefetch=(TRUE \| FALSE) securityType=(none \| capable \| enabled)<sup className="ph sup">7</sup>\| dataAssurance=(none \| enabled)<sup className="ph sup">5</sup>
`boolean`	`(TRUE \| FALSE)`
`cache-flush-modifier- setting`	`immediate, 0, .25, .5, .75, 1, 1.5, 2, 5, 10, 20, 60, 120, 300, 1200, 3600, infinite`
`capacity-spec`	`integer-literal` [KB \| MB \| GB \| TB \| Bytes]
`count-based-repository- spec`	repositoryRAIDLevel =<var id="GUID-27B44A94-CF78-4A35-85BA-0E3466B9AB1F__V1231464" className="keyword varname">repository-raid-level</var> repositoryDriveCount=<var id="GUID-27B44A94-CF78-4A35-85BA-0E3466B9AB1F__V1231465" className="keyword varname">integer-literal</var> [repositoryVolumeGroupUserLabel =<var id="GUID-27B44A94-CF78-4A35-85BA-0E3466B9AB1F__V1231466" className="keyword varname">user-label</var>] [driveType=<var id="GUID-27B44A94-CF78-4A35-85BA-0E3466B9AB1F__V1231467" className="keyword varname">drive-type</var><sup className="ph sup">4</sup>] [trayLossProtect=(TRUE \| FALSE)<sup className="ph sup">1</sup>] \| [drawerLossProtect=(TRUE \| FALSE)<sup className="ph sup">2</sup>] \| [dataAssurance=(none \| enabled)<sup className="ph sup">5</sup>] \|
`create-raid-vol-attr- value-list`	`create-raid-volume-attribute-value-pair` { `create-raid-volume-attribute-value-pair` }
`create-raid-volume- attribute-value-pair`	`capacity=<var id="GUID-27B44A94-CF78-4A35-85BA-0E3466B9AB1F__V1231440" className="keyword varname">capacity-spec</var> \| owner=(<span className="ph">a</span> \| <span className="ph">b</span>) \| cacheReadPrefetch=(TRUE \| FALSE) \| segmentSize=<var id="GUID-27B44A94-CF78-4A35-85BA-0E3466B9AB1F__V1231441" className="keyword varname">integer-literal</var> \| usageHint=<var id="GUID-27B44A94-CF78-4A35-85BA-0E3466B9AB1F__V1231442" className="keyword varname">usage-hint-spec</var>`
`create-volume-copy-attr- value-list`	`create-volume-copy-attr-value-pair` { `create-volume-copy-attr-value-pair` }
`create-volume-copy-attr- value-pair`	`copyPriority=(highest \| high \| medium \| low \| lowest) \| targetReadOnlyEnabled=(TRUE \| FALSE) \| copyType=(offline \| online) \| repositoryPercentOfBase=(20 \| 40 \| 60 \| 120 \| default) \| repositoryGroupPreference=(sameAsSource \| otherThanSource \| default)`
`drive-media-type`	( SSD \| unknown \| allMedia) SSD 是指固态磁盘。
`drive-spec`	`trayID,slotID` 或 `trayID,drawerID,slotID` 驱动器定义为以逗号分隔的两个或三个整数文本值。低密度托盘需要两个值。高密度托盘是有抽屉的托盘，需要三个值。
`drive-spec-list`	`drive-spec` `drive-spec`
`drive-type`	(SAS)
`error-action`	(stop \| continue)
`ethernet-port-options`	enableIPv4=(TRUE \| FALSE) \| enableIPv6=(TRUE \| FALSE) \| IPv6LocalAddress=<var id="GUID-27B44A94-CF78-4A35-85BA-0E3466B9AB1F__V1231496" className="keyword varname">ipv6-address</var> \| IPv6RoutableAddress=<var id="GUID-27B44A94-CF78-4A35-85BA-0E3466B9AB1F__V1231497" className="keyword varname">ipv6-address</var> \| IPv6RouterAddress=<var id="GUID-27B44A94-CF78-4A35-85BA-0E3466B9AB1F__V1231498" className="keyword varname">ipv6-address</var> \| IPv4Address=<var id="GUID-27B44A94-CF78-4A35-85BA-0E3466B9AB1F__V1231499" className="keyword varname">ip-address</var> \| IPv4ConfigurationMethod= (static \| dhcp) \| IPv4GatewayIP=<var id="GUID-27B44A94-CF78-4A35-85BA-0E3466B9AB1F__V1231500" className="keyword varname">ip-address</var> \| IPv4SubnetMask=<var id="GUID-27B44A94-CF78-4A35-85BA-0E3466B9AB1F__V1231501" className="keyword varname">ip-address</var> \| duplexMode=(TRUE \| FALSE) \| portSpeed=(autoNegotiate \| 10 \| 100 \| 1000)
`feature-identifier`	注缺省情况下启用 ThinkSystem SAN OS 11.50 中的所有功能。
`filename`	`string-literal`
`hex-literal`	0x00-0xFF 范围内的文本。
`host-card-identifier`	(1 \| 2 \| 3 \| 4)
`host-type`	`string-literal` \| `integer-literal`
`instance-based- repository-spec`	(repositoryRAIDLevel =<var id="GUID-27B44A94-CF78-4A35-85BA-0E3466B9AB1F__V1231458" className="keyword varname">repository-raid-level</var> repositoryDrives= (<var id="GUID-27B44A94-CF78-4A35-85BA-0E3466B9AB1F__V1231459" className="keyword varname">drive-spec-list</var>) [repositoryVolumeGroupUserLabel =<var id="GUID-27B44A94-CF78-4A35-85BA-0E3466B9AB1F__V1231460" className="keyword varname">user-label</var>] [trayLossProtect=(TRUE \| FALSE)<sup className="ph sup">1</sup>]) \| [drawerLossProtect=(TRUE \| FALSE)<sup className="ph sup">2</sup>]) \| (repositoryVolumeGroup=<var id="GUID-27B44A94-CF78-4A35-85BA-0E3466B9AB1F__V1231462" className="keyword varname">user-label</var> [freeCapacityArea=<var id="GUID-27B44A94-CF78-4A35-85BA-0E3466B9AB1F__V1231463" className="keyword varname">integer-literal</var><sup className="ph sup">3</sup>]) 指定 repositoryRAIDLevel 参数与 repositoryDrives 参数。请勿用卷组指定 RAID 级别或驱动器。指定卷组时，请勿设置 trayLossProtect 参数的值。
`ip-address`	(0-255).(0-255).(0-255).(0-255)
`ipv6-address`	(0-FFFF):(0-FFFF):(0-FFFF):(0-FFFF): (0-FFFF):(0-FFFF):(0-FFFF):(0-FFFF) 必须输入全部 32 位十六进制字符。
`iscsi-host-port`	`(1 \| 2 \| 3 \| 4)` 主机端口号可能是 2、3 或 4，具体取决于所用控制器的类型。
`iscsi-host-port-options`	IPv4Address=<var id="GUID-27B44A94-CF78-4A35-85BA-0E3466B9AB1F__V1231502" className="keyword varname">ip-address</var> \| IPv6LocalAddress=<var id="GUID-27B44A94-CF78-4A35-85BA-0E3466B9AB1F__V1231503" className="keyword varname">ipv6-address</var> \| IPv6RoutableAddress=<var id="GUID-27B44A94-CF78-4A35-85BA-0E3466B9AB1F__V1231504" className="keyword varname">ipv6-address</var> \| IPv6RouterAddress=<var id="GUID-27B44A94-CF78-4A35-85BA-0E3466B9AB1F__V1231505" className="keyword varname">ipv6-address</var> \| enableIPv4=(TRUE \| FALSE) \| enableIPv6=(TRUE \| FALSE) \| enableIPv4Priority=(TRUE \| FALSE) \| enableIPv6Priority=(TRUE \| FALSE) \| IPv4ConfigurationMethod=(static \| dhcp) \| IPv6ConfigurationMethod= (static \| auto) \| IPv4GatewayIP=<var id="GUID-27B44A94-CF78-4A35-85BA-0E3466B9AB1F__V1231506" className="keyword varname">ip-address</var> \| IPv6HopLimit=<var id="GUID-27B44A94-CF78-4A35-85BA-0E3466B9AB1F__V1231507" className="keyword varname">integer</var> \| IPv6NdDetectDuplicateAddress=<var id="GUID-27B44A94-CF78-4A35-85BA-0E3466B9AB1F__V1231508" className="keyword varname">integer</var> \| IPv6NdReachableTime=<var id="GUID-27B44A94-CF78-4A35-85BA-0E3466B9AB1F__V1231509" className="keyword varname">time-interval</var> \| IPv6NdRetransmitTime=<var id="GUID-27B44A94-CF78-4A35-85BA-0E3466B9AB1F__V1231510" className="keyword varname">time-interval</var> \| IPv6NdTimeOut=<var id="GUID-27B44A94-CF78-4A35-85BA-0E3466B9AB1F__V1231511" className="keyword varname">time-interval</var> \| IPv4Priority=<var id="GUID-27B44A94-CF78-4A35-85BA-0E3466B9AB1F__V1231512" className="keyword varname">integer</var> \| IPv6Priority=<var id="GUID-27B44A94-CF78-4A35-85BA-0E3466B9AB1F__V1231513" className="keyword varname">integer</var> \| IPv4SubnetMask=<var id="GUID-27B44A94-CF78-4A35-85BA-0E3466B9AB1F__V1231514" className="keyword varname">ip-address</var> \| IPv4VlanId=<var id="GUID-27B44A94-CF78-4A35-85BA-0E3466B9AB1F__V1231515" className="keyword varname">integer</var> \| IPv6VlanId=<var id="GUID-27B44A94-CF78-4A35-85BA-0E3466B9AB1F__V1231516" className="keyword varname">integer</var> \| maxFramePayload=<var id="GUID-27B44A94-CF78-4A35-85BA-0E3466B9AB1F__V1231517" className="keyword varname">integer</var> \| tcpListeningPort=<var id="GUID-27B44A94-CF78-4A35-85BA-0E3466B9AB1F__V1231518" className="keyword varname">tcp-port-id</var> \| portSpeed=(autoNegotiate \| 1 \| 10)
`iscsiSession`	`[<var id="GUID-27B44A94-CF78-4A35-85BA-0E3466B9AB1F__V1231495" className="keyword varname">session-identifier</var>]`
`nvsram-offset`	`hex-literal`
`nvsramBitSetting`	`nvsram-mask, nvsram-value` = `0xhexadecimal, 0xhexadecimal` \| `integer-literal` `0xhexadecimal` 值通常是从 0x00 到 0xFF 的值。
`nvsramByteSetting`	`nvsram-value` = `0xhexadecimal` \| `integer-literal` `0xhexadecimal` 值通常是从 0x00 到 0xFF 的值。
`portID`	`(0-127)`
`raid-level`	`(0 \| 1 \| 3 \| 5 \| 6)`
`recover-raid-volume-attr- value-list`	`recover-raid-volume-attr-value-pair` { `recover-raid-volume-attr-value-pair` }
`recover-raid-volume-attr- value-pair`	`owner=(<span className="ph">a</span>\|<span className="ph">b</span>) \| cacheReadPrefetch=(TRUE \| FALSE) \| dataAssurance=(none \| enabled)`
`repository-raid-level`	`(1 \| 3 \| 5 \| 6)`
`repository-spec`	`instance-based-repository-spec` \| `count-based-repository-spec`
`segment-size-spec`	`integer-literal` — 所有容量都使用 base-2 格式。
`serial-number`	`string-literal`
`slotID`	对于高容量驱动器托盘，请指定驱动器的托盘标识值、抽屉标识值和插槽标识值。对于低容量驱动器托盘，请指定驱动器的托盘标识值和插槽标识值。托盘标识值为 0 到 99。抽屉标识值为 1 到 5。所有插槽标识最大值均为 24。插槽标识值从 0 或 1 开始，具体取决于托盘型号。用方括号（[ ]）将托盘标识值、抽屉标识值和插槽标识值括起来。 `( <span className="ph"> drive=(trayID,[drawerID,]slotID) </span> \| <span className="ph"> drives=(trayID1,[drawerID1,]slotID1 ... trayIDn,[drawerIDn,]slotIDn) </span> )`
`test-devices`	`controller=(<span className="ph">a</span>\|<span className="ph">b</span>) esms=(<var id="GUID-27B44A94-CF78-4A35-85BA-0E3466B9AB1F__V1231521" className="keyword varname">esm-spec-list</var>)drives=(<var id="GUID-27B44A94-CF78-4A35-85BA-0E3466B9AB1F__V1231522" className="keyword varname">drive-spec-list</var>)`
`test-devices-list`	`test-devices` { `test-devices` }
`time-zone-spec`	`(GMT+HH:MM \| GMT-HH:MM) [dayLightSaving=HH:MM]`
`trayID-list`	`trayID` { `trayID` }
`usage-hint-spec`	`usageHint=(multiMedia \| database \| fileSystem)` 控制器使用卷的使用提示或需要的 I/O 特征来指示合适的缺省卷段大小和动态高速缓存读预取。对于文件系统和数据库，使用 128 KB 段大小。对于多媒体，使用 256 KB 段大小。所有三个使用提示都启用动态高速缓存读预取。
`user-label`	`string-literal` 有效字符为字母数字、连字符和下划线。
`user-label-list`	`user-label` { `user-label` }
`volumeGroup-number`	`integer-literal`
`wwID`	`string-literal`

¹ 为了使托盘丢失保护正常工作，您的配置必须遵守以下准则：

级别	存储架丢失保护的条件	所需的最小存储架数量
池	池中一个存储架内的驱动器不得超过两个。	6
RAID 6	卷组中一个存储架内的驱动器不得超过两个。	3
RAID 3 或 RAID 5	卷组中的每个驱动器都位于独立存储架中。	3
RAID 1	RAID 1 对中的每个驱动器都必须位于一个独立存储架中。	2
RAID 0	不能实现存储架丢失保护。	不适用

² 为了使抽屉丢失保护正常工作，您的配置必须遵守以下准则：

级别	抽屉丢失保护的条件	所需的最小抽屉数量
池	池包含所有五个抽屉中的驱动器，每个抽屉中的驱动器数目相同。	5
RAID 6	卷组中一个抽屉内的驱动器不得超过两个。	3
RAID 3 或 RAID 5	卷组中的每个驱动器位于独立抽屉中。	3
RAID 1	镜像对中的每个驱动器必须位于一个独立抽屉中。	2
RAID 0	不能实现抽屉丢失保护。	不适用

如果在您的存储阵列配置中有一个卷组跨多个托盘，则必须确保抽屉丢失保护的设置与托盘丢失保护设置相配合。您可以在没有托盘丢失保护功能的情况下使用抽屉丢失保护。而不能在没有抽屉丢失保护功能的情况下使用托盘丢失保护。如果未将 trayLossProtect 参数与 drawerLossProtect 参数设置为相同值，则存储阵列会返回一条错误消息，并且不会创建存储阵列配置。

³ 要确定是否存在可用容量区域，请运行 show volumeGroup 命令。

⁴ 缺省驱动器（驱动器类型）为 SAS。

如果存储阵列中只有一种类型的驱动器，则不需要 DriveType 参数。如果使用 driveType 参数，还必须使用 hotSpareCount 参数和 volumeGroupWidth 参数。

⁵dataAssurance 参数与数据保证（DA）功能有关。

数据保证（DA）功能提升了整个存储系统的数据完整性。使用 DA 功能，存储阵列能够检查当数据在控制器和驱动器之间移动时可能发生的错误。启用此功能后，存储阵列会在卷中的每个数据块中附加错误检查代码（也称为循环冗余检查或 CRC）。移动数据块后，存储阵列使用这些 CRC 代码来确定传输期间是否发生了任何错误。可能损坏的数据不会写入磁盘。

要使用 DA 功能，请从只包括支持 DA 功能的驱动器的池或卷组开始。然后，创建支持 DA 的卷。

注

当需要的所有硬件和 I/O 接口都支持 DA 功能时，可将 dataAssurance 参数设置为 enabled，然后即可在特定操作中应用 DA。例如，可以创建包含支持 DA 功能的驱动器的卷组，然后在支持 DA 功能的该卷组中创建一个卷。使用支持 DA 功能的卷的其他操作具有支持 DA 功能的多个选项。

⁶volumesPerGroupCount 参数是每个卷组中容量相等的卷的数量。

⁷securityType 参数可用于指定要创建的卷组的安全设置。还会将所有卷设置为您选择的安全设置。用于设置安全设置的可用选项包括：

none – 卷组不安全。
capable – 卷组支持安全功能，但未启用安全功能。
enabled – 卷组启用了安全功能。

注

如果要设置 securityType=enabled，必须已经为存储阵列创建存储阵列安全密钥。（要创建存储阵列安全密钥，请使用 create storageArray securityKey 命令。

提供反馈