Tópico anterior: Entendendo os comandos do CA ARCserve RHA PowerShell

Próximo tópico: Resume-Scenario - Retomar a replicação de uma réplica suspensa

Usando comandos do CA ARCserve RHA PowerShell

Este capítulo descreve em detalhes a utilização dos comandos do CA ARCserve RHA PowerShell para controlar, editar e monitorar os processos de DR e HA. Os comandos são exibidos em ordem alfabética e são divididos em quatro grupos: Conexão e registro, Controle, Edição e Monitoramento.

Esta seção contém os seguintes tópicos:

Comandos de conexão e registro

Comandos de controle

Comandos de edição

Comandos de monitoramento

Comandos de gerenciamento do usuário

Comandos de conexão e registro

Esta seção descreve como se conectar ao Serviço de controle, como se desconectar dele e como inserir a chave de licença do registro do CA ARCserve RHA.

Connect-XO - Conectar o PowerShell a um serviço de controle

Para trabalhar com cenários do CA ARCserve RHA usando o PowerShell, a primeira coisa a fazer é se conectar ao serviço de controle que age como o ponto de controle da operação do CA ARCserve RHA. O comando Connect-XO permite a conexão do PowerShell a um determinado serviço de controle.

Observação: após concluir o trabalho com o CA ARCserve RHA PowerShell, não se esqueça de se desconectar do serviço de controle usando o comando Disconnect-XO. Fechar a janela do PowerShell também fará com que o PowerShell se desconecte do Serviço de controle.

Sintaxe
Connect-XO [-Host] <String> [-Credentials] <PSCredential> [[-Protocol] [<String>]] [[-Port] [<String>]]
Parâmetros
Host

O endereço IP ou nome do host do computador no qual o serviço de controle está em execução.

Credentials\PSCredentials

O domínio\nome do usuário do serviço de controle. Essas credenciais devem pertencer a um usuário com direitos de Administrador para o serviço de controle. Após digitar as credenciais, a caixa de diálogo Windows PowerShell Credential Request aparece, solicitando sua senha.

Observação: para evitar a necessidade de inserir manualmente suas credenciais na caixa de diálogo PSCredentials, consulte Conectar o PowerShell a um serviço de controle usando um script.

Protocolo

O protocolo usado para se conectar ao serviço de controle. Digite um destes: http ou https.

Port (opcional)

A porta TCP/IP usada para se conectar ao serviço de controle. Para http, o valor padrão é 8088; para https, o valor padrão é 443.

Exemplo: conectar-se a um serviço de controle

connect-xo 192.168.1.151 qa88-w3k3\administrator https

Resultado

Uma caixa de diálogo Windows PowerShell Credential Request aparece, solicitando a senha. Em seguida, o texto abaixo aparece:

Conectando...
192.168.1.151 conectado!

Conectar o PowerShell a um serviço de controle usando um script

Você pode evitar a necessidade de inserir manualmente suas credenciais na caixa de diálogo PSCredentials, criptografando sua senha e executando-a como um objeto.

Para criptografar sua senha e executá-la como um objeto

Digite os seguintes comandos, usando sua senha, quando indicado, e execute-os uma vez:

read-host -assecurestring | convertfrom-securestring | out-file C:\ securestring.txt <password>
$pass = cat C:\securestring.txt | convertto-securestring
$mycred = new-object -typename System.Management.Automation.PSCredential -argumentlist <domain\user_name>, $pass
Connect -XO [-Host] <String> $mycred [[-Protocol][<String>]] [[-Port] [<String>]]

O resultado é o mesmo de uma conexão padrão:

Conectando...
<endereço IP> conectado! 

Para obter mais informações, consulte a documentação do PowerShell ou pesquise na Internet.

Disconnect-XO - Desconectar de um serviço de controle em execução

Após concluir o trabalho com o CA ARCserve RHA PowerShell, você precisa se desconectar do serviço de controle em execução. O comando Disconnect-XO permite que você desconecte o PowerShell do serviço de controle em execução.

Observação: Fechar a janela do PowerShell também fará com que o PowerShell seja desconectado do serviço de controle.

