Partilhar via


Diskraid

Diskraid é uma ferramenta de linha de comando que permite configurar e gerenciar matrizes redundantes de subsistemas de armazenamento independentes (ou baratos) de discos (RAID).

RAID é normalmente usado em servidores para padronizar e categorizar sistemas de disco tolerantes a falhas. Os níveis de RAID fornecem várias combinações de desempenho, confiabilidade e custo. Alguns servidores fornecem três níveis de RAID: Nível 0 (striping), Nível 1 (espelhamento) e Nível 5 (striping 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 plex e pode ter qualquer número de plexes adicionais. Cada plex contém uma cópia dos dados no objeto LUN. Os plexes podem ser adicionados e removidos de um objeto LUN.

A maioria dos comandos Diskraid opera em uma porta específica do adaptador de barramento de host (HBA), adaptador do 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 Focus simplifica tarefas de configuração comuns, como a criação de vários LUNs no mesmo subsistema.

Observação

A ferramenta de linha de comando Diskraid funciona apenas com subsistemas de armazenamento que suportam VDS (Virtual Disk Service).

Comandos Diskraid

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

adicionar

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

Sintaxe

add plex lun=n [noerr]
add tpgroup tportal=n [noerr]
Parâmetros
Parâmetro Descrição
plex lun=<n> Especifica o número de LUN a ser adicionado como um plex ao LUN selecionado no momento. CUIDADO: Todos os dados no LUN que está sendo adicionado 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 Apenas para scripts. Quando um erro é encontrado, o Diskraid continua a processar comandos como se o erro não tivesse ocorrido.

associado

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

Sintaxe

associate controllers [add] <n>[,<n> [,…]]
associate ports [add] <n-m>[,<n-m>[,…]]
associate targets [add] <n>[,<n> [,…]]
Parâmetros
Parâmetro Descrição
controlador Adiciona ou substitui a lista de controladores associados ao LUN selecionado no momento. Use apenas com provedores VDS 1.0.
portos Adiciona ou substitui a lista de portas do controlador associadas ao LUN selecionado no momento. Use apenas com provedores VDS 1.1.
Objetivos Adiciona ou substitui a lista de destinos iSCSI associados ao LUN selecionado no momento. Use apenas com provedores VDS 1.1.
adicionar 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 de controlador especificadas à lista existente de portas de 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 os controladores de ou alvos parâmetro. Especifica os números dos controladores ou destinos iSCSI a serem definidos como ativos ou associados.
<n-m>[,<n-m>[,…]] Use com as portas parâmetro. 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).

Exemplo

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)

Automagia

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

Sintaxe

automagic {set | clear | apply} all <flag=value> [<flag=value> [...]]
Parâmetros
Parâmetro Descrição
conjunto/configuração Define os sinalizadores especificados para os valores especificados.
limpar Limpa os sinalizadores especificados. A palavra-chave all limpa todos os sinalizadores automagic.
candidatar-se Aplica os sinalizadores atuais ao LUN selecionado.
<flag> As bandeiras são identificadas por siglas de três letras, incluindo:
  • FCR - Recuperação rápida de falhas necessária
  • FTL - Tolerante a falhas
  • MSR - Leituras Maioritárias
  • MXD - Máximo de drives
  • 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 escrita ideal
  • OWS - Tamanho de gravação ideal
  • RBP - Prioridade de reconstrução
  • RBV - Read Back Verify Ativado
  • RMP - Remapear ativado
  • STS - Tamanho da tira
  • WTC - Cache de Write-Through ativado
  • YNK - Removível

pausa

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

Atenção

Você deve primeiro selecionar um LUN espelhado antes de usar esse comando. Todos os dados no plex serão excluídos. Não é garantido que todos os dados contidos no LUN original sejam consistentes.

Sintaxe

break plex=<plex_number> [noerr]
Parâmetros
Parâmetro Descrição
Plex Especifica o número do plex a ser removido. O plex e os dados nele contidos não serão retidos, e os recursos usados por este plex serão recuperados. Não é garantido que os dados contidos no LUN sejam consistentes. Se você quiser manter esse plexo, use o VSS (Serviço de Cópias de Sombra de Volume).
Noerr Apenas para scripts. Quando um erro é encontrado, o Diskraid continua a processar comandos como se o erro não tivesse ocorrido.

