Diskraid

O Diskraid é uma ferramenta de linha de comando que permite configurar e gerenciar subsistemas de armazenamento RAID (Redundant Array of Independent (or Incheap) Disks.

O RAID normalmente é usado em servidores para padronizar e categorizar sistemas de disco tolerantes a falhas. Os níveis RAID fornecem várias combinações de desempenho, confiabilidade e custo. Alguns servidores fornecem três dos níveis RAID: Nível 0 (distribuição), Nível 1 (espelhamento) e Nível 5 (distribuição com paridade).

Um subsistema RAID de hardware distingue unidades de armazenamento fisicamente endereçáveis umas das outras usando um LUN (Número de Unidade Lógica). Um objeto LUN deve ter pelo menos um plexe e pode ter qualquer número de plexes adicionais. Cada plex contém uma cópia dos dados no objeto LUN. Plexes podem ser adicionados e removidos de um objeto LUN.

A maioria dos comandos diskraid opera em uma porta HBA (adaptador de barramento de host) específica, adaptador de iniciador, portal do iniciador, provedor, subsistema, controlador, porta, unidade, LUN, portal de destino, destino ou grupo de portal de destino. Use o comando SELECT para selecionar um objeto. Diz-se que o objeto selecionado tem foco. O foco simplifica tarefas comuns de configuração, como a criação de vários LUNs no mesmo subsistema.

Note

A ferramenta de linha de comando Diskraid funciona apenas com subsistemas de armazenamento que dão suporte ao VDS (Virtual Disk Service).

Diskraid commands

Os comandos a seguir estão disponíveis na ferramenta Diskraid.

add

Adiciona um LUN existente ao LUN selecionado no momento ou adiciona um portal de destino iSCSI ao grupo de portal de destino iSCSI selecionado no momento.

Syntax

add plex lun=n [noerr]
add tpgroup tportal=n [noerr]
Parameters
Parameter Description
plex lun =<n> Especifica o número LUN a ser adicionado como um plex ao LUN selecionado no momento. CUIDADO: todos os dados sobre o LUN que estão sendo adicionados como um plex serão excluídos.
tpgroup tportal=<n> Especifica o número do portal de destino iSCSI a ser adicionado ao grupo de portal de destino iSCSI selecionado no momento.
noerr Somente para scripts. Quando um erro é encontrado, Diskraid continua a processar comandos como se o erro não tivesse ocorrido.

associate

Define a lista especificada de portas do controlador como ativas para o LUN selecionado no momento (outras portas do controlador são inativas) ou adiciona as portas do controlador especificadas à lista de portas de controlador ativo existentes para o LUN selecionado no momento ou associa o destino iSCSI especificado para o LUN selecionado no momento.

Syntax

associate controllers [add] <n>[,<n> [,…]]
associate ports [add] <n-m>[,<n-m>[,…]]
associate targets [add] <n>[,<n> [,…]]
Parameters
Parameter Description
controlador Adiciona ou substitui a lista de controladores associados ao LUN selecionado no momento. Use somente com provedores VDS 1.0.
ports Adiciona ou substitui a lista de portas do controlador associadas ao LUN selecionado no momento. Use somente com provedores VDS 1.1.
targets Adiciona ou substitui a lista de destinos iSCSI associados ao LUN selecionado no momento. Use somente com provedores VDS 1.1.
add Se estiver usando provedores VDS 1.0: Adiciona os controladores especificados à lista existente de controladores associados ao LUN. Se esse parâmetro não for especificado, a lista de controladores substituirá a lista existente de controladores associados a esse LUN.

Se estiver usando provedores VDS 1.1: Adiciona as portas do controlador especificadas à lista existente de portas do controlador associadas ao LUN. Se esse parâmetro não for especificado, a lista de portas do controlador substituirá a lista existente de portas do controlador associadas a esse LUN.

<n>[,<n> [, ...]] Use com o parâmetro controllers ou targets . Especifica os números dos controladores ou destinos iSCSI a serem definidos como ativos ou associados.
<n-m>[,<n-m>[,…]] Use com o parâmetro ports . Especifica as portas do controlador a serem definidas como ativas usando um par de número de controlador (n) e número de porta (m).

Example

Para associar e adicionar portas a um LUN que usa um provedor 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

Define ou limpa sinalizadores que dão dicas aos provedores sobre como configurar um LUN. Usada sem parâmetros, a operação de automagia exibe uma lista de sinalizadores.

Syntax

automagic {set | clear | apply} all <flag=value> [<flag=value> [...]]
Parameters
Parameter Description
set Define os sinalizadores especificados para os valores especificados.
desmarcar Limpa os sinalizadores especificados. A palavra-chave all limpa todos os sinalizadores de automagic.
aplicar Aplica os sinalizadores atuais ao LUN selecionado.
<flag> Os sinalizadores são identificados por acrônimos de três letras, incluindo:
  • FCR - Recuperação rápida de falhas necessária
  • FTL - Tolerante a falhas
  • MSR - Principalmente leituras
  • MXD - Máximo de unidades
  • MXS - Tamanho máximo esperado
  • ORA - Alinhamento de leitura ideal
  • ORS - Tamanho de leitura ideal
  • OSR - Otimizar para leituras sequenciais
  • OSW - Otimizar para gravações sequenciais
  • OWA - Alinhamento de gravação ideal
  • OWS - Tamanho ideal de gravação
  • RBP - Prioridade de recompilação
  • RBV - Verificação de Leitura Habilitada
  • RMP - Remapeamento Habilitado
  • STS - Tamanho da tira
  • WTC - Cache de Write-Through habilitado
  • YNK - Removível

interromper

Remove o plex do LUN selecionado no momento. O plexe e os dados contidos não são retidos e as extensões da unidade podem ser recuperadas.

Caution

Primeiro, você deve selecionar um LUN espelhado antes de usar esse comando. Todos os dados no plex serão excluídos. Não há garantia de que todos os dados contidos no LUN original sejam consistentes.

Syntax

break plex=<plex_number> [noerr]
Parameters
Parameter Description
plex Especifica o número do plex a ser removido. O plexe e os dados contidos não serão retidos e os recursos usados por esse plex serão recuperados. Não há garantia de que os dados contidos no LUN sejam consistentes. Se você quiser manter esse plex, use o VSS (Serviço de Cópia de Sombra de Volume).
noerr Somente para scripts. Quando um erro é encontrado, Diskraid continua a processar comandos como se o erro não tivesse ocorrido.

chap

Define o segredo compartilhado CHAP (Challenge Handshake Authentication Protocol) para que os iniciadores iSCSI e os destinos iSCSI possam se comunicar uns com os outros.

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 Define o segredo compartilhado no serviço iniciador iSCSI local usado para autenticação CHAP mútua quando o iniciador autentica o destino.
initiator remember Comunica o segredo CHAP de um destino iSCSI para o serviço de iniciador iSCSI local para que o serviço iniciador possa usar o segredo para se autenticar no destino durante a autenticação chap.
target set Define o segredo compartilhado no destino iSCSI atualmente selecionado usado para autenticação CHAP quando o destino autentica o iniciador.
target remember Comunica o segredo CHAP de um iniciador iSCSI para o destino iSCSI em foco atual para que o destino possa usar o segredo para se autenticar no iniciador durante a autenticação chap mútua.
segredo Especifica o segredo a ser usado. Se estiver vazio, o segredo será limpo.
destino Especifica um destino no subsistema selecionado no momento para associar ao segredo. Isso é opcional ao definir um segredo no iniciador e deixá-lo de fora indica que o segredo será usado para todos os destinos que ainda não têm um segredo associado.
initiatorname Especifica um nome iSCSI do iniciador a ser associado ao segredo. Isso é opcional ao definir um segredo em um destino e deixá-lo de fora indica que o segredo será usado para todos os iniciadores que ainda não têm um segredo associado.

criar

Cria um novo destino LUN ou iSCSI no subsistema selecionado no momento ou cria um grupo de portal de destino no destino selecionado no momento. Você pode visualizar a vinculação real usando o 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 Cria um LUN simples.
stripe Cria um LUN distribuído.
raid Cria um LUN distribuído com paridade.
mirror Cria um LUN espelhado.
automagic Cria um LUN usando as dicas de automagia atualmente em vigor. Para obter mais informações, consulte o subcomando automagic neste artigo.
size= Especifica o tamanho total do LUN em megabytes. O parâmetro size= ou drives= deve ser especificado. Eles também podem ser usados juntos. Se o parâmetro size= não for especificado, o LUN criado terá o maior tamanho possível permitido por todas as unidades especificadas.

Um provedor normalmente cria um LUN pelo menos tão grande quanto o tamanho solicitado, mas o provedor pode ter que arredondar para o próximo maior tamanho em alguns casos. Por exemplo, se o tamanho for especificado como 0,99 GB e o provedor puder alocar apenas extensões de disco GB, o LUN resultante será de 1 GB. Para especificar o tamanho usando outras unidades, use um dos seguintes sufixos reconhecidos imediatamente após o tamanho:

  • B - byte
  • KB - kilobyte
  • MB - megabyte
  • GB - gigabyte
  • TB - terabyte
  • PB - petabyte.
drives= Especifica o drive_number das unidades a serem usadas para criar um LUN. O parâmetro size= ou drives= deve ser especificado. Eles também podem ser usados juntos. Se o parâmetro size= não for especificado, o LUN criado terá o maior tamanho possível permitido por todas as unidades especificadas. Se o parâmetro size= for especificado, os provedores selecionarão unidades na lista de unidades especificadas para criar o LUN. Os provedores tentarão usar as unidades na ordem especificada quando possível.
stripesize= Especifica o tamanho em megabytes para um LUN de distribuição ou raid . O stripesize não pode ser alterado após a criação do LUN. Para especificar o tamanho usando outras unidades, use um dos seguintes sufixos reconhecidos imediatamente após o tamanho:
  • B - byte
  • KB - kilobyte
  • MB - megabyte
  • GB - gigabyte
  • TB - terabyte
  • PB - petabyte.
destino Cria um novo destino iSCSI no subsistema selecionado no momento.
name Fornece o nome amigável para o destino.
iscsiname Fornece o nome iSCSI para o destino e pode ser omitido para que o provedor gere um nome.
tpgroup Cria um novo grupo de portal de destino iSCSI no destino selecionado no momento.
noerr Somente para scripts. Quando um erro é encontrado, Diskraid continua a processar comandos como se o erro não tivesse ocorrido.

excluir

Exclui o lun selecionado no momento, o destino iSCSI (desde que não haja nenhum LUNs associado ao destino iSCSI) ou o grupo de portal de destino iSCSI.

Syntax

delete lun [uninstall] [noerr]
delete target [noerr]
delete tpgroup [noerr]
Parameters
Parameter Description
lun Exclui o LUN selecionado no momento e todos os dados nele.
desinstalar Especifica que o disco no sistema local associado ao LUN será limpo antes que o LUN seja excluído.
destino Exclui o destino iSCSI selecionado no momento se nenhum LUNs estiver associado ao destino.
tpgroup Exclui o grupo de portal de destino iSCSI selecionado no momento.
noerr Somente para scripts. Quando um erro é encontrado, Diskraid continua a processar comandos como se o erro não tivesse ocorrido.

detail

Exibe informações detalhadas sobre o objeto atualmente selecionado do tipo especificado.

Syntax

detail {hbaport | iadapter | iportal | provider | subsystem | controller | port | drive | lun | tportal | target | tpgroup} [verbose]
Parameters
Parameter Description
hbaport Lista informações detalhadas sobre a porta HBA (adaptador de barramento de host) selecionada no momento.
iadapter Lista informações detalhadas sobre o adaptador do iniciador iSCSI selecionado no momento.
iportal Lista informações detalhadas sobre o portal do iniciador iSCSI selecionado no momento.
fornecedor Lista informações detalhadas sobre o provedor selecionado no momento.
subsistema Lista informações detalhadas sobre o subsistema selecionado no momento.
controlador Lista informações detalhadas sobre o controlador selecionado no momento.
porta Lista informações detalhadas sobre a porta do controlador selecionada no momento.
drive Lista informações detalhadas sobre a unidade selecionada no momento, incluindo os LUNs de ocupação.
lun Lista informações detalhadas sobre o LUN atualmente selecionado, incluindo as unidades contribuintes. A saída difere ligeiramente dependendo se o LUN faz parte de um subsistema Fibre Channel ou iSCSI. Se a lista Hosts Desmascarados contiver apenas um asterisco, isso significa que o LUN será desmascarado para todos os hosts.
tportal Lista informações detalhadas sobre o portal de destino iSCSI selecionado no momento.
destino Lista informações detalhadas sobre o destino iSCSI selecionado no momento.
tpgroup Lista informações detalhadas sobre o grupo de portal de destino iSCSI selecionado no momento.
detalhada Para uso somente com o parâmetro LUN. Lista informações adicionais, incluindo seus plexes.

dissociate

Define a lista especificada de portas do controlador como inativas para o LUN selecionado no momento (outras portas do controlador não são afetadas) ou desassocia a lista especificada de destinos iSCSI para o LUN selecionado no momento.

Syntax

dissociate controllers <n> [,<n> [,...]]
dissociate ports <n-m>[,<n-m>[,…]]
dissociate targets <n> [,<n> [,…]]
Parameter
Parameter Description
controllers Remove os controladores da lista de controladores associados ao LUN selecionado no momento. Use somente com provedores VDS 1.0.
ports Remove as portas do controlador da lista de portas do controlador associadas ao LUN selecionado no momento. Use somente com provedores VDS 1.1.
targets Remove destinos da lista de destinos iSCSI associados ao LUN selecionado no momento. Use somente com provedores VDS 1.1.
<n> [,<n> [,…]] Para uso com o parâmetro controllers ou targets . Especifica os números dos controladores ou destinos iSCSI a serem definidos como inativos ou dissociados.
<n-m>[,<n-m>[,…]] Para uso com o parâmetro ports . Especifica as portas do controlador a serem definidas como inativas usando um par de número de controlador (n) e número de 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)

