Diskraid

Article
04/11/2023

Diskraid est un outil en ligne de commande qui vous permet de configurer et de gérer un tableau redondant de sous-systèmes de stockage RAID indépendants (ou peu coûteux).

RAID est généralement utilisé sur les serveurs pour standardiser et classer les systèmes de disques à tolérance de panne. Les niveaux de RAID fournissent différentes combinaisons de performances, de fiabilité et de coûts. Certains serveurs fournissent trois niveaux de RAID : niveau 0 (agrégation par bandes), niveau 1 (mise en miroir) et niveau 5 (agrégation par bandes avec parité).

Un sous-système RAID matériel distingue les unités de stockage adressables physiquement les unes des autres à l’aide d’un numéro d’unité logique (LUN). Un objet LUN doit avoir au moins un plex et peut avoir n’importe quel nombre de plex supplémentaires. Chaque plex contient une copie des données sur l’objet LUN. Les plex peuvent être ajoutés et supprimés d’un objet LUN.

La plupart des commandes Diskraid fonctionnent sur un port d’adaptateur de bus hôte (HBA) spécifique, un adaptateur initiateur, un portail initiateur, un fournisseur, un sous-système, un contrôleur, un port, un lecteur, un numéro d’unité logique, un portail cible, une cible ou un groupe de portails cibles. Vous utilisez la commande SELECT pour sélectionner un objet. On dit que l’objet sélectionné a le focus. Le focus simplifie les tâches de configuration courantes, comme la création de plusieurs LUN dans le même sous-système.

Notes

L’outil en ligne de commande Diskraid fonctionne uniquement avec les sous-systèmes de stockage qui prennent en charge VDS (Virtual Disk Service).

Commandes Diskraid

Les commandes suivantes sont disponibles à partir de l’outil Diskraid.

add

Ajoute un numéro d’unité logique existant au LUN actuellement sélectionné ou ajoute un portail cible iSCSI au groupe de portails cibles iSCSI actuellement sélectionné.

Syntaxe

add plex lun=n [noerr]
add tpgroup tportal=n [noerr]

Paramètres

Paramètre	Description
plex lun=`<n>`	Spécifie le numéro d’unité logique à ajouter en tant que plex au numéro d’unité logique actuellement sélectionné. ATTENTION : toutes les données sur le LUN ajoutées en tant que plex seront supprimées.
tpgroup tportal=`<n>`	Spécifie le numéro de portail cible iSCSI à ajouter au groupe de portails cibles iSCSI actuellement sélectionné.
noerr	Pour les scripts uniquement. Lorsqu’une erreur est rencontrée, Diskraid continue de traiter les commandes comme si l’erreur ne s’était pas produite.

associate

Définit la liste spécifiée des ports de contrôleur comme étant actifs pour le LUN actuellement sélectionné (les autres ports de contrôleur sont rendus inactifs), ou ajoute les ports de contrôleur spécifiés à la liste des ports de contrôleur actifs existants pour le LUN actuellement sélectionné, ou associe la cible iSCSI spécifiée pour le LUN sélectionné.

Syntaxe

associate controllers [add] <n>[,<n> [,…]]
associate ports [add] <n-m>[,<n-m>[,…]]
associate targets [add] <n>[,<n> [,…]]

Paramètres

Paramètre	Description
contrôleur	Ajoute ou remplace la liste des contrôleurs associés au LUN actuellement sélectionné. Utilisez uniquement avec les fournisseurs VDS 1.0.
ports	Ajoute ou remplace la liste des ports de contrôleur associés au LUN actuellement sélectionné. Utilisez uniquement avec les fournisseurs VDS 1.1.
cibles	Ajoute ou remplace la liste des cibles iSCSI associées au LUN actuellement sélectionné. Utilisez uniquement avec les fournisseurs VDS 1.1.
add	Si vous utilisez des fournisseurs VDS 1.0 : Ajoute les contrôleurs spécifiés à la liste existante de contrôleurs associés au LUN. Si ce paramètre n’est pas spécifié, la liste des contrôleurs remplace la liste existante des contrôleurs associés à ce LUN. Si vous utilisez des fournisseurs VDS 1.1 : Ajoute les ports de contrôleur spécifiés à la liste existante des ports de contrôleur associés au LUN. Si ce paramètre n’est pas spécifié, la liste des ports de contrôleur remplace la liste existante des ports de contrôleur associés à ce LUN.
`<n>[,<n> [, ...]]`	Utilisez avec le paramètre controllers ou targets. Spécifie le nombre de contrôleurs ou de cibles iSCSI à définir sur actif ou associé.
`<n-m>[,<n-m>[,…]]`	Utilisez avec le paramètre ports. Spécifie les ports de contrôleur à définir comme actifs à l’aide d’une paire numéro de contrôleur (n) et numéro de port (m).

Exemple

Pour associer et ajouter des ports à un LUN qui utilise un fournisseur VDS 1.1 :

DISKRAID> SEL LUN 5
LUN 5 is now the selected LUN.

DISKRAID> ASSOCIATE PORTS 0-0,0-1
Controller port associations changed.
(Controller ports active after this command: Ctlr 0 Port 0, Ctlr 0 Port 1)

DISKRAID> ASSOCIATE PORTS ADD 1-1
Controller port associations changed.
(Controller ports active after this command: Ctlr 0 Port 0, Ctlr 0 Port 1, Ctlr 1 Port 1)

automagic

