Diskraid

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

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

Ein Hardware-RAID-Subsystem unterscheidet physisch adressierbare Speichereinheiten unter Verwendung einer Logischen Einheitennummer (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 im LUN-Objekt. Plexes können einem LUN-Objekt hinzugefügt und daraus entfernt werden.

Die meisten Diskraid-Befehle funktionieren auf einem bestimmten HBA-Port (Host Bus Adapter), Initiatoradapter, Initiatorportal, Anbieter, Subsystem, Controller, Port, Laufwerk, LUN, Zielportal, Zielportal oder Zielportalgruppe. Sie verwenden den Befehl SELECT, um ein Objekt auszuwählen. Das ausgewählte Objekt soll den Fokus haben. Focus vereinfacht gängige Konfigurationsaufgaben, z. B. das Erstellen mehrerer LUNs innerhalb desselben Subsystems.

Hinweis

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

Diskraid-Befehle

Die folgenden Befehle sind im Diskraid-Tool verfügbar.

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]

Parameter

Parameter	BESCHREIBUNG
plex lun=<n>	Gibt die LUN-Nummer an, die der aktuell ausgewählten LUN als Plex hinzugefügt werden soll. VORSICHT: Alle Daten auf der 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 zur Skripterstellung. Bei einem Fehler setzt Diskraid die Verarbeitung von Befehlen fort, als sei der Fehler nicht aufgetreten.

associate

Legt die angegebene Liste der Controllerports als aktiv für die aktuell ausgewählte LUN fest (andere Controllerports sind inaktiv), 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> [,…]]

Parameter

Parameter	BESCHREIBUNG
Controller	Fügt die Liste der Controller, die der aktuell ausgewählten LUN zugeordnet sind, hinzu oder ersetzt sie. Verwenden Sie diesen Befehl nur für VDS 1.0-Anbieter.
ports	Fügt die Liste der Controllerports, die der aktuell ausgewählten LUN zugeordnet sind, hinzu oder ersetzt sie. Verwenden Sie diesen Befehl nur für VDS 1.1-Anbieter.
Ziele	Fügt die Liste der iSCSI-Ziele, die der aktuell ausgewählten LUN zugeordnet sind, hinzu oder ersetzt sie. Verwenden Sie diesen Befehl nur für VDS 1.1-Anbieter.
add	Bei Verwendung von VDS 1.0-Anbietern: Fügt die angegebenen Controller der vorhandenen Liste der Controller hinzu, die der LUN zugeordnet sind. Wenn dieser Parameter nicht angegeben wird, ersetzt die Liste der Controller die vorhandene Liste der Controller, die dieser LUN zugeordnet sind. Bei Verwendung von VDS 1.1-Anbietern: Fügt die angegebenen Controllerports der vorhandenen Liste der Controllerports hinzu, die der LUN zugeordnet sind. Wenn dieser Parameter nicht angegeben wird, ersetzt die Liste der Controllerports die vorhandene Liste der Controllerports, die dieser LUN zugeordnet sind.
<n>[,<n> [, ...]]	Verwenden Sie diesen Befehl mit dem Parameter controllers oder targets. Gibt die Anzahl der Controller oder iSCSI-Ziele an, die auf „active“ oder „associate“ festgelegt werden sollen.
<n-m>[,<n-m>[,…]]	Verwenden Sie diesen Befehl mit dem Parameter ports. Gibt die Controllerports an, die mit einer Controllernummer (n) und einem Portnummerpaar (m) auf „active“ festgelegt werden sollen.

Beispiel

So ordnen Sie einer LUN, die einen VDS 1.1-Anbieter verwendet, Ports zu und fügen 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 diese, die Anbietern Hinweise zum Konfigurieren einer LUN geben. Der automagic-Vorgang wird ohne Parameter verwendet und zeigt eine Liste von Flags an.

Syntax

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

Parameter

