test

Versionshinweise zu Sun Java System Application Server 9.1 Update 1-9.1 Update 2

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 /lib/package-appclient.xml ist standardmäßig ein hartcodierter Wert für die Variable AS_ACC_CONFIG für domain1 festgelegt, auf den in der 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.

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

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 eine 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 Anwendungsserver über sun-appserv-admin führt zu LoginException-Fehler (6288893)

Lösung

  1. Benennen Sie das vorhandene Skript as-install/bin/asant in asant.bak um.

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

  3. Bearbeiten Sie das soeben kopierte Skript as-install/bin/asant, 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 Anwendungsserver-Dokumentation beschrieben (6315957)

Beschreibung

Die Datei .asadmintruststore wird in der Anwendungsserver-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

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 Anwendungsserver-Cluster-Instanz lautet LOCAL. Wenn Anwendungsserver 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.

Hinweis –

Bei Auswahl des REMOTE-Modus verwenden alle Instanzen einen Broker (DAS), sodass beim Start des Anwendungsserver-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!

ProcedureVerwenden 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

ProcedureVerwenden 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:


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 Anwendungsserver 9.1 Update 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 Anwendungsserver geändert. Für die Versionen 7.x, 8. x und 9.x lautet der standardmäßige Admin-Port wie folgt:

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 Anwendungsserver der Standardport 4848 beibehalten wird.

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-Fehler (wahrscheinlich nicht übersetzt): java.lang.NullPointerException
 Enter keystore password:  New keystore password:

ProcedureLösung: (AIX) So erstellen Sie eine Domäne mit einem benutzerdefinierten Master-Passwort

Hinweis –

In der folgenden Vorgehensweise werden nur die in den einzelnen Schritten erforderlichen Optionen verwendet. Wenn Sie zusätzliche Optionen für einen Befehl benötigen, geben Sie diese Optionen im Befehl an. Informationen zu Anwendungsserver-Befehlen finden Sie im Sun Java System Application Server 9.1 Update 1-9.1 Update 2 Reference Manual .

  1. Erstellen Sie ein Shell-Skript, das die folgenden Codezeilen enthält:

    #!/bin/sh
changeKeystorePass() {
  keytool -storepasswd -keystore ${KEYSTORE} -storepass ${OLD} -new ${NEW}
}
changeTruststorePass() {
  keytool -storepasswd -keystore ${TRUSTSTORE} -storepass ${OLD} -new ${NEW}
}
changeKeyPass() {
  keytool -keypasswd -alias s1as -keystore ${KEYSTORE} -storepass ${NEW} -keypass ${OLD} -new ${NEW}
}
changeDomainPasswordEntry() {
  keytool -storepasswd -storetype JCEKS -keystore ${DOMAINPASSWORDS} -storepass ${OLD} -new ${NEW}
}
deleteMasterPasswordFile() {
  if [ -f ${DOMAIN_PATH}/master-password ] ; then
    echo Deleting ${DOMAIN_PATH}/master-password
    rm -f ${DOMAIN_PATH}/master-password
  fi
}
DOMAIN_PATH=$1
OLD=$2
NEW=$3
if [ $# != 3 ] ; then
  echo Usage: $0 domain-path old-master-pass new-master-pass
  exit 1
fi
echo Processing ...
if [ ! -f ${DOMAIN_PATH}/config/domain.xml ] ; then
  echo "Domain with folder ${DOMAIN_PATH} does not exist, create it first"
  exit 2
else
  KEYSTORE=${DOMAIN_PATH}/config/keystore.jks
  TRUSTSTORE=${DOMAIN_PATH}/config/cacerts.jks
  DOMAINPASSWORDS=${DOMAIN_PATH}/config/domain-passwords
  changeKeystorePass
  changeTruststorePass
  changeKeyPass
  changeDomainPasswordEntry
  deleteMasterPasswordFile
fi

  2. Erstellen Sie eine Domäne, und geben Sie dabei das standardmäßige Master-Passwort an.


    aadmin create-domain {--adminport aminportno|--portbase portbase} domain-name
Please enter the admin user name>admin-user
Please enter the admin password>admin-user-password
Please enter the admin password again>admin-user-password
Please enter the master password [Enter to accept the default]:>
Please enter the master password again [Enter to accept the default]:>

    Das standardmäßige Master-Passwort lautet changeit.

  3. Ändern Sie das Masterpasswort der Domäne, die Sie soeben erstellt haben.

    Um das Masterpasswort zu ändern, führen Sie das in Schritt 1 erstellte Skript aus.


    script-name domain-path old-password new-password

  4. Starten Sie die in Schritt 2 erstellte Domäne.


    asadmin start-domain Domaenenname

    Da die Domäne über ein benutzerdefiniertes Master-Passwort verfügt, werden Sie zur Eingabe des Master-Passworts aufgefordert.

  5. Geben Sie das neue Master-Passwort ein.

  6. Für Domänen, die für die Clusterunterstützung konfiguriert wurden, erstellen und starten Sie einen Knotenagenten.

    1. Erstellen Sie einen Knotenagenten für die Domäne, die Sie in Schritt 2 erstellt haben.


      asadmin create-node-agent --port portno --user admin-user

    2. Starten Sie den Knotenagenten, den Sie in Schritt a erstellt haben.


      asadmin start-node-agent

      Da die Domäne über ein benutzerdefiniertes Master-Passwort verfügt, werden Sie zur Eingabe des Master-Passworts aufgefordert.

    3. Geben Sie das neue Master-Passwort ein.

Siehe auch

Die folgenden Anwendungsserver-Manpages:

AIX: 0403-027 The parameter list is too long (6625591)

Beschreibung

Unter einem AIX-Betriebssystem schlagen einige mit dem Betriebssystem verknüpfte Operationen möglicherweise mit folgendem Fehler fehl:


0403-027 The parameter list is too long

Beispiele für Operationen, die mit dem Betriebssystem verknüpft sind, sind die Bereitstellung von Anwendungen oder das Ausführen des Anwendungsclientcontainers.

Dieses Problem wird üblicherweise durch lange Dateipfade in der Umgebungsvariable CLASSPATH verursacht.

Lösung

Wählen Sie eine der folgenden Lösungen:

Procedure(AIX) So erhöhen Sie die maximale Länge der Befehlszeile

Das ncargs-Attribut bestimmt die maximale Länge der Befehlszeile, einschließlich Umgebungsvariablen. Unter AIX-Betriebssystemen lautet der Standardwert des ncargs-Attributs vier, 4–KB-Blöcke. Um sicherzustellen, dass Anwendungsserver-Befehle die maximale Länge der Befehlszeile nicht überschreiten, erhöhen Sie diesen Wert auf 16 4–KB-Blöcke.

Hinweis –

Nachdem Sie das ncargs-Attribut geändert haben, ist kein Neustart und keine Aktualisierung von Daemons erforderlich.

  1. Ermitteln Sie den Wert des ncargs-Attributs.


    lsattr -EH -l sys0 | grep ncargs

  2. Wenn der Wert von ncargs geringer ist als 16 4–KB-Blöcke, erhöhen Sie den Wert auf 16.


    chdev -l sys0 -a ncargs=16