Vorheriges Thema: Informationen zu CA ARCserve RHA-PowerShell-Befehlen

Nächstes Thema: Resume-Scenario - Wiederaufnehmen der Replikation auf einem angehaltenen Replikatserver

Verwenden von CA ARCserve RHA-PowerShell-Befehlen

In diesem Kapitel wird ausführlich beschrieben, wie Sie mit CA ARCserve RHA-PowerShell-Befehlen die Replikations- und HA-Vorgänge steuern, bearbeiten und überwachen können. Die Befehle sind alphabetisch geordnet und in vier Gruppen eingeteilt: Verbindung und Registrierung, Steuerung, Bearbeitung sowie Überwachung.

Dieses Kapitel enthält folgende Themen:

Herstellen von Verbindungen mit und Registrieren von Befehlen

Steuerbefehle

Bearbeiten von Befehlen

Überwachen von Befehlen

Benutzerverwaltungsbefehle

Herstellen von Verbindungen mit und Registrieren von Befehlen

In diesem Abschnitt wird beschrieben, wie Sie eine Verbindung zum Steuerungsdienst herstellen, wie Sie diese trennen, und wie Sie Ihren Lizenzschlüssel für die Registrierung von CA ARCserve RHA eingeben.

Connect-XO - Verbinden der PowerShell mit einem Steuerungsdienst

Um unter Verwendung der PowerShell mit CA ARCserve RHA-Szenarien arbeiten zu können, müssen Sie zunächst eine Verbindung zu dem Steuerungsdienst herstellen, der als Kontrollpunkt für den Betrieb von CA ARCserve RHA fungiert. Mit Hilfe des Befehls Connect-XO können Sie die PowerShell mit einem bestimmten Steuerungsdienst verbinden.

Hinweis: Wenn Sie die Arbeit mit der CA ARCserve RHA-PowerShell beendet haben, sollten Sie daran denken, die Verbindung mit dem Steuerungsdienst anschließend mit Hilfe des Befehls Disconnect-XO wieder zu trennen. Wenn Sie das Fenster der PowerShell schließen, wird gleichzeitig die Verbindung der PowerShell mit dem Steuerungsdienst getrennt.

Syntax
Connect-XO [-Host] <Zeichenfolge> [-Anmeldeinformationen] <PowerShell-Anmeldeinformationen> [[-Protokoll] [<Zeichenfolge>]] [[-Port] [<Zeichenfolge>]]
Parameter
Host

IP-Adresse oder Hostname des Computers, auf dem der Steuerungsdienst ausgeführt wird.

Anmeldeinformationen\PowerShell-Anmeldeinformationen

Domäne oder Benutzername für den Steuerungsdienst. Diese Anmeldeinformationen müssen zu einem Benutzer gehören, der über Administratorrechte für den Steuerungsdienst verfügt. Wenn Sie die Anmeldeinformationen eingegeben haben, wird das Dialogfeld mit der Aufforderung zur Eingabe der Anmeldeinformationen für die Windows PowerShell eingeblendet, und Sie werden aufgefordert, Ihr Kennwort einzugeben.

Hinweis: Wie Sie vermeiden, dass Sie Ihre Anmeldeinformationen manuell in das Dialogfeld PowerShell-Anmeldeinformationen eingeben müssen, finden Sie unter Verbinden der PowerShell mit einem Steuerungsdienst unter Verwendung eines Skripts.

Protokoll

Das Protokoll, das für die Verbindung mit dem Steuerungsdienst verwendet wird. Geben Sie entweder http oder https ein.

Port (optional)

Der TCP-/IP-Port, der für die Verbindung mit dem Steuerungsdienst verwendet wird. Für http ist der Standardwert 8088 und für https 443.

Beispiel: Verbinden mit einem Steuerungsdienst

connect-xo 192.168.1.151 qa88-w3k3\administrator https

Ergebnis

Ein Dialogfeld mit der Aufforderung zur Eingabe der Anmeldeinformationen für die Windows PowerShell wird eingeblendet, und Sie werden aufgefordert, Ihr Kennwort einzugeben. Dann geschieht Folgendes:

Verbindung wird hergestellt...
192.168.1.151 verbunden!

Verbinden der PowerShell mit einem Steuerungsdienst unter Verwendung eines Skripts