Définit ou efface les indicateurs qui donnent aux fournisseurs des indications sur la configuration d’un LUN. Utilisée sans paramètre, l’opération automagic affiche une liste d’indicateurs.

Syntaxe

automagic {set | clear | apply} all <flag=value> [<flag=value> [...]]

Paramètres

Paramètre	Description
set	Définit les indicateurs spécifiés sur les valeurs spécifiées.
clear	Efface les indicateurs spécifiés. Le mot clé all efface tous les indicateurs automagic.
apply	Applique les indicateurs actuels au LUN sélectionné.
`<flag>`	Les indicateurs sont identifiés par des acronymes à trois lettres, notamment : FCR - Récupération rapide sur incident requise FTL - Tolérance de panne MSR - Principalement des lectures MXD - Nombre maximal de lecteurs MXS - Taille maximale attendue ORA - Alignement de lecture optimal ORS - Taille de lecture optimale OSR - Optimiser pour les lectures séquentielles OSW - Optimiser pour les écritures séquentielles OWA - Alignement optimal de l’écriture OWS - Taille d’écriture optimale RBP - Priorité de reconstruction RBV - Vérification en lecture arrière activée RMP - Remappage activé STS - Taille de bande WTC - Mise en cache à double écriture activée YNK - Amovible

break

Supprime le plex du numéro logique actuellement sélectionné. Le plex et les données qu’il contient ne sont pas conservés, et les extensions de lecteur peuvent être récupérées.

Attention

Vous devez d’abord sélectionner un LUN mis en miroir avant d’utiliser cette commande. Toutes les données du plex seront supprimées. Il n’est pas garanti que toutes les données contenues dans le LUN d’origine sont cohérentes.

Syntaxe

break plex=<plex_number> [noerr]

Paramètres

Paramètre	Description
plex	Spécifie le numéro du plex à supprimer. Le plex et les données qu’il contient ne seront pas conservés, et les ressources utilisées par ce plex seront récupérées. La cohérence des données contenues dans le LUN n’est pas garantie. Si vous souhaitez conserver ce plex, utilisez VSS (Volume Shadow Copy Service).
noerr	Pour les scripts uniquement. Lorsqu’une erreur est rencontrée, Diskraid continue de traiter les commandes comme si l’erreur ne s’était pas produite.

chap

Définit le secret partagé CHAP (Challenge Handshake Authentication Protocol) afin que les initiateurs iSCSI et les cibles iSCSI puissent communiquer entre eux.

Syntaxe

chap initiator set secret=[<secret>] [target=<target>]
chap initiator remember secret=[<secret>] target=<target>
chap target set secret=[<secret>] [initiator=<initiatorname>]
chap target remember secret=[<secret>] initiator=<initiatorname>

Paramètres

Paramètre	Description
initiator set	Définit le secret partagé dans le service initiateur iSCSI local utilisé pour l’authentification CHAP mutuelle lorsque l’initiateur authentifie la cible.
initiator remember	Communique le secret CHAP d’une cible iSCSI au service initiateur iSCSI local afin que le service initiateur puisse utiliser le secret afin de s’authentifier auprès de la cible lors de l’authentification CHAP.
target set	Définit le secret partagé dans la cible iSCSI actuellement sélectionnée utilisée pour l’authentification CHAP lorsque la cible authentifie l’initiateur.
target remember	Communique le secret CHAP d’un initiateur iSCSI à la cible iSCSI active afin que la cible puisse utiliser le secret afin de s’authentifier auprès de l’initiateur lors de l’authentification CHAP mutuelle.
secret	Spécifie le secret à utiliser. S’il est vide, le secret est effacé.
target	Spécifie une cible dans le sous-système actuellement sélectionné à associer au secret. Facultatif lors de la définition d’un secret sur l’initiateur. L’absence de définition indique que le secret sera utilisé pour toutes les cibles qui n’ont pas encore de secret associé.
initiatorname	Spécifie un nom iSCSI de l’initiateur à associer au secret. Facultatif lors de la définition d’un secret sur une cible. L’absence de définition indique que le secret sera utilisé pour tous les initiateurs qui n’ont pas encore de secret associé.

créer

Crée un LUN ou une cible iSCSI sur le sous-système actuellement sélectionné, ou crée un groupe de portails cibles sur la cible actuellement sélectionnée. Vous pouvez afficher la liaison réelle à l’aide de la commande Diskraid list.

Syntaxe

create lun simple [size=<n>] [drives=<n>] [noerr]
create lun stripe [size=<n>] [drives=<n, n> [,...]]  [stripesize=<n>] [noerr]
create lun raid [size=<n>] [drives=<n, n> [,...]] [stripesize=<n>] [noerr]
create lun mirror [size=<n>] [drives=<n, n> [,...]] [stripesize=<n>] [noerr]
create lun automagic size=<n> [noerr]
create target name=<name> [iscsiname=<iscsiname>] [noerr]
create tpgroup [noerr]

Paramètres

