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: |
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.
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.
Connect-XO [-Host] <String> [-Credentials] <PSCredential> [[-Protocol] [<String>]] [[-Port] [<String>]]
La dirección IP o el nombre de host del equipo donde está ejecutándose el Servicio de control.
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.
El protocolo que se utiliza para conectar al Servicio de control. Introduzca http o https.
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!
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 | converfrom-securestring | out-file C:\ securestring.txt <password>
$pass = cat C:\securestring.txt | convert to-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.
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.
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!
El comando Get-License permite ver los detalles de licencia de CA ARCserve RHA.
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
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.
set-license
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
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.
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.
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
Esta sección describe los comandos de PowerShell de CA ARCserve RHA que permiten controlar los procesos de replicación y de alta disponibilidad.
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.
Diff-Scenario [-Name] <String> [-Mode] <String> [-Ignore] <Boolean>
El nombre del escenario para el cual desea generar el informe. Puede introducir varios nombres de escenario mediante el comando Get-scenario.
El modo de sincronización. Introduzca uno de los siguientes valores:
B=Binario
F=Archivo
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!
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.
Export-Scenario [-Name] <String> [[-File] [<String>]]
El nombre del escenario.
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
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:
Expose-Snapshot [-Name] <String> [-Index] <Int32> [-Path] <String> [-Port] <String>
El nombre del host cuya instantánea desea mostrar.
El número de índice de la instantánea, de la manera que lo devuelve el comando Get-Snapshot.
La ruta en la que quiere mostrar la instantánea. La ruta puede ser una letra de unidad o una ruta de carpeta completa.
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:
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.
Import-Scenario [-File] <String>
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
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.
Mount-Snapshot [-Name] <String> [[-Index] [<Int32>]] [[-Path] [<String>]] [[-Port] [<String>]]
El nombre del host cuya instantánea desea montar.
El número de índice de la instantánea, de la manera que lo devuelve el comando Get-Snapshot.
La ruta en la que quiere mostrar la instantánea. La ruta puede ser una letra de unidad o una ruta de carpeta completa.
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:
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.
Prepare-Reboot [-Name] <String>
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
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.
Recover-Scenario [-Name] <String> [-Host] <String> [-Mode] <String> [-Ignore] <Boolean> [-RemoveMasterFiles] <Boolean> [-RecoveryMode] <String> [-RebootAfterRecovery] <Boolean>
El nombre del escenario.
El host de réplica desde el que desea recuperar los datos.
El modo de sincronización. Introduzca uno de los siguientes valores:
B=Binario
F=Archivo
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
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
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.
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