Bei der Aktualisierung von Unternehmensanwendungen
wird eine neue Datei oder ein neues Modul einer installierten Java EE-Anwendung
hinzugefügt oder es wird eine installierte Anwendung, eine installierte Datei oder ein
installiertes Modul ersetzt oder entfernt.
Vorbereitende Schritte
Stellen Sie vor der Aktualisierung der Anwendungsdateien auf einem Server sicher, dass die Dateien
zu implementierbaren Modulen assembliert wurden.
Lesen Sie anschließend den Artikel Aktualisierung von Unternehmensanwendungsdateien
und legen Sie fest, wie Sie Ihre Anwendungsdateien aktualisieren möchten. Sie können Unternehmensanwendungen
oder Module über die Administrationskonsole, mit dem Tool "wsadmin" oder durch Java-MBean-Programmierung aktualisieren.
Alle Methoden stellen ähnliche Aktualisierungsfunktionen bereit.
Stellen Sie auch fest, ob die aktualisierten Dateien in Ihren
Implementierungszielen installiert werden können.
Informationen zu diesem Vorgang
In diesem Artikel wird beschrieben, wie implementierte Anwendungen oder Module
mit der Administrationskonsole aktualisiert werden können.
Vorgehensweise
- Sichern Sie die installierte Anwendung oder das installierte Modul.
- Rufen Sie die Seite Unternehmensanwendungen in der Administrationskonsole auf.
Klicken Sie in der Konsolennavigationsstruktur auf .
- Exportieren Sie die Anwendung in eine EAR-Datei, oder exportieren Sie eine
Datei in der Anwendung.
Wählen Sie die Anwendung aus, die exportiert werden soll, und klicken Sie auf
Exportieren oder Datei exportieren.
Die Bindungsinformationen bleiben beim Exportieren erhalten.
- Wählen Sie die Anwendung auf der Seite Unternehmensanwendungen aus und klicken Sie anschließend auf
Aktualisieren. Daraufhin erscheint die Seite Anwendungsaktualisierung vorbereiten.
- Gehen Sie unter Hochzuladende und zu installierende EAR-, WAR-, JAR-, RAR- oder SAR-Module angeben wie folgt vor:
- Vergewissern Sie sich, dass Zu aktualisierende Anwendung auf die zu aktualisierende Anwendung verweist.
- Wählen Sie unter Optionen für die Aktualisierung der Anwendung die installierte Anwendung, das installierte Modul bzw. die installierte Datei aus, die Sie aktualisieren möchten.
Der Artikel Aktualisierung der Anwendung
vorbereiten - Einstellungen der Onlinehilfe enthält detaillierte
Informationen zu den Optionen.
Fehler vermeiden: JAX-WS-Annotationen können über die Aktualisierungsoptionen
Einzelne Datei ersetzen oder hinzufügen und
Mehrere Dateien ersetzen, hinzufügen oder löschen
nicht hinzugefügt, entfernt und geändert werden. Mit diesen Optionen kann nur eine einzelne Datei oder eine Teilanwendung geändert werden.
Wenn Sie eine JAX-WS-Annotation mit einer dieser Optionen ändern, gibt das Produkt keinen Fehler zurück.
Es können jedoch Probleme beim Implementieren annotierter Web-Services auftreten.
gotcha
- Gehen Sie wie folgt vor, wenn Sie die Option Vollständige Anwendung ersetzen oder
Einzelnes Modul ersetzen oder hinzufügen ausgewählt haben:
- Klicken Sie auf Weiter, um einen Assistenten für die Aktualisierung
der Anwendungsdateien anzuzeigen.
- Führen Sie die Schritte im Aktualisierungsassistenten aus.
Dieser
Aktualisierungsassistent, der dem Installationsassistenten ähnlich ist, stellt Felder
bereit, in denen Sie Bindungsinformationen für die Anwendung angeben oder bearbeiten
können. Anleitungen finden Sie in den Informationen zum
Installieren von Anwendungen und
auf der Seite mit den Einstellungen für Anwendungsinstallationsbindungen.
Beachten Sie, dass in den
Installationsschritten Bindungsinformationen der neuen Version und der alten Version
zusammengeführt werden. Wenn die neue Version Bindungen für die Anwendungsartefakte, z.
B. EJB-JNDI-Namen, EJB-Referenzen oder Ressourcenreferenzen besitzt, werden diese
Bindungen zu einem Bestandteil der zusammengeführten Bindungsinformationen. Sind keine
neuen Bindungen vorhanden, werden Bindungen der installierten (alten) Version verwendet. Wenn
Bindungen in der alten Version nicht vorhanden sind und die Option für die Generierung
der Standardbindung aktiviert ist, werden die Standardbindungen in die zusammengeführten
Bindungsinformationen aufgenommen.
Sie können angeben, ob Bindungen in der alten oder der neuen Version ignoriert
werden sollen.
- Klicken Sie auf Fertig stellen.
- Falls Sie die Seite Module verwalten des Aktualisierungsassistenten
nicht verwendet haben, ordnen Sie nach der Aktualisierung der Anwendung die installierte Anwendung bzw. das installierte Modul
Servern oder Clustern zu.
Verwenden Sie die Seite, die Sie über die Seite Unternehmensanwendungen aufrufen können.
- Rufen Sie die Seite Module verwalten auf. Klicken Sie auf .
- Geben Sie den Anwendungsserver an, in dem Sie die in der Anwendung enthaltenen Module
installieren möchten, und klicken Sie dann auf OK.
Sie können J2EE 1.4-Module
(Java 2 Platform, Enterprise Edition) in Servern auf Knoten mit Version 6 oder höher implementieren.
Sie können Java EE 5-Module (Java Platform, Enterprise Edition)
in Servern auf Knoten mit Version 7.x oder höher implementieren.
Sie können Java EE 6-Module in Servern auf Knoten mit
Version 8.x oder höher implementieren. Sie können Java EE 7-Module in Servern auf Knoten mit Version 9.x implementieren.
In Mehrserverprodukten können Sie Module auch in Clustern implementieren.
Zum Implementieren von J2EE 1.4-Modulen müssen die Cluster Cluster-Member auf Knoten mit Version 6 oder
höher enthalten. Zum Implementieren von Java EE 5-Modulen müssen die Cluster Cluster-Member auf Knoten mit
Version 7.x oder höher enthalten. Zum Implementieren von Java EE 6-Modulen müssen die Cluster Cluster-Member auf Knoten mit
Version 8.x oder höher enthalten. Zum Implementieren von Java EE 7-Modulen müssen die Cluster Cluster-Member auf Knoten mit Version 9.x enthalten.
Ergebnisse
Nach dem Ersetzen einer vollständigen Anwendung deinstalliert das Produkt die alte Anwendung.
Nach dem Ersetzen eines Moduls, einer Datei oder einer Teilanwendung entfernt das Produkt
das alte installierte Modul, die alte installierte Anwendung bzw. die alte installierte Teilanwendung aus der installierten Anwendung.
Nächste Schritte
Gehen Sie nach der Installation der Anwendungsdatei oder des Moduls wie folgt vor:
- Wenn Sie eine geänderte Anwendung oder ein geändertes Modul in
einem Cluster implementieren, geben Sie die Änderungen nacheinander an alle Cluster-Member des Cluster weiter, in denen die Anwendung bzw. das Modul implementiert ist. Klicken Sie auf der Seite
Unternehmensanwendungen auf
Rollout der Aktualisierung durchführen, um die geänderte Konfiguration an alle Cluster-Member des Cluster weiterzugeben, in denen die Anwendung bzw. das
Modul implementiert ist. Die Option Rollout der Aktualisierung durchführen aktualisiert
nacheinander die Konfigurationen der Knoten, die Cluster-Member enthalten.
Anmerkung: Wenn ein Cluster mehrere
Member auf demselben Knoten hat, werden alle Member auf dem Knoten gleichzeitig gestoppt.
Bewährtes Verfahren: Wenn die letzte der
Installationsnachrichten, die während der
Anwendungs- oder Modulinstallation in der Konsole erscheinen, angezeigt wurde, klicken Sie
auf
Anwendungen verwalten, um die Seite
Unternehmensanwendungen aufzurufen.
Speichern Sie Änderungen an der Konfiguration erst, nachdem Sie die Änderungen nacheinander installiert haben.
best-practices
- Speichern Sie die Änderungen in Ihrer Konfiguration.
Wenn Sie in
Mehrserverprodukten auf Speichern klicken, löscht das Produkt die alten
Anwendungsdateien und kopiert neue Dateien, wenn die Konfiguration
des Deployment Manager mit der Konfiguration des Knotens, auf dem die Anwendung installiert ist, synchronisiert wird.
Wenn die Anwendung ausgeführt wird und Sie sie aktualisieren,
wird sie gestoppt, bevor ihre Dateien in das Zielverzeichnis des Knotens kopiert werden.
Nach dem Kopiervorgang wird die Anwendung erneut gestartet. Daher ist die Anwendung
während des Zeitraums, in dem der Knoten seine Konfiguration mit dem Deployment Manager
synchronisiert, nicht verfügbar.
- Starten Sie die Anwendung
manuell erneut, damit ggf. vorgenommene Änderungen wirksam werden.
Wenn eine aktive Anwendung aktualisiert
wird, stoppt das Produkt automatisch die Anwendung oder nur die geänderten Komponenten,
aktualisiert die Anwendungslogik und startet die gestoppte Anwendung bzw. die Anwendungskomponenten erneut.
Wenn
Sie Modulmetadaten während der Ausführung der Anwendung aktualisieren, ist das erneute Starten der
Anwendung möglicherweise nicht ausreichend, damit die Änderungen wirksam werden.
Ändern Sie beispielsweise Deskriptoren in aktiven Anwendungen der Java EE Version 6, die Annotationen verwenden,
müssen Sie die Anwendung erneut installieren.
Wenn Sie Klassen in einer Anwendung ändern, die Klassenhierarchien einführen, entfernen oder ändern,
und wenn sich diese Änderungen auf annotierte Klassen auswirken, müssen Sie auch die Anwendung erneut installieren.
- Wenn die Anwendung, die Sie aktualisieren, in einem Server implementiert ist, dessen Anwendungsklassenladerrichtlinie
auf der Seite mit den Einstellungen des Anwendungsservers auf Einer eingestellt ist, starten Sie den Server erneut.