Paramètre	Description
simple	Crée un LUN simple.
frange	Crée un LUN à bandes.
raid	Crée un LUN à bandes avec parité.
mirror	Crée un LUN mis en miroir.
automagic	Crée un LUN à l’aide des indicateurs automagic actuellement appliqués. Pour plus d’informations, consultez la sous-commande automagic dans cet article.
size=	Spécifie la taille totale du LUN en mégaoctets. Le paramètre size= ou drives= doit être spécifié. Ils peuvent également être utilisés conjointement. Si le paramètre size= n’est pas spécifié, le LUN créé sera de la plus grande taille possible autorisée par tous les lecteurs spécifiés. Un fournisseur crée généralement un LUN au moins aussi grand que la taille demandée, mais le fournisseur peut avoir à arrondir à la taille supérieure suivante dans certains cas. Par exemple, si la taille est spécifiée à 0,99 Go et que le fournisseur ne peut allouer que des étendues de disque en Go, le LUN résultant est de 1 Go. Pour spécifier la taille à l’aide d’autres unités, utilisez l’un des suffixes reconnus suivants immédiatement après la taille : B - octets KB - kilo-octets MB - mégaoctets GB - gigaoctets TB - téraoctets PB - pétaoctets
drives=	Spécifie le drive_number que les lecteurs doivent utiliser pour créer un LUN. Le paramètre size= ou drives= doit être spécifié. Ils peuvent également être utilisés conjointement. Si le paramètre size= n’est pas spécifié, le numéro d’unité logique créé est la plus grande taille possible autorisée par tous les lecteurs spécifiés. Si le paramètre size= est spécifié, les fournisseurs sélectionnent les lecteurs dans la liste des lecteurs spécifiés pour créer le LUN. Les fournisseurs tenteront d’utiliser les lecteurs dans l’ordre spécifié lorsque cela est possible.
stripesize=	Spécifie la taille en mégaoctets d’un LUN à bandes ou RAID. Il est impossible de modifier stripesize une fois que le LUN a été créé. Pour spécifier la taille à l’aide d’autres unités, utilisez l’un des suffixes reconnus suivants immédiatement après la taille : B - octets KB - kilo-octets MB - mégaoctets GB - gigaoctets TB - téraoctets PB - pétaoctets
target	Crée une cible iSCSI sur le sous-système actuellement sélectionné.
name	Fournit le nom convivial de la cible.
iscsiname	Fournit le nom iSCSI de la cible et peut être omis pour que le fournisseur génère un nom.
tpgroup	Crée un groupe de portails cibles iSCSI sur la cible actuellement sélectionnée.
noerr	Pour les scripts uniquement. Lorsqu’une erreur est rencontrée, Diskraid continue de traiter les commandes comme si l’erreur ne s’était pas produite.

supprimer

Supprime le LUN sélectionné, la cible iSCSI (tant qu’aucun LUN n’est associé à la cible iSCSI) ou le groupe de portails cibles iSCSI sélectionné.

Syntaxe

delete lun [uninstall] [noerr]
delete target [noerr]
delete tpgroup [noerr]

Paramètres

Paramètre	Description
lun	Supprime le LUN actuellement sélectionné et toutes les données qu’il contient.
uninstall	Spécifie que le disque sur le système local associé au LUN sera nettoyé avant la suppression du LUN.
target	Supprime la cible iSCSI actuellement sélectionnée si aucun LUN n’est associé à la cible.
tpgroup	Supprime le groupe de portails cibles iSCSI actuellement sélectionné.
noerr	Pour les scripts uniquement. Lorsqu’une erreur est rencontrée, Diskraid continue de traiter les commandes comme si l’erreur ne s’était pas produite.

détails

Affiche des informations détaillées sur l’objet actuellement sélectionné du type spécifié.

Syntaxe

detail {hbaport | iadapter | iportal | provider | subsystem | controller | port | drive | lun | tportal | target | tpgroup} [verbose]

Paramètres

Paramètre	Description
hbaport	Répertorie des informations détaillées sur le port de l’adaptateur de bus hôte (HBA) actuellement sélectionné.
iadapter	Répertorie des informations détaillées sur l’adaptateur initiateur iSCSI actuellement sélectionné.
iportal	Répertorie des informations détaillées sur le portail d’initiateur iSCSI actuellement sélectionné.
provider	Répertorie des informations détaillées sur le fournisseur actuellement sélectionné.
subsystem	Répertorie des informations détaillées sur le sous-système actuellement sélectionné.
contrôleur	Répertorie des informations détaillées sur le contrôleur actuellement sélectionné.
port	Répertorie des informations détaillées sur le port du contrôleur actuellement sélectionné.
lecteur	Répertorie des informations détaillées sur le lecteur actuellement sélectionné, y compris les LUN occupants.
lun	Répertorie des informations détaillées sur le LUN actuellement sélectionné, y compris les lecteurs contributeurs. La sortie diffère légèrement selon que le LUN fait partie d’un sous-système Fibre Channel ou iSCSI. Si la liste Hôtes non masqués contient uniquement un astérisque, cela signifie que le LUN est masqué pour tous les hôtes.
tportal	Répertorie des informations détaillées sur le portail cible iSCSI actuellement sélectionné.
target	Répertorie des informations détaillées sur la cible iSCSI actuellement sélectionnée.
tpgroup	Répertorie des informations détaillées sur le groupe de portails cibles iSCSI actuellement sélectionné.
verbose	À utiliser uniquement avec le paramètre LUN. Répertorie des informations supplémentaires, y compris ses plex.

dissociate

Définit la liste spécifiée de ports de contrôleur comme inactifs pour le LUN actuellement sélectionné (les autres ports du contrôleur ne sont pas affectés), ou dissocie la liste spécifiée de cibles iSCSI pour le LUN actuellement sélectionné.

Syntaxe

dissociate controllers <n> [,<n> [,...]]
dissociate ports <n-m>[,<n-m>[,…]]
dissociate targets <n> [,<n> [,…]]

Paramètre