encerrar

Exits Diskraid.

Syntax

exit

extend

Estende o LUN selecionado no momento adicionando setores ao final do LUN. Nem todos os provedores dão suporte à extensão de LUNs. Não estende nenhum volume ou sistemas de arquivos contidos no LUN. Depois de estender o LUN, você deve estender as estruturas em disco associadas usando o comando DiskPart extend.

Syntax

extend lun [size=<LUN_size>] [drives=<drive_number>, [<drive_number>, ...]] [noerr]
Parameters
Parameter Description
size Especifica o tamanho em megabytes para estender o LUN. O tamanho ou o <drive> parâmetro devem ser especificados. Eles também podem ser usados juntos. Se o parâmetro size= não for especificado, o LUN será estendido pelo maior tamanho possível permitido por todas as unidades especificadas. Se o parâmetro size= for especificado, os provedores selecionarão unidades na lista especificada pelo parâmetro drives= para criar o LUN. Para especificar o tamanho usando outras unidades, use um dos seguintes sufixos reconhecidos imediatamente após o tamanho:
  • B - byte
  • KB - kilobyte
  • MB - megabyte
  • GB - gigabyte
  • TB - terabyte
  • PB - petabyte.
drives= Especifica o <drive_number> para as unidades a serem usadas ao criar um LUN. O tamanho ou o <drive> parâmetro devem ser especificados. Eles também podem ser usados juntos. Se o parâmetro size= não for especificado, o LUN criado terá o maior tamanho possível permitido por todas as unidades especificadas. Os provedores usam as unidades na ordem especificada quando possível.
noerr Somente para scripts. Quando um erro é encontrado, Diskraid continua a processar comandos como se o erro não tivesse ocorrido.

