Bevor Sie ein Upgrade für Ihre Application Engine-Installation durchführen, müssen Sie Ihre
vorhandene Konfiguration für das Upgrade vorbereiten. Diese Vorbereitung umfasst die Ausführung eines Backups Ihrer vorhandenen Dateien und die Deimplementierung Ihrer Webanwendung.
Informationen zu diesem Vorgang
Informationen hierzu finden Sie im Thema zum Entfernen von Software in IBM FileNet P8 eForms Installation
and Upgrade Guide.
Wichtig: In einer Hochverfügbarkeits-Cluster-Server-Umgebung müssen Sie die Schritte auf allen Knoten in Ihrem Cluster ausführen.
So bereiten Sie das
Upgrade für
Application Engine vor:
Vorgehensweise
- Melden Sie sich am Application Engine-Server an:
Option |
Bezeichnung |
AIX, HPUX, Linux, Linux on System
z, Solaris |
Melden Sie sich als Benutzer mit Schreib-, Lese- und Ausführungszugriff auf das Verzeichnis an, in dem Sie Application Engine installieren wollen. |
Windows |
Melden Sie sich als Mitglied der lokalen Administratorgruppe oder als Benutzer mit entsprechenden Berechtigungen an. |
- (Windows) Stellen Sie mithilfe von Windows Task-Manager sicher, dass keine javaw.exe-Prozesse aktiv sind.
Wenn die Anwendungen in den vorherigen Schritten korrekt gestoppt wurden, dürfen keine zu Application Engine gehörenden javaw.exe-Prozesse aktiv sein.
- Verwenden Sie die Windows-Dienste, um den Dienst Process Application Engine Services Manager zu stoppen. Wählen Sie aus. Wenn der Dienst Process Application Engine Services
Manager den Status Gestartet hat, klicken Sie mit der rechten Maustaste auf das Element und klicken Sie dann auf Beenden.
- Wenn weiterhin javaw.exe-Prozesse aktiv sind, nachdem Sie den Dienst Process Application Engine Services Manager beendet haben, beenden Sie über Windows Task-Manager alle zu Application Engine gehörigen javaw.exe-Prozesse.
- Führen Sie ein Backup für die Workplace-Webanwendung durch, deimplementieren Sie die Webanwendung und entfernen Sie sie vom Java™-EE-Anwendungsserver.
Bei diesem Schritt werden Sie eine Backup-Kopie der implementierten Webanwendung
erstellen, die alle im Verzeichnis WEB-INF gespeicherten angepassten Dateien und Konfigurationsdateien enthält.
Das Installationsprogramm erstellt zwar automatisch ein Backup Ihrer vorhandenen Konfigurationsdateien von Application Engine Version 3.5 oder 4.0.1, es ist jedoch ein bewährtes Verfahren,
ein Backup der folgenden Verzeichnisse durchzuführen, um ein vollständiges Backup
Ihres implementierten Systems zu erhalten. Sie benötigen diese Dateien möglicherweise in späteren Schritten, damit Sie Ihre Einstellungen aus Version
3.5 oder 4.0.1 beibehalten können. Sie benötigen diese Dateien möglicherweise, wenn Sie geänderte Dateien während des Upgrades und der Konfiguration von Application Engine in das installierte Workplace-Verzeichnis kopieren.
Option |
Bezeichnung |
WebSphere Application Server |
- Erstellen Sie eine Backup-Kopie des implementierten Workplace-Verzeichnisses (deploy_backup): WAS-Ausgangsverzeichnis/profiles/default/installedApps/Knotenname/app_engine_war.ear/app_engine.war
Ihr Pfad kann vom genannten abweichen, wenn Sie ein neues Profil erstellt oder Ihre WAR-Datei umbenannt haben.
- Stoppen Sie die Workplace-Anwendung über die WebSphere-Administrationskonsole.
- Deinstallieren Sie die Workplace-Anwendung
in Unternehmensanwendungen.
- Speichern Sie die Änderungen und stoppen Sie die WebSphere Application Server-Instanz.
- Löschen Sie das temporäre Workplace-Verzeichnis
(Standard: app_engine_war) in: WAS-Ausgangsverzeichnis/profiles/default/temp/Knotenname/Instanz/app_engine.war
|
WebLogic Server |
- Stoppen Sie über die WebLogic Server-Administrationskonsole das Workplace-Webanwendungsmodul.
- Erstellen Sie eine Backup-Kopie des Workplace-Ordners
(Implementierungsbackup): AE-Installationspfad/Workplace
- Löschen Sie das Webanwendungsmodul Workplace.
- Stoppen Sie die WebLogic Server-Instanz.
|
JBoss Application Server |
- Stoppen Sie die JBoss Application Server-Instanz.
- Erstellen Sie eine Backup-Kopie des implementierten Workplace-Verzeichnisses (Implementierungsbackup): JBoss-Ausgangsverzeichnis/server/default/deploy/Workplace.war
- Löschen Sie das implementierte Workplace-Verzeichnis: JBoss-Ausgangsverzeichnis/server/default/deploy/Workplace.war
- Löschen Sie das temporäre Workplace-Verzeichnis für JBoss: JBoss-Ausgangsverzeichnis/server/default/work/jboss.web/localhost/Workplace
|
- Kopieren Sie geänderte Dateien in das installierte Workplace-Verzeichnis. Während des
Upgrades werden die Konfigurationsdateien aus dem folgenden Verzeichnis verschoben:
AE-Installationspfad/Workplace/WEB-INF
in:
AE-Installationspfad/Config/AE
Wenn Sie an einer dieser Dateien direkt im implementierten
Workplace-Verzeichnis (
app_engine.war für
WebSphere Application Server oder
Workplace.war für
JBoss) Ihrer Umgebung von Version 3.5 oder 4.0.1 Änderungen vorgenommen haben, müssen Sie die geänderte
Version dieser Dateien aus dem Verzeichnis
deploy_backup in das
installierte Verzeichnis
AE-Installationspfad/Workplace/WEB-INF kopieren, bevor
Sie das Installationsprogramm ausführen.
- actions.xml
- bootstrap.properties
- ClassFilter.xml
- ConfigurableLabels.xml
- containericons.properties
- content_redir.properties
- customobjecticons.properties
- download_redir.properties
- fnsoap.xml
- icons.properties
- InfoPages.xml
- PagingConfiguration.xml
- PolicyProcessors.xml
- PrimaryViews.xml
- PropertiesPages.xml
- SimpleSearch.xml
- SystemsPropertiesView.xml
Als Teil des Upgrades erstellt das Installationsprogramm automatisch ein Backup Ihrer vorhandenen Konfigurationsdateien von
Application Engine Version 3.5 oder 4.0.1, wobei den Dateinamen das Suffix .old angehängt wird.
- actions.xml.old
- ClassFilter.xml.old
- ConfigurableLabels.xml.old
- containericons.properties.old
- content_redir.properties.old
- icons.properties.old
- SystemsPropertiesView.xml.old
- UpdateActions.xml.old
- UpdateClassFilter.xml.old
- UpdateConfigurableLabels.xml.old
- UpdateProps.xml.old
- UpdateSystemPropertiesView.xml.old
- UpdateWeb.xml.old
- web.xml.old
Die gesicherten Dateien befinden sich im Verzeichnis AE-Installationspfad/backup-4_0_2.
Führen Sie die folgenden zusätzlichen Backup-Schritte aus, wenn Sie ein Upgrade in einer Hochverfügbarkeitsumgebung durchführen.