Paramètre	Description
controllers	Supprime les contrôleurs de la liste des contrôleurs associés au LUN actuellement sélectionné. Utilisez uniquement avec les fournisseurs VDS 1.0.
ports	Supprime les ports du contrôleur de la liste des ports de contrôleur associés au LUN actuellement sélectionné. Utilisez uniquement avec les fournisseurs VDS 1.1.
cibles	Supprime les cibles de la liste des cibles iSCSI associées au LUN actuellement sélectionné. Utilisez uniquement avec les fournisseurs VDS 1.1.
`<n> [,<n> [,…]]`	À utiliser avec le paramètre controllers ou targets. Spécifie les numéros des contrôleurs ou des cibles iSCSI à définir comme inactifs ou dissocier.
`<n-m>[,<n-m>[,…]]`	À utiliser avec le paramètre ports. Spécifie les ports de contrôleur à définir comme inactifs à l’aide d’une paire numéro de contrôleur (n) et numéro de port (m).

Exemple

DISKRAID> SEL LUN 5
LUN 5 is now the selected LUN.

DISKRAID> ASSOCIATE PORTS 0-0,0-1
Controller port associations changed.
(Controller ports active after this command: Ctlr 0 Port 0, Ctlr 0 Port 1)

DISKRAID> ASSOCIATE PORTS ADD 1-1
Controller port associations changed.
(Controller ports active after this command: Ctlr 0 Port 0, Ctlr 0 Port 1, Ctlr 1 Port 1)

DISKRAID> DISSOCIATE PORTS 0-0,1-1
Controller port associations changed.
(Controller ports active after this command: Ctlr 0 Port 1)

exit

Quitte Diskraid.

Syntaxe

exit

extend

Étend le LUN actuellement sélectionné en ajoutant des secteurs à la fin du LUN. Tous les fournisseurs ne prennent pas en charge l’extension des LUN. N’étend pas les volumes ou systèmes de fichiers contenus sur le LUN. Après avoir étendu le LUN, vous devez étendre les structures sur disque associées à l’aide de la commande DiskPart extend.

Syntaxe

extend lun [size=<LUN_size>] [drives=<drive_number>, [<drive_number>, ...]] [noerr]

Paramètres

Paramètre	Description
taille	Spécifie la taille en mégaoctets pour étendre le LUN. Vous devez spécifier la taille ou le paramètre `<drive>`. Ils peuvent également être utilisés conjointement. Si le paramètre size= n’est pas spécifié, le LUN est étendu par la taille la plus élevée possible autorisée par tous les lecteurs spécifiés. Si le paramètre size= est spécifié, les fournisseurs sélectionnent les lecteurs dans la liste spécifiée par le paramètre drives= pour créer le LUN. Pour spécifier la taille à l’aide d’autres unités, utilisez l’un des suffixes reconnus suivants immédiatement après la taille : B - octets KB - kilo-octets MB - mégaoctets GB - gigaoctets TB - téraoctets PB - pétaoctets
drives=	Spécifie le `<drive_number>` pour les lecteurs à utiliser lors de la création d’un LUN. Vous devez spécifier la taille ou le paramètre `<drive>`. Ils peuvent également être utilisés conjointement. Si le paramètre size= n’est pas spécifié, le numéro d’unité logique créé est la plus grande taille possible autorisée par tous les lecteurs spécifiés. Les fournisseurs utilisent les lecteurs dans l’ordre spécifié lorsque cela est possible.
noerr	Pour les scripts uniquement. Lorsqu’une erreur est rencontrée, Diskraid continue de traiter les commandes comme si l’erreur ne s’était pas produite.

flushcache

Efface le cache sur le contrôleur actuellement sélectionné.

Syntaxe

flushcache controller

help

Affiche une liste des commandes Diskraid.

Syntaxe

help

importtarget

Récupère ou définit la cible d’importation VSS (Volume Shadow Copy Service) actuelle qui est définie pour le sous-système actuellement sélectionné.

Syntaxe

importtarget subsystem [set target]

Paramètre

Paramètre	Description
set target	S’il est spécifié, définit la cible actuellement sélectionnée sur la cible d’importation VSS pour le sous-système actuellement sélectionné. S’il n’est pas spécifié, la commande récupère la cible d’importation VSS actuelle définie pour le sous-système actuellement sélectionné.

initiateur

Récupère des informations sur l’initiateur iSCSI local.

Syntaxe

initiator

invalidatecache

Invalide le cache sur le contrôleur actuellement sélectionné.

Syntaxe

invalidatecache controller

lbpolicy

Définit la stratégie d’équilibrage de charge sur le LUN actuellement sélectionné.

Syntaxe

lbpolicy set lun type=<type> [paths=<path>-{primary | <weight>}[,<path>-{primary | <weight>}[,…]]]
lbpolicy set lun paths=<path>-{primary | <weight>}[,<path>-{primary | <weight>}[,…]]

Paramètres

Paramètre Description

type

Paramètre	Description
type	Spécifie la stratégie d’équilibrage de charge. Si le type n’est pas spécifié, le paramètre path doit être spécifié. Type peut avoir l’une des valeurs suivantes : FAILOVER : utilise un chemin d’accès principal, les autres chemins étant des chemins de secours. ROUNDROBIN : utilise tous les chemins d’accès en mode tourniquet, en essayant chaque chemin de manière séquentielle. SUBSETROUNDROBIN : utilise tous les chemins d’accès principaux en mode tourniquet (round robin) ; les chemins de secours sont utilisés uniquement si tous les chemins d’accès principaux échouent. DYNLQD : utilise le chemin d’accès avec le nombre de requêtes actives le plus bas. WEIGHTED : utilise le chemin avec le poids le plus faible (chaque chemin doit se voir attribuer un poids). LEASTBLOCKS : utilise le chemin avec le moins de blocs. VENDORSPECIFIC : utilise une stratégie propre au fournisseur.
path	Spécifie si un chemin d’accès est principal ou a un `<weight>` particulier. Tous les chemins non spécifiés sont implicitement définis comme étant de secours. Tous les chemins d’accès répertoriés doivent être l’un des chemins d’accès du LUN actuellement sélectionné.

