Diskraid

  • Artículo

Diskraid es una herramienta de línea de comandos que permite configurar y administrar una matriz redundante de subsistemas de almacenamiento de discos independientes (o económicos) (RAID).

RAID se usa normalmente en servidores para estandarizar y clasificar los sistemas de disco tolerantes a errores. Los niveles RAID ofrecen varias combinaciones de rendimiento, confiabilidad y costo. Algunos servidores proporcionan tres de los niveles RAID: Nivel 0 (fragmentación), Nivel 1 (reflejo) y Nivel 5 (fragmentación con paridad).

Un subsistema RAID de hardware distingue las unidades de almacenamiento direccionables físicamente entre sí mediante un número de unidad lógica (LUN). Un objeto LUN debe tener al menos un plex y puede tener cualquier número de plexes adicionales. Cada plex contiene una copia de los datos en el objeto LUN. Los plexes se pueden agregar y quitar de un objeto LUN.

La mayoría de los comandos Diskraid funcionan en un puerto específico del adaptador de bus host (HBA), adaptador del iniciador, portal del iniciador, proveedor, subsistema, controlador, puerto, unidad, LUN, portal de destino, destino o grupo del portal de destino. Use el comando SELECT para seleccionar un objeto. Se dice que el objeto seleccionado tiene el foco. El foco simplifica las tareas de configuración comunes, como la creación de varios LUN en el mismo subsistema.

Nota:

La herramienta de línea de comandos Diskraid solo funciona con subsistemas de almacenamiento que admiten un servicio de disco virtual (VDS).

Comandos diskraid

Los siguientes comandos están disponibles desde la herramienta Diskraid.

add

Agrega un LUN existente al LUN seleccionado actualmente o agrega un portal de destino iSCSI al grupo de portales de destino iSCSI seleccionado actualmente.

Sintaxis

add plex lun=n [noerr]
add tpgroup tportal=n [noerr]
Parámetros
Parámetro Descripción
plex lun=<n> Especifica el número de LUN que se va a agregar como un plex al LUN seleccionado actualmente. PRECAUCIÓN: Se eliminarán todos los datos del LUN que se van a agregar como un plex.
tpgroup tportal=<n> Especifica el número del portal de destino iSCSI que se va a agregar al grupo de portales de destino iSCSI seleccionado actualmente.
noerr Sólo para scripting. Cuando se detecta un error, Diskraid sigue procesando los comandos como si no hubiera ningún error.

associate

Establece la lista especificada de puertos de controlador como activos para el LUN seleccionado actualmente (otros puertos de controlador están inactivos) o agrega los puertos de controlador especificados a la lista de puertos de controlador activos existentes para el LUN seleccionado actualmente o asocia el destino iSCSI especificado para el LUN seleccionado actualmente.

Sintaxis

associate controllers [add] <n>[,<n> [,…]]
associate ports [add] <n-m>[,<n-m>[,…]]
associate targets [add] <n>[,<n> [,…]]
Parámetros
Parámetro Descripción
controlador Agrega o reemplaza la lista de controladores asociados al LUN seleccionado actualmente. Usar solo con proveedores de VDS 1.0.
ports Agrega o reemplaza la lista de puertos de controlador asociados al LUN seleccionado actualmente. Usar solo con proveedores de VDS 1.1.
destinos Agrega o reemplaza la lista de destinos iSCSI asociados al LUN seleccionado actualmente. Usar solo con proveedores de VDS 1.1.
add Si usa proveedores de VDS 1.0: agrega los controladores especificados a la lista existente de controladores asociados al LUN. Si no se especifica este parámetro, la lista de controladores reemplaza la lista existente de controladores asociados a este LUN.

Si usa proveedores de VDS 1.1: agrega los puertos de controlador especificados a la lista existente de puertos de controlador asociados al LUN. Si no se especifica este parámetro, la lista de puertos de controlador reemplaza la lista existente de puertos de controlador asociados a este LUN.
<n>[,<n> [, ...]] Úselo con el parámetro controllers o targets. Especifica los números de los controladores o destinos iSCSI que se van a establecer en activos o asociados.
<n-m>[,<n-m>[,…]] Use con el parámetro ports. Especifica los puertos del controlador que se van a establecer como activos mediante un número de controlador (n) y un par de número de puerto (m).

Ejemplo

Para asociar y agregar puertos a un LUN que usa un proveedor 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

Establece o borra marcas que proporcionan sugerencias a los proveedores sobre cómo configurar un LUN. Si se usa sin parámetros, la operación automagic muestra una lista de marcas.

Sintaxis