cap

Define o segredo compartilhado do CHAP (Challenge Handshake Authentication Protocol) para que os iniciadores iSCSI e os destinos iSCSI possam se comunicar entre si.

Sintaxe

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 Descrição
conjunto do iniciador Define o segredo compartilhado no serviço do iniciador iSCSI local usado para autenticação CHAP mútua quando o iniciador autentica o destino.
Lembram-se do iniciador Comunica o segredo CHAP de um destino iSCSI ao serviço do iniciador iSCSI local para que o serviço do iniciador possa usar o segredo para autenticar-se no destino durante a autenticação CHAP.
Conjunto de metas Define o segredo compartilhado no destino iSCSI atualmente selecionado usado para autenticação CHAP quando o destino autentica o iniciador.
alvo lembrar Comunica o segredo CHAP de um iniciador iSCSI ao destino iSCSI atual em foco para que o destino possa usar o segredo para autenticar-se no iniciador durante a autenticação CHAP mútua.
segredo Especifica o segredo a ser usado. Se estiver vazio, o segredo será apagado.
destino Especifica um destino no subsistema atualmente selecionado 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 alvos 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 alvo 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 de LUN ou iSCSI no subsistema selecionado no momento ou cria um grupo de portal de destino no destino selecionado no momento. Você pode exibir a associação real usando o comando lista Diskraid.

Sintaxe

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 Descrição
simples Cria um LUN simples.
risca Cria um LUN distribuído.
Incursão Cria um LUN distribuído com paridade.
espelho Cria um LUN espelhado.
Automagia Cria um LUN usando as dicas de automagic atualmente em vigor. Para obter mais informações, consulte o subcomando automagic neste artigo.
tamanho= Especifica o tamanho total do LUN em megabytes. O tamanho = ou o parâmetro drives= deve ser especificado. Eles também podem ser usados juntos. Se o parâmetro size= não for especificado, o LUN criado será 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 tamanho maior em alguns casos. Por exemplo, se o tamanho for especificado como .99 GB e o provedor só puder alocar 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.
unidades= Especifica o drive_number para as unidades a serem usadas para criar um LUN. O tamanho = ou o parâmetro drives= deve ser especificado. Eles também podem ser usados juntos. Se o parâmetro size= não for especificado, o LUN criado será 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 especificada para criar o LUN. Os provedores tentarão usar as unidades na ordem especificada quando possível.
tamanho da risca= Especifica o tamanho em megabytes de um de distribuição de ou raid LUN. 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.
nome Fornece o nome amigável para o alvo.
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 Apenas para scripts. Quando um erro é encontrado, o Diskraid continua a processar comandos como se o erro não tivesse ocorrido.

suprimir

Exclui o LUN, o destino iSCSI atualmente selecionado (desde que não haja LUNs associados ao destino iSCSI) ou o grupo de portal de destino iSCSI.

Sintaxe

delete lun [uninstall] [noerr]
delete target [noerr]
delete tpgroup [noerr]
Parâmetros
Parâmetro Descrição
LUN Exclui o LUN atualmente selecionado e todos os dados nele contidos.
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 LUN estiver associado ao destino.
tpgroup Exclui o grupo de portal de destino iSCSI selecionado no momento.
Noerr Apenas para scripts. Quando um erro é encontrado, o Diskraid continua a processar comandos como se o erro não tivesse ocorrido.

detalhe

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

Sintaxe

detail {hbaport | iadapter | iportal | provider | subsystem | controller | port | drive | lun | tportal | target | tpgroup} [verbose]
Parâmetros
Parâmetro Descrição
Hbaport Lista informações detalhadas sobre a porta do adaptador de barramento de host (HBA) atualmente selecionada.
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 atualmente selecionado.
controlador Lista informações detalhadas sobre o controlador selecionado no momento.
porto Lista informações detalhadas sobre a porta do controlador atualmente selecionada.
Conduzir Lista informações detalhadas sobre a unidade selecionada no momento, incluindo os LUNs ocupantes.
LUN Lista informações detalhadas sobre o LUN selecionado no momento, incluindo os drives contribuintes. A saída difere ligeiramente dependendo se o LUN faz parte de um subsistema Fibre Channel ou iSCSI. Se a lista de 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.
Verborrágico Para uso somente com o parâmetro LUN. Lista informações adicionais, incluindo seus plexes.