Parameter	BESCHREIBUNG
set	Legt die angegebenen Flags auf die angegebenen Werte fest.
clear	Löscht die angegebenen Flags. Das Schlüsselwort all löscht alle automagic-Flags.
apply	Wendet die aktuellen Flags auf die ausgewählte LUN an.
<flag>	Flags werden durch Dreibuchstaben-Akronyme identifiziert, darunter: FCR: Schnelle Absturzwiederherstellung erforderlich FTL: Fehlertolerant MSR: Meistens Lesevorgänge MXD: Maximale Laufwerksanzahl MXS: Maximale Größe erwartet 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 neu erstellen RBV: Überprüfung durch Wiederholung aktiviert (Read Back Verify Enabled) RMP: Neuzuordnung aktiviert STS: Streifengröße WTC: Write-Through-Zwischenspeicherung aktiviert YNK: Entfernbar

break

Entfernt den Plex aus der aktuell ausgewählten LUN. Der Plex wird nicht beibehalten, und die von diesem Plex verwendeten Laufwerksbereiche werden wieder freigegeben.

Achtung

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

Syntax

break plex=<plex_number> [noerr]

Parameter

Parameter	BESCHREIBUNG
plex	Gibt die Anzahl des zu entfernenden Plexs an. Der Plex und die darin enthaltenen Daten werden nicht beibehalten, und die von diesem Plex verwendeten Ressourcen werden wieder freigegeben. Es ist nicht garantiert, dass die in der LUN enthaltenen Daten konsistent sind. Wenn Sie diesen Plex beibehalten möchten, verwenden Sie den Volume Shadow Copy Service (VSS).
noerr	Nur zur Skripterstellung. Bei einem Fehler setzt Diskraid die Verarbeitung von Befehlen fort, als sei der Fehler nicht aufgetreten.

chap

Legt das freigegebene Geheimnis des Challenge Handshake Authentication Protocol (CHAP) fest, damit 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>

Parameter

Parameter	BESCHREIBUNG
initiator set	Legt das freigegebene Geheimnis im lokalen iSCSI-Initiatordienst fest, der für die gegenseitige CHAP-Authentifizierung verwendet wird, wenn der Initiator das Ziel authentifiziert.
initiator remember	Kommuniziert das CHAP-Geheimnis eines iSCSI-Ziels an den lokalen iSCSI-Initiatordienst, damit der Initiatordienst das Geheimnis verwenden kann, um sich während der CHAP-Authentifizierung beim Ziel zu authentifizieren.
target set	Legt das freigegebene Geheimnis 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 an das aktuell fokussierte iSCSI-Ziel, damit das Ziel das Geheimnis verwenden kann, um sich bei der gegenseitigen CHAP-Authentifizierung gegenüber dem Initiator zu authentifizieren.
secret	Gibt das zu verwendende Geheimnis an. Wenn leer ist, wird das Geheimnis gelöscht.
target	Gibt ein Ziel im derzeit ausgewählten Subsystem an, das dem Geheimnis zugeordnet werden soll. Dies ist optional, wenn das Festlegen eines Geheimnisses für den Initiator und das Auslassen des Geheimnisses angibt, dass das Geheimnis für alle Ziele verwendet wird, die noch nicht über ein zugeordnetes Geheimnis verfügen.
initiatorname	Gibt einen Initiator-iSCSI-Namen an, der dem Geheimnis zugeordnet werden soll. Dies ist optional, wenn Sie ein Geheimnis für ein Ziel festlegen und das Auslassen angibt, dass das Geheimnis für alle Initiatoren verwendet wird, die noch nicht über ein zugeordnetes Geheimnis 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]

Parameter