automagic {set | clear | apply} all <flag=value> [<flag=value> [...]]
Parámetros
Parámetro Descripción
set Establece las marcas especificadas en los valores especificados.
clear Borra las marcas especificadas. La palabra clave all borra todas las marcas automagic.
apply Aplica las marcas actuales al LUN seleccionado.
<flag> Las marcas se identifican mediante acrónimos de tres letras, entre las que se incluyen:
  • FCR: recuperación rápida tras bloqueo necesaria
  • FTL: tolerante a errores
  • MSR: principalmente lecturas
  • MXD: unidades máximas
  • MXS: tamaño máximo esperado
  • ORA: alineación óptima de lectura
  • ORS: tamaño de lectura óptimo
  • OSR: optimización para lecturas secuenciales
  • OSW: optimización para escrituras secuenciales
  • OWA: alineación óptima de escritura
  • OWS: tamaño de escritura óptimo
  • RBP: prioridad de reconstrucción
  • RBV: comprobación de lectura habilitada
  • RMP: reasignación habilitada
  • STS: tamaño de franja
  • WTC: almacenamiento en caché de escritura simultánea habilitado
  • YNK: extraíble

break

Quita el plex del LUN seleccionado actualmente. El plex y los datos que contiene no se conservan y las extensiones de unidad se pueden reclamar.

Precaución

Primero debe seleccionar un LUN reflejado antes de usar este comando. Se eliminarán todos los datos del plex. No se garantiza que todos los datos contenidos en el LUN original sean coherentes.

Sintaxis

break plex=<plex_number> [noerr]
Parámetros
Parámetro Descripción
plex Especifica el número del plex que se va a quitar. El plex y los datos contenidos no se conservarán y se reclamarán los recursos utilizados por este plex. No se garantiza que los datos contenidos en el LUN sean coherentes. Si desea conservar este plex, use el Servicio de instantáneas de volumen (VSS).
noerr Sólo para scripting. Cuando se detecta un error, Diskraid sigue procesando los comandos como si no hubiera ningún error.

chap

Establece el secreto compartido del Protocolo de autenticación por desafío mutuo (CHAP) para que los iniciadores iSCSI y los destinos iSCSI puedan comunicarse entre sí.

Sintaxis

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>
Parámetros
Parámetro Descripción
initiator set Establece el secreto compartido en el servicio de iniciador iSCSI local que se usa para la autenticación CHAP mutua cuando el iniciador autentica el destino.
initiator remember Comunica el secreto CHAP de un destino iSCSI al servicio del iniciador iSCSI local para que el servicio de iniciador pueda usar el secreto para autenticarse en el destino durante la autenticación CHAP.
target set Establece el secreto compartido en el destino iSCSI seleccionado actualmente que se usa para la autenticación CHAP cuando el destino autentica al iniciador.
target remember Comunica el secreto CHAP de un iniciador iSCSI al destino iSCSI actual en foco para que el destino pueda usar el secreto para autenticarse en el iniciador durante la autenticación CHAP mutua.
secret Especifica el secreto que se va a usar. Si está vacío, se borrará el secreto.
Destino Especifica un destino en el subsistema seleccionado actualmente que se va a asociar al secreto. Esto es opcional. Si se establece un secreto en el iniciador y se deja fuera, esto indica que el secreto se usará para todos los destinos que aún no tienen un secreto asociado.
initiatorname Especifica un nombre iSCSI del iniciador que se va a asociar al secreto. Esto es opcional. Si se establece un secreto en el destino y se deja fuera, esto indica que el secreto se usará para todos los iniciadores que aún no tienen un secreto asociado.

create

Crea un nuevo destino LUN o iSCSI en el subsistema seleccionado actualmente o crea un grupo de portal de destino en el destino seleccionado actualmente. Puede ver el enlace real mediante el comando Diskraid list.

Sintaxis

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]
Parámetros
Parámetro Descripción
simple Crea un LUN simple.
franja Crea un LUN seccionado.
raid Crea un LUN seccionado con paridad.
mirror Crea un LUN reflejado.
automagic Crea un LUN mediante las sugerencias automagic actualmente en vigor. Para obtener más información, consulte el subcomando automagic de este artículo.
size= Especifica el tamaño total de LUN en megabytes. Se debe especificar el parámetro size= o drives=. También se pueden usar juntos. Si no se especifica el parámetro size=, el LUN creado será el tamaño más grande posible permitido por todas las unidades especificadas.