dissociar

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 dissocia a lista especificada de destinos iSCSI para o LUN selecionado no momento.

Sintaxe

dissociate controllers <n> [,<n> [,...]]
dissociate ports <n-m>[,<n-m>[,…]]
dissociate targets <n> [,<n> [,…]]
Parâmetro
Parâmetro Descrição
controladores Remove controladores da lista de controladores associados ao LUN selecionado no momento. Use apenas com provedores VDS 1.0.
portos Remove as portas do controlador da lista de portas do controlador associadas ao LUN selecionado no momento. Use apenas com provedores VDS 1.1.
Objetivos Remove destinos da lista de destinos iSCSI associados ao LUN selecionado no momento. Use apenas com provedores VDS 1.1.
<n> [,<n> [,…]] Para uso com os controladores ou alvos parâmetro. Especifica os números dos controladores ou destinos iSCSI a serem definidos como inativos ou dissociados.
<n-m>[,<n-m>[,…]] Para uso com as portas parâmetro. 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).

Exemplo

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)

sair

Sai do Diskraid.

Sintaxe

exit

estender

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

Sintaxe

extend lun [size=<LUN_size>] [drives=<drive_number>, [<drive_number>, ...]] [noerr]
Parâmetros
Parâmetro Descrição
tamanho Especifica o tamanho em megabytes para estender o LUN. O tamanho ou o parâmetro <drive> 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 todos os drives especificados. 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.
unidades= Especifica o <drive_number> para as unidades a serem usadas ao criar um LUN. O tamanho ou o parâmetro <drive> devem ser especificados. Eles também podem ser usados juntos. Se o parâmetro size= não for especificado, o LUN criado será o maior tamanho possível permitido por todas as unidades especificadas. Os provedores usam as unidades na ordem especificada quando possível.
Noerr Apenas para scripts. Quando um erro é encontrado, o Diskraid continua a processar comandos como se o erro não tivesse ocorrido.

FlushCache

Limpa o cache no controlador selecionado no momento.

Sintaxe

flushcache controller

Ajuda

Exibe uma lista de todos os comandos Diskraid.

Sintaxe

help

importtarget

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

Sintaxe

importtarget subsystem [set target]
Parâmetro
Parâmetro Descrição
definir meta Se especificado, define o destino atualmente selecionado como o destino de importação VSS para o subsistema selecionado no momento. Se não for especificado, o comando recuperará o destino de importação VSS atual definido para o subsistema selecionado no momento.

iniciador

Recupera informações sobre o iniciador iSCSI local.

Sintaxe

initiator

InvalidateCache

Invalida o cache no controlador selecionado no momento.

Sintaxe

invalidatecache controller

lbpolicy

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

Sintaxe

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 Descrição
tipo Especifica a política de balanceamento de carga. Se o tipo não for especificado, o caminho parâmetro deverá ser especificado. O tipo pode ser um dos seguintes:
  • FAILOVER - Usa um caminho primário com outros caminhos sendo caminhos de backup.
  • ROUNDROBIN - Usa todos os caminhos de forma round-robin, que tenta cada caminho sequencialmente.
  • SUBSETROUNDROBIN - Utiliza todos os caminhos primários de forma round-robin; Os caminhos de backup são usados somente se todos os caminhos primários falharem.
  • DYNLQD - Usa o caminho com o menor número de solicitações ativas.
  • PONDERADO - 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 é principal ou tem um <weight>específico. Todos os caminhos não especificados são implicitamente definidos como backup. Todos os caminhos listados devem ser um dos caminhos do LUN atualmente selecionados.

Lista

Exibe uma lista de objetos do tipo especificado.

Sintaxe