Parameter	BESCHREIBUNG
Einfach	Erstellt eine einfache LUN.
Bereichsstreifen	Erstellt eine gestreifte LUN.
raid	Erstellt eine gestreifte LUN mit Parität.
mirror	Erstellt eine gespiegelte LUN.
automagic	Erstellt eine LUN mithilfe der derzeit gültigen automagic-Hinweise. Weitere Informationen finden Sie in diesem Artikel im Abschnitt zum Unterbefehl automagic.
size=	Gibt die Gesamtgröße der LUN in Megabyte an. Es muss entweder der Parameter size = oder der Parameter drives angegeben werden. Sie können auch zusammen verwendet werden. Wenn der Parameter size= nicht angegeben wird, ist die erstellte LUN die größtmögliche Größe, die für alle angegebenen Laufwerke zulässig ist. Ein Anbieter erstellt in der Regel eine LUN, die mindestens so groß ist wie die angeforderte Größe, aber der Anbieter muss in einigen Fällen möglicherweise auf die nächstgrößte Größe aufrunden. Wenn beispielsweise die Größe als .99 GB angegeben wird und der Anbieter nur GB-Datenträgerbereiche zuordnen kann, beträgt die resultierende LUN 1 GB. Verwenden Sie direkt nach der Größe eines der folgenden erkannten Suffixe, um die Größe mit anderen Einheiten anzugeben: B: Byte KB: Kilobyte MB: Megabyte GB: Gigabyte TB: Terabyte PB: Petabyte
drives=	Gibt den Parameter drive_number für die Laufwerke an, die zum Erstellen einer LUN verwendet werden sollen. Es muss entweder der Parameter size = oder der Parameter drives angegeben werden. Sie können auch zusammen verwendet werden. Wenn der Parameter size= nicht angegeben wird, ist die erstellte LUN die größtmögliche Größe, die für alle angegebenen Laufwerke zulässig ist. Wenn der Parameter size= angegeben ist, wählen Anbieter Laufwerke aus der angegebenen Laufwerkliste 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. Nach Erstellung der LUN kann der stripesize-Parameter nicht mehr geändert werden. Verwenden Sie direkt nach der Größe eines der folgenden erkannten Suffixe, um die Größe mit anderen Einheiten anzugeben: 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	Gibt den iSCSI-Namen für das Ziel an und kann weggelassen werden, damit der Anbieter einen Namen generiert.
tpgroup	Erstellt eine neue iSCSI-Zielportalgruppe für das aktuell ausgewählte Ziel.
noerr	Nur zur Skripterstellung. Bei einem Fehler setzt Diskraid die Verarbeitung von Befehlen fort, als sei der Fehler nicht aufgetreten.

delete

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

Syntax

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

Parameter

Parameter	BESCHREIBUNG
lun	Löscht die derzeit ausgewählte LUN und alle darin enthaltenen Daten.
uninstall	Gibt an, dass der Datenträger auf dem lokalen System, das der LUN zugeordnet ist, vor dem Löschen der 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 zur Skripterstellung. Bei einem Fehler setzt Diskraid die Verarbeitung von Befehlen fort, als sei der Fehler nicht aufgetreten.

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]

Parameter

Parameter	BESCHREIBUNG
hbaport	Listet ausführliche Informationen zum derzeit ausgewählten Hostbusadapter-Port (HBA) 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.
Laufwerk	Listet detaillierte Informationen zum aktuell ausgewählten Laufwerk auf, einschließlich der belegenden LUNs.
lun	Listet detaillierte Informationen zur aktuell ausgewählten LUN auf, einschließlich der beitragenden Laufwerke. Die Ausgabe unterscheidet sich geringfügig, je nachdem, ob die LUN Teil eines Fibre Channel- oder iSCSI-Subsystems ist. Wenn die Liste „Unmaskierte Hosts“ nur ein Sternchen enthält, bedeutet dies, dass die LUN für alle Hosts nicht maskiert ist.
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 zum aktuell ausgewählten iSCSI-Zielportalgruppe auf.
Ausführlich	Nur für die Verwendung mit dem LUN-Parameter. Listet zusätzliche Informationen auf, einschließlich der Plexes.

dissociate

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

Syntax

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

Parameter