Normalmente, un proveedor crea un LUN al menos tan grande como el tamaño solicitado, pero es posible que el proveedor tenga que redondear hasta el siguiente tamaño más grande en algunos casos. Por ejemplo, si el tamaño se especifica como 0,99 GB y el proveedor solo puede asignar extensiones de disco GB, el LUN resultante sería de 1 GB. Para especificar el tamaño mediante otras unidades, use uno de los siguientes sufijos reconocidos inmediatamente después del tamaño:

  • B: byte
  • KB: kilobyte
  • MB: megabyte
  • GB: gigabyte
  • TB: terabyte
  • PB: petabyte.
drives= Especifica el drive_number de las unidades que se van a usar para crear un LUN. Se debe especificar el parámetro size= o drives=. También se pueden usar juntos. Si no se especifica el parámetro size=, el LUN creado es el tamaño más grande posible permitido por todas las unidades especificadas. Si se especifica el parámetro size=, los proveedores seleccionarán unidades de la lista de unidades especificadas para crear el LUN. Los proveedores intentarán usar las unidades en el orden especificado cuando sea posible.
stripesize= Especifica el tamaño en megabytes para un LUN stripe o raid. El stripesize no se puede cambiar después de crear el LUN. Para especificar el tamaño mediante otras unidades, use uno de los siguientes sufijos reconocidos inmediatamente después del tamaño:
  • B: byte
  • KB: kilobyte
  • MB: megabyte
  • GB: gigabyte
  • TB: terabyte
  • PB: petabyte.
Destino Crea un nuevo destino iSCSI en el subsistema seleccionado actualmente.
name Proporciona el nombre descriptivo del destino.
iscsiname Proporciona el nombre iSCSI para el destino y se puede omitir para que el proveedor genere un nombre.
tpgroup Crea un nuevo grupo de portal de destino iSCSI en el destino seleccionado actualmente.
noerr Sólo para scripting. Cuando se detecta un error, Diskraid sigue procesando los comandos como si no hubiera ningún error.

delete

Elimina el LUN seleccionado actualmente, el destino iSCSI (siempre que no haya ningún LUN asociado con el destino iSCSI) o el grupo del portal de destino iSCSI.

Sintaxis

delete lun [uninstall] [noerr]
delete target [noerr]
delete tpgroup [noerr]
Parámetros
Parámetro Descripción
lun Elimina el LUN seleccionado actualmente y todos los datos que hay en él.
uninstall Especifica que el disco del sistema local asociado al LUN se limpiará antes de eliminar el LUN.
Destino Elimina el destino iSCSI seleccionado actualmente si no hay ningún LUN asociado al destino.
tpgroup Elimina el grupo de portal de destino iSCSI seleccionado actualmente.
noerr Sólo para scripting. Cuando se detecta un error, Diskraid sigue procesando los comandos como si no hubiera ningún error.

detalles

Muestra información detallada sobre el objeto seleccionado actualmente del tipo especificado.

Sintaxis

detail {hbaport | iadapter | iportal | provider | subsystem | controller | port | drive | lun | tportal | target | tpgroup} [verbose]
Parámetros
Parámetro Descripción
hbaport Muestra información detallada sobre el puerto del adaptador de bus host (HBA) seleccionado actualmente.
iadapter Muestra información detallada sobre el adaptador del iniciador iSCSI seleccionado actualmente.
iportal Muestra información detallada sobre el portal del iniciador iSCSI seleccionado actualmente.
provider Muestra información detallada sobre el proveedor seleccionado actualmente.
subsistema Muestra información detallada sobre el subsistema seleccionado actualmente.
controlador Muestra información detallada sobre el controlador seleccionado actualmente.
port Muestra información detallada sobre el puerto del controlador seleccionado actualmente.
unidad Muestra información detallada sobre la unidad seleccionada actualmente, incluidos los LUN que ocupan.
lun Muestra información detallada sobre el LUN seleccionado actualmente, incluidas las unidades de contribución. La salida difiere ligeramente en función de si el LUN forma parte de un subsistema iSCSI o canal de fibra. Si la lista Hosts sin máscara contiene solo un asterisco, esto significa que el LUN no tiene máscara en ninguno de los hosts.
tportal Muestra información detallada sobre el portal de destino iSCSI seleccionado actualmente.
Destino Muestra información detallada sobre el destino iSCSI seleccionado actualmente.
tpgroup Muestra información detallada sobre el grupo de portal de destino iSCSI seleccionado actualmente.
verbose Para uso exclusivo con el parámetro LUN. Enumera información adicional, incluidos sus plexes.

dissociate

Establece la lista especificada de puertos de controlador como inactivos para el LUN seleccionado actualmente (otros puertos de controlador no se ven afectados) o desasocia la lista especificada de destinos iSCSI para el LUN seleccionado actualmente.

Syntax

