Befehl restoreConfig

Verwenden Sie den Befehl restoreConfig, um die Konfiguration Ihres Knotens wiederherzustellen, nachdem Sie die Konfiguration mit dem Befehl backupConfig gesichert haben.

Unterstützte Konfigurationen Unterstützte Konfigurationen:

Dieser Artikel beschreibt die Migration von Profilkonfigurationen. Wenn Sie Ihre Anwendungen auf die aktuellste Version migrieren möchten, verwenden Sie WebSphere Application Server Migration Toolkit. Weitere Informationen finden Sie unter Migration Toolkit on WASdev.

sptcfg

Der Befehl restoreConfig ist ein einfaches Dienstprogramm, mit dem Sie die Konfiguration Ihres Knotens wiederherstellen können, nachdem Sie die Konfiguration mit dem Befehl backupConfig gesichert haben. Standardmäßig werden alle Server auf dem Knoten gestoppt, bevor die Konfiguration wiederhergestellt wird. Deshalb wird während der Wiederherstellung keine Knotensynchronisation vorgenommen. Falls das Konfigurationsverzeichnis bereits vorhanden ist, wird es vor der Wiederherstellung umbenannt. Weitere Informationen dazu, wo dieser Befehl auszuführen ist, finden Sie unter "Befehlszeilentools verwenden".

Wenn Sie Änderungen an den Anwendungsdateien direkt im Verzeichnis Stammverzeichnis_des_Anwendungsservers/installedApps vornehmen, diese Änderungen ab ernicht an den Anwendungsdateien im Verzeichnis Stammverzeichnis_des_Anwendungsservers/config nachvollziehen, können die Änderungen überschrieben werden, wenn Sie den Befehl restoreConfig verwenden.

Der Befehl backupConfig speichert weder Dateiberechtigungen noch Informationen zum Eigner. Der Befehl restoreConfig verwendet die aktuelle umask und die EUID (Effective User ID), um beim Wiederherstellen einer Datei die Berechtigungen und das Eigentumsrecht festzulegen. Wenn die wiederhergestellten Dateien die ursprünglichen Berechtigungen und Eigentümer haben müssen, verwenden Sie zum Sichern und Wiederherstellen der Konfiguration den Befehl tar, der auf allen UNIX- und Linux-Systemen verfügbar ist.