Parameter	BESCHREIBUNG
Controller	Entfernt Controller aus der Liste der Controller, die der aktuell ausgewählten LUN zugeordnet sind. Verwenden Sie diesen Befehl nur für VDS 1.0-Anbieter.
ports	Entfernt Controllerports aus der Liste der Controllerports, die der aktuell ausgewählten LUN zugeordnet sind. Verwenden Sie diesen Befehl nur für VDS 1.1-Anbieter.
Ziele	Entfernt Ziele aus der Liste der iSCSI-Ziele, die der aktuell ausgewählten LUN zugeordnet sind. Verwenden Sie diesen Befehl nur für VDS 1.1-Anbieter.
<n> [,<n> [,…]]	Verwenden Sie diesen Befehl mit dem Parameter controllers oder targets. Gibt die Anzahl der Controller oder iSCSI-Ziele an, die auf „inactive“ oder „dissociate“ festgelegt werden sollen.
<n-m>[,<n-m>[,…]]	Verwenden Sie diesen Befehl mit dem Parameter ports. Gibt die Controllerports an, die mit einer Controllernummer (n) und einem Portnummerpaar (m) auf „inactive“ festgelegt werden sollen.

Beispiel

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

Beendet Diskraid.

Syntax

exit

extend

Erweitert die aktuell ausgewählte LUN durch Hinzufügen von Sektoren am Ende der LUN. Nicht alle Anbieter unterstützen das Erweitern 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]

Parameter

Parameter	BESCHREIBUNG
size	Gibt die Größe in Megabyte an, um die LUN zu erweitern. Es muss entweder der Parameter size oder der Parameter <drive> angegeben werden. Sie können auch zusammen verwendet werden. Wenn der Parameter size= nicht angegeben wird, wird die LUN durch die größte mögliche Größe erweitert, die für alle angegebenen Laufwerke zulässig ist. Wenn der Parameter size= angegeben ist, wählen Anbieter Laufwerke aus der Liste aus, die durch den Parameterdrives= angegeben wird, um die LUN zu erstellen. Verwenden Sie direkt nach der Größe eines der folgenden erkannten Suffixe, um die Größe mit anderen Einheiten anzugeben: B: Byte KB: Kilobyte MB: Megabyte GB: Gigabyte TB: Terabyte PB: Petabyte
drives=	Gibt die <drive_number> beim Erstellen eines LUNs zu verwendenden Laufwerke an. Es muss entweder der Parameter size oder der Parameter <drive> angegeben werden. Sie können auch zusammen verwendet werden. Wenn der Parameter size= nicht angegeben wird, ist die erstellte LUN die größtmögliche Größe, die für alle angegebenen Laufwerke zulässig ist. Anbieter verwenden die Laufwerke nach Möglichkeit in der angegebenen Reihenfolge.
noerr	Nur zur Skripterstellung. Bei einem Fehler setzt Diskraid die Verarbeitung von Befehlen fort, als sei der Fehler nicht aufgetreten.

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 (Volumeschattenkopie-Dienst) ab, das für das aktuell ausgewählte Subsystem festgelegt ist, oder legt es fest.

Syntax

importtarget subsystem [set target]

Parameter

Parameter	BESCHREIBUNG
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

Erklärt den Cache auf dem aktuell ausgewählten Controller für ungültig.

Syntax

invalidatecache controller

lbpolicy

Legt die Lastenausgleichsrichtlinie für die derzeit 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>}[,…]]

Parameter

Parameter	BESCHREIBUNG
type	Gibt die Richtlinie für den Lastenausgleich an. Wenn der Typ nicht angegeben wird, muss der Parameter path angegeben werden. Als Type kann eines der folgenden Elemente verwendet werden: FAILOVER: Verwendet einen primären Pfad mit anderen Pfaden, die Sicherungspfade sind. ROUNDROBIN: Verwendet alle Pfade im Roundrobin-Modus, bei dem jeder Pfad sequenziell versucht wird. SUBSETROUNDROBIN: Verwendet alle primären Pfade im Roundrobin-Modus; 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 der geringsten Anzahl von Blöcken. VENDORSPECIFIC: Verwendet eine anbieterspezifische Richtlinie.
path	Gibt an, ob ein Pfad primär ist oder über eine bestimmte <weight> verfügt. Alle nicht angegebenen Pfade werden implizit als Sicherung festgelegt. Alle aufgelisteten Pfade müssen einer der aktuell ausgewählten LUN-Pfade sein.

list