list {hbaports | iadapters | iportals | providers | subsystems | controllers | ports | drives | LUNs | tportals | targets | tpgroups}
Parâmetros
Parâmetro Descrição
HbaPorts Lista informações resumidas sobre todas as portas HBA conhecidas pelo VDS. A porta HBA selecionada atualmente é marcada por um asterisco (*).
iAdapters Lista informações resumidas sobre todos os adaptadores de iniciador iSCSI conhecidos pelo VDS. O adaptador iniciador atualmente selecionado está 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 atualmente selecionado está marcado por um asterisco (*).
fornecedores Lista informações resumidas sobre cada provedor conhecido pelo VDS. O fornecedor atualmente selecionado está marcado por um asterisco (*).
subsistemas Lista informações resumidas sobre cada subsistema no sistema. O subsistema atualmente selecionado está marcado por um asterisco (*).
controladores Lista informações resumidas sobre cada controlador no subsistema selecionado no momento. O controlador atualmente selecionado está marcado por um asterisco (*).
portos Lista informações resumidas sobre cada porta do controlador no controlador selecionado no momento. A porta atualmente selecionada está marcada por um asterisco (*).
acionamentos Lista informações resumidas sobre cada unidade no subsistema selecionado no momento. A unidade atualmente selecionada está marcada por um asterisco (*).
Lunos Lista informações resumidas sobre cada LUN no subsistema atualmente selecionado. O LUN selecionado atualmente é marcado por um asterisco (*).
portais Lista informações resumidas sobre todos os portais de destino iSCSI no subsistema selecionado no momento. O portal de destino atualmente selecionado está marcado por um asterisco (*).
Objetivos Lista informações resumidas sobre todos os destinos iSCSI no subsistema selecionado no momento. O alvo atualmente selecionado está marcado por um asterisco (*).
tpgroups Lista informações resumidas sobre todos os grupos de portal de destino iSCSI no destino selecionado no momento. O grupo de portal atualmente selecionado está marcado por um asterisco (*).

iniciar sessão

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

Sintaxe

login target iadapter=<iadapter> [type={manual | persistent | boot}] [chap={none | oneway | mutual}] [iportal=<iportal>] [tportal=<tportal>] [<flag> [<flag> […]]]
Parâmetros
Parâmetro Descrição
tipo Especifica o tipo de login a ser executado: manual ou persistente . Se não for especificado, um login manual será realizado.
Manual Faça login manualmente. Há também uma opção de de inicialização que se destina a desenvolvimento futuro e não é usada atualmente.
persistente Use automaticamente o mesmo login quando o computador for reiniciado.
cap Especifica o tipo de autenticação CHAP a ser usada: nenhuma, CHAP unidirecional ou CHAP de mútuo; Se não for especificado, nenhuma autenticação será usada.
tportal Especifica um portal de destino opcional no subsistema atualmente selecionado para usar no logon.
iPortal Especifica um portal do iniciador opcional no adaptador do iniciador especificado a ser usado para o logon.
<flag> Identificado por siglas de três letras:
  • IPS - Requer IPsec
  • EMP - Ativar multicaminho
  • EHD - Ativar resumo de cabeçalho
  • EDD - Ativar resumo de dados

sair

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

Sintaxe

logout target iadapter= <iadapter>
Parâmetros
Parâmetro Descrição
iAdapter Especifica o adaptador iniciador com uma sessão de login da qual fazer logout.

Manutenção

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

Sintaxe

maintenance <object operation> [count=<iteration>]
Parâmetros
Parâmetro Descrição
<object> Especifica o tipo de objeto no qual executar a operação. O objeto tipo pode ser um de subsistema, controlador, porta, de unidade ou LUN.
<operation> Especifica a operação de manutenção a ser executada. A operação tipo pode ser de spinup, spindown, piscar, bipe ou ping. Deve ser especificada uma de operação.
contagem= Especifica o número de vezes que a operação deve ser repetida. Isso geralmente é usado com piscar, bipeou ping.

nome

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

Sintaxe

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

fora de linha

Define o estado do objeto atualmente selecionado do tipo especificado como offline.

Sintaxe

offline <object>
Parâmetro
Parâmetro Descrição
<object> Especifica o tipo de objeto no qual executar essa operação. O tipo pode ser: subsistema, controlador, drive, LUNou tportal.

Online

Define o estado do objeto selecionado do tipo especificado como online. Se o objeto estiver hbaport, alterará o status dos caminhos para a porta HBA atualmente selecionada para online.

Sintaxe

online <object>
Parâmetro
Parâmetro Descrição
<object> Especifica o tipo de objeto no qual executar essa operação. O tipo pode ser: hbaport, subsistema, controlador, drive, LUNou tportal.