dissociate controllers <n> [,<n> [,...]]
dissociate ports <n-m>[,<n-m>[,…]]
dissociate targets <n> [,<n> [,…]]
Parámetro
Parámetro Descripción
controllers Quita los controladores de la lista de controladores asociados al LUN seleccionado actualmente. Usar solo con proveedores de VDS 1.0.
ports Quita los puertos del controlador de la lista de puertos de controlador que están asociados al LUN seleccionado actualmente. Usar solo con proveedores de VDS 1.1.
destinos Quita los destinos de la lista de destinos iSCSI asociados al LUN seleccionado actualmente. Usar solo con proveedores de VDS 1.1.
<n> [,<n> [,…]] Para usar con el parámetro controllers o targets. Especifica los números de los controladores o destinos iSCSI que se van a establecer como inactivos o desasociados.
<n-m>[,<n-m>[,…]] Para su uso con el parámetro ports. Especifica los puertos del controlador que se van a establecer como inactivos mediante un número de controlador (n) y un par de número de puerto (m).

Ejemplo

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

Sale de Diskraid.

Sintaxis

exit

extend

Extiende el LUN seleccionado actualmente agregando sectores al final del LUN. No todos los proveedores admiten la extensión de LUN. No extiende ningún volumen ni sistema de archivos contenido en el LUN. Después de extender el LUN, debe extender las estructuras asociadas en disco mediante el comando DiskPart extend.

Sintaxis

extend lun [size=<LUN_size>] [drives=<drive_number>, [<drive_number>, ...]] [noerr]
Parámetros
Parámetro Descripción
tamaño Especifica el tamaño en megabytes para extender el LUN. Se debe especificar el size o el parámetro <drive>. También se pueden usar juntos. Si no se especifica el parámetro size=, el LUN se extiende por el tamaño más grande posible permitido por todas las unidades especificadas. Si se especifica el parámetro size=, los proveedores seleccionan unidades de la lista especificadas por el parámetro drives= para crear el LUN. Para especificar el tamaño mediante otras unidades, use uno de los siguientes sufijos reconocidos inmediatamente después del tamaño:
  • B: byte
  • KB: kilobyte
  • MB: megabyte
  • GB: gigabyte
  • TB: terabyte
  • PB: petabyte.
drives= Especifica el <drive_number> que usarán las unidades al crear un LUN. Se debe especificar el size o el parámetro <drive>. También se pueden usar juntos. Si no se especifica el parámetro size=, el LUN creado es el tamaño más grande posible permitido por todas las unidades especificadas. Los proveedores usan las unidades en el orden especificado cuando sea posible.
noerr Sólo para scripting. Cuando se detecta un error, Diskraid sigue procesando los comandos como si no hubiera ningún error.

flushcache

Borra la memoria caché en el controlador seleccionado actualmente.

Sintaxis

flushcache controller

help

Muestra una lista de los comandos Diskraid.

Sintaxis

help

importtarget

Recupera o establece el destino de importación actual del Servicio de instantáneas de volumen (VSS) que se establece para el subsistema seleccionado actualmente.

Syntax

importtarget subsystem [set target]
Parámetro
Parámetro Descripción
set target Si se especifica, establece el destino seleccionado actualmente en el destino de importación de VSS para el subsistema seleccionado actualmente. Si no se especifica, el comando recupera el destino de importación de VSS actual que se establece para el subsistema seleccionado actualmente.

initiator

Recupera información sobre el iniciador iSCSI local.

Sintaxis

initiator

invalidatecache

Invalida la memoria caché en el controlador seleccionado actualmente.

Sintaxis

invalidatecache controller

lbpolicy

Establece la directiva de equilibrio de carga en el LUN seleccionado actualmente.

Sintaxis

lbpolicy set lun type=<type> [paths=<path>-{primary | <weight>}[,<path>-{primary | <weight>}[,…]]]
lbpolicy set lun paths=<path>-{primary | <weight>}[,<path>-{primary | <weight>}[,…]]
Parámetros
Parámetro Descripción
type Especifica la directiva de equilibrio de carga. Si no se especifica el tipo, se debe especificar el parámetro path. El elemento Type puede ser uno de los siguientes:
  • FAILOVER: usa una ruta de acceso principal con otras rutas de acceso de copia de seguridad.
  • ROUNDROBIN: usa todas las rutas de acceso de forma round robin, que intenta cada ruta secuencialmente.
  • SUBSETROUNDROBIN: usa todas las rutas de acceso principales de forma round robin; las rutas de acceso de copia de seguridad solo se usan si se produce un error en todas las rutas de acceso principales.
  • DYNLQD: usa la ruta de acceso con el menor número de solicitudes activas.
  • WEIGHTED: usa la ruta de acceso con el menor peso (cada ruta de acceso debe tener asignado un peso).
  • LEASTBLOCKS: usa la ruta de acceso con los bloques mínimos.
  • VENDORSPECIFIC: usa una directiva específica del proveedor.