flushcache

Limpa o cache no controlador selecionado no momento.

Syntax

flushcache controller

help

Exibe uma lista de todos os comandos diskraid.

Syntax

help

importtarget

Recupera ou define o destino de importação do VSS (Serviço de Cópia de Sombra de Volume) atual definido para o subsistema selecionado no momento.

Syntax

importtarget subsystem [set target]
Parameter
Parameter Description
set target Se especificado, define o destino atualmente selecionado como o destino de importação do VSS para o subsistema selecionado no momento. Se não for especificado, o comando recuperará o destino de importação do VSS atual definido para o subsistema selecionado no momento.

iniciador

Recupera informações sobre o iniciador iSCSI local.

Syntax

initiator

invalidatecache

Invalida o cache no controlador selecionado no momento.

Syntax

invalidatecache controller

lbpolicy

Define a política de balanceamento de carga no LUN selecionado no momento.

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
tipo Especifica a política de balanceamento de carga. Se o tipo não for especificado, o parâmetro path deverá ser especificado. Tipo pode ser um dos seguintes:
  • FAILOVER - Usa um caminho principal com outros caminhos sendo caminhos de backup.
  • ROUNDROBIN - Usa todos os caminhos no modo round-robin, que tenta cada caminho sequencialmente.
  • SUBSETROUNDROBIN - Usa todos os caminhos primários no modo round-robin; Os caminhos de backup serão usados somente se todos os caminhos primários falharem.
  • DYNLQD - Usa o caminho com o menor número de solicitações ativas.
  • WEIGHTED - Usa o caminho com o menor peso (cada caminho deve receber um peso).
  • LEASTBLOCKS - Usa o caminho com menos blocos.
  • VENDORSPECIFIC - Usa uma política específica do fornecedor.