Spécifie la stratégie d’équilibrage de charge. Si le type n’est pas spécifié, le paramètre path doit être spécifié. Type peut avoir l’une des valeurs suivantes :

FAILOVER : utilise un chemin d’accès principal, les autres chemins étant des chemins de secours.
ROUNDROBIN : utilise tous les chemins d’accès en mode tourniquet, en essayant chaque chemin de manière séquentielle.
SUBSETROUNDROBIN : utilise tous les chemins d’accès principaux en mode tourniquet (round robin) ; les chemins de secours sont utilisés uniquement si tous les chemins d’accès principaux échouent.
DYNLQD : utilise le chemin d’accès avec le nombre de requêtes actives le plus bas.
WEIGHTED : utilise le chemin avec le poids le plus faible (chaque chemin doit se voir attribuer un poids).
LEASTBLOCKS : utilise le chemin avec le moins de blocs.
VENDORSPECIFIC : utilise une stratégie propre au fournisseur.

path Spécifie si un chemin d’accès est principal ou a un <weight> particulier. Tous les chemins non spécifiés sont implicitement définis comme étant de secours. Tous les chemins d’accès répertoriés doivent être l’un des chemins d’accès du LUN actuellement sélectionné.

list

Affiche une liste des objets de service du type spécifié.

Syntaxe

list {hbaports | iadapters | iportals | providers | subsystems | controllers | ports | drives | LUNs | tportals | targets | tpgroups}

Paramètres

Paramètre	Description
hbaports	Répertorie des informations récapitulatives sur tous les ports HBA connus de VDS. Le port HBA actuellement sélectionné est marqué par un astérisque (*).
iadapters	Répertorie des informations récapitulatives sur tous les adaptateurs initiateurs iSCSI connus de VDS. L’adaptateur initiateur sélectionné est marqué par un astérisque (*).
iportals	Répertorie des informations récapitulatives sur tous les portails d’initiateur iSCSI dans l’adaptateur d’initiateur actuellement sélectionné. Le portail initiateur actuellement sélectionné est marqué par un astérisque (*).
fournisseurs	Répertorie des informations récapitulatives sur chaque fournisseur connu de VDS. Le fournisseur actuellement sélectionné est marqué par un astérisque (*).
sous-systèmes	Répertorie les informations récapitulatives sur chaque sous-système du système. Le sous-système actuellement sélectionné est marqué par un astérisque (*).
controllers	Répertorie des informations récapitulatives sur chaque contrôleur dans le sous-système actuellement sélectionné. Le contrôleur actuellement sélectionné est marqué par un astérisque (*).
ports	Répertorie des informations récapitulatives sur chaque port de contrôleur dans le contrôleur actuellement sélectionné. Le port actuellement sélectionné est marqué par un astérisque (*).
lecteurs	Répertorie des informations récapitulatives sur chaque lecteur dans le sous-système actuellement sélectionné. Le lecteur actuellement sélectionné est marqué par un astérisque (*).
luns	Répertorie des informations récapitulatives sur chaque LUN dans le sous-système actuellement sélectionné. Le LUN actuellement sélectionné est marqué par un astérisque (*).
tportals	Répertorie des informations récapitulatives sur tous les portails cibles iSCSI dans le sous-système actuellement sélectionné. Le portail cible actuellement sélectionné est marqué par un astérisque (*).
cibles	Répertorie des informations récapitulatives sur toutes les cibles iSCSI dans le sous-système actuellement sélectionné. La cible actuellement sélectionnée est marquée par un astérisque (*).
tpgroups	Répertorie des informations récapitulatives sur tous les groupes de portails cibles iSCSI dans la cible actuellement sélectionnée. Le groupe de portails actuellement sélectionné est marqué par un astérisque (*).

Journalise l’adaptateur d’initiateur iSCSI spécifié dans la cible iSCSI actuellement sélectionnée.

Syntaxe

login target iadapter=<iadapter> [type={manual | persistent | boot}] [chap={none | oneway | mutual}] [iportal=<iportal>] [tportal=<tportal>] [<flag> [<flag> […]]]

Paramètres

Paramètre	Description
type	Spécifie le type de connexion à effectuer : manual our persistent. S’il n’est pas spécifié, une connexion manuelle est effectuée.
manual	Connectez-vous manuellement. Il existe également une option boot qui est destinée au développement futur et qui n’est pas utilisée actuellement.
persistent	Utilisez automatiquement la même connexion lorsque l’ordinateur est redémarré.
chap	Spécifie le type d’authentification CHAP à utiliser : none, oneway ou mutual ; s’il n’est pas spécifié, aucune authentification n’est utilisée.
tportal	Spécifie un portail cible facultatif dans le sous-système actuellement sélectionné à utiliser pour la connexion.
iportal	Spécifie un portail initiateur facultatif dans l’adaptateur d’initiateur spécifié à utiliser pour la connexion.
`<flag>`	Identifié par des acronymes à trois lettres : IPS - Exiger IPsec EMP - Activer les chemins d’accès multiples EHD - Activer la synthèse d’en-tête EDD - Activer la synthèse de données

