Tema anterior: Información general de los comandos de PowerShell de CA ARCserve RHA

Tema siguiente: Resume-Scenario: cómo reanudar una replicación sobre un réplica suspendido

Uso de los comandos de PowerShell de CA ARCserve RHA

Este capítulo describe de forma detallada cómo utilizar los comandos de PowerShell de CA ARCserve RHA para controlar, editar y supervisar los procesos de replicación y de alta disponibilidad. Los comandos se muestran en orden alfabético y se dividen en cuatro grupos: conexión y registro, control, edición y supervisión.

Esta sección contiene los siguientes temas:

Comandos de conexión y de registro

Comandos de control

Editar comandos

Comandos de supervisión

Comandos de gestión de usuarios

Comandos de conexión y de registro

Esta sección describe cómo conectarse al Servicio de control, cómo desconectarse de él y cómo introducir la clave de licencia para el registro de CA ARCserve RHA.

Connect-XO: cómo conectar PowerShell a un Servicio de control

Para trabajar con escenarios de CA ARCserve RHA mediante PowerShell, lo primero que debe hacer es conectarse al Servicio de control, que actúa como el punto de control del funcionamiento de CA ARCserve RHA. El comando Connect-XO permite conectar PowerShell a un Servicio de control específico.

Nota: Una vez que haya terminado de trabajar con PowerShell de CA ARCserve RHA, no olvide desconectarlo del Servicio de control con el comando Disconnect-XO. Al cerrar la ventana PowerShell, PowerShell se desconecta del Servicio de control.

Sintaxis
Connect-XO [-Host] <String> [-Credentials] <PSCredential> [[-Protocol] [<String>]] [[-Port] [<String>]]
Parámetros
hosts

La dirección IP o el nombre de host del equipo donde está ejecutándose el Servicio de control.

Credentials\PSCredentials

El nombre de dominio\usuario para el Servicio de control. Estas credenciales deben pertenecer a un usuario que tiene derechos de administrador en el Servicio de control. Tras introducir las credenciales, aparecerá el cuadro de diálogo Solicitud de credenciales de Windows PowerShell, indicándole que introduzca su contraseña.

Nota: Para no tener que introducir las credenciales de forma manual en el cuadro de diálogo PSCredentials, consulte Conexión de PowerShell a un Servicio de control mediante una secuencia de comandos.

Protocolo

El protocolo que se utiliza para conectar al Servicio de control. Introduzca http o https.

Puerto (opcional)

El puerto de TCP/IP que se utiliza para conectar al Servicio de control. El valor predeterminado para http es 8088; para https es 443.

Ejemplo: conexión a un Servicio de control

connect-xo 192.168.1.151 qa88-w3k3\administrator https

Resultado

Aparecerá el cuadro de diálogo Solicitud de credenciales de Windows PowerShell, indicándole que introduzca su contraseña. A continuación, realice lo siguiente:

Connecting...
192.168.1.151 connected!

Conexión de PowerShell a un Servicio de control mediante una secuencia de comandos

Puede evitar la introducción de las credenciales de forma manual en el cuadro de diálogo PSCredentials. Para ello, cifre la contraseña y ejecútela como un objeto.

Cómo cifrar la contraseña y ejecutarla como un objeto

Introduzca los comandos siguientes, utilizando la contraseña donde se le indique y, a continuación, ejecute:

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>]]

El resultado es el mismo que en una conexión estándar:

Connecting...
<IP Address> connected! 

Para obtener más información, consulte la documentación de PowerShell o busque en internet.

Disconnect-XO: cómo desconectar PowerShell de un Servicio de control

Cuando haya terminado de trabajar con PowerShell de CA ARCserve RHA, deberá desconectarse del Servicio de control en ejecución. El comando Disconnect-XO permite conectar PowerShell a un Servicio de control específico.

Nota: Al cerrar la ventana PowerShell, PowerShell se desconecta del Servicio de control.

Sintaxis
Disconnect-XO

Nota: Este comando no tiene parámetros. Desconecta automáticamente el Servicio de control en ejecución.

