|
|
|
Ce chapitre décrit en détail l'utilisation des commandes CA ARCserve RHA PowerShell pour contrôler, modifier et surveiller les processus de réplication et de haute disponibilité. Les commandes sont affichées dans l'ordre alphabétique et se divisent en 4 groupes : Connexion, Enregistrement, Contrôle, Edition et Surveillance.
Ce chapitre traite des sujets suivants :
Commandes de connexion et d'enregistrement
Commandes de gestion des utilisateurs
Cette section décrit la connexion au service de contrôle, la déconnexion et la saisie de votre clé de licence pour l'enregistrement de CA ARCserve RHA.
Pour travailler avec les scénarios de réplication CA ARCserve RHA à l'aide de PowerShell, vous devez d'abord vous connecter à un service de contrôle utilisé comme point de contrôle pour le fonctionnement de CA ARCserve RHA. La commande Connect-XO vous permet de connecter PowerShell à un service de contrôle donné.
Remarque : Si vous n'avez plus besoin de CA ARCserve RHA PowerShell, déconnectez-vous du service de contrôle à l'aide de la commande Disconnect-XO. Si vous fermez la fenêtre PowerShell, PowerShell se déconnecte également du service de contrôle.
Connect-XO [-Host] <Chaîne> [-Credentials] <Informations_identificationPS> [[-Protocol] [<Chaîne>]] [[-Port] [<Chaîne>]]
Adresse IP ou nom d'hôte de l'ordinateur sur lequel est exécuté le service de contrôle.
Désigne le nom de domaine/d'utilisateur pour le service de contrôle. Ces informations d'identification doivent appartenir à un utilisateur disposant des droits d'administration sur le service de contrôle. Après avoir entré les informations d'identification, une boîte de dialogue Demande d'informations d'identification Windows PowerShell s'affiche et vous invite à saisir votre mot de passe.
Remarque : Pour ne pas avoir à saisir manuellement vos informations d'identification dans la boîte de dialogue Informations d'identificationPS, reportez-vous à la section Connexion de PowerShell à un service de contrôle à l'aide d'un script.
Protocole utilisé pour la connexion au service de contrôle. Saisissez l'un des protocoles suivants : http ou https.
Port TCP/IP utilisé pour la connexion au service de contrôle. Pour http, la valeur par défaut est 8088 ; pour https, la valeur par défaut est 443.
Exemple : Connexion à un service de contrôle
connect-xo 192.168.1.151 qa88-w3k3\administrator https
Résultat :
Une boîte de dialogue Demande d'informations d'identification Windows PowerShell s'affiche et vous invite à saisir votre mot de passe. Le message suivant s'affiche.
Connexion en cours... 192.168.1.151 connecté
Pour éviter de saisir manuellement les informations d'identification de l'utilisateur dans la boîte de dialogue Informations d'identificationPS, chiffrez votre mot de passe et exécutez-le en tant qu'objet.
Pour chiffrer votre mot de passe et l'exécuter en tant qu'objet :
Entrez les commandes suivantes, en indiquant votre mot de passe, et exécutez-les une seule fois :
read-host -assecurestring | convertfrom-securestring | out-file C:\ securestring.txt <mot_de_passe>
$pass = cat C:\securestring.txt | convertto-securestring
$mycred = new-object -typename System.Management.Automation.PSCredential -argumentlist <domaine\nom_utilisateur>, $pass
Connect -XO [-Host] <String> $mycred [[-Protocol][<String>]] [[-Port] [<String>]]
Le résultat est le même qu'avec une connexion standard :
Connexion en cours...
<adresse_IP> connectée
Pour plus d'informations, consultez la documentation de PowerShell documentation ou recherchez sur Internet.
Si vous n'avez plus besoin de CA ARCserve RHA PowerShell, déconnectez-vous du service de contrôle en cours d'exécution. La commande Disconnect-XO vous permet de déconnecter PowerShell du service de contrôle en cours d'exécution.
Remarque : Si vous fermez la fenêtre de PowerShell, l'application se déconnecte également du service de contrôle.
Disconnect-XO
Remarque : Cette commande n'a pas de paramètres. Elle déconnecte automatiquement le service de contrôle en cours d'exécution.
Exemple : Déconnexion d'un service de contrôle
disconnect-xo
Résultat :
192.168.1.151 déconnecté
La commande Get-License vous permet d'afficher les détails de la licence CA ARCserve RHA.
get-license
Exemple : Affichage des détails de la licence de CA ARCserve RHA
get-license
Résultat :
Clé : TVC2LF24FTU7G3WJ2QAFMCLGXA5KLPCCYIXTJTWX2MOZFU5GL7EJ3OYZQND7V3G123456
Société :
Délai d'expiration de la licence : 11 2009
Maintenance jusqu'au : 11 2009
Nombre de noeuds de la récupération garantie : 240
Nombre de noeuds du référentiel CDP : 240
Liste de produits :
- Serveur d'applications, édition Windows Cluster, 30 instances de haute disponibilité
- Serveur de fichiers, édition Windows Enterprise, 130 instances de haute disponibilité
- Serveur d'applications, édition Windows Enterprise, 130 instances de récupération après sinistre
- Serveur de fichiers, édition Windows Enterprise, 30 instances de récupération après sinistre
- Serveur d'applications, ordinateur virtuel, 100 instances de récupération après sinistre
- Serveur d'applications, ordinateur virtuel, 100 instances de haute disponibilité
La commande Set-License vous permet d'enregistrer CA ARCserve RHA au moyen d'une clé de licence. Vous devez disposer d'une clé d'enregistrement valide pour utiliser cette commande.
set-license
Clé de licence valide.
Exemple : enregistrement de CA ARCserve RHA à l'aide d'une clé de licence
set-license TVC2LF24FTU7G3WJ2QAFMCLGXA5KLPCCYIXTJTWX2MOZFU5GL7EJ3OYZQND7V3G123456
Résultat :
Clé correctement enregistrée
Cette commande lit tous les enregistrements d'identification dans le fichier XML indiqué et les ajoute au service de contrôle au moyen de la commande Add-Credential.
Syntaxe
xo-import-credential
Paramètres
Entrez le nom du fichier XML.
Entrée
Aucun. Aucun objet n'est redirigé vers xo-import-credential.
Cette commande convertit un fichier CSV de text simple en fichier XML sécurisé.
Syntaxe
xo-convertto-securefile
Paramètres
La destination et le nom de fichier sont spécifiés.
La source doit être un fichier CSV file au format suivant :
|
hostname, |
username, |
password |
|
host1, |
user1, |
pwd1 |
|
host2, |
user2, |
pwd2 |
Entrée
Aucun. Aucun objet n'est redirigé.
La commande xo-credential permet de convertir une chaîne de nom d'utilisateur et de mot de passe en objet d'identification sécurisé pour une utilisation avec d'autres commandes qui utilisent l'objet PSCredential en tant qu'arguments de commande.
Syntaxe
xo-credential <nom_utilisateur> <mot_passe>
Exemple
xo-credential johnsmith mypword2
Cette section décrit les commandes CA ARCserve RHA PowerShell qui permettent de contrôler les processus de réplication et de haute disponibilité.
La commande Diff-Scenario permet de générer un rapport comparatif pour un scénario donné.
Important : Nous vous déconseillons de lancer un rapport comparatif lorsqu'une mise à jour des données est en cours sur l'ordinateur maître, car toutes les mises à jour qui ne sont pas encore appliquées à l'ordinateur de réplication apparaîtront comme des différences.
Diff-Scenario [-Name] <Chaîne> [-Mode] <Chaîne> [-Ignore] <Valeur_booléenne>
Nom du scénario pour lequel vous souhaitez générer le rapport. Vous pouvez saisir plusieurs noms de scénarios en utilisant la commande Get-Scenario.
Mode de synchronisation. Choisissez l'une des valeurs suivantes :
B = binaire
F = fichier
Permet d'ignorer les fichiers portant le même nom et de la même taille pendant la comparaison des données. Choisissez l'une des valeurs suivantes :
1 = Oui
0 = Non
Remarque : Pour afficher le rapport comparatif après sa génération, ouvrez le centre de rapports dans la page de présentation et sélectionnez le rapport souhaité.
Exemple : Génération d'un rapport comparatif
diff-scenario "Serveur de fichiers 1" F 1
Résultat :
Le rapport comparatif est en cours d'exécution pour le scénario Serveur de fichiers 1... Terminé
La commande Export-Scenario vous permet d'exporter des scénarios vers d'autres emplacements en vue de les réutiliser. Le scénario est exporté sous forme de fichier XMC et vous pouvez spécifier son emplacement.
Export-Scenario [-Name] <Chaîne> [[-File] [<Chaîne>]]
Nom du scénario.
Chemin d'accès complet du fichier exporté. Si vous ne spécifiez pas de chemin, le fichier est exporté dans le répertoire actuel et porte le nom du scénario, suivi de l'extension .xmc.
Exemple : Exportation d'un scénario vers un emplacement spécifié
export-scenario "Serveur de fichiers 1" C:\Scenarios
Résultat :
Scénario Serveur de fichiers 1 exporté vers C:\Scenarios
La commande Expose-Snapshot vous permet d'exposer un cliché. Vous pouvez soit exposer le cliché sous forme de dossier local en lecture seule en le montant sur un dossier inutilisé, soit l'exposer sous forme de volume local en lecture seule en le montant sur une lettre de lecteur inutilisée.
Remarques :
Expose-Snapshot [-Name] <Chaîne> [-Index] <Int32> [-Path] <Chaîne> [-Port] <Chaîne>
Nom de l'hôte dont vous souhaitez exposer le cliché.
Numéro d'index de cliché renvoyé par la commande Get-Snapshot.
Chemin à utiliser pour exposer le cliché. Il peut s'agir soit d'une lettre de lecteur, soit d'un chemin de dossier complet.
Port utilisé pour la connexion à l'hôte. Le port par défaut est 25000.
Exemple : Exposition d'un cliché sous forme de volume local en lecture seule
Expose-Snapshot 192.168.1.153 0 E: 25000
Résultat :
Snapshot {97127d0b-f1c9-4db5-943d-96c39b712fe6} mounted as E:
La commande Import-Scenario permet d'importer un scénario, sous la forme d'un fichier XMC, à partir d'un emplacement spécifié. Utilisez cette option pour déplacer les scénarios d'un service de contrôle à un autre ou pour utiliser des scénarios plus anciens conservés sur votre système.
Import-Scenario [-File] <Chaîne>
Chemin d'accès complet du fichier de scénario importé.
Remarques :
Exemple : Importation d'un scénario d'un emplacement spécifié vers votre gestionnaire
import-scenario c:\scenarios
Résultat :
Scénario Serveur de Fichiers 2 importé à partir de c:\scenarios
La commande Mount-Snapshot vous permet de monter un cliché exposé. Vous pouvez soit monter le cliché sous forme de dossier local en lecture seule sur un dossier inutilisé, soit le monter sous forme de volume local en lecture seule sur une lettre de lecteur inutilisée.
Mount-Snapshot [-Name] <Chaîne> [[-Index] [<Int32>]] [[-Path] [<Chaîne>]] [[-Port] [<Chaîne>]]
Nom de l'hôte dont vous souhaitez afficher le cliché.
Numéro d'index de cliché renvoyé par la commande Get-Snapshot.
Chemin à utiliser pour exposer le cliché. Il peut s'agir soit d'une lettre de lecteur, soit d'un chemin de dossier complet.
Port utilisé pour la connexion à l'hôte. Le port par défaut est 25000.
Exemple : Montage d'un cliché sous forme de volume local en lecture seule
mount-snapshot 192.168.1.153 0 F:
Résultat :
Snapshot {745d6ce9-d880-40bf-a0cb-d4f0114bb0f8} mounted as F:
La commande Prepare-Reboot vous permet d'effectuer des opérations de maintenance, telles que le redémarrage d'un hôte ou le déplacement de groupes entre noeuds de cluster Microsoft, sans devoir effectuer de resynchronisation une fois ces processus terminés.
Les hôtes pouvant être préparés à des fins de maintenance doivent participer aux scénarios en cours d'exécution. La préparation est effectuée sur un hôte à la fois, mais ce dernier peut participer à plusieurs scénarios. Dans ces scénarios, l'hôte peut fonctionner à la fois en tant qu'hôte maître et en tant qu'hôte de réplication. Lorsqu'un hôte participe à un scénario qui n'est pas en cours d'exécution, la préparation liée à ce scénario ne se produit pas.
Après réception du message vous informant que l'hôte est prêt à redémarrer, vous pouvez redémarrer l'hôte ou permuter les groupes entre les noeuds de cluster. Une fois les opérations de maintenance terminées, le processus de réplication reprend automatiquement, sans procéder à une resynchronisation.
Remarque : Si, après avoir préparé l'hôte pour la maintenance, vous avez décidé de ne pas le redémarrer et de continuer à exécuter ses scénarios, vous devez arrêter les scénarios pour les exécuter de nouveau.
Prepare-Reboot [-Name] <Chaîne>
Nom de l'hôte
Exemple : Préparation d'un hôte de réplication pour le redémarrage
Prepare-Reboot QA95-W2K3-EX2
Résultat :
Host QA95-W2K3-EX2 Preparing for reboot
La commande Recover-Scenario vous permet de récupérer des données perdues sur l'ordinateur maître en les transférant à partir des hôtes de réplication participant à un scénario. Il faut pour ce faire activer un processus de synchronisation dans le sens inverse, c'est-à-dire de l'ordinateur de réplication vers l'ordinateur maître. Lorsque vous activez la commande Recover-Scenario, vous devez spécifier l'ordinateur de réplication à partir duquel vous souhaitez récupérer les données et indiquer si les données présentes sur l'ordinateur maître, mais pas sur l'ordinateur de réplication, doivent être supprimées pendant la récupération.
Important : Vous devez arrêter la réplication avant de lancer la récupération.
Pour vérifier que la récupération est terminée, utilisez la commande Get-Events. Après avoir reçu le message Le processus de récupération est terminé, vous pouvez redémarrer la réplication de l'ordinateur maître vers l'ordinateur de réplication en utilisant la commande Run-Scenario.
Recover-Scenario [-Name] <Chaîne> [-Host] <Chaîne> [-Mode] <Chaîne> [-Ignore] <Valeur_booléenne> [-RemoveMasterFiles] <Valeur_booléenne> [-RecoveryMode] <Chaîne> [-RebootAfterRecovery] <Valeur_booléenne>
Nom du scénario.
Hôte de réplication à partir duquel vous souhaitez récupérer les données.
Mode de synchronisation. Choisissez l'une des valeurs suivantes :
B = binaire
F = fichier
Permet d'ignorer les fichiers portant le même nom et de la même taille pendant la comparaison des données. Choisissez l'une des valeurs suivantes :
1 = Oui
0 = Non
Permet de supprimer ou non des fichiers existant uniquement sur l'ordinateur maître au cours du processus de récupération. Choisissez l'une des valeurs suivantes :
1 = Oui, supprimer les fichiers existant uniquement sur l'ordinateur maître
0 = Non, conserver les fichiers existant uniquement sur l'ordinateur maître
Type de données à récupérer. Choisissez l'une des valeurs suivantes :
A = Données d'applications
S = Données sur l'état du système (uniquement si l'option Protection de l'état du système est activée)
B = Les deux types de données
La valeur par défaut est A.
Redémarrer ou non l'hôte maître une fois le processus de récupération terminé. Choisissez l'une des valeurs suivantes :
1 = Oui, redémarrer l'ordinateur maître
2 = Non, ne pas redémarrer l'ordinateur maître
Exemple : Récupération des données perdues
Recover-Scenario "File Server 1" 192.168.1.153 F 1 0 A 2
Résultat :
Recover application data process started
La commande Resume-IsAliveCheck permet de reprendre manuellement le contrôle d'activation d'un scénario de haute disponibilité en cours d'exécution.
Resume-IsAliveCheck [-ScenarioName] <Chaîne>
Nom du scénario de destination.
Exemple : Reprise du contrôle d'activation de SQLscenario
Resume-IsAliveCheck SQLscenario
Résultat :
Reprend le contrôle d'activation périodique de SQLscenario.
| Copyright © 2012 CA. Tous droits réservés. | Envoyer un courriel à CA Technologies sur cette rubrique |