La version française est une traduction automatique. La version anglaise prévaut sur la française en cas de divergence.

Éléments de syntaxe récurrents

12/16/2024 Contributeurs

Les éléments de syntaxe récurrente sont une catégorie générale de paramètres et d'options que vous pouvez utiliser dans les commandes de script. Le tableau suivant répertorie les conventions utilisées dans les éléments de syntaxe récurrents.

Convention Définition

Convention	Définition
`*a	b*`
Alternative (« a » ou « b »)	`italicized-words`
Nécessite une entrée utilisateur pour remplir un paramètre (réponse à une variable)	`[ ... ]` (crochets)
Zéro ou une occurrence (les crochets sont également utilisés comme délimiteur pour certains paramètres de commande)	`{ ... }` (accolades)
Zéro occurrence ou plus	`(*a
b	c*)`

`*a

b*`

Alternative (« a » ou « b »)

italicized-words

Nécessite une entrée utilisateur pour remplir un paramètre (réponse à une variable)

[ ... ] (crochets)

Zéro ou une occurrence (les crochets sont également utilisés comme délimiteur pour certains paramètres de commande)

{ ... } (accolades)

Zéro occurrence ou plus

`(*a

c*)`

Le tableau suivant répertorie les paramètres de syntaxe récurrents et les valeurs que vous pouvez utiliser avec les paramètres de syntaxe récurrents.

Syntaxe récurrente Valeur de syntaxe

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 signifie disque dur. SSD signifie disque SSD.

drive-spec

trayID,slotID ou trayID,drawerID,slotID Un lecteur est défini comme deux ou trois valeurs littérales entières séparées par une virgule. Les plateaux à faible densité nécessitent deux valeurs. Les plateaux haute densité, ceux dotés de tiroirs, nécessitent trois valeurs.

drive-spec-list

`_drive-spec_` `_drive-spec_`

drive-type

`(fibre

SATA

SAS)`

[NOTE] ==== Seuls les disques SAS sont pris en charge par les versions de firmware 7.86 et ultérieures.

====

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

Toutes les fonctionnalités de SANtricity 11.40 sont activées par défaut.

filename

string-literal

gid

string-literal

hex-literal

Un littéral dans la plage 0x00 - 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]) ---- Spécifiez le repositoryRAIDLevel paramètre avec le repositoryDrives paramètre. Ne spécifiez pas le niveau RAID ou les disques avec le groupe de volumes. Ne définissez pas de valeur pour le trayLossProtect paramètre lorsque vous spécifiez un groupe de volumes.

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)

Vous devez entrer les 32 caractères hexadécimaux.

iscsi-host-port

(1

4) ---- Le numéro de port hôte peut être 2, 3 ou 4 selon le type de contrôleur que vous utilisez.

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

Le 0xhexadecimal La valeur est généralement une valeur comprise entre 0x00 et 0xFF.

nvsramByteSetting

nvsram-value = 0xhexadecimal

integer-literal

Le 0xhexadecimal La valeur est généralement une valeur comprise entre 0x00 et 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 - toutes les capacités sont dans la base-2.

serial-number

string-literal

slotID

Pour les tiroirs disques haute capacité, spécifiez la valeur d'ID du bac, la valeur d'ID du tiroir et la valeur d'ID du logement pour le lecteur. Pour les tiroirs disques basse capacité, spécifiez la valeur d'ID du bac et la valeur d'ID du logement pour le lecteur. Les valeurs d'ID du bac sont 0 à 99. Les valeurs d'ID de tiroir sont 1 à 5.

La capacité maximale de tous les emplacements est de 24. Les valeurs d'ID de fente commencent à 0 ou 1, selon le modèle de bac.

Placez la valeur d'ID du bac, la valeur d'ID du tiroir et la valeur d'ID de logement entre crochets ([ ]).

(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) ---- L'indice d'utilisation ou les caractéristiques d'E/S attendues du volume sont utilisés par le contrôleur pour indiquer une taille de segment de volume par défaut appropriée et une préextraction de lecture dynamique du cache. Pour le système de fichiers et la base de données, une taille de segment de 128 Ko est utilisée. Pour le multimédia, une taille de segment de 256 Ko est utilisée. Les trois conseils d'utilisation permettent d'activer la lecture préalable du cache dynamique.

user-label

string-literal

Les caractères valides sont alphanumériques, le tiret et le trait de soulignement.

user-label-list

