Diskraid
Diskraid é uma ferramenta de linha de comando que permite configurar e gerenciar a matriz redundante de subsistemas de armazenamento em disco (RAID) independentes (ou baratos).
O 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 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 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 HBA (adaptador de barramento de host), adaptador iniciador, portal iniciador, provedor, subsistema, controlador, porta, unidade, LUN, portal de destino, destino ou grupo de portais de destino específico. 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.
Observação
A ferramenta de linha de comando Diskraid funciona apenas com subsistemas de armazenamento que dão suporte ao VDS (Serviço de Disco Virtual).
Comandos Diskraid
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 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 LUN a ser adicionado como um plex ao LUN selecionado no momento. ATENÇÃO: todos os dados no 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 portais de destino iSCSI selecionado no momento. |
| noerr | Somente para scripts. Quando um erro é encontrado, o Diskraid continua a processar os comandos como se o erro não tivesse ocorrido. |
associate
Define a lista especificada de portas do controlador como ativa para o LUN selecionado no momento (outras portas do controlador são desativadas) ou adiciona as portas do 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 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. |
| destinos | 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 de controlador especificadas à lista existente de portas de controlador associadas ao LUN. Se esse parâmetro não for especificado, a lista de portas de controlador substituirá a lista existente de portas de 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úmeros de controlador (n) e 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)
automagic
Define ou limpa sinalizadores que dão dicas aos provedores sobre como configurar um LUN. Usada sem parâmetros, a operação automagic exibe uma lista de sinalizadores.
Sintaxe
automagic {set | clear | apply} all <flag=value> [<flag=value> [...]]
Parâmetros
| Parâmetro | Descrição |
|---|---|
| set | Define os sinalizadores especificados para os valores especificados. |
| clear | Limpa os sinalizadores especificados. A palavra-chave all limpa todos os sinalizadores automagic. |
| aplicar | Aplica os sinalizadores atuais ao LUN selecionado. |
<flag> |
Os sinalizadores são identificados por acrônimos de três letras, incluindo:
|
break
Remove o plex do LUN selecionado no momento. O plex e os dados contidos não são retidos e as extensões da unidade podem ser recuperadas.
Cuidado
Primeiro, você precisa 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.
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 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ópias de Sombra de Volume). |
| noerr | Somente para scripts. Quando um erro é encontrado, o Diskraid continua a processar os 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.
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 |
|---|---|
| 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 iniciador iSCSI local para que o serviço iniciador possa usar o segredo e 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 atualmente para que o destino possa usar o segredo a fim de 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 durante a definição de um segredo no iniciador e deixá-lo de fora indica que o segredo será usado em 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 durante a definição de um segredo em um destino e deixá-lo de fora indica que o segredo será usado em todos os iniciadores que ainda não têm um segredo associado. |
create
Cria um novo destino LUN ou iSCSI no subsistema selecionado no momento ou cria um grupo de portais de destino no destino selecionado no momento. Você pode exibir a associação real usando o comando Diskraid list.
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 |
|---|---|
| simple | Cria um LUN simples. |
| faixa | 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 automagic 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= precisa 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 maior tamanho seguinte 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:
|
| drives= | Especifica o drive_number para as unidades a serem usadas a fim de criar um LUN. O parâmetro size= ou drives= precisa 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 sempre que possível. |
| stripesize= | Especifica o tamanho em megabytes de um LUN distribuição ou raid. O tamanho da distribuição 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:
|
| destino | Cria um 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 grupo de portais de destino iSCSI no destino selecionado no momento. |
| noerr | Somente para scripts. Quando um erro é encontrado, o Diskraid continua a processar os 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 LUN associado ao destino iSCSI) ou o grupo de portais de destino iSCSI.
Sintaxe
delete lun [uninstall] [noerr]
delete target [noerr]
delete tpgroup [noerr]
Parâmetros
| Parâmetro | Descrição |
|---|---|
| lun | Exclui o LUN selecionado no momento e todos os dados nele. |
| uninstall | 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 está associado ao destino. |
| tpgroup | Exclui o grupo de portais de destino iSCSI selecionado no momento. |
| noerr | Somente para scripts. Quando um erro é encontrado, o Diskraid continua a processar os comandos como se o erro não tivesse ocorrido. |
detalhes
Exibe informações detalhadas sobre o objeto selecionado atual 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 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 adaptador do iniciador iSCSI selecionado no portal. |
| provider | Lista informações detalhadas sobre o provedor selecionado no momento. |
| subsystem | 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 de controlador selecionada no momento. |
| unidade | Lista informações detalhadas sobre a unidade selecionada no momento, incluindo os LUNs que a ocupam. |
| lun | Lista informações detalhadas sobre o LUN selecionado no momento, incluindo as unidades contribuintes. A saída difere ligeiramente dependendo de o LUN fazer parte de um subsistema Fibre Channel ou iSCSI. Se a lista Hosts Sem Máscara contiver apenas um asterisco, isso significa que o LUN não tem máscara em todos os hosts. |
| tportal | Lista informações detalhadas sobre o portal de destino iSCSI selecionado atualmente. |
| destino | Lista informações detalhadas sobre o destino iSCSI selecionado atualmente. |
| tpgroup | Lista informações detalhadas sobre o grupo de portais de destino iSCSI selecionado atualmente. |
| verbose | 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 de controlador não são afetadas) ou desassocia a lista especificada de destinos iSCSI no LUN selecionado no momento.
Syntax
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 somente com provedores VDS 1.0. |
| ports | Remove portas de controlador da lista de portas de controlador associadas ao LUN selecionado no momento. Use somente com provedores VDS 1.1. |
| destinos | 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 desassociados. |
<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úmeros de controlador (n) e 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)
exit
Sai do 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.
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 parâmetro size= ou <drive> precisa ser especificado. 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:
|
| drives= | Especifica o <drive_number> para as unidades a serem usadas durante o uso de um LUN. O parâmetro size= ou <drive> precisa 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. Os provedores usam as unidades na ordem especificada sempre que possível. |
| noerr | Somente para scripts. Quando um erro é encontrado, o Diskraid continua a processar os comandos como se o erro não tivesse ocorrido. |
flushcache
Limpa o cache no controlador selecionado no momento.
Syntax
flushcache controller
ajuda
Mostra uma lista de todos os comandos Diskraid.
Syntax
help
importtarget
Recupera ou define o destino de importação do VSS (Serviço de Cópias de Sombra de Volume) atual definido para o subsistema selecionado no momento.
Syntax
importtarget subsystem [set target]
Parâmetro
| Parâmetro | Descrição |
|---|---|
| set target | Se especificado, define o destino selecionado no momento 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. |
initiator
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.
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 |
|---|---|
| type | Especifica a política de balanceamento de carga. Se o tipo não for especificado, o parâmetro path precisará ser especificado. Tipo pode ser um dos seguintes:
|
| caminho | Especifica se um caminho é primário ou tem um <weight> específico. Todos os caminhos não especificados são definidos implicitamente como backup. Todos os caminhos listados precisam ser um dos caminhos do LUN selecionado no momento. |
list
Mostra 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 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 iniciadores iSCSI no adaptador iniciador selecionado no momento. O portal 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 (*). |
| subsistemas | Lista informações resumidas sobre cada subsistema no sistema. O subsistema selecionado no momento é marcado por um asterisco (*). |
| controladores | 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 de controlador no controlador selecionado no momento. A porta selecionada no momento é marcada por um asterisco (*). |
| unidades | 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 (*). |
| destinos | 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 resumidas sobre todos os grupos do portal de destino iSCSI no destino selecionado no momento. O grupo de portais selecionado no momento é marcado por um asterisco (*). |
login
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 |
|---|---|
| type | Especifica o tipo de logon a ser executado: manual ou persistente. Se não for especificado, um logon manual será executado. |
| manual | Faça logon manualmente. Há também uma opção de inicialização que se destina a 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 usado: nenhum, CHAP único ou CHAP mútuo; se não for especificado, nenhuma autenticação será usada. |
| tportal | Especifica um portal de destino opcional no subsistema selecionado no momento 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:
|
logout
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 logon da qual deve fazer logoff. |
manutenção
Executa operações de manutenção do tipo especificado no objeto selecionado no momento.
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 tipo objeto pode ser subsistema, controlador, porta, unidade ou LUN. |
<operation> |
Especifica a operação de manutenção a ser executada. O tipo operação pode ser spinup, spindown, blink, beep ou ping. Uma operação precisa ser especificada. |
| count= | Especifica o número de vezes que a operação será repetida. Normalmente, isso é usado com blink, beep 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>]
Parâmetro
| Parâmetro | Descrição |
|---|---|
<name> |
Especifica um nome para o subsistema, LUN ou destino. Seu tamanho precisa ser menor que 64 caracteres. Se nenhum nome for fornecido, o nome existente, se houver, será excluído. |
offline
Define o estado do objeto do tipo especificado selecionado no momento como offline.
Syntax
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, unidade, LUN ou tportal. |
online
Define o estado do objeto do tipo especificado selecionado no momento como offline. Se o objeto for hbaport, o status dos caminhos para a porta HBA selecionada no momento será alterado para online.
Syntax
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, unidade, 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
Renumera objetos do tipo especificado. Se você usar o comando extend LUN, precisará 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 eventuais novos subsistemas que foram adicionados no provedor selecionado no momento. |
| unidades | Consulta os barramentos de E/S internos para descobrir as novas unidades que foram adicionadas ao subsistema selecionado no momento. |
refresh
Atualiza os dados internos do provedor selecionado no momento.
Syntax
refresh provider
rem
Usado para comentar scripts.
Syntax
Rem <comment>
remove
Remove o portal de destino iSCSI especificado do grupo de portais de destino selecionado no momento.
Syntax
remove tpgroup tportal=<tportal> [noerr]
Parâmetro
| Parâmetro | Descrição |
|---|---|
tpgroup tportal=<tportal> |
Especifica o portal de destino iSCSI a ser removido. |
| noerr | Somente para scripts. Quando um erro é encontrado, o Diskraid continua a processar os 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>
Parâmetro
| Parâmetro | Descrição |
|---|---|
| drive= | Especifica o <drive_number> para a unidade a ser substituída. |
reset
Redefine o controlador ou a porta selecionados no momento.
Sintaxe
reset {controller | port}
Parâmetros
| Parâmetro | Descrição |
|---|---|
| controlador | Redefine o controlador. |
| porta | Redefine a porta. |
select
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, unidade ou 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 no momento (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 iniciadores e portais iniciadores selecionados. |
iadapter [<n>] |
Define o foco no adaptador inicial iSCSI local especificado. Se nenhum adaptador iniciador for especificado, o comando exibirá o adaptador iniciador selecionado no momento (se houver). A especificação de um índice de adaptador iniciador inválido resulta em nenhum adaptador iniciador em foco. A seleção de um adaptador iniciador desmarca todas as portas HBA e portais iniciadores selecionados. |
iportal [<n>] |
Define o foco para o portal do iniciador iSCSI local especificado dentro do adaptador iniciador iSCSI selecionado. Se nenhum portal iniciador for especificado, o comando exibirá o portal iniciador selecionado no momento (se houver). A especificação de um índice de portal iniciador inválido resulta em nenhum portal iniciador selecionado. |
provider [<n>] |
Define o foco no provedor especificado. Se nenhum provedor for especificado, o comando exibirá o provedor selecionado no momento (se houver). A especificação de um índice de provedor inválido resulta em nenhum provedor em foco. |
subsystem [<n>] |
Define o foco no 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 resulta em nenhum subsistema em foco. A seleção de um subsistema seleciona implicitamente seu provedor associado. |
controller [<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). 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, unidades, LUNs, portais de destino, destinos e grupos de portal de destino selecionados. |
port [<n>] |
Define o foco na 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). A especificação de um índice de porta inválido resulta em nenhuma porta selecionada. |
drive [<n>] |
Define o foco na 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). A especificação de um índice de unidade inválido 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 no 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 de controlador, unidades, portais de destino, destinos e grupos de portais de destino selecionados. |
tportal [<n>] |
Define o foco no 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). 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 do controlador, unidades, LUNs, destinos e grupos de portais de destino. |
target [<n>] |
Define o foco no 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 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 portais de destino. |
tpgroup [<n>] |
Define o foco no grupo de portais de destino iSCSI especificado dentro do destino iSCSI selecionado no momento. Se nenhum grupo de portais de destino for especificado, o comando exibirá o grupo de portais de destino selecionado no momento (se houver). A especificação de um índice de grupo de portais de destino inválido resulta em nenhum grupo de portais 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 de uso frequente. Os sobressalentes de uso frequente não podem ser usados em operações comuns de associação LUN. Eles são reservados apenas para tratamento de falhas. A unidade não poderá estar associada a nenhum LUN existente no momento.
Sintaxe
setflag drive hotspare={true | false}
Parâmetros
| Parâmetro | Descrição |
|---|---|
| true | Seleciona a unidade selecionada no momento como um sobressalente de uso frequente. |
| false | Desmarca a unidade selecionada no momento como um sobressalente de uso frequente. |
shrink
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) pelo qual reduzir o tamanho do LUN. Para especificar o tamanho usando outras unidades, use um dos seguintes sufixos reconhecidos imediatamente após o tamanho:
|
| noerr | Somente para scripts. Quando um erro é encontrado, o Diskraid continua a processar os 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) selecionada no momento 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) selecionada no momento para STANDBY. |
unmask
Torna os LUNs selecionados no momento acessíveis nos hosts especificados.
Sintaxe
unmask lun {all | none | [add] wwn=<hexadecimal_number> [;<hexadecimal_number> [;…]] | [add] initiator=<initiator>[;<initiator>[;…]]} [uninstall]
Parâmetros
| Parâmetro | Descrição |
|---|---|
| all | Especifica que o LUN deve ficar acessível a todos os hosts. No entanto, você não pode remover a máscara do LUN para todos os destinos em um subsistema iSCSI. Você precisa fazer logoff do destino antes de executar o comando |
| nenhum | Especifica que o LUN não deve ficar acessível a nenhum host. Você precisa fazer logoff do destino antes de executar o comando |
| add | Especifica que os hosts especificados precisam ser adicionados à lista existente de hosts aos 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 aos quais esse LUN está acessível. |
| wwn= | Especifica uma lista de números hexadecimais que representam nomes de todo o mundo nos quais o LUN ou os hosts devem ser disponibilizados para acesso. 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 ficar 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. |
| uninstall | Se especificado, desinstala o disco associado ao LUN no sistema local antes que o LUN seja mascarado. |
Criação de scripts Diskraid
O Diskraid pode ser roteirizado em qualquer computador que execute uma versão com suporte do Windows Server e com um provedor de hardware VDS associado. Para invocar um script Diskraid, no tipo de prompt de comando:
diskraid /s <script.txt>
Por padrão, o Diskraid interromperá 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 dão suporte ao parâmetro noerr. Os erros sempre são 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. 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. |
Exemplo
Para exibir o status do subsistema 0 no computador, digite:
diskraid
Pressione ENTER e a saída semelhante à seguinte será 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 a saída semelhante à seguinte será 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