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: 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.
sptcfgDer 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.
![[Linux]](../images/linux.gif)
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.
Wenn Sie ein logisches Verzeichnis
für Stammverzeichnis_des_Anwendungsservers/config verwenden,
funktioniert der Befehl restoreConfig nicht.
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.
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.Position
Setzen Sie den Befehl im Verzeichnis Profilstammverzeichnis/bin ab.
Syntax
Der Befehl hat die folgende Syntax:
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
restoreConfig.sh Sicherungsdatei [Optionen]
![[Windows]](../images/windows.gif)
restoreConfig.bat Sicherungsdatei [Optionen]
![[IBM i]](../images/iseries.gif)
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.
Standardmäßig wird das Verzeichnis Stammverzeichnis_des_Anwendungsservers/config verwendet.
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.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
-profileName Profilname![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
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
Mit dem Befehl restoreConfig können Sie einen Anwendungsserver nach
Auftreten eines Fehlers wiederherstellen. Führen Sie die
folgenden Schritte aus:Die folgenden Beispiele veranschaulichen die richtige Syntax:
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
restoreConfig.sh WebSphereConfig_2006-04-22.zip
![[Windows]](../images/windows.gif)
restoreConfig.bat WebSphereConfig_2006-04-22.zip
![[IBM i]](../images/iseries.gif)
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:
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
restoreConfig.sh WebSphereConfig_2006-04-22.zip -location /tmp -nostop
![[Windows]](../images/windows.gif)
restoreConfig.bat WebSphereConfig_2006-04-22.zip -location /tmp -nostop
![[IBM i]](../images/iseries.gif)
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.
Referenzartikel