Use o Interface da linha de comandos do Data Protection for VMware para fazer backup, restaurar ou visualizar informações de configuração em um ambiente vSphere ou vCloud.
Linux Windows
Sobre Esta Tarefa
O Interface da linha de comandos do Data Protection for VMware fornece estes comandos:
“Cópia de Segurança” na página 46
Inicie backups completos e incrementais das suas MVs.
“Restauração” na página 49
Restaure os backups das suas MVs.
“Inquire_config” na página 56
Visualize as informações de configuração sobre o banco de dados de backup.
“Inquire_detail” na página 61
Visualize as informações de configuração sobre o ambiente de backup.
“Set_domain” na página 64
Aplique as mudanças nas configurações de domínio.
“Set_mapping” na página 65
Configure o mapeamento entre os objetos vCloud e o nome do nó do Tivoli Storage Manager.
“Set_option” na página 66
Configure um parâmetro no vmcliprofile.
“Set_password” na página 68
Configure a senha para o nome do nó do Interface da linha de comandos do Data Protection for VMware.
“Get_password_info” na página 70
Visualize o status de credenciais de convidado configuradas para os datacenters gerenciados.
“Start_guest_scan” na página 71
Excetue varredura nas VMs guest para informações do aplicativo.
Exemplo
Acesse o Interface da linha de comandos do Data Protection for VMware nestes diretórios:
Linux
/opt/tivoli/tsm/tdpvmware/common/scripts
Windows (32 bits)
C:\Program Files\Common Files\Tivoli\TDPVMware\VMwarePlugin\scripts
Windows (64 bits)
C:\Program Files (x86)\Common Files\Tivoli\TDPVMware\VMwarePlugin\scripts
Para mensagens do Interface da linha de comandos do Data Protection for VMware que contiverem o prefixo FMM, as informações de mensagem estão disponíveis no IBM Knowledge Center:
FMM, FMF, FMV, FMX, FMY: mensagens do Tivoli Storage FlashCopy Manager (http://www.ibm.com/support/knowledgecenter/SS36V9_4.1.1/
com.ibm.itsm.fcm.doc/r_messages_fcm.html)
Cópia de Segurança
Use este comando vmcli para iniciar backups incrementais e completos de VMs ou modelos de VM.
Sintaxe
O comando backup vmcli -f usa esta sintaxe:
vmcli -f backup -tbackupType -I backupObjectListFile -d datacenternodename | providervDCnodename -o datamovernodename [--name taskName] [--description descriptionInFile.txt] [-s tsmserverhostname][ -n vctrclinodename] [-p tsmserverport]
Linux
Você deve emitir o comando vmcli -f backup como usuário tdpvmware, e não como raiz.
Parâmetros
Antes de emitir um comando vmcli -f backup, emita o comando vmcli -f
inquire_configpara verificar se sua configuração está correta. Além disso, use as informações da saída de comando vmcli -f inquire_config como um guia para configurar os parâmetros de backup.
Quando uma operação de backup está em execução, não há nenhum comando ou método disponível para parar o backup, incluindo Ctrl + C. Você deve aguardar a operação ser concluída por si só.
O comando vmcli -f backup requer que VE_VCENTER_NODE_NAME seja configurado corretamente no vmcliprofile. Não é possível sobrescrever esse parâmetro com uma entrada de linha de comandos.
O sistema movedor de dados (o vStorage Backup Server no qual o cliente de backup-archive Tivoli Storage Manager está instalado) não deve configurar a opção ASNODENAME.
-t backupType
TSM_INCR
Cria um backup incremental do objeto de backup especificado. Esse parâmetro é válido apenas no modo vSphere.
TSM_FULL
Cria um backup de imagem completo dos objetos de backup especificados. Esse parâmetro é válido apenas no modo vSphere.
TSM_IFFULL
Cria um backup completo contínuo incremental dos objetos de backup especificados. Quando TSM_IFFULL é especificado, as MVs modelo inalteradas desde o último backup também são incluídas. Esse parâmetro é válido nos modos vSphere e vCloud.
TSM_IFINCR
Cria um backup incremental contínuo do objeto de backup especificado. Esse tipo faz backup apenas de dados que foram alterados desde o último backup. Esse parâmetro é válido nos modos vSphere e vCloud. Esse tipo é o padrão.
O processo de backup não cria uma captura instantânea das MVs modelo da mesma maneira que uma captura instantânea é criada para MVs regulares. Como resultado, transportes VMware VDDK avançados (SAN, modo HotAdd), rastreamento de bloqueio de mudança (CBT) e backups incrementais não estão disponíveis.
-I backupObjectListFile
Especifique o arquivo que contém a lista de objetos dos quais fazer backup. Cada linha contém uma especificação para backup.
No modo vCloud, o backupObjectListFile usa o seguinte formato:
vappname:Org=organization,OrgvDC=organization VDC[,vApp=vApp]
As palavras-chave org, orgvdc e vapp devem ser seguidas por um sinal de igual (=) e separadas da palavra-chave seguinte com uma vírgula (,). No modo vCloud, o backupObjectListFile usa as seguintes palavras-chave:
vappname
Especifique o nome do vApp para fazer backup. Cada linha no backupObjectListFile deve começar com essa palavra-chave. É possível repetir essa palavra-chave para cada vApp de que deseja fazer backup.
org Especifique o nome da organização a partir da qual vApps são submetidos a backup. Esse parâmetro deve ser especificado
imediatamente após a palavra-chave vappname. Se você fizer backup de vApps a partir de organizações diferentes, crie várias linhas.
orgvdc
Especifique o nome da vDC da organização a partir da qual vApps são submetidos a backup. Esse parâmetro deve ser especificado como o terceiro parâmetro de uma linha de entrada (após a palavra-chave org). Se você fizer backup de vApps a partir de vDCs de organização diferentes, crie várias linhas.
vapp Especifique o nome do vApp para fazer backup. Esse parâmetro deve ser especificado como o quarto parâmetro de uma linha de entrada (após a palavra-chave orgvdc). Se você fizer backup de vários vApps, crie várias linhas. Se esse parâmetro não for especificado, todos os vApps do vDC da organização (orgvdc) da organização (org) serão submetidos a backup.
No modo vSphere, o backupObjectListFile usa a seguinte palavra-chave:
vmname
Especifique o nome da MV da qual fazer o backup. É possível especificar essa palavra-chave para cada MV da qual deseja fazer backup. Por exemplo:
vmname:vm1 vmname:vm2
Restrições:
v Não especifique um nome de host de MV no backupObjectListFile. O Data Protection for VMware não suporta o backup de uma MV identificada pelo nome do host da MV.
v Quando você especifica o nome de uma VM usando a palavra-chave vmname em backupObjectListFile, Data Protection for VMware não diferencia dois pontos (:) usados como um separador de
palavra-chave de dois pontos usados em um nome de VM. Portanto, tome cuidado ao especificar valores de palavra-chave. Além disso, o backup de uma MV que contém uma vírgula em seu nome não é suportado.
v O suporte do Data Protection for VMware para as operações de backup da VM é limitado aos nomes de VM e aos nomes de datacenter contendo apenas caracteres ASCII de 7 bits em inglês. Nomes de VM e nomes de datacenter que usam caracteres de outro idioma não são suportados atualmente. Outras restrições quanto a caracteres estão listadas em Apêndice A, “Resolução de Problemas”, na página 133.
v Um VMware vCenter permite a existência de duas MVs com o mesmo nome. Entretanto, o Data Protection for VMware não suporta o backup de duas MVs com o mesmo nome. Para evitar erros ou falhas de backup, não tenha duas VMs com o mesmo nome em um vCenter.
-d datacenternodename | providervDCnodename | organizationvDCnodename
Quando o parâmetro VE_TSM_MODE especificar VSPHERE, especifique o nome do nó do datacenter.
Quando o parâmetro VE_TSM_MODE especificar vCloud, especifique o nome do nó do vDC do fornecedor (operações de backup e restauração) ou nome do nó vDC da organização (operações de consulta).
-o datamovernodename
Especifique o nome do nó do movedor de dados. Este nome é o nome do nó para o cliente de backup-archive Tivoli Storage Manager que é instalado no vStorage Backup Server. Esse nó executa a movimentação de dados.
[--name taskName]
Especifique a sequência que identifica a tarefa de backup. [--description descriptionInFile.txt]
Especifique o nome do arquivo de texto que contém uma descrição da tarefa de backup.
[-s tsmserverhostname]
Especifique o nome do host ou o endereço IP do servidor Tivoli Storage Manager. Se este parâmetro não estiver especificado, o valor no perfil será
[-n vmclinodename]
Especifique o nome do Nó do VMCLI. Esse nó conecta o servidor Interface da linha de comandos do Data Protection for VMware ao Tivoli Storage Manager e ao nó do movedor de dados. Se este parâmetro não estiver especificado, o valor no perfil será usado.
[-p tsmserverport]
Especifique a porta do servidor Tivoli Storage Manager.
v Se este parâmetro não estiver especificado no Interface da linha de comandos do Data Protection for VMware e não estiver especificado no perfil, a porta padrão (1500) será usada.
v Se este parâmetro não estiver especificado no Interface da linha de comandos do Data Protection for VMware, mas estiver especificado no perfil, o valor no perfil será usado.
Restauração
Use este comando vmcli para restaurar backups de suas máquinas virtuais, modelos de máquina virtual ou do vApps.
Sintaxe
O comando vmcli -f restore usa esta sintaxe:
vmcli -f restore[-c tsm_mode] -I restoreObjectListFile -d datacenternodename -o datamovernodename [-s tsmserverhostname] [-n vmclinodename] [-p tsmserverport] [-vmrestoretype (noninstant | instantrestore | instantaccess | mount |
vmcleanup| vmfullcleanup | mountcleanup)]
Linux
Você deve emitir o comando vmcli -f restore como usuário do tdpvmware e não como root.
Parâmetros
O comando vmcli -f restore requer que VE_VCENTER_NODE_NAME esteja configurado corretamente no vmcliprofile. Não é possível sobrescrever esse parâmetro com uma entrada de linha de comandos.
O sistema movedor de dados (o vStorage Backup Server no qual o cliente de backup-archive Tivoli Storage Manager está instalado) não deve configurar a opção ASNODENAME.
-c tsm_mode
Especifique o modo no qual o Tivoli Storage Manager restaura o ambiente virtual. O valor é configurado no parâmetro VE_TSM_MODE no vmcliprofile. É possível escolher entre um dos seguintes modos:
VSPHERE
Especifique este valor quando o Tivoli Storage Manager restaurar VMs individuais de um vCenter.
VCloud
Especifique este valor quando o Tivoli Storage Manager restaurar vApps de um vCloud Director.
Capítulo 4. Interface da linha de comandos do Data Protection for VMware
49
|| | |
Se o modo não estiver configurado no vmcliprofile, o modo VSPHERE será usado com o comando vmcli.
-I restoreObjectListFile
Especifique o arquivo que contém a lista de VMs ou vApps para restaurar. Cada linha pode conter apenas um identificador de VM (modo vSphere) ou uma especificação de restauração para um vApp (modo vCloud).
O restoreObjectListFile usa a seguinte palavra-chave no modo vSphere e no modo vCloud:
ID de backup
Cada linha deve começar com backupid. A sintaxe é
backupid:your_backup_ID. Especifique o ID do Objeto do Tivoli Storage Manager para um backup de VM específico (modo vSphere) ou backup do vApp (modo vCloud). Localize o ID do Objeto usando o comando
vmcli -f inquire_detail. Esta palavra-chave é necessária para uma operação de restauração.
O restoreObjectListFile usa as seguintes palavras-chave apenas no modo vSphere:
vmname
No modo vSphere, especifique o nome da máquina virtual da qual foi feito backup originalmente. Se essa palavra-chave não for especificada, o nome vmname será usado para a restauração.
Restrição: Restrições: Quando você especifica uma palavra-chave no restoreObjectListFile, o Data Protection for VMware não diferencia entre dois pontos (:) usados como um separador de palavra-chave ou dois pontos usados em um valor de palavra-chave. Portanto, tome cuidado ao especificar valores de palavra-chave. Além disso, o suporte do Data Protection for VMware para operações de restauração da VM é
limitado a nomes de VM e nomes de datacenter do VMware contendo apenas caracteres ASCII de 7 bits em inglês. Nomes de VM e nomes de datacenter que usam caracteres de outro idioma não são suportados atualmente. Restrições adicionais de caracteres estão listadas em Apêndice A, “Resolução de Problemas”, na página 133.
O processo de restauração não cria uma captura instantânea das MVs modelo da mesma maneira que uma captura instantânea é criada para MVs regulares. Como resultado, transportes VMware VDDK avançados (SAN, modo HotAdd), rastreamento de bloqueio de mudança (CBT) e backups incrementais não estão disponíveis.
vmname
No modo vSphere, especifique o nome com o qual você deseja que a máquina virtual restaurada seja nomeada. Essa palavra-chave é a segunda entrada. As MVs existentes não são sobrescritas. Portanto, renomeie a VM (usando essa palavra-chave) ou exclua a VM original antes de emitir o comando vmcli -f restore.
-vmdk=cnfg
No modo vSphere, especifique que as informações de configuração da máquina virtual foram restauradas. As informações de configuração são sempre restauradas quando uma máquina virtual inteira é
restaurada. No entanto, por padrão, a configuração não é restaurada ao restaurar os discos selecionados apenas com a opção vmdk=disk label. | | | | | |
Normalmente, a restauração das informações de configuração para uma máquina virtual existente falha porque as informações de configuração restauradas entram em conflito com as informações de configuração da máquina virtual existente. Use esta opção se o arquivo de configuração existente para uma máquina virtual no servidor ESX foi excluído e você desejar usar a configuração com backup feito para recriá-lo.
Por exemplo, essa entrada em restoreObjectListFile restaura todos os VMDKs para a máquina virtual VM1 e mantém o mesmo nome:
backupid:26801107 vmname:VM1:-vmdk=cnfg
vmdk=disk label
No modo vSphere, especifique o rótulo do disco dos discos virtuais para incluir na operação de restauração. Especifique esta opção apenas se desejar restaurar parcialmente os dados da máquina virtual ao restaurar apenas os discos específicos.
Por exemplo, essa entrada em restoreObjectListFile restaura apenas o VMDK denominado Disco Rígido 1 como uma nova máquina virtual:
backupid:26801107 vmanme:myvm:vmdk=Hard Disk 1::vmname:newname
-vmdk=disk label
No modo vSphere, especifique o rótulo do disco de um ou mais discos virtuais para excluir da operação de restauração.
Por exemplo, essa entrada em restoreObjectListFile restaura todos os VMDKs exceto aquele denominado Disco Rígido 1 como uma nova máquina virtual:
backupid:26801107 vmanme:myvm:-vmdk=Hard Disk 4::vmname:newname
Essa entrada restaura os VMDKs para a máquina virtual como uma nova máquina virtual sem informações de configuração:
backupid:26801107 vmname:oldvmname:-vmdk=cnfg::vmname:newname
newdatacentername
No modo vSphere, quando você desejar que o destino de restauração seja um datacenter diferente, especifique o nome desse datacenter com essa palavra-chave.
newesxhostname
No modo vSphere, quando você desejar que o destino de restauração seja um host ESX diferente, especifique o nome desse host ESX com essa palavra-chave.
newdatastoreurl
No modo vSphere, especifique o nome (não a URL) do armazenamento de dados do VMware onde a máquina virtual deve ser restaurada. Por exemplo, o nome de um armazenamento de dados como datastore1 é suportado. A URL de um armazenamento de dados como
sanfs://vmfs_uuid:4d90pa2d-e9ju45ab-065d-00101a7f1a1d/não é suportada.
Capítulo 4. Interface da linha de comandos do Data Protection for VMware
51
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |vmtempdatastore
No modo vSphere, quando você quiser emitir uma operação de restauração instantânea, especifique um armazenamento de dados provisório no host ESX. Esse armazenamento de dados provisório contém os dados e as informações de configuração da VM criada durante a operação.
vmautostartvm
No modo vSphere, quando uma máquina virtual for criada para acesso instantâneo (vmrestoretype instantaccess), especifique se deve-se iniciar a máquina virtual automaticamente:
YES A VM criada para acesso instantâneo é iniciada automaticamente.
NÃO A VM criada para acesso instantâneo não é iniciada automaticamente. Ela deve ser iniciada manualmente pelo usuário. Esse valor é padrão.
vmdiskprovision
No modo vSphere, especifique o tipo de fornecimento para o disco da máquina virtual que é restaurado durante um processo de restauração instantâneo (vmrestoretype instant):
THICK
O disco é criado com thick provisioning. Esse valor é padrão.
THIN O disco é criado com thin provisioning.
Um restoreObjectListFile de exemplo no modo vSphere é fornecido aqui: # restore of VM "678912345" named "vmName6" to new vmname "vm6newName" to datacenter "DataCenter2" to ESX esxhostname:esxHost1Name to new datastore "datastore2"
backupid:678912345 vmname:vmName6::vmname:vm6newName newdatacentername:DataCenter2 newesxhostname:esxHost1Name newdatastoreurl:datastore2 vmtempdatastore:datastore2temp
vmdiskprovision:thin
Cada especificação de restauração deve estar em uma única linha. No entanto, em consideração à formatação da página, a especificação da restauração nesse exemplo está em diversas linhas.
O restoreObjectListFile usa as seguintes palavras-chave no modo vSphere para operações de montagem:
vmostype
Especifique o tipo de sistema operacional para o backup da máquina virtual.
AUTOMÁTICO
O sistema operacional da máquina virtual com backup feito é detectado automaticamente. Esse valor é padrão.
LINUX
O sistema operacional da máquina virtual com backup feito é Linux.
WINDOWS
O sistema operacional da máquina virtual com backup feito é Windows. | | | | | | | | | | | | | |
exportfs
Exporta o sistema de arquivos montado para o local especificado pelo valor do exportparameter.
YES O sistema de arquivos montado é exportado.
NÃO O sistema de arquivos montado não é exportado. Esse valor é padrão.
exportparameter
O local onde o sistema de arquivos é exportado.
Linux IP ou nome da máquina
O endereço IP ou nome da máquina que monta o sistema de arquivos exportado.
Windows user name
O nome do usuário que é permitido para acessar o
Compartilhamento do Windows. É de responsabilidade do usuário estar ciente de quais usuários e grupos têm acesso aos seus arquivos compartilhados.
mountpoint mount point path
Especifique o caminho do ponto de montagem.
Linux O valor padrão é /mnt/vmname.
Windows O valor padrão é D:\tsmvemount\vmname.
mounttagstring
Essa sequência é o texto que você insere para tornar o nome do ponto de montagem mais fácil para identificar ao procurar no sistema de arquivos local. Especifique essa sequência como parte do caminho de montagem.
Linux O caminho completo para um disco é /mount
root/tag/vmname/snapshot date and time/file system number. Por exemplo:
/mnt/tickel-4711/VM1/2013-12-12-12:12:12/disk1
Windows O caminho completo para um disco é mount
root\tag\vmname\snapshot date and time\file system number. Por exemplo:
C:\Users\Admin\tickel-4711\VM1\2013-12-12-12:12:12\disk1
Um restoreObjectListFile de exemplo no modo vSphere para operações de montagem é fornecido aqui:
Linux
backupid:1167852 vmname:VM-Lin4 mounttag:limor exportparameters:9.123.456.78 exportfs:yes vmostype:linux mountpoint:/tmp/tsm-mounts
Windows
backupid:1167850 vmname:VM-Name3 mounttag:limor exportparameters:WinUser1 exportfs:yes vmostype:windows mountpoint:C:\temp\mnt
O restoreObjectListFile usa as seguintes palavras-chave apenas no modo vCloud:
Capítulo 4. Interface da linha de comandos do Data Protection for VMware
53
| | | || || | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |vappname
No modo vCloud, especifique a especificação de restauração para um vApp. Essa palavra-chave é especificada após a palavra-chave
backupid. O valor vappname é composto por essa entrada tripla:
org=organization name,orgvdc=nome do nó vDC da organização,vapp=vApp name
Por exemplo, a entrada restoreObjectListFile a seguir restaura vApp denominado "vApp1" da organização "Mainz_org" e organização virtual datacenter "MZ_Silver" para um novo vApp denominado "vApp1_restore":
vappname "vApp1_restore"
backupid:47110815 vappname:org=Mainz_org,orgvdc=MZ_Silver,vapp=vApp1 vappname_new:vApp1_restore
org=organization,orgvdc=organization vdc,vapp=name of vApp backup No modo vCloud, use esse trio para especificar as informações a seguir:
org O nome da organização à qual o vApp pertence.
orgvdc
O nome da vDC da organização à qual o vApp pertence.
vapp O nome do vApp que foi originalmente submetido a backup.
vappname_new
No modo vCloud, especifique o novo nome para ovApp a ser
restaurado. vApps existentes não são sobrescritos. Como resultado, use a palavra-chave vappname_new para renomear o vApp de restauração ou excluir o vApp original antes de iniciar a operação de restauração. Se essa palavra-chave não for especificada, o valor vappname será usado para a restauração.
Um restoreObjectListFile de exemplo é fornecido aqui:
# restore of VM "678912345" named "vmName6" to new vmname "vm6newName" to datacenter "DataCenter2" to ESX esxhostname:esxHost1Name to new datastore "datastore2"
backupid:678912345 vmname:vmName6::vmname:vm6newName newdatacentername:DataCenter2 newesxhostname:esxHost1Name newdatastoreurl:datastore2 vmtempdatastore:datastore2temp
vmdiskprovision:thin
Cada especificação de restauração deve estar em uma única linha. No entanto, em consideração à formatação da página, a especificação da restauração nesse exemplo está em diversas linhas.
Dica: Para certificar-se de que as informações corretas estão especificadas no restoreObjectListFile, você poderá emitir o comando inquire_detail. O
“Inquire_detail” na página 61 fornece informações de configuração atuais sobre o ambiente de backup.
-d datacenternodename | providervDCnodename
Quando o parâmetro VE_TSM_MODE especificar VSPHERE, especifique o nome do nó do datacenter.
Quando o parâmetro VE_TSM_MODE especificar VCloud, especifique o nome do nó do vDC do fornecedor.
cliente de backup-archive do Tivoli Storage Manager que está instalado no Servidor de Backup do vStorage. Esse nó executa a movimentação de dados. [-s tsmserverhostname]
Especifique o nome do host ou o endereço IP do servidor Tivoli Storage Manager. Se este parâmetro não estiver especificado, o valor no perfil será usado.
[-n vmclinodename]
Especifique o nome do Nó do VMCLI. Esse nome é o nó que conecta o Interface da linha de comandos do Data Protection for VMware ao servidor