Sintaxe
disconnect-XO

Observação: este comando não tem parâmetros. Ele desconecta automaticamente o serviço de controle em execução.

Exemplo: desconectar-se de um serviço de controle

disconnect-xo

Resultado:

192.168.1.151 disconnected!

Get-License - Exibir a licença do CA ARCserve RHA

O comando Get-License permite que você exiba os detalhes da licença do CA ARCserve RHA.

Sintaxe
get-license

Exemplo: exibir os detalhes da licença do CA ARCserve RHA

get-license

Resultado:

Chave: TVC2LF24FTU7G3WJ2QAFMCLGXA5KLPCCYIXTJTWX2MOZFU5GL7EJ3OYZQND7V3G123456
Empresa:
License expires on: 11  2009
Maintenance till: 11  2009
Number of Assured Recovery nodes:240
Number of CDP Repository nodes:240

Product list:
- Application Server, Windows Cluster edition, 30 instances HA
- Application Server, Windows Cluster edition, 130 instances HA
- Application Server, Windows Cluster edition, 130 instances DR
- Application Server, Windows Cluster edition, 30 instances DR
- Application Server, Virtual Machine, 100 instances DR
- Application Server, Virtual Machine, 100 instances HA

Set-License - Registrar CA ARCserve RHA

O comando Set-License permite registrar o CA ARCserve RHA usando uma chave de licença. Você precisa ter uma chave de registro válida para usar esse comando.

Sintaxe
set-license
Parâmetros
Chave

Uma chave de licença válida.

Exemplo: registrar o CA ARCserve RHA usando uma chave de licença

set-license TVC2LF24FTU7G3WJ2QAFMCLGXA5KLPCCYIXTJTWX2MOZFU5GL7EJ3OYZQND7V3G123456

Resultado:

Key registered successfully
















xo-import-credential

Este comando lê todos os registros da credencial no arquivo XML e o adiciona ao conectar o serviço de controle, por meio do comando Add-Credential.

Sintaxe

xo-import-credential

Parâmetros

Especifique o nome do arquivo XML.

Entrada

Nenhum. Nenhum objeto é conectado ao xo-import-credential.

xo-convertto-securefile

Este comando converte um arquivo de texto sem formatação CVS para um arquivo XML seguro.

Sintaxe

xo-convertto-securefile

Parâmetros

Nome do arquivo de origem e destino são especificados.

A fonte deve ser um arquivo CSV com o seguinte formato:

hostname,

username,

password

host1,

user1,

pwd1

host2,

user2,

pwd2

Entrada

Nenhum. Nenhum objeto é conectado.

xo-credential - converter uma sequência de caracteres para um objeto PSCredential

O comando xo-credential permite converter uma sequência de caracteres de nome de usuário e senha para um objeto de credencial protegida, para uso em outros comandos que tenham objetos PSCredential como argumentos do comando.

Sintaxe

xo-credential <nome de usuário> <senha>

Exemplo

xo-credential jorgesantos mypword2

Comandos de controle

Esta seção descreve os comandos do CA ARCserve RHA PowerShell que permitem controlar os processos de DR e HA.

Diff-Scenario - Gerar um Relatório de diferenças

O comando Diff-Scenario permite gerar um relatório de diferenças para um determinado cenário.

Importante: não é recomendável iniciar um relatório de diferenças enquanto os dados estiverem sendo atualizados no Mestre, pois todas as atualizações ainda não aplicadas à réplica serão mostradas como diferenças.

Sintaxe
Diff-Scenario [-Name] <seqüência de caracteres> [-Mode] <seqüência de caracteres> [-Ignore] <booleano> 
Parâmetros
Nome

O nome do cenário cujo relatório você deseja gerar. É possível digitar vários nomes de cenários usando o comando Get-Scenario.

Modo

O modo de sincronização. Digite uma das seguintes opções:

B=Binário

F=Arquivo

Ignorar

Ignore arquivos com o mesmo nome e tamanho durante a comparação de dados. Digite uma das seguintes opções:

1=Sim

0= Não

