Verwenden Sie den Befehl restoreConfig, um die Konfiguration Ihres Knotens wiederherzustellen,
nachdem Sie die Konfiguration mit dem Befehl backupConfig gesichert haben.
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.
- Melden Sie sich am System an.
- Starten Sie mit dem Befehl STRQSH eine Qshell-Sitzung.
- Navigieren Sie zum Verzeichnis Stammverzeichnis_des_Anwendungsservers/bin
für den Anwendungsserver.
- 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
- 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
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.