path Especifica si una ruta de acceso es principal o tiene un determinado <weight>. Las rutas de acceso no especificadas se establecen implícitamente como copia de seguridad. Las rutas de acceso enumeradas deben ser una de las rutas de acceso de LUN seleccionadas actualmente.

list

Muestra una lista de objetos del tipo especificado.

Sintaxis

list {hbaports | iadapters | iportals | providers | subsystems | controllers | ports | drives | LUNs | tportals | targets | tpgroups}
Parámetros
Parámetro Descripción
hbaports Muestra información de resumen sobre todos los puertos HBA conocidos para VDS. El puerto HBA seleccionado actualmente está marcado por un asterisco (*).
iadapters Muestra información de resumen sobre todos los adaptadores de iniciador iSCSI conocidos por VDS. El adaptador del iniciador seleccionado actualmente está marcado por un asterisco (*).
iportals Muestra información de resumen sobre todos los portales del iniciador iSCSI en el adaptador del iniciador seleccionado actualmente. El portal del iniciador seleccionado actualmente está marcado por un asterisco (*).
providers Muestra información de resumen sobre cada proveedor conocido por VDS. El proveedor seleccionado actualmente está marcado por un asterisco (*).
subsistemas Muestra información de resumen sobre cada subsistema del sistema. El subsistema seleccionado actualmente está marcado por un asterisco (*).
controllers Muestra información de resumen sobre cada controlador del subsistema seleccionado actualmente. El controlador seleccionado actualmente está marcado por un asterisco (*).
ports Muestra información de resumen sobre cada puerto de controlador en el controlador seleccionado actualmente. El puerto seleccionado actualmente está marcado por un asterisco (*).
unidades Muestra información de resumen sobre cada unidad del subsistema seleccionado actualmente. La unidad seleccionada actualmente está marcada por un asterisco (*).
luns Muestra información de resumen sobre cada LUN en el subsistema seleccionado actualmente. El LUN seleccionado actualmente está marcado por un asterisco (*).
tportals Muestra información de resumen sobre todos los portales de destino iSCSI del subsistema seleccionado actualmente. El portal de destino seleccionado actualmente está marcado por un asterisco (*).
destinos Muestra información de resumen sobre todos los destinos iSCSI del subsistema seleccionado actualmente. El destino seleccionado actualmente está marcado por un asterisco (*).
tpgroups Muestra información de resumen sobre todos los grupos del portal de destino iSCSI en el destino seleccionado actualmente. El grupo del portal seleccionado actualmente está marcado por un asterisco (*).

login

Registra el adaptador del iniciador iSCSI especificado en el destino iSCSI seleccionado actualmente.

Sintaxis

login target iadapter=<iadapter> [type={manual | persistent | boot}] [chap={none | oneway | mutual}] [iportal=<iportal>] [tportal=<tportal>] [<flag> [<flag> […]]]
Parámetros
Parámetro Descripción
type Especifica el tipo de inicio de sesión que se va a realizar: manual o persistent. Si no se especifica, se realizará un inicio de sesión manual.
manual Inicie sesión manualmente. También hay una opción boot que está pensada para el desarrollo futuro y no se usa actualmente.
persistent Use automáticamente el mismo inicio de sesión cuando se reinicie el equipo.
chap Especifica el tipo de autenticación CHAP que se va a usar: none, oneway CHAP o mutual CHAP; si no se especifica, no se usará ninguna autenticación.
tportal Especifica un portal de destino opcional en el subsistema seleccionado actualmente que se va a usar para el inicio de sesión.
iportal Especifica un portal de iniciador opcional en el adaptador del iniciador especificado que se va a usar para el inicio de sesión.
<flag> Identificado por acrónimos de tres letras:
  • IPS: Requerir IPsec
  • EMP: Habilitar varias rutas
  • EHD: Habilitar resumen de encabezado
  • EDD: Habilitar resumen de datos

logout

Registra el adaptador del iniciador iSCSI especificado fuera del destino iSCSI seleccionado actualmente.

Sintaxis

logout target iadapter= <iadapter>
Parámetros
Parámetro Descripción
iadapter Especifica el adaptador del iniciador con una sesión de inicio de sesión desde la que cerrar sesión.

mantenimiento

Realiza operaciones de mantenimiento en el objeto seleccionado actualmente del tipo especificado.

Sintaxis