Zeigt eine Liste von Objekten des angegebenen Typs an.

Syntax

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

Parameter

Parameter	BESCHREIBUNG
hbaports	Listet Zusammenfassungsinformationen zu allen für VDS bekannten HBA-Ports auf. Der aktuell ausgewählte HBA-Port ist durch ein Sternchen (*) gekennzeichnet.
iadapters	Listet Zusammenfassungsinformationen zu allen iSCSI-Initiatoradaptern auf, die VDS bekannt sind. Der aktuell ausgewählte Initiatoradapter ist durch ein Sternchen (*) gekennzeichnet.
iportals	Listet Zusammenfassungsinformationen zu allen iSCSI-Initiatorportalen im derzeit ausgewählten Initiatoradapter auf. Das aktuell ausgewählte Initiatorportal ist durch ein Sternchen (*) gekennzeichnet.
providers	Listet Zusammenfassungsinformationen zu jedem Anbieter auf, der VDS bekannt ist. Der aktuell ausgewählte Anbieter ist durch ein Sternchen (*) gekennzeichnet.
subsystems	Listet Zusammenfassungsinformationen zu den einzelnen Subsystemen im System auf. Das aktuell ausgewählte Subsystem ist durch ein Sternchen (*) gekennzeichnet.
Controller	Listet Zusammenfassungsinformationen zu den einzelnen Controllern im derzeit ausgewählten Subsystem auf. Der aktuell ausgewählte Controller ist durch ein Sternchen (*) gekennzeichnet.
ports	Listet Zusammenfassungsinformationen zu den einzelnen Controllerports im derzeit ausgewählten Controller auf. Der aktuell ausgewählte Port ist durch ein Sternchen (*) gekennzeichnet.
Laufwerke	Listet Zusammenfassungsinformationen zu den einzelnen Laufwerken im derzeit ausgewählten Subsystem auf. Das aktuell ausgewählte Laufwerk ist durch ein Sternchen (*) gekennzeichnet.
luns	Listet Zusammenfassungsinformationen zu den einzelnen LUNs im derzeit ausgewählten Subsystem auf. Die aktuell ausgewählte LUN ist durch ein Sternchen (*) gekennzeichnet.
tportals	Listet Zusammenfassungsinformationen zu allen iSCSI-Zielportalen im derzeit ausgewählten Subsystem auf. Das aktuell ausgewählte Zielportal ist durch ein Sternchen (*) gekennzeichnet.
Ziele	Listet Zusammenfassungsinformationen zu allen iSCSI-Zielen im derzeit ausgewählten Subsystem auf. Das aktuell ausgewählte Ziel ist durch ein Sternchen (*) gekennzeichnet.
tpgroups	Listet Zusammenfassungsinformationen zu allen iSCSI-Zielportalgruppen im derzeit ausgewählten Ziel auf. Die aktuell ausgewählte Portalgruppe ist durch ein Sternchen (*) gekennzeichnet.

login

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

Syntax

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

Parameter

Parameter	BESCHREIBUNG
type	Gibt den Typ der auszuführenden Anmeldung an: manuell oder persistent. Falls nicht angegeben, wird eine manuelle Anmeldung ausgeführt.
manual	Melden Sie sich manuell an. Es gibt auch eine Startoption, die für die zukünftige Entwicklung vorgesehen ist und derzeit nicht verwendet wird.
persistent	Sie verwenden automatisch dieselbe Anmeldung, wenn der Computer neu gestartet wird.
chap	Gibt den Typ der zu verwendenden CHAP-Authentifizierung an: none, oneway CHAP oder mutual CHAP; wenn nicht angegeben, wird keine Authentifizierung verwendet.
tportal	Gibt ein optionales Zielportal im derzeit 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 Dreibuchstaben-Akronyme: IPS: IPsec erforderlich EMP: Aktivieren von Multipfaden EHD: Aktivieren des Headerdigests EDD: Aktivieren des Datendigests

logout

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

Syntax

logout target iadapter= <iadapter>

Parameter

Parameter	BESCHREIBUNG
iadapter	Gibt den Initiatoradapter mit einer Anmeldesitzung zum Abmelden an.

