In diesem Abschnitt werden die bekannten Probleme beim Aufrüsten sowie ihre Lösungen beschrieben.
Die Domänen, die in custom-path erstellt werden und nicht dem Verzeichnis as-install/domains entsprechen, werden während des Upgrades von Application Server Enterprise Edition 8 auf Application Server Enterprise Edition 8.1 nicht direkt aktualisiert.
Wenn Sie das Upgrade-Dienstprogramm ausführen und dabei das as-install als Quellverzeichnis für die Installation angeben, werden beim Upgrade nur die Domänen aktualisiert, die sich im Verzeichnis as-install/domains befinden. Für in anderen Pfaden erstellte Domänen wird kein Upgrade durchgeführt.
Kopieren Sie alle Domänenverzeichnisse aus den jeweiligen Speicherorten in das Verzeichnis as-install/domains, bevor Sie den Upgrade-Vorgang beginnen.
Dieses Problem wurde bei verschiedenen Linux-Systemen beobachtet. Es tritt am häufigsten bei Java Desktop System 2 auf, wurde jedoch auch in Distributionen von Red Hat beobachtet.
Wenn Sie auf der letzten Seite des Installationsprogramms auf die Schaltfläche "Start Upgrade Tool" klicken, wird das Upgrade-Tool nicht gestartet und der Upgrade-Vorgang nicht abgeschlossen. Das Upgrade-Tool reagiert nicht mehr und gibt keine Eingabeaufforderung aus.
Dieses Problem tritt nicht auf, wenn das In-Place-Upgrade im Befehlszeilen-Installationsmodus ausgeführt wird.
Wenn Sie das In-Place-Upgrade im Benutzeroberflächenmodus ausführen und dieses Problem auftritt, beenden Sie das Installationsprogramm, indem Sie in dem Terminal-Fenster, von dem aus das Installationsprogramm gestartet wurde, STRG+C drücken.
Starten Sie das Upgrade-Tool vom Terminal-Fenster aus, indem Sie folgenden Befehl eingeben:
as-install/bin/asupgrade --source as-install/domains --target as-install --adminuser adminuser --adminpassword adminpassword --masterpassword changeit |
Die Werte für Administrator und Administratorpasswort müssen mit den Werten übereinstimmen, die in der aufzurüstenden Installation verwendet werden.
Wenn das Upgrade-Tool den Upgrade-Prozess beendet hat, können Sie auch den Browser starten und den folgenden URL eingeben, um die Infoseite anzuzeigen:
file://as-install/docs-ee/about.html |
Wenn Sie auch noch die Installationsoption zum Registrieren des Produkts gewählt haben, folgen Sie dem Link der Registrierungsseite, der sich auf der Produktinfo-Seite befindet.
Entfernen Sie die folgenden Einträge aus der Zieldatei domain.xml (nach dem Upgrade) und starten Sie den Server neu:
<jvm-options>-Djavax.net.ssl.keyStore=${com.sun.aas.instanceRoot} /config/keystore.jks</jvm-options>- <jvm-options>Djavax.net.ssl.trustStore=${com.sun.aas.instanceRoot} /config/cacerts.jks</jvm-options>
Das Upgrade-Tool überschreibt vorhandene index.html-Dateien für alle Serverinstanzen.
Sichern Sie Ihre vorhandenen index.html-Dateien vor dem Ausführen des Upgrade-Tools, und stellen Sie diese Dateien später wiederher.
Bei der Aktualisierung von Anwendungsserver 8.0PE auf 9.1 Update 1 wird in einem Fehler angezeigt, dass der Server nicht über einen System-Konnektor null und ungültige Benutzerinformationen in sbs-manual verfügt. Selbst nach dem Ändern der hartcodierten Werte wird diese Fehlermeldung angezeigt. Dieses Problem tritt auf, da die Datei domain.xml aus Version 8.0 in Version 9.1 geändert wurde.
Dieser Fehler tritt nur bei der Aktualisierung von 8.0 PE auf 9.1 auf. Als Umgehung führen Sie ein Upgrade auf 8.1, 8.2 oder 9.0 und erst anschließend auf 9.1 durch.
Wenn beim Durchführen eines In-Place-Upgrades mehrere Domänen in der Quelle vorhanden sind, ruft das Installationsprogramm das Upgrade-Tool auf, obgleich der Prozess abgebrochen wird. Dieses Problem tritt auf, wenn der Aufruf im GUI-Modus erfolgt.
Führen Sie das In-Place-Upgrade im CLI-Modus durch, und beenden Sie den Vorgang, wenn Sie vom Installationsprogramm aufgefordert werden, am Ende des Installationsprozesses das Upgrade-Tool auszuwählen. Domänen, die im Domänenverzeichnis vorhanden sind, werden dabei nicht gelöscht. Das Upgrade-Tool sollte manuell über das Verzeichnis bin aufgerufen werden.
Erstellen Sie beim In-Place-Upgrade im GUI-Modus eine Sicherung der Domänen im Domänen-Root-Verzeichnis, um den Verlust dieser Domänen im Installationsprozess zu verhindern. Beenden Sie den Vorgang am Ende des Installationsprozesses, wenn Sie vom Installationsprogramm zum Aufrufen des Upgrade-Tools aufgefordert werden. Kopieren Sie die gesicherten Domänen in das Domänenverzeichnis, wenn diese verloren gegangen sind. Starten Sie das Upgrade-Tool manuell, um die Aktualisierung durchzuführen.
Beim Upgrade von AS 8.2 auf 9.1 wird das Master-Passwort aus der 8.2-Installation in der 9.1-Installation nicht geerbt. Dies führt anschließend bei der nächsten Admin-Anmeldung zu einem Authentifizierungsfehler.
Das standardmäßige Admin-Passwort in Anwendungsserver 9.1 Update 1 lautet changeit. Um nach dem Upgrade von 8.2 Probleme bei der Anmeldung am 9.1-Server zu vermeiden, führen Sie einen der folgenden Schritte aus:
Ändern Sie das Admin-Passwort aus Version 8.2 vor dem Upgrade in changeit.
Akzeptieren Sie das standardmäßige Admin-Passwort während des Upgrades nicht, sondern geben Sie explizit das gewünschte Passwort ein.
Melden Sie sich unter Verwendung des Standardpassworts an 9.1 an, und ändern Sie dieses Passwort umgehend.
Das Upgrade-Tool aktualisiert keine Datenbanken oder Datenbanktabellen. Diese Option wird auch in zukünftigen Versionen nicht unterstützt. Die Konfigurationen der Ressourcenreferenzen werden übermittelt, und Anwendungsserver sollte weiterhin mit den ursprünglichen Datenbanken und Tabellen funktionieren. Wenn Sie die Datenbanken oder Übertragungsdatenbanktabellen ändern möchten, verwenden Sie die Tools, die mit der verwendeten Datenbank funktionieren.
Führen Sie zur Migration des MQ-Speichers die folgenden Schritte aus:
Führen Sie die folgenden Schritte aus, NACHDEM AS 8.2 heruntergefahren und NACHDEM das AS9.1-Upgrade-Tool ausgeführt, jedoch BEVOR AS9.1 ERSTMALIG gestartet wurde. Wenn Sie AS 9.1 nach der IFR-Installation/Aktualisierung bereits gestartet haben, führen Sie diese Schritte NICHT aus, da sie die Stabilität des MQ-Nachrichtenspeichers gefährden können.
Kopieren Sie das gesamte Unterverzeichnis domain-dir/imq aus dem AS 8.x domains-Verzeichnis in das AS 9.1-Verzeichnis domains.
Stellen Sie sicher, dass der Besitzer des Verzeichnisses und der Dateien mit dem Benutzer übereinstimmt, der Anwendungsserver ausführen wird.
Nach dem Ausführen der oben stehenden Schritte kann Anwendungsserver 9.1 Update 1 gestartet werden und der MQ-Speicher im Anwendungsserver 9.1 Update 1-Verzeichnis domains wird aus dem JES5 U1-Format in das MQ 4.1-Format migriert. Beachten Sie, dass der ursprüngliche JES5 U1 MQ-Speicher unter AS 8.2 beibehalten wird und nicht durch diese Prozedur oder MQ4.1 beim Start von AS 9.1 geändert wird.
Beim Upgrade von JES5 (Anwendungsserver 8.2) auf Anwendungsserver 9.1 Update 1 funktioniert das Portal Server Community-Beispiel nicht mehr, und es werden eine Vielzahl von javax.faces.application.ApplicationFactory-Fehlern angezeigt.
Die Aktualisierung von Anwendungsserver 8.2 auf 9.1 Update 1 wird nicht unterstützt, wenn Anwendungsserver 8.2 mit JES5 Portal Server installiert wurde. Portal Server muss vor dem Upgrade von Anwendungsserver auf 9.1 Update 1 auf Java ES 5 Update 1 aktualisiert werden.
Bei der Aktualisierung von Anwendungsserver 8.2 auf 9.1 Update 1 über das IFR-Installationsprogramm auf Linux-Plattformen kann die Option JDK installieren ausgewählt werden, nach der erfolgreichen Fertigstellung der Installation funktionieren die meisten JES-Komponenten jedoch nicht.
Dieses Problem betrifft ausschließlich die IFR-Installation von Anwendungsserver 9.1 Update 1 auf Linux-Plattformen und tritt nur auf, wenn die Option JDK installieren ausgewählt ist. Verknüpfen Sie /usr/jdk/entsys-j2se nach der Installation umgehend manuell mit dem Verzeichnis /usr/java/jdk1.5.0_12 , um dieses Problem zu umgehen.
Bei der Aktualisierung von Anwendungsserver 9.1 Update 1 IFR unter Windows, wird die In-Place-Sicherung nicht ordnungsgemäß in die asupdate.bat-Formularwerte integriert. Genau gesagt, wenn Sie in einem ASupdate.bat-GUI-Bildschirm falsche Informationen eingeben und auf Weiter klicken, versucht das Upgrade-Installationsprogramm zu ermitteln, ob es sich um ein In-Place-Upgrade handelt. Falls ja, wird domain1 vor dem Upgrade in ein Sicherungsverzeichnis verschoben. Im Verlauf des Upgrades wird eine Fehlermeldung aufgrund dieser falschen Informationen angezeigt. Wenn Sie versuchen, den Fehler umgehend zu beheben, wird ein Pfadfehler ausgegeben, da domain1 bereits verschoben wurde.
Ändern Sie das Quellverzeichnis entweder in das Verzeichnis domain1_timestamp unter current-source-path/backup, oder beenden Sie das Installationsprogramm über die Schaltfläche Abbrechen, und starten Sie den Vorgang erneut.
(Nur Windows) Wenn eine frühere Version von Anwendungsserver unter Verwendung von speziellen Zeichen oder Kurznamen im DOS-Stil im Programmverzeichnispfad installiert wurde, schlagen anschließende In-Place-Upgrades auf Anwendungsserver 9.1 Update 1 fehl, wenn dieselben Verzeichnispfadnamen verwendet werden.
Beispiel: Anwendungsserver 8.2 wurde in einem der folgenden Verzeichnisse installiert:
C:\Programme (x86)\dirs\appserver c:\progra~2\dirs\appserver |
Der Versuch, ein In-Place-Upgrade auf 9.1 Update 1 durchzuführen, schlägt fehl, da das Installationsprogramm die Kurznamen oder speziellen Zeichen nicht in das erforderliche lange Namensformat konvertieren kann.
Es wird dringend davon abgeraten, Anwendungsserver unter Verwendung eines Pfadnamens mit speziellen Zeichen oder Abkürzungen für Kurznamen im DOS-Stil (z. B. progra~2) zu installieren, da dies die anschließende Installation von Upgrades verhindert. Wenn eine solche Installation vorhanden ist, installieren Sie sie vor dem Upgrade entweder unter Verwendung von langen Pfadnamen erneut, oder installieren Sie die neue Version von Anwendungsserver in einem vollständig neuen Verzeichnis.
Nach einem Anwendungsserver-Upgrade funktioniert das <jsp:forward>-Tag in Authenticate.jsp nicht wie erwartet. Der <jsp:forward>-Aufruf führt zu einem Fehler in den Serverprotokollen, und in der WebUI wird eine leere Seite angezeigt. Das Problem ist, dass <jsp:forward> in Authenticate.jsp ein Seitenattribut wie <jsp:forward page="${redirectPage}"/> erfordert, der übergebene Wert jedoch ein relativer Pfad wie /registry/thin/{pagename}.jsp ist. Dieser funktioniert selbst dann nicht, wenn Authenticate.jsp eine reine JSP-Seite ist.
Verwenden Sie nach dem Upgrade von Anwendungsserver das asadmin-Tool, um die folgenden Befehle zum Festlegen des <auth-realm> in domain.xml auszuführen:
Wechseln Sie zu as-install/bin, und führen Sie den folgenden Befehl aus:
./asadmin delete-auth-realm --host localhost --port 6489 certificate |
Dadurch wird das alte auth-realm-Zertifikat entfernt (sofern vorhanden).
Führen Sie den folgenden Befehl aus:
./asadmin create-auth-realm --terse=false --echo=true --interactive=true \ --user admin --host localhost --port 6489 --classname \ com.sun.enterprise.security.auth.realm.certificate.CertificateRealm \ --property assign-groups=have.client.cert certificate |
Dadurch wird der neue <auth-realm> mit der assign-groups-Eigenschaft erstellt.
Halten Sie die Anwendungsserver-Domäne registry an, und starten Sie sie neu.
Beim Ausführen der asupgrade-GUI in einer anderen Sprache als Englisch ist keine lokalisierte Version der Online-Hilfe für die GUI vorhanden.
Gegenwärtig ist keine Lösung verfügbar. Die Lokalisierung der Online-Hilfe ist für alle Zielsprachen neben Englisch geplant.
Nach dem Upgrade einer Konfiguration mit mehreren Domänen sind lediglich die Knotenagenten der zuletzt verarbeiteten Domäne vorhanden. Dieses Problem tritt auf, da das Upgrade-Tool das nodeagents-Verzeichnis auf dem Ziel jedes Mal entfernt und neu erstellt, wenn es eine Domäne verarbeitet.