maintenance <object operation> [count=<iteration>]
Parámetros
Parámetro Descripción
<object> Especifica el tipo de objeto en el que se va a realizar la operación. El tipo object puede ser un subsystem, controller, port, drive o LUN.
<operation> Especifica la operación de mantenimiento que se va a realizar. El tipo operation puede ser spinup, spindown, blink, beep o ping. Se debe especificar una operation.
count= Especifica el número de veces que se repite la operación. Se usa normalmente con blink, beep o ping.

name

Establece el nombre descriptivo del subsistema, LUN o destino iSCSI actualmente seleccionado en el nombre especificado.

Syntax

name {subsystem | lun | target} [<name>]
Parámetro
Parámetro Descripción
<name> Especifica un nombre para el subsistema, LUN o destino. El nombre debe tener menos de 64 caracteres de longitud. Si no se proporciona ningún nombre, se elimina el nombre existente, si existe.

sin conexión

Establece el estado del objeto seleccionado actualmente del tipo especificado en offline.

Syntax

offline <object>
Parámetro
Parámetro Descripción
<object> Especifica el tipo de objeto en el que se va a realizar esta operación. El tipo puede ser: subsystem, controller, drive, LUN o tportal.

online (en línea)

Establece el estado del objeto seleccionado del tipo especificado en línea. Si el objeto es hbaport, cambia el estado de las rutas de acceso al puerto HBA seleccionado actualmente en online.

Syntax

online <object>
Parámetro
Parámetro Descripción
<object> Especifica el tipo de objeto en el que se va a realizar esta operación. El tipo puede ser: hbaport, subsystem, controller, drive, LUN o tportal.

recover

Realiza las operaciones necesarias, como la resincronización o la moderación activa, para reparar el LUN tolerante a errores seleccionado actualmente. Por ejemplo, RECOVER puede hacer que una reserva activa esté enlazada a un conjunto RAID que tenga un disco con errores u otra reasignación de extensión de disco.

Sintaxis

recover <lun>

reenumerate

Vuelve a enumerar los objetos del tipo especificado. Si usa el comando extend LUN, debe usar el comando refresh para actualizar el tamaño del disco antes de usar el comando reenumerate.

Sintaxis

reenumerate {subsystems | drives}
Parámetros
Parámetro Descripción
subsistemas Consulta al proveedor para detectar los nuevos subsistemas que se agregaron en el proveedor seleccionado actualmente.
unidades Consulta los buses de E/S internos para detectar las nuevas unidades que se agregaron en el subsistema seleccionado actualmente.

actualizar

Actualiza los datos internos del proveedor seleccionado actualmente.

Sintaxis

refresh provider

rem

Se usa para comentar scripts.

Sintaxis

Rem <comment>

remove

Quita el portal de destino iSCSI especificado del grupo de portales de destino seleccionado actualmente.

Syntax

remove tpgroup tportal=<tportal> [noerr]
Parámetro
Parámetro Descripción
tpgroup tportal=<tportal> Especifica el portal de destino iSCSI que se va a quitar.
noerr Sólo para scripting. Cuando se detecta un error, Diskraid sigue procesando los comandos como si no hubiera ningún error.

replace

Reemplaza la unidad especificada por la unidad seleccionada actualmente. Es posible que la unidad especificada no sea la unidad seleccionada actualmente.

Syntax

replace drive=<drive_number>
Parámetro
Parámetro Descripción
drive= Especifica el <drive_number> para que reemplace la unidad.

reset

Restablece el controlador o puerto seleccionado actualmente.

Sintaxis

reset {controller | port}
Parámetros
Parámetro Descripción
controlador Restablece el controlador.
port Restablece el puerto.

select

Muestra o cambia el objeto seleccionado actualmente.

Sintaxis