recuperar

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

Sintaxe

recover <lun>

reenumerar

Reenumera objetos do tipo especificado. Se você usar o comando extend LUN, deverá usar o comando refresh para atualizar o tamanho do disco antes de usar o comando reenumerate.

Sintaxe

reenumerate {subsystems | drives}
Parâmetros
Parâmetro Descrição
subsistemas Consulta o provedor para descobrir quaisquer novos subsistemas que foram adicionados no provedor selecionado no momento.
acionamentos Consulta os barramentos de E/S internos para descobrir quaisquer novas unidades que foram adicionadas no subsistema selecionado no momento.

de dados

Atualiza os dados internos do provedor selecionado no momento.

Sintaxe

refresh provider

REM

Usado para comentar scripts.

Sintaxe

Rem <comment>

remover

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

Sintaxe

remove tpgroup tportal=<tportal> [noerr]
Parâmetro
Parâmetro Descrição
tpgroup tportal=<tportal> Especifica o portal de destino iSCSI a ser removido.
Noerr Apenas para scripts. Quando um erro é encontrado, o 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.

Sintaxe

replace drive=<drive_number>
Parâmetro
Parâmetro Descrição
unidade= Especifica o <drive_number> para a unidade a ser substituída.

repor

Redefine o controlador ou a porta atualmente selecionados.

Sintaxe

reset {controller | port}
Parâmetros
Parâmetro Descrição
controlador Redefine o controlador.
porto Redefine a porta.

selecione

Exibe ou altera o objeto selecionado no momento.

Sintaxe

select {hbaport | iadapter | iportal | provider | subsystem | controller | port | drive | lun | tportal | target | tpgroup } [<n>]
Parâmetros
Parâmetro Descrição
objeto Especifica o tipo de objeto a ser selecionado, incluindo: provedor, subsistema, controlador, driveou LUN.
Hbaport [<n>] Define o foco para a porta HBA local especificada. Se nenhuma porta HBA for especificada, o comando exibirá a porta HBA selecionada atualmente (se houver). A especificação de 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 de iniciador e portais de iniciador selecionados.
iAdapter [<n>] Define o foco para o adaptador do iniciador iSCSI local especificado. Se nenhum adaptador iniciador for especificado, o comando exibirá o adaptador do iniciador selecionado no momento (se houver). A especificação de um índice de adaptador de iniciador inválido resulta em nenhum adaptador de iniciador em foco. A seleção de um adaptador de iniciador desmarca todas as portas de HBA e portais de iniciador selecionados.
iPortal [<n>] Define o foco para o portal do iniciador iSCSI local especificado dentro do adaptador do iniciador iSCSI selecionado. Se nenhum portal do iniciador for especificado, o comando exibirá o portal do iniciador selecionado no momento (se houver). A especificação de um índice inválido do portal do iniciador não resulta em nenhum portal do iniciador selecionado.
provedor [<n>] 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). A especificação de um índice de subsistema inválido não resulta em nenhum subsistema em foco. A seleção de um subsistema seleciona implicitamente seu provedor associado.
[<n>] do controlador 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). A especificação de um índice de controlador inválido resulta em nenhum controlador em foco. A seleção de um controlador desmarca todas as portas, drives, LUNs, portais de destino, destinos e grupos de portais de destino selecionados.
porto [<n>] Define o foco para a porta do controlador especificado dentro do controlador selecionado no momento. Se nenhuma porta for especificada, o comando exibirá a porta atualmente selecionada (se houver). A especificação de um índice de porta inválido resulta em nenhuma porta selecionada.
[<n>] de carro 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 atualmente selecionada (se houver). A especificação de um índice de unidade inválido não resulta em nenhuma unidade em foco. A seleção de uma unidade desmarca todos os controladores, portas de controlador, LUNs, portais de destino, destinos e grupos de portais 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). A especificação de um índice de LUN inválido não resulta em nenhum LUN selecionado. A seleção de um LUN desmarca todos os controladores, portas de controlador, drives, portais de destino, destinos e grupos de portais de destino selecionados.
tportal [<n>] Define o foco para o portal de destino iSCSI especificado dentro do subsistema selecionado no momento. Se nenhum portal de destino for especificado, o comando exibirá o portal de destino selecionado no momento (se houver). A especificação de 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 de controlador, drives, LUNs, destinos e grupos de portais de destino.
[<n>] alvo 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). A especificação de um índice de destino inválido não resulta em nenhum destino selecionado. A seleção de um destino desmarca todos os controladores, portas de controlador, drives, LUNs, portais de destino e grupos de portais de destino.
tpgroup [<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). A especificação de um índice de grupo de portal de destino inválido resulta em nenhum grupo de portal de destino em foco.
[<n>] Especifica a <object number> a ser selecionada. Se o <object number> especificado não for válido, todas as seleções existentes para objetos do tipo especificado serão limpas. Se nenhum <object number> for especificado, o objeto atual será exibido.