logout

Journalise l’adaptateur d’initiateur iSCSI spécifié hors de la cible iSCSI actuellement sélectionnée.

Syntaxe

logout target iadapter= <iadapter>

Paramètres

Paramètre	Description
iadapter	Spécifie l’adaptateur initiateur avec une session de connexion à partir de laquelle se déconnecter.

maintenance

Effectue des opérations de maintenance sur l’objet actuellement sélectionné du type spécifié.

Syntaxe

maintenance <object operation> [count=<iteration>]

Paramètres

Paramètre	Description
`<object>`	Spécifie le type d’objet sur lequel effectuer l’opération. Le type object peut être un sous-système, un contrôleur, un port, un lecteur ou un LUN.
`<operation>`	Spécifie l’opération de maintenance à effectuer. Le type d’opération peut être spinup, spindown, blink, beep ou ping. Une opération doit être spécifiée.
count=	Spécifie le nombre de fois où répéter l’opération. Cela est généralement utilisé avec blink, beep,ou ping.

name

Définit le nom convivial du sous-système, du LUN ou de la cible iSCSI actuellement sélectionné sur le nom spécifié.

Syntaxe

name {subsystem | lun | target} [<name>]

Paramètre

Paramètre	Description
`<name>`	Spécifie un nom pour le sous-système, le LUN ou la cible. Le nom doit comporter moins de 64 caractères. Si aucun nom n’est fourni, le nom existant, le cas échéant, est supprimé.

hors connexion

Définit l’état de l’objet actuellement sélectionné du type spécifié sur offline.

Syntaxe

offline <object>

Paramètre

Paramètre	Description
`<object>`	Spécifie le type d’objet sur lequel effectuer cette opération. Le type peut être : subsystem, controller, drive, LUN ou tportal.

online

Définit l’état de l’objet sélectionné du type spécifié sur online. Si l’objet est hbaport, change l’état des chemins d’accès au port HBA actuellement sélectionné sur online.

Syntaxe

online <object>

Paramètre

Paramètre	Description
`<object>`	Spécifie le type d’objet sur lequel effectuer cette opération. Le type peut être : hbaport, subsystem, controller, drive, LUN ou tportal.

recover

Effectue les opérations nécessaires, comme la resynchronisation ou le remplacement à chaud, pour réparer le LUN à tolérance de panne actuellement sélectionné. Par exemple, RECOVER peut entraîner la liaison d’un disque d’échange à chaud à un jeu RAID qui a un disque défaillant ou une autre réaffectation d’extension de disque.

Syntaxe

recover <lun>

reenumerate

Énumère à nouveau les objets du type spécifié. Si vous utilisez la commande extend LUN, vous devez utiliser la commande refresh pour mettre à jour la taille du disque avant d’utiliser la commande reenumerate.

Syntaxe

reenumerate {subsystems | drives}

Paramètres

Paramètre	Description
sous-systèmes	Interroge le fournisseur pour découvrir les nouveaux sous-systèmes qui ont été ajoutés dans le fournisseur actuellement sélectionné.
lecteurs	Interroge les bus d’E/S internes pour découvrir les nouveaux lecteurs qui ont été ajoutés dans le sous-système actuellement sélectionné.

actualiser

Actualise les données internes pour le fournisseur actuellement sélectionné.

Syntaxe

refresh provider

rem

Utilisé pour commenter les scripts.

Syntaxe

Rem <comment>

remove

Supprime le portail cible iSCSI spécifié du groupe de portails cibles actuellement sélectionné.

Syntaxe

remove tpgroup tportal=<tportal> [noerr]

Paramètre

Paramètre	Description
tpgroup tportal=`<tportal>`	Spécifie le portail cible iSCSI à supprimer.
noerr	Pour les scripts uniquement. Lorsqu’une erreur est rencontrée, Diskraid continue de traiter les commandes comme si l’erreur ne s’était pas produite.

remplacer

Remplace le lecteur spécifié par le lecteur actuellement sélectionné. Le lecteur spécifié peut ne pas être le lecteur actuellement sélectionné.

Syntaxe

replace drive=<drive_number>

Paramètre

Paramètre	Description
drive=	Spécifie le `<drive_number>` pour le lecteur à remplacer.

reset

Réinitialise le contrôleur ou le port actuellement sélectionné.

Syntaxe

reset {controller | port}

Paramètres

Paramètre	Description
contrôleur	Réinitialise le contrôleur.
port	Réinitialise le port.

select

Affiche ou modifie l’objet actuellement sélectionné.

Syntaxe

select {hbaport | iadapter | iportal | provider | subsystem | controller | port | drive | lun | tportal | target | tpgroup } [<n>]

Paramètres