Wartung

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

Syntax

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

Parameter

Parameter	BESCHREIBUNG
<object>	Gibt den Typ des Objekts an, für den der Vorgang ausgeführt werden soll. Der Objekttyp kann ein Subsystem, ein Controller, ein Port, ein Laufwerk oder eine LUN sein.
<operation>	Gibt den auszuführenden Wartungsvorgang an. Der Vorgangstyp kann ein Spinup, ein Spindown, ein Blinken, ein Signalton oder ein Ping sein. Ein Vorgang muss angegeben werden.
count=	Gibt an, wie oft der Vorgang wiederholt werden soll. Dies wird in der Regel mit einem Blinken, einem Signalton oder einem Ping verwendet.

name

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

Syntax

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

Parameter

Parameter	BESCHREIBUNG
<name>	Gibt einen Namen für das Subsystem, die LUN oder das Ziel an. Der Name muss kürzer als 64 Zeichen sein. Wenn kein Name angegeben wird, wird der vorhandene Name gelöscht, falls vorhanden.

Offline

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

Syntax

offline <object>

Parameter

Parameter	BESCHREIBUNG
<object>	Gibt den Typ des Objekts an, für den der Vorgang ausgeführt werden soll. Der Typ kann Folgendes sein: subsystem, controller, drive, 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	BESCHREIBUNG
<object>	Gibt den Typ des Objekts an, für den der Vorgang ausgeführt werden soll. Der Typ kann Folgendes sein: hbaport, subsystem, controller, drive, LUN oder tportal.

recover

Führt Vorgänge aus, die erforderlich sind, z. B. „resynchronisierung“ oder „hot sparing“, um die aktuell ausgewählte fehlertolerante LUN zu reparieren. Beispielsweise kann RECOVER dazu führen, dass ein Hotspare an eine RAID-Gruppe gebunden wird, die einen fehlerhaften Datenträger oder eine andere Neuzuordnung des Datenträgerbereichs aufweist.

Syntax

recover <lun>

reenumerate

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

Syntax

reenumerate {subsystems | drives}

Parameter

Parameter	BESCHREIBUNG
subsystems	Fragt den Anbieter ab, um alle neuen Subsysteme zu ermitteln, die im aktuell ausgewählten Anbieter hinzugefügt wurden.
Laufwerke	Fragt die internen E/A-Busse ab, um neue Laufwerke zu ermitteln, die im aktuell ausgewählten Subsystem hinzugefügt wurden.

Aktualisieren

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	BESCHREIBUNG
tpgroup tportal=<tportal>	Gibt das zu entfernende iSCSI-Zielportal an.
noerr	Nur zur Skripterstellung. Bei einem Fehler setzt Diskraid die Verarbeitung von Befehlen fort, als sei der Fehler nicht aufgetreten.

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	BESCHREIBUNG
drive=	Gibt den <drive_number> für das zu ersetzende Laufwerk an.

reset

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

Syntax

reset {controller | port}

Parameter

Parameter	BESCHREIBUNG
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>]

Parameter

