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 gerenciamento do usuário
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.
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.
Connect-XO [-Host] <String> [-Credentials] <PSCredential> [[-Protocol] [<String>]] [[-Port] [<String>]]
O endereço IP ou nome do host do computador no qual o serviço de controle está em execução.
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.
O protocolo usado para se conectar ao serviço de controle. Digite um destes: http ou https.
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!
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.
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.
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!
O comando Get-License permite que você exiba os detalhes da licença do CA ARCserve RHA.
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
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.
set-license
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
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.
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.
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
Esta seção descreve os comandos do CA ARCserve RHA PowerShell que permitem controlar os processos de DR e HA.
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.
Diff-Scenario [-Name] <seqüência de caracteres> [-Mode] <seqüência de caracteres> [-Ignore] <booleano>
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.
O modo de sincronização. Digite uma das seguintes opções:
B=Binário
F=Arquivo
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!
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.
Export-Scenario [-Name] <String> [[-File] [<String>]]
O nome do cenário.
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
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:
Expose-Snapshot [-Name] <String> [-Index] <Int32> [-Path] <String> [-Port] <String>
O nome do host cujo instantâneo você deseja expor.
O nº do índice do instantâneo, conforme retornado pelo comando Get-Snapshot.
O caminho no qual você deseja expor o instantâneo. O caminho pode ser uma letra de unidade ou um caminho de pasta completa.
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:
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.
Import-Scenario [-File] <String>
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
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.
Mount-Snapshot [-Name] <String> [[-Index] [<Int32>]] [[-Path] [<String>]] [[-Port] [<String>]]
O nome do host cujo instantâneo você deseja montar.
O nº do índice do instantâneo, conforme retornado pelo comando Get-Snapshot.
O caminho no qual você deseja expor o instantâneo. O caminho pode ser uma letra de unidade ou um caminho de pasta completa.
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:
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.
Prepare-Reboot [-Name] <String>
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
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.
Recover-Scenario [-Name] <String> [-Host] <String> [-Mode] <String> [-Ignore] <Boolean> [-RemoveMasterFiles] <Boolean> [-RecoveryMode] <String> [-RebootAfterRecovery] <Boolean>
O nome do cenário.
O host da réplica cujos dados você deseja recuperar.
O modo de sincronização. Digite uma das seguintes opções:
B=Binário
F=Arquivo
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
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
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.
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
O comando Resume-IsAliveCheck permite retomar manualmente a verificação de atividade para um determinado cenário de alta disponibilidade em execução.
Resume-IsAliveCheck [-ScenarioName] <String>
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.
Copyright © 2012 CA. Todos os direitos reservados. | Enviar email à CA Technologies sobre este tópico |