Paramètre	Description
object	Spécifie le type d’objet à sélectionner, notamment : provider, subsystem, controller, drive ou LUN.
hbaport `[<n>]`	Définit le focus sur le port HBA local spécifié. Si aucun port HBA n’est spécifié, la commande affiche le port HBA actuellement sélectionné (le cas échéant). La spécification d’un index de port HBA non valide ne met aucun port HBA en focus. La sélection d’un port HBA désélectionne les adaptateurs d’initiateur et les portails d’initiateur sélectionnés.
iadapter `[<n>]`	Définit le focus sur l’adaptateur initiateur iSCSI local spécifié. Si aucun adaptateur d’initiateur n’est spécifié, la commande affiche l’adaptateur d’initiateur actuellement sélectionné (le cas échéant). La spécification d’un index d’adaptateur d’initiateur non valide ne met aucun adaptateur d’initiateur en focus. La sélection d’un adaptateur d’initiateur désélectionne tous les ports HBA et portails d’initiateur sélectionnés.
iportal `[<n>]`	Définit le focus sur le portail d’initiateur iSCSI local spécifié dans l’adaptateur d’initiateur iSCSI sélectionné. Si aucun portail d’initiateur n’est spécifié, la commande affiche le portail d’initiateur actuellement sélectionné (le cas échéant). La spécification d’un index du portail d’initiateur non valide ne sélectionne aucun portail d’initiateur.
provider `[<n>]`	Affecte au focus du fournisseur spécifié. Si aucun fournisseur n’est spécifié, la commande affiche le fournisseur actuellement sélectionné (le cas échéant). La spécification d’un index de fournisseur non valide ne met aucun fournisseur en focus.
subsystem `[<n>]`	Affecte au focus du sous-système spécifié. Si aucun sous-système n’est spécifié, la commande affiche le sous-système avec le focus (le cas échéant). La spécification d’un index de sous-système non valide ne met aucun sous-système en focus. La sélection d’un sous-système sélectionne implicitement son fournisseur associé.
controller `[<n>]`	Définit le focus sur le contrôleur spécifié dans le sous-système actuellement sélectionné. Si aucun contrôleur n’est spécifié, la commande affiche le contrôleur actuellement sélectionné (le cas échéant). La spécification d’un index de contrôleur non valide ne met aucun contrôleur en focus. La sélection d’un contrôleur désélectionne les ports de contrôleur, les lecteurs, les LUN, les portails cibles, les cibles et les groupes de portails cibles sélectionnés.
port `[<n>]`	Définit le focus sur le port du contrôleur spécifié dans le contrôleur actuellement sélectionné. Si aucun port n’est spécifié, la commande affiche le port actuellement sélectionné (le cas échéant). La spécification d’un index de port non valide ne sélectionne aucun port.
drive `[<n>]`	Définit le focus sur le lecteur spécifié, ou le disque physique, dans le sous-système actuellement sélectionné. Si aucun lecteur n’est spécifié, la commande affiche le lecteur actuellement sélectionné (le cas échéant). La spécification d’un index de lecteur non valide ne met aucun lecteur en focus. La sélection d’un lecteur désélectionne les contrôleurs, ports de contrôleur, LUN, portails cibles, cibles et groupes de portails cibles sélectionnés.
lun `[<n>]`	Définit le focus sur le LUN spécifié dans le sous-système actuellement sélectionné. Si aucun LUN n’est spécifié, la commande affiche le LUN actuellement sélectionné (le cas échéant). La spécification d’un index LUN non valide entraîne la non-sélection de LUN. La sélection d’un LUN désélectionne les contrôleurs, ports de contrôleur, lecteurs, portails cibles, cibles et groupes de portails cibles sélectionnés.
tportal `[<n>]`	Définit le focus sur le portail cible iSCSI spécifié dans le sous-système actuellement sélectionné. Si aucun portail cible n’est spécifié, la commande affiche le portail cible actuellement sélectionné (le cas échéant). Si vous spécifiez un index de portail cible non valide, aucun portail cible n’est sélectionné. La sélection d’un portail cible désélectionne les contrôleurs, ports de contrôleur, lecteurs, LUN, cibles et groupes de portails cibles.
target `[<n>]`	Définit le focus sur la cible iSCSI spécifiée dans le sous-système actuellement sélectionné. Si aucune cible n’est spécifiée, la commande affiche la cible actuellement sélectionnée (le cas échéant). La spécification d’un index cible non valide ne sélectionne aucune cible. La sélection d’une cible désélectionne les contrôleurs, ports de contrôleur, lecteurs, LUN, portails cibles et groupes de portails cibles.
tpgroup `[<n>]`	Définit le focus sur le groupe de portails cibles iSCSI spécifié au sein de la cible iSCSI actuellement sélectionnée. Si aucun groupe de portails cibles n’est spécifié, la commande affiche le groupe de portails cibles actuellement sélectionné (le cas échéant). La spécification d’un index de groupe de portails cibles non valide ne met aucun groupe de portails cibles en focus.
`[<n>]`	Spécifie le `<object number>` à sélectionner. Si le `<object number>` spécifié n’est pas valide, toutes les sélections existantes pour les objets du type spécifié sont effacées. Si aucun `<object number>` n’est spécifié, l’objet actuel s’affiche.

setflag

Définit le lecteur actuellement sélectionné en tant que disque d’échange à chaud. Les disques de remplacement à chaud ne peuvent pas être utilisés pour les opérations de liaison de LUN ordinaires. Ils sont réservés à la gestion des erreurs uniquement. Le lecteur ne doit pas être actuellement lié à un LUN existant.

Syntaxe

setflag drive hotspare={true | false}

Paramètres

Paramètre	Description
true	Sélectionne le lecteur actuellement sélectionné en tant que disque d’échange à chaud.
false	Désélectionne le lecteur actuellement sélectionné en tant que disque d’échange à chaud.

shrink

Réduit la taille du LUN sélectionné.

Syntaxe

shrink lun size=<n> [noerr]

Paramètres

