Se proporciona el idioma español mediante traducción automática para su comodidad. En caso de alguna inconsistencia, el inglés precede al español.

Elementos de sintaxis recurrente

12/16/2024 Colaboradores

PDF

Los elementos de sintaxis recurrente son una categoría general de parámetros y opciones que se pueden utilizar en los comandos de script. En la siguiente tabla, se enumeran las convenciones utilizadas en los elementos de sintaxis recurrente.

Convención Definición

Convención	Definición
`*a	b*`
Alternativa ("a" o "b")	`italicized-words`
Se necesita una entrada de usuario para completar un parámetro (una respuesta a una variable)	`[ ... ]` (corchetes)
Cero o una aparición (los corchetes también se utilizan como delimitadores para algunos parámetros de comando)	`{ ... }` (llaves)
Cero o más ocurrencias	`(*a
b	c*)`

`*a

b*`

Alternativa ("a" o "b")

italicized-words

Se necesita una entrada de usuario para completar un parámetro (una respuesta a una variable)

[ ... ] (corchetes)

Cero o una aparición (los corchetes también se utilizan como delimitadores para algunos parámetros de comando)

{ ... } (llaves)

Cero o más ocurrencias

`(*a

c*)`

En la siguiente tabla, se enumeran los parámetros de sintaxis recurrente y los valores que se pueden utilizar con los parámetros de sintaxis recurrente.

Sintaxis recurrente Valor de sintaxis

autoconfigure-vols-attr- value-list