caminho Especifica se um caminho é primário ou tem um .<weight> Todos os caminhos não especificados são definidos implicitamente como backup. Todos os caminhos listados devem ser um dos caminhos do LUN selecionado no momento.

list

Exibe uma lista de objetos do tipo especificado.

Syntax

list {hbaports | iadapters | iportals | providers | subsystems | controllers | ports | drives | LUNs | tportals | targets | tpgroups}
Parameters
Parameter Description
hbaports Lista informações resumidas sobre todas as portas HBA conhecidas pelo VDS. A porta HBA selecionada no momento é marcada por um asterisco (*).
iadapters Lista informações resumidas sobre todos os adaptadores do iniciador iSCSI conhecidos pelo VDS. O adaptador iniciador selecionado no momento é marcado por um asterisco (*).
iportals Lista informações resumidas sobre todos os portais do iniciador iSCSI no adaptador do iniciador selecionado no momento. O portal do iniciador selecionado no momento é marcado por um asterisco (*).
providers Lista informações resumidas sobre cada provedor conhecido pelo VDS. O provedor selecionado no momento é marcado por um asterisco (*).
subsystems Lista informações resumidas sobre cada subsistema no sistema. O subsistema selecionado no momento é marcado por um asterisco (*).
controllers Lista informações resumidas sobre cada controlador no subsistema selecionado no momento. O controlador selecionado no momento é marcado por um asterisco (*).
ports Lista informações resumidas sobre cada porta do controlador no controlador selecionado no momento. A porta selecionada no momento é marcada por um asterisco (*).
drives Lista informações resumidas sobre cada unidade no subsistema selecionado no momento. A unidade selecionada no momento é marcada por um asterisco (*).
luns Lista informações resumidas sobre cada LUN no subsistema selecionado no momento. O LUN selecionado no momento é marcado por um asterisco (*).
tportals Lista informações resumidas sobre todos os portais de destino iSCSI no subsistema selecionado no momento. O portal de destino selecionado no momento é marcado por um asterisco (*).
targets Lista informações resumidas sobre todos os destinos iSCSI no subsistema selecionado no momento. O destino selecionado no momento é marcado por um asterisco (*).
tpgroups Lista informações de resumo sobre todos os grupos de portal de destino iSCSI no destino selecionado no momento. O grupo de portal selecionado no momento é marcado por um asterisco (*).