select {hbaport | iadapter | iportal | provider | subsystem | controller | port | drive | lun | tportal | target | tpgroup } [<n>]
Parámetros
Parámetro Descripción
object Especifica el tipo de objeto que se va a seleccionar, incluido: provider, subsystem, controller, drive o LUN.
hbaport [<n>] Establece el foco en el puerto HBA local especificado. Si no se especifica ningún puerto HBA, el comando muestra el puerto HBA seleccionado actualmente (si existe). Si se especifica un índice de puerto HBA no válido, no se pone ningún puerto HBA en el foco. Al seleccionar un puerto HBA, se anula la selección de los adaptadores de iniciador y los portales del iniciador seleccionados.
iadapter [<n>] Establece el foco en el adaptador del iniciador iSCSI local especificado. Si no se especifica ningún adaptador de iniciador, el comando muestra el adaptador del iniciador seleccionado (si existe). Si se especifica un índice de adaptador de iniciador no válido, no se produce ningún adaptador de iniciador en foco. Al seleccionar un adaptador de iniciador, se anula la selección de los puertos HBA y los portales del iniciador seleccionados.
iportal [<n>] Establece el foco en el portal del iniciador iSCSI local especificado dentro del adaptador del iniciador iSCSI seleccionado. Si no se especifica ningún portal del iniciador, el comando muestra el portal del iniciador seleccionado actualmente (si existe). Especificar un índice del portal del iniciador no válido no da como resultado ningún portal de iniciador seleccionado.
provider [<n>] Establece el foco del proveedor especificado. Si no se especifica ningún proveedor, el comando muestra el proveedor seleccionado actualmente (si existe). Si se especifica un índice de proveedor no válido, no se pone el foco en ningún proveedor.
subsystem [<n>] Establece el foco del subsistema especificado. Si no se especifica ningún subsistema, el comando muestra el subsistema con foco (si existe). Si se especifica un índice de subsistema no válido, no se pone el foco en ningún subsistema. Al seleccionar un subsistema, se selecciona implícitamente su proveedor asociado.
controller [<n>] Establece el foco en el controlador especificado dentro del subsistema seleccionado actualmente. Si no se especifica ningún controlador, el comando muestra el controlador seleccionado actualmente (si existe). Si se especifica un índice de controlador no válido, no se pone el foco en ningún controlador. Al seleccionar un controlador, se anula la selección de los puertos de controlador seleccionados, las unidades, los LUN, los portales de destino, los destinos y los grupos del portal de destino.
port [<n>] Establece el foco en el puerto del controlador especificado dentro del controlador seleccionado actualmente. Si no se especifica ningún puerto, el comando muestra el puerto seleccionado actualmente (si existe). Si se especifica un índice de puerto no válido, no se selecciona ningún puerto.
drive [<n>] Establece el foco en la unidad especificada, o el eje físico, dentro del subsistema seleccionado actualmente. Si no se especifica ninguna unidad, el comando muestra la unidad seleccionada actualmente (si existe). Especificar un índice de unidad no válido conlleva que no se ponga el foco en ninguna unidad. Al seleccionar una unidad, se anula la selección de los controladores seleccionados, los puertos de controlador, los LUN, los portales de destino, los destinos y los grupos del portal de destino.
lun [<n>] Establece el foco en el LUN especificado dentro del subsistema seleccionado actualmente. Si no se especifica ningún LUN, el comando muestra el LUN seleccionado actualmente (si existe). Si no se especifica un índice LUN válido, no se selecciona ningún LUN. Al seleccionar un LUN, se anula la selección de los controladores seleccionados, los puertos del controlador, las unidades, los portales de destino, los destinos y los grupos del portal de destino.
tportal [<n>] Establece el foco en el portal de destino iSCSI especificado dentro del subsistema seleccionado actualmente. Si no se especifica ningún portal de destino, el comando muestra el portal de destino seleccionado actualmente (si existe). Si no se especifica un índice de portal de destino válido, no se selecciona ningún portal de destino. Al seleccionar un portal de destino, se anula la selección de los controladores, los puertos del controlador, las unidades, los LUN, los destinos y los grupos del portal de destino.
target [<n>] Establece el foco en el destino iSCSI especificado dentro del subsistema seleccionado actualmente. Si no se especifica ningún destino, el comando muestra el destino seleccionado actualmente (si existe). Si se especifica un índice de destino no válido, no se selecciona ningún destino. Al seleccionar un destino, se anula la selección de los controladores, los puertos del controlador, las unidades, los LUN, los portales de destino y los grupos del portal de destino.
tpgroup [<n>] Establece el foco en el grupo de portal de destino iSCSI especificado dentro del destino iSCSI seleccionado actualmente. Si no se especifica ningún grupo de portal de destino, el comando muestra el grupo de portal de destino seleccionado actualmente (si existe). Especificar un índice de grupo de portal de destino no válido supone que no ponga el foco en el grupo de portal.
[<n>] Especifica el objeto <object number> que se va a seleccionar. Si el <object number> especificado no es válido, se borran las selecciones existentes para los objetos del tipo especificado. Si no se especifica ningún <object number>, se muestra el objeto actual.

setflag

Establece la unidad seleccionada actualmente como reserva activa. Las reservas activas no se pueden usar para las operaciones de enlace de LUN normales. Están reservadas solo para el control de errores. La unidad no debe estar enlazada actualmente a ningún LUN existente.

Sintaxis

setflag drive hotspare={true | false}
Parámetros
Parámetro Descripción
true Selecciona la unidad seleccionada actualmente como reserva activa.
false Anula la selección de la unidad seleccionada actualmente como reserva activa.