Ejemplo: desconexión de un Servicio de control

disconnect-xo

Resultado:

192.168.1.151 disconnected!

Get-License: cómo mostrar la licencia de CA ARCserve RHA

El comando Get-License permite ver los detalles de licencia de CA ARCserve RHA.

Sintaxis
get-license

Ejemplo: cómo mostrar los detalles de licencia de CA ARCserve RHA

get-license

Resultado:

Key: TVC2LF24FTU7G3WJ2QAFMCLGXA5KLPCCYIXTJTWX2MOZFU5GL7EJ3OYZQND7V3G123456
Company:
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
- File server, Windows Enterprise edition, 130 instances HA
- Application Server, Windows Enterprise edition, 130 instances DR
- File server, Windows Enterprise edition, 30 instances DR
- Application Server, Virtual Machine, 100 instances DR
- Application Server, Virtual Machine, 100 instances HA

Set-License: registro de CA ARCserve RHA

El comando Set-License permite registrar CA ARCserve RHA mediante una clave de licencia. Necesita tener una clave de registro válida antes de utilizar este comando.

Sintaxis
set-license
Parámetros
Clave

Una clave de licencia válida.

Ejemplo: cómo registrar CA ARCserve RHA mediante una clave de licencia

set-license TVC2LF24FTU7G3WJ2QAFMCLGXA5KLPCCYIXTJTWX2MOZFU5GL7EJ3OYZQND7V3G123456

Resultado:

Key registered successfully
















xo-import-credential

Este comando lee todos los registros de credencial en el archivo XML dado y los agrega al Servicio de control al cual está conectado, a través del comando Add-Credential.

Sintaxis

xo-import-credential

Parámetros

Especifica el nombre del archivo XML.

Entrada

Ninguno. Ningún objeto se canaliza a xo-import-credential.

xo-convertto-securefile

Este comando convierte un archivo de CSV de texto sin formato a un archivo XML seguro.

Sintaxis

xo-convertto-securefile

Parámetros

Se especifican el nombre de archivo de origen y destino.

El origen debería ser un archivo de CSV con el formato siguiente:

hostname,

username,

password

host1,

user1,

pwd1

host2,

user2,

pwd2

Entrada

Ninguno. No se ha canalizado ningún objeto.

xo-credential: cómo convertir una cadena en un objeto de PSCredential

El comando xo-credential permite convertir una cadena de nombre de usuario y contraseña en un objeto de credenciales seguro, para el uso de otros comandos que entienden los objetos de PSCredential como argumentos de comando.

Sintaxis

xo-credential <username> <password>

Ejemplo

xo-credential johnsmith mypword2

Comandos de control

Esta sección describe los comandos de PowerShell de CA ARCserve RHA que permiten controlar los procesos de replicación y de alta disponibilidad.

Diff-Scenario: cómo generar un informe de diferencias

El comando Diff-Scenario permite generar un informe de diferencias para un escenario en concreto.

Importante: no es aconsejable iniciar el informe de diferencias cuando se están actualizando los datos del servidor master, ya que todas las actualizaciones que todavía no se hayan aplicado en el réplica aparecerán como diferencias.

Sintaxis
Diff-Scenario [-Name] <String> [-Mode] <String> [-Ignore] <Boolean> 
Parámetros
Nombre

El nombre del escenario para el cual desea generar el informe. Puede introducir varios nombres de escenario mediante el comando Get-scenario.

Modo

El modo de sincronización. Introduzca uno de los siguientes valores:

B=Binario

F=Archivo

Ignorar

Ignora los archivos con el mismo nombre y tamaño durante la comparación de datos. Introduzca uno de los siguientes valores:

1=Sí

0= No

Nota: Para ver el informe de diferencias una vez generado, abra el Centro de informes en la Página de presentación y seleccione el informe requerido.

Ejemplo: cómo generar un informe de diferencias

diff-scenario "File Server 1" F 1

Resultado:

Differences report is running for scenario File Server 1...
Done!