login

Registra o adaptador do iniciador iSCSI especificado no destino iSCSI selecionado no momento.

Syntax

login target iadapter=<iadapter> [type={manual | persistent | boot}] [chap={none | oneway | mutual}] [iportal=<iportal>] [tportal=<tportal>] [<flag> [<flag> […]]]
Parameters
Parameter Description
tipo Especifica o tipo de login a ser executado: manual ou persistente. Se não for especificado, um logon manual será executado.
manual Login manually. Há também uma opção de inicialização destinada ao desenvolvimento futuro e não é usada no momento.
persistent Use automaticamente o mesmo logon quando o computador for reiniciado.
chap Especifica o tipo de autenticação CHAP a ser usada: nenhuma, CHAP unidirecional ou CHAP mútuo ; Se não for especificado, nenhuma autenticação será usada.
tportal Especifica um portal de destino opcional no subsistema atualmente selecionado a ser usado para o logon.
iportal Especifica um portal de iniciador opcional no adaptador iniciador especificado a ser usado para o logon.
<flag> Identificado por acrônimos de três letras:
  • IPS - Exigir IPsec
  • EMP - Ativar multicaminho
  • EHD - Habilitar resumo de cabeçalho
  • EDD - Ativar resumo de dados

logout

Registra o adaptador do iniciador iSCSI especificado fora do destino iSCSI selecionado no momento.

Syntax

logout target iadapter= <iadapter>
Parameters
Parameter Description
iadapter Especifica o adaptador iniciador com uma sessão de logon da qual fazer logoff.

manutenção

Executa operações de manutenção no objeto atualmente selecionado do tipo especificado.

Syntax