{user-label {user-label}

volumeGroup-number

integer-literal

wwID

1pour que la protection contre les pertes de bac fonctionne, votre configuration doit respecter les directives suivantes :

Niveau	Critères pour la protection contre les pertes du plateau	Nombre minimum de bacs requis
Pool de disques	Le pool de disques ne contient pas plus de deux lecteurs dans un bac unique	6
RAID 6	Le groupe de volumes ne contient pas plus de deux lecteurs dans un bac unique	3
RAID 3 ou RAID 5	Chaque lecteur du groupe de volumes se trouve dans un bac distinct	3
RAID 1	Chaque lecteur d'une paire RAID 1 doit se trouver dans un bac distinct	2
RAID 0	Impossible d'obtenir la protection contre les pertes du bac.	Sans objet

Niveau

Critères pour la protection contre les pertes du plateau

Nombre minimum de bacs requis

Pool de disques

Le pool de disques ne contient pas plus de deux lecteurs dans un bac unique

RAID 6

Le groupe de volumes ne contient pas plus de deux lecteurs dans un bac unique

RAID 3 ou RAID 5

Chaque lecteur du groupe de volumes se trouve dans un bac distinct

RAID 1

Chaque lecteur d'une paire RAID 1 doit se trouver dans un bac distinct

RAID 0

Impossible d'obtenir la protection contre les pertes du bac.

Sans objet

2pour que la protection contre les pertes de tiroirs fonctionne, votre configuration doit respecter les directives suivantes :

Niveau	Critères pour la protection contre les pertes de tiroirs	Nombre minimum de tiroirs requis
Pool de disques	Le pool comprend des disques des cinq tiroirs et il y a un nombre égal de disques dans chaque tiroir. Un plateau de 60 lecteurs peut atteindre la protection contre les pertes de tiroirs lorsque le pool de disques contient 15, 20, 25, 30, 35, 40, 45, 50, 55 ou 60 disques.	5
RAID 6	Le groupe de volumes ne contient pas plus de deux disques dans un tiroir unique.	3
RAID 3 ou RAID 5	Chaque lecteur du groupe de volumes se trouve dans un tiroir distinct.	3
RAID 1	Chaque lecteur d'une paire symétrique doit être placé dans un tiroir séparé.	2
RAID 0	Impossible d'obtenir la protection contre la perte de tiroir.	Sans objet

Niveau

Critères pour la protection contre les pertes de tiroirs

Nombre minimum de tiroirs requis

Pool de disques

Le pool comprend des disques des cinq tiroirs et il y a un nombre égal de disques dans chaque tiroir. Un plateau de 60 lecteurs peut atteindre la protection contre les pertes de tiroirs lorsque le pool de disques contient 15, 20, 25, 30, 35, 40, 45, 50, 55 ou 60 disques.

RAID 6

Le groupe de volumes ne contient pas plus de deux disques dans un tiroir unique.

RAID 3 ou RAID 5

Chaque lecteur du groupe de volumes se trouve dans un tiroir distinct.

RAID 1

Chaque lecteur d'une paire symétrique doit être placé dans un tiroir séparé.

RAID 0

Impossible d'obtenir la protection contre la perte de tiroir.

Sans objet

Si vous disposez d'une configuration de matrice de stockage dans laquelle un groupe de volumes couvre plusieurs bacs, vous devez vous assurer que le paramètre de protection contre les pertes de tiroir fonctionne avec le paramètre de protection contre les pertes de bac. Vous pouvez bénéficier d'une protection contre les pertes de tiroirs sans protection contre les pertes de bac. Vous ne pouvez pas bénéficier d'une protection contre les pertes de bac sans protection contre les pertes de tiroir. Si le trayLossProtect paramètre et le drawerLossProtect les paramètres ne sont pas définis sur la même valeur, la matrice de stockage renvoie un message d'erreur et aucune configuration de matrice de stockage ne sera créée.

3 pour déterminer si une zone de capacité libre existe, exécutez le show volumeGroup commande.

4 le disque par défaut (type de disque) est SAS.

Le driveType le paramètre n'est pas requis si un seul type de disque se trouve dans la matrice de stockage. Si vous utilisez le driveType paramètre, vous devez également utiliser le hotSpareCount paramètre et le volumeGroupWidth paramètre.

5 le dataAssurance Le paramètre est lié à la fonctionnalité Data assurance (DA).

La fonctionnalité Data assurance (DA) renforce l'intégrité des données sur l'ensemble du système de stockage. DA permet à la matrice de stockage de vérifier si des erreurs peuvent se produire lorsque des données sont déplacées entre les hôtes et les lecteurs. Lorsque cette fonctionnalité est activée, la matrice de stockage ajoute des codes de vérification des erreurs (également appelés vérifications cycliques de redondance ou CRCS) à chaque bloc de données du volume. Après le déplacement d'un bloc de données, la matrice de stockage utilise ces codes CRC pour déterminer si des erreurs se sont produites au cours de la transmission. Les données potentiellement corrompues ne sont ni écrites sur le disque ni renvoyées à l'hôte.

Si vous souhaitez utiliser la fonction DA, commencez par un pool ou un groupe de volumes qui inclut uniquement les lecteurs qui prennent en charge DA. Ensuite, créez des volumes compatibles DA. Enfin, mappez ces volumes compatibles DA à l'hôte à l'aide d'une interface d'E/S capable de gérer DA. Les interfaces d'E/S qui peuvent être DA incluent Fibre Channel, SAS et iser over InfiniBand (iSCSI Extensions for RDMA/IB). DA n'est pas pris en charge par iSCSI over Ethernet ou par le SRP sur InfiniBand.

Lorsque tout le matériel requis et l'interface d'E/S sont compatibles DA, vous pouvez configurer le dataAssurance paramètre à enabled Puis utiliser DA avec certaines opérations. Par exemple, vous pouvez créer un groupe de volumes comprenant des disques compatibles DA, puis créer un volume au sein de ce groupe de volumes qui est activé par DA. Les autres opérations qui utilisent un volume activé par DA peuvent prendre en charge la fonction DA.

6 le volumesPerGroupCount paramètre correspond au nombre de volumes de capacité égale par groupe de volumes.

7 le securityType paramètre vous permet de spécifier le paramètre de sécurité pour un groupe de volumes que vous créez. Tous les volumes sont également définis sur le paramètre de sécurité de votre choix. Les options disponibles pour définir le paramètre de sécurité sont les suivantes :

none — le groupe de volumes n'est pas sécurisé.
capable — le groupe de volumes est sécurisé, mais la sécurité n'a pas été activée.
enabled — le groupe de volumes est sécurisé activé.

Une clé de sécurité de la matrice de stockage doit déjà être créée pour la matrice de stockage si vous souhaitez la définir securityType=enabled. (Pour créer une clé de sécurité de la matrice de stockage, utilisez le create storageArray securityKey commande.)

Éléments de syntaxe récurrents

Creating your file...