Paramètre	Description
taille	Spécifie la quantité d’espace souhaitée en mégaoctets (Mo) pour réduire la taille du LUN. Pour spécifier la taille à l’aide d’autres unités, utilisez l’un des suffixes reconnus suivants immédiatement après la taille : B - octets KB - kilo-octets MB - mégaoctets GB - gigaoctets TB - téraoctets PB - pétaoctets
noerr	Pour les scripts uniquement. Lorsqu’une erreur est rencontrée, Diskraid continue de traiter les commandes comme si l’erreur ne s’était pas produite.

secours

Modifie l’état des chemins d’accès au port de l’adaptateur de bus hôte (HBA) actuellement sélectionné sur EN ATTENTE.

Syntaxe

standby hbaport

Paramètres

Paramètre	Description
hbaport	Modifie l’état des chemins d’accès au port de l’adaptateur de bus hôte (HBA) actuellement sélectionné sur EN ATTENTE.

unmask

Rend les LUN actuellement sélectionnés accessibles à partir des hôtes spécifiés.

Syntaxe

unmask lun {all | none | [add] wwn=<hexadecimal_number> [;<hexadecimal_number> [;…]] | [add] initiator=<initiator>[;<initiator>[;…]]} [uninstall]

Paramètres

Paramètre	Description
all	Spécifie que le LUN doit être rendu accessible à partir de tous les hôtes. Toutefois, vous ne pouvez pas démasquer le LUN pour toutes les cibles d’un sous-système iSCSI. Vous devez vous déconnecter de la cible avant d’exécuter la commande `unmask lun all`.
Aucun	Spécifie que le LUN ne doit être accessible à aucun hôte. Vous devez vous déconnecter de la cible avant d’exécuter la commande `unmask lun none`.
add	Spécifie que les hôtes spécifiés doivent être ajoutés à la liste existante des hôtes à partir desquels ce LUN est accessible. Si ce paramètre n’est pas spécifié, la liste d’hôtes fournie remplace la liste existante d’hôtes à partir desquels ce LUN est accessible.
wwn=	Spécifie une liste de nombres hexadécimaux représentant des noms internationaux à partir desquels le LUN ou les hôtes doivent être rendus accessibles. Pour masquer/démasquer un ensemble spécifique d’hôtes dans un sous-système Fibre Channel, vous pouvez taper une liste séparée par des points-virgules de WWN pour les ports sur les machines hôtes concernées.
initiator=	Spécifie une liste d’initiateurs iSCSI pour lesquels le LUN actuellement sélectionné doit être accessible. Pour masquer/démasquer un ensemble spécifique d’hôtes dans un sous-système iSCSI, vous pouvez taper une liste séparée par des points-virgules de noms d’initiateur iSCSI pour les initiateurs sur les ordinateurs hôtes concernés.
uninstall	S’il est spécifié, désinstalle le disque associé au LUN sur le système local avant que le LUN soit masqué.

Scripts pour Diskraid

Diskraid peut être scripté sur n’importe quel ordinateur exécutant une version prise en charge de Windows Server, avec un fournisseur de matériel VDS associé. Pour appeler un script Diskraid, à l’invite de commandes, tapez :

diskraid /s <script.txt>

Par défaut, Diskraid arrête le traitement des commandes et retourne un code d’erreur en cas de problème dans le script. Pour continuer à exécuter le script et ignorer les erreurs, incluez le paramètre noerr sur la commande. Cela permet d’employer des pratiques utiles comme l’utilisation d’un script unique pour supprimer tous les LUN d’un sous-système, quel que soit le nombre total de LUN. Toutes les commandes ne prennent pas en charge le paramètre noerr. Les erreurs sont toujours retournées lors des erreurs de syntaxe de commande, que vous incluiez ou non le paramètre noerr.

Codes d’erreur Diskraid

Code d'erreur	Description de l’erreur
0	Aucune erreur ne s'est produite. Le script entier s’est exécuté sans échec.
1	Une exception fatale s’est produite.
2	Les arguments spécifiés sur une ligne de commande Diskraid étaient incorrects.
3	Diskraid n’a pas pu ouvrir le script ou le fichier de sortie spécifié.
4	L’un des services que Diskraid utilise a retourné un échec.
5	Une erreur de syntaxe de commande s’est produite. Le script a échoué, car un objet a été sélectionné de manière incorrecte ou n’était pas valide pour une utilisation avec cette commande.

Exemple

Pour afficher l’état du sous-système 0 sur votre ordinateur, tapez :

diskraid

Appuyez sur ENTRÉE, et une sortie semblable à la suivante s’affiche :

Microsoft Diskraid version 5.2.xxxx
Copyright (©) 2003 Microsoft Corporation
On computer: COMPUTER_NAME

Pour sélectionner le sous-système 0, tapez ce qui suit à l’invite Diskraid :

select subsystem 0

Appuyez sur ENTRÉE, et une sortie semblable à la suivante s’affiche :

Subsystem 0 is now the selected subsystem.

DISKRAID> list drives

  Drive ###  Status      Health          Size      Free    Bus  Slot  Flags
  ---------  ----------  ------------  --------  --------  ---  ----  -----
  Drive 0    Online      Healthy         107 GB    107 GB    0     1
  Drive 1    Offline     Healthy          29 GB     29 GB    1     0
  Drive 2    Online      Healthy         107 GB    107 GB    0     2
  Drive 3    Not Ready   Healthy          19 GB     19 GB    1     1

Pour quitter Diskraid, tapez ce qui suit à l’invite Diskraid :

exit

Clé de syntaxe de ligne de commande