Observação: para exibir o relatório de diferenças após sua criação, abra o Centro de relatórios, na página Visão geral, e selecione o relatório necessário.

Exemplo: gerar um relatório de diferenças

diff-scenario "File Server 1" F 1

Resultado:

Differences report is running for scenario File Server 1...
Concluído!

Export-Scenario - Exportar um cenário para um local especificado

O comando Export-Scenario permite que você exporte cenários para outros locais de modo a reutilizá-los. O cenário é exportado como um arquivo XMC e você pode especificar seu local.

Sintaxe
Export-Scenario [-Name] <String> [[-File] [<String>]] 
Parâmetros
Nome

O nome do cenário.

Arquivo (opcional)

O caminho completo do arquivo exportado. Se você não especificar um caminho, o arquivo será exportado para o diretório atual e terá o nome do cenário com a extensão .xmc.

Exemplo: exportar um cenário para um local especificado

export-scenario "File Server 1" C:\Scenarios

Resultado:

Scenario File Server 1 exported successfully to C:\Scenarios

Expose-Snapshot - Expor um instantâneo

O comando Expose-Snapshot permite expor um instantâneo. Você pode expor o instantâneo como uma pasta de leitura local, montando-o em uma pasta não utilizada, ou expô-lo como um volume de leitura local, montando-o em uma letra de unidade não utilizada.

Observações:

Sintaxe
Expose-Snapshot [-Name] <String> [-Index] <Int32> [-Path] <String> [-Port] <String>
Parâmetros
Nome

O nome do host cujo instantâneo você deseja expor.

Índice remissivo

O nº do índice do instantâneo, conforme retornado pelo comando Get-Snapshot.

Path

O caminho no qual você deseja expor o instantâneo. O caminho pode ser uma letra de unidade ou um caminho de pasta completa.

Porta (opcional)

A porta que é usada para se conectar ao host especificado. A porta padrão é 25000.

Exemplo: expor um instantâneo como um volume de leitura local

Expose-Snapshot 192.168.1.153 0 E: 25000

Resultado:

Snapshot {97127d0b-f1c9-4db5-943d-96c39b712fe6} mounted as E:

Import-scenario - importar um cenário para o gerenciador

O comando Import-Scenario permite importar um cenário, na forma de um arquivo XMC, a partir de um local especificado. Use essa opção se desejar realocar cenários de um serviço de controle em outro ou se desejar usar cenários antigos que foram mantidos no sistema.

Sintaxe
Import-Scenario [-File] <String> 
Parâmetros
Arquivo

O caminho completo do arquivo de cenário importado.

Observações:

Exemplo: importar um cenário de um local especificado para o gerenciador

import-scenario c:\scenarios

Resultado:

Scenario File Server 2 imported successfully from c:\scenarios

Mount-Snapshot - Montar um instantâneo

O comando Mount-Snapshot permite montar um instantâneo exposto. Você pode montar o instantâneo como uma pasta de leitura local em uma pasta não utilizada, ou montá-lo como um volume de leitura local em uma letra de unidade não utilizada.

Sintaxe
Mount-Snapshot [-Name] <String> [[-Index] [<Int32>]] [[-Path] [<String>]] [[-Port] [<String>]]
Parâmetros
Nome

O nome do host cujo instantâneo você deseja montar.

Índice remissivo

O nº do índice do instantâneo, conforme retornado pelo comando Get-Snapshot.

Path

O caminho no qual você deseja expor o instantâneo. O caminho pode ser uma letra de unidade ou um caminho de pasta completa.

Porta (opcional)

A porta que é usada para se conectar ao host especificado. A porta padrão é 25000.

Exemplo: montar um instantâneo como um volume de leitura local

mount-snapshot 192.168.1.153 0 F:

Resultado:

Snapshot {745d6ce9-d880-40bf-a0cb-d4f0114bb0f8} mounted as F:

Prepare-Reboot - Prepare um host para manutenção

O comando Prepare-Reboot permite executar procedimentos de manutenção, como a reinicialização de um host ou a movimentação de grupos entre nós de agrupamento da Microsoft, sem executar uma nova sincronização após a conclusão desses processos.