maintenance <object operation> [count=<iteration>]
Parameters
Parameter Description
<object> Especifica o tipo de objeto no qual executar a operação. O tipo de objeto pode ser um subsistema, controlador,porta, unidade ou LUN.
<operation> Especifica a operação de manutenção a ser executada. O tipo de operação pode ser spinup, spindown, blink, beep ou ping. Uma operação deve ser especificada.
count= Especifica o número de vezes para repetir a operação. Isso normalmente é usado com piscar, bipe ou ping.

name

Define o nome amigável do subsistema, LUN ou iSCSI atualmente selecionado como o nome especificado.

Syntax

name {subsystem | lun | target} [<name>]
Parameter
Parameter Description
<name> Especifica um nome para o subsistema, LUN ou destino. O nome deve ter menos de 64 caracteres de comprimento. Se nenhum nome for fornecido, o nome existente, se houver, será excluído.

offline

Define o estado do objeto selecionado no momento do tipo especificado como offline.

Syntax

offline <object>
Parameter
Parameter Description
<object> Especifica o tipo de objeto no qual executar essa operação. O tipo pode ser: subsistema, controlador, unidade, LUN, ou tportal.

online

Define o estado do objeto selecionado do tipo especificado como online. Se object for hbaport, altera o status dos caminhos para a porta HBA selecionada no momento para on-line.

Syntax

online <object>
Parameter
Parameter Description
<object> Especifica o tipo de objeto no qual executar essa operação. O tipo pode ser: hbaport, subsystem, controller, drive, LUN, ou tportal.

recover

Executa as operações necessárias, como ressincronização ou moderação frequente, para reparar o LUN tolerante a falhas selecionado no momento. Por exemplo, RECOVER pode fazer com que um sobressalente frequente seja associado a um conjunto RAID que tenha um disco com falha ou outra realocação de extensão de disco.

Syntax

recover <lun>

reenumerate

Reenumera objetos do tipo especificado. Se você usar o comando LUN de extensão, deverá usar o comando atualizar para atualizar o tamanho do disco antes de usar o comando reenumerar.

Syntax

reenumerate {subsystems | drives}
Parameters
Parameter Description
subsystems Consulta o provedor para descobrir quaisquer novos subsistemas que foram adicionados no provedor selecionado no momento.
drives Consulta os barramentos de E/S internos para descobrir as novas unidades que foram adicionadas no subsistema selecionado no momento.

atualizar

Atualiza dados internos para o provedor selecionado no momento.

Syntax

refresh provider

rem

Usado para comentar scripts.

Syntax

Rem <comment>

remover

Remove o portal de destino iSCSI especificado do grupo de portal de destino selecionado no momento.

Syntax

remove tpgroup tportal=<tportal> [noerr]
Parameter
Parameter Description
tpgroup tportal=<tportal> Especifica o portal de destino iSCSI a ser removido.
noerr Somente para scripts. Quando um erro é encontrado, Diskraid continua a processar comandos como se o erro não tivesse ocorrido.

substituir

Substitui a unidade especificada pela unidade selecionada no momento. A unidade especificada pode não ser a unidade selecionada no momento.

Syntax

replace drive=<drive_number>
Parameter
Parameter Description
drive= Especifica o <drive_number> para a unidade a ser substituída.

redefinir

Redefine o controlador ou a porta atualmente selecionado.

Syntax

reset {controller | port}
Parameters
Parameter Description
controlador Redefine o controlador.
porta Redefine a porta.

select

Exibe ou altera o objeto selecionado no momento.

Syntax