Parameter	BESCHREIBUNG
Objekt (object)	Gibt den Typ des auszuwählenden Objekts an, einschließlich : provider, subsystem, controller, drive 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). Wenn Sie einen ungültigen HBA-Portindex angeben, wird kein HBA-Port im Fokus angezeigt. 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 (falls vorhanden). Wenn Sie einen ungültigen Initiatoradapterindex angeben, wird kein Initiatoradapter im Fokus angezeigt. 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 (falls vorhanden). Wenn Sie einen ungültigen Initiatorportalindex angeben, wird kein Initiatorportal ausgewählt.
provider [<n>]	Legt den Fokus auf den angegebenen Anbieter fest. Wenn kein Anbieter angegeben ist, zeigt der Befehl den aktuell ausgewählten Anbieter an (falls vorhanden). Wenn Sie einen ungültigen Anbieterindex angeben, wird kein Anbieter mit Fokus angegeben.
subsystem [<n>]	Legt den Fokus auf das angegebene Subsystem fest. Wenn kein Subsystem angegeben wird, zeigt der Befehl das Subsystem mit Fokus an (falls vorhanden). Wenn Sie einen ungültigen Subsystemindex angeben, wird kein Subsystem mit Fokus angezeigt. 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 (falls vorhanden). Wenn Sie einen ungültigen Controllerindex angeben, wird kein Controller mit Fokus angezeigt. 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 Port ausgewählt.
drive [<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). Wenn Sie einen ungültigen Laufwerkindex angeben, wird kein Laufwerk mit Fokus angezeigt. Wenn Sie ein Laufwerk auswählen, wird die Auswahl aller Controller, Controllerports, LUNs, Zielportale, Ziele und Zielportalgruppen aufgehoben.
lun [<n>]	Legt den Fokus auf die angegebene LUN innerhalb des aktuell ausgewählten Subsystems fest. Wenn keine LUN angegeben ist, zeigt der Befehl die aktuell ausgewählte LUN an (falls vorhanden). Wenn Sie einen ungültigen LUN-Index angeben, wird keine LUN ausgewählt. Wenn Sie eine LUN auswählen, wird die Auswahl aller Controller, Controllerports, Laufwerke, Zielportale, Ziele und Zielportalgruppen aufgehoben.
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 (falls vorhanden). Wenn Sie einen ungültigen Zielportalindex angeben, wird kein Zielportal ausgewählt. Wenn Sie ein Zielportal auswählen, werden alle ausgewählten Controller, Controllerports, Laufwerke, LUNs, Ziele und Zielportalgruppen deaktiviert.
target [<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 (falls vorhanden). Wenn Sie einen ungültigen Zielindex angeben, wird kein Ziel ausgewählt. Wenn Sie ein Ziel auswählen, werden alle ausgewählten Controller, Controllerports, Laufwerke, LUNs, Zielportale und Zielportalgruppen deaktiviert.
tpgroup [<n>]	Legt den Fokus auf die angegebene iSCSI-Zielgruppe innerhalb des aktuell ausgewählten iSCSI-Ziels fest. Wenn keine Zielportalgruppe angegeben ist, zeigt der Befehl die aktuell ausgewählte Zielportalgruppe an (falls vorhanden). Wenn Sie einen ungültigen Zielportal-Gruppenindex angeben, wird keine Zielportalgruppe mit Fokus angezeigt.
[<n>]	Gibt den <object number> an, der ausgewählt werden soll. Wenn der angegebene <object number> ungültig ist, werden alle vorhandenen Auswahlmöglichkeiten für Objekte des angegebenen Typs gelöscht. Wenn kein <object number> angegeben wird, wird das aktuelle Objekt angezeigt.

setflag

Legt das aktuell ausgewählte Laufwerk als Hotspare fest. Hotspares können nicht für normale LUN-Bindungsvorgänge verwendet werden. Sie sind nur für die Fehlerbehandlung vorgesehen. Das Laufwerk darf derzeit nicht an eine vorhandene LUN gebunden sein.

Syntax

setflag drive hotspare={true | false}

Parameter

Parameter	BESCHREIBUNG
true	Wählt das aktuell ausgewählte Laufwerk als Hotspare aus.
false	Hebt die aktuelle Auswahl des Laufwerks als Hotspare auf.

shrink

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

Syntax

shrink lun size=<n> [noerr]

Parameter

Parameter	BESCHREIBUNG
size	Gibt den gewünschten Speicherplatz in Megabytes (MB) an, um die Größe des LUN zu reduzieren. Verwenden Sie direkt nach der Größe eines der folgenden erkannten Suffixe, um die Größe mit anderen Einheiten anzugeben: B: Byte KB: Kilobyte MB: Megabyte GB: Gigabyte TB: Terabyte PB: Petabyte
noerr	Nur zur Skripterstellung. Bei einem Fehler setzt Diskraid die Verarbeitung von Befehlen fort, als sei der Fehler nicht aufgetreten.

standby

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

Syntax

standby hbaport

Parameter

Parameter	BESCHREIBUNG
hbaport	Ändert den Status der Pfade zum aktuell ausgewählten Hostbusadapter-Port (HBA) in STANDBY.

unmask

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

Syntax

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

Parameter

Parameter	BESCHREIBUNG
all	Gibt an, dass die LUN von allen Hosts aus zugänglich gemacht werden soll. Sie können die Maskierung der LUN jedoch nicht für alle Ziele in einem iSCSI-Subsystem aufheben. Melden Sie sich vom Ziel ab, bevor Sie den Befehl unmask lun all ausführen.
Keine	Gibt an, dass die LUN nicht für einen Host zugänglich sein sollte. Melden Sie sich vom Ziel ab, 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 aus auf diese LUN zugegriffen werden kann. Wenn dieser Parameter nicht angegeben wird, ersetzt die Liste der bereitgestellten Hosts die vorhandene Liste der Hosts, von denen aus auf diese LUN zugegriffen werden kann.
wwn=	Gibt eine Liste von Hexadezimalzahlen an, die weltweite Namen darstellen, über die die LUN oder Hosts zugänglich gemacht werden sollen. Wenn Sie eine bestimmte Gruppe von Hosts in einem Fibre Channel-Subsystem maskieren bzw. die Maskierung aufheben möchten, können Sie eine durch Semikolon getrennte Liste von WWNs für die Ports auf den relevanten Hostcomputern eingeben.
initiator=	Gibt eine Liste von iSCSI-Initiatoren an, für die die aktuell ausgewählte LUN zugänglich gemacht werden soll. Wenn Sie eine bestimmte Gruppe von Hosts in einem iSCSI-Subsystem maskieren bzw. die Maskierung aufheben möchten, können Sie eine durch Semikolon getrennte Liste von iSCSI-Initiatornamen für die Initiatoren auf den relevanten Hostcomputern eingeben.
uninstall	Wenn angegeben, wird der Datenträger, der der LUN im lokalen System zugeordnet ist, deinstalliert, bevor die LUN maskiert wird.

Skripterstellung für Diskraid

Für Diskraid kann auf jedem Computer mit einer unterstützten Version von Windows Server mit einem zugeordneten VDS-Hardwareanbieter Skripts erstellt werden. Geben Sie an der Eingabeaufforderung Folgendes ein, um ein Diskraid-Skript aufzurufen:

diskraid /s <script.txt>

Standardmäßig beendet Diskraid die Verarbeitung von Befehlen und gibt einen Fehlercode zurück, wenn im Skript ein Problem vorliegt. Fügen Sie den Parameter noerr in den Befehl ein, um die Ausführung des Skripts fortzusetzen und Fehler zu ignorieren. Dies ermöglicht die Verwendung eines einzelnen Skripts zum Löschen aller LUNs in einem Subsystem unabhängig von der Gesamtzahl der LUNs. Nicht alle Befehle unterstützen den Parameter noerr. Fehler werden immer bei Befehlssyntaxfehlern zurückgegeben, unabhängig davon, ob Sie den Parameter noerr enthalten.

Diskraid-Fehlercodes

Fehlercode	Fehlerbeschreibung
0	Kein Fehler ist aufgetreten. Das gesamte Skript wurde ohne Fehler ausgeführt.
1	Es ist ein schwerwiegender Ausnahmefehler 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 von Diskraid verwendeten Dienste hat einen Fehler zurückgegeben.
5	Es ist ein Syntaxfehler aufgetreten. Das Skript konnte nicht ausgeführt werden, da ein Objekt nicht ordnungsgemäß ausgewählt wurde oder für die Verwendung mit diesem Befehl ungültig war.

Beispiel

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

diskraid

Drücken Sie die EINGABETASTE. Es wird eine Ausgabe ähnlich wie folgt angezeigt:

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. Es wird eine Ausgabe ähnlich wie folgt angezeigt:

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

Geben Sie zum Beenden von Diskraid Folgendes an der Diskraid-Eingabeaufforderung ein:

exit

Verwandte Links

• Erläuterung zur Befehlszeilensyntax