Spectrum Virtualize for SAN Volume Controller and Storwize … · 2019-08-31 · IBM Spectrum...

1012
IBM Spectrum Virtualize for SAN Volume Controller and Storwize Family Versão 7.8.0 Guia do Usuário da Interface de Linha de Comandos GC43-1488-13 IBM

Transcript of Spectrum Virtualize for SAN Volume Controller and Storwize … · 2019-08-31 · IBM Spectrum...

  • IBM Spectrum Virtualize for SAN Volume Controller andStorwize FamilyVersão 7.8.0

    Guia do Usuário da Interface de Linhade Comandos

    GC43-1488-13

    IBM

  • ObservaçãoAntes de usar estas informações e o produto suportado por elas, consulte as informações em “Avisos” na página 969.

    Esta edição se aplica ao SAN Volume Controller versão 7.8.0 e a todas as liberações e modificações subsequentes atéque seja indicado de outra forma em novas edições.

    Esta edição substitui a GC27-2287-12.

    © Copyright IBM Corporation 2003, 2016.

  • Índice

    Tabelas . . . . . . . . . . . . . . . xi

    Sobre este Manual . . . . . . . . . xiiiQuem Deve Usar Este Guia. . . . . . . . . xiiiAcessibilidade . . . . . . . . . . . . . xiiiÊnfase . . . . . . . . . . . . . . . . xiiiBiblioteca do SAN Volume Controller e PublicaçõesRelacionadas. . . . . . . . . . . . . . xiiiComo Solicitar Publicações IBM . . . . . . . xvEnviando Seus Comentários . . . . . . . . . xvDiagramas de Sintaxe. . . . . . . . . . . xvi

    Terminologia . . . . . . . . . . . . xviiCaracteres Especiais da CLI . . . . . . . xviiiUsando curingas no CLI . . . . . . . . xviiiTipos de Dados e Intervalos de Valores . . . . xixComandos e Parâmetros daCLI . . . . . . xxivSinalizadores da CLI . . . . . . . . . . xxvMensagens da CLI . . . . . . . . . . xxvComandos CLI descontinuados . . . . . . xxvEntendendo indicadores de capacidade . . . xxviiAtributos dos Parâmetros -filtervalue. . . . xxviii

    Capítulo 1. Configurando um ClienteSSH . . . . . . . . . . . . . . . . 1Configurando um Cliente SSH em um Host Windows 2

    Gerando um Par de Chaves SSH Usando o PuTTY 2Configurando uma Sessão do PuTTY para a CLI . 3Conectando-se à CLI Usando PuTTY . . . . . 4Iniciando uma Sessão do PuTTY para a CLI . . . 6

    Preparando o Cliente SSH em um Host AIX ou Linux 6Gerando um Par de Chaves SSH Usando oOpenSSH . . . . . . . . . . . . . . 7Conectando-se à CLI Usando OpenSSH . . . . 8

    Trabalhando com Usuários Local e Remoto . . . . 8Comandos UNIX disponíveis em sessões SSHinterativas . . . . . . . . . . . . . . . 9

    Capítulo 2. Copiando os arquivos dosoftware atualização usando PuTTYpscp ou openssh scp . . . . . . . . 11

    Capítulo 3. Usando a CLI . . . . . . . 13Definindo a Hora do Sistema em Cluster Usando aCLI . . . . . . . . . . . . . . . . . 13Configurando Data e Hora de Cluster . . . . . 14Visualizando e Atualizando Configurações deLicença Usando a CLI . . . . . . . . . . . 14Exibindo Propriedades do Sistema em ClusterUsando a CLI . . . . . . . . . . . . . 15Mantendo senhas usando a CLI . . . . . . . 16Usando os comandos de dump para trabalhar comdiretórios . . . . . . . . . . . . . . . 17Reinclusão de um Nó Reparado em um Sistema emCluster Usando a CLI . . . . . . . . . . . 19

    Exibindo propriedades do nó usando a CLI . . . 22Descobrindo MDisks Usando a CLI . . . . . . 22Criando Conjuntos de Armazenamento Usando aCLI . . . . . . . . . . . . . . . . . 24Incluindo MDisks em Conjuntos de ArmazenamentoUsando a CLI . . . . . . . . . . . . . 26Configurando um Disco Quorum Usando a CLI . . 28Modificando a quantia de memória disponível paraos Serviços de cópia, Espelhamento de volume ematrizes RAID usando a CLI . . . . . . . . 28Criando volumes Usando a CLI . . . . . . . 31Incluindo uma cópia em um volume . . . . . . 33Excluindo uma cópia de um volume . . . . . . 34Configurando Objetos de Host Usando a CLI . . . 34Criando Mapeamentos de Host Usando a CLI . . . 36Criando Mapeamentos FlashCopy Usando a CLI . . 36

    Preparando e Iniciando um MapeamentoFlashCopy Usando a CLI . . . . . . . . . 37Parando Mapeamentos FlashCopy Usando a CLI 38Excluindo um Mapeamento FlashCopy Usando aCLI . . . . . . . . . . . . . . . . 39

    Criando um Grupo de Consistências FlashCopy eIncluindo Mapeamentos Usando a CLI . . . . . 39

    Preparando e Iniciando um Grupo deConsistências FlashCopy Usando a CLI . . . . 41Parando um Grupo de Consistências FlashCopyUsando a CLI . . . . . . . . . . . . 42Excluindo um Grupo de Consistências FlashCopyUsando a CLI . . . . . . . . . . . . 43

    Criando relacionamentos do Metro Mirror, GlobalMirror ou ativo/ativo usando a CLI . . . . . . 43

    Modificando relacionamentos do Metro Mirror,do Global Mirror ou ativo/ativo usando a CLI . 44Iniciando e parando relacionamentos do MetroMirror, do Global Mirror ou ativo/ativo usando aCLI . . . . . . . . . . . . . . . . 44Exibindo o progresso de relacionamentos doMetro Mirror, do Global Mirror ou ativo/ativousando a CLI . . . . . . . . . . . . . 45Alternando Relacionamentos de Metro Mirror ouGlobal Mirror Usando a CLI. . . . . . . . 46Excluindo relacionamentos do Metro Mirror, doGlobal Mirror ou ativo/ativo usando a CLI. . . 46

    Criando grupos de consistências do Metro Mirror,do Global Mirror ou ativo/ativo usando a CLI . . 47

    Modificando grupos de consistências do MetroMirror, do Global Mirror ou ativo/ativo usando aCLI . . . . . . . . . . . . . . . . 47Iniciando e parando processos de cópia do grupode consistências do Metro Mirror, Global Mirrorou ativo/ativo usando a CLI . . . . . . . 47Excluindo grupos de consistências do MetroMirror, do Global Mirror ou ativo/ativo usando aCLI . . . . . . . . . . . . . . . . 48

    Criando Parcerias de Metro Mirror e Global MirrorUsando a CLI . . . . . . . . . . . . . 49

    © Copyright IBM Corp. 2003, 2016 iii

  • Modificando Parcerias de Metro Mirror e GlobalMirror Usando a CLI . . . . . . . . . . 50Iniciando e Parando Parcerias de Metro Mirror eGlobal Mirror Usando a CLI. . . . . . . . 51Excluindo Parcerias de Metro Mirror e GlobalMirror Usando a CLI . . . . . . . . . . 51

    Determinando os WWNNs de um nó usando a CLI 51Listando volumes dependentes do nó usando a CLI 52Determinando o nome do volume a partir doidentificador de dispositivo no host . . . . . . 53Determinando o host que um volume mapeia . . . 54Determinando o relacionamento entre volumes eMDisks usando a CLI . . . . . . . . . . . 54Determinando o Relacionamento entre MDisks eLUNs do Controlador Usando a CLI . . . . . . 54Aumentando o tamanho de seu sistema usando aCLI . . . . . . . . . . . . . . . . . 55

    Incluindo um nó para aumentar o tamanho dosistema . . . . . . . . . . . . . . . 55

    Validando e reparando cópias de volume espelhadousando a CLI . . . . . . . . . . . . . . 58Reparando um volume thin-provisioned usando aCLI . . . . . . . . . . . . . . . . . 60Recuperando volumes off-line usando a CLI(interface da linha de comandos) . . . . . . . 60

    Recuperando um nó e retornando-o para osistema usando a CLI . . . . . . . . . . 61Recuperando Volumes Offline Usando a CLI . . 62Movendo volumes offline para seus grupos deE/S originais usando a CLI . . . . . . . . 63

    Registrando as alterações de WWPN de HBAs dohost substituído . . . . . . . . . . . . . 63Expandindo volumes usando a CLI . . . . . . 64

    Expandindo um volume que está mapeado paraum host AIX . . . . . . . . . . . . . 65Expandindo um volume que é mapeado para umhost do Microsoft Windows usando a CLI . . . 65

    Reduzindo Volumes Usando a CLI . . . . . . 66Migrando Extensões Usando a CLI . . . . . . 67Migrando volumes entre conjuntos usando a CLI. . 68Movendo um volume entre os grupos de E/Susando a CLI . . . . . . . . . . . . . . 70Criando um novo volume de modo de imagemusando a CLI . . . . . . . . . . . . . . 71Migrando dados para um volume de modo deimagem usando CLI . . . . . . . . . . . 72Excluindo um nó a partir de um sistema usando aCLI . . . . . . . . . . . . . . . . . 72Executando o procedimento de manutenção dosistema usando a CLI . . . . . . . . . . . 74Modificando endereços IP do sistema usando a CLI 75Alterando o endereço do gateway do sistemausando a CLI . . . . . . . . . . . . . . 76Mudando a largura da banda do relacionamentopara um sistema usando a CLI . . . . . . . . 76Configurando o sistema para hosts iSCSI . . . . 77

    Configurando ou Modificando um Alias iSCSIUsando a CLI . . . . . . . . . . . . 79Configurando o Endereço do Servidor iSNSUsando a CLI . . . . . . . . . . . . 79

    Configurando o sistema de autenticação iSCSIusando a CLI . . . . . . . . . . . . . 79

    Configurando o Serviço de Autenticação RemotaUsando a CLI . . . . . . . . . . . . . 80

    Configurando o Serviço de Autenticação Remotacom o Protocolo (LDAP) Usando a CLI . . . . 81

    Alterando grupo de usuários . . . . . . . . 82Alterando usuários . . . . . . . . . . . . 82Configurando Notificações SNMP Usando a CLI . . 83Configurando Notificações de syslog Usando a CLI 84Configurando Notificações de Eventos de email eRelatórios de Inventário Usando a CLI . . . . . 85Configurando Servidores de email Usando a CLI . . 87Alterando Senhas de Usuário Usando a CLI . . . 87Alterando a Configuração do Código de IdiomaUsando a CLI . . . . . . . . . . . . . 88Visualizando o Log de Recurso Usando a CLI . . . 88Analisando o Log de Erros Usando A CLI . . . . 88Encerrando um sistema usando a CLI . . . . . 89Atualizando o software automaticamente usando aCLI . . . . . . . . . . . . . . . . . 89

    Capítulo 4. Comandos na Matriz . . . . 93charray . . . . . . . . . . . . . . . . 93charraymember . . . . . . . . . . . . . 95lsarray . . . . . . . . . . . . . . . . 97lsarrayinitprogress. . . . . . . . . . . . 104lsarraylba. . . . . . . . . . . . . . . 105lsarraymember . . . . . . . . . . . . . 107lsarraymembergoals . . . . . . . . . . . 110lsarraymemberprogress . . . . . . . . . . 113lsarrayrecommendation . . . . . . . . . . 115lsarraysyncprogress . . . . . . . . . . . 118lspotentialarraysize . . . . . . . . . . . 119mkarray . . . . . . . . . . . . . . . 122mkdistributedarray . . . . . . . . . . . 124recoverarray . . . . . . . . . . . . . . 127recoverarraybycluster (Descontinuado) . . . . . 128recoverarraybysystem . . . . . . . . . . 128rmarray . . . . . . . . . . . . . . . 128

    Capítulo 5. Comandos do Log deAuditoria . . . . . . . . . . . . . 131catauditlog . . . . . . . . . . . . . . 131dumpauditlog . . . . . . . . . . . . . 132lsauditlogdumps (Descontinuado) . . . . . . 134

    Capítulo 6. Comandos de Backup eRestauração . . . . . . . . . . . . 135svcconfig . . . . . . . . . . . . . . . 135backup . . . . . . . . . . . . . . . 136clear . . . . . . . . . . . . . . . . 137cron . . . . . . . . . . . . . . . . 138recover . . . . . . . . . . . . . . . 138restauração . . . . . . . . . . . . . . 139restauração . . . . . . . . . . . . . . 141

    iv Spectrum Virtualize for SAN Volume Controller and Storwize Family: Guia do Usuário da Interface de Linha de Comandos

  • Capítulo 7. Comandos da conta denuvem . . . . . . . . . . . . . . 143chcloudaccountawss3. . . . . . . . . . . 143chcloudaccountswift . . . . . . . . . . . 145lscloudaccount . . . . . . . . . . . . . 148lscloudaccountusage . . . . . . . . . . . 149lscloudaccountimportcandidate . . . . . . . 151mkcloudaccountawss3 . . . . . . . . . . 152mkcloudaccountswift . . . . . . . . . . . 153rmcloudaccount . . . . . . . . . . . . 155testcloudaccount . . . . . . . . . . . . 155

    Capítulo 8. Comandos do Sistema emCluster . . . . . . . . . . . . . . 157addnode (Apenas SAN Volume Controller) . . . 157addiscsistorageport . . . . . . . . . . . 160cfgportip . . . . . . . . . . . . . . . 162chbanner . . . . . . . . . . . . . . . 168chcluster (Descontinuado) . . . . . . . . . 170chiogrp . . . . . . . . . . . . . . . 170chnode . . . . . . . . . . . . . . . 174chnodebattery . . . . . . . . . . . . . 176chnodebootdrive . . . . . . . . . . . . 177chnodehw (SVC) / chnodecanisterhw (Produtos daFamília Storwize) . . . . . . . . . . . . 178chquorum . . . . . . . . . . . . . . 179chsecurity . . . . . . . . . . . . . . 181chsite . . . . . . . . . . . . . . . . 182chsystem . . . . . . . . . . . . . . . 182chsystemcert . . . . . . . . . . . . . 190chsystemip . . . . . . . . . . . . . . 192chthrottle . . . . . . . . . . . . . . . 194cleardumps . . . . . . . . . . . . . . 195cpdumps . . . . . . . . . . . . . . . 197detectiscsistorageportcandidate . . . . . . . 198dumpconfig (Descontinuado) . . . . . . . . 200help . . . . . . . . . . . . . . . . 200lsclustercandidate (Descontinuado) . . . . . . 201lscluster (Descontinuado) . . . . . . . . . 201lsclusterip (Descontinuado) . . . . . . . . . 201lsclusterstats (Descontinuado) . . . . . . . . 201lsdiscoverystatus . . . . . . . . . . . . 201lsfabric . . . . . . . . . . . . . . . 203lsfcportcandidate . . . . . . . . . . . . 206lsiscsistorageport . . . . . . . . . . . . 207lsiscsistorageportcandidate . . . . . . . . . 210lsiogrp . . . . . . . . . . . . . . . 212lshbaportcandidate (Descontinuado) . . . . . . 215lsiogrphost . . . . . . . . . . . . . . 215lsiogrpcandidate . . . . . . . . . . . . 216lsiostatsdumps (Descontinuado) . . . . . . . 217lsiotracedumps (Descontinuado) . . . . . . . 217lsnode (SVC) / lsnodecanister (produtos da famíliaStorwize) . . . . . . . . . . . . . . . 217lsnodebattery . . . . . . . . . . . . . 222lsnodecandidate (SAN Volume Controller). . . . 225lsnodedependentvdisks (Descontinuado) . . . . 226lsnodehw (SVC) / lsnodecanisterhw (Produtos daFamília Storwize) . . . . . . . . . . . . 226

    lsnodestats (SVC) / lsnodecanisterstats (Produtosda Família Storwize) . . . . . . . . . . . 228lsnodevpd (SVC) / lsnodecanistervpd (Produtos daFamília Storwize) . . . . . . . . . . . . 235lsportusb . . . . . . . . . . . . . . . 244lsportip . . . . . . . . . . . . . . . 247lsportfc . . . . . . . . . . . . . . . 254lsportsas . . . . . . . . . . . . . . . 257lsquorum. . . . . . . . . . . . . . . 259lsroute. . . . . . . . . . . . . . . . 261lstimezones . . . . . . . . . . . . . . 262lssasportcandidate . . . . . . . . . . . . 262lssecurity . . . . . . . . . . . . . . . 263lssite . . . . . . . . . . . . . . . . 264lsthrottle . . . . . . . . . . . . . . . 266lssystem . . . . . . . . . . . . . . . 267lssystemcert . . . . . . . . . . . . . . 275lssystemip . . . . . . . . . . . . . . 277lssystemstats . . . . . . . . . . . . . 279lstargetportfc . . . . . . . . . . . . . 284mkquorumapp . . . . . . . . . . . . . 286mkthrottle . . . . . . . . . . . . . . 286ping . . . . . . . . . . . . . . . . 287rmiscsistorageport . . . . . . . . . . . . 288rmnode (SVC) / rmnodecanister (Produtos daFamília Storwize) . . . . . . . . . . . . 289rmportip . . . . . . . . . . . . . . . 291rmthrottle . . . . . . . . . . . . . . 292setclustertime (Descontinuado) . . . . . . . 292setsystemtime . . . . . . . . . . . . . 292setpwdreset . . . . . . . . . . . . . . 293settimezone . . . . . . . . . . . . . . 294showtimezone . . . . . . . . . . . . . 294startstats . . . . . . . . . . . . . . . 295stopstats (Descontinuado) . . . . . . . . . 297stopcluster (Descontinuado) . . . . . . . . 297stopsystem . . . . . . . . . . . . . . 297

    Capítulo 9. Comandos de Diagnósticoe de Auxílio de Serviço do Sistemaem Cluster . . . . . . . . . . . . 299applysoftware . . . . . . . . . . . . . 299caterrlog (Descontinuado) . . . . . . . . . 302caterrlogbyseqnum (Descontinuado) . . . . . . 302cherrstate (Descontinuado) . . . . . . . . . 302chdnsserver . . . . . . . . . . . . . . 302cheventlog . . . . . . . . . . . . . . 303chsyslogserver . . . . . . . . . . . . . 303clearerrlog . . . . . . . . . . . . . . 305cpfabricdumps (Descontinuado) . . . . . . . 305dumperrlog . . . . . . . . . . . . . . 305finderr . . . . . . . . . . . . . . . 306setevent (Descontinuado) . . . . . . . . . 307lscimomdumps (Descontinuado) . . . . . . . 307lscopystatus . . . . . . . . . . . . . . 307lsdumps . . . . . . . . . . . . . . . 307lsdnsserver . . . . . . . . . . . . . . 309lserrlogbyfcconsistgrp (Descontinuado) . . . . . 310lserrlogbyfcmap (Descontinuado) . . . . . . . 310lserrlogbyhost (Descontinuado) . . . . . . . 310

    Índice v

  • lserrlogbyiogrp (Descontinuado) . . . . . . . 310lserrlogbymdisk (Descontinuado) . . . . . . . 310lserrlogbymdiskgrp (Descontinuado) . . . . . 311lserrlogbynode (Descontinuado) . . . . . . . 311lserrlogbyrcconsistgrp (Descontinuado) . . . . . 311lserrlogbyrcrelationship (Descontinuado) . . . . 311lserrlogbyvdisk (Descontinuado) . . . . . . . 311lserrlogdumps (Descontinuado) . . . . . . . 311lsfeaturedumps (Descontinuado) . . . . . . . 311lseventlog . . . . . . . . . . . . . . 311lsservicestatus . . . . . . . . . . . . . 317lssyslogserver . . . . . . . . . . . . . 322lssoftwaredumps (Descontinuado) . . . . . . 323lssoftwareupgradestatus (Descontinuado) . . . . 323lsupdate . . . . . . . . . . . . . . . 323mkdnsserver . . . . . . . . . . . . . 326mksyslogserver . . . . . . . . . . . . . 327rmdnsserver . . . . . . . . . . . . . . 329rmsyslogserver . . . . . . . . . . . . . 329setlocale . . . . . . . . . . . . . . . 330svqueryclock . . . . . . . . . . . . . 331writesernum. . . . . . . . . . . . . . 331

    Capítulo 10. Comando do Controlador 333chcontroller . . . . . . . . . . . . . . 333lscontroller . . . . . . . . . . . . . . 334lscontrollerdependentvdisks . . . . . . . . 339

    Capítulo 11. Comandos da Unidade 341applydrivesoftware . . . . . . . . . . . 341chdrive . . . . . . . . . . . . . . . 344lsdrive. . . . . . . . . . . . . . . . 345lsdriveclass . . . . . . . . . . . . . . 350lsdrivelba. . . . . . . . . . . . . . . 353lsdriveprogress . . . . . . . . . . . . . 354lsdriveupgradeprogress . . . . . . . . . . 356triggerdrivedump . . . . . . . . . . . . 358

    Capítulo 12. Comandos de Notificaçãode Email e de Eventos . . . . . . . 359chemail . . . . . . . . . . . . . . . 359chemailserver . . . . . . . . . . . . . 361chemailuser . . . . . . . . . . . . . . 362chsnmpserver . . . . . . . . . . . . . 363lsemailserver . . . . . . . . . . . . . 364lsemailuser . . . . . . . . . . . . . . 365lssnmpserver . . . . . . . . . . . . . 366mkemailserver . . . . . . . . . . . . . 367mkemailuser . . . . . . . . . . . . . 368mksnmpserver . . . . . . . . . . . . . 370rmemailserver . . . . . . . . . . . . . 371rmemailuser . . . . . . . . . . . . . . 372rmsnmpserver . . . . . . . . . . . . . 372sendinventoryemail . . . . . . . . . . . 373setemail (Descontinuado) . . . . . . . . . 373startemail. . . . . . . . . . . . . . . 373stopemail. . . . . . . . . . . . . . . 374testemail . . . . . . . . . . . . . . . 374

    Capítulo 13. Comandos do Gabinete 377addcontrolenclosure . . . . . . . . . . . 377chenclosure . . . . . . . . . . . . . . 377chenclosurecanister . . . . . . . . . . . 378chenclosuredrawer . . . . . . . . . . . 380chenclosurepsu . . . . . . . . . . . . . 381chenclosuresem. . . . . . . . . . . . . 381chenclosureslot . . . . . . . . . . . . . 382(satask) chenclosurevpd (Descontinuado) . . . . 383lsenclosure . . . . . . . . . . . . . . 383lsenclosurebattery . . . . . . . . . . . . 386lscontrolenclosurecandidate (Apenas Produtos daFamília Storwize) . . . . . . . . . . . . 389lsenclosurecanister. . . . . . . . . . . . 390lsenclosurechassis (Flex V7000 Storage Node). . . 393lsenclosuredrawer . . . . . . . . . . . . 395lsenclosuredisplaypanel . . . . . . . . . . 397lsenclosurefanmodule . . . . . . . . . . 398lsenclosurepsu . . . . . . . . . . . . . 400lsenclosuresem . . . . . . . . . . . . . 403lsenclosureslot . . . . . . . . . . . . . 405lsenclosurestats . . . . . . . . . . . . . 408lssasfabric . . . . . . . . . . . . . . 411resetleds . . . . . . . . . . . . . . . 413triggerenclosuredump . . . . . . . . . . 414

    Capítulo 14. Comandos de criptografia 417chencryption . . . . . . . . . . . . . 417lsencryption . . . . . . . . . . . . . . 419

    Capítulo 15. Comandos delicenciamento e especificação . . . . 423activatefeature . . . . . . . . . . . . . 423chlicense . . . . . . . . . . . . . . . 424deactivatefeature . . . . . . . . . . . . 426lsfeature . . . . . . . . . . . . . . . 427lslicense . . . . . . . . . . . . . . . 429

    Capítulo 16. Comandos de FlashCopy 433chfcconsistgrp . . . . . . . . . . . . . 433chfcmap . . . . . . . . . . . . . . . 433lsfcconsistgrp . . . . . . . . . . . . . 435lsfcmap . . . . . . . . . . . . . . . 438lsfcmapcandidate . . . . . . . . . . . . 442lsfcmapprogress . . . . . . . . . . . . 442lsfcmapdependentmaps . . . . . . . . . . 443lsrmvdiskdependentmaps . . . . . . . . . 444mkfcconsistgrp . . . . . . . . . . . . . 445mkfcmap . . . . . . . . . . . . . . . 446prestartfcconsistgrp . . . . . . . . . . . 449prestartfcmap . . . . . . . . . . . . . 450rmfcconsistgrp . . . . . . . . . . . . . 451rmfcmap . . . . . . . . . . . . . . . 452startfcconsistgrp . . . . . . . . . . . . 453startfcmap . . . . . . . . . . . . . . 455stopfcconsistgrp . . . . . . . . . . . . 456stopfcmap . . . . . . . . . . . . . . 457

    Capítulo 17. Comandos do Host . . . 461addhostclustermember . . . . . . . . . . 461

    vi Spectrum Virtualize for SAN Volume Controller and Storwize Family: Guia do Usuário da Interface de Linha de Comandos

  • addhostiogrp . . . . . . . . . . . . . 462addhostport . . . . . . . . . . . . . . 462chhost . . . . . . . . . . . . . . . . 464chhostcluster . . . . . . . . . . . . . 465lshost . . . . . . . . . . . . . . . . 467lshostcluster . . . . . . . . . . . . . . 471lshostclustermember . . . . . . . . . . . 473lshostclustervolumemap . . . . . . . . . . 474lshostiogrp . . . . . . . . . . . . . . 476lsiscsiauth . . . . . . . . . . . . . . 477mkhost . . . . . . . . . . . . . . . 478mkhostcluster . . . . . . . . . . . . . 480mkvolumehostclustermap . . . . . . . . . 482rmhost . . . . . . . . . . . . . . . 483rmhostcluster . . . . . . . . . . . . . 483rmhostclustermember . . . . . . . . . . 484rmvolumehostclustermap . . . . . . . . . 485rmhostiogrp . . . . . . . . . . . . . . 486rmhostport . . . . . . . . . . . . . . 488

    Capítulo 18. Comandos deInformações . . . . . . . . . . . . 491ls2145dumps (Descontinuado) . . . . . . . . 491lsconfigdumps (Descontinuado) . . . . . . . 491lssshkeys (Descontinuado) . . . . . . . . . 491

    Capítulo 19. Comandos do servidorprincipal . . . . . . . . . . . . . 493chkeyserver . . . . . . . . . . . . . . 493chkeyserverisklm . . . . . . . . . . . . 494lskeyserver . . . . . . . . . . . . . . 495lskeyserverisklm . . . . . . . . . . . . 496mkkeyserver . . . . . . . . . . . . . 498rmkeyserver . . . . . . . . . . . . . . 499testkeyserver . . . . . . . . . . . . . 500

    Capítulo 20. Comandos Livedump . . 501cancellivedump. . . . . . . . . . . . . 501lslivedump . . . . . . . . . . . . . . 501preplivedump . . . . . . . . . . . . . 502triggerlivedump . . . . . . . . . . . . 502

    Capítulo 21. Comandos do DiscoGerenciado . . . . . . . . . . . . 505addmdisk . . . . . . . . . . . . . . 505applymdisksoftware (Discontinuado) . . . . . 506chmdisk . . . . . . . . . . . . . . . 506detectmdisk . . . . . . . . . . . . . . 508dumpallmdiskbadblocks. . . . . . . . . . 510dumpmdiskbadblocks . . . . . . . . . . 511includemdisk . . . . . . . . . . . . . 512lsmdisk . . . . . . . . . . . . . . . 512lsmdiskdumps (Descontinuado) . . . . . . . 519lsmdisklba . . . . . . . . . . . . . . 519lsmdiskcandidate . . . . . . . . . . . . 520lsmdiskextent . . . . . . . . . . . . . 521lsmdiskmember . . . . . . . . . . . . 523setquorum (Descontinuado) . . . . . . . . 525triggermdiskdump (Descontinuado) . . . . . . 525

    Capítulo 22. Comandos de Conjuntosde Armazenamento . . . . . . . . . 527chmdiskgrp . . . . . . . . . . . . . . 527lsfreeextents . . . . . . . . . . . . . . 529lsmdiskgrp . . . . . . . . . . . . . . 529mkmdiskgrp . . . . . . . . . . . . . 537rmmdisk . . . . . . . . . . . . . . . 542rmmdiskgrp . . . . . . . . . . . . . . 543

    Capítulo 23. Comandos de serviçosde cópia . . . . . . . . . . . . . 545chpartnership . . . . . . . . . . . . . 545chrcconsistgrp . . . . . . . . . . . . . 548chrcrelationship . . . . . . . . . . . . 550lspartnership . . . . . . . . . . . . . 554lspartnershipcandidate . . . . . . . . . . 558lsrcconsistgrp . . . . . . . . . . . . . 558lsrcrelationship . . . . . . . . . . . . . 562lsrcrelationshipcandidate . . . . . . . . . 567lsrcrelationshipprogress . . . . . . . . . . 568mkfcpartnership . . . . . . . . . . . . 569mkippartnership . . . . . . . . . . . . 570mkpartnership (Descontinuado) . . . . . . . 572mkrcconsistgrp . . . . . . . . . . . . . 572mkrcrelationship . . . . . . . . . . . . 572rmpartnership . . . . . . . . . . . . . 576rmrcconsistgrp . . . . . . . . . . . . . 577rmrcrelationship . . . . . . . . . . . . 578startrcconsistgrp . . . . . . . . . . . . 579startrcrelationship . . . . . . . . . . . . 581stoprcconsistgrp . . . . . . . . . . . . 584stoprcrelationship . . . . . . . . . . . . 586switchrcconsistgrp. . . . . . . . . . . . 588switchrcrelationship . . . . . . . . . . . 590

    Capítulo 24. Comandos de Migração 593lsmigrate . . . . . . . . . . . . . . . 593migrateexts . . . . . . . . . . . . . . 594migratetoimage. . . . . . . . . . . . . 595migratevdisk . . . . . . . . . . . . . 597

    Capítulo 25. Comandos deInformações de Serviço . . . . . . . 599host . . . . . . . . . . . . . . . . 599sainfo lsbootdrive . . . . . . . . . . . . 599sainfolscmdstatus . . . . . . . . . . . . 601lsfiles . . . . . . . . . . . . . . . . 602lshardware . . . . . . . . . . . . . . 603lsservicenodes . . . . . . . . . . . . . 605lsservicerecommendation . . . . . . . . . 606lsservicestatus . . . . . . . . . . . . . 607traceroute . . . . . . . . . . . . . . 611

    Capítulo 26. Comandos do Modo deServiço (Descontinuado) . . . . . . 613applysoftware (Descontinuado) . . . . . . . 613svcservicemodetask cleardumps (Descontinuado) 613svcservicemodetask dumperrlog (Descontinuado) 613exit (Descontinuado) . . . . . . . . . . . 613

    Índice vii

  • Capítulo 27. Comandos deInformações do Modo de Serviço(Descontinuado) . . . . . . . . . . 615ls2145dumps (Descontinuado) . . . . . . . . 615lscimomdumps (Descontinuado) . . . . . . . 615lsclustervpd (Descontinuado) . . . . . . . . 615lserrlogdumps (Descontinuado) . . . . . . . 615lsfeaturedumps (Descontinuado) . . . . . . . 615lsiostatsdumps (Descontinuado) . . . . . . . 615lsiotracedumps (Descontinuado) . . . . . . . 615lsmdiskdumps (Descontinuado) . . . . . . . 615lssoftwaredumps (Descontinuado) . . . . . . 615

    Capítulo 28. Comandos de Tarefa deServiço . . . . . . . . . . . . . . 617satask chbootdrive. . . . . . . . . . . . 617chnodeled . . . . . . . . . . . . . . 617chserviceip . . . . . . . . . . . . . . 619satask chvpd . . . . . . . . . . . . . 621chwwnn . . . . . . . . . . . . . . . 623cpfiles . . . . . . . . . . . . . . . . 624dumpinternallog (Descontinuado) . . . . . . 625installsoftware . . . . . . . . . . . . . 625leavecluster . . . . . . . . . . . . . . 626metadados . . . . . . . . . . . . . . 627(satask) mkcluster . . . . . . . . . . . . 628mkcluster (Descontinuado) . . . . . . . . . 629satask overridequorum . . . . . . . . . . 629rescuenode . . . . . . . . . . . . . . 630resetpassword . . . . . . . . . . . . . 630restartservice . . . . . . . . . . . . . 631(satask) setlocale . . . . . . . . . . . . 632setpacedccu . . . . . . . . . . . . . . 633settempsshkey . . . . . . . . . . . . . 633snap . . . . . . . . . . . . . . . . 634startservice . . . . . . . . . . . . . . 635stopnode . . . . . . . . . . . . . . . 636stopservice . . . . . . . . . . . . . . 636t3recovery . . . . . . . . . . . . . . 637

    Capítulo 29. Comandos deGerenciamento de Usuários . . . . . 639chauthservice . . . . . . . . . . . . . 639chcurrentuser . . . . . . . . . . . . . 641chldap. . . . . . . . . . . . . . . . 642chldapserver . . . . . . . . . . . . . 645chuser . . . . . . . . . . . . . . . . 647chusergrp . . . . . . . . . . . . . . 648lscurrentuser . . . . . . . . . . . . . 648lsldap . . . . . . . . . . . . . . . . 649lsldapserver . . . . . . . . . . . . . . 650lsuser . . . . . . . . . . . . . . . . 652lsusergrp . . . . . . . . . . . . . . . 653mkldapserver . . . . . . . . . . . . . 655mkuser . . . . . . . . . . . . . . . 656mkusergrp . . . . . . . . . . . . . . 657rmldapserver . . . . . . . . . . . . . 660rmuser . . . . . . . . . . . . . . . 660rmusergrp . . . . . . . . . . . . . . 661testldapserver . . . . . . . . . . . . . 662

    Capítulo 30. Comandos de volume 665addvolumecopy . . . . . . . . . . . . 665addvdiskcopy . . . . . . . . . . . . . 667addvdiskaccess . . . . . . . . . . . . . 674analyzevdisk . . . . . . . . . . . . . 675analyzevdiskbysystem . . . . . . . . . . 676backupvolume . . . . . . . . . . . . . 676backupvolumegroup . . . . . . . . . . . 678chvdisk . . . . . . . . . . . . . . . 679chvolumegroup. . . . . . . . . . . . . 683expandvdisksize . . . . . . . . . . . . 684lsdependentvdisks. . . . . . . . . . . . 686lshostvdiskmap. . . . . . . . . . . . . 687lsmetadatavdisk . . . . . . . . . . . . 690lsrepairsevdiskcopyprogress . . . . . . . . 691lsrepairvdiskcopyprogress . . . . . . . . . 692lssevdiskcopy . . . . . . . . . . . . . 694lsvdisk . . . . . . . . . . . . . . . 700lsvdiskaccess . . . . . . . . . . . . . 714lsvdiskanalysis . . . . . . . . . . . . . 716lsvdiskanalysisprogress . . . . . . . . . . 719lsvdiskcopy . . . . . . . . . . . . . . 720lsvdiskdependentmaps . . . . . . . . . . 726lsvdiskextent . . . . . . . . . . . . . 727lsvdiskfcmapcopies . . . . . . . . . . . 728lsvdiskfcmappings. . . . . . . . . . . . 729lsvdiskhostmap. . . . . . . . . . . . . 730lsvdisklba . . . . . . . . . . . . . . 731lsvdiskmember . . . . . . . . . . . . . 733lsvdiskprogress . . . . . . . . . . . . . 734lsvdisksyncprogress . . . . . . . . . . . 735lsvolumebackup . . . . . . . . . . . . 737lsvolumebackupgeneration . . . . . . . . . 739lsvolumebackupprogress . . . . . . . . . 741lsvolumegroup . . . . . . . . . . . . . 743lsvolumerestoreprogress . . . . . . . . . . 745mkmetadatavdisk . . . . . . . . . . . . 747mkvdisk . . . . . . . . . . . . . . . 748mkvdiskhostmap . . . . . . . . . . . . 758mkvolume . . . . . . . . . . . . . . 760mkvolumegroup . . . . . . . . . . . . 763mkimagevolume . . . . . . . . . . . . 764movevdisk . . . . . . . . . . . . . . 766recovervdisk. . . . . . . . . . . . . . 768recovervdiskbycluster (Descontinuado) . . . . . 769recovervdiskbyiogrp . . . . . . . . . . . 769recovervdiskbysystem . . . . . . . . . . 770repairsevdiskcopy . . . . . . . . . . . . 770repairvdiskcopy . . . . . . . . . . . . 771restorevolume . . . . . . . . . . . . . 772rmvdisk . . . . . . . . . . . . . . . 774rmmetadatavdisk . . . . . . . . . . . . 777rmvdiskcopy . . . . . . . . . . . . . 777rmvdiskaccess . . . . . . . . . . . . . 778rmvdiskhostmap . . . . . . . . . . . . 779rmvolumegroup . . . . . . . . . . . . 780rmvolumebackupgeneration . . . . . . . . 780shrinkvdisksize . . . . . . . . . . . . . 781rmvolume . . . . . . . . . . . . . . 783rmvolumecopy . . . . . . . . . . . . . 785splitvdiskcopy . . . . . . . . . . . . . 787

    viii Spectrum Virtualize for SAN Volume Controller and Storwize Family: Guia do Usuário da Interface de Linha de Comandos

  • Capítulo 31. Mensagens da Interfaceda Linha de Comandos . . . . . . . 791

    Apêndice. Recursos de acessibilidadedo SAN Volume Controller . . . . . . 967

    Avisos . . . . . . . . . . . . . . 969Marcas Registradas . . . . . . . . . . . 971

    Índice Remissivo . . . . . . . . . . 973

    Índice ix

  • x Spectrum Virtualize for SAN Volume Controller and Storwize Family: Guia do Usuário da Interface de Linha de Comandos

  • Tabelas

    1. Websites do IBM para Ajuda, Serviços eInformações . . . . . . . . . . . . xiv

    2. Biblioteca do SAN Volume Controller xiv3. Documentação do IBM e Web Sites

    Relacionados . . . . . . . . . . . . xv4. Diagramas de Sintaxe . . . . . . . . . xvi5. Abreviações . . . . . . . . . . . . xvii6. Tipos de Dados . . . . . . . . . . . xx7. Indicadores de capacidade . . . . . . xxviii8. Comandos do UNIX para sessões SSH

    interativas . . . . . . . . . . . . . 99. Capacidade Máxima de Volume por Tamanho

    da Extensão . . . . . . . . . . . . 2510. Exemplos de memória necessária . . . . . 2911. Comparações de níveis de RAID . . . . . 2912. Volume Ressincronização das Cópias de 3213. Opções de Combinação de charraymember 9614. Saída da matriz . . . . . . . . . . . 9915. Saída de lsarrayinitprogress . . . . . . . 10516. Saída lsarraylba . . . . . . . . . . . 10617. Saída de lsarraymember . . . . . . . . 10818. Saída de lsarraymembergoals . . . . . . 11219. Saída lsarraymemberprogress . . . . . . 11420. saída de lsarrayrecommendation . . . . . 11721. Saída de lsarraysyncprogress . . . . . . 11922. saída de lspotentialarraysize . . . . . . 12123. Saída lscloudaccountusage . . . . . . . 15024. Saída lscloudaccountimportcandidate 15125. Memória necessária para matrizes do RAID,

    Copy Services e espelhamento de volume . . 17226. Comparações de níveis de RAID . . . . . 17327. Número de Extensões Reservadas por

    Tamanho da Extensão. . . . . . . . . 18028. Formatos de Lista de Endereços IP . . . . 19429. Saída de lsfcportcandidate . . . . . . . 20730. Saída lsiscsistorageport . . . . . . . . 20831. Saída lsiscsistorageportcandidate . . . . . 21132. Valores de Atributo lsnode ou lsnodecanister 21933. Valores de atributo lsnodebattery . . . . . 22234. Saídas de lsnodecandidate . . . . . . . 22635. Valores de Atributo para lsnodehw e

    lsnodecanisterhw . . . . . . . . . . 22736. Valores de Atributo para o lsnodestats ou

    lsnodecanister . . . . . . . . . . . 22937. Valores do campo Stat_name . . . . . . 23138. Valores de atributo para lsnodevpd e

    lsnodecanistervpd . . . . . . . . . . 23739. Saída de lsportusb . . . . . . . . . . 24540. Saída lsportip . . . . . . . . . . . 24841. Saída lsportfc . . . . . . . . . . . 25542. Saída lsportsas . . . . . . . . . . . 25843. Saída lsquorum . . . . . . . . . . . 26044. Saída de lssasportcandidate . . . . . . . 26345. Valor de atributo do lssecurity . . . . . . 26446. Valores do Atributo lssite . . . . . . . 26547. Saída lsthrottle . . . . . . . . . . . 267

    48. Saída lssystem . . . . . . . . . . . 26849. Saída lssystemcert . . . . . . . . . . 27550. saída lssystemip . . . . . . . . . . 27851. valores de atributo lssystemstats . . . . . 28052. Valores do campo Stat_name . . . . . . 28153. Saída lstargetportfc . . . . . . . . . 28554. Saída lsdnsserver . . . . . . . . . . 31055. Saída lseventlog. . . . . . . . . . . 31356. Saída lsservicestatus . . . . . . . . . 31857. Saída lssyslogserver . . . . . . . . . 32358. Saída de lscontroller . . . . . . . . . 33659. Saída de lsdrive. . . . . . . . . . . 34760. Saída lsdriveclass . . . . . . . . . . 35261. Saída de lsdrivelba. . . . . . . . . . 35462. Saída de lsenclosure . . . . . . . . . 38563. Saídas de lsenclosurebattery . . . . . . 38864. Valores do Atributo

    lscontrolenclosurecandidate . . . . . . . 39065. Saída de lsenclosurecanister. . . . . . . 39166. Saídas de lsenclosurechassis. . . . . . . 39467. Saída lsenclosuredrawer . . . . . . . . 39668. ? saída . . . . . . . . . . . . . . 39869. Valores de atributo lsenclosurefanmodule 39970. Saída de lsenclosurepsu . . . . . . . . 40171. lsenclosuresem output . . . . . . . . 40472. Saída de lsenclosureslot . . . . . . . . 40673. Saídas de lsenclosurestats . . . . . . . 40974. Valores do campo Stat_name . . . . . . 41175. Saída de lssasfabric . . . . . . . . . 41276. Saída lsencryption . . . . . . . . . . 42077. Saídas de lsfeature . . . . . . . . . . 42778. Saída lslicense . . . . . . . . . . . 43079. Relacionamento entre os valores de taxa de

    limpeza, taxa de dados e granularidades porsegundo . . . . . . . . . . . . . 435

    80. Relacionamento entre os valores de taxa delimpeza, taxa de dados e granularidades porsegundo . . . . . . . . . . . . . 448

    81. Saída de lshost . . . . . . . . . . . 47082. Saída lshostcluster . . . . . . . . . . 47283. Saída lshostclustermember . . . . . . . 47384. Saída lshostclustervolumemap . . . . . . 47585. Saída lskeyserver . . . . . . . . . . 49586. Saída lskeyserverisklm . . . . . . . . 49787. Saídas de lslivedump . . . . . . . . . 50288. Saída do MDisk. . . . . . . . . . . 51489. Saída do Comando lsmdisklba . . . . . . 52090. Diferenças de Parâmetro para Conjuntos-filho

    e Conjuntos-pai . . . . . . . . . . . 52891. Diferenças de parâmetro para conjuntos-filhos

    e conjuntos de armazenamento . . . . . 53992. valores de atributo lspartnership . . . . . 55593. Valores de Saída do Comando lsrcconsistgrp 56094. Atributos e Valores do Comando

    lsrcrelationship . . . . . . . . . . 56495. stoprcconsistgrp consistency group states 585

    © Copyright IBM Corp. 2003, 2016 xi

  • 96. Estados do Grupo de Consistênciasstoprcrelationship . . . . . . . . . 588

    97. Valores de atributo lsbootdrive. . . . . . 60098. Valores do Atributos lshardware . . . . . 60499. Saídas lsservicenodes . . . . . . . . . 605

    100. Saída lsservicestatus . . . . . . . . . 607101. Valores do Atributo lsldap . . . . . . . 650102. Valores do Atributo lsldapserver . . . . . 651103. Valores do Atributo testldapserver . . . . 663104. Configurações do Easy Tier para o Conjunto

    de Armazenamento . . . . . . . . . 670105. Relacionamento entre o valor syncrate e os

    dados copiados por segundo . . . . . . 673106. Relacionamento entre o valor syncrate e os

    dados copiados por segundo . . . . . . 682

    107. saída lsmetadatavdisk. . . . . . . . . 690108. Valores de status de Easy Tier . . . . . . 706109. Saída lsvdiskanalysis . . . . . . . . . 717110. Saída lsvdiskanalysisprogress . . . . . . 719111. Cenários de Saída do Comando lsvdisklba 732112. Saída lsvolumebackup . . . . . . . . 738113. Saída lsvolumebackupgeneration . . . . . 740114. Saída lsvolumebackupprogress. . . . . . 742115. Saída lsvolumegroup . . . . . . . . . 744116. Saída lsvolumerestoreprogress . . . . . . 746117. Relacionamento entre o valor syncrate e os

    dados copiados por segundo . . . . . . 756118. Formatos de endereços IP aceitos . . . . . 936

    xii Spectrum Virtualize for SAN Volume Controller and Storwize Family: Guia do Usuário da Interface de Linha de Comandos

  • Sobre este Manual

    Esta publicação fornece informações que ajudam a configurar e usar o IBM® System Storage SAN VolumeController e o IBM Storwize V7000.

    Quem Deve Usar Este GuiaEste guia é destinado a administradores ou outros que instalam e usam o SAN Volume Controllerou oStorwize V7000.

    Antes de usar o SAN Volume Controller, você deve conhecer as redes de áreas de armazenamento(SANs), os requisitos de armazenamento de sua empresa e os recursos de suas unidades dearmazenamento.

    AcessibilidadeA IBM se esforça para fornecer produtos com acesso utilizável para todos, independentemente da idadeou capacidade.

    Este produto usa as teclas de navegação padrão do Windows.

    Para obter mais informações, consulte o tópico sobre recursos de acessibilidade na seção Referência.

    ÊnfaseSão usados diferentes fontes neste guia para mostrar ênfase.

    Os seguintes fontes são usados para mostrar ênfase:

    Negrito O texto em negrito representa itens de menu.

    Negrito com monoespaçamento O texto em negrito com monoespaçamento representanomes de comandos.

    Itálico O texto em itálico é utilizado para enfatizar uma palavra.Na sintaxe de comando, ele é utilizado para variáveispara as quais você fornece valores reais, como umdiretório padrão ou o nome de um sistema.

    Monoespaçamento O texto em monoespaçamento identifica os dados oucomandos digitados, amostras de saída de comando,exemplos de código do programa ou mensagens dosistema, ou nomes de sinalizadores de comando,parâmetros, argumentos e pares nome-valor.

    Biblioteca do SAN Volume Controller e Publicações RelacionadasManuais de produto, outras publicações e Web sites contêm informações que se relacionam a SANVolume Controller.

    © Copyright IBM Corp. 2003, 2016 xiii

  • IBM Knowledge Center for SAN Volume Controller

    A coleta de informações no IBM Knowledge Center contém todas as informações necessárias parainstalar, configurar e gerenciar o sistema. A coleção de informações no IBM Knowledge Center éatualizada entre as liberações do produto para fornecer a documentação mais atual. A coleção deinformações está disponível no website a seguir:

    http://www.ibm.com/support/knowledgecenter/STPVGU

    Biblioteca do SAN Volume Controller

    A menos que seja notado de outra maneira, as publicações na biblioteca estão disponíveis em AdobePortable Document Format (PDF) de um website.

    www.ibm.com/e-business/linkweb/publications/servlet/pbi.wss

    Clique em Procurar por publicações para localizar as publicações on-line de seu interesse e visualize oufaça o download da publicação, clicando o item apropriado.

    Tabela 1 lista websites nos quais é possível localizar ajuda, serviços e mais informações

    Tabela 1. Websites do IBM para Ajuda, Serviços e Informações

    Website Endereço

    Diretório de contatos em todo o mundo http://www.ibm.com/planetwide

    Suporte para SAN Volume Controller (2145) www.ibm.com/storage/support/2145

    Suporte para produtos IBM System Storage e IBM TotalStorage www.ibm.com/storage/support/

    Cada publicação em PDF na biblioteca do Tabela 2 também está disponível no IBM Knowledge Centerclicando no número na coluna “Número da ordem”:

    Tabela 2. Biblioteca do SAN Volume Controller

    Título Descrição Número de pedido

    IBM SAN Volume Controller Model2145-SV1 Hardware Installation Guide

    O guia fornece as instruções que oRepresentante de serviços IBM usapara instalar o hardware para SANVolume Controller, modelo 2145-SV1.

    GI13-4547

    IBM SAN Volume Controller HardwareMaintenance Guide

    O guia fornece as instruções que oRepresentante de serviços IBM usapara servir o hardware do SANVolume Controller, incluindo aremoção e a substituição de peças.

    GC27-2283

    Guia de resolução de problemas do IBMSAN Volume Controller

    O guia descreve os recursos de cadamodelo do SAN Volume Controller,explica como usar o painel frontal oua GUI do assistente de serviço efornece os procedimentos de análisede manutenção para ajudar adiagnosticar e resolver problemascom o SAN Volume Controller.

    GC27-2284

    IBM System Storage SAN VolumeController and IBM Storwize V7000Command-Line Interface User's Guide

    O guia descreve os comandos quevocê pode usar da interface da linhade comandos (CLI) do SAN VolumeController.

    GC43-1488-12

    xiv Spectrum Virtualize for SAN Volume Controller and Storwize Family: Guia do Usuário da Interface de Linha de Comandos

    http://www.ibm.com/support/knowledgecenter/STPVGUhttp://www.ibm.com/e-business/linkweb/publications/servlet/pbi.wsshttp://www.ibm.com/planetwidehttp://www.ibm.com/storage/support/2145http://www.ibm.com/storage/support/2145http://www.ibm.com/storage/support/

  • Documentação do IBM e Web Sites Relacionados

    Tabela 3 lista Web sites que fornecem publicações e outras informações sobre o SAN Volume Controllerou produtos ou tecnologias relacionados(as). As publicações do IBM Redbooks fornecem orientação deposicionamento e valor, experiências de instalação e implementação, cenários de solução e procedimentospasso a passo para vários produtos.

    Tabela 3. Documentação do IBM e Web Sites Relacionados

    Website Endereço

    Centro de Publicações IBM www.ibm.com/e-business/linkweb/publications/servlet/pbi.wss

    Publicações IBM Redbooks www.redbooks.ibm.com/

    Informações de Acessibilidade Relacionadas

    Para visualizar um arquivo PDF, é necessário ter o Adobe Reader, que pode ser transferido por downloada partir do site da Adobe:

    www.adobe.com/support/downloads/main.html

    Como Solicitar Publicações IBMO Centro de Publicações IBM é um repositório central global para publicações e materiais de marketingdo produto IBM.

    O Centro de Publicações IBM oferece funções de procura customizadas para ajudá-lo a encontrar aspublicações que precisar. Algumas publicações estão disponíveis para visualização ou download semencargos. Também é possível solicitar publicações. O centro de publicações exibe preços em sua moedalocal. É possível acessar o Centro de Publicações IBM através do seguinte Web site:

    www.ibm.com/e-business/linkweb/publications/servlet/pbi.wss

    Enviando Seus ComentáriosSeu feedback é importante para ajudar a fornecer informações mais precisas e de mais alta qualidade.

    Para enviar comentários sobre este manual ou sobre qualquer outra documentação do SAN VolumeController:v Acesse a página de feedback no Web site do Centro de Informações do SAN Volume Controller em

    publib.boulder.ibm.com/infocenter/svc/ic/index.jsp?topic=/com.ibm.storage.svc.console.doc/feedback.htm. Lá, é possível usar a página de feedback para inserir e enviar comentários ou navegarno tópico e usar o link de feedback no rodapé em execução dessa página para identificar o tópico parao qual você tem um comentário.

    v Envie seus comentários por email para [email protected]. Inclua as informações a seguir para essapublicação ou use substituições adequadas para o título da publicação e o número do formulário paraa publicação na qual você está colocando comentário:– Título da publicação: IBM System Storage SAN Volume Controller and IBM Storwize V7000

    Command-Line Interface User's Guide

    – Número do formulário de publicação: GC43-1488-12-01– Página, tabela ou números de ilustração sobre os quais você está comentando– Uma descrição detalhada de qualquer informação que deve ser alterada

    Sobre este Manual xv

    http://www.ibm.com/e-business/linkweb/publications/servlet/pbi.wsshttp://www.redbooks.ibm.com/http://www.adobe.com/support/downloads/main.htmlhttp://www.ibm.com/e-business/linkweb/publications/servlet/pbi.wsshttp://publib.boulder.ibm.com/infocenter/svc/ic/index.jsp?topic=/com.ibm.storage.svc.console.doc/feedback.htmhttp://publib.boulder.ibm.com/infocenter/svc/ic/index.jsp?topic=/com.ibm.storage.svc.console.doc/feedback.htmmailto:[email protected]?subject=SAN%20Volume%20Controller%20and%20Storwize%20V7000%20Command-Line%20Interface%20User's%20Guide%20(GC27-2287-02)

  • Diagramas de SintaxeUm diagrama de sintaxe usa símbolos para representar os elementos de um comando e para especificaras regras para o uso desses elementos.

    Tabela 4 explica como ler os diagramas de sintaxe que representam os comandos da interface de linha decomandos (CLI). Com isso, ela define os símbolos que representam os elementos do comando da CLI.

    Tabela 4. Diagramas de Sintaxe

    Elemento Sintaxe Descrição

    Linha do caminhoprincipal

    >>>() () () >>Começa à esquerda com duaspontas de seta()>< e termina àdireita com duas pontas de seta,uma de frente para outra (). Se umdiagrama for mais longo que umalinha, cada linha a ser continuadaterminará com uma única> ponta deseta () e a linha seguinte começarácom uma única ponta de seta. Leiaos diagramas da esquerda paradireita, de cima para baixo, seguindoa linha do caminho principal.

    Palavra-chave►► esscli ►◄

    Representa o nome de um comando,sinalizador, parâmetro ouargumento. Uma palavra-chave nãoé colocada em itálico. Apalavra-chave deve ser digitadaexatamente como mostrada nodiagrama de sintaxe.

    Palavras-chaveobrigatórias ►► a AccessFile

    u Useridp Password

    ►◄Indicam os parâmetros ouargumentos que devem serespecificados para o comando. Aspalavras-chave obrigatóriasaparecem na linha do caminhoprincipal. Palavras-chave que nãopodem ser usadas juntas sãoempilhadas verticalmente.

    Palavras-chaveOpcionais ►►

    h-help?

    ►◄Indicam os parâmetros ouargumentos que você pode escolherespecificar para o comando. Aspalavras-chave opcionais aparecemabaixo da linha do caminhoprincipal. Palavras-chave opcionaismutuamente exclusivas sãoempilhadas verticalmente.

    Valor padrão

    ►►FCP

    protocol = FICON ►◄

    Aparecem acima da linha docaminho principal.

    Palavra-chave ouvalor Repetidos ►► newports = ALL

    PortId1,PortId2,...►◄

    Representa um parâmetro ouargumento que pode serespecificado mais de uma vez. Umapalavra-chave ou valor repetível érepresentada por uma setaretornando para a esquerda acima àesquerda da palavra-chave ou valor.

    xvi Spectrum Virtualize for SAN Volume Controller and Storwize Family: Guia do Usuário da Interface de Linha de Comandos

  • Tabela 4. Diagramas de Sintaxe (continuação)

    Elemento Sintaxe Descrição

    Variável►► AccessFile ►◄

    Representa o valor que deve serfornecido para um parâmetro ouargumento, como um nome dearquivo, um nome de usuário ouuma senha. As variáveis sãomostradas em itálico.

    Separador de espaço►► u Userid p Password ►◄

    Inclui um espaço em branco na linhado caminho principal para separarelementos como palavras-chave,parâmetros, argumentos ou variáveisuns dos outros.

    Delimitadores deAspas ►► d " ess = EssId host = ►

    ► 'Host Name' perfil = ProfileName ►

    ► " ►◄

    Indicam o começo e o final de umparâmetro ou argumento quecontém diversos valores. Coloqueum ou mais pares de nome-valorentre um conjunto de aspas duplaspara determinado parâmetro ouargumento. Se o valor de umparâmetro ou par de nome-valorcontiver um espaço vazio ou embranco, coloque todo o valor entreum conjunto de aspas simples.

    Operador de sinal deigual ►► " ess = EssId perfil = ►

    ► ProfileName " ►◄

    Separa um nome de seu valor emum par de nome-valor.

    Fragmento de sintaxe►► Fragment Name ►◄

    Nome do Fragmento:

    ( fragment details )

    Divide diagramas de sintaxe que sãomuito longos, muito complexos ourepetitivos. O nome do fragmento éinserido no diagrama principal e ofragmento real é mostrado abaixo dodiagrama principal.

    TerminologiaEssas são abreviações que são usadas mais comumente para as operações da interface da linha decomandos (CLI).

    O Tabela 5 mostra as abreviações e oferece uma breve descrição.

    Tabela 5. Abreviações

    Nome Tipo de objeto

    Host Refere-se a um host único

    Cluster do host Refere-se a um cluster do host (que faz parte deservidores que compartilham um conjunto de volumes)

    Objeto do host Refere-se a uma lista de nomes da porta universal(WWPNs) e nomes iSCSI

    Cópia de volume Referida como vdiskcopy

    Cópia de volume thin-provisioned Referida como sevdiskcopy

    Disco gerenciado Referido como MDisk

    Sobre este Manual xvii

  • Tabela 5. Abreviações (continuação)

    Nome Tipo de objeto

    Grupo de MDisk ou conjunto de armazenamentos Referido como conjunto de armazenamentos

    Grupo de E/S Referido como iogrp

    Nó, caixa do nó, gabinete Refere-se a nó, caixa do nó ou gabinete, dependendo dosistema

    Sistema em cluster (sistema) ou cluster Referido como sistema

    VDisk ou volume Referido como volume

    Controlador Referido como controlador que faz parte de um sistemaem cluster

    Mapeamento IBM FlashCopy Referida como fcmap

    Grupo de consistências do IBM FlashCopy Referido como fcconsistgrp

    Relacionamento do Metro Mirror ou do Global Mirror Referido como rcrelationship

    Grupo de consistências do Metro Mirror ou do GlobalMirror

    Referido como rcconsistgrp

    Grupo de consistências de espelhamento do IBMHyperSwap

    Referido como hyperswap

    Objeto não suportado/desconhecido unknown

    Caracteres Especiais da CLIOs caracteres especiais a seguir são usados nos exemplos de comandos da interface de linha de comandos(CLI).

    sinal de menos (-)Sinalizadores são prefixados com um sinal - (menos). Os sinalizadores definem a ação de umcomando ou modificam a operação de um comando. Ao emitir um comando, é possível usardiversos sinalizadores, seguidos por parâmetros. O caractere - não pode ser usado como oprimeiro caractere de um nome de objeto.

    barra vertical (|)Uma barra vertical significa que apenas um valor é escolhido. Por exemplo, [ a | b ] entrecolchetes indica que é possível escolher a, b ou nada. Da mesma forma, { a | b } entre chavesindica que você deve escolher a ou b.

    delimitadores (: ou ou !)Delimitadores são usados para delimitar itens listados após emitir um comando de informações.v Dois-pontos (:) é usado para delimitar itens em uma lista em um comando (por exemplo

    mkhost -name myhost -hbawwpn AA22000011112222:AA22000011112223).v Vírgula (,) será usada para delimitar itens em uma lista em um comando, se os valores do

    item puderem conter uma vírgula.v Ponto de exclamação (!) será usado para delimitar itens em um comando, se os valores do

    item puderem conter dois-pontos ou uma vírgula. Pontos de exclamação geralmente nãoaparecem na saída de exemplo e são um bom delimitador a ser usado.

    Usando curingas no CLIÉ possível usar curingas na interface da linha de comandos (CLI) do SAN Volume Controller.

    A página A CLI suporta o uso do caractere asterisco (*) como um curinga nos argumentos dedeterminados parâmetros. Existem alguns problemas comportamentais que devem ser considerados aousar curingas, para evitar resultados inesperados. Esses problemas comportamentais e as maneiras deevitá-los são as seguintes:

    xviii Spectrum Virtualize for SAN Volume Controller and Storwize Family: Guia do Usuário da Interface de Linha deComandos

  • 1. Execução do comando com login efetuado no nó.O shell tentará interpretar qualquer um dos caracteres especiais se eles não forem de escape(precedidos por um caractere de barra invertida). Os curingas serão expandidos em uma lista dearquivos se houver arquivos que correspondem aos curingas. Se não existirem arquivoscorrespondentes, o curinga será passado para o comando do SAN Volume Controller intacto.Para evitar a expansão, emita o seguinte comando em um de seus formatos:

    cleardumps -prefix '/dumps/*.txt' com aspassimples(’’), ou

    cleardumps -prefix /dumps/\*.txt usando uma barra invertida(\) ou

    cleardumps -prefix "/dumps/*.txt" com aspas duplas("").

    2. Execução do comando por meio de Secure Shell (SSH), por exemplo, a partir de um host.Esse método é um pouco mais complicado, porque o shell do host processa a linha de comandosantes de ela ser passada pelo SSH para o shell do sistema em cluster (sistem). Isso significa que énecessária uma camada extra de proteção cercando o curinga, uma vez que o shell do host irá tirar asaspas protetoras e a exposição do curinga ao shell do sistema resultará na expansão do curinga noshell do sistema.Para evitar a expansão, emita o seguinte comando em um de seus formatos:

    cleardumps"'/dumps/*.txt'" com aspas simples (’’)dentro de aspas duplas (""), ou

    cleardumps '/dumps/\*.txt' usando uma barra invertida(\) dentro deaspas simples (’’), ou

    cleardumps '"/dumps/*.txt"' com aspas duplas ("")dentro de aspas simples (’’).

    Tipos de Dados e Intervalos de ValoresO comprimento máximo de qualquer parâmetro único inserido na linha de comandos é de 2176 bytes.

    Nota: Ao criar um novo objeto, o sistema em cluster (sistema) designará um nome -type padrão senenhum estiver especificado. O nome -type padrão consiste no prefixo do objeto e no número inteiromais baixo disponível iniciando a partir de 0 (exceto para nós que iniciam a partir de 1); por exemplo,vdisk23; o nome -type padrão deve ser exclusivo.

    Tabela 6 na página xx lista os tipos de dados e as faixas de valor para cada.

    Sobre este Manual xix

  • Tabela 6. Tipos de Dados

    Tipos de Dados Intervalos de Valores

    filename_arg Este é um nome de arquivo (opcionalmente completo), que contém no máximo 169caracteres. Os caracteres válidos são:

    v . (ponto; o campo não deve iniciar ou terminar, nem conter, dois pontosconsecutivos)

    v / (forward slash)v - (hyphen)v _ (underscore)v a–z (letras minúsculas, A a Z)v A–Z (letras maiúsculas, A a Z)v 0–9 (numerais de 0 a 9)

    directory_or_file_filter Especifica um diretório, um filtro de nomes de arquivo ou ambos, dentro dodiretório especificado. Os valores de diretório válidos são:

    v /dumpsv /dumps/auditv /dumps/configsv /dumps/elogsv /dumps/featurev /dumps/iostatsv /dumps/iotracev /dumps/software

    O filtro de nomes de arquivo pode ser qualquer nome de arquivo válido, contendoum máximo de 128 caracteres, com ou sem o “*” (curinga) e anexado ao final de umvalor de diretório. Os caracteres válidos são:

    v * (asterisk/wildcard)v . (o campo não deve iniciar ou terminar, nem conter, dois pontos consecutivos)v /v -v _v a–zv A–Zv 0–9

    filename_prefix O prefixo de um nome de arquivo que contém no máximo 128 caracteres. Oscaracteres válidos são:

    v -v _v a–zv A–Zv 0–9

    xx Spectrum Virtualize for SAN Volume Controller and Storwize Family: Guia do Usuário da Interface de Linha de Comandos

  • Tabela 6. Tipos de Dados (continuação)

    Tipos de Dados Intervalos de Valores

    name_arg Os nomes podem ser especificados ou alterados usando as funções criar e modificar.Os comandos de visualização fornecem o nome e o ID de um objeto.Nota: O nome do sistema é configurado quando o sistema é criado.

    O primeiro caractere de um name_arg deve ser numérico. O primeiro caractere deum nome de objeto não pode ser um – (hífen) porque a interface da linha decomandos (CLI) interpreta isso como sendo o próximo parâmetro.

    Os caracteres válidos são:

    v . (um ponto - o campo não deve iniciar ou terminar, nem conter dois pontosconsecutivos)

    v /v -v _v espaçov a a zv A a Zv 0 a 9

    password Esta é uma senha definida pelo usuário contendo no máximo 15 caracteres. Oscaracteres válidos são:

    v - (não pode ser usado como o primeiro caractere)v _v a–zv A–Zv 0–9

    serial_number O formato deste número está em conformidade com o padrão de números de sérieda IBM C-S 1-1121-018 1999-06 para produtos IBM. O número de série possui 7dígitos, em que os dois primeiros definem o local de fabricação e os 5 dígitosrestantes definem o produto.

    O padrão define uma maneira de estender o número de série usando letras no lugarde números no campo de 5 dígitos.

    ip_address_arg O argumento segue as regras padrão para notação decimal com ponto.

    Os seguintes formatos de endereço protocolo da Internet 4 (IPv4) e protocolo daInternet 6 (IPv6) são suportados:

    IPv4 (nenhuma porta configurada, o SAN Volume Controller usa o padrão)1.2.3.4

    IPv4 com porta específica1.2.3.4:22

    IPv6 completo, porta padrão1234:1234:0001:0123:1234:1234:1234:1234

    IPv6 completo, porta padrão, zeros à esquerda suprimidos1234:1234:1:123:1234:1234:1234:1234

    IPv6 completo, com porta[2002:914:fc12:848:209:6bff:fe8c:4ff6]:23

    IPv6 com zero compactado, porta padrão2002::4ff6

    IPv6 com zero compactado, com porta[2002::4ff6]:23

    Sobre este Manual xxi

  • Tabela 6. Tipos de Dados (continuação)

    Tipos de Dados Intervalos de Valores

    dns_name Este é o nome de domínio com ponto para o sistema sub-rede (por exemplo,ibm.com).

    hostname O nome do host designado ao sistema . Esse nome pode ser diferente do nome dosistema e é modificável.

    Uma combinação do nome do host e do dns_name é usada para acessar o sistema ,por exemplo: https://hostname.ibm.com/

    capacity_value A capacidade expressa em um intervalo de 512 bytes a 2 petabytes (PB).Dica: Especifique a capacidade como megabytes (MB), kilobytes (KB), gigabytes(GB) ou petabytes PB. Ao usar MB, especifique o valor em múltiplos de 512 bytes.Uma capacidade igual a 0 é válida para um volume dividido ou sequencial. Omenor número de bytes suportados é 512.

    node_id Um ID de nó é diferente de outros IDs que é um ID exclusivo designado quandoum nó é usado para criar um sistema ou quando um nó é incluído em um sistema .Um valor de node_id nunca é reutilizado em um sistema.

    Os IDs de nó são internamente representados como números de 64 bits e, assimcomo outros IDs, eles não podem ser modificados por comandos do usuário.

    xxx_id Todos os objetos são encaminhados pelos IDs de número inteiro exclusivos,designados pelo sistema quando os objetos são criados. Todos os IDs sãorepresentados internamente como números inteiros de 32 bits; os IDs de nó são umaexceção.

    Os IDs nos seguintes intervalos identificam os vários tipos de objetos:

    v node_id: Um número inteiro decimal positivo maior ou igual a 1v mdisk_grp_id: 0–127v io_grp_id: 0–3 (Consulte Nota).v mdisk_id: 0–4095v vdisk_id: 0–8191v copy_id: 0–1v host_id: 0–1023v flash_const_grp_id: 0–255v remote_const_grp_id: 0–255v fcmap_id: 0–4095v rcrel_id: 0–8191v controller_id: 0–63

    Nota: O io_group 4 existe, mas é usado apenas em determinados procedimentos derecuperação de erro.

    Esses IDs, como os IDs de nó, não podem ser modificados por comandos dousuário.Nota: Os IDs são designados no tempo de execução pelo sistema e não podem serdesignados os mesmos após, por exemplo, a restauração da configuração. Use nomesde objeto em preferência aos IDs ao trabalhar com objetos.

    xxx_list Uma lista de valores do tipo xxx delimitada por dois pontos.

    wwpn_arg O Fibre Channel nome da porta universal (WWPN), expresso como um númerohexadecimal de 64-bit e consistindo dos caracteres 0-9, a-f e A-F; por exemplo:1A2B30C67AFFE47B.Nota: A inserção de WWPN 0 na sequência de caracteres de comandos causa umafalha de comando.

    xxii Spectrum Virtualize for SAN Volume Controller and Storwize Family: Guia do Usuário da Interface de Linha de Comandos

  • Tabela 6. Tipos de Dados (continuação)

    Tipos de Dados Intervalos de Valores

    panel_name Esta é uma sequência de até seis caracteres correspondente ao número da etiquetaimpressa logo abaixo da exibição no painel frontal de um nó no sistema .

    sequence_number Um número inteiro não assinado de 32 bits, expresso no formato decimal.

    csi_num_arg Um número inteiro não assinado de 32 bits, expresso no formato decimal.

    percentage_arg Um número inteiro não assinado de 8 bits, expresso no formato decimal de 0 a 100.

    extent_arg Um número inteiro não assinado de 32 bits, expresso no formato decimal.

    num_extents_arg Um número inteiro não assinado de 32 bits, expresso no formato decimal.

    threads_arg Um número inteiro não assinado de 8 bits, expresso no formato decimal. Os valoresválidos são 1, 2, 3 ou 4.

    velocity_arg A velocidade da malha, em gigabytes por segundo (GBps). Os valores válidos são 1ou 2.

    timezone_arg O ID conforme detalhado na saída do comando lstimezones.

    timeout_arg O período de tempo limite do comando. Um número inteiro de 0 a 600 (segundos).

    stats_time_arg A frequência na qual as estatísticas são reunidas. Os valores válidos vão de 1 a 60minutos, em incrementos de 1 minuto.

    directory_arg Especifica um diretório, um filtro de nomes de arquivo ou ambos, dentro dodiretório especificado. Os valores de diretório válidos são:

    v /dumpsv /dumps/auditv /dumps/cimomv /dumps/configsv /dumps/elogsv /dumps/featurev /dumps/iostatsv /dumps/iotracev /home/admin/upgrade

    O filtro de nomes de arquivo pode ser qualquer nome de arquivo válido, contendoum máximo de 128 caracteres, com ou sem o curinga (*, um asterisco) e anexado aofinal de um valor de diretório. Os caracteres válidos são:

    v *v . (o campo não deve iniciar ou terminar, nem conter, dois pontos consecutivos)v /v -v _v a–zv A–Zv 0–9

    Sobre este Manual xxiii

  • Tabela 6. Tipos de Dados (continuação)

    Tipos de Dados Intervalos de Valores

    locale_arg A configuração de código de idioma do sistema . Os valores válidos são:

    v 0 en_US: Inglês americano (padrão)v 1 zh_CN: Chinês simplificadov 2 zh_TW: Chinês tradicionalv 3 ja_JP: Japonêsv 4 fr_FR: Francêsv 5 de_DE: Alemãov 6 it_IT: Italianov 7 es_ES: Espanhol

    key_arg Um identificador definido pelo usuário para uma chave de shell seguro (SSH),contendo no máximo 30 caracteres.

    user_arg Especifica o usuário: administrador ou serviço.

    copy_rate Um valor numérico de 0 a 100.

    copy_type Especifica o tipo de cópia Mirror: Metro ou Global.

    O número máximo de valores inseridos em uma lista separada por dois pontos é 128; exceder essenúmero máximo retorna um erro.

    Comandos e Parâmetros daCLIOs comandos e parâmetros da interface da linha de comandos (CLI) são representados no diagrama desintaxe.

    A interface de linha de comandos do SAN Volume Controller oferece conclusão de linha para a entradade comandos. A conclusão da linha de comandos permite digitar os primeiros caracteres de um comandoe pressionar a tecla tab para preencher o resto do nome do comando. Se houver diversos comandosiniciados com os mesmos caracteres, será retornada uma lista de possíveis comandos. É possível digitarmais caracteres até que o nome do comando fique claro.

    Os parâmetros da CLI podem ser inseridos em qualquer ordem, exceto nas seguintes situações:v Quando um nome de comando é especificado, o primeiro argumento fornecido deve ser a ação que

    você deseja executar.v Onde você especificar um comando com relação a um objeto específico, o ID ou nome do objeto deve

    ser o último argumento na linha.

    Um parâmetro válido atende aos seguintes requisitos:v Os parâmetros podem ser inseridos em qualquer ordem.v Se um parâmetro tiver um argumento associado, o argumento deverá sempre seguir o parâmetro.v Um parâmetro deve iniciar com um '-'; caso contrário, ele será assumido como um argumento.v O comprimento máximo de qualquer parâmetro único que pode ser inserido na CLI é 128 bytes.v Um argumento pode conter diversos itens de dados. O número máximo de itens de dados que podem

    ser inseridos nessa lista é 128. Para uma lista de componentes, separe os itens individuais por doispontos.

    v Qualquer parâmetro com um argumento deve ser inserido como -parameter=argument.v A inserção de -param= significa que o argumento é uma sequência vazia, equivalente a -param.v O símbolo '--' é válido como a penúltima entrada na linha de comandos. Ele especifica que a próxima

    entrada é o nome ou ID do objeto de destino, mesmo que ele comece com um hífen.chuser -usergrp=-usergrp -- -password

    xxiv Spectrum Virtualize for SAN Volume Controller and Storwize Family: Guia do Usuário da Interface de Linha deComandos

  • v O símbolo '--' é válido como a palavra final na linha de comandos.

    Exemplos que são válidosmkuser -name fred -usergrp 0 -password bucketsmkuser -name fred -usergrp 0 -password=bucketsmkuser -name=-barney -usergrp=0 -password=buckets

    chuser -usergrp 1 fredchuser -usergrp 1 -- fredchuser -usergrp 1 -- -barney

    Exemplos que são inválidoschuser -usergrp 1 fred --chuser -usergrp 1 -- fred --chuser -- -usergrp 1 fredchuser -usergrp 1 -barney

    Sinalizadores da CLIOS sinalizadores a seguir são comuns a todos os comandos da interface da linha de comandos (CLI).

    -? or -hImpressão de texto de ajuda. Por exemplo, emitir lssystem -h fornece uma lista das açõesdisponíveis com o comando lssystem.

    -nomsgQuando utilizado, esse sinalizador impede a exibição da saída successfully created. Porexemplo, se você emitir o seguinte comando:

    mkmdiskgrp -ext 16

    ele exibe:

    MDisk Group, id [6], successfully created

    Entretanto, se o parâmetro -nomsg for incluído, por exemplo:

    mkmdiskgrp -ext 16 -nomsg

    as seguintes informações serão exibidas:

    6

    Esse parâmetro pode ser inserido para qualquer comando, mas atua apenas nos comandos quegeram as saídas successfully created. Todos os outros comandos ignorar esse parâmetro.

    Mensagens da CLICertifique-se de estar familiarizado com as mensagens da interface da linha de comandos (CLI).

    Quando alguns comandos são concluídos com êxito, normalmente uma saída textual é fornecida.Entretanto, alguns comandos não fornecem nenhuma saída. A frase No feedback é usada para indicar quenenhuma saída é fornecida. Se o comando não for concluído com êxito, um erro será gerado. Porexemplo, se o comando tiver falhado como resultado da instabilidade do cluster, a seguinte saída seráfornecida:v CMMVC5786E A ação falhou porque o cluster não está em um estado estável.

    Comandos CLI descontinuadosAlguns comandos da interface da linha de comandos (CLI) foram descontinuados e substituídos pornovos comandos.

    Sobre este Manual xxv

  • Os comandos da interface da linha de comandos (CLI) podem ser descontinuados e substituídos pornovos comandos que sejam mais eficazes. Esta ação pode afetar o script, que é feito para simplificartarefas, como a especificação de comandos (repetidos), por exemplo.

    Um comando descontinuado é removido da CLI e não pode mais ser usado. Na maioria das instâncias,há um comando de substituição para comandos descontinuados.

    Um comando descontinuado ainda poderá ser usado se o prefixo de comando apropriado forespecificado (svctask ou svcinfo, por exemplo). Na maioria das instâncias, há um comando desubstituição para comandos descontinuados.

    Os comandos a seguir foram descontinuados:v Estes comandos foram substituídos por lseventlog:

    – caterrlog– caterrlogbyseqnum– lserrlogbyfcconsistgrp– lserrlogbyfcmap– lserrlogbyhost– lserrlogbyiogrp– lserrlogbymdisk– lserrlogbymdiskgrp– lserrlogbynode– lserrlogbyrcconsistgrp– lserrlogbyrcrelationship– lserrlogbyvdisk

    v Estes comandos foram substituídos por lsdumps:– ls2145dumps– lsauditlogdumps– lserrlogdumps– lscimomdumps– lsfeaturedumps– lsiostatsdumps– lsiotracedumps– lsmdiskdumps– lssoftwaredumps

    v lssoftwareupgradestatus foi substituído por lsupdatev chenclosurevpd foi substituído por chvpdv cherrstate foi substituído por cheventlogv lsnodedependentvdisks foi substituído por lsdependentvdisksv setquorum foi substituído por chquorumv mkpartnership foi substituído por mkippartnership e mkfcpartnershipv lshbaportcandidate foi substituído por lssasportcandidate e lsfcportcandidate

    Os comandos a seguir foram descontinuados:v Estes comandos foram substituídos por lsdumps:

    – svcservicemodeinfo ls2145dumps– svcservicemodeinfo lsclustervpd

    xxvi Spectrum Virtualize for SAN Volume Controller and Storwize Family: Guia do Usuário da Interface de Linha deComandos

  • – svcservicemodeinfo lserrlogdumps– svcservicemodeinfo lsfeaturedumps– svcservicemodeinfo lsiostatsdumps– svcservicemodeinfo lsiotracedumps– svcservicemodeinfo lsmdiskdumps– svcservicemodeinfo lssoftwaredumps

    v Esses comandos foram substituídos por comandos de gerenciamento de usuário:– addsshkeys– lsauth– mkauth– rmsshkey– rmallsshkeys– rmauth

    v applymdisksoftware foi substituído por applydrivesoftwarev chcluster foi substituído por chsystemv cpfabricdumps foi substituídov dumpconfig foi substituído porv dumpinternallog foi substituído porv lscluster foi substituído por lssystemv lsclustercandidate foi substituído por lspartnershipcandidatev lsclusterip foi substituído por lssystemv lsclusterstats foi substituído por lssystemstatsv lsconfigdumps não tem substituiçãov recoverarraybycluster foi substituído por recoverarraybysystemv recoverdiskbycluster foi substituído por recoverdiskbysystemv svcservicemodeinfo lsclustervpd foi substituído por satask lsservicestatusv svcservicemodetask applysoftware foi substituído por satask installsoftwarev svcservicemodetask cleardumps foi substituído por cleardumpsv svcservicemodetask dumperrlog foi substituído por dumperrlogv svcservicemodetask exit foi substituído por stopservicev setclustertime foi substituído por setsystemtimev stopcluster foi substituído por stopsystemv triggermdiskdump foi substituído por triggerdrivedumpv setevent foi substituído por chsnmpserver, lssnmpserver, mksnmpserver e rmsnmpserverv sete-mail foi substituído por che-mail, che-mailserver, lse-mailserver, mke-mailserver e

    rme-mailserver

    Entendendo indicadores de capacidadeO sistema usa base 2 (numeral binário) como indicador de capacidade para volumes, unidades e outrosobjetos do sistema. A GUI de gerenciamento e a interface da linha de comandos (CLI) usam abreviaçõesdiferentes para indicar capacidade, mas o valor para esses indicadores de capacidade é o mesmo.

    A tabela a seguir exibe as diferenças em como os indicadores de capacidade são exibidos na GUI degerenciamento e na CLI.

    Sobre este Manual xxvii

  • Tabela 7. Indicadores de capacidade. Esta tabela exibe as diferenças em como os indicadores de capacidade sãoexibidos na GUI de gerenciamento e na CLI.

    Métrica Abreviação da GUI Abreviação da CLI Valor

    kibibyte KiB KB 1024

    mebibyte MiB MB 1.048.576

    gibibyte GiB GB 1.073.741.824

    tebibyte TiB TB 1.099.511.627.776

    pebibyte PiB PB 1.125.899.906.842.624

    exbibyte EiB EB 1.152.921.504.606.846.976

    zebibyte ZiB ZB 1.180.591.620.717.411.303.424

    yobibyte YiB YB 1.208.925.819.614.629.174.706.176

    Atributos dos Parâmetros -filtervalueO parâmetro -filtervalue filtra uma visualização baseada em valores de atributos específicos que estãorelacionados a cada tipo de objeto. É possível combinar diversos filtros para criar procuras específicas,por exemplo -filtervalue name=fred:status=online. A ajuda (-filtervalue) especifica os atributos queestão disponíveis para cada tipo de objeto.

    O parâmetro -filtervalue deve ser especificado com attrib=value. Os parâmetros-filtervalue? e-filtervalue não podem ser especificados juntos.

    Nota: Os caracteres qualificadores menor que () devem ser colocados entre aspas duplas(""). Por exemplo, -filtervalue vdisk_count ""1. Também é válido colocar toda aexpressão entre aspas duplas. Por exemplo, -filtervalue "vdisk_count

  • Capítulo 1. Configurando um Cliente SSH

    O shell seguro (SSH) é um aplicativo da rede cliente/servidor. Ele é usado como um meio decomunicação entre o sistema host e a interface da linha de comandos (CLI) do SAN Volume Controller.

    Visão Geral

    O sistema age como o servidor SSH nesse relacionamento. O cliente SSH fornece um ambiente seguropara a conexão com uma máquina remota. A autenticação é concluída usando o nome de usuário e asenha. Se você precisar de acesso à linha de comandos sem inserir uma senha, ele usará os princípios dechaves públicas e privadas para autenticação.

    Autenticando Logins de SSH

    Gere um par de chaves de shell seguro (SSH) para usar a interface da linha de comandos (CLI). Alémdisso, ao usar o SSH para efetuar login no sistema, deve-se utilizar a autenticação de chave privadabaseada em RSA.

    Quando estiver usando hosts AIX, os logins de SSH serão autenticados no sistema usando a autenticaçãobaseada em RSA que é suportada no cliente OpenSSH que está disponível para AIX. Esse esquema ébaseado na senha fornecida (ou então, se você precisar de acesso à linha de comandos sem inserir umasenha, a criptografia de chave pública será usada) usando um algoritmo normalmente conhecido comoRSA.

    Nota: O processo de autenticação para sistemas host que não são AIX é semelhante.

    Com esse esquema (assim como em sistemas OpenSSH semelhantes em outros tipos de host), acriptografia e a decriptografia são feitas usando chaves separadas. Isso significa que não é possívelderivar a chave de decriptografia da chave de criptografia.

    Como a posse física da chave privada permite acesso ao sistema, a chave privada deve ser mantida emum local protegido, como o diretório .ssh no host AIX, com permissões de acesso restrito.

    Quando o cliente SSH (A) tentar se conectar ao servidor SSH (B), a senha SSH (se você precisar de acessoà linha de comandos sem inserir uma senha, o par de chaves) autenticará a conexão. A chave consiste emduas metades: as chaves públicas e as chaves provadas. A chave pública do cliente SSH é colocada noServidor SSH (B), usando meio externos à sessão SSH. Quando o cliente SSH (A) tenta se conectar, achave privada que está no cliente SSH (A) pode autenticar com sua metade pública que está no servidorSSH (B).

    O sistema suporta até 32 sessões SSH interativas no endereço IP de gerenciamento simultaneamente.

    Nota: Depois de uma hora, uma sessão interativa SSH fixa atinge o tempo limite, o que significa que asessão SSH é encerrada automaticamente. Esse tempo limite de sessão não é configurável.

    Para conectar-se ao sistema, o cliente SSH requer um nome de login de usuário e uma senha SSH (ou sevocê precisar de acesso à linha de comandos sem inserir uma senha, o par de chaves). Autentique-se nosistema usando um nome de usuário e senha de gerenciamento. Ao usar um cliente SSH para acessar umsistema, você deve usar seu SVC_username e senha. O sistema usará a senha (e se não for uma senha, opar de chaves SSH) para autorizar o usuário que estiver acessando o sistema.

    É possível conectar-se ao sistema usando o mesmo nome de usuário com o qual efetua login no sistema.

    © Copyright IBM Corp. 2003, 2016 1

  • Para hosts Microsoft Windows, o PuTTY pode ser transferido por download na internet e usadogratuitamente para fornecer um cliente SSH.

    É possível conectar-se ao sistema usando o mesmo nome de usuário com o qual efetua login no sistema.

    Configurando um Cliente SSH em um Host WindowsÉ possível preparar o cliente SSH em um host Windows.

    A estação de trabalho do SAN Volume Controller inclui o programa cliente PuTTY, o qual é um programacliente Microsoft Windows SSH. O programa cliente PuTTY pode ser instalado em sua estação detrabalho de uma das seguintes maneiras:v Se você comprou a opção de hardware da estação de trabalho do IBM, o programa cliente PuTTY foi

    pré-instalado no hardware.v É possível usar o CD de instalação de software da estação de trabalho para instalar o programa cliente

    PuTTY.v É possível usar o assistente de instalação do programa cliente PuTTY, putty-version-installer.exe. O

    programa cliente PuTTY pode ser transferido por download a partir do seguinte Web site:Download Putty

    Nota: Antes de instalar o programa cliente PuTTY, verifique se o sistema Windows atende aos requisitosdo sistema.

    Para conectar-se ao sistema, o cliente SSH requer um nome de login de usuário e uma senha SSH (ou sevocê precisar de acesso à linha de comandos sem inserir uma senha, o par de chaves). Autentique-se nosistema usando um nome de usuário e senha de gerenciamento. Ao usar um cliente SSH para acessar umsistema, você deve usar seu SVC_username e senha. O sistema usará a senha (e se não for uma senha, opar de chaves SSH) para autorizar o usuário que estiver acessando o sistema.

    É possível conectar-se ao sistema usando o mesmo nome de usuário com o qual efetua login no sistema.

    Gerando um Par de Chaves SSH Usando o PuTTYPara usar a interface da linha de comandos do SAN Volume Controller, você deverá gerar um par dechaves shell seguro (SSH) usando PuTTY.

    Sobre Esta Tarefa

    Gere chaves SSH usando o gerador de chaves PuTTY (PuTTYgen):

    Procedimento1. Inicie o PuTTYgen clicando em Iniciar > Programas > PuTTY > PuTTYgen. O painel Gerador de

    Chaves PuTTY é exibido.2. Clique em SSH-2 RSA como o tipo de chave a ser gerado.

    Nota: Deixe o número de bits em um valor de chave gerado como 1024.3. Clique em Gerar e, em seguida, mova o cursor ao redor da área em branco da seção Chave, para

    gerar os caracteres aleatórios que criam uma chave exclusiva. Quando a nova chave for totalmentegerada, as informações sobre ela serão exibidas na seção Chave.Atenção: Não modifique os campos Impressão Digital da Chave ou Comentário da Chave; isso podefazer com que a chave não seja mais válida.

    4. (Opcional) Insira uma passphrase nos campos Passphrase da Chave e Confirmar Passphrase. Apassphrase criptografa a chave no disco; portanto, não é possível usar a chave sem antes inserir apassphrase.

    2 Spectrum Virtualize for SAN Volume Controller and Storwize Family: Guia do Usuário da Interface de Linha de Comandos

    http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html

  • 5. Salve a chave pública por:a. Clique em Salvar chave pública. Será solicitado o nome e o local da chave pública.b. Digite icat.pub como o nome da chave pública e especifique o local no qual deseja salvar a chave

    pública. Por exemplo, é possível criar um diretório chamado keys em seu computador paraarmazenar as chaves pública e privada.

    c. Clique em Salvar.6. Salve a chave privada por:

    a. Clique em Salvar chave privada. O painel Aviso do PuTTYgen é exibido.b. Clique em Yes para salvar a chave privada sem uma passphrase.c. Digite icat como o nome da chave privada e especifique o local no qual deseja salvar a chave

    privada. Por exemplo, é possível criar um diretório chamado keys em seu computador paraarmazenar as chaves pública e privada. É recomendável salvar as chaves pública e privada nomesmo local.

    d. Clique em Salvar.7. Feche a janela do Gerador de Chaves PuTTY.

    Configurando uma Sessão do PuTTY para a CLIVocê deve configurar uma sessão de PuTTY usando a senha de Shell Seguro (SSH). Se você precisar deacesso à linha de comandos sem inserir uma senha, use o par de chaves SSH criado para a interface dalinha de comandos (CLI).

    Sobre Esta Tarefa

    Atenção: Não execute scripts que criem processos filho executados em segundo plano e chame oscomandos do SAN Volume Controller. Isso pode fazer com que o sistema perca o acesso aos dados epode causar a perda de dados.

    Conclua as seguintes etapas para configurar uma sessão PuTTY para a CLI:

    Procedimento1. Selecione Iniciar > Programas > PuTTY > PuTTY. A janela de Configuração do PuTTY é aberta.2. Clique em Sessão na árvore de navegação Categoria. As opções Básicas para a sessão do PuTTY são

    exibidas.3. Clique em SSH como a opção de Protocolo.4. Clique em Apenas em Saídas Limpas como a janela Fechar na opção de saída. Isso garante a

    exibição dos erros de conexão.5. Clique em Conexão > SSH na árvore de navegação Categoria. As opções que controlam as conexões

    SSH são exibidas.6. Clique em 2 como a versão de protocolo SSH preferencial.7. Clique em Conexão > SSH > Autorização na árvore de navegação Categoria. As Opções da

    autenticação SSH do controlador são exibidas.8. Clique em Navegar ou digite o nome completo do arquivo e o local do cliente SSH e a senha. Se

    nenhuma senha for usada, a chave privada no campo Arquivo de Chave Privada para Autenticação.9. Clique em Conexão > Dados na árvore de navegação Categoria.

    10. Digite o nome do usuário que você deseja usar no SAN Volume Controller no campo Loginautomático do nome de usuário.

    11. Clique em Sessão na árvore de navegação Categoria. As opções Básicas para a sessão do PuTTY sãoexibidas.

    12. No campo Nome do Host (ou Endereço IP), digite o nome ou endereço de Protocolo da Internet (IP)de um dos endereços IP ou nomes do host do sistema em cluster (sistema) SAN Volume Controller.

    Capítulo 1. Shell Seguro 3

  • 13. Digite 22 no campo Porta. O sistema SAN Volume Controller usa a porta SSH padrão.14. No campo Sessões Salvas digite o nome que você deseja associar a esta sessão. Por exemplo, é

    possível nomear a sessão como Sistema 1 SAN Volume Controller.15. Clique em Salvar.

    Resultados

    Agora você configurou uma sessão do PuTTY para a CLI.

    Nota: Se você configurou mais de um endereço IP para o sistema SAN Volume Controller, repita asetapas anteriores para criar outra sessão salva para o segundo endereço IP. Dessa forma, ele pode serusado se o primeiro endereço IP estiver indisponível.

    Conectando-se à CLI Usando PuTTYCertifique-se de estar familiarizado com a execução do PuTTY e os utilitários Plink.

    Nota: Os usuários do Windows podem fazer download do PuTTY do seguinte website: Download Putty.

    O protocolo de shell seguro (SSH) especifica que o primeiro acesso a um novo servidor host envie umdesafio ao usuário SSH para aceitar a chave pública do servidor SSH ou senha do usuário. Como essa é aprimeira vez que você se conecta a um servidor SSH, o servidor não está incluído na lista de clientes deSSH de hosts conhecidos. Portanto, há uma solicitação de impressão digital, que pergunta se você aceita aresponsabilidade de conectar-se a esse host. Se você digitar y, a impressão digital do host e o endereço IPserão salvos pelo cliente SSH.

    Ao usar o PuTTY, você também deve digitar y para aceitar essa impressão digital do host. Entretanto, aimpressão digital do host e o endereço IP serão armazenados no registro do nome de usuário que estáconectado no Windows.

    O protocolo SSH também especifica que, quando a chave pública do servidor SSH for aceitaoutrasolicitação seja apresentada, se a impressão digital de um servidor SSH for diferente daquela aceitaanteriormente. Nesse caso, você deve decidir se deseja aceitar esta impressão digital do host alterada.

    Nota: As chaves do servidor SSH do SAN Volume Controller serão regeneradas quando umcarregamento de microcódigo for executado no sistema em cluster. Como resultado, é enviada umasolicitação, porque a impressão digital do servidor SSH foi alterada.

    Todos os comandos da interface de linha de comandos (CLI) são executados em uma sessão de SSH. Épossível executar os comandos de uma das seguintes maneiras:v Um modo de prompt interativov Um modo de comando em uma única linha, inserida uma vez para incluir todos os parâmetros

    Modo Interativo

    Para o modo interativo, é possível usar o executável PuTTY para abrir o shell restrito SSH.

    O sistema suporta até 32 sessões SSH interativas no endereço IP de gerenciamento simultaneamente.

    Nota: Depois de uma hora, uma sessão interativa SSH fixa atinge o tempo limite, o que significa que asessão SSH é encerrada automaticamente. Esse tempo limite de sessão não é configurável.

    A seguir, há um exemplo do comando que pode ser emitido para iniciar o modo interativo:C:\support utils\putty @svcconsoleip

    4 Spectrum Virtualize for SAN Volume Controller and Storwize Family: Guia do Usuário da Interface de Linha de Comandos

    http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html

  • em que support utils\putty é o local do arquivo putty.exe, é o endereço IP do GUI degerenciamento e é o nome do usuário que você deseja usar.

    Se você emitir o comando lsuser, que lista as chaves públicas de cliente SSH que estão armazenadas nosistema, a saída a seguir será exibida quando ssh_key=yes:

    IBM_2145:cluster0:superuser>lsuserid name password ssh_key remote usergrp_id usergrp_name0 superuser yes yes no 0 SecurityAdmin1 smith no yes no 4 Monitor2 jones no yes no 2 CopyOperator

    É possível digitar exit e pressionar Enter para sair do comando do modo interativo.

    A seguir, há um exemplo da solicitação de impressão digital ao usar o Plink no modo interativo:

    C:\ProgramFiles\IBM\svcconsole\cimom>[email protected] server’s host key is not cached in the registry. Youhave no guarantee that the server is the computer youthink it is.The server’s key fingerprint is:ssh-rsa 1024 e4:c9:51:50:61:63:e9:cd:73:2a:60:6b:f0:be:25:bfIf you trust this host, enter "y" to add the key toPuTTY’s cache and carry on connecting.If you want to carry on connecting just once, withoutadding the key to the cache, enter "n".If you do not trust this host, press Return to abandon theconnection.Store key in cache? (y/n) yUsing user name "superuser".Authenticating with public key "imported-openssh-key"IBM_2145:your_cluster_name:superuser>

    Comando de Única Linha

    Para um modo de comando de linha única, é possível digitar todos os itens a seguir em uma linha decomandos:

    C:\Program Files\IBM\svcconsole\cimom>plink [email protected]

    lsuserAuthenticating with public key "imported-openssh-ke