Sie können das Erfordernis umgehen, Ihre Anmeldeinformationen manuell in das Dialogfeld PowerShell-Anmeldeinformationen eingeben zu müssen, indem Sie Ihr Kennwort verschlüsseln und es als Objekt ausführen.

So verschlüsseln Sie Ihr Kennwort und führen es als Objekt aus

Geben Sie folgende Befehle ein, verwenden Sie Ihr Kennwort dabei wo angegeben, und führen Sie es einmal aus.

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

Das Ergebnis ist dasselbe wie bei einer Standardverbindung:

Verbindung wird hergestellt...
<IP -Adresse> verbunden! 

Weitere Informationen finden Sie in der Dokumentation zu PowerShell oder im Internet.

Disconnect: XO: Trennen der Verbindung mit einem Steuerungsdienst

Wenn Sie die Arbeit mit der CA ARCserve RHA-PowerShell beendet haben, müssen Sie die Verbindung mit dem ausgeführten Steuerungsdienst trennen. Mit Hilfe des Befehls Disconnect-XO können Sie die Verbindung der PowerShell mit dem Steuerungsdienst trennen.

Hinweis: Wenn Sie das Fenster der PowerShell schließen, wird gleichzeitig die Verbindung der PowerShell mit dem Steuerungsdienst getrennt.

Syntax
Disconnect-XO

Hinweis: Dieser Befehl verfügt nicht über Parameter. Er trennt die Verbindung mit dem Steuerungsdienst automatisch.

Beispiel: Trennen der Verbindung mit einem Steuerungsdienst

Disconnect-XO

Ergebnis:

192.168.1.151 getrennt!

Get-License - Anzeigen Ihrer CA ARCserve RHA-Lizenz

Mit Hilfe des Befehls Get-License können Sie die Einzelheiten Ihrer CA ARCserve RHA-Lizenz anzeigen.

Syntax
get-license

Beispiel: Anzeigen der Einzelheiten Ihrer CA ARCserve RHA-Lizenz

get-license

Ergebnis:

Schlüssel: "TVC2LF24FTU7G3WJ2QAFMCLGXA5KLPCCYIXTJTWX2MOZFU5GL7EJ3OYZQND7V3G123456"
Firma:
Ablauf der Lizenz: 11  2009
Wartung bis: 11  2009
Anzahl der Assured Recovery-Knoten:240
Anzahl der CDP-Repository-Knoten:240

Produktliste:
- Anwendungsserver, Windows Cluster Edition, HA mit 30 Instanzen
- Dateiserver, Windows Enterprise Edition, HA mit 130 Instanzen
- Anwendungsserver, Windows Enterprise Edition, DR mit 130 Instanzen
- Dateiserver, Windows Enterprise Edition, DR mit 30 Instanzen
- Anwendungsserver, virtueller Rechner, DR mit 100 Instanzen
- Anwendungsserver, virtueller Rechner, HA mit 100 Instanzen

Set-License - Registrieren von CA ARCserve RHA

Mit Hilfe des Befehls Set-License können Sie CA ARCserve RHA durch einen Lizenzschlüssel registrieren. Sie müssen über einen gültigen Registrierungsschlüssel verfügen, bevor Sie diesen Befehl verwenden können.

Syntax
set-license
Parameter
Schlüssel

Einen gültigen Lizenzschlüssel.

Beispiel: Registrieren von CA ARCserve RHA mit einem Lizenzschlüssel

set-license TVC2LF24FTU7G3WJ2QAFMCLGXA5KLPCCYIXTJTWX2MOZFU5GL7EJ3OYZQND7V3G123456

Ergebnis:

Schlüssel erfolgreich registriert
















xo-Import-credential

Dieser Befehl liest alle Credential-Datensätze in der jeweiligen XML-Datei und fügt sie über den Befehl Add-Credential zu dem verbundenen Steuerungsdienst hinzu.

Syntax

xo-Import-credential

Parameter

Geben Sie den Namen der XML-Datei an.

Eingabe

Keine. Kein Objekt wird an xo-import-credential geleitet.

xo-convertto-securefile

Dieser Befehl konvertiert eine CVS-Datei in unformatiertem Textformat in eine gesicherte XML-Datei.

Syntax

xo-convertto-securefile

Parameter

Der Name der Quelldatei und des Ziels werden angegeben.

Die Quelle sollte eine CSV-Datei mit folgendem Format sein:

hostname,

username,

password

host1,

user1,