Der Befehl restoreConfig wird unter dem Benutzerprofil QEJBSVR ausgeführt, um sicherzustellen, dass das Benutzerprofil QEJBSVR der Eigner der erstellten Verzeichnisse und Dateien ist. Das System setzt die "*PUBLIC"-Berechtigung für die erstellten Verzeichnisse auf "*EXCLUDE". Alle privaten Berechtigungen, die zuvor für die Verzeichnisse und Dateien im Konfigurationsverzeichnis existiert haben, gehen verloren. Verwenden Sie das Qshell-Script zum Erteilen von Berechtigungen für WebSphere Application Server (grtwasaut) oder den CL-Befehl CHGAUT, um alle privaten Berechtigungen, die verloren gegangen sind, erneut festzulegen.
Anmerkung: Das Benutzerprofil QEJBSVR muss mindestens die Berechtigung "*X" für edes Verzeichnis in dem Pfad, der die "Sicherungsdatei" enthält, und die Berechtigung "*R" für die "Sicherungsdatei" haben.
Der Befehl restoreConfig setzt den Eigner für die Verzeichnisstruktur und den Inhalt dieser Struktur auf das Benutzerprofil QEJBSVR, stellt aber keine privaten Berechtigungen wieder her. Wenn Sie eine Instanz von IBM HTTP Server oder Lotus Domino HTTP Server mit dem Anwendungsserver auf demselben System oder auf derselben Partition verwenden und die Datei plugin-cfg.xml für den Anwendungsserver in der Verzeichnisstruktur Profilstammverzeichnis/config enthalten ist, verwenden Sie die folgenden Anweisungen, um dem Benutzerprofil für IBM HTTP Server bzw. Lotus Domino HTTP Server die erforderlichen privaten Berechtigungen zu erteilen.
Anmerkung: Wenn Sie keine Instanz von IBM HTTP Server oder Lotus Domino HTTP Server auf demselben System wie das wiederhergestellte Profil verwenden, führen Sie diese Schritte nicht aus. Führen Sie diese Schritte auch nicht aus, wenn die Datei "plugin-cfg.xml" nicht in der config-Verzeichnisstruktur für das Profil enthalten ist.
  1. Melden Sie sich am System an.
  2. Starten Sie mit dem Befehl STRQSH eine Qshell-Sitzung.
  3. Navigieren Sie zum Verzeichnis Stammverzeichnis_des_Anwendungsservers/bin für den Anwendungsserver.
  4. Verwenden Sie den folgenden Qshell-Befehl grtwasaut, um jedem Verzeichnis in dem Pfad, das die Datei plugin-cfg.xml enthält, angefangen beim Verzeichnis config, die Ausführungsberechtigung (x) zu erteilen:
    grtwasaut -profileName Profilname -object Pfad -dtaaut x -user Benutzer
    Für diese Angaben gilt: Profilname steht für den Namen der wiederhergestellten Profilkonfiguration, Pfad für den zu ändernden Verzeichnispfad, relativ zum Profilstammverzeichnis, und Benutzer entweder für QTMHHTTP (für IBM HTTP Server) oder QNOTES (für Lotus Domino HTTP Server).
    Führen Sie beispielsweise die folgenden Befehle aus, wenn Sie IBM HTTP Server für die Plattform iSeries verwenden und die Datei plugin-cfg.xml für Ihr Profil "myprofile" sich im Verzeichnis Profilstammverzeichnis/config/cells/MYSYSTEM_myprofile/nodes/MYSYSTEM_myprofile/servers/myHTTPinstance befindet:
    grtwasaut -profileName myprofile -object config/cells/MYSYSTEM_myprofile/nodes/MYSYSTEM_myprofile/
    servers/myHTTPinstance -dtaaut x -user QTMHHTTP
    grtwasaut -profileName myprofile -object config/cells/MYSYSTEM_myprofile/nodes/MYSYSTEM_myprofile/
    servers -dtaaut x -user QTMHHTTP
    grtwasaut -profileName myprofile -object config/cells/MYSYSTEM_myprofile/nodes/MYSYSTEM_myprofile 
    -dtaaut x -user QTMHHTTP
    grtwasaut -profileName myprofile -object config/cells/MYSYSTEM_myprofile/nodes -dtaaut x -user QTMHHTTP
    grtwasaut -profileName myprofile -object config/cells/MYSYSTEM_myprofile -dtaaut x -user QTMHHTTP
    grtwasaut -profileName myprofile -object config/cells -dtaaut x -user QTMHHTTP
    grtwasaut -profileName myprofile -object config -dtaaut x -user QTMHHTTP
    Verwenden Sie das folgende Beispiel, wenn Sie IBM HTTP Server für die Plattform iSeries verwenden und die Datei plugin-cfg.xml für Ihr Profil "myprofile" sich im Verzeichnis Profilstammverzeichnis/config/cells befindet:
    grtwasaut -profileName myprofile -object config/cells -dtaaut x -user QTMHHTTP 
    grtwasaut -profileName myprofile -object config -dtaaut x -user QTMHHTTP
  5. Verwenden Sie den folgenden Befehl grtwasaut, um der Datei plugin-cfg.xml Lese- und Ausführungsberechtigung (rx) zu erteilen:
    grtwasaut -profileName Profilname -object Pfad/plugin-cfg.xml -dtaaut x -user Benutzer
    Für diese Angaben gilt: Profilname steht für den Namen der wiederhergestellten Profilkonfiguration, Pfad für den zu ändernden Verzeichnispfad, relativ zum Profilstammverzeichnis, und Benutzer für QTMHHTTP (für IBM HTTP Server) oder QNOTES (für Lotus Domino HTTP Server).
    Führen Sie beispielsweise den folgenden Befehl aus, wenn Sie IBM HTTP Server für die Plattform iSeries verwenden und die Datei plugin-cfg.xml für Ihr Profil "myprofile" sich im Verzeichnis Profilstammverzeichnis/config/cells/MYSYSTEM_myprofile/nodes/MYSYSTEM_myprofile/servers/myHTTPinstance befindet:
    grtwasaut -profileName myprofile -object config/cells/MYSYSTEM_myprofile/nodes/MYSYSTEM_myprofile
    /servers/myHTTPinstance/plugin-cfg.xml -dtaaut rx -user QTMHHTTP
    Verwenden Sie das folgende Beispiel, wenn Sie IBM HTTP Server für die Plattform iSeries verwenden und die Datei plugin-cfg.xml für Ihr Profil "myprofile" sich im Verzeichnis Profilstammverzeichnis/config/cells befindet:
    grtwasaut -profileName myprofile -object config/cells/plugin-cfg.xml -dtaaut rx -user QTMHHTTP

