Diskraid

Diskraid è uno strumento a riga di comando che consente di configurare e gestire array ridondanti di sottosistemi di archiviazione RAID (Independent Disks Independent) (o poco costosi).

RAID viene in genere usato nei server per standardizzare e classificare i sistemi disco a tolleranza di errore. I livelli RAID offrono diverse combinazioni di prestazioni, affidabilità e costi. Alcuni server forniscono tre livelli RAID: livello 0 (striping), livello 1 (mirroring) e livello 5 (striping con parità).

Un sottosistema RAID hardware distingue le unità di archiviazione indirizzabili fisicamente l'una dall'altra usando un numero di unità logica (LUN). Un oggetto LUN deve avere almeno un plex e può avere un numero qualsiasi di plessi aggiuntivi. Ogni plex contiene una copia dei dati nell'oggetto LUN. I plexes possono essere aggiunti e rimossi da un oggetto LUN.

La maggior parte dei comandi Diskraid opera su una porta HBA (Host Bus Adapter), scheda iniziatore, portale iniziatore, provider, sottosistema, controller, porta, unità, LUN, portale di destinazione, destinazione o gruppo del portale di destinazione. Utilizzare il comando SELEZIONA per selezionare un oggetto. L'oggetto selezionato ha lo stato attivo. Lo stato attivo semplifica le attività di configurazione comuni, ad esempio la creazione di più LUN all'interno dello stesso sottosistema.

Note

Lo strumento da riga di comando Diskraid funziona solo con i sottosistemi di archiviazione che supportano il servizio dischi virtuali (VDS).

Diskraid commands

I comandi seguenti sono disponibili all'interno dello strumento Diskraid.

add

Aggiunge un LUN esistente al LUN attualmente selezionato oppure aggiunge un portale di destinazione iSCSI al gruppo di portale di destinazione iSCSI attualmente selezionato.

Syntax

add plex lun=n [noerr]
add tpgroup tportal=n [noerr]
Parameters
Parameter Description
plex lun=<n> Specifica il numero LUN da aggiungere come plex al LUN attualmente selezionato. ATTENZIONE: tutti i dati sul LUN da aggiungere come plex verranno eliminati.
tpgroup tportal=<n> Specifica il numero del portale di destinazione iSCSI da aggiungere al gruppo di portale di destinazione iSCSI attualmente selezionato.
noerr Solo per la creazione di script. Quando viene rilevato un errore, Diskraid continua a elaborare i comandi come se l'errore non si verificasse.

associate

Imposta l'elenco specificato di porte controller come attive per il LUN attualmente selezionato (altre porte controller vengono rese inattive) o aggiunge le porte controller specificate all'elenco delle porte del controller attivo esistenti per il LUN attualmente selezionato oppure associa la destinazione iSCSI specificata per il LUN attualmente selezionato.

Syntax

associate controllers [add] <n>[,<n> [,…]]
associate ports [add] <n-m>[,<n-m>[,…]]
associate targets [add] <n>[,<n> [,…]]
Parameters
Parameter Description
controller Aggiunge o sostituisce l'elenco dei controller associati al LUN attualmente selezionato. Usare solo con i provider VDS 1.0.
ports Aggiunge o sostituisce l'elenco di porte controller associate al LUN attualmente selezionato. Usare solo con i provider VDS 1.1.
targets Aggiunge o sostituisce l'elenco di destinazioni iSCSI associate al LUN attualmente selezionato. Usare solo con i provider VDS 1.1.
add Se si usano provider VDS 1.0: Aggiunge i controller specificati all'elenco esistente di controller associati al LUN. Se questo parametro non viene specificato, l'elenco dei controller sostituisce l'elenco esistente di controller associati a questo LUN.

Se si usano provider VDS 1.1: Aggiunge le porte controller specificate all'elenco esistente di porte controller associate al LUN. Se questo parametro non viene specificato, l'elenco di porte controller sostituisce l'elenco esistente di porte controller associate a questo LUN.

<n>[,<n> [, ...]] Utilizzare con il parametro controller o targets . Specifica i numeri dei controller o delle destinazioni iSCSI da impostare su attivo o associato.
<n-m>[,<n-m>[,…]] Utilizzare con il parametro ports . Specifica le porte del controller da impostare come attive utilizzando una coppia di numeri di controller (n) e numeri di porta (m).

Example

Per associare e aggiungere porte a un LUN che usa un provider 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

Imposta o cancella i flag che forniscono suggerimenti ai provider su come configurare un LUN. Utilizzata senza parametri, l'operazione automagic visualizza un elenco di flag.

Syntax