pwd1

host2,

user2,

pwd2

Eingabe

Keinen. Kein Objekt wird weitergeleitet.

xo-credential - Konvertieren einer Zeichenfolge in ein PowerShell-Anmeldeinformations-Objekt

Der Befehl xo-credential ermöglicht es Ihnen, eine Benutzernamen- und Kennwortzeichenfolge in ein gesichertes Anmeldeinformations-Objekt zu konvertieren, das innerhalb anderer Befehle, die PowerShell-Anmeldeinformations-Objekte als Befehlsargumente betrachten, verwendet werden kann.

Syntax

xo-credential <username> <password>

Beispiel

xo-credential johnsmith mypword2

Steuerbefehle

In diesem Abschnitt werden CA ARCserve RHA-PowerShell-Befehle beschrieben, mit denen Sie die Replikations- und HA-Vorgänge steuern können.

Diff-Scenario - Erstellen von Vergleichsberichten

Mit Hilfe des Befehls Diff-Scenario können Sie für ein bestimmtes Szenario einen Vergleichsbericht erstellen.

Wichtig! Es ist nicht empfehlenswert, einen Vergleichsbericht zu initiieren, während Daten auf dem Master aktualisiert werden, da alle Aktualisierungen, die auf dem Replikat noch nicht vorgenommen wurden, als Unterschied angezeigt werden.

Syntax
Diff-Scenario [-Name] <Zeichenfolge> [-Modus] <Zeichenfolge> [-Ignorieren] <Boolesch> 
Parameter
Name

Der Name des Szenarios, für das Sie den Bericht erstellen möchten. Sie können mehrere Szenarionamen eingeben, indem Sie den Befehl Get-Scenario verwenden.

Modus

Der Synchronisationsmodus. Geben Sie eine der folgenden Angaben ein:

B=Binary (Binär)

F=File (Datei)

Ignorieren

Ignorieren von Dateien mit gleichem Namen und gleicher Größe beim Datenvergleich. Geben Sie eine der folgenden Angaben ein:

1=Ja

0= Nein

Hinweis: Um den erstellten Vergleichsbericht anzuzeigen, öffnen Sie in der Übersichtsseite das "Report-Center" und wählen den gewünschten Bericht aus.

Beispiel: Erstellen von Vergleichsberichten

diff-scenario "Dateiserver 1" F 1

Ergebnis:

Vergleichsbericht wird erstellt für Szenario Dateiserver 1...
Fertig

Export-Scenario - Exportieren von Szenarien an einen angegebenen Speicherort

Mit Hilfe des Befehls Export-Scenario können Sie Szenarien zur Wiederverwendung an andere Speicherorte exportieren. Das Szenario wird als XMC-Datei exportiert, und Sie können den Speicherort angeben.

Syntax
Export-Scenario [-Name] <Zeichenfolge> [[-Datei] [<Zeichenfolge>]] 
Parameter
Name

Der Szenarioname.

Datei (optional)

Der vollständige Pfad der exportierten Datei. Wenn Sie keinen Pfad angeben, wird die Datei in das aktuelle Verzeichnis exportiert und trägt den Namen des Szenarios mit der Erweiterung ".xmc".

Beispiel: Exportieren von Szenarien an einen angegebenen Speicherort

export-scenario "Dateiserver 1" C:\Szenarien

Ergebnis:

Szenario Dateiserver 1 erfolgreich exportiert in C:\Szenarien

Expose-Snapshot: Anzeigen von Snapshots

Mit dem Befehl Expose-Snapshot können Sie einen Snapshot anzeigen. Sie können den Snapshot entweder als lokalen, schreibgeschützten Ordner anzeigen, indem Sie ihn in einen nicht verwendeten Ordner laden, oder ihn als lokales, schreibgeschütztes Volume anzeigen, indem Sie ihn unter einem nicht verwendeten Laufwerksbuchstaben laden.

Hinweise:

Syntax
Expose-Snapshot [-Name] <Zeichenfolge> [-Index] <Int32> [-Pfad] <Zeichenfolge> [-Port] <Zeichenfolge>
Parameter
Name

Der Name des Hosts, dessen Snapshot Sie anzeigen möchten.

Index

Die Indexnummer des Snapshot, wie vom Befehl Get-Snapshot zurückgegeben.

Pfad