Export-Scenario: cómo exportar un escenario a una ubicación especificada

El comando Export-Scenario permite exportar escenarios a otras ubicaciones para reutilizarlos. El escenario se exporta como un archivo XMC, y se puede especificar su ubicación.

Sintaxis
Export-Scenario [-Name] <String> [[-File] [<String>]] 
Parámetros
Nombre

El nombre del escenario.

Archivo (opcional)

La ruta completa del archivo exportado. Si no especifica una ruta, el archivo se exportará al directorio actual y llevará el nombre del escenario con la extensión .xmc.

Ejemplo: cómo exportar un escenario a una ubicación especificada

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

Resultado:

Scenario File Server 1 exported successfully to C:\Scenarios

Expose-Snapshot: cómo mostrar una instantánea

El comando Expose-Snapshot permite mostrar una instantánea. Puede mostrar la instantánea como una carpeta local de sólo lectura (para ello, móntela en una carpeta no utilizada) o como volumen local de sólo lectura (para ello, móntela en una letra de unidad no utilizada).

Notas:

Sintaxis
Expose-Snapshot [-Name] <String> [-Index] <Int32> [-Path] <String> [-Port] <String>
Parámetros
Nombre

El nombre del host cuya instantánea desea mostrar.

Índice

El número de índice de la instantánea, de la manera que lo devuelve el comando Get-Snapshot.

Ruta

La ruta en la que quiere mostrar la instantánea. La ruta puede ser una letra de unidad o una ruta de carpeta completa.

Puerto (opcional)

El puerto que se utiliza para conectarse con el host indicado. El puerto predeterminado es 25000.

Ejemplo: muestra de una instantánea como volumen local de sólo lectura

Expose-Snapshot 192.168.1.153 0 E: 25000

Resultado:

Snapshot {97127d0b-f1c9-4db5-943d-96c39b712fe6} se monta como E:

Import-Scenario: cómo importar un escenario al gestor

El comando Import-Scenario permite importar un escenario, en forma de archivo de XMC, desde una ubicación especificada. De un Servicio de control a otro, o si desea utilizar escenarios anteriores que se han guardado en el sistema.

Sintaxis
Import-Scenario [-File] <String> 
Parámetros
Archivo

La ruta completa del archivo de escenario importado.

Notas:

Ejemplo: cómo importar un escenario desde una ubicación especificada al gestor

import-scenario c:\scenarios

Resultado:

Scenario File Server 2 imported successfully from c:\scenarios

Mount-Snapshot: cómo montar una instantánea

El comando Mount-Snapshot permite montar una instantánea mostrada. Puede montar la instantánea como una carpeta local de sólo lectura en una carpeta no utilizada o como un volumen local de sólo lectura en una letra de unidad no utilizada.

Sintaxis
Mount-Snapshot [-Name] <String> [[-Index] [<Int32>]] [[-Path] [<String>]] [[-Port] [<String>]]
Parámetros
Nombre

El nombre del host cuya instantánea desea montar.

Índice

El número de índice de la instantánea, de la manera que lo devuelve el comando Get-Snapshot.

Ruta

La ruta en la que quiere mostrar la instantánea. La ruta puede ser una letra de unidad o una ruta de carpeta completa.

Puerto (opcional)

El puerto que se utiliza para conectarse con el host indicado. El puerto predeterminado es 25000.

Ejemplo: montaje de una instantánea como volumen local de sólo lectura

mount-snapshot 192.168.1.153 0 F:

Resultado:

Snapshot {745d6ce9-d880-40bf-a0cb-d4f0114bb0f8} montada como F:

Prepare-Reboot: cómo preparar un host para el mantenimiento

El comando Prepare-Reboot permite realizar procedimientos de mantenimiento como, por ejemplo, reiniciar un host o mover grupos entre los nodos de clúster de Microsoft, sin realizar la resincronización al finalizar los procesos.