{autoconfigure-vols-attr-value-pair {autoconfigure-vols-attr-value-pair}

autoconfigure-vols-attr- value-pair

driveType=drive-type

driveMediaType=drive-media-type

raidLevel=raid-level

volumeGroupWidth=integer-literal

volumeGroupCount=integer-literal

volumesPerGroupCount=integer-literal6

hotSpareCount=integer-literal

segmentSize=segment-size-spec

cacheReadPrefetch=(TRUE

FALSE) securityType=(none

capable

enabled)7

dataAssurance=(none

enabled)5 ----

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

Bytes]`

count-based-repository- spec

repositoryRAIDLevel =repository-raid-level repositoryDriveCount=integer-literal
[repositoryVolumeGroupUserLabel =user-label] [driveType=drive-type4
] [trayLossProtect=(TRUE

FALSE)1]

[drawerLossProtect=(TRUE

FALSE)2]

[dataAssurance=(none

enabled)5]

----

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=capacity-spec

owner=(a

cacheReadPrefetch=(TRUE

FALSE)

segmentSize=integer-literal

usageHint=usage-hint-spec ----

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

120

default)

repositoryGroupPreference=(sameAsSource

otherThanSource

default) ----

drive-media-type

`(HDD

SSD

unknown

allMedia)` HDD significa unidad de disco duro. SSD significa disco de estado sólido.

drive-spec

trayID,slotID o. trayID,drawerID,slotID Una unidad se define con dos o tres valores literales de números enteros separados por coma. Los soportes de densidad baja requieren dos valores. Los soportes de densidad alta, los que tienen cajones, requieren tres valores.

drive-spec-list

`_drive-spec_` `_drive-spec_`

drive-type

`(fibre

SATA

SAS)`

[NOTE] ==== Solo se admiten unidades SAS para las versiones de firmware 7.86 y posteriores.

====

error-action

`(stop

continue)`

ethernet-port-options

enableIPv4=(TRUE

FALSE)

enableIPv6=(TRUE

FALSE)

IPv6LocalAddress=ipv6-address

IPv6RoutableAddress=ipv6-address

IPv6RouterAddress=ipv6-address

IPv4Address=ip-address

IPv4ConfigurationMethod= (static

dhcp)

IPv4GatewayIP=ip-address

IPv4SubnetMask=ip-address

duplexMode=(TRUE

FALSE)

portSpeed=(autoNegotiate

100

1000) ----

feature-identifier

De manera predeterminada, todas las funciones de SANtricity 11.40 se encuentran habilitadas.

filename

string-literal

gid

string-literal

hex-literal

Un valor literal comprendido entre 0x00 y 0xFF.

host-card-identifier

`(1

4)`

host-type

string-literal

integer-literal

instance-based- repository-spec

(repositoryRAIDLevel =repository-raid-level repositoryDrives= (drive-spec-list)
[repositoryVolumeGroupUserLabel =user-label] [trayLossProtect=(TRUE

FALSE)1])

[drawerLossProtect=(TRUE

FALSE)2])

(repositoryVolumeGroup=user-label [freeCapacityArea=integer-literal3]) ---- Especifique el repositoryRAIDLevel con el repositoryDrives parámetro. No se debe especificar el nivel de RAID ni las unidades con el grupo de volúmenes. No configure un valor para trayLossProtect parámetro al especificar un grupo de volúmenes.

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)

Se deben introducir los 32 caracteres hexadecimales.

iscsi-host-port

(1

4) ---- El número de puerto de host puede ser 2, 3 o 4, según el tipo de controladora que se esté usando.

iscsi-host-port-options

IPv4Address=ip-address

IPv6LocalAddress=ipv6-address

IPv6RoutableAddress=ipv6-address

IPv6RouterAddress=ipv6-address

enableIPv4=(TRUE

FALSE)

enableIPv6=(TRUE

FALSE)

enableIPv4Priority=(TRUE

FALSE)

enableIPv6Priority=(TRUE

FALSE)

IPv4ConfigurationMethod=(static

dhcp)

IPv6ConfigurationMethod= (static

auto)

IPv4GatewayIP=ip-address

IPv6HopLimit=integer

IPv6NdDetectDuplicateAddress=integer

IPv6NdReachableTime=time-interval

IPv6NdRetransmitTime=time-interval

IPv6NdTimeOut=time-interval

IPv4Priority=integer

IPv6Priority=integer

IPv4SubnetMask=ip-address

IPv4VlanId=integer

IPv6VlanId=integer

maxFramePayload=integer

tcpListeningPort=tcp-port-id

portSpeed=(autoNegotiate

10) ----

iscsiSession

[session-identifier]

nvsram-offset

hex-literal

nvsramBitSetting

nvsram-mask, nvsram-value = 0xhexadecimal, 0xhexadecimal

integer-literal

La 0xhexadecimal El valor suele ser un valor entre 0x00 y 0xFF.

nvsramByteSetting

nvsram-value = 0xhexadecimal

integer-literal

La 0xhexadecimal El valor suele ser un valor entre 0x00 y 0xFF.

portID

(0-127)

raid-level

(0

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=(a

cacheReadPrefetch=(TRUE

FALSE)

dataAssurance=(none

enabled) ----

repository-raid-level

(1

6) ----

repository-spec

instance-based-repository-spec

count-based-repository-spec

segment-size-spec

integer-literal - todas las capacidades se encuentran en la base 2.

serial-number

string-literal

slotID

En el caso de los soportes de unidades de gran capacidad, es necesario indicar los valores de ID de soporte, ID de cajón e ID de ranura correspondientes a la unidad. En el caso de los soportes de unidades de baja capacidad, es necesario indicar los valores de ID de soporte e ID de ranura correspondientes a la unidad. Los valores de ID de soporte son 0 para 99. Los valores de ID de cajón son 1 para 5.

El valor máximo de ID de ranura es 24. Los valores de ID de ranura comienzan con 0 o 1, según el modelo de soporte.

Los valores de ID de soporte, de cajón y de ranura deben escribirse entre corchetes ([ ]).

(drive=\(trayID,[drawerID,]slotID\)

drives=\(trayID1,[drawerID1,]slotID1 … trayIDn,[drawerIDn,]slotIDn\) ) ----

test-devices

controller=(a

b) esms=(esm-spec-list)drives=(drive-spec-list) ----

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) ---- La controladora utiliza el Consejo de uso o las características de I/o esperadas del volumen para indicar un tamaño de segmento de volumen predeterminado adecuado y la captura previa de lectura de caché dinámica. En el caso de los sistemas de archivos y las bases de datos, se utiliza un tamaño de segmento de 128 KB. En el caso de los archivos multimedia, se utiliza un tamaño de segmento de 256 KB. Los tres consejos de uso habilitan la captura previa de lectura de caché dinámica.

user-label

string-literal

Los caracteres válidos son los alfanuméricos, el guion y el guion bajo.

user-label-list

{user-label {user-label}

volumeGroup-number

integer-literal

wwID

1para que la protección contra pérdida de soporte funcione, la configuración debe respetar las siguientes directrices:

Nivel	Criterios para la protección contra pérdida de soporte	Cantidad mínima requerida de bandejas
Pool de discos	El pool de discos consta de dos unidades como máximo en un solo soporte	6
RAID 6	El grupo de volúmenes consta de dos unidades como máximo en un solo soporte	3
RAID 3 o RAID 5	Cada unidad del grupo de volúmenes se encuentra en un soporte aparte	3
RAID 1	Cada unidad de una pareja RAID 1 se debe ubicar en un soporte aparte	2
RAID 0	No puede contar con protección contra pérdida de soporte.	No aplicable

Nivel

Criterios para la protección contra pérdida de soporte

Cantidad mínima requerida de bandejas

Pool de discos

El pool de discos consta de dos unidades como máximo en un solo soporte

RAID 6

El grupo de volúmenes consta de dos unidades como máximo en un solo soporte

RAID 3 o RAID 5

Cada unidad del grupo de volúmenes se encuentra en un soporte aparte

RAID 1

Cada unidad de una pareja RAID 1 se debe ubicar en un soporte aparte

RAID 0

No puede contar con protección contra pérdida de soporte.

No aplicable

2para que la protección contra pérdida de cajón funcione, la configuración debe respetar las siguientes directrices:

Nivel	Criterios para la protección contra pérdida de cajón	Cantidad mínima requerida de cajones
Pool de discos	El pool incluye las unidades de los cinco cajones y existe la misma cantidad de unidades por cajón. Un soporte de 60 unidades puede brindar protección contra pérdida de cajón cuando el pool de discos consta de 15, 20, 25, 30, 35, 40, 45, 50, 55 o 60 unidades.	5
RAID 6	El grupo de volúmenes consta de dos unidades como máximo en un solo cajón.	3
RAID 3 o RAID 5	Cada unidad del grupo de volúmenes se encuentra en un cajón aparte.	3
RAID 1	Cada unidad de una pareja reflejada se debe ubicar en un cajón aparte.	2
RAID 0	No puede contar con protección contra pérdida de cajón.	No aplicable

Nivel

Criterios para la protección contra pérdida de cajón

Cantidad mínima requerida de cajones

Pool de discos

El pool incluye las unidades de los cinco cajones y existe la misma cantidad de unidades por cajón. Un soporte de 60 unidades puede brindar protección contra pérdida de cajón cuando el pool de discos consta de 15, 20, 25, 30, 35, 40, 45, 50, 55 o 60 unidades.

RAID 6

El grupo de volúmenes consta de dos unidades como máximo en un solo cajón.

RAID 3 o RAID 5

Cada unidad del grupo de volúmenes se encuentra en un cajón aparte.

RAID 1

Cada unidad de una pareja reflejada se debe ubicar en un cajón aparte.

RAID 0

No puede contar con protección contra pérdida de cajón.

No aplicable

Si un grupo de volúmenes se extiende por varios soportes en la configuración de la cabina de almacenamiento, se debe comprobar que la configuración para la protección contra pérdida de cajón funcione con la configuración para la protección contra pérdida de soporte. Es posible contar con protección contra pérdida de cajón sin protección contra pérdida de soporte. No es posible contar con protección contra pérdida de soporte sin protección contra pérdida de cajón. Si la trayLossProtect y la drawerLossProtect no están configurados en el mismo valor, la cabina de almacenamiento muestra un mensaje de error y no se creará la configuración de la cabina de almacenamiento.

3 para determinar si existe un área de capacidad libre, ejecute el show volumeGroup comando.

4 la unidad predeterminada (tipo de unidad) es SAS.

La driveType no es necesario parámetro si la cabina de almacenamiento contiene un solo tipo de unidad. Si utiliza la driveType parámetro, también debe usar el hotSpareCount y la volumeGroupWidth parámetro.

5 la dataAssurance El parámetro se relaciona con la función de garantía de datos (DA).

La función Data Assurance (DA) mejora la integridad de los datos en todo el sistema de almacenamiento. DA permite a la cabina de almacenamiento comprobar si se producen errores cuando se transfieren datos entre hosts y unidades. Si esta función está habilitada, la cabina de almacenamiento añade códigos de comprobación de errores (también conocidos como comprobaciones de redundancia cíclicas o CRC) a cada bloque de datos del volumen. Una vez movido un bloque de datos, la cabina de almacenamiento utiliza estos códigos de CRC para determinar si se produjeron errores durante la transmisión. Los datos posiblemente dañados no se escriben en el disco ni se vuelven a transferir al host.

Si desea usar la función DA, comience con un pool o grupo de volúmenes que solo incluya unidades que sean compatibles con DA. A continuación, cree volúmenes compatibles con DA. Por último, asigne estos volúmenes compatibles con DA al host por medio de una interfaz de I/o compatible con DA. Las interfaces de I/o compatibles con DA son Fibre Channel, SAS e Iser over InfiniBand (extensiones iSCSI para RDMA/IB). ISCSI sobre Ethernet o SRP over InfiniBand no admiten LA función DA.

Cuando todo el hardware necesario y la interfaz de I/o son compatibles CON DA, puede configurar la dataAssurance parámetro a. enabled Y luego usar DA con ciertas operaciones. Por ejemplo, es posible crear un grupo de volúmenes que incluya unidades compatibles con DA y, luego, crear un volumen dentro de ese grupo que tenga la función DA habilitada. Otras operaciones que usan volúmenes con la función DA habilitada tienen opciones para admitir la función DA.

6 la volumesPerGroupCount parámetro es la cantidad de volúmenes de capacidad equivalente por grupo de volúmenes.

7 la securityType el parámetro permite especificar la configuración de seguridad para el grupo de volúmenes que se va a crear. Todos los volúmenes se establecen en la configuración de seguridad seleccionada. Algunas de las opciones disponibles para establecer la configuración de seguridad son:

none — el grupo de volúmenes no es seguro.
capable — el grupo de volúmenes es compatible con la función de seguridad, pero no tiene la seguridad habilitada.
enabled — el grupo de volúmenes tiene la función de seguridad habilitada.

Se debe crear una clave de seguridad para la cabina de almacenamiento si desea establecer securityType=enabled. (Para crear una clave de seguridad de la cabina de almacenamiento, utilice create storageArray securityKey ).

Elementos de sintaxis recurrente

Creating your file...