In diesem Abschnitt werden bekannte Verwaltungsprobleme sowie ihre Lösungen beschrieben.
Bei der Erstellung eines Clusters weist Communications Server einen zufälligen Heartbeat-Port zwischen 1026 und 45556 zu. Bei·default-cluster, dem von einer Communications Server-Installation erstellten Standard-Cluster, wird eine Zufallszahl zwischen 0 und 45556 gewählt. Bei der Cluster-Erstellung wird nicht präzise erkannt, ob der Heartbeat-Port bereits von einem anderen Dienst verwendet wird.
Wenn bei der automatisierten Cluster-Erstellungskonfiguration ein Heartbeat-Port gewählt wird, der im Konflikt zu einem anderen Dienst steht, der bereits diesen Port verwendet, aktualisieren Sie den Heartbeat-Port des Clusters in einen Port, der nicht vom System verwendet wird.
Um den Heartbeat-Port eines Clusters zu ändern, verwenden Sie den folgenden asadmin-Befehl:
asadmin set Cluster-Name.heartbeat-port= neuePortNummer
Der Befehl asadmin create-domain kann während des Versuchs, eine Domäne in einem von NFS eingehängten Dateisystem (Network File System, NFS = Netzwerkdateisystem) mit einem 64-Bit-Linux ausführenden NFS-Server zu erstellen, fehlschlagen.
Keine bekannte Lösung.
Beim Rotieren einer großen Protokolldatei wird eine leichte Heraufsetzung der Antwortzeit beobachtet.
Der Leistungsabfall kann minimiert werden, indem die Werte für "Dateirotationslimit" und "Dateirotationszeitlimit" in den Einstellungen der Protokollfunktion geändert werden. Die Werte für diese Eigenschaften hängen von Ihrer Anwendung und Umgebung ab.
Die Bereitstellung eines generischen RA-Adapters für IBM Message Queue schlägt fehl. In der Datei server.policy werden folgende Berechtigungen gewährt.
grant { permission java.util.logging.LoggingPermission "control"; permission java.util.PropertyPermission "*", "read,write"; } |
Ändern Sie die Berechtigungen in der Datei server.policy wie folgt:
grant codeBase "file:${com.sun.aas.installRoot}/lib/install/applications/adminapp/-" { permission java.util.logging.LoggingPermission "control"; }; |
Unter bestimmten Bedingungen werden Dateien, die auf DAS installiert sind und die mit einer bestimmten Instanz synchronisiert werden sollen, an weitere Instanzen gesendet.
Keine bekannte Lösung.
Der Befehl asadmin start-cluster zeigt zu viele Meldungen an, auch wenn nicht kritische Komponenten während des Startens ausfallen. Beachten Sie das folgende Beispiel einer Befehlsausgabe, wenn nicht kritische Elemente (bezogen auf die Instanzen im Cluster) ausfallen:
./asadmin start-cluster --port 9898 cluster1 Please enter the admin user name>admin Please enter the admin password> The clustered instance, instance2, was successfully started. error 0 [#|2008-07-17T14:58:16.496+0200|WARNING|sun-appserver9.1|javax.jms| _ThreadID=10;_ThreadName=main; _RequestID=90bbbe3a-d654-4480-b295-7e317d945a4a;|[C4003]: Error occurred on connection creation [localhost:37676]. - cause: java.net.ConnectException: Connection refused|#] error 1 [#|2008-07-17T14:58:17.517+0200|WARNING|sun-appserver9.1|javax.jms| _ThreadID=10;_ThreadName=main; _RequestID=90bbbe3a-d654-4480-b295-7e317d945a4a;|[C4003]: Error occurred on connection creation [localhost:37676]. - cause: java.net.ConnectException: Connection refused|#] error 2 [#|2008-07-17T14:58:30.596+0200|WARNING|sun-appserver9.1| javax.enterprise.system.container.ejb| _ThreadID=13;_ThreadName=pool-1-thread-4;TimerBean; _RequestID=5954a044-df06-4a3e-902a-0c40b4b6cddb; |EJB5108:Unable to initialize EJB Timer Service. The likely cause is the database has not been started or the timer database table has not been created.|#] error 3 [#|2008-07-17T14:58:32.512+0200|WARNING|sun-appserver9.1| javax.enterprise.resource.resourceadapter|_ThreadID=10;_ThreadName=main; __CallFlowPool;_RequestID=90bbbe3a-d654-4480-b295-7e317d945a4a;| RAR5005:Error in accessing XA resource with JNDI name [__CallFlowPool] for recovery|#] The clustered instance, instance1, was successfully started. error 0 [#|2008-07-17T14:58:21.117+0200|WARNING|sun-appserver9.1| javax.enterprise.system.container.ejb| _ThreadID=13;_ThreadName=pool-1-thread-4;TimerBean; _RequestID=30827d9a-72ac-4854-b216-06494b6a9fb5; |EJB5108:Unable to initialize EJB Timer Service. The likely cause is the database has not been started or the timer database table has not been created.|#] error 1 [#|2008-07-17T14:58:23.106+0200|WARNING|sun-appserver9.1| javax.enterprise.resource.resourceadapter| _ThreadID=10;_ThreadName=main;__CallFlowPool; _RequestID=b41d76fa-0203-49f7-a2ae-83bf242d3e7a; |RAR5005:Error in accessing XA resource with JNDI name [__CallFlowPool] for recovery|#] Command start-cluster executed successfully. |
Keine bekannte Lösung. Diese Meldungen (Ausnahmen) können ignoriert werden.
Standardmäßig befindet sich hartcodierter Wert in as-install/lib/package-appclient.xml , der für die Variable AS_ACC_CONFIG für domain1 gilt, auf die asenv.conf verweist. 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.
Gehen Sie folgendermaßen vor:
Entfernen Sie domain1 nicht und erstellen Sie die anderen Domänen um diese Domäne herum.
Entfernen Sie domain1, und ersetzen Sie den hartcodierten Wert für domain1 in as-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.
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 integriertenjmx-connector-Server und dem neuen jmx-connector-Server verursacht.
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.
Beim Starten des Servers wird eine Zeile ähnlich der unten dargestellten Zeile auf dem Server angezeigt. Sie können eine Verbindung zur 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: Here is the JMXServiceURL for the JMXConnectorServer: [service:jmx:rmi:///jndi/rmi://hostname:8686/management/ rmi-jmx-connector]. This is where the remote administrative clients should connect using the JSR 160 JMX Connectors.|#] |
Die Datei .asadmintruststore wird in der 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.
Falls möglich, sollte der Befehl asadmin start-domain domain1 von dem Benutzer ausgeführt werden, der den Server installierte.
Wenn .asadmintruststore nicht von diesem Benutzer ausgeführt wird, muss es vom Verzeichnis Home des installierenden Benutzers in das Verzeichnis Home des ausführenden Benutzers verschoben oder kopiert werden.
Beachten Sie, dass beim Verschieben der Datei (nicht kopieren) vom Verzeichnis Home des installierenden Benutzer zum Verzeichnis Home des ausführenden Benutzers Probleme mit dem Upgrade der Anwendung auftreten können, wie in den Bugs 6309079, 6310428 und 6312869 beschrieben, da der Upgrade/Installations-Benutzer (normalerweise root in Java ES) nicht mehr über die Datei .asadminstruststore in seinem Home-Verzeichnis verfügt.
Der standardmäßige MQ-Integrationsmodus für eine Communications Server-Cluster-Instanz lautet LOCAL. Wenn Communications Server in einem Verzeichnis (PATH) installiert wird, das lang (also "nicht kurz") ist, stürzt imqbrokerscv.exe beim Starten der Cluster-Instanz ab. Das Problem wird durch die Speicherzuweisung in imqbrokersvc verursacht.
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 Communications Server-Clusters kein Broker-Cluster erstellt wird. Weitere Informationen finden Sie in “Auto-clustering” in Abschnitt 4.1, Absatz iii in der Übersicht auf http://www.glassfishwiki.org/gfwiki/attach/OnePagersOrFunctionalSpecs/as-mq-integration-gfv2.txt. Die oben stehende Funktionalität ist nicht verfügbar!
Ä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.
Ändern Sie die Clusterkonfiguration, und ändern Sie den JMS-Typ in REMOTE .
as-install/bin/asadmin.bat set --port 5858 --user admin --passwordfile \ as-install/bin/password_file racluster.jms-service.type=REMOTE |
Erstellen Sie einen JMS-Host in Übereinstimmung mit dem DAS JMS-Host.
as-install/bin/asadmin.bat create-jms-host --port 5858 --user admin --passwordfile \ as-install/bin/password_file --target racluster --mqhost localhost --mqport 7676 \ --mquser admin --mqpassword admin dashost |
Legen Sie für den JMS-Host den DAS JMS-Host fest, der im vorherigen Schritt erstellt wurde.
as-install/bin/asadmin.bat set --port 5858 --user admin --passwordfile \ as-install/bin/password_file racluster.jms-service.default-jms-host=dashost |
Wechseln Sie zu ?Konfigurationen“->cluster-name-config->Java Message Service->JMS Hosts.
Klicken Sie auf Neu, um einen neuen JMS-Host zu erstellen; wählen Sie für diesen Host den Namen dashost.
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
Password: admin
Ändern Sie diese Einstellungen nach Bedarf für Ihren DAS JMS-Dienst.
Wechseln Sie erneut auf die Registerkarte "Java Message Service", und ändern Sie den JMS-Diensttyp in REMOTE (der Standardwert lautet LOCAL).
Wählen Sie dashost aus der Dropdown-Liste default-jms-host aus.
Speichern Sie die Änderungen, und starten Sie den Knotenagenten oder Cluster.
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:
Error loading jmaki.widgets.jmaki.charting.line.Widget : id=form1:jmaki_chart11 Script: http://easqelx5.red.iplanet.com:4848/resources/jmaki/charting/ \ line/component.js (line:5437). Message: area.initialize is not a function |
Verwenden Sie einen unterstützten Browser. Unter Browser finden Sie eine Liste der von Communications Server unterstützten Browser.
Unter einem AIX-Betriebssystem schlägt der Versuch, eine Domäne mit einem benutzerdefinierten Master-Passwort zu erstellen, mit dem folgenden Fehler fehl:
keytool error (likely untranslated): java.lang.NullPointerException Enter keystore password: New keystore password: |