setflag

Define a unidade atualmente selecionada como um hot spare. Os hot spares não podem ser usados para operações comuns de vinculação de LUN. Eles são reservados apenas para o tratamento de falhas. No momento, o drive não deve estar vinculado a nenhum LUN existente.

Sintaxe

setflag drive hotspare={true | false}
Parâmetros
Parâmetro Descrição
verdadeiro Seleciona a unidade atualmente selecionada como hot spare.
falso Desmarca a unidade atualmente selecionada como hot spare.

encolher

Reduz o tamanho do LUN selecionado.

Sintaxe

shrink lun size=<n> [noerr]
Parâmetros
Parâmetro Descrição
tamanho Especifica a quantidade desejada de espaço 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 Apenas para scripts. Quando um erro é encontrado, o Diskraid continua a processar comandos como se o erro não tivesse ocorrido.

em espera

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

Sintaxe

standby hbaport
Parâmetros
Parâmetro Descrição
Hbaport Altera o status dos caminhos para a porta HBA (adaptador de barramento de host) atualmente selecionada para STANDBY.

desmascarar

Torna os LUNs atualmente selecionados acessíveis a partir dos hosts especificados.

Sintaxe

unmask lun {all | none | [add] wwn=<hexadecimal_number> [;<hexadecimal_number> [;…]] | [add] initiator=<initiator>[;<initiator>[;…]]} [uninstall]
Parâmetros
Parâmetro Descrição
tudo Especifica que o LUN deve ser disponibilizado a partir de todos os hosts. No entanto, não é possível desmascarar o LUN para todos os destinos em um subsistema iSCSI.

Você deve efetuar logout do destino antes de executar o comando unmask lun all.

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

Você deve efetuar logout do destino antes de executar o comando unmask lun none.

adicionar Especifica que os hosts especificados devem ser adicionados à lista existente de hosts a partir dos quais esse LUN é acessível. Se esse parâmetro não for especificado, a lista de hosts fornecida substituirá a lista existente de hosts a partir dos quais esse LUN é acessível.
wwn= Especifica uma lista de números hexadecimais que representam nomes mundiais a partir dos quais o LUN ou os hosts devem ser acessíveis. Para mascarar/desmascarar para um conjunto específico de hosts em um subsistema Fibre Channel, você pode digitar uma lista separada por ponto-e-vírgula de WWNs para as portas nas máquinas host de interesse.
iniciador= Especifica uma lista de iniciadores iSCSI aos quais o LUN selecionado atualmente deve ser acessível. Para mascarar/desmascarar para um conjunto específico de hosts em um subsistema iSCSI, você pode digitar uma lista separada por ponto-e-vírgula de nomes de iniciadores 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 executado por script em qualquer computador que execute uma versão suportada do Windows Server, com um provedor de hardware VDS associado. Para invocar um script Diskraid, no prompt de comando, digite:

diskraid /s <script.txt>

Por padrão, o Diskraid para de processar 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 práticas tão úteis como o uso de um único script para excluir 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

Código de Erro Descrição do erro
0 Não ocorreu nenhum erro. Todo o script foi executado sem falhas.
1 Ocorreu uma exceção fatal.
2 Os argumentos especificados em uma linha de comando Diskraid estavam incorretos.
3 O Diskraid não conseguiu 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.

Exemplo

Para visualizar o status do subsistema 0 no seu computador, digite:

diskraid

Pressione ENTER e uma 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 do Diskraid:

select subsystem 0

Pressione ENTER e uma 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