select {hbaport | iadapter | iportal | provider | subsystem | controller | port | drive | lun | tportal | target | tpgroup } [<n>]
Parameters
Parameter Description
objeto Especifica o tipo de objeto a ser selecionado, incluindo: provedor, subsistema, controlador, unidade ou LUN.
suporte [<n>] Define o foco para a porta HBA local especificada. Se nenhuma porta HBA for especificada, o comando exibirá a porta HBA selecionada no momento (se houver). Especificar um índice de porta HBA inválido resulta em nenhuma porta HBA em foco. A seleção de uma porta HBA desmarca todos os adaptadores e portais do iniciador selecionados.
iAdapter [<n>] Define o foco para o adaptador do iniciador iSCSI local especificado. Se nenhum adaptador de iniciador for especificado, o comando exibirá o adaptador do iniciador selecionado no momento (se houver). Especificar um índice de adaptador de iniciador inválido resulta em nenhum adaptador iniciador em foco. Selecionar um adaptador de iniciador desmarca todas as portas HBA selecionadas e portais do iniciador.
[<n>] do iportal Define o foco para o portal do iniciador iSCSI local especificado no adaptador do iniciador iSCSI selecionado. Se nenhum portal do iniciador for especificado, o comando exibirá o portal do iniciador selecionado no momento (se houver). Especificar um índice inválido do portal do iniciador resulta em nenhum portal de iniciador selecionado.
[<n>] do provedor Define o foco para o provedor especificado. Se nenhum provedor for especificado, o comando exibirá o provedor selecionado no momento (se houver). Especificar um índice de provedor inválido resulta em nenhum provedor em foco.
subsistema [<n>] Define o foco para o subsistema especificado. Se nenhum subsistema for especificado, o comando exibirá o subsistema com foco (se houver). Especificar um índice de subsistema inválido resulta em nenhum subsistema em foco. Selecionar um subsistema seleciona implicitamente seu provedor associado.
controlador [<n>] Define o foco para o controlador especificado dentro do subsistema selecionado no momento. Se nenhum controlador for especificado, o comando exibirá o controlador selecionado no momento (se houver). Especificar um índice de controlador inválido resulta em nenhum controlador em foco. A seleção de um controlador desmarca todas as portas, unidades, LUNs, portais de destino, destinos e grupos de portal de destino selecionados.
[<n>] de porta Define o foco para a porta do controlador especificada dentro do controlador selecionado no momento. Se nenhuma porta for especificada, o comando exibirá a porta selecionada no momento (se houver). Especificar um índice de porta inválido resulta em nenhuma porta selecionada.
[<n>] de unidade Define o foco para a unidade especificada, ou eixo físico, dentro do subsistema selecionado no momento. Se nenhuma unidade for especificada, o comando exibirá a unidade selecionada no momento (se houver). Especificar um índice de unidade inválido resulta em nenhuma unidade em foco. A seleção de uma unidade desmarca todos os controladores, portas do controlador, LUNs, portais de destino, destinos e grupos de portal de destino selecionados.
Lun [<n>] Define o foco para o LUN especificado dentro do subsistema selecionado no momento. Se nenhum LUN for especificado, o comando exibirá o LUN selecionado no momento (se houver). Especificar um índice LUN inválido resulta em nenhum LUN selecionado. A seleção de um LUN desmarca todos os controladores, portas do controlador, unidades, portais de destino, destinos e grupos de portal de destino selecionados.
[<n>] de portais Define o foco para o portal de destino iSCSI especificado no subsistema selecionado no momento. Se nenhum portal de destino for especificado, o comando exibirá o portal de destino selecionado no momento (se houver). Especificar um índice de portal de destino inválido resulta em nenhum portal de destino selecionado. A seleção de um portal de destino desmarca todos os controladores, portas do controlador, unidades, LUNs, destinos e grupos de portal de destino.
[<n>] de destino Define o foco para o destino iSCSI especificado dentro do subsistema selecionado no momento. Se nenhum destino for especificado, o comando exibirá o destino selecionado no momento (se houver). Especificar um índice de destino inválido resulta em nenhum destino selecionado. A seleção de um destino desmarca todos os controladores, portas do controlador, unidades, LUNs, portais de destino e grupos de portal de destino.
grupo de teleporte [<n>] Define o foco para o grupo de portal de destino iSCSI especificado dentro do destino iSCSI selecionado no momento. Se nenhum grupo de portal de destino for especificado, o comando exibirá o grupo de portal de destino selecionado no momento (se houver). Especificar um índice de grupo do portal de destino inválido resulta em nenhum grupo de portal de destino em foco.
[<n>] Especifica o <object number> a ser selecionado. Se o <object number> especificado não for válido, todas as seleções existentes para objetos do tipo especificado serão desmarcadas. Se nenhum <object number> for especificado, o objeto atual será exibido.

setflag

Define a unidade selecionada no momento como um sobressalente quente. As sobressalentes frequentes não podem ser usadas para operações de associação LUN comuns. Eles são reservados apenas para tratamento de falhas. A unidade não deve estar vinculada a nenhum LUN existente no momento.

Syntax

setflag drive hotspare={true | false}
Parameters
Parameter Description
true Seleciona a unidade selecionada no momento como um sobressalente quente.
false Desmarca a unidade selecionada no momento como um sobressalente quente.

shrink