automagic {set | clear | apply} all <flag=value> [<flag=value> [...]]
Parameters
Parameter Description
set Imposta i flag specificati sui valori specificati.
clear Cancella i flag specificati. La parola chiave all cancella tutti i flag di automagia.
apply Applica i flag correnti al LUN selezionato.
<flag> I flag sono identificati da acronimi di tre lettere, tra cui:
  • FCR - Ripristino rapido in caso di arresto anomalo richiesto
  • FTL - Tolleranza ai guasti
  • MSR - Letture per lo più
  • MXD - Numero massimo di unità
  • MXS - Dimensione massima prevista
  • ORA - Allineamento ottimale in lettura
  • ORS - Dimensione di lettura ottimale
  • OSR - Ottimizza per le letture sequenziali
  • OSW - Ottimizza per le scritture sequenziali
  • OWA - Allineamento ottimale della scrittura
  • OWS - Dimensione di scrittura ottimale
  • RBP - Priorità di ricostruzione
  • RBV - Verifica lettura abilitata
  • RMP - Rimappa abilitato
  • STS - Dimensione striscia
  • WTC - Memorizzazione nella cache Write-Through abilitata
  • YNK - Rimovibile

break

Rimuove il plex dal LUN attualmente selezionato. I plex e i dati contenuti non vengono conservati e gli extent dell'unità possono essere recuperati.

Caution

Prima di usare questo comando, è necessario selezionare un LUN con mirroring. Tutti i dati sul plex verranno eliminati. Non è garantito che tutti i dati contenuti nel LUN originale siano coerenti.

Syntax

break plex=<plex_number> [noerr]
Parameters
Parameter Description
plex Specifica il numero di plex da rimuovere. I plex e i dati contenuti non verranno conservati e le risorse usate da questo plex verranno recuperate. Non è garantito che i dati contenuti nel LUN siano coerenti. Se si vuole mantenere questo plex, usare il servizio Copia Shadow del volume (VSS).
noerr Solo per la creazione di script. Quando viene rilevato un errore, Diskraid continua a elaborare i comandi come se l'errore non si verificasse.

chap

Imposta il segreto condiviso CHAP (Challenge Handshake Authentication Protocol) in modo che gli iniziatori iSCSI e le destinazioni iSCSI possano comunicare tra loro.

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 Imposta il segreto condiviso nel servizio iniziatore iSCSI locale utilizzato per l'autenticazione CHAP reciproca quando l'iniziatore autentica la destinazione.
initiator remember Comunica il segreto CHAP di una destinazione iSCSI al servizio iniziatore iSCSI locale in modo che il servizio iniziatore possa usare il segreto per autenticarsi nella destinazione durante l'autenticazione CHAP.
target set Imposta il segreto condiviso nella destinazione iSCSI attualmente selezionata utilizzata per l'autenticazione CHAP quando la destinazione autentica l'iniziatore.
target remember Comunica il segreto CHAP di un iniziatore iSCSI alla destinazione iSCSI corrente in modo che la destinazione possa usare il segreto per autenticarsi con l'iniziatore durante l'autenticazione CHAP reciproca.
secret Specifica il segreto da utilizzare. Se vuoto, il segreto verrà cancellato.
target Specifica una destinazione nel sottosistema attualmente selezionato da associare al segreto. Questa opzione è facoltativa quando si imposta un segreto sull'iniziatore e si esce da esso indica che il segreto verrà usato per tutte le destinazioni che non dispongono già di un segreto associato.
initiatorname Specifica un nome iSCSI iniziatore da associare al segreto. Questa opzione è facoltativa quando si imposta un segreto su una destinazione e la si esce indica che il segreto verrà usato per tutti gli iniziatori che non dispongono già di un segreto associato.

create

Crea una nuova destinazione LUN o iSCSI nel sottosistema attualmente selezionato oppure crea un gruppo di portale di destinazione nella destinazione attualmente selezionata. È possibile visualizzare l'associazione effettiva utilizzando il comando 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 Crea un LUN semplice.
stripe Crea un LUN con striping.
raid Crea un LUN con striping con parità.
mirror Crea un LUN con mirroring.
automagic Crea un LUN utilizzando i suggerimenti automagici attualmente in vigore. Per altre informazioni, vedere il sottocomando automagic in questo articolo.
size= Specifica la dimensione lun totale in megabyte. Deve essere specificato il parametro size= o drives=. Possono anche essere usati insieme. Se il parametro size= non è specificato, il LUN creato sarà la dimensione più grande possibile consentita da tutte le unità specificate.