Der Pfad, unter dem Sie den Snapshot anzeigen möchten. Der Pfad kann entweder ein Laufwerksbuchstabe oder ein vollständiger Ordnerpfad sein.

Port (optional)

Der Port, der für die Verbindung mit dem vorgegebenen Host verwendet wird. Die standardmäßige Port-Nummer lautet 25000.

Beispiel: Anzeigen eines Snapshots als lokales, schreibgeschütztes Volume

Expose-Snapshot 192.168.1.153 0 E: 25000

Ergebnis:

Snapshot {97127d0b-f1c9-4db5-943d-96c39b712fe6} geladen als E:

Import-Scenario - Importieren von Szenarien in den Manager

Mit Hilfe des Befehls Import-Scenario können Sie Szenarien als XMC-Dateien von einem angegebenen Speicherort importieren. Verwenden Sie diese Option, wenn Sie Szenarien von einem Steuerungsdienst zu einem anderen verschieben möchten, oder wenn Sie ältere Szenarien verwenden möchten, die im System gespeichert wurden.

Syntax
Import-Scenario [-Datei] <Zeichenfolge> 
Parameter
Datei

Der vollständige Pfad der importierten Szenariodatei.

Hinweise:

Beispiel: Importieren von Szenarien von einem angegebenen Speicherort in den Manager

import-scenario C:\Szenarien

Ergebnis:

Szenario Dateiserver 2 erfolgreich importiert aus C:\Szenarien

Mount-Snapshot: Laden von Snapshots

Mit dem Befehl Mount-Snapshot können Sie einen angezeigten Snapshot laden. Sie können den Snapshot entweder als lokalen, schreibgeschützten Ordner in einen nicht verwendeten Ordner laden oder ihn als lokales, schreibgeschütztes Volume unter einem nicht verwendeten Laufwerksbuchstaben laden.

Syntax
Mount-Snapshot [-Name] <Zeichenfolge> [[-Index] [<Int32>]] [[-Pfad] [<Zeichenfolge>]] [[-Port] [<Zeichenfolge>]]
Parameter
Name

Der Name des Hosts, dessen Snapshot Sie laden möchten.

Index

Die Indexnummer des Snapshot, wie vom Befehl Get-Snapshot zurückgegeben.

Pfad

Der Pfad, unter dem Sie den Snapshot anzeigen möchten. Der Pfad kann entweder ein Laufwerksbuchstabe oder ein vollständiger Ordnerpfad sein.

Port (optional)

Der Port, der für die Verbindung mit dem vorgegebenen Host verwendet wird. Die standardmäßige Port-Nummer lautet 25000.

Beispiel: Laden eines Snapshots als lokales, schreibgeschütztes Volume

mount-snapshot 192.168.1.153 0 F:

Ergebnis:

Snapshot {745d6ce9-d880-40bf-a0cb-d4f0114bb0f8} geladen als F:

Prepare-Reboot: Vorbereiten eines Hosts für eine Wartung

Mit dem Befehl Prepare-Reboot können Sie Wartungsprozeduren ausführen, z. B. das Neustarten von Hosts oder das Verschieben von Gruppen zwischen Microsoft Cluster-Knoten, ohne dass nach dem Abschluss dieser Vorgänge eine Resynchronisation erforderlich ist.

Die Hosts, die für die Wartung vorbereitet werden können, müssen an laufenden Szenarien teilnehmen. Die Hosts werden einzeln vorbereitet, jeder Host kann allerdings an mehreren Szenarien teilnehmen. In diesen Szenarien kann der Host sowohl als Master als auch als Replikat fungieren. Wenn ein Host an einem Szenario teilnimmt, das nicht ausgeführt wird, wird die Vorbereitung für dieses Szenario nicht durchgeführt.

Nachdem die Meldung angezeigt wurde, die Sie darüber informiert, dass der Host für einen Neustart vorbereitet ist, können Sie den Host neu starten oder Gruppen zwischen Cluster-Knoten wechseln. Nach Abschluss der Wartung wird die Replikation automatisch wiederaufgenommen, ohne dass eine Neusynchronisation durchgeführt wird.

Hinweis: Falls Sie sich nach der Vorbereitung eines Hosts auf die Wartung entscheiden, den Host nicht neu zu starten und dessen Szenarien weiterhin auszuführen, müssen Sie die Szenarien beenden und erneut ausführen.

Syntax
Prepare-Reboot [-Name] <Zeichenfolge>
Parameter
Name