Reduz o tamanho do LUN selecionado.

Syntax

shrink lun size=<n> [noerr]
Parameters
Parameter Description
size Especifica a quantidade de espaço desejada em megabytes (MB) para reduzir o tamanho do LUN. Para especificar o tamanho usando outras unidades, use um dos seguintes sufixos reconhecidos imediatamente após o tamanho:
  • B - byte
  • KB - kilobyte
  • MB - megabyte
  • GB - gigabyte
  • TB - terabyte
  • PB - petabyte.
noerr Somente para scripts. Quando um erro é encontrado, Diskraid continua a processar comandos como se o erro não tivesse ocorrido.

standby

Altera o status dos caminhos para a porta HBA (adaptador de barramento de host) selecionada no momento para STANDBY.

Syntax

standby hbaport
Parameters
Parameter Description
hbaport Altera o status dos caminhos para a porta HBA (adaptador de barramento de host) selecionada no momento para STANDBY.

unmask

Torna os LUNs selecionados no momento acessíveis dos hosts especificados.

Syntax

unmask lun {all | none | [add] wwn=<hexadecimal_number> [;<hexadecimal_number> [;…]] | [add] initiator=<initiator>[;<initiator>[;…]]} [uninstall]
Parameters
Parameter Description
all Especifica que o LUN deve ser acessível de todos os hosts. No entanto, você não pode desmascarar o LUN para todos os destinos em um subsistema iSCSI.

Você deve fazer logoff do destino antes de executar o comando unmask lun all.

none Especifica que o LUN não deve ser acessível a nenhum host.

Você deve fazer logoff do destino antes de executar o comando unmask lun none.

add Especifica que os hosts especificados devem ser adicionados à lista existente de hosts dos quais esse LUN está acessível. Se esse parâmetro não for especificado, a lista de hosts fornecidos substituirá a lista existente de hosts dos quais esse LUN está acessível.
wwn= Especifica uma lista de números hexadecimal que representam nomes de todo o mundo dos quais o LUN ou os hosts devem ser disponibilizados. Para mascarar/desmascarar um conjunto específico de hosts em um subsistema Fibre Channel, você pode digitar uma lista separada por ponto-e-vírgula de WWN para as portas nos computadores host de interesse.
initiator= Especifica uma lista de iniciadores iSCSI aos quais o LUN selecionado no momento deve ser acessível. Para mascarar/desmascarar um conjunto específico de hosts em um subsistema iSCSI, você pode digitar uma lista separada por ponto-e-vírgula de nomes de iniciador iSCSI para os iniciadores nos computadores host de interesse.
desinstalar Se especificado, desinstala o disco associado ao LUN no sistema local antes que o LUN seja mascarado.

Scripting Diskraid

O Diskraid pode ser roteado em qualquer computador executando uma versão com suporte do Windows Server, com um provedor de hardware do VDS associado. Para invocar um script Diskraid, no tipo de prompt de comando:

diskraid /s <script.txt>

Por padrão, o Diskraid interrompe o processamento de comandos e retorna um código de erro se houver um problema no script. Para continuar executando o script e ignorar erros, inclua o parâmetro noerr no comando. Isso permite que práticas úteis como usar um único script excluam todos os LUNs em um subsistema, independentemente do número total de LUNs. Nem todos os comandos suportam o parâmetro noerr . Os erros são sempre retornados em erros de sintaxe de comando, independentemente de você ter incluído o parâmetro noerr .

Códigos de erro diskraid

Error Code Error Description
0 Nenhum erro ocorreu. O script inteiro foi executado sem falha.
1 Ocorreu uma exceção fatal.
2 Os argumentos especificados em uma linha de comando Diskraid estavam incorretos.
3 O Diskraid não pôde abrir o script ou o arquivo de saída especificado.
4 Um dos serviços que o Diskraid usa retornou uma falha.
5 Ocorreu um erro de sintaxe de comando. O script falhou porque um objeto foi selecionado incorretamente ou era inválido para uso com esse comando.

Example

Para exibir o status do subsistema 0 no computador, digite:

diskraid

Pressione ENTER e a saída semelhante à seguinte é exibida:

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

Para selecionar o subsistema 0, digite o seguinte no prompt diskraid:

select subsystem 0

Pressione ENTER e a saída semelhante à seguinte é exibida:

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 sair do Diskraid, digite o seguinte no prompt do Diskraid:

exit