Freigeben über


Diskraid

Diskraid ist ein Befehlszeilentool, mit dem Sie redundante RAID-Speichersubsysteme (Array of Independent (oder kostengünstige) Festplatten (RAID) konfigurieren und verwalten können.

RAID wird in der Regel auf Servern verwendet, um fehlertolerante Datenträgersysteme zu standardisieren und zu kategorisieren. RAID-Level bieten verschiedene Kombinationen aus Leistung, Zuverlässigkeit und Kosten. Einige Server bieten drei DER RAID-Ebenen: Level 0 (Striping), Level 1 (Spiegelung) und Level 5 (Streifen mit Parität).

Ein Hardware-RAID-Subsystem unterscheidet physisch adressierbare Speichereinheiten voneinander mithilfe einer Logischen Einheitsnummer (Logical Unit Number, LUN). Ein LUN-Objekt muss mindestens einen Plex aufweisen und kann eine beliebige Anzahl zusätzlicher Plexes aufweisen. Jeder Plex enthält eine Kopie der Daten des LUN-Objekts. Plexes können einem LUN-Objekt hinzugefügt und daraus entfernt werden.

Die meisten Diskraid-Befehle werden auf einem bestimmten Hostbusadapter (HBA)-Port, Initiatoradapter, Initiatorportal, Anbieter, Subsystem, Controller, Port, Laufwerk, LUN, Zielportal, Ziel- oder Zielportalgruppe ausgeführt. Mit dem Befehl SELECT können Sie ein Objekt auswählen. Das ausgewählte Objekt soll den Fokus haben. Der Fokus vereinfacht allgemeine Konfigurationsaufgaben, z. B. das Erstellen mehrerer LUNs innerhalb desselben Subsystems.

Note

Das Befehlszeilentool Diskraid funktioniert nur mit Speichersubsystemen, die den Virtual Disk Service (VDS) unterstützen.

Diskraid commands

Die folgenden Befehle stehen im Diskraid-Tool zur Verfügung.

add

Fügt der aktuell ausgewählten LUN eine vorhandene LUN hinzu, oder fügt der aktuell ausgewählten iSCSI-Zielportalgruppe ein iSCSI-Zielportal hinzu.

Syntax

add plex lun=n [noerr]
add tpgroup tportal=n [noerr]
Parameters
Parameter Description
plex lun=<n> Gibt die LUN-Nummer an, die dem aktuell ausgewählten LUN als Plex hinzugefügt werden soll. ACHTUNG: Alle Daten zum LUN, die als Plex hinzugefügt werden, werden gelöscht.
tpgroup tportal=<n> Gibt die iSCSI-Zielportalnummer an, die der aktuell ausgewählten iSCSI-Zielportalgruppe hinzugefügt werden soll.
noerr Nur für Skripts. Wenn ein Fehler auftritt, verarbeitet Diskraid weiterhin Befehle, als ob der Fehler nicht aufgetreten ist.

associate

Legt die angegebene Liste der Controllerports als aktiv für die aktuell ausgewählte LUN fest (andere Controllerports werden inaktiv gemacht), oder fügt die angegebenen Controllerports der Liste der vorhandenen aktiven Controllerports für die aktuell ausgewählte LUN hinzu oder ordnet das angegebene iSCSI-Ziel für die aktuell ausgewählte LUN zu.

Syntax

associate controllers [add] <n>[,<n> [,…]]
associate ports [add] <n-m>[,<n-m>[,…]]
associate targets [add] <n>[,<n> [,…]]
Parameters
Parameter Description
controller Fügt die Liste der Controller hinzu, die der aktuell ausgewählten LUN zugeordnet sind, oder ersetzt sie. Wird nur bei VDS 1.0-Anbietern verwendet.
ports Fügt die Liste der Controllerports hinzu, die der aktuell ausgewählten LUN zugeordnet sind, oder ersetzt sie. Wird nur bei VDS 1.1-Anbietern verwendet.
targets Fügt die Liste der iSCSI-Ziele hinzu oder ersetzt sie, die der aktuell ausgewählten LUN zugeordnet sind. Wird nur bei VDS 1.1-Anbietern verwendet.
add Bei Verwendung von VDS 1.0-Anbietern: Fügt die angegebenen Controller zur vorhandenen Liste der Controller hinzu, die dem LUN zugeordnet sind. Wenn dieser Parameter nicht angegeben ist, ersetzt die Liste der Controller die vorhandene Liste der Controller, die diesem LUN zugeordnet sind.

Bei Verwendung von VDS 1.1-Anbietern: Fügt die angegebenen Controllerports zur vorhandenen Liste der Controllerports hinzu, die der LUN zugeordnet sind. Wenn dieser Parameter nicht angegeben ist, ersetzt die Liste der Controllerports die vorhandene Liste der Controllerports, die diesem LUN zugeordnet sind.

<n>[,<n> [, ...]] Verwenden Sie diese Option mit dem Parameter controller oder targets . Gibt die Anzahl der Controller oder iSCSI-Ziele an, die auf "aktiv" oder "zuordnen" festgelegt werden sollen.
<n-m>[,<n-m>[,…]] Verwenden Sie diese Option mit dem Parameter ports . Gibt die Controller-Ports an, die mithilfe eines Paares aus Controller-Nummer (n) und Portnummer (m) aktiviert werden sollen.

Example

So ordnen Sie einer LUN Ports zu, die einen VDS 1.1-Anbieter verwenden, und fügen Sie diese hinzu:

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

Legt Flags fest oder löscht Flags, die Anbietern Hinweise zum Konfigurieren einer LUN geben. Wenn die automagische Operation ohne Parameter verwendet wird, zeigt sie eine Liste von Flags an.

Syntax

automagic {set | clear | apply} all <flag=value> [<flag=value> [...]]
Parameters
Parameter Description
set Legt die angegebenen Flags auf die angegebenen Werte fest.
clear Löscht die angegebenen Flags. Das Schlüsselwort all löscht alle automagischen Flags.
apply Wendet die aktuellen Flags auf die ausgewählte LUN an.
<flag> Kennzeichnungen werden durch Drei-Buchstaben-Akronyme identifiziert, darunter:
  • FCR - Schnelle Wiederherstellung nach einem Systemabsturz erforderlich
  • FTL - Fehlertolerant
  • MSR - Liest hauptsächlich
  • MXD - Maximale Anzahl von Laufwerken
  • MXS - Maximal erwartete Größe
  • ORA - Optimale Leseausrichtung
  • ORS - Optimale Lesegröße
  • OSR - Optimieren für sequenzielle Lesevorgänge
  • OSW - Optimieren für sequenzielle Schreibvorgänge
  • OWA - Optimale Schreibausrichtung
  • OWS - Optimale Schreibgröße
  • RBP - Priorität für die Wiederherstellung
  • RBV - Zurücklesen, Verifizieren, Aktivieren
  • RMP - Neuzuordnung aktiviert
  • STS - Streifengröße
  • WTC - Write-Through Caching aktiviert
  • YNK - Abnehmbar

break

Entfernt den Plex aus der aktuell ausgewählten LUN. Der Plex und die darin enthaltenen Daten werden nicht aufbewahrt, und die Laufwerksausdehnungen können zurückgefordert werden.

Caution

Sie müssen zuerst eine gespiegelte LUN auswählen, bevor Sie diesen Befehl verwenden. Alle Daten auf dem Plex werden gelöscht. Alle daten, die im ursprünglichen LUN enthalten sind, sind nicht garantiert konsistent.

Syntax

break plex=<plex_number> [noerr]
Parameters
Parameter Description
plex Gibt die Anzahl des zu entfernenden Plexs an. Der Plex und die darin enthaltenen Daten werden nicht aufbewahrt, und die von diesem Plex verwendeten Ressourcen werden zurückgefordert. Die im LUN enthaltenen Daten sind nicht garantiert konsistent. Wenn Sie diesen Plex beibehalten möchten, verwenden Sie den Volumeschattenkopie-Dienst (Volume Shadow Copy Service, VSS).
noerr Nur für Skripts. Wenn ein Fehler auftritt, verarbeitet Diskraid weiterhin Befehle, als ob der Fehler nicht aufgetreten ist.

chap

Legt den freigegebenen CHAP-Schlüssel (Challenge Handshake Authentication Protocol) fest, sodass iSCSI-Initiatoren und iSCSI-Ziele miteinander kommunizieren können.

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 Legt den freigegebenen Schlüssel im lokalen iSCSI-Initiatordienst fest, der für die gegenseitige CHAP-Authentifizierung verwendet wird, wenn der Initiator das Ziel authentifiziert.
initiator remember Kommuniziert den CHAP-Geheimschlüssel eines iSCSI-Ziels an den lokalen iSCSI-Initiatordienst, damit der Initiatordienst den geheimen Schlüssel verwenden kann, um sich während der CHAP-Authentifizierung beim Ziel zu authentifizieren.
target set Legt den freigegebenen geheimen Schlüssel im aktuell ausgewählten iSCSI-Ziel fest, das für die CHAP-Authentifizierung verwendet wird, wenn das Ziel den Initiator authentifiziert.
target remember Kommuniziert das CHAP-Geheimnis eines iSCSI-Initiators mit dem aktuellen iSCSI-Ziel im Fokus, damit das Ziel den geheimen Schlüssel verwenden kann, um sich während der gegenseitigen CHAP-Authentifizierung beim Initiator zu authentifizieren.
secret Gibt den zu verwendenden geheimen Schlüssel an. Wenn der geheime Schlüssel leer ist, wird er gelöscht.
target Gibt ein Ziel im derzeit ausgewählten Subsystem an, das dem geheimen Schlüssel zugeordnet werden soll. Dies ist optional, wenn sie einen geheimen Schlüssel für den Initiator festlegen und auslassen, dass der geheime Schlüssel für alle Ziele verwendet wird, die noch nicht über einen zugeordneten geheimen Schlüssel verfügen.
initiatorname Gibt einen iSCSI-Initiatornamen an, der dem geheimen Schlüssel zugeordnet werden soll. Dies ist optional, wenn sie einen geheimen Schlüssel für ein Ziel festlegen und auslassen, dass der geheime Schlüssel für alle Initiatoren verwendet wird, die noch nicht über einen zugeordneten geheimen Schlüssel verfügen.

create

Erstellt ein neues LUN- oder iSCSI-Ziel im aktuell ausgewählten Subsystem oder erstellt eine Zielportalgruppe für das aktuell ausgewählte Ziel. Sie können die tatsächliche Bindung mit dem Befehl Diskraid list anzeigen.

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 Erstellt eine einfache LUN.
stripe Erstellt eine gestreifte LUN.
raid Erstellt eine gestreifte LUN mit Parität.
mirror Erstellt eine gespiegelte LUN.
automagic Erstellt eine LUN mit den derzeit gültigen automagischen Hinweisen. Weitere Informationen finden Sie unter dem Unterbefehl automagic in diesem Artikel.
size= Gibt die Gesamtgröße der LUN in Megabyte an. Entweder muss der Parameter size= oder drives= angegeben werden. Sie können auch zusammen verwendet werden. Wenn der Parameter size= nicht angegeben ist, hat die erstellte LUN die größtmögliche Größe, die von allen angegebenen Laufwerken zugelassen wird.

Ein Anbieter erstellt in der Regel eine LUN mindestens so groß wie die angeforderte Größe, aber der Anbieter muss in einigen Fällen möglicherweise auf die nächste größte Größe aufgerundet werden. Wenn z. B. die Größe als 0,99 GB angegeben ist und der Anbieter nur GB-Datenträgerausdehnungen zuordnen kann, beträgt die resultierende LUN 1 GB. Wenn Sie die Größe mit anderen Einheiten angeben möchten, verwenden Sie eins der folgenden erkannten Suffixe unmittelbar nach der Größe:

  • B - Byte
  • KB - Kilobyte
  • MB - Megabyte
  • GB - Gigabyte
  • TB - Terabyte
  • PB - Petabyte.
drives= Gibt die drive_number an, die von den Laufwerken zum Erstellen einer LUN verwendet werden sollen. Entweder muss der Parameter size= oder drives= angegeben werden. Sie können auch zusammen verwendet werden. Wenn der Parameter size= nicht angegeben ist, ist die erstellte LUN die größtmögliche Größe, die von allen angegebenen Laufwerken zugelassen wird. Wenn der Parameter size= angegeben ist, wählen Provider Laufwerke aus der angegebenen Laufwerksliste aus, um die LUN zu erstellen. Anbieter versuchen, die Laufwerke nach Möglichkeit in der angegebenen Reihenfolge zu verwenden.
stripesize= Gibt die Größe in Megabyte für eine Stripe- oder RAID-LUN an. Die Stripesize kann nicht geändert werden, nachdem die LUN erstellt wurde. Wenn Sie die Größe mit anderen Einheiten angeben möchten, verwenden Sie eins der folgenden erkannten Suffixe unmittelbar nach der Größe:
  • B - Byte
  • KB - Kilobyte
  • MB - Megabyte
  • GB - Gigabyte
  • TB - Terabyte
  • PB - Petabyte.
target Erstellt ein neues iSCSI-Ziel für das aktuell ausgewählte Subsystem.
name Gibt den Anzeigenamen für das Ziel an.
iscsiname Stellt den iSCSI-Namen für das Ziel bereit und kann weggelassen werden, damit der Anbieter einen Namen generiert.
tpgroup Erstellt eine neue iSCSI-Zielportalgruppe auf dem aktuell ausgewählten Ziel.
noerr Nur für Skripts. Wenn ein Fehler auftritt, verarbeitet Diskraid weiterhin Befehle, als ob der Fehler nicht aufgetreten ist.

delete

Löscht das aktuell ausgewählte LUN-, iSCSI-Ziel (sofern keine LUNs mit dem iSCSI-Ziel verknüpft sind) oder die iSCSI-Zielportalgruppe.

Syntax

delete lun [uninstall] [noerr]
delete target [noerr]
delete tpgroup [noerr]
Parameters
Parameter Description
lun Löscht die aktuell ausgewählte LUN und alle darin befindlichen Daten.
uninstall Gibt an, dass der Datenträger im lokalen System, das der LUN zugeordnet ist, vor dem Löschen des LUN bereinigt wird.
target Löscht das aktuell ausgewählte iSCSI-Ziel, wenn dem Ziel keine LUNs zugeordnet sind.
tpgroup Löscht die aktuell ausgewählte iSCSI-Zielportalgruppe.
noerr Nur für Skripts. Wenn ein Fehler auftritt, verarbeitet Diskraid weiterhin Befehle, als ob der Fehler nicht aufgetreten ist.

detail

Zeigt detaillierte Informationen zum aktuell ausgewählten Objekt des angegebenen Typs an.

Syntax

detail {hbaport | iadapter | iportal | provider | subsystem | controller | port | drive | lun | tportal | target | tpgroup} [verbose]
Parameters
Parameter Description
hbaport Listet detaillierte Informationen zum aktuell ausgewählten Hostbusadapter (HBA)-Port auf.
iadapter Listet detaillierte Informationen zum aktuell ausgewählten iSCSI-Initiatoradapter auf.
iportal Listet detaillierte Informationen zum aktuell ausgewählten iSCSI-Initiatorportal auf.
provider Listet detaillierte Informationen zum aktuell ausgewählten Anbieter auf.
subsystem Listet detaillierte Informationen zum aktuell ausgewählten Subsystem auf.
controller Listet detaillierte Informationen zum aktuell ausgewählten Controller auf.
port Listet detaillierte Informationen zum aktuell ausgewählten Controllerport auf.
drive Listet detaillierte Informationen zum aktuell ausgewählten Laufwerk auf, einschließlich der besetzenden LUNs.
lun Listet detaillierte Informationen zu der aktuell ausgewählten LUN auf, einschließlich der beitragenden Laufwerke. Die Ausgabe unterscheidet sich geringfügig, je nachdem, ob das LUN Teil eines Fibre Channel- oder iSCSI-Subsystems ist. Wenn die Liste "Unmasked Hosts" nur ein Sternchen enthält, bedeutet dies, dass die LUN für alle Hosts entmasket wird.
tportal Listet detaillierte Informationen zum aktuell ausgewählten iSCSI-Zielportal auf.
target Listet detaillierte Informationen zum aktuell ausgewählten iSCSI-Ziel auf.
tpgroup Listet detaillierte Informationen zur aktuell ausgewählten iSCSI-Zielportalgruppe auf.
verbose Nur für den LUN-Parameter zu verwenden. Listet zusätzliche Informationen auf, einschließlich seiner Plexes.

dissociate

Legt die angegebene Liste der Controllerports als inaktiv für die aktuell ausgewählte LUN fest (andere Controllerports sind nicht betroffen), oder entfernt die angegebene Liste der iSCSI-Ziele für die aktuell ausgewählte LUN.

Syntax

dissociate controllers <n> [,<n> [,...]]
dissociate ports <n-m>[,<n-m>[,…]]
dissociate targets <n> [,<n> [,…]]
Parameter
Parameter Description
controllers Entfernt Controller aus der Liste der Controller, die der aktuell ausgewählten LUN zugeordnet sind. Wird nur bei VDS 1.0-Anbietern verwendet.
ports Entfernt Controllerports aus der Liste der Controllerports, die der aktuell ausgewählten LUN zugeordnet sind. Wird nur bei VDS 1.1-Anbietern verwendet.
targets Entfernt Ziele aus der Liste der iSCSI-Ziele, die der aktuell ausgewählten LUN zugeordnet sind. Wird nur bei VDS 1.1-Anbietern verwendet.
<n> [,<n> [,…]] Zur Verwendung mit den Parametern controller oder targets . Gibt die Anzahl der Controller oder iSCSI-Ziele an, die als inaktiv oder dissoziiert festgelegt werden sollen.
<n-m>[,<n-m>[,…]] Zur Verwendung mit dem Parameter ports . Gibt die Controller-Ports an, die mithilfe eines Paares aus Controller-Nummer (n) und Portnummer (m) als inaktiv festgelegt werden sollen.

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

Erweitert die aktuell ausgewählte LUN durch Hinzufügen von Sektoren bis zum Ende des LUN. Nicht alle Anbieter unterstützen die Erweiterung von LUNs. Erweitert keine Volumes oder Dateisysteme, die in der LUN enthalten sind. Nachdem Sie die LUN erweitert haben, sollten Sie die zugeordneten Strukturen auf dem Datenträger mit dem Befehl DiskPart extend erweitern.

Syntax

extend lun [size=<LUN_size>] [drives=<drive_number>, [<drive_number>, ...]] [noerr]
Parameters
Parameter Description
size Gibt die Größe in Megabyte an, um die LUN zu erweitern. Es muss entweder die Größe oder der <drive> Parameter angegeben werden. Sie können auch zusammen verwendet werden. Wenn der Parameter size= nicht angegeben ist, wird die LUN um die größtmögliche Größe erweitert, die für alle angegebenen Laufwerke zulässig ist. Wenn der Parameter size= angegeben ist, wählen Provider Laufwerke aus der Liste aus, die durch den Parameter drive= angegeben wird, um die LUN zu erstellen. Wenn Sie die Größe mit anderen Einheiten angeben möchten, verwenden Sie eins der folgenden erkannten Suffixe unmittelbar nach der Größe:
  • B - Byte
  • KB - Kilobyte
  • MB - Megabyte
  • GB - Gigabyte
  • TB - Terabyte
  • PB - Petabyte.
drives= Gibt die <drive_number> für die Laufwerke an, die beim Erstellen einer LUN verwendet werden sollen. Es muss entweder die Größe oder der <drive> Parameter angegeben werden. Sie können auch zusammen verwendet werden. Wenn der Parameter size= nicht angegeben ist, ist die erstellte LUN die größtmögliche Größe, die von allen angegebenen Laufwerken zugelassen wird. Anbieter verwenden die Laufwerke in der angegebenen Reihenfolge, wenn möglich.
noerr Nur für Skripts. Wenn ein Fehler auftritt, verarbeitet Diskraid weiterhin Befehle, als ob der Fehler nicht aufgetreten ist.

flushcache

Löscht den Cache auf dem aktuell ausgewählten Controller.

Syntax

flushcache controller

help

Zeigt eine Liste aller Diskraid-Befehle an.

Syntax

help

importtarget

Ruft das aktuelle VsS-Importziel (Volume Shadow Copy Service) ab, das für das aktuell ausgewählte Subsystem festgelegt ist, oder legt dieses fest.

Syntax

importtarget subsystem [set target]
Parameter
Parameter Description
set target Wenn angegeben, legt das aktuell ausgewählte Ziel auf das VSS-Importziel für das aktuell ausgewählte Subsystem fest. Wenn nicht angegeben, ruft der Befehl das aktuelle VSS-Importziel ab, das für das aktuell ausgewählte Subsystem festgelegt ist.

initiator

Ruft Informationen zum lokalen iSCSI-Initiator ab.

Syntax

initiator

invalidatecache

Ungültig wird der Cache auf dem aktuell ausgewählten Controller.

Syntax

invalidatecache controller

lbpolicy

Legt die Richtlinie zum Lastenausgleich für die aktuell ausgewählte LUN fest.

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 Gibt die Richtlinie zum Lastenausgleich an. Wenn der Typ nicht angegeben ist, muss der Pfadparameter angegeben werden. Als Type kann eines der folgenden Elemente verwendet werden:
  • FAILOVER - Verwendet einen primären Pfad, während andere Pfade Sicherungspfade sind.
  • ROUNDROBIN - Verwendet alle Pfade im Round-Robin-Format, wobei jeder Pfad nacheinander ausprobiert wird.
  • SUBSETROUNDROBIN - Verwendet alle primären Pfade im Round-Robin-Stil; Sicherungspfade werden nur verwendet, wenn alle primären Pfade fehlschlagen.
  • DYNLQD - Verwendet den Pfad mit der geringsten Anzahl aktiver Anforderungen.
  • WEIGHTED - Verwendet den Pfad mit der geringsten Gewichtung (jedem Pfad muss eine Gewichtung zugewiesen werden).
  • LEASTBLOCKS - Verwendet den Pfad mit den wenigsten Blöcken.
  • VENDORSPECIFIC – Verwendet eine anbieterspezifische Richtlinie.
path Gibt an, ob ein Pfad primär ist oder eine bestimmte <weight>. Alle nicht angegebenen Pfade werden implizit als Sicherung festgelegt. Alle aufgelisteten Pfade müssen eines der aktuell ausgewählten LUN-Pfade sein.

list

Zeigt eine Liste der Objekte des angegebenen Typs an.

Syntax

list {hbaports | iadapters | iportals | providers | subsystems | controllers | ports | drives | LUNs | tportals | targets | tpgroups}
Parameters
Parameter Description
hbaports Listet zusammenfassende Informationen zu allen HBA-Ports auf, die VDS kennen. Der aktuell ausgewählte HBA-Port wird durch ein Sternchen (*) markiert.
iadapters Listet zusammenfassende Informationen zu allen iSCSI-Initiatoradaptern auf, die VDS kennen. Der aktuell ausgewählte Initiatoradapter ist durch ein Sternchen (*) gekennzeichnet.
iportals Listet zusammenfassungsinformationen zu allen iSCSI-Initiatorportalen im aktuell ausgewählten Initiatoradapter auf. Das aktuell ausgewählte Initiatorportal wird durch ein Sternchen (*) markiert.
providers Listet zusammenfassende Informationen zu jedem anbieter auf, der VDS bekannt ist. Der aktuell ausgewählte Anbieter wird durch ein Sternchen (*) markiert.
subsystems Listet zusammenfassende Informationen zu den einzelnen Subsystemen im System auf. Das aktuell ausgewählte Subsystem ist durch ein Sternchen (*) gekennzeichnet.
controllers Listet zusammenfassende Informationen zu jedem Controller im aktuell ausgewählten Subsystem auf. Der aktuell ausgewählte Controller ist durch ein Sternchen (*) gekennzeichnet.
ports Listet zusammenfassungsinformationen zu den einzelnen Controllerports im aktuell ausgewählten Controller auf. Der aktuell ausgewählte Port wird durch ein Sternchen (*) markiert.
drives Listet zusammenfassende Informationen zu jedem Laufwerk im aktuell ausgewählten Subsystem auf. Das aktuell ausgewählte Laufwerk ist durch ein Sternchen (*) gekennzeichnet.
luns Listet zusammenfassende Informationen zu den einzelnen LUN im aktuell ausgewählten Subsystem auf. Die aktuell ausgewählte LUN wird durch ein Sternchen (*) markiert.
tportals Listet zusammenfassungsinformationen zu allen iSCSI-Zielportalen im aktuell ausgewählten Subsystem auf. Das aktuell ausgewählte Zielportal wird durch ein Sternchen (*) markiert.
targets Listet zusammenfassende Informationen zu allen iSCSI-Zielen im aktuell ausgewählten Subsystem auf. Das aktuell ausgewählte Ziel wird durch ein Sternchen (*) markiert.
tpgroups Listet zusammenfassungsinformationen zu allen iSCSI-Zielportalgruppen im aktuell ausgewählten Ziel auf. Die aktuell ausgewählte Portalgruppe wird durch ein Sternchen (*) markiert.

login

Protokolliert den angegebenen iSCSI-Initiatoradapter im aktuell ausgewählten iSCSI-Ziel.

Syntax

login target iadapter=<iadapter> [type={manual | persistent | boot}] [chap={none | oneway | mutual}] [iportal=<iportal>] [tportal=<tportal>] [<flag> [<flag> […]]]
Parameters
Parameter Description
type Gibt die Art der Anmeldung an, die ausgeführt werden soll: manuell oder dauerhaft. Wenn nicht angegeben, wird eine manuelle Anmeldung durchgeführt.
manual Login manually. Es gibt auch eine Boot-Option , die für die zukünftige Entwicklung gedacht ist und derzeit nicht verwendet wird.
persistent Verwenden Sie automatisch dieselbe Anmeldung, wenn der Computer neu gestartet wird.
chap Gibt den Typ der zu verwendenden CHAP-Authentifizierung an: keine, unidirektionales CHAP oder gegenseitiges CHAP. Wenn nicht angegeben, wird keine Authentifizierung verwendet.
tportal Gibt ein optionales Zielportal im aktuell ausgewählten Subsystem an, das für die Anmeldung verwendet werden soll.
iportal Gibt ein optionales Initiatorportal im angegebenen Initiatoradapter an, das für die Anmeldung verwendet werden soll.
<flag> Identifiziert durch Drei-Buchstaben-Akronyme:
  • IPS - IPsec erforderlich
  • EMP - Multipath aktivieren
  • EHD - Header-Digest aktivieren
  • EDD - Datendigest aktivieren

logout

Protokolliert den angegebenen iSCSI-Initiatoradapter aus dem aktuell ausgewählten iSCSI-Ziel.

Syntax

logout target iadapter= <iadapter>
Parameters
Parameter Description
iadapter Gibt den Initiatoradapter mit einer Anmeldesitzung an, von der sich abmelden soll.

maintenance

Führt Wartungsvorgänge für das aktuell ausgewählte Objekt des angegebenen Typs aus.

Syntax

maintenance <object operation> [count=<iteration>]
Parameters
Parameter Description
<object> Gibt den Typ des Objekts an, für das der Vorgang ausgeführt werden soll. Bei dem Objekttyp kann es sich um ein Subsystem, einen Controller, einen Port, ein Laufwerk oder eine LUN handeln.
<operation> Gibt den auszuführenden Wartungsvorgang an. Der Operationstyp kann "Spinup", "Spindown", " Blink", "Piepton" oder "Ping" sein. Es muss ein Vorgang angegeben werden.
count= Gibt an, wie oft der Vorgang wiederholt werden soll. Dies wird in der Regel mit Blinken, Piepton oder Ping verwendet.

name

Legt den Anzeigenamen des aktuell ausgewählten Subsystems, der LUN oder des iSCSI-Ziels auf den angegebenen Namen fest.

Syntax

name {subsystem | lun | target} [<name>]
Parameter
Parameter Description
<name> Gibt einen Namen für das Subsystem, die LUN oder das Ziel an. Der Name muss kleiner als 64 Zeichen lang sein. Wenn kein Name angegeben wird, wird der vorhandene Name (falls vorhanden) gelöscht.

offline

Legt den Status des aktuell ausgewählten Objekts des angegebenen Typs auf offline fest.

Syntax

offline <object>
Parameter
Parameter Description
<object> Gibt den Typ des Objekts an, für das dieser Vorgang ausgeführt werden soll. Der Typ kann sein: Subsystem, Controller, Laufwerk, LUN oder tportal.

online

Legt den Status des ausgewählten Objekts des angegebenen Typs auf online fest. Wenn das Objekt hbaport ist, ändert sich der Status der Pfade zum aktuell ausgewählten HBA-Port in online.

Syntax

online <object>
Parameter
Parameter Description
<object> Gibt den Typ des Objekts an, für das dieser Vorgang ausgeführt werden soll. Der Typ kann sein: hbaport, subsystem, controller, drive, LUN oder tportal.

recover

Führt Vorgänge aus, die erforderlich sind, z. B. erneute Synchronisierung oder Hot-Sparing, um die aktuell ausgewählte fehlertolerante LUN zu reparieren. Beispielsweise kann RECOVER dazu führen, dass ein Hot Spare an einen RAID-Satz gebunden wird, der über einen fehlerhaften Datenträger oder eine andere Verschiebung des Datenträgers verfügt.

Syntax

recover <lun>

reenumerate

Listet Objekte des angegebenen Typs erneut auf. Wenn Sie den Befehl "LUN erweitern" verwenden, müssen Sie den Aktualisierungsbefehl verwenden, um die Datenträgergröße zu aktualisieren, bevor Sie den Befehl zum erneuten Aufzählen verwenden.

Syntax

reenumerate {subsystems | drives}
Parameters
Parameter Description
subsystems Fragt den Anbieter ab, um alle neuen Subsysteme zu ermitteln, die im aktuell ausgewählten Anbieter hinzugefügt wurden.
drives Fragt die internen E/A-Busse ab, um alle neuen Laufwerke zu ermitteln, die im aktuell ausgewählten Subsystem hinzugefügt wurden.

refresh

Aktualisiert interne Daten für den aktuell ausgewählten Anbieter.

Syntax

refresh provider

rem

Wird zum Kommentieren von Skripts verwendet.

Syntax

Rem <comment>

remove

Entfernt das angegebene iSCSI-Zielportal aus der aktuell ausgewählten Zielportalgruppe.

Syntax

remove tpgroup tportal=<tportal> [noerr]
Parameter
Parameter Description
tpgroup tportal=<tportal> Gibt das zu entfernende iSCSI-Zielportal an.
noerr Nur für Skripts. Wenn ein Fehler auftritt, verarbeitet Diskraid weiterhin Befehle, als ob der Fehler nicht aufgetreten ist.

replace

Ersetzt das angegebene Laufwerk durch das aktuell ausgewählte Laufwerk. Das angegebene Laufwerk ist möglicherweise nicht das aktuell ausgewählte Laufwerk.

Syntax

replace drive=<drive_number>
Parameter
Parameter Description
drive= Gibt die <drive_number> für das zu ersetzende Laufwerk an.

reset

Setzt den aktuell ausgewählten Controller oder Port zurück.

Syntax

reset {controller | port}
Parameters
Parameter Description
controller Setzt den Controller zurück.
port Setzt den Port zurück.

select

Zeigt das aktuell ausgewählte Objekt an oder ändert es.

Syntax

select {hbaport | iadapter | iportal | provider | subsystem | controller | port | drive | lun | tportal | target | tpgroup } [<n>]
Parameters
Parameter Description
object Gibt den Typ des auszuwählenden Objekts an, z. B. Anbieter, Subsystem, Controller, Laufwerk oder LUN.
HBAPORT [<n>] Legt den Fokus auf den angegebenen lokalen HBA-Port fest. Wenn kein HBA-Port angegeben ist, zeigt der Befehl den aktuell ausgewählten HBA-Port an (falls vorhanden). Das Angeben eines ungültigen HBA-Portindex führt zu keinem im Fokus bezogenen HBA-Port. Wenn Sie einen HBA-Port auswählen, werden alle ausgewählten Initiatoradapter und Initiatorportale deaktiviert.
iAdapter [<n>] Legt den Fokus auf den angegebenen lokalen iSCSI-Initiatoradapter fest. Wenn kein Initiatoradapter angegeben ist, zeigt der Befehl den aktuell ausgewählten Initiatoradapter an (sofern vorhanden). Wenn Sie einen ungültigen Initiatoradapterindex angeben, wird kein In-Focus-Initiatoradapter angegeben. Wenn Sie einen Initiatoradapter auswählen, werden alle ausgewählten HBA-Ports und Initiatorportale deaktiviert.
iportal [<n>] Legt den Fokus auf das angegebene lokale iSCSI-Initiatorportal innerhalb des ausgewählten iSCSI-Initiatoradapters fest. Wenn kein Initiatorportal angegeben ist, zeigt der Befehl das aktuell ausgewählte Initiatorportal an (sofern vorhanden). Wenn Sie einen ungültigen Initiatorportalindex angeben, wird kein ausgewähltes Initiatorportal angezeigt.
Anbieter-[<n>] Legt den Fokus auf den angegebenen Anbieter fest. Wenn kein Anbieter angegeben ist, zeigt der Befehl den aktuell ausgewählten Anbieter an (sofern vorhanden). Das Angeben eines ungültigen Anbieterindex führt zu keinem In-Focus-Anbieter.
Subsystem [<n>] Legt den Fokus auf das angegebene Subsystem fest. Wenn kein Subsystem angegeben ist, zeigt der Befehl das Subsystem mit Fokus an (falls vorhanden). Das Angeben eines ungültigen Subsystemindex führt zu keinem Fokussubsystem. Wenn Sie ein Subsystem implizit auswählen, wird der zugehörige Anbieter ausgewählt.
Controller[<n>] Legt den Fokus auf den angegebenen Controller innerhalb des aktuell ausgewählten Subsystems fest. Wenn kein Controller angegeben ist, zeigt der Befehl den aktuell ausgewählten Controller an (sofern vorhanden). Wenn Sie einen ungültigen Controllerindex angeben, wird kein Fokuscontroller angegeben. Wenn Sie einen Controller auswählen, werden alle ausgewählten Controllerports, Laufwerke, LUNs, Zielportale, Ziele und Zielportalgruppen deaktiviert.
Port [<n>] Legt den Fokus auf den angegebenen Controllerport innerhalb des aktuell ausgewählten Controllers fest. Wenn kein Port angegeben ist, zeigt der Befehl den aktuell ausgewählten Port an (falls vorhanden). Wenn Sie einen ungültigen Portindex angeben, wird kein ausgewählter Port angegeben.
Laufwerk [<n>] Legt den Fokus auf das angegebene Laufwerk oder die physische Spindel innerhalb des aktuell ausgewählten Subsystems fest. Wenn kein Laufwerk angegeben ist, zeigt der Befehl das aktuell ausgewählte Laufwerk an (falls vorhanden). Das Angeben eines ungültigen Laufwerkindexes führt zu keinem Fokuslaufwerk. Wenn Sie ein Laufwerk auswählen, werden alle ausgewählten Controller, Controllerports, LUNs, Zielportale, Ziele und Zielportalgruppen deaktiviert.
lun [<n>] Legt den Fokus auf das angegebene LUN innerhalb des aktuell ausgewählten Subsystems fest. Wenn kein LUN angegeben ist, zeigt der Befehl die aktuell ausgewählte LUN an (falls vorhanden). Das Angeben eines ungültigen LUN-Indexes führt zu keiner ausgewählten LUN. Wenn Sie eine LUN auswählen, werden alle ausgewählten Controller, Controllerports, Laufwerke, Zielportale, Zielportale und Zielportalgruppen deaktiviert.
TPORTAL [<n>] Legt den Fokus auf das angegebene iSCSI-Zielportal innerhalb des aktuell ausgewählten Subsystems fest. Wenn kein Zielportal angegeben ist, zeigt der Befehl das aktuell ausgewählte Zielportal an (sofern vorhanden). Das Angeben eines ungültigen Zielportalindexes führt zu keinem ausgewählten Zielportal. Wenn Sie ein Zielportal auswählen, werden alle Controller, Controllerports, Laufwerke, LUNs, Ziele und Zielportalgruppen deaktiviert.
Ziel-[<n>] Legt den Fokus auf das angegebene iSCSI-Ziel innerhalb des aktuell ausgewählten Subsystems fest. Wenn kein Ziel angegeben ist, zeigt der Befehl das aktuell ausgewählte Ziel an (sofern vorhanden). Das Angeben eines ungültigen Zielindexes führt zu keinem ausgewählten Ziel. Wenn Sie ein Ziel auswählen, werden alle Controller, Controllerports, Laufwerke, LUNs, Zielportale und Zielportalgruppen deaktiviert.
tpgroup [<n>] Legt den Fokus auf die angegebene iSCSI-Zielportalgruppe innerhalb des aktuell ausgewählten iSCSI-Ziels fest. Wenn keine Zielportalgruppe angegeben ist, zeigt der Befehl die aktuell ausgewählte Zielportalgruppe an (sofern vorhanden). Wenn Sie einen ungültigen Zielportalgruppenindex angeben, wird keine Zielportalgruppe im Fokus angezeigt.
[<n>] Gibt den auszuwählenden <object number> an. Wenn die angegebene <object number> ungültig ist, werden alle vorhandenen Auswahlmöglichkeiten für Objekte des angegebenen Typs gelöscht. Wenn kein <object number> angegeben ist, wird das aktuelle Objekt angezeigt.

setflag

Legt das aktuell ausgewählte Laufwerk als Hot Spare fest. Hot Spares können nicht für gewöhnliche LUN-Bindungsvorgänge verwendet werden. Sie sind nur für die Fehlerbehandlung reserviert. Das Laufwerk darf derzeit nicht an vorhandene LUN gebunden sein.

Syntax

setflag drive hotspare={true | false}
Parameters
Parameter Description
true Wählt das aktuell ausgewählte Laufwerk als Hot Spare aus.
false Hebt die Auswahl des aktuell ausgewählten Laufwerks als Hot Spare auf.

shrink

Reduziert die Größe der ausgewählten LUN.

Syntax

shrink lun size=<n> [noerr]
Parameters
Parameter Description
size Gibt den gewünschten Speicherplatz in Megabyte (MB) an, um die Größe der LUN um zu verringern. Wenn Sie die Größe mit anderen Einheiten angeben möchten, verwenden Sie eins der folgenden erkannten Suffixe unmittelbar nach der Größe:
  • B - Byte
  • KB - Kilobyte
  • MB - Megabyte
  • GB - Gigabyte
  • TB - Terabyte
  • PB - Petabyte.
noerr Nur für Skripts. Wenn ein Fehler auftritt, verarbeitet Diskraid weiterhin Befehle, als ob der Fehler nicht aufgetreten ist.

standby

Ändert den Status der Pfade zum aktuell ausgewählten Hostbusadapter (HBA) in STANDBY.

Syntax

standby hbaport
Parameters
Parameter Description
hbaport Ändert den Status der Pfade zum aktuell ausgewählten Hostbusadapter (HBA) in STANDBY.

unmask

Ermöglicht den Zugriff auf die aktuell ausgewählten LUNs von den angegebenen Hosts.

Syntax

unmask lun {all | none | [add] wwn=<hexadecimal_number> [;<hexadecimal_number> [;…]] | [add] initiator=<initiator>[;<initiator>[;…]]} [uninstall]
Parameters
Parameter Description
all Gibt an, dass die LUN von allen Hosts aus zugänglich gemacht werden soll. Sie können die LUN jedoch nicht für alle Ziele in einem iSCSI-Subsystem aufheben.

Sie müssen sich beim Ziel abmelden, bevor Sie den Befehl unmask lun all ausführen.

none Gibt an, dass auf den LUN nicht auf einen Host zugegriffen werden soll.

Sie müssen sich beim Ziel abmelden, bevor Sie den Befehl unmask lun none ausführen.

add Gibt an, dass die angegebenen Hosts der vorhandenen Liste der Hosts hinzugefügt werden müssen, von denen auf diese LUN zugegriffen werden kann. Wenn dieser Parameter nicht angegeben ist, ersetzt die angegebene Liste der bereitgestellten Hosts die vorhandene Liste der Hosts, von denen auf diese LUN zugegriffen werden kann.
wwn= Gibt eine Liste mit hexadezimalen Zahlen an, die weltweite Namen darstellen, aus denen die LUN oder Hosts zugänglich gemacht werden sollen. Um eine bestimmte Gruppe von Hosts in einem Fibre Channel-Subsystem zu maskieren/zu entmasken, können Sie eine durch Semikolons getrennte Liste der WWNs für die Ports auf den Hostcomputern eingeben, die von Interesse sind.
initiator= Gibt eine Liste der iSCSI-Initiatoren an, für die die aktuell ausgewählte LUN zugänglich gemacht werden soll. Um eine bestimmte Gruppe von Hosts in einem iSCSI-Subsystem zu maskieren/zu entmasken, können Sie eine durch Semikolons getrennte Liste der iSCSI-Initiatornamen für die Initiatoren auf den Hostcomputern eingeben, die von Interesse sind.
uninstall Wenn angegeben, deinstalliert der datenträger, der dem LUN im lokalen System zugeordnet ist, bevor die LUN maskiert wird.

Scripting Diskraid

Diskraid kann auf jedem Computer, auf dem eine unterstützte Version von Windows Server ausgeführt wird, mit einem zugehörigen VDS-Hardwareanbieter skripted werden. Um ein Diskraid-Skript aufzurufen, geben Sie an der Eingabeaufforderung folgendes ein:

diskraid /s <script.txt>

Standardmäßig beendet Diskraid die Verarbeitung von Befehlen und gibt einen Fehlercode zurück, wenn ein Problem im Skript vorliegt. Um das Skript weiter auszuführen und Fehler zu ignorieren, fügen Sie den Parameter noerr in den Befehl ein. Dies ermöglicht die Verwendung eines einzelnen Skripts zum Löschen aller LUNs in einem Subsystem unabhängig von der Gesamtanzahl der LUNs. Nicht alle Befehle unterstützen den noerr-Parameter . Fehler werden immer bei Befehlssyntaxfehlern zurückgegeben, unabhängig davon, ob Sie den Parameter noerr eingeschlossen haben.

Diskraid-Fehlercodes

Error Code Error Description
0 Es ist kein Fehler aufgetreten. Das gesamte Skript wurde ohne Fehler ausgeführt.
1 Es ist eine schwerwiegende Ausnahme aufgetreten.
2 Die in einer Diskraid-Befehlszeile angegebenen Argumente waren falsch.
3 Diskraid konnte das angegebene Skript oder die angegebene Ausgabedatei nicht öffnen.
4 Einer der Dienste, die Diskraid verwendet, hat einen Fehler zurückgegeben.
5 Es ist ein Befehlssyntaxfehler aufgetreten. Fehler des Skripts, da ein Objekt nicht ordnungsgemäß ausgewählt wurde oder für die Verwendung mit diesem Befehl ungültig war.

Example

Geben Sie Folgendes ein, um den Status des Subsystems 0 auf Ihrem Computer anzuzeigen:

diskraid

Drücken Sie die EINGABETASTE, und geben Sie eine ähnliche Ausgabe wie folgt aus:

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

Geben Sie zum Auswählen des Subsystems 0 Folgendes an der Diskraid-Eingabeaufforderung ein:

select subsystem 0

Drücken Sie die EINGABETASTE, und geben Sie eine ähnliche Ausgabe wie folgt aus:

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

Um Diskraid zu beenden, geben Sie Folgendes an der Diskraid-Eingabeaufforderung ein:

exit