Os hosts que podem ser preparados para manutenção precisam participar de cenários em execução. A preparação é realizada em um host por vez, mas esse host pode participar de vários cenários. Nesses cenários, o host pode funcionar como mestre e de réplica. Quando um host participa de um cenário que não está em execução, a preparação relacionada a esse cenário não ocorrerá.

Após receber a mensagem informando que o host está preparando a reinicialização, reinicie o host ou alterne os grupos entre os nós do agrupamento. Concluídos os procedimentos de manutenção, o processo de replicação continua automaticamente, sem a necessidade de nova sincronização.

Observação: se depois de preparar o host para a manutenção, você decidir não reiniciá-lo e continuar executando os cenários, será necessário interromper os cenários e executá-los novamente.

Sintaxe
Prepare-Reboot [-Name] <String>
Parâmetros
Nome

O nome do host.

Exemplo: preparar um host de réplica para reinicialização

Prepare-Reboot QA95-W2K3-EX2

Resultado:

Host QA95-W2K3-EX2 Preparando para reinicialização

Recover-Scenario - Recuperar dados perdidos a partir da réplica para o mestre

O comando Recover-Scenario permite recuperar dados que foram perdidos no mestre transferindo-os de quaisquer hosts de réplicas que participam de um cenário. Isso é feito ativando-se um processo de sincronização na direção inversa: de uma réplica para o mestre. Quando você ativa o comando Recover-Scenario, precisa definir de qual host de réplica deseja recuperar os dados e se deseja excluir os dados existentes no mestre, exceto os da réplica, durante o processo de recuperação.

Importante: você deve interromper a replicação para iniciar a recuperação.

Para verificar se o processo de recuperação está concluído, use o comando Get-Events. Depois de obter uma mensagem informando-o que "O processo de recuperação foi concluído", você pode reiniciar o processo de replicação do mestre para a réplica usando o comando Run-Scenario.

Sintaxe
Recover-Scenario [-Name] <String> [-Host] <String> [-Mode] <String> [-Ignore] <Boolean> [-RemoveMasterFiles] <Boolean> [-RecoveryMode] <String> [-RebootAfterRecovery] <Boolean> 
Parâmetros
Nome

O nome do cenário.

Host

O host da réplica cujos dados você deseja recuperar.

Modo

O modo de sincronização. Digite uma das seguintes opções:

B=Binário

F=Arquivo

Ignorar

Ignore arquivos com o mesmo nome e tamanho durante a comparação de dados. Digite uma das seguintes opções:

1=Sim

0= Não

RemoveMasterFiles

Se deseja excluir os arquivos que existem apenas no mestre durante o processo de recuperação. Digite uma das seguintes opções:

1 = Sim, excluir arquivos que existem apenas no mestre

0 = Sim, excluir arquivos que existem apenas no mestre

RecoveryMode

O tipo de dados a ser recuperado. Digite uma das seguintes opções:

A = Dados do aplicativo

S = Dados do estado do sistema (somente se a opção Proteção do estado do sistema estiver ativa)

B = Os dois tipos de dados

O valor padrão é A.

RebootAfterRecovery

Se o host mestre deve ou não ser reinicializado após a conclusão do processo de recuperação. Digite uma das seguintes opções:

1 = Sim, reinicialize o mestre

2 = Não, não reinicialize o mestre

Exemplo: recuperar dados perdidos

Recover-Scenario "File Server 1" 192.168.1.153 F 1 0 A 2

Resultado:

Recover application data process started

Resume-IsAliveCheck - retoma a verificação de atividade de um cenário em execução

O comando Resume-IsAliveCheck permite retomar manualmente a verificação de atividade para um determinado cenário de alta disponibilidade em execução.

Sintaxe
Resume-IsAliveCheck [-ScenarioName] <String>
Parâmetros
ScenarioName

O nome do cenário de destino.

Exemplo: retomar a verificação de atividade de cenário de SQL

Resume-IsAliveCheck SQLscenario

Resultado:

Retoma a verificação de atividade periódica do cenário de SQL.