Note
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de changer d’annuaire.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de changer d’annuaire.
Diskraid est un outil de ligne de commande qui vous permet de configurer et de gérer des sous-systèmes de stockage RAID (Redundant Array of Independent Disks).
RAID est généralement utilisé sur les serveurs pour normaliser et classer les systèmes de disque tolérants aux pannes. 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 plexes supplémentaires. Chaque plex contient une copie des données sur l’objet LUN. Les Plexes peuvent être ajoutés et supprimés d’un objet LUN.
La plupart des commandes Diskraid fonctionnent sur un port HBA spécifique, adaptateur d’initiateur, portail initiateur, fournisseur, sous-système, contrôleur, port, lecteur, LUN, portail cible, cible ou groupe de portail cible. La commande SELECT permet de 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 unités logiques dans le même sous-système.
Note
L’outil en ligne de commande Diskraid fonctionne uniquement avec les sous-systèmes de stockage qui prennent en charge virtual Disk Service (VDS).
Diskraid commands
Les commandes suivantes sont disponibles à partir de l’outil Diskraid.
add
Ajoute un numéro d’unité logique existant à l’unité logique actuellement sélectionnée ou ajoute un portail cible iSCSI au groupe de portails cible iSCSI actuellement sélectionné.
Syntax
add plex lun=n [noerr]
add tpgroup tportal=n [noerr]
Parameters
| Parameter | 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 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 n’a pas eu lieu. |
associate
Définit la liste spécifiée des ports du contrôleur comme étant actifs pour l’unité logique actuellement sélectionnée (d’autres ports de contrôleur sont inactifs) ou ajoute les ports de contrôleur spécifiés à la liste des ports de contrôleur actifs existants pour l’unité logique actuellement sélectionnée, ou associe la cible iSCSI spécifiée pour l’unité logique actuellement sélectionnée.
Syntax
associate controllers [add] <n>[,<n> [,…]]
associate ports [add] <n-m>[,<n-m>[,…]]
associate targets [add] <n>[,<n> [,…]]
Parameters
| Parameter | Description |
|---|---|
| controller | Ajoute ou remplace la liste des contrôleurs associés au numéro d’unité logique actuellement sélectionné. Utilisez uniquement 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 les fournisseurs VDS 1.1. |
| targets | Ajoute ou remplace la liste des cibles iSCSI associées au numéro d’unité logique actuellement sélectionné. Utilisez uniquement 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 de contrôleur remplace la liste existante des ports de contrôleur associés à ce numéro d’unité logique. |
<n>[,<n> [, ...]] |
À utiliser 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>[,…]] |
À utiliser avec le paramètre ports . Spécifie les ports de contrôleur à activer à l’aide d’une paire de numéro de contrôleur (n) et de numéro de port (m). |
Example
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 des conseils aux fournisseurs sur la configuration d’un LUN. Utilisée sans paramètres, l’opération automagique affiche une liste de drapeaux.
Syntax
automagic {set | clear | apply} all <flag=value> [<flag=value> [...]]
Parameters
| Parameter | 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 drapeaux 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 étendues de lecteur peuvent être récupérées.
Caution
Vous devez d’abord sélectionner un lun mis en miroir avant d’utiliser cette commande. Toutes les données sur le plex seront supprimées. Toutes les données contenues sur l’unité logique d’origine ne sont pas garanties d’être cohérentes.
Syntax
break plex=<plex_number> [noerr]
Parameters
| Parameter | Description |
|---|---|
| plex | Spécifie le nombre de 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. 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 l’écriture de scripts 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é CHAP (Challenge Handshake Authentication Protocol) afin que les initiateurs iSCSI et les cibles iSCSI puissent communiquer entre eux.
Syntax
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>
Parameters
| Parameter | 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 d’initiateur iSCSI local afin que le service initiateur puisse utiliser le secret pour s’authentifier auprès de la cible pendant 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. Si le secret est vide, il est effacé. |
| target | Spécifie une cible dans le sous-système actuellement sélectionné à associer au secret. Cela est facultatif lors de la définition d’un secret sur l’initiateur et de son abandon indique que le secret sera utilisé pour toutes les cibles qui n’ont pas encore de secret associé. |
| initiatorname | 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 de sa sortie indique que le secret sera utilisé pour tous les initiateurs qui n’ont pas encore de secret associé. |
create
Crée un numéro d’unité logique ou une cible iSCSI sur le sous-système actuellement sélectionné, ou crée un groupe de portails cible sur la cible actuellement sélectionnée. Vous pouvez afficher la liaison réelle à l’aide de la commande Diskraid list .
Syntax
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]
Parameters
| Parameter | Description |
|---|---|
| simple | Crée un LUN simple. |
| stripe | Crée un numéro d’unité logique à bandes. |
| raid | Crée un numéro d’unité logique à bandes avec parité. |
| mirror | Crée un LUN mis en miroir. |
| automagic | Crée un LUN à l’aide des indicateurs d’automagie actuellement en vigueur. Pour plus d’informations, consultez la sous-commande automagic dans cet article. |
| size= | Spécifie la taille totale des LUN en mégaoctets. Le paramètre size= ou drives= doit être spécifié. Ils peuvent également être utilisés ensemble. Si le paramètre size= n’est pas spécifié, la LUN créée sera la plus grande taille possible autorisée par tous les disques spécifiés. Un fournisseur crée généralement un NUMÉRO d’unité logique au moins aussi volumineux que la taille demandée, mais le fournisseur peut devoir arrondir à la plus grande taille suivante dans certains cas. Par exemple, si la taille est spécifiée en tant que .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 :
|
| drives= | Spécifie le drive_number que les disques doivent utiliser pour créer une LUN. Le paramètre size= ou drives= doit être spécifié. Ils peuvent également être utilisés ensemble. Si le paramètre size= n’est pas spécifié, la LUN créée 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 des lecteurs spécifiés pour créer le LUN. Les fournisseurs tenteront d’utiliser les lecteurs dans l’ordre spécifié si possible. |
| stripesize= | Spécifie la taille en mégaoctets d’un LUN de répartition ou de raid . La taille des bandes 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 l’écriture de scripts uniquement. Lorsqu’une erreur est rencontrée, Diskraid continue de traiter les commandes comme si l’erreur n’a pas eu lieu. |
delete
Supprime le numéro d’unité logique actuellement sélectionné, la cible iSCSI (tant qu’il n’y a pas d’unités logiques associées à la cible iSCSI) ou au groupe de portails cibles iSCSI.
Syntax
delete lun [uninstall] [noerr]
delete target [noerr]
delete tpgroup [noerr]
Parameters
| Parameter | Description |
|---|---|
| lun | Supprime le numéro d’unité logique actuellement sélectionné et toutes les données qu’il contient. |
| uninstall | Spécifie que le disque sur le système local associé au numéro d’unité logique sera nettoyé avant la suppression de l’unité logique. |
| target | Supprime la cible iSCSI actuellement sélectionnée si aucun numéro d’unité logique n’est associé à la cible. |
| tpgroup | Supprime le groupe de portail 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 n’a pas eu lieu. |
detail
Affiche des informations détaillées sur l’objet actuellement sélectionné du type spécifié.
Syntax
detail {hbaport | iadapter | iportal | provider | subsystem | controller | port | drive | lun | tportal | target | tpgroup} [verbose]
Parameters
| Parameter | Description |
|---|---|
| hbaport | Répertorie des informations détaillées sur le port HBA (Host Bus Adapter) 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é. |
| controller | 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é. |
| drive | Répertorie des informations détaillées sur le lecteur actuellement sélectionné, y compris les numéros logiques occupants. |
| lun | Répertorie des informations détaillées sur le numéro d’unité logique actuellement sélectionné, 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 Des hôtes non masqués contient uniquement un astérisque, cela signifie que le numéro d’unité logique est masqué à 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. |
dissociate
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 le numéro d’unité logique actuellement sélectionné.
Syntax
dissociate controllers <n> [,<n> [,...]]
dissociate ports <n-m>[,<n-m>[,…]]
dissociate targets <n> [,<n> [,…]]
Parameter
| Parameter | Description |
|---|---|
| controllers | Supprime les contrôleurs de la liste des contrôleurs associés au numéro d’unité logique actuellement sélectionné. Utilisez uniquement les fournisseurs VDS 1.0. |
| ports | Supprime les ports du contrôleur de la liste des ports de contrôleur associés au numéro d’unité logique actuellement sélectionné. Utilisez uniquement les fournisseurs VDS 1.1. |
| targets | Supprime les cibles de la liste des cibles iSCSI associées au numéro d’unité logique actuellement sélectionné. Utilisez uniquement les fournisseurs VDS 1.1. |
<n> [,<n> [,…]] |
À utiliser avec le paramètre controllers ou targets . Spécifie le nombre de contrôleurs ou de cibles iSCSI à définir comme inactifs ou dissociants. |
<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 de numéro de contrôleur (n) et de numéro de port (m). |
Example
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
Exits Diskraid.
Syntax
exit
extend
Étend le numéro d’unité logique actuellement sélectionné en ajoutant des secteurs à la fin de l’unité logique. Tous les fournisseurs ne prennent pas en charge l’extension des numéros d’unité logique. N’étend pas les volumes ou systèmes de fichiers contenus dans le numéro d’unité logique. Après avoir étendu le LUN, vous devez étendre les structures sur disque associées à l’aide de la commande DiskPart extend .
Syntax
extend lun [size=<LUN_size>] [drives=<drive_number>, [<drive_number>, ...]] [noerr]
Parameters
| Parameter | Description |
|---|---|
| size | Spécifie la taille en mégaoctets pour étendre le lun. La taille ou le <drive> paramètre doit être spécifié. Ils peuvent également être utilisés ensemble. Si le paramètre size= n’est pas spécifié, la LUN est étendue de la plus grande taille possible autorisée par tous les disques 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 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 :
|
| drives= | Spécifie la <drive_number> pour que les lecteurs utilisent lors de la création d’un numéro d’unité logique. La taille ou le <drive> paramètre doit être spécifié. Ils peuvent également être utilisés ensemble. Si le paramètre size= n’est pas spécifié, la LUN créée 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 l’écriture de scripts 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é.
Syntax
importtarget subsystem [set target]
Parameter
| Parameter | Description |
|---|---|
| set target | 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é. |
initiator
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’équilibrage de charge sur le numéro d’unité logique actuellement sélectionné.
Syntax
lbpolicy set lun type=<type> [paths=<path>-{primary | <weight>}[,<path>-{primary | <weight>}[,…]]]
lbpolicy set lun paths=<path>-{primary | <weight>}[,<path>-{primary | <weight>}[,…]]
Parameters
| Parameter | 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 :
|
| path | Spécifie si un chemin d’accès est principal ou s’il comporte un <weight>. Tous les chemins 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 actuellement sélectionnés. |
list
Affiche une liste d’objets du type spécifié.
Syntax
list {hbaports | iadapters | iportals | providers | subsystems | controllers | ports | drives | LUNs | tportals | targets | tpgroups}
Parameters
| Parameter | 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 (*). |
| providers | Répertorie les informations récapitulatives sur chaque fournisseur connu pour VDS. Le fournisseur actuellement sélectionné est marqué par un astérisque (*). |
| subsystems | 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 du contrôleur actuellement sélectionné. Le port actuellement sélectionné est marqué par un astérisque (*). |
| drives | 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 (*). |
| luns | Répertorie les 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 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 (*). |
| targets | Répertorie les 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 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.
Syntax
login target iadapter=<iadapter> [type={manual | persistent | boot}] [chap={none | oneway | mutual}] [iportal=<iportal>] [tportal=<tportal>] [<flag> [<flag> […]]]
Parameters
| Parameter | Description |
|---|---|
| type | Spécifie le type de connexion à effectuer : manuelle ou persistante. S’il n’est pas spécifié, une connexion manuelle est effectuée. |
| manual | Login manually. Il existe également une option de démarrage 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 : aucun, CHAP unidirectionnel ou CHAP mutuel ; S’il n’est pas spécifié, aucune authentification ne sera 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 d’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.
Syntax
logout target iadapter= <iadapter>
Parameters
| Parameter | 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é.
Syntax
maintenance <object operation> [count=<iteration>]
Parameters
| Parameter | Description |
|---|---|
<object> |
Spécifie le type d’objet sur lequel effectuer l’opération. Il peut s’agir d’un sous-système, d’un contrôleur, d’un port, d’un lecteur ou d’une LUN. |
<operation> |
Spécifie l’opération de maintenance à effectuer. Le type d’opération peut être spinup, spindown, clignotant, bip ou ping. Une opération doit être spécifiée. |
| count= | Spécifie le nombre de fois qu’il faut répéter l’opération. Ceci est généralement utilisé avec blink, bip ou ping. |
name
Définit le nom convivial du sous-système, lun ou cible iSCSI actuellement sélectionné avec le nom spécifié.
Syntax
name {subsystem | lun | target} [<name>]
Parameter
| Parameter | Description |
|---|---|
<name> |
Spécifie un nom pour le sous-système, lun ou cible. Le nom doit être inférieur à 64 caractères. Si aucun nom n’est fourni, le nom existant, le cas échéant, est supprimé. |
offline
Définit l’état de l’objet actuellement sélectionné du type spécifié sur hors connexion.
Syntax
offline <object>
Parameter
| Parameter | Description |
|---|---|
<object> |
Spécifie le type d’objet sur lequel effectuer cette opération. Il peut s’agir d’un sous-système, d’un contrôleur, d’un lecteur, d’une LUN ou d’un tportal. |
online
Définit l’état de l’objet sélectionné du type spécifié sur en ligne. Si object est hbaport, change l’état des chemins d’accès au port HBA actuellement sélectionné en online.
Syntax
online <object>
Parameter
| Parameter | Description |
|---|---|
<object> |
Spécifie le type d’objet sur lequel effectuer cette opération. Il peut s’agir du type : hbaport, sous-système, contrôleur, lecteur, LUN ou tportal. |
recover
Effectue les opérations nécessaires, telles que la resynchronisation ou l’éparse à chaud, pour réparer le lun à tolérance de panne actuellement sélectionné. Par exemple, RECOVER peut entraîner la liaison d’un disque à chaud à un jeu RAID ayant un disque défaillant ou une autre réaffectation de l’extension du disque.
Syntax
recover <lun>
reenumerate
Réumère 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 réumerate.
Syntax
reenumerate {subsystems | drives}
Parameters
| Parameter | Description |
|---|---|
| subsystems | Interroge le fournisseur pour découvrir les nouveaux sous-systèmes qui ont été ajoutés au fournisseur actuellement sélectionné. |
| drives | Interroge les bus d’E/S internes pour découvrir les nouveaux lecteurs ajoutés dans le sous-système actuellement sélectionné. |
refresh
Actualise les données internes du fournisseur actuellement sélectionné.
Syntax
refresh provider
rem
Utilisé pour commenter des scripts.
Syntax
Rem <comment>
remove
Supprime le portail cible iSCSI spécifié du groupe de portails cible actuellement sélectionné.
Syntax
remove tpgroup tportal=<tportal> [noerr]
Parameter
| Parameter | 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 n’a pas eu lieu. |
replace
Remplace le lecteur spécifié par le lecteur actuellement sélectionné. Le lecteur spécifié peut ne pas être le lecteur actuellement sélectionné.
Syntax
replace drive=<drive_number>
Parameter
| Parameter | Description |
|---|---|
| drive= | Spécifie la <drive_number> du lecteur à remplacer. |
reset
Réinitialise le contrôleur ou le port actuellement sélectionné.
Syntax
reset {controller | port}
Parameters
| Parameter | Description |
|---|---|
| controller | Réinitialise le contrôleur. |
| port | Réinitialise le port. |
select
Affiche ou modifie l’objet actuellement sélectionné.
Syntax
select {hbaport | iadapter | iportal | provider | subsystem | controller | port | drive | lun | tportal | target | tpgroup } [<n>]
Parameters
| Parameter | Description |
|---|---|
| object | Spécifie le type d’objet à sélectionner, notamment : 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 initiateurs et les portails initiateurs sélectionnés. |
iAdaptateur [<n>] |
Définit le focus sur l’adaptateur initiateur iSCSI local spécifié. Si aucune carte 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 en focus. La sélection d’une carte d’initiateur désélectionne les ports HBA et les portails initiateurs sélectionnés. |
[<n>] iportal |
Définit le focus sur le portail d’initiateur iSCSI local spécifié dans l’adaptateur initiateur iSCSI sélectionné. Si aucun portail initiateur n’est spécifié, la commande affiche le portail initiateur actuellement sélectionné (le cas échéant). La spécification d’un index du portail initiateur non valide n’entraîne aucun portail initiateur sélectionné. |
[<n>] fournisseur |
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 actif. |
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 le focus (le cas échéant). La spécification d’un index de sous-système non valide n’entraîne aucun sous-système en 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 actif. La sélection d’un contrôleur désélectionne tous les ports, lecteurs, numéros d’unité logique sélectionnés, portails cibles, cibles et groupes de portails cibles. |
[<n>] de port |
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 entraîne l’absence de port sélectionné. |
lecteur [<n>] |
Définit le focus sur le lecteur spécifié, ou le spindle 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 en focus. La sélection d’un lecteur désélectionne les contrôleurs sélectionnés, les ports de contrôleur, les numéros d’unité logique, 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 aucun numéro d’unité logique n’est spécifié, la commande affiche le numéro d’unité logique actuellement sélectionné (le cas échéant). La spécification d’un index d’unité logique non valide entraîne l’absence d’unité logique sélectionnée. La sélection d’un numéro d’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. |
[<n>] tportal |
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 n’entraîne aucun portail cible sélectionné. La sélection d’un portail cible désélectionne tous les contrôleurs, ports de contrôleur, lecteurs, numéros d’unité logique, cibles et groupes de portails cibles. |
[<n>] cible |
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 d’unité logique, 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 portails cible actuellement sélectionné (le cas échéant). La spécification d’un index de groupe de portail cible non valide n’entraîne aucun groupe de portail cible en focus. |
[<n>] |
Spécifie la <object number> à sélectionner. Si la <object number> spécifiée n’est pas valide, toutes les sélections existantes pour les objets du type spécifié sont effacées. Si aucune <object number> n’est spécifiée, l’objet actif s’affiche. |
setflag
Définit le lecteur actuellement sélectionné en tant que disque de rechange à chaud. Les disques de rechange à chaud ne peuvent pas être utilisés pour les opérations de liaison d’unité logique ordinaires. Ils sont réservés uniquement à la gestion des erreurs. Le lecteur ne doit pas être actuellement lié à un numéro d’unité logique existant.
Syntax
setflag drive hotspare={true | false}
Parameters
| Parameter | 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.
Syntax
shrink lun size=<n> [noerr]
Parameters
| Parameter | Description |
|---|---|
| size | 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 l’écriture de scripts uniquement. Lorsqu’une erreur est rencontrée, Diskraid continue de traiter les commandes comme si l’erreur n’a pas eu lieu. |
standby
Modifie l’état des chemins d’accès au port HBA (Host Bus Adapter) actuellement sélectionné en MODE VEILLE.
Syntax
standby hbaport
Parameters
| Parameter | Description |
|---|---|
| hbaport | Modifie l’état des chemins d’accès au port HBA (Host Bus Adapter) actuellement sélectionné en MODE VEILLE. |
unmask
Rend les unités logiques actuellement sélectionnées accessibles à partir des hôtes spécifiés.
Syntax
unmask lun {all | none | [add] wwn=<hexadecimal_number> [;<hexadecimal_number> [;…]] | [add] initiator=<initiator>[;<initiator>[;…]]} [uninstall]
Parameters
| Parameter | 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 pour toutes les cibles d’un sous-système iSCSI. Vous devez vous déconnecter de la cible avant d’exécuter la commande |
| none | 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 commande |
| add | Spécifie que les hôtes spécifiés doivent être ajoutés à la liste existante d’hôtes à partir duquel 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 à partir duquel ce numéro d’unité logique 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 qui vous intéressent. |
| initiator= | Spécifie une liste d’initiateurs iSCSI auxquels le numéro d’unité logique actuellement sélectionné doit être rendu 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 des noms d’initiateur iSCSI pour les initiateurs sur les ordinateurs hôtes d’intérêt. |
| uninstall | S’il est spécifié, désinstalle le disque associé au numéro d’unité logique sur le système local avant le masquage de l’unité logique. |
Scripting 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 dans 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 d’unités logiques. Toutes les commandes ne prennent pas en charge le paramètre noerr . Les erreurs sont toujours renvoyées sur les erreurs de syntaxe de commande, que vous ayez inclus ou non le paramètre noerr .
Codes d’erreur diskraid
| Error Code | Error Description |
|---|---|
| 0 | Aucune erreur n’a eu lieu. Le script entier 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 que Diskraid utilise retourne 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. |
Example
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