Diskraid
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 normaliser et classer les systèmes de disque à tolérance de panne. Les niveaux RAID fournissent différentes combinaisons de performances, de fiabilité et de coûts. Certains serveurs fournissent trois niveaux RAID : niveau 0 (bandes), Niveau 1 (mise en miroir) et Niveau 5 (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 HBA (Host Bus Adapter), 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 portail cible. Vous utilisez la commande SELECT pour sélectionner un objet. L’objet sélectionné est dit avoir le focus. Le focus simplifie les tâches de configuration courantes, telles que la création de plusieurs numéros d’unité logique au sein du 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 Virtual Disk Service (VDS).
Commandes Diskraid
Les commandes suivantes sont disponibles à partir de l’outil Diskraid.
add
Ajoute un numéro d’unité logique existant au numéro d’unité logique actuellement sélectionné ou ajoute un portail cible iSCSI au groupe de portails cible 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 numéro d’unité logique ajoutée en tant que plex seront supprimées. |
tpgroup tportal=<n> |
Spécifie le numéro du portail cible iSCSI à ajouter au groupe de portails cible iSCSI actuellement sélectionné. |
| noerr | Pour l’écriture de scripts uniquement. Lorsqu’une erreur est rencontrée, Diskraid continue de traiter les commandes comme si l’erreur ne s’est pas produite. |
Associé
Définit la liste spécifiée des ports du contrôleur comme étant actifs pour le numéro d’unité logique actuellement sélectionné (d’autres ports du contrôleur sont inactifs), ou ajoute les ports de contrôleur spécifiés à la liste des ports de contrôleur actifs existants pour le numéro d’unité logique actuellement sélectionné, ou associe la cible iSCSI spécifiée pour le numéro logique actuellement 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 numéro d’unité logique 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 numéro d’unité logique actuellement sélectionné. Utilisez uniquement avec les fournisseurs VDS 1.1. |
| cibles | Ajoute ou remplace la liste des cibles iSCSI associées au numéro d’unité logique 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 numéro d’unité logique. Si ce paramètre n’est pas spécifié, la liste des contrôleurs remplace la liste existante des contrôleurs associés à ce numéro d’unité logique. 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 numéro d’unité logique. Si ce paramètre n’est pas spécifié, la liste des ports du contrôleur remplace la liste existante des ports de contrôleur associés à ce numéro d’unité logique. |
<n>[,<n> [, ...]] |
Utilisez le paramètre contrôleurs ou cibles . Spécifie le nombre de contrôleurs ou de cibles iSCSI à définir sur actif ou associé. |
<n-m>[,<n-m>[,…]] |
Utilisez-le avec le paramètre de ports . Spécifie les ports du contrôleur à définir 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 numéro d’unité logique 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 des indications aux fournisseurs sur la configuration d’un numéro d’unité logique. Utilisée sans paramètre, l’opération automagique 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 automagiques. |
| apply | Applique les indicateurs actuels au numéro d’unité logique sélectionné. |
<flag> |
Les indicateurs sont identifiés par des acronymes à trois lettres, notamment :
|
break
Supprime le plex de l’unité logique actuellement sélectionnée. Le plex et les données qu’il contenait ne sont pas conservés, et les extensions de lecteur peuvent être récupérées.
Attention
Vous devez d’abord sélectionner un numéro d’unité logique en miroir avant d’utiliser cette commande. Toutes les données sur le plex seront supprimées. Toutes les données contenues dans le numéro d’unité logique d’origine ne sont pas garanties d’être cohérentes.
Syntaxe
break plex=<plex_number> [noerr]
Paramètres
| Paramètre | Description |
|---|---|
| Plex | Spécifie le nombre de plex à supprimer. Les plex et les données qu’il contenait ne seront pas conservées, et les ressources utilisées par ce plex seront récupérées. Les données contenues dans l’unité logique ne sont pas garanties d’être cohérentes. Si vous souhaitez conserver ce plex, utilisez le service VSS (Volume Shadow Copy Service). |
| noerr | Pour le script uniquement. Lorsqu’une erreur est rencontrée, Diskraid continue de traiter les commandes comme si l’erreur n’a pas eu lieu. |
Chap
Définit le secret partagé Challenge Handshake Authentication Protocol (CHAP) 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 |
|---|---|
| jeu d’initiateurs | Définit le secret partagé dans le service initiateur iSCSI local utilisé pour l’authentification CHAP mutuelle lorsque l’initiateur authentifie la cible. |
| l’initiateur se rappelle | Communique le secret CHAP d’une cible iSCSI au service initiateur iSCSI local afin que le service initiateur puisse utiliser le secret pour s’authentifier auprès de la cible pendant l’authentification CHAP. |
| jeu cible | 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. |
| cible rappelez-vous | 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. Si la clé secrète est vide, elle est effacée. |
| target | Spécifie une cible dans le sous-système actuellement sélectionné pour l’associer au secret. Cette option est facultative lors de la définition d’un secret sur l’initiateur et de la quitter indique que le secret sera utilisé pour toutes les cibles qui n’ont pas déjà de secret associé. |
| nom de l’initiateur | Spécifie un nom iSCSI initiateur à associer au secret. Cette option est facultative lors de la définition d’un secret sur une cible et indique que le secret sera utilisé pour tous les initiateurs qui n’ont pas déjà de secret associé. |
créer
Crée une cible LUN ou iSCSI sur le sous-système actuellement sélectionné ou crée un groupe de portail cible 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 une unité logique simple. |
| frange | Crée un numéro d’unité logique en bandes. |
| Raid | Crée un LUN en bandes avec parité. |
| mirror | Crée un LUN mis en miroir. |
| automagique | Crée un LUN à l’aide des indicateurs automagiques actuellement en vigueur. Pour plus d’informations, consultez la sous-commande automagic dans cet article. |
| size= | Spécifie la taille totale de l’unité logique en mégaoctets. La taille= ou le paramètre drive= doivent être spécifiés. Ils peuvent également être utilisés ensemble. Si le paramètre size= n’est pas spécifié, le numéro d’unité logique créé sera 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 la plus importante suivante dans certains cas. Par exemple, si la taille est spécifiée sous la forme .99 Go et que le fournisseur ne peut allouer que des étendues de disque Go, le numéro d’unité logique 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 :
|
| drive= | Spécifie la drive_number des lecteurs à utiliser pour créer une unité logique. La taille= ou le paramètre drive= doivent être spécifiés. Ils peuvent également être utilisés ensemble. Si le paramètre size= n’est pas spécifié, le lun 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 des lecteurs dans la liste de lecteurs spécifiée pour créer le numéro d’unité logique. Les fournisseurs tenteront d’utiliser les lecteurs dans l’ordre spécifié si possible. |
| stripesize= | Spécifie la taille en mégaoctets d’une bande ou d’un numéro d’unité logique raid . La bande ne peut pas être modifiée après la création de l’unité logique. Pour spécifier la taille à l’aide d’autres unités, utilisez l’un des suffixes reconnus suivants immédiatement après la taille :
|
| 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 le script uniquement. Lorsqu’une erreur est rencontrée, Diskraid continue de traiter les commandes comme si l’erreur n’a pas eu lieu. |
supprimer
Supprime le numéro d’unité logique actuellement sélectionné, la cible iSCSI (tant qu’il n’existe aucun numéro d’unité logique associé à la cible iSCSI) ou au groupe de portails cibles iSCSI.
Syntaxe
delete lun [uninstall] [noerr]
delete target [noerr]
delete tpgroup [noerr]
Paramètres
| Paramètre | Description |
|---|---|
| lun | Supprime l’unité logique actuellement sélectionnée et toutes les données sur celle-ci. |
| uninstall | Spécifie que le disque sur le système local associé à l’unité logique sera nettoyé avant la suppression de l’unité logique. |
| target | Supprime la cible iSCSI actuellement sélectionnée si aucune unité logique n’est associée à la cible. |
| tpgroup | Supprime le groupe de portail cible iSCSI actuellement sélectionné. |
| noerr | Pour le script uniquement. Lorsqu’une erreur est rencontrée, Diskraid continue de traiter les commandes comme si l’erreur n’a pas eu lieu. |
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 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 numéros de requête occupants. |
| lun | Répertorie des informations détaillées sur l’unité logique actuellement sélectionnée, y compris les lecteurs contributeurs. La sortie diffère légèrement selon que le numéro d’unité logique fait partie d’un sous-système Fibre Channel ou iSCSI. Si la liste hôtes non masquées contient uniquement un astérisque, cela signifie que le numéro d’unité logique est masqué sur 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 portail cible iSCSI actuellement sélectionné. |
| verbose | Pour une utilisation uniquement avec le paramètre LUN. Répertorie des informations supplémentaires, y compris ses plexes. |
Dissocier
Définit la liste spécifiée des ports du contrôleur comme inactifs pour l’unité logique actuellement sélectionnée (d’autres ports de contrôleur ne sont pas affectés) ou dissocie la liste spécifiée des cibles iSCSI pour l’unité logique actuellement sélectionnée.
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 à l’unité logique actuellement sélectionnée. Utilisez uniquement les fournisseurs VDS 1.0. |
| ports | Supprime les ports de contrôleur de la liste des ports de contrôleur associés à l’unité logique actuellement sélectionnée. Utilisez uniquement les fournisseurs VDS 1.1. |
| cibles | Supprime les cibles de la liste des cibles iSCSI associées à l’unité logique actuellement sélectionnée. Utilisez uniquement les fournisseurs VDS 1.1. |
<n> [,<n> [,…]] |
Pour une utilisation avec le paramètre contrôleurs ou cibles . Spécifie le nombre de contrôleurs ou de cibles iSCSI à définir comme inactifs ou dissociants. |
<n-m>[,<n-m>[,…]] |
Pour une utilisation avec le paramètre de ports . Spécifie les ports du 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.
Syntax
exit
extend
Étend l’unité logique actuellement sélectionnée en ajoutant des secteurs à la fin de l’unité logique. Tous les fournisseurs ne prennent pas en charge l’extension des numéros de domaine logiques. N’étend aucun volume ou système de fichiers contenu dans l’unité logique. Après avoir étendu le numéro d’unité logique, 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 numéro d’unité logique. La taille ou le <drive> paramètre doivent être spécifiés. Ils peuvent également être utilisés ensemble. Si le paramètre size= n’est pas spécifié, le numéro d’unité logique est étendu par la taille la plus grande possible autorisée par tous les lecteurs spécifiés. Si le paramètre size= est spécifié, les fournisseurs sélectionnent des lecteurs dans la liste spécifiée par le paramètre drive= pour créer le numéro d’unité logique. Pour spécifier la taille à l’aide d’autres unités, utilisez l’un des suffixes reconnus suivants immédiatement après la taille :
|
| drive= | Spécifie les <drive_number> lecteurs à utiliser lors de la création d’une unité logique. La taille ou le <drive> paramètre doivent être spécifiés. Ils peuvent également être utilisés ensemble. Si le paramètre size= n’est pas spécifié, le lun 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é si possible. |
| noerr | Pour le script uniquement. Lorsqu’une erreur est rencontrée, Diskraid continue de traiter les commandes comme si l’erreur n’a pas eu lieu. |
flushcache
Efface le cache sur le contrôleur actuellement sélectionné.
Syntax
flushcache controller
help
Affiche la liste de toutes les commandes Diskraid.
Syntax
help
importtarget
Récupère ou définit la cible d’importation VSS (Volume Shadow Copy Service) actuelle définie pour le sous-système actuellement sélectionné.
Syntaxe
importtarget subsystem [set target]
Paramètre
| Paramètre | Description |
|---|---|
| définir la cible | Si elle est spécifiée, définit la cible actuellement sélectionnée sur la cible d’importation VSS pour le sous-système actuellement sélectionné. Si elle n’est pas spécifiée, 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.
Syntax
initiator
invalidatecache
Invalide le cache sur le contrôleur actuellement sélectionné.
Syntax
invalidatecache controller
lbpolicy
Définit la stratégie d’équilibre de charge sur l’unité logique actuellement sélectionnée.
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 | Spécifie la stratégie d’équilibre de charge. Si le type n’est pas spécifié, le paramètre de chemin d’accès doit être spécifié. Type peut avoir l’une des valeurs suivantes :
|
| path | Spécifie si un chemin d’accès est principal ou a un particulier <weight>. Les chemins d’accès non spécifiés sont implicitement définis comme sauvegarde. Tous les chemins répertoriés doivent être l’un des chemins d’accès de l’unité logique actuellement sélectionnés. |
list
Affiche une liste d’objets 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 les informations récapitulatives sur tous les ports HBA connus pour VDS. Le port HBA actuellement sélectionné est marqué par un astérisque (*). |
| iadapters | Répertorie les informations récapitulatives sur tous les adaptateurs initiateurs iSCSI connus pour VDS. L’adaptateur initiateur actuellement sélectionné est marqué par un astérisque (*). |
| iportals | Répertorie les informations récapitulatives sur tous les portails initiateurs iSCSI dans l’adaptateur initiateur actuellement sélectionné. Le portail initiateur actuellement sélectionné est marqué par un astérisque (*). |
| fournisseurs | Répertorie les informations récapitulatives sur chaque fournisseur connu pour 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 les 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 les 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 les informations récapitulatives sur chaque lecteur du sous-système actuellement sélectionné. Le lecteur actuellement sélectionné est marqué par un astérisque (*). |
| Lun | Répertorie les informations récapitulatives sur chaque LUN dans le sous-système actuellement sélectionné. L’unité logique actuellement sélectionnée est marquée par un astérisque (*). |
| tportals | Répertorie les 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 les informations récapitulatives sur toutes les cibles iSCSI du sous-système actuellement sélectionné. La cible actuellement sélectionnée est marquée par un astérisque (*). |
| tpgroups | Répertorie les 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 (*). |
login
Enregistre l’adaptateur 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 : manuel ou persistant. Si elle n’est pas spécifiée, une connexion manuelle est effectuée. |
| manual | Connectez-vous manuellement. Il existe également une option de démarrage destinée au développement futur et qui n’est pas utilisée actuellement. |
| Persistante | Utilisez automatiquement la même connexion lorsque l’ordinateur est redémarré. |
| Chap | Spécifie le type d’authentification CHAP à utiliser : aucun, chap ou chap mutuel ; si elle n’est pas spécifiée, 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 initiateur spécifié à utiliser pour la connexion. |
<flag> |
Identifié par des acronymes à trois lettres :
|
logout
Enregistre l’adaptateur 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 d’objet peut être un sous-système, un contrôleur, un port, un lecteur ou un numéro d’unité logique. |
<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 clignotement, bip ou ping. |
name
Définit le nom convivial du sous-système, du numéro d’unité logique ou de la cible iSCSI actuellement sélectionné avec 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 numéro d’unité logique 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é en mode hors connexion.
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 : sous-système, contrôleur, lecteur, LUN ou tportal. |
online
Définit l’état de l’objet sélectionné du type spécifié en ligne. Si l’objet est hbaport, modifie l’état des chemins d’accès au port HBA actuellement sélectionné en ligne.
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, sous-système, contrôleur, lecteur, LUN ou tportal. |
recover
Effectue les opérations nécessaires, telles que la resynchronisation ou la parcage à chaud, pour réparer le numéro d’unité logique à tolérance de panne actuellement sélectionné. Par exemple, RECOVER peut entraîner la liaison d’un disque d’échange à chaud à un jeu RAID ayant un disque défaillant ou une autre réaffectation de l’extension du disque.
Syntax
recover <lun>
réenumerate
Réenumer 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 de réumerate.
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 au 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é.
Syntax
refresh provider
rem
Utilisé pour commenter des scripts.
Syntax
Rem <comment>
suppression
Supprime le portail cible iSCSI spécifié du groupe de portails cible 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 l’écriture de scripts uniquement. Lorsqu’une erreur est rencontrée, Diskraid continue de traiter les commandes comme si l’erreur ne s’est 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> 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, y compris : fournisseur, sous-système, contrôleur, lecteur ou LUN. |
hbaport [<n>] |
Définit le focus sur le port DBA 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 n’entraîne aucun port HBA en focus. La sélection d’un port HBA désélectionne les adaptateurs d’initiateur et les portails initiateurs sélectionnés. |
iadapter [<n>] |
Définit le focus sur l’adaptateur initiateur iSCSI local spécifié. Si aucune carte d’initiateur n’est spécifiée, la commande affiche l’adaptateur initiateur actuellement sélectionné (le cas échéant). La spécification d’un index d’adaptateur initiateur non valide entraîne l’absence d’adaptateur initiateur au focus. La sélection d’une carte d’initiateur désélectionne les ports HBA et les portails initiateurs sélectionnés. |
iportal [<n>] |
Définit le focus sur le portail d’initiateur iSCSI local spécifié dans l’adaptateur 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 de portail d’initiateur non valide ne génère aucun portail initiateur sélectionné. |
Fournisseur [<n>] |
Définit le focus sur le 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 entraîne l’absence de fournisseur en focus. |
Sous-système [<n>] |
Définit le focus sur le sous-système spécifié. Si aucun sous-système n’est spécifié, la commande affiche le sous-système avec focus (le cas échéant). La spécification d’un index de sous-système non valide entraîne l’absence de sous-système focus. La sélection d’un sous-système sélectionne implicitement son fournisseur associé. |
Contrôleur [<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 entraîne l’absence de contrôleur en focus. La sélection d’un contrôleur désélectionne les ports de contrôleur, lecteurs, numéros de domaine logiques, portails cibles, cibles et groupes de portails cibles sélectionnés. |
Port [<n>] |
Définit le focus sur le port de 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 génère aucun port sélectionné. |
Disque [<n>] |
Définit le focus sur le lecteur spécifié ou la broche 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 entraîne l’absence de lecteur au focus. La sélection d’un lecteur désélectionne les contrôleurs sélectionnés, les ports de contrôleur, les numéros de commande, les portails cibles, les cibles et les groupes de portails cibles. |
lun [<n>] |
Définit le focus sur l’unité logique spécifiée dans le sous-système actuellement sélectionné. Si aucune unité logique n’est spécifiée, la commande affiche l’unité logique actuellement sélectionnée (le cas échéant). La spécification d’un index lun non valide entraîne l’absence de numéro d’unité logique sélectionné. La sélection d’une unité logique désélectionne les contrôleurs sélectionnés, les ports de contrôleur, les lecteurs, les portails cibles, les cibles et les groupes de portails cibles. |
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). La spécification d’un index de portail cible non valide ne génère aucun portail cible sélectionné. La sélection d’un portail cible désélectionne les contrôleurs, les ports de contrôleur, les lecteurs, les numéros de requête, les cibles et les groupes de portails cibles. |
Cible [<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 entraîne l’absence de cible sélectionnée. La sélection d’une cible désélectionne les contrôleurs, les ports de contrôleur, les lecteurs, les numéros de commande, les portails cibles et les groupes de portails cibles. |
tpgroup [<n>] |
Définit le focus sur le groupe de portail cible iSCSI spécifié dans la cible iSCSI actuellement sélectionnée. Si aucun groupe de portail cible n’est spécifié, la commande affiche le groupe de portail cible actuellement sélectionné (le cas échéant). La spécification d’un index de groupe de portail cible non valide ne génère aucun groupe de portail cible en focus. |
[<n>] |
Spécifie la <object number> sélection. Si la <object number> valeur spécifiée n’est pas valide, toutes les sélections existantes pour les objets du type spécifié sont effacées. Si aucun n’est <object number> spécifié, l’objet actif est affiché. |
setflag
Définit le lecteur actuellement sélectionné en tant que disque de rechange à chaud. Les pièces de rechange à chaud ne peuvent pas être utilisées pour les opérations de liaison de lun ordinaires. Ils sont réservés uniquement à la gestion des pannes. Le lecteur ne doit pas être actuellement lié à une unité logique existante.
Syntaxe
setflag drive hotspare={true | false}
Paramètres
| Paramètre | Description |
|---|---|
| true | Sélectionne le lecteur actuellement sélectionné en tant que disque de rechange à chaud. |
| false | Désélectionne le lecteur actuellement sélectionné en tant que disque de rechange à chaud. |
shrink
Réduit la taille de l’unité logique sélectionnée.
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 de l’unité logique. Pour spécifier la taille à l’aide d’autres unités, utilisez l’un des suffixes reconnus suivants immédiatement après la taille :
|
| noerr | Pour le script uniquement. Lorsqu’une erreur est rencontrée, Diskraid continue de traiter les commandes comme si l’erreur n’a pas eu lieu. |
secours
Modifie l’état des chemins d’accès au port HBA (Host Bus Adapter) actuellement sélectionné en MODE VEILLE.
Syntaxe
standby hbaport
Paramètres
| Paramètre | Description |
|---|---|
| hbaport | Modifie l’état des chemins d’accès au port HBA (Host Bus Adapter) actuellement sélectionné en MODE VEILLE. |
Démasquer
Rend les numéros de domaine logiques 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 l’unité logique doit être rendue accessible à partir de tous les hôtes. Toutefois, vous ne pouvez pas supprimer le numéro d’unité logique sur toutes les cibles d’un sous-système iSCSI. Vous devez vous déconnecter de la cible avant d’exécuter la |
| aucun | Spécifie que le numéro d’unité logique ne doit pas être accessible à un hôte. Vous devez vous déconnecter de la cible avant d’exécuter la |
| add | Spécifie que les hôtes spécifiés doivent être ajoutés à la liste existante des hôtes auxquels ce numéro d’unité logique est accessible. Si ce paramètre n’est pas spécifié, la liste des hôtes fournis remplace la liste existante des hôtes auxquels cette lun est accessible. |
| wwn= | Spécifie une liste de nombres hexadécimaux représentant des noms à l’échelle mondiale à partir desquels les lun ou les hôtes doivent être rendus accessibles. Pour masquer/dissocier 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 pour les ports sur les ordinateurs hôtes d’intérêt. |
| initiateur= | Spécifie une liste d’initiateurs iSCSI auxquels l’unité logique actuellement sélectionnée doit être rendue accessible. Pour masquer/dissocier 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 d’intérêt. |
| uninstall | Si elle est spécifiée, désinstalle le disque associé au numéro d’unité logique sur le système local avant le masquage de l’unité logique. |
Script 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 s’il existe un 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 de telles pratiques utiles que l’utilisation d’un seul script pour supprimer toutes les unités logiques d’un sous-système, quel que soit le nombre total de numéros de requête. Toutes les commandes ne prennent pas en charge le paramètre noerr . Les erreurs sont toujours retournées sur les erreurs de syntaxe de commande, que vous ayez inclus le paramètre noerr .
Codes d’erreur Diskraid
| Code d'erreur | Description de l’erreur |
|---|---|
| 0 | Aucune erreur ne s'est produite. L’ensemble du script s’est exécuté sans échec. |
| 1 | Une exception irrécupérable 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 Diskraid utilise 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’est 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 sortie comme suit :
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 sortie comme suit :
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