Un provider crea in genere un LUN almeno quanto le dimensioni richieste, ma il provider potrebbe dover arrotondare fino alla dimensione più grande successiva in alcuni casi. Ad esempio, se le dimensioni vengono specificate come 99 GB e il provider può allocare solo extent di disco GB, il LUN risultante sarà 1 GB. Per specificare le dimensioni usando altre unità, usare uno dei suffissi riconosciuti seguenti immediatamente dopo le dimensioni:

  • B - byte
  • KB - kilobyte
  • MB - megabyte
  • GB - gigabyte
  • TB - terabyte
  • PB - petabyte.
drives= Specifica il drive_number per le unità da utilizzare per creare un LUN. Deve essere specificato il parametro size= o drives=. Possono anche essere usati insieme. Se il parametro size= non è specificato, il LUN creato è la dimensione massima possibile consentita da tutte le unità specificate. Se viene specificato il parametro size= , i provider selezioneranno le unità dall'elenco di unità specificato per creare il LUN. I provider tenteranno di usare le unità nell'ordine specificato quando possibile.
stripesize= Specifica le dimensioni in megabyte per un LUN stripe o raid . Non è possibile modificare il formato di stripsize dopo la creazione del LUN. Per specificare le dimensioni usando altre unità, usare uno dei suffissi riconosciuti seguenti immediatamente dopo le dimensioni:
  • B - byte
  • KB - kilobyte
  • MB - megabyte
  • GB - gigabyte
  • TB - terabyte
  • PB - petabyte.
target Crea una nuova destinazione iSCSI nel sottosistema attualmente selezionato.
name Fornisce il nome descrittivo per la destinazione.
iscsiname Specifica il nome iSCSI per la destinazione e può essere omesso per fare in modo che il provider generi un nome.
tpgroup Crea un nuovo gruppo di portale di destinazione iSCSI nella destinazione attualmente selezionata.
noerr Solo per la creazione di script. Quando viene rilevato un errore, Diskraid continua a elaborare i comandi come se l'errore non si verificasse.

delete

Elimina il LUN attualmente selezionato, la destinazione iSCSI (purché non siano presenti LUN associati alla destinazione iSCSI) o al gruppo del portale di destinazione iSCSI.

Syntax

delete lun [uninstall] [noerr]
delete target [noerr]
delete tpgroup [noerr]
Parameters
Parameter Description
lun Elimina il LUN attualmente selezionato e tutti i dati in esso contenuti.
uninstall Specifica che il disco nel sistema locale associato al LUN verrà pulito prima dell'eliminazione del LUN.
target Elimina la destinazione iSCSI attualmente selezionata se alla destinazione non sono associate LUN.
tpgroup Elimina il gruppo del portale di destinazione iSCSI attualmente selezionato.
noerr Solo per la creazione di script. Quando viene rilevato un errore, Diskraid continua a elaborare i comandi come se l'errore non si verificasse.

detail

Visualizza informazioni dettagliate sull'oggetto attualmente selezionato del tipo specificato.

Syntax

detail {hbaport | iadapter | iportal | provider | subsystem | controller | port | drive | lun | tportal | target | tpgroup} [verbose]
Parameters
Parameter Description
hbaport Elenca informazioni dettagliate sulla porta HBA (Host Bus Adapter) attualmente selezionata.
iadapter Elenca informazioni dettagliate sull'adattatore iniziatore iSCSI attualmente selezionato.
iportal Elenca informazioni dettagliate sul portale iniziatore iSCSI attualmente selezionato.
provider Elenca informazioni dettagliate sul provider attualmente selezionato.
subsystem Elenca informazioni dettagliate sul sottosistema attualmente selezionato.
controller Elenca informazioni dettagliate sul controller attualmente selezionato.
port Elenca informazioni dettagliate sulla porta del controller attualmente selezionata.
drive Elenca informazioni dettagliate sull'unità attualmente selezionata, inclusi i LUN occupati.
lun Elenca informazioni dettagliate sul LUN attualmente selezionato, incluse le unità che contribuiscono. L'output è leggermente diverso a seconda che il LUN faccia parte di un sottosistema Fibre Channel o iSCSI. Se l'elenco Host non mascherati contiene solo un asterisco, significa che il LUN non viene mascherato in tutti gli host.
tportal Elenca informazioni dettagliate sul portale di destinazione iSCSI attualmente selezionato.
target Elenca informazioni dettagliate sulla destinazione iSCSI attualmente selezionata.
tpgroup Elenca informazioni dettagliate sul gruppo del portale di destinazione iSCSI attualmente selezionato.
verbose Per l'uso solo con il parametro LUN. Elenca informazioni aggiuntive, inclusi i relativi puntini di sospensione.

dissociate

Imposta l'elenco specificato di porte controller come inattive per il LUN attualmente selezionato (altre porte controller non sono interessate) o annulla l'elenco specificato di destinazioni iSCSI per il LUN attualmente selezionato.

Syntax

