Administration

In diesem Abschnitt werden bekannte Verwaltungsprobleme sowie ihre Lösungen beschrieben.

Das Skript package-appclient funktioniert nicht, wenn domain1 nicht vorhanden ist (6171458)

Beschreibung

In $INSTALL/lib/package-appclient.xml ist standardmäßig ein hartkodierter Wert für die Variable AS_ACC_CONFIG für domain1 festgelegt, auf den durch die Datei asenv.conf verwiesen wird. Wenn domain1 gelöscht und eine neue Domäne erstellt wird, wird die AS_ACC_CONFIG-Variable nicht entsprechend der neuen Domäne aktualisiert, sodass die Ausführung des package-appclient-Skripts fehlschlägt.

Lösung

Gehen Sie folgendermaßen vor:

1. Entfernen Sie domain1 nicht und erstellen Sie andere Domänen um diese Domäne.

2. Entfernen Sie domain1, und ersetzen Sie den hartcodierten Wert für domain1 in $INSTALL/lib/package-appclient.xml durch den neuen Domänennamen.

Diesen Vorgang müssen Sie für jede neu erstellte Domäne durchführen, wenn domain1 nicht mehr vorhanden ist.

Keine Wiederherstellung einer gesicherten Domäne mit einem anderen Namen möglich (6196993)

Beschreibung

Eine Domäne kann in derselben Application Server-Installation nicht über die Befehle backup-domain und restore-domain gespiegelt werden, da die Domäne nicht unter Verwendung eines anderen Namens als dem ursprünglichen Namen wiederhergestellt werden kann (wenngleich der Befehl asadmin restore-domain eine Option zum Umbenennen der Domäne bietet). Die Umbenennung der gesicherten Domäne scheint erfolgreich, doch der Versuch, die umbenannte Domäne zu starten, schlägt fehl, da die Einträge in der Domänenkonfiguration nicht geändert werden und startserv und stopserv den ursprünglichen Domänennamen zum Festlegen von Pfaden verwenden.

Lösung

Der vom Befehl restore-domain verwendete Domänenname muss mit dem ursprünglichen, vom Befehl backup-domain verwendeten Domänennamen übereinstimmen. Die Befehle backup-domain und restore-domain in Application Server 8.1 funktionieren nur zum Sichern und Wiederherstellen derselben Domäne auf demselben Computer.

Das Starten von Application Server mit einem zusätzlichen JMX-Agenten wird nicht unterstützt (6200011)

Beschreibung

J2SE 1.4.x, 5.0 oder höher kann für die Ausführung mit Application Server konfiguriert werden. In J2SE 5.0 ermöglicht eine plattformeigene Funktion das Starten eines JMX-Agenten. Um diese Funktion zu aktivieren, setzen Sie die entsprechenden Systemeigenschaften für den Serverstart fest.

Zu den möglichen Werten gehören:

name="com.sun.management.jmxremote" value="true"
name="com.sun.management.jmxremote.port" value="9999"
name="com.sun.management.jmxremote.authenticate" value="false"
name="com.sun.management.jmxremote.ssl" value="false"

Nachdem Sie die JMX-Eigenschaften konfiguriert und den Server gestartet haben, wird ein neuer jmx-connector-Server in der Virtual Machine von Application Server gestartet. Ein unerwünschter Nebeneffekt davon besteht darin, dass die Administrationsfunktionen beeinträchtigt werden und die Application Server-Administrationskonsole und Befehlszeilenschnittstelle evtl. unerwünschte Ergebnisse produzieren. Dieses Problem wird durch Konflikte zwischen dem integrierten jmx-connector-Server und dem neuen jmx-connector-Server verursacht.

Lösung

Wenn Sie jconsole (oder einen anderen JMX-kompatiblen Client) verwenden, können Sie den standardmäßig beim Start von Application Server gestarteten JMX-Konnektor-Server wiederverwenden.

Wird der Server gestartet, wird eine Zeile ähnlich der unten dargestellten Zeile auf dem Server angezeigt.Protokoll. Sie können eine Verbindung zum dort angegebenen JMXService-URL herstellen und dieselben Management-/Konfigurationsoperationen durchführen, nachdem Sie die Anmeldeinformationen erfolgreich angegeben haben, beispielsweise:

[#|2004-11-24T17:49:08.203-0800|INFO|sun-appserver-ee8.1|
javax.enterprise.system.tools.admin|_ThreadID=10;|ADM1501: 
Dies ist die JMXServiceURL für JMXConnectorServer: 
[service:jmx:rmi:///jndi/rmi://hostname:8686/management/
rmi-jmx-connector]. Dieser URL gilt für die entfernten 
administrativen Clients, die die JSR 160 JMX-Konnektoren verwenden.|#]

Weitere Informationen finden Sie im Sun Java System Application Server 9.1 Administration Guide .

Unter UNIX führen übermäßig einschränkende Ausführungsberechtigungen in Application Server zum Starten und Anhalten von Skripts (6206176)

Beschreibung

Wenn Sie als Benutzer "A" angemeldet sind und den Befehl asadmin restore-domain ausführen, wird in den Skripts die Berechtigung 744 (rwxr--r--) festgelegt. Wenn Sie anschließend als Benutzer "B" angemeldet sind, können Sie keine Domäne starten oder beenden (selbst wenn Benutzer "B" Root ist), da die Skripts nur noch von Benutzer "A" ausgeführt werden können.

Lösung

Ändern Sie die Berechtigungen in den Skripts:

chmod 755 appserv/domains/domain-name/bin/*

Konfigurationsdatei für den Lastenausgleich wird nicht mit der Endpunkt-URL eines Webservice erstellt (6236544, 6275436)

Beschreibung

Beim Einrichten der Lastenausgleichskonfiguration mit einer Anwendung, die über ein EJB-Modul verfügt und einen Webservice-URL exportiert, befindet sich das Kontext-Stammverzeichnis (root) für den Webservice nicht in der resultierenden Datei loadbalancer.xml.

Lösung

1. Bearbeiten Sie die Datei loadbalancer.xml wie folgt, um das fehlende Webmodul hinzuzufügen:

   <web-module context-root="context-root-name" disable-timeout-in-minutes="30" enabled="true"/>

2. Ersetzen Sie den Wert context-root-name mit dem Kontext-Rootnamen des Webservice, der als EJB offengelegt wurde.

Neustart von Application Server über sun-appserv-admin führt zu LoginException-Fehler(6288893)

Lösung

1. Benennen Sie das vorhandene <as_install> /bin/asant-Skript in asant.bak um.

2. Kopieren Sie die Datei asant.template in <as_install> /lib/install/templates/ee (für die SE/EE-Version) in das <as_install>/bin/-Verzeichnis und benennen Sie die Datei in asant um.

3. Bearbeiten Sie das gerade kopierte <as_install> /bin/asant-Skript, wobei Sie das %CONFIG_HOME%-Token durch <as_install>/config ersetzen.

4. Falls manuelle Änderungen an der ursprünglichen asant.bak-Datei vorgenommen wurden, führen Sie diese in das neue asant-Skript zusammen.

Die Datei .asadmintruststore ist nicht in der Application Server-Dokumentation beschrieben (6315957)

Beschreibung

Die Datei .asadmintruststore wird in der Application Server-Dokumentation nicht beschrieben. Falls diese Datei nicht im home-Verzeichnis des Serveradministrators vorhanden ist, können schwerwiegende Fehler beim Upgrade bestimmter, auf dem Server gehosteter Anwendungen auftreten.

Lösung

• Falls möglich, sollte der Befehl asadmin start-domain domain1 von dem Benutzer ausgeführt werden, der den Server installierte.

• Falls er nicht von diesem Benutzer ausgeführt wird, sollte .asadmintruststore aus dem home-Verzeichnis des installierenden Benutzers in das home-Verzeichnis des ausführenden Benutzers kopiert werden.

• Beachten Sie Folgendes: Falls die Datei aus dem home-Verzeichnis des installierenden Benutzers in das home-Verzeichnis des ausführenden Benutzers verschoben (nicht kopiert) wird, treten eventuell Probleme beim Anwendungsupgrade auf, wie in den Bugs 6309079, 6310428 und 6312869 beschrieben, da der Upgrade-/Installationsbenutzer (in Java ES in der Regel root) in seinem Stammverzeichnis nicht mehr über die Datei .asadminstruststore verfügt.

Cluster-Instanzen werden aufgrund einer Zeitüberschreitung beim Herstellen der Verbindung mit dem JMS-Broker nicht gestartet (6523663)

Beschreibung

Der standardmäßige MQ-Integrationsmodus für eine Application Server-Cluster-Instanz lautet LOCAL. Wenn Application Server in einem Verzeichnis (PATH) installiert wird, das lang (also "not short") ist, stürzt imqbrokerscv.exe beim Starten der Cluster-Instanz ab. Das Problem wird durch die Speicherzuweisung in imqbrokersvc verursacht.

Lösung

Der JMS-Diensttyp für die Cluster-Instanz muss vom Standardwert LOCAL in REMOTE geändert werden. In dieser Konfiguration zeigen alle Instanzen auf den DAS-Broker. Befolgen Sie die unten stehenden Anweisungen zum Konfigurieren eines Clusters im REMOTE-Modus.

Bei Auswahl des REMOTE-Modus verwenden alle Instanzen einen Broker (DAS), sodass beim Start des Application Server-Clusters kein Broker-Cluster erstellt wird. Weitere Informationen finden Sie in Abschnitt 4.1, Unterabschnitt iii, "Auto-clustering" des einseitigen Dokuments unter http://www.glassfishwiki.org/gfwiki/attach/OnePagersOrFunctionalSpecs/as-mq-integration-gfv2.txt. Die oben stehende Funktionalität ist nicht verfügbar!

Verwenden der Befehlszeile

Bevor Sie beginnen

Ändern Sie den Port und die Passwortdatei gemäß Ihrer Umgebung. Beachten Sie, dass im unten stehenden Beispiel der Clustername racluster, der DAS-Admin-Port 5858 und der DAS JMS-Port 7676 lautet.

1. Ändern Sie die Clusterkonfiguration, und ändern Sie den JMS-Typ in REMOTE .

   $AS91_HOME/bin/asadmin.bat set --port 5858 --user admin --passwordfile \ $AS91_HOME/bin/password_file racluster.jms-service.type=REMOTE

2. Erstellen Sie einen JMS-Host in Übereinstimmung mit dem DAS JMS-Host.

   $AS91_HOME/bin/asadmin.bat create-jms-host --port 5858 --user admin --passwordfile \ $AS91_HOME/bin/password_file --target racluster --mqhost localhost --mqport 7676 \ --mquser admin --mqpassword admin dashost

3. Legen Sie für den JMS-Host den DAS JMS-Host fest, der im vorherigen Schritt erstellt wurde.

   $AS91_HOME/bin/asadmin.bat set --port 5858 --user admin --passwordfile \ $AS91_HOME/bin/password_file racluster.jms-service.default-jms-host=dashost

Verwenden der Admin-GUI

1. Wechseln Sie zu "Konfigurationen"->Clustername-config->"Java Message Service"->"JMS-Hosts".

2. Klicken Sie auf Neu, um einen neuen JMS-Host zu erstellen; wählen Sie für diesen Host den Namen dashost.

3. Geben Sie die Konfigurationseinstellungen in Übereinstimmung mit dem JMS-Dienst für den DAS ein; die Standardwerte lauten wie folgt:

   • Hostname: localhost

   • Port: 7676

   • Admin-Benutzer: admin

   • Passwort: admin

   Ändern Sie diese Einstellungen nach Bedarf für Ihren DAS JMS-Dienst.

4. Wechseln Sie erneut auf die Registerkarte "Java Message Service", und ändern Sie den JMS-Diensttyp in REMOTE (der Standardwert lautet LOCAL).

5. Wählen Sie dashost aus der Dropdown-Liste default-jms-host aus.

6. Speichern Sie die Änderungen, und starten Sie den Knotenagenten oder Cluster.

Keine Anzeige des jmaki-Diagramms in Netscape 8.1.3, Mozilla 1.7 und Safari 2.0.4 möglich (6543014)

Beschreibung

Beim Versuch, ein Diagramm von der Seite zur Überwachung der Protokollstatistik über einen nicht unterstützten Browser anzuzeigen, wird möglicherweise die folgende Fehlermeldung angezeigt:

Fehler beim Laden von jmaki.widgets.jmaki.charting.line.Widget : id=form1:jmaki_chart11
Skript: http://easqelx5.red.iplanet.com:4848/resources/jmaki/charting/ \
line/component.js (line:5437).
Meldung: area.initialize ist keine Funktion

Lösung

Verwenden Sie einen unterstützten Browser. Eine Liste der in Application Server 9.1 unterstützten Browser finden Sie unter Browser.

Standardports ändern sich in jeder Hauptversion von AS (6566481)

Beschreibung

Der standardmäßige Admin-Port wurde in jeder der drei vergangenen Versionen von Application Server geändert. Für die Versionen 7.x, 8. x und 9.x lautet der standardmäßige Admin-Port wie folgt:

• AS 7.x: 4848

• AS 8.x: 4849

• AS 9.x: 4848

Lösung

Dies ist kein Fehler, sollte jedoch beachtet werden. Der standardmäßige Admin-Port ist lediglich eine Empfehlung. Es wird davon ausgegangen, dass in zukünftigen Versionen von Application Server der Standardport 4848 beibehalten wird.