Es necesario que los host que se pueden preparar para mantenimiento participen en escenarios en ejecución. La preparación se realiza en un host cada vez, pero este host puede participar en varios escenarios. En estos escenarios, el host puede funcionar como servidor master y como réplica. Cuando un host participa en un escenario que no está en ejecución, no se producirá la preparación relativa a este escenario.

Después de recibir el mensaje que le informa de que el host está preparándose para el reinicio, puede reiniciar el host o conmutar grupos entre nodos de clúster. Una vez finalizados los procedimientos de mantenimiento, el proceso de replicación se reanuda automáticamente, sin realizar la sincronización.

Nota: Si después de preparar el host para el mantenimiento, decide no reiniciarlo y continuar ejecutando los escenarios, deberá detener los escenarios y volverlos a ejecutar.

Sintaxis
Prepare-Reboot [-Name] <String>
Parámetros
Nombre

El nombre de host.

Ejemplo: cómo preparar un host de réplica para el reinicio

Prepare-Reboot QA95-W2K3-EX2

Resultado:

Host QA95-W2K3-EX2 Preparing for reboot

Recover-Scenario: cómo recuperar los datos perdidos desde el réplica en el master

El comando Recover-Scenario permite recuperar datos que se han perdido en el servidor master. Para ello, los transfiere desde cualquiera de los host de réplica que forman parte del escenario. Para ello, se activa un proceso de sincronización en dirección inversa, esto es, desde un réplica al master. Si activa el comando Recover-Scenario, deberá definir desde qué host de réplica desea recuperar los datos y si desea borrar los datos presentes en el master (pero no en el réplica) durante el proceso de recuperación.

Importante: para iniciar la recuperación debe detener la replicación.

Para comprobar que el proceso de recuperación ha finalizado, utilice el comando Get-Events. Cuando aparezca un mensaje comunicándole que el proceso de recuperación ha finalizado, puede reiniciar el proceso de replicación desde el master al réplica. Para ello, utilice elcomando Run-Scenario.

Sintaxis
Recover-Scenario [-Name] <String> [-Host] <String> [-Mode] <String> [-Ignore] <Boolean> [-RemoveMasterFiles] <Boolean> [-RecoveryMode] <String> [-RebootAfterRecovery] <Boolean> 
Parámetros
Nombre

El nombre del escenario.

hosts

El host de réplica desde el que desea recuperar los datos.

Modo

El modo de sincronización. Introduzca uno de los siguientes valores:

B=Binario

F=Archivo

Ignorar

Ignora los archivos con el mismo nombre y tamaño durante la comparación de datos. Introduzca uno de los siguientes valores:

1=Sí

0= No

RemoveMasterFiles

Si desea eliminar los archivos que existen sólo en el servidor master durante el proceso de recuperación. Introduzca uno de los siguientes valores:

1 = Sí, eliminar los archivos que existen sólo en el master

0 = No, mantener los archivos que existen sólo en el master

RecoveryMode

El tipo de datos que desea recuperar. Introduzca uno de los siguientes valores:

A = Datos de aplicación

S = Datos del estado de sistema (sólo si la opción Protección del estado del sistema está activa)

B = Ambos tipos de datos

El valor predeterminado es A.

RebootAfterRecovery

Si reiniciar el host master cuando haya finalizado el proceso de recuperación. Introduzca uno de los siguientes valores:

1 = Sí, reiniciar el host master

2 = No, no reiniciar el host master

Ejemplo: recuperación de datos perdidos

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

Resultado:

Recover application data process started

Resume-IsAliveCheck: Cómo reanudar lResume-IsAliveCheck de un escenario en ejecución

El comando Resume-IsAliveCheck permite reanudar manualmente la comprobación de monitorización de un escenario de alta disponibilidad proporcionado.

Sintaxis
Resume-IsAliveCheck [-ScenarioName] <String>
Parámetros
ScenarioName

El nombre del escenario de destino.

Ejemplo: Resume-IsAliveCheck comprobación del escenario SQL

Resume-IsAliveCheck escenario SQL

Resultado:

Reanuda la comprobación de monitorización periódica del escenario SQL.