dissociate controllers <n> [,<n> [,...]]
dissociate ports <n-m>[,<n-m>[,…]]
dissociate targets <n> [,<n> [,…]]
Parameter
Parameter Description
controllers Rimuove i controller dall'elenco dei controller associati al LUN attualmente selezionato. Usare solo con i provider VDS 1.0.
ports Rimuove le porte controller dall'elenco di porte controller associate al LUN attualmente selezionato. Usare solo con i provider VDS 1.1.
targets Rimuove le destinazioni dall'elenco di destinazioni iSCSI associate al LUN attualmente selezionato. Usare solo con i provider VDS 1.1.
<n> [,<n> [,…]] Da utilizzare con i controller o il parametro targets . Specifica i numeri dei controller o delle destinazioni iSCSI da impostare come inattivi o dissociati.
<n-m>[,<n-m>[,…]] Da utilizzare con il parametro ports . Specifica le porte del controller da impostare come inattive utilizzando una coppia di numeri di controller (n) e numeri di porta (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

Estende il LUN attualmente selezionato aggiungendo i settori alla fine del LUN. Non tutti i provider supportano l'estensione dei LUN. Non estende volumi o file system contenuti nel LUN. Dopo aver esteso il LUN, è necessario estendere le strutture su disco associate utilizzando il comando DiskPart extend.

Syntax

extend lun [size=<LUN_size>] [drives=<drive_number>, [<drive_number>, ...]] [noerr]
Parameters
Parameter Description
size Specifica le dimensioni in megabyte per estendere il LUN. È necessario specificare la dimensione o il <drive> parametro. Possono anche essere usati insieme. Se il parametro size= non viene specificato, il LUN viene esteso della dimensione massima possibile consentita da tutte le unità specificate. Se viene specificato il parametro size= , i provider selezionano le unità dall'elenco specificato dal parametro drives= per creare il LUN. Per specificare le dimensioni usando altre unità, usare uno dei suffissi riconosciuti seguenti immediatamente dopo le dimensioni:
  • B - byte
  • KB - kilobyte
  • MB - megabyte
  • GB - gigabyte
  • TB - terabyte
  • PB - petabyte.
drives= Specifica il <drive_number> per le unità da usare durante la creazione di un LUN. È necessario specificare la dimensione o il <drive> parametro. Possono anche essere usati insieme. Se il parametro size= non è specificato, il LUN creato è la dimensione massima possibile consentita da tutte le unità specificate. I provider usano le unità nell'ordine specificato quando possibile.
noerr Solo per la creazione di script. Quando viene rilevato un errore, Diskraid continua a elaborare i comandi come se l'errore non si verificasse.

flushcache

Cancella la cache nel controller attualmente selezionato.

Syntax

flushcache controller

help

Visualizza un elenco di tutti i comandi Diskraid.

Syntax

help

importtarget

Recupera o imposta la destinazione di importazione corrente del servizio Copia Shadow del volume impostata per il sottosistema attualmente selezionato.

Syntax

importtarget subsystem [set target]
Parameter
Parameter Description
set target Se specificato, imposta la destinazione attualmente selezionata sulla destinazione di importazione vss per il sottosistema attualmente selezionato. Se non specificato, il comando recupera la destinazione di importazione vss corrente impostata per il sottosistema attualmente selezionato.

initiator

Recupera informazioni sull'iniziatore iSCSI locale.

Syntax

initiator

invalidatecache

Invalida la cache nel controller attualmente selezionato.

Syntax

invalidatecache controller

lbpolicy

Imposta i criteri di bilanciamento del carico nel LUN attualmente selezionato.

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 Specifica i criteri di bilanciamento del carico. Se il tipo non viene specificato, è necessario specificare il parametro path . Tipo può essere uno dei seguenti:
  • FAILOVER : utilizza un percorso primario mentre gli altri percorsi sono percorsi di backup.
  • ROUNDROBIN - Utilizza tutti i percorsi in modalità round robin, che prova ogni percorso in sequenza.
  • SUBSETROUNDROBIN - Utilizza tutti i percorsi primari in modalità round-robin; I percorsi di backup vengono utilizzati solo se tutti i percorsi primari hanno esito negativo.
  • DYNLQD : utilizza il percorso con il minor numero di richieste attive.
  • WEIGHTED - Utilizza il percorso con il peso minimo (a ogni percorso deve essere assegnato un peso).
  • LEASTBLOCKS - Utilizza il percorso con il minor numero di blocchi.
  • VENDORSPECIFIC : utilizza un criterio specifico del fornitore.
path Specifica se un percorso è primario o ha un particolare <weight>. Tutti i percorsi non specificati vengono impostati in modo implicito come backup. Tutti i percorsi elencati devono essere uno dei percorsi lun attualmente selezionati.

list

Visualizza un elenco di oggetti del tipo specificato.

Syntax

list {hbaports | iadapters | iportals | providers | subsystems | controllers | ports | drives | LUNs | tportals | targets | tpgroups}
Parameters
Parameter Description
hbaports Elenca le informazioni di riepilogo su tutte le porte HBA note al VDS. La porta HBA attualmente selezionata è contrassegnata da un asterisco (*).
iadapters Elenca le informazioni di riepilogo su tutti gli adattatori iniziatori iSCSI noti al VDS. L'adattatore iniziatore attualmente selezionato è contrassegnato da un asterisco (*).
iportals Elenca le informazioni di riepilogo su tutti i portali iniziatori iSCSI nell'adattatore iniziatore attualmente selezionato. Il portale iniziatore attualmente selezionato è contrassegnato da un asterisco (*).
providers Elenca le informazioni di riepilogo su ogni provider noto a VDS. Il provider attualmente selezionato è contrassegnato da un asterisco (*).
subsystems Elenca le informazioni di riepilogo su ogni sottosistema nel sistema. Il sottosistema attualmente selezionato è contrassegnato da un asterisco (*).
controllers Elenca le informazioni di riepilogo su ogni controller nel sottosistema attualmente selezionato. Il controller attualmente selezionato è contrassegnato da un asterisco (*).
ports Elenca le informazioni di riepilogo su ogni porta controller nel controller attualmente selezionato. La porta attualmente selezionata è contrassegnata da un asterisco (*).
drives Elenca le informazioni di riepilogo su ogni unità nel sottosistema attualmente selezionato. L'unità attualmente selezionata è contrassegnata da un asterisco (*).
luns Elenca le informazioni di riepilogo su ogni LUN nel sottosistema attualmente selezionato. Il LUN attualmente selezionato è contrassegnato da un asterisco (*).
tportals Elenca le informazioni di riepilogo su tutti i portali di destinazione iSCSI nel sottosistema attualmente selezionato. Il portale di destinazione attualmente selezionato è contrassegnato da un asterisco (*).
targets Elenca le informazioni di riepilogo su tutte le destinazioni iSCSI nel sottosistema attualmente selezionato. La destinazione attualmente selezionata è contrassegnata da un asterisco (*).
tpgroups Elenca le informazioni di riepilogo su tutti i gruppi del portale di destinazione iSCSI nella destinazione attualmente selezionata. Il gruppo del portale attualmente selezionato è contrassegnato da un asterisco (*).

login

Registra l'adattatore iniziatore iSCSI specificato nella destinazione iSCSI attualmente selezionata.

Syntax

login target iadapter=<iadapter> [type={manual | persistent | boot}] [chap={none | oneway | mutual}] [iportal=<iportal>] [tportal=<tportal>] [<flag> [<flag> […]]]
Parameters
Parameter Description
type Specifica il tipo di accesso da eseguire: manuale o persistente. Se non specificato, verrà eseguito un account di accesso manuale.
manual Login manually. C'è anche un'opzione di avvio destinata allo sviluppo futuro e attualmente non utilizzata.
persistent Usare automaticamente lo stesso account di accesso quando il computer viene riavviato.
chap Specifica il tipo di autenticazione CHAP da utilizzare: nessuna, CHAP unidirezionale o CHAP reciproco ; Se non specificato, non verrà utilizzata alcuna autenticazione.
tportal Specifica un portale di destinazione facoltativo nel sottosistema attualmente selezionato da usare per l'accesso.
iportal Specifica un portale iniziatore facoltativo nell'adattatore iniziatore specificato da utilizzare per l'accesso.
<flag> Identificato da acronimi di tre lettere:
  • IPS - Richiedi IPsec
  • EMP - Abilita multipath
  • EHD - Abilita digest intestazione
  • EDD - Abilita digest dati

logout

Registra l'adattatore iniziatore iSCSI specificato dalla destinazione iSCSI attualmente selezionata.

Syntax

logout target iadapter= <iadapter>
Parameters
Parameter Description
iadapter Specifica l'adattatore iniziatore con una sessione di accesso da cui eseguire la disconnessione.

maintenance

Esegue operazioni di manutenzione sull'oggetto attualmente selezionato del tipo specificato.

Syntax

maintenance <object operation> [count=<iteration>]
Parameters
Parameter Description
<object> Specifica il tipo di oggetto su cui eseguire l'operazione. Il tipo di oggetto può essere un sottosistema, un controller, una porta, un'unità o un LUN.
<operation> Specifica l'operazione di manutenzione da eseguire. Il tipo di operazione può essere spinup, spindown, blink, beep o ping. È necessario specificare un'operazione .
count= Specifica il numero di ripetizioni dell'operazione. Questo viene in genere utilizzato con blink, bip o ping.

name

Imposta il nome descrittivo del sottosistema, del LUN o della destinazione iSCSI attualmente selezionato sul nome specificato.

Syntax

name {subsystem | lun | target} [<name>]
Parameter
Parameter Description
<name> Specifica un nome per il sottosistema, il LUN o la destinazione. Il nome deve avere una lunghezza inferiore a 64 caratteri. Se non viene specificato alcun nome, il nome esistente, se presente, viene eliminato.

offline

Imposta lo stato dell'oggetto attualmente selezionato del tipo specificato su offline.

Syntax

offline <object>
Parameter
Parameter Description
<object> Specifica il tipo di oggetto su cui eseguire questa operazione. Il tipo può essere: sottosistema, controller, azionamento, LUN o tportal.

online

Imposta lo stato dell'oggetto selezionato del tipo specificato su online. Se l'oggetto è hbaport, modifica lo stato dei percorsi della porta HBA attualmente selezionata in online.

Syntax

online <object>
Parameter
Parameter Description
<object> Specifica il tipo di oggetto su cui eseguire questa operazione. Il tipo può essere: hbaport, sottosistema, controller, azionamento, LUN o tportal.

recover

Esegue operazioni necessarie, ad esempio la risincronizzazione o la spaziatura a caldo, per ripristinare il LUN a tolleranza di errore attualmente selezionato. Ad esempio, RECOVER potrebbe causare un'associazione di riserva ad accesso frequente a un set RAID con un disco non riuscito o un'altra riallocazione dell'extent del disco.

Syntax

recover <lun>

reenumerate

Numenumera gli oggetti del tipo specificato. Se si usa il comando EXTEND LUN, è necessario usare il comando refresh per aggiornare le dimensioni del disco prima di usare il comando reenumerate.

Syntax

reenumerate {subsystems | drives}
Parameters
Parameter Description
subsystems Esegue una query sul provider per individuare eventuali nuovi sottosistemi aggiunti nel provider attualmente selezionato.
drives Esegue una query sugli autobus di I/O interni per individuare le nuove unità aggiunte nel sottosistema attualmente selezionato.

refresh

Aggiorna i dati interni per il provider attualmente selezionato.

Syntax

refresh provider

rem

Usato per impostare come commento gli script.

Syntax

Rem <comment>

remove

Rimuove il portale di destinazione iSCSI specificato dal gruppo del portale di destinazione attualmente selezionato.

Syntax

remove tpgroup tportal=<tportal> [noerr]
Parameter
Parameter Description
tpgroup tportal=<tportal> Specifica il portale di destinazione iSCSI da rimuovere.
noerr Solo per la creazione di script. Quando viene rilevato un errore, Diskraid continua a elaborare i comandi come se l'errore non si verificasse.

replace

Sostituisce l'unità specificata con l'unità attualmente selezionata. L'unità specificata potrebbe non essere l'unità attualmente selezionata.

Syntax

replace drive=<drive_number>
Parameter
Parameter Description
drive= Specifica il <drive_number> per la sostituzione dell'unità.

reset

Reimposta il controller o la porta attualmente selezionata.

Syntax

reset {controller | port}
Parameters
Parameter Description
controller Reimposta il controller.
port Reimposta la porta.

select

Visualizza o modifica l'oggetto attualmente selezionato.

Syntax

select {hbaport | iadapter | iportal | provider | subsystem | controller | port | drive | lun | tportal | target | tpgroup } [<n>]
Parameters
Parameter Description
object Specifica il tipo di oggetto da selezionare, tra cui: provider, sottosistema, controller, unità o LUN.
HBAport [<n>] Imposta lo stato attivo sulla porta HBA locale specificata. Se non viene specificata alcuna porta HBA, il comando visualizza la porta HBA attualmente selezionata (se presente). Se si specifica un indice di porta HBA non valido, non viene restituita alcuna porta HBA con stato attivo. Se si seleziona una porta HBA, vengono deselezionati tutti gli adattatori iniziatori e i portali iniziatori selezionati.
iadapter [<n>] Imposta lo stato attivo sull'adattatore iniziatore iSCSI locale specificato. Se non viene specificato alcun adattatore iniziatore, il comando visualizza l'adattatore iniziatore attualmente selezionato (se presente). Se si specifica un indice dell'adattatore iniziatore non valido, non viene restituito alcun adattatore iniziatore con stato attivo. Se si seleziona un adattatore iniziatore, vengono deselezionate le porte HBA e i portali iniziatori selezionati.
iportale [<n>] Imposta lo stato attivo sul portale iniziatore iSCSI locale specificato all'interno dell'adattatore iniziatore iSCSI selezionato. Se non viene specificato alcun portale iniziatore, il comando visualizza il portale iniziatore attualmente selezionato (se presente). Se si specifica un indice dell'iniziatore non valido, non viene restituito alcun portale iniziatore selezionato.
provider [<n>] Imposta lo stato attivo sul provider specificato. Se non viene specificato alcun provider, il comando visualizza il provider attualmente selezionato (se presente). Se si specifica un indice del provider non valido, non viene generato alcun provider con stato attivo.
sottosistema [<n>] Imposta lo stato attivo sul sottosistema specificato. Se non viene specificato alcun sottosistema, il comando visualizza il sottosistema con lo stato attivo (se presente). Se si specifica un indice del sottosistema non valido, non viene generato alcun sottosistema attivo. Se si seleziona un sottosistema, il provider associato viene selezionato in modo implicito.
controllore [<n>] Imposta lo stato attivo sul controller specificato all'interno del sottosistema attualmente selezionato. Se non viene specificato alcun controller, il comando visualizza il controller attualmente selezionato (se presente). Se si specifica un indice controller non valido, non viene generato alcun controller con stato attivo. Se si seleziona un controller, vengono deselezionate le porte, le unità, i LUN, i portali di destinazione, le destinazioni e i gruppi del portale di destinazione selezionati.
[<n>] porta Imposta lo stato attivo sulla porta del controller specificata all'interno del controller attualmente selezionato. Se non viene specificata alcuna porta, il comando visualizza la porta attualmente selezionata (se presente). Se si specifica un indice di porta non valido, non viene restituita alcuna porta selezionata.
unità [<n>] Imposta lo stato attivo sull'unità specificata o sullo spindle fisico all'interno del sottosistema attualmente selezionato. Se non viene specificata alcuna unità, il comando visualizza l'unità attualmente selezionata (se presente). Se si specifica un indice di unità non valido, non viene eseguita alcuna unità messa a fuoco. Se si seleziona un'unità, vengono deselezionati i controller, le porte controller, i LUN, i portali di destinazione, le destinazioni e i gruppi del portale di destinazione.
lun [<n>] Imposta lo stato attivo sul LUN specificato all'interno del sottosistema attualmente selezionato. Se non viene specificato alcun LUN, il comando visualizza il LUN attualmente selezionato (se presente). Se si specifica un indice LUN non valido, non viene restituito alcun LUN selezionato. Se si seleziona un LUN, vengono deselezionati i controller, le porte controller, le unità, i portali di destinazione, le destinazioni e i gruppi del portale di destinazione.
[<n>] tportal Imposta lo stato attivo sul portale di destinazione iSCSI specificato all'interno del sottosistema attualmente selezionato. Se non viene specificato alcun portale di destinazione, il comando visualizza il portale di destinazione attualmente selezionato (se presente). Se si specifica un indice del portale di destinazione non valido, non viene restituito alcun portale di destinazione selezionato. Se si seleziona un portale di destinazione, vengono deselezionati i controller, le porte controller, le unità, i LUN, le destinazioni e i gruppi del portale di destinazione.
[<n>] di destinazione Imposta lo stato attivo sulla destinazione iSCSI specificata all'interno del sottosistema attualmente selezionato. Se non viene specificata alcuna destinazione, il comando visualizza la destinazione attualmente selezionata (se presente). Se si specifica un indice di destinazione non valido, non viene restituita alcuna destinazione selezionata. Se si seleziona una destinazione, vengono deselezionati tutti i controller, le porte controller, le unità, i LUN, i portali di destinazione e i gruppi del portale di destinazione.
tpgroup [<n>] Imposta lo stato attivo sul gruppo del portale di destinazione iSCSI specificato all'interno della destinazione iSCSI attualmente selezionata. Se non viene specificato alcun gruppo di portale di destinazione, il comando visualizza il gruppo del portale di destinazione attualmente selezionato (se presente). Se si specifica un indice di gruppo del portale di destinazione non valido, non viene generato alcun gruppo di portale di destinazione con stato attivo.
[<n>] Specifica il <object number> da selezionare. Se la <object number> specificata non è valida, tutte le selezioni esistenti per gli oggetti del tipo specificato vengono cancellate. Se non viene specificato alcun <object number>, viene visualizzato l'oggetto corrente.

setflag

Imposta l'unità attualmente selezionata come riserva a caldo. Non è possibile usare i riserva ad accesso frequente per le normali operazioni di associazione LUN. Sono riservati solo per la gestione degli errori. L'unità non deve essere attualmente associata a un LUN esistente.

Syntax

setflag drive hotspare={true | false}
Parameters
Parameter Description
true Seleziona l'unità attualmente selezionata come riserva a caldo.
false Deseleziona l'unità attualmente selezionata come riserva a caldo.

shrink

Riduce le dimensioni del LUN selezionato.

Syntax

shrink lun size=<n> [noerr]
Parameters
Parameter Description
size Specifica la quantità di spazio desiderata in megabyte (MB) per ridurre le dimensioni del LUN. Per specificare le dimensioni usando altre unità, usare uno dei suffissi riconosciuti seguenti immediatamente dopo le dimensioni:
  • B - byte
  • KB - kilobyte
  • MB - megabyte
  • GB - gigabyte
  • TB - terabyte
  • PB - petabyte.
noerr Solo per la creazione di script. Quando viene rilevato un errore, Diskraid continua a elaborare i comandi come se l'errore non si verificasse.

standby

Modifica lo stato dei percorsi alla porta HBA (Host Bus Adapter) attualmente selezionata in STANDBY.

Syntax

standby hbaport
Parameters
Parameter Description
hbaport Modifica lo stato dei percorsi alla porta HBA (Host Bus Adapter) attualmente selezionata in STANDBY.

unmask

Rende accessibili i LUN attualmente selezionati dagli host specificati.

Syntax

unmask lun {all | none | [add] wwn=<hexadecimal_number> [;<hexadecimal_number> [;…]] | [add] initiator=<initiator>[;<initiator>[;…]]} [uninstall]
Parameters
Parameter Description
all Specifica che il LUN deve essere reso accessibile da tutti gli host. Tuttavia, non è possibile annullare il mascheramento del LUN a tutte le destinazioni in un sottosistema iSCSI.

È necessario disconnettersi dalla destinazione prima di eseguire il comando unmask lun all.

none Specifica che il LUN non deve essere accessibile ad alcun host.

È necessario disconnettersi dalla destinazione prima di eseguire il comando unmask lun none.

add Specifica che gli host specificati devono essere aggiunti all'elenco esistente di host da cui è accessibile il LUN. Se questo parametro non viene specificato, l'elenco di host forniti sostituisce l'elenco esistente di host da cui è accessibile il LUN.
wwn= Specifica un elenco di numeri esadecimali che rappresentano nomi a livello mondiale da cui rendere accessibili i LUN o gli host. Per mascherare o rimuovere il mascheramento in un set specifico di host in un sottosistema Fibre Channel, è possibile digitare un elenco delimitato da punto e virgola di WWN per le porte nei computer host di interesse.
initiator= Specifica un elenco di iniziatori iSCSI a cui deve essere reso accessibile il LUN attualmente selezionato. Per mascherare o rimuovere il mascheramento in un set specifico di host in un sottosistema iSCSI, è possibile digitare un elenco delimitato da punto e virgola di nomi di iniziatori iSCSI per gli iniziatori nei computer host di interesse.
uninstall Se specificato, disinstalla il disco associato al LUN nel sistema locale prima che il LUN venga mascherato.

Scripting Diskraid

Diskraid può essere creato tramite script in qualsiasi computer che esegue una versione supportata di Windows Server, con un provider di hardware VDS associato. Per richiamare uno script Diskraid, al prompt dei comandi digitare:

diskraid /s <script.txt>

Per impostazione predefinita, Diskraid interrompe l'elaborazione dei comandi e restituisce un codice di errore se si verifica un problema nello script. Per continuare a eseguire lo script e ignorare gli errori, includere il parametro noerr nel comando. In questo modo è possibile usare uno script singolo per eliminare tutti i LUN in un sottosistema indipendentemente dal numero totale di LUN. Non tutti i comandi supportano il parametro noerr . Gli errori vengono sempre restituiti in caso di errori di sintassi dei comandi, indipendentemente dal fatto che sia stato incluso o meno il parametro noerr .

Codici di errore diskraid

Error Code Error Description
0 Non si è verificato alcun errore. L'intero script è stato eseguito senza errori.
1 Si è verificata un'eccezione irreversibile.
2 Gli argomenti specificati in una riga di comando diskraid non sono corretti.
3 Diskraid non è riuscito ad aprire lo script o il file di output specificato.
4 Uno dei servizi usati da Diskraid ha restituito un errore.
5 Si è verificato un errore di sintassi del comando. Lo script non è riuscito perché un oggetto è stato selezionato in modo non corretto o non è valido per l'uso con tale comando.

Example

Per visualizzare lo stato del sottosistema 0 nel computer, digitare:

diskraid

Premere INVIO e output simile al seguente:

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

Per selezionare il sottosistema 0, digitare quanto segue al prompt diskraid:

select subsystem 0

Premere INVIO e output simile al seguente:

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

Per uscire da Diskraid, digitare quanto segue al prompt diskraid:

exit