shrink

Reduce el tamaño del LUN seleccionado.

Sintaxis

shrink lun size=<n> [noerr]
Parámetros
Parámetro Descripción
tamaño Especifica el espacio en megabytes (MB) que se desea reducir en el volumen. Para especificar el tamaño mediante otras unidades, use uno de los siguientes sufijos reconocidos inmediatamente después del tamaño:
  • B: byte
  • KB: kilobyte
  • MB: megabyte
  • GB: gigabyte
  • TB: terabyte
  • PB: petabyte.
noerr Sólo para scripting. Cuando se detecta un error, Diskraid sigue procesando los comandos como si no hubiera ningún error.

espera

Cambia el estado de las rutas de acceso al puerto del adaptador de bus host (HBA) seleccionado actualmente a STANDBY.

Sintaxis

standby hbaport
Parámetros
Parámetro Descripción
hbaport Cambia el estado de las rutas de acceso al puerto del adaptador de bus host (HBA) seleccionado actualmente a STANDBY.

unmask

Hace que los LUN seleccionados actualmente estén accesibles desde los hosts especificados.

Sintaxis

unmask lun {all | none | [add] wwn=<hexadecimal_number> [;<hexadecimal_number> [;…]] | [add] initiator=<initiator>[;<initiator>[;…]]} [uninstall]
Parámetros
Parámetro Descripción
all Especifica que el LUN debe ser accesible desde todos los hosts. Sin embargo, no se puede desenmascarar el LUN en todos los destinos de un subsistema iSCSI.

Debe cerrar sesión en el destino antes de ejecutar el comando unmask lun all.
ninguno Especifica que el LUN no debe ser accesible para ningún host.

Debe cerrar sesión en el destino antes de ejecutar el comando unmask lun none.
add Especifica que los hosts especificados deben agregarse a la lista existente de hosts desde los que se puede acceder a este LUN. Si no se especifica este parámetro, la lista de hosts suministrados reemplaza la lista existente de hosts desde los que se puede acceder a este LUN.
wwn= Especifica una lista de números hexadecimales que representan nombres de todo el mundo a partir de los cuales se debe hacer accesible el LUN o los hosts. Para enmascarar o desenmascarar a un conjunto específico de hosts en un subsistema de canal de fibra, puede escribir una lista separada por punto y coma de WWN para los puertos de las máquinas host de interés.
initiator= Especifica una lista de iniciadores iSCSI a los que se debe hacer accesible el LUN seleccionado actualmente. Para enmascarar o desenmascarar a un conjunto específico de hosts en un subsistema iSCSI, puede escribir una lista separada por punto y coma de nombres de iniciadores iSCSI para los iniciadores en los equipos host de interés.
uninstall Si se especifica, desinstala el disco asociado al LUN en el sistema local antes de enmascarar el LUN.

Scripting Diskraid

Se puede crear un script para Diskraid en cualquier equipo que ejecute una versión compatible de Windows Server, con un proveedor de hardware de VDS asociado. Para invocar un script Diskraid, escriba en el símbolo del sistema:

diskraid /s <script.txt>

De forma predeterminada, Diskraid detiene el procesamiento de comandos y devuelve un código de error si hay un problema en el script. Para seguir ejecutando el script y omitir los errores, incluya el parámetro noerr en el comando. Esto permite prácticas útiles como el uso de un único script para eliminar todos los LUN de un subsistema, independientemente del número total de LUN. No todos los comandos admiten el parámetro noerr. Los errores siempre se devuelven en los errores de sintaxis de comandos, independientemente de si incluyó el parámetro noerr.

Códigos de error diskraid

Código de error Descripción del error
0 No se ha producido ningún error. El script completo se ejecutó sin errores.
1 Excepción grave.
2 Los argumentos especificados en una línea de comandos Diskraid eran incorrectos.
3 DiskPart no ha podido abrir el script o el archivo de salida especificados.
4 Uno de los servicios que utiliza Diskraid ha devuelto un error.
5 Error de sintaxis de comando. El script produjo un error porque un objeto se seleccionó incorrectamente o no era válido para su uso con dicho comando.

Ejemplo

Para ver el estado del subsistema 0 en el equipo, escriba:

diskraid

Pulse ENTRAR y se mostrará una salida similar a la siguiente:

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

Para seleccionar el subsistema 0, escriba lo siguiente en el símbolo del sistema Diskraid:

select subsystem 0

Pulse ENTRAR y se mostrará una salida similar a la siguiente:

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

Para salir de Diskraid, escriba lo siguiente en el símbolo del sistema de Diskraid:

exit