Administration

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

Communications Server erkennt keine Probleme mit dem Heartbeat-Port eines Clusters (Problem 1967)

Beschreibung

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.

Lösung

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

Domänenerstellung stoppt auf NFS-Server, der 64-Bit-Linux ausführt (Problem 1961)

Beschreibung

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.

Lösung

Keine bekannte Lösung.

Beobachteter Leistungsabfall beim Rotieren einer großen Protokolldatei (Problem 6718611)

Beschreibung

Beim Rotieren einer großen Protokolldatei wird eine leichte Heraufsetzung der Antwortzeit beobachtet.

Lösung

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.

Generic RA Resource Adapter konnte nicht für IBM MQ bereitgestellt werden (Problem 6605)

Beschreibung

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";
      }

Lösung

Ä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";
 };

Standalone-Instanzen erhalten gelegentlich Dateien von anderen Instanzen (6698604).

Beschreibung

Unter bestimmten Bedingungen werden Dateien, die auf DAS installiert sind und die mit einer bestimmten Instanz synchronisiert werden sollen, an weitere Instanzen gesendet.

Lösung

Keine bekannte Lösung.

Die Startmeldung des Befehls start-cluster ist zu ausführlich.

Beschreibung

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.

Lösung

Keine bekannte Lösung. Diese Meldungen (Ausnahmen) können ignoriert werden.

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

Beschreibung

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.

Lösung

Gehen Sie folgendermaßen vor:

1. Entfernen Sie domain1 nicht und erstellen Sie die anderen Domänen um diese Domäne herum.

2. 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.

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 integriertenjmx-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.

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 (6315957)

Beschreibung

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.

Lösung

• 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.

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 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.

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 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!

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 .

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

2. 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

3. 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

Verwenden der Admin-GUI

1. Wechseln Sie zu ?Konfigurationen“->cluster-name-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

   • Password: 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:

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

Lösung

Verwenden Sie einen unterstützten Browser. Unter Browser finden Sie eine Liste der von Communications Server unterstützten Browser.

Der create-domain-Befehl schlägt mit einem benutzerdefinierten Master-Passwort unter AIX fehl (6628170)

Beschreibung

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: