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 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.
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:
- Speichern Sie die Änderungen in Ihrer Konfiguration.
Wenn Sie eine vollständige
Anwendung in einem Einzelserverprodukt (Basis) aktualisieren, wird nach dem Speichern der Änderungen die alte Version der
Anwendung deinstalliert und die neue Version in der Konfiguration installiert.
Die Binärdateien der Anwendung für die alte
Version werden aus dem Zielverzeichnis gelöscht, und die neuen Binärdateien werden in das
Verzeichnis kopiert.
- 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.