Position

Setzen Sie den Befehl im Verzeichnis Profilstammverzeichnis/bin ab.

Syntax

Der Befehl hat die folgende Syntax:

restoreConfig Sicherungsdatei [Optionen]
Hierbei steht Sicherungsdatei für die wiederherzustellende Datei. Wenn Sie keine Datei angeben, wird der Befehl nicht ausgeführt.

Parameter

Die folgenden Optionen sind für den Befehl restoreConfig verfügbar:

-help
Gibt eine Anweisung zur Verwendung des Befehls aus.
-location Verzeichnisname
Gibt das Verzeichnis an, in dem die Sicherungsdatei wiederhergestellt wird.
Das Standardverzeichnis ist Profilstammverzeichnis/config.
-logfile Dateiname
Gibt die Position der Protokolldatei an, in die die Traceinformationen geschrieben werden.

Standardmäßig hat die Protokolldatei den Namen restoreConfig.log und wird in Ihrem Verzeichnis logs erstellt.

-nostop
Weist den Befehl restoreConfig an, die Server vor dem Wiederherstellen der Konfiguration nicht zu stoppen.
-password Kennwort
Gibt das Kennwort für die Authentifizierung an, wenn die Sicherheitskomponente auf dem Server aktiviert ist.
-profileName Profilname
Definiert das Profil des Anwendungsserverprozesses in einer Installation mit mehreren Profilen.

Die Option "-profileName" ist in einer Umgebung mit nur einem Profil nicht erforderlich. Standardmäßig wird für diese Option das Standardprofil verwendet.

-quiet
Unterdrückt die Fortschrittsinformationen, die der Befehl restoreConfig im normalen Modus ausgibt.
-replacelog
Ersetzt die Protokolldatei, anstatt sie an das aktuelle Protokoll anzuhängen.
-trace
Generiert in der Protokolldatei Traceinformationen, die für das Debugging verwendet werden können.
-username Benutzername
Gibt den Benutzernamen für die Authentifizierung an, wenn die Sicherheitskomponente auf dem Server aktiviert ist. Funktioniert genauso wie die Option -user.
-user Benutzername
Gibt den Benutzernamen für die Authentifizierung an, wenn die Sicherheitskomponente auf dem Server aktiviert ist. Funktioniert genauso wie die Option -username.
-?
Gibt eine Anweisung zur Verwendung des Befehls aus.

Verwendung

Die folgenden Beispiele veranschaulichen die richtige Syntax:

restoreConfig WebSphereConfig_2006-04-22.zip

Der folgende Beispielbefehl stellt die angegebene Datei im Verzeichnis /tmp wieder her und stoppt keine Server vor dem Beginn der Wiederherstellung:

restoreConfig WebSphereConfig_2006-04-22.zip -location /tmp -nostop
Das folgende Beispiel stellt die Konfiguration, die unter /home/mydir/myprofileBackup.zip gespeichert wurde, in der Konfiguration des Profils myprofile wieder her:
restoreConfig /home/mydir/myprofileBackup.zip -profileName myprofile

Wenn Sie die Konfiguration in einem anderen Verzeichnis als dem, das Sie mit dem Befehl backupConfig gesichert haben, wiederherstellen, müssen Sie einige Pfade im Konfigurationsverzeichnis unter Umständen manuell aktualisieren.


Symbol, das den Typ des Artikels anzeigt. Referenzartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-iseries&topic=rxml_restoreconfig
Dateiname:rxml_restoreconfig.html