Der Hostname.

Beispiel: Vorbereiten eines Replikat-Hosts für den Neustart

Prepare-Reboot QA95-W2K3-EX2

Ergebnis:

Host QA95-W2K3-EX2 Neustart wird vorbereitet

Recover-Scenario: Wiederherstellen verloren gegangener Daten vom Replikat zum Master

Mit dem Befehl Recover-Scenario können Sie verloren gegangene Daten auf dem Master wiederherstellen, indem Sie sie von einem der Replikat-Hosts, die an einem Szenario beteiligt sind, übertragen. Dazu müssen Sie einen Synchronisationsvorgang in umgekehrter Richtung aktivieren: von einem Replikat zum Master. Wenn Sie den Befehl Recover-Scenario aktivieren, müssen Sie definieren, von welchem Replikat-Host Sie die Daten wiederherstellen möchten und ob Sie während des Wiederherstellungsvorgangs Daten löschen möchten, die auf dem Master existieren, jedoch nicht auf dem Replikat.

Wichtig! Um einen Wiederherstellungsvorgang initiieren zu können, müssen Sie die Replikation beenden.

Verwenden Sie den Befehl Get-Events, um sicherzustellen, dass der Wiederherstellungsvorgang abgeschlossen ist. Wenn Sie die Meldung "Wiederherstellungsvorgang ist abgeschlossen" erhalten, können Sie den Replikationsvorgang vom Master zum Replikat über den Befehl Run-Scenario neu starten.

Syntax
Recover-Scenario [-Name] <Zeichenfolge> [-Host] <Zeichenfolge> [-Modus] <Zeichenfolge> [-Ignorieren] <Boolesch> [-MasterDateienEntfernen] <Boolesch> [-Wiederherstellungsmodus] <Zeichenfolge> [-NeustartnachWiederherstellung] <Boolesch> 
Parameter
Name

Der Szenarioname.

Host

Das Replikat, von dem Sie Daten wiederherstellen möchten.

Modus

Der Synchronisationsmodus. Geben Sie eine der folgenden Angaben ein:

B=Binary (Binär)

F=File (Datei)

Ignorieren

Ignorieren von Dateien mit gleichem Namen und gleicher Größe beim Datenvergleich. Geben Sie eine der folgenden Angaben ein:

1=Ja

0= Nein

MasterDateienEntfernen

Ob während des Wiederherstellungsprozesses Dateien gelöscht werden sollen, die nur auf dem Master vorhanden sind. Geben Sie eine der folgenden Angaben ein:

1 = Ja, Dateien löschen, die nur auf dem Master vorhanden sind

0 = Nein, Dateien behalten, die nur auf dem Master vorhanden sind

Wiederherstellungsmodus

Der Datentyp, der wiederhergestellt werden soll. Geben Sie eine der folgenden Angaben ein:

A = Anwendungsdaten

S = Systemstatusdaten (nur wenn die Option Schutz von Systemstatus aktiviert ist)

B = Beide Datentypen

Der Standardwert ist A.

NeustartnachWiederherstellung

Ob der Master-Host nach Abschluss des Wiederherstellungsvorgangs neu gestartet werden soll. Geben Sie eine der folgenden Angaben ein:

1 = Ja, Master neu starten

2 = Nein, Master nicht neu starten

Beispiel: Wiederherstellen verloren gegangener Daten

Recover-Scenario "Dateiserver 1" 192,168.1,153 F 1 0 A 2

Ergebnis:

Vorgang zur Wiederherstellung von Anwendungsdaten wurde gestartet

Resume-IsAliveCheck - "Ist aktiv"-Überprüfung (IsAlive) für ein Szenario in Ausführung wieder aufnehmen

Der Befehl Resume-IsAliveCheck lässt Sie die "Ist aktiv"-Überprüfung (IsAlive) für ein bestimmtes ausgeführtes HA-Szenario manuell wieder aufnehmen.

Syntax
Resume-IsAliveCheck [-Szenarioname] <Zeichenfolge>
Parameter
SzenarioName

Der Zielszenarioname.

Beispiel: IsAlive-Überprüfung von SQLscenario wieder aufnehmen

Resume-IsAliveCheck SQLscenario

Ergebnis:

Periodische "Ist aktiv"-Überprüfung (IsAlive) von SQLscenario wird wieder aufgenommen.