Fehlermeldungen. Adobe LiveCycle ES2

3

Fehlermeldungen

LiveCycle ES2-Protokolldatei, Fehlermeldungen

In diesem Abschnitt werden die Probleme und Lösungen beschrieben, die zu den Fehlermeldungen in der

LiveCycle ES2-Protokolldatei gehören.

Allgemeine Fehlermeldungen

In diesem Abschnitt werden LiveCycle ES2-unspezifische Fehlermeldungen und Lösungen der zugrunde liegenden Probleme beschrieben.

Zu wenig Arbeitsspeicher

Dieser Typ von Fehler wird meist von einem der folgenden Probleme verursacht:

●

●

●

„Zu wenig Threads“ auf Seite 49

„Threads und Arbeitsspeicherzuordnungen“ auf Seite 50

„Ausführen des Document Management-Dienstes für Content Services ES2 auf Basishardware“ auf

Seite 52

Zu wenig Threads

Es gibt viele Arten von Threads, die jedoch im Wesentlichen zu zwei Kategorien gehören:

Java-Threads und native Threads. Alle in einer JVM ausgeführten Threads sind Java-Threads (Klasse java.lang.Thread

innerhalb von Java). Der native Code (C++/C) erzeugt native Threads, die vom

Betriebssystem geplant und verwaltet werden. Dies sind die Hauptunterschiede zwischen den beiden

Typen:

●

●

Java-Threads werden entweder vom LiveCycle ES2-Code, Anwendungsserver oder der JVM selbst erstellt und verwaltet.

Betriebssystemtools (wie Systemmonitor oder Task-Manager) verfügen nur über Informationen zu nativen Threads.

Da das Betriebssystem Java-Threads nicht transparent machen kann, überwachen Sie beim Überwachen von Threads mit Betriebssystemtools wie Systemmonitor ausschließlich native Threads. Die einzige

Möglichkeit, Details zu Java-Threads zu erfahren, ist das Ausführen eines Java-Thread-Dumps. Das

Verfahren zum Ausgeben eines Java-Thread-Dumps hängt vom Anwendungsserver und der JVM ab.

Informationen hierzu finden Sie in der Dokumentation des Herstellers.

Die Implementierung der JVM erfolgt in C/C++-Code und dieser JVM-Code ordnet Java-Threads nativen

Threads zu. Die Zuordnung kann entweder 1:1 (1 Java-Thread zu 1 nativen Thread) oder n:1 (mehrere

Java-Threads zu 1 nativen Thread) sein. Die Einzelheiten zur Funktionsweise dieser Zuordnung sind

JVM-herstellerspezifisch, doch die 1:1-Zuordnung ist meist die Standardeinstellung. Dies bedeutet, dass jeder Java-Thread über einen entsprechenden nativen Thread verfügt. Die Anzahl der Java-Threads ist jedoch nicht begrenzt. Da aber die 1:1-Zuordnung die Regel ist und die Anzahl der nativen Threads begrenzt ist, stehen ggf. auch zu wenig Java-Threads zur Verfügung. Diese Begrenzung gilt pro Prozess

(die JVM ist auch ein einzelner Prozess) und variiert je nach Betriebssystem. Sie können davon ausgehen,

49

Adobe LiveCycle ES2

Fehlerbehebung in LiveCycle ES2

Fehlermeldungen

Zu wenig Arbeitsspeicher 50 dass sich die Begrenzung im Tausenderbereich, aber unter 10.000 bewegt. Unabhängig von diesem Wert können viele Hundert Threads ein Leistungsproblem darstellen, da das Betriebssystem diese hohe Anzahl von Threads einplanen muss.

Threads und Arbeitsspeicherzuordnungen

Ein weiteres gängiges Problem bei Threads ist die Arbeitsspeicherzuordnung. Wird ein neuer Java-Thread zugewiesen, ist für dessen Stapel eine feste Menge an Arbeitsspeicher erforderlich. Dieser

Thread-Stapelspeicher ist ein Parameter (Option -Xss für die Sun™-JVM), dessen Standardeinstellung

„~512 KB“ beträgt. Bei 1.000 Threads sind dann allein für die Stapel des Threads 500 MB Arbeitsspeicher erforderlich. Dieser Arbeitsspeicher steht dann in Konkurrenz zu allen anderen Arbeitsspeicherzuordnungen, die in der JVM erfolgen, z. B. mit den Zuordnungen von LiveCycle ES2, wodurch es zu Problemen bei der

Zuordnung von Arbeitsspeicher kommt.

Wenn die JVM in der Praxis keinen Arbeitsspeicher zuordnen oder keine Threads erzeugen kann, wird an die aufrufende Funktion eine Ausnahme vom Typ OutOfMemory (Zu wenig Arbeitsspeicher) zurückgegeben. Zusammen mit dieser Ausnahme werden eine Stapelablaufverfolgung und ein Grund für die Auslösung der Ausnahme zurückgegeben. Dieser Grund muss unbedingt beachtet werden, da er weitere Hinweise auf die mögliche Fehlerursache bietet.

Der folgende Code ist ein Beispiel für eine Meldung mit zwei Fehlern und den dazugehörigen Fehlercodes:

„Neuer nativer Thread kann nicht erstellt werden: java.lang.OutOfMemoryError:

Neuer nativer Thread kann nicht erstellt werden java.lang.OutOfMemoryError:

Java-Heap-Speicher“

Diese Fehler bedeuten, dass die JVM aus einem der folgenden Gründe keine weiteren Threads erzeugen konnte:

●

●

Der prozessbezogene Thread-Grenzwert wurde erreicht.

Der Thread-Stapel kann nicht zugeordnet werden.

Um die exakte Ursache zu bestimmen, müssen Sie einen Thread-Dump (auch Java-Dump genannt) durchführen. Ein Thread-Dump wird in der Regel in der Datei javacore.xxxx.txt in den

Protokollverzeichnissen des Anwendungsservers abgelegt. Der Thread-Dump enthält sehr viele

Informationen, doch Sie können die Anzahl der Threads rasch bestimmen, indem Sie die Vorkommen des Tokens TID: in der Liste zählen. Ein typischer Eintrag sieht so aus:

"Thread-1227" (TID:0x106948F0, sys_thread_t:0x78996DA0, state:R, native

ID:0x191C) prio=5

4XESTACKTRACE at java.net.SocketInputStream.socketRead0(Native Method)

4XESTACKTRACE at java.net.SocketInputStream.read(SocketInputStream.java(Compiled Code))

4XESTACKTRACE at java.io.BufferedInputStream.fill(BufferedInputStream.java(Compiled Code))

4XESTACKTRACE at java.io.BufferedInputStream.read1(BufferedInputStream.java(Compiled Code))

4XESTACKTRACE at java.io.BufferedInputStream.read(BufferedInputStream.java(Compiled Code))

4XESTACKTRACE at com.sun.jndi.ldap.Connection.run(Connection.java(Compiled

Code))

4XESTACKTRACE at java.lang.Thread.run(Thread.java:567)

Adobe LiveCycle ES2

Fehlerbehebung in LiveCycle ES2

Fehlermeldungen

Zu wenig Arbeitsspeicher 51

Wenn Tausende von Threads vorhanden sind, gibt es wahrscheinlich zu wenig Threads. Entwickler können die offensichtlichen Ursachen ermitteln, indem die Stapelablaufverfolgungen dieser Threads untersucht werden.

Hinweis: Thread-Dumps sind meist intrusiv und erfordern einen anschließenden Neustart des

Anwendungsservers.

Sind mehrere Hundert Threads vorhanden, ist der Grund für die Fehlermeldung java.lang.OutOfMemory

nicht das Thread-Limit. Verkleinern Sie den Thread-Stapel (siehe die oben genannte Option -Xss ), starten Sie

LiveCycle ES2 erneut und prüfen Sie, ob das Problem behoben wurde.

Zu wenig Arbeitsspeicher: Java-Heap-Speicherfehler

In LiveCycle ES2 sind Transaktionen möglich, deren Ausführung länger dauert als vom standardmäßigen

WebLogic-Transaktionszeitlimit vorgesehen. Die Verarbeitung großer PDF-Dokumente kann beispielsweise sehr zeitaufwendig sein. Diese Fehler werden ggf. im Anwendungsserverprotokoll angezeigt, wenn LiveCycle Workbench ES2-Benutzer große Dateien in die Ansicht „Ressourcen“ ziehen.

Wenn OutOfMemoryError -Meldungen im Anwendungsserverprotokoll auftreten, müssen Sie das Transaktionszeitlimit erhöhen. Der empfohlene Wert betragt 300 Sekunden (5 Minuten). Unter

WebLogic muss der Wert für das ransaktionszeitlimit höher als der an der Auftragsquelle mit der

WebLogic Server-Verwaltungskonsole konfigurierte Wert sein. Unter WebSphere muss der Wert für das Transaktionszeitlimit höher als der maximale konfigurierte Wert sein.

➤

So legen Sie das JBoss-Transaktionszeitlimit fest:

1. Öffnen Sie die Datei „[Anwendungsserver-Stammverzeichnis]/server/all/conf/jboss.service.xml“ in einem

Texteditor.

2. Suchen Sie das Element attribute , dessen Attribut name den TransactionTimeout hat:

<attribute name="TransactionTimeout">300</attribute>

3. Ändern Sie den Wert des Elements attribute den Anforderungen entsprechend in einen höheren

Wert.

4. Speichern Sie „jboss.service.xml“.

➤

So legen Sie das Transaktionszeitlimit von WebLogic fest:

1. Melden Sie sich bei der WebLogic Server-Verwaltungskonsole an und klicken Sie unter „Domain

Structure“ auf Environment > Servers.

2. Klicken Sie im rechten Fenster auf Ihren Server und anschließend auf die Registerkarte Server Start.

3. Klicken Sie auf Lock & Edit.

4. Klicken Sie im linken Fenster auf [Domänenname] und anschließend im rechten Fenster auf die

Registerkarte JTA.

5. Geben Sie in das Feld Timeout Seconds den Wert 300 (oder höher) ein.

6. Klicken Sie auf Save und dann auf Activate Changes.

Adobe LiveCycle ES2

Fehlerbehebung in LiveCycle ES2

Fehlermeldungen

Zu wenig Arbeitsspeicher 52

➤

So legen Sie das Transaktionszeitlimit von WebSphere fest:

1. Klicken Sie in der Navigationsstruktur der WebSphere-Verwaltungskonsole auf Servers > Application

servers > [Servername].

2. Klicken Sie unter „Container Settings“ auf Container Services >Transaction Service.

3. Geben Sie unter „General Properties“ in das Feld Total transaction lifetime timeout den Wert 300

(oder höher) ein.

4. Stellen Sie in „General Properties“ sicher, dass der Wert für Maximum transaction timeout größer gleich dem für die Eigenschaft Total transaction lifetime timeout angegebenen Wert ist.

5. Klicken Sie auf OK.

Ausführen des Document Management-Dienstes für Content Services ES2 auf Basishardware

Content Services ES2 bietet verschiedene speicherinterne Caches, die die Leistung wesentlich verbessern, aber auch immens viel Java-Heap-Speicher belegen. Es treten ggf. OutOfMemory-Ausnahmefehler auf, wenn Sie den Document Management-Dienst für Content Services ES2 auf Hardware ausführen, die nur die Mindestanforderungen an die Hardware erfüllt.

Sie können die Speicherbelegung steuern, indem Sie die JVM-Argumente

-Dhibernate.cache.use_second_level_cache=false und

-Dhibernate.cache.use_query_cache=false festlegen.

➤

So steuern Sie die Content Services ES2-Speicherbelegung unter JBoss Application Server:

1. Öffnen Sie die folgende Datei in einem Texteditor:

●

●

(Windows) [Anwendungsserver-Stammverzeichnis]/bin/run.bat

(UNIX) [Anwendungsserver-Stammverzeichnis]/bin/run.sh

2. Fügen Sie in der Zeile JAVA_OPTS folgende Argumente hinzu oder ändern Sie sie:

●

●

-Dhibernate.cache.use_second_level_cache=false

-Dhibernate.cache.use_query_cache=false

3. Speichern Sie die bearbeitete Datei.

➤

So steuern Sie die Content Services ES2-Speicherbelegung unter WebLogic Server:

1. Klicken Sie in der WebLogic Server-Verwaltungskonsole unter „Domain Structure“ auf Environment >

Servers und klicken Sie dann im rechten Bereich auf den Namen des LiveCycle ES2-Servers.

2. Klicken Sie auf die Registerkarte Configuration > Server Start.

3. Klicken Sie unter „Change Center“ auf Lock & Edit.

4. Fügen Sie im Feld „Arguments“ die folgenden JVM-Argumente hinzu oder ändern Sie es:

●

●

-Dhibernate.cache.use_second_level_cache=false

-Dhibernate.cache.use_query_cache=false

5. Klicken Sie auf Save und dann auf Activate Changes.

Adobe LiveCycle ES2

Fehlerbehebung in LiveCycle ES2

Fehlermeldungen

404 Datei nicht gefunden 53

➤

So steuern Sie die Content Services ES2-Speicherbelegung unter WebSphere Application Server:

1. Melden Sie sich bei der WebSphere-Verwaltungskonsole an, klicken Sie in der Navigationsstruktur auf

Servers > Application servers und klicken Sie anschließend im rechten Bereich auf den Servernamen.

2. Klicken Sie unter „Server Infrastructure“ auf Java and Process Management > Process Definition.

3. Klicken Sie unter „Additional Properties“ auf Java Virtual Machine und fügen Sie im Feld Generic JVM arguments die folgenden JVM-Argumente hinzu oder ändern Sie sie:

●

●

-Dhibernate.cache.use_second_level_cache=false

-Dhibernate.cache.use_query_cache=false

4. Klicken Sie auf Apply und dann auf Save directly to Master Configuration.

404 Datei nicht gefunden

Überprüfen Sie bei Anzeige des Fehlers 404 Datei nicht gefunden Folgendes:

●

Untersuchen Sie das Problem im Zugriffsprotokoll des Browsers.

●

●

Prüfen Sie, ob die EAR-Datei ordnungsgemäß bereitgestellt und die Anwendung initialisiert wurde.

Wenn die URL für den HTTP-Server vorgesehen ist, prüfen Sie, ob die Datei vorhanden ist. Suchen Sie in der Datei „error_log“ oder „error.log“ den vollständigen Dateinamen, den der Webserver sucht.

●

●

●

(JBoss) Vergewissern Sie sich, dass die URL die ordnungsgemäßen Schreibweise verwendet, da Groß- und Kleinschreibung unterschieden werden.

(JBoss) Stellen Sie sicher, dass der Kontextstamm der Webanwendung (erster Teil der URL) in der Datei

„uriworkermap.properties“ der JK-Plug-In-Konfiguration vorhanden ist.

(JBoss) Stellen Sie sicher, wenn es sich um JSP handelt, dass die Datei in der EAR-Datei vorhanden ist.

Diese Option wird durch Fehlen eines Eintrags in der Fehlerprotokolldatei des HTTP-Servers bestätigt.

Klasse nicht gefunden

Wenn die Fehlermeldung Klasse nicht gefunden angezeigt wird, prüfen Sie, ob eines dieser

Probleme vorliegt:

●

●

●

Die Klassenpfadeinstellung ist ungültig oder nicht vorhanden.

Die JAR-Datei ist veraltet.

In der Klasse liegt ein Kompilierungsproblem vor.

JNDI-Name nicht gefunden

Wenn das Symptom eine Ausnahmestapelverfolgung mit javax.naming.NameNotFoundException: jdbc/<badName> - Prüfen Sie, ob der erwartete Name ordnungsgemäß geschrieben ist. Falls nicht, müssen Sie den Code korrigieren.

➤

So beseitigen Sie die gängigsten JNDI-Ausnahmen:

1. Überprüfen Sie die JNDI-Struktur auf dem LiveCycle ES2-Anwendungsserver. Wird der verwendete

Name in der Struktur angezeigt?

●

Falls ja, ist es sehr wahrscheinlich, dass in Ihrem Code das Objekt InitialContext nicht ordnungsgemäß eingerichtet wurde, das für die Suche verwendet wird, und die Suche in einer

Adobe LiveCycle ES2

Fehlerbehebung in LiveCycle ES2

Fehlermeldungen

JBoss Application Server-Fehlermeldungen 54

●

JNDI-Struktur erfolgt, die nicht diejenige ist, in der die Ressource aufgelistet ist. Überprüfen Sie im

Dokument Installieren und Bereitstellen von LiveCycle ES2 für Ihren Anwendungsserver die zu verwendenden Eigenschaftswerte.

Falls nein, fahren Sie mit Schritt 2 fort.

2. Wird die Ressource in der JNDI-Struktur unter einem anderen Namen als dem in der Suche angegebenen Namen aufgeführt?

●

●

Falls ja, verwenden Sie den falschen Suchnamen. Geben Sie den ordnungsgemäßen Namen an.

Falls nein, fahren Sie mit Schritt 3 fort.

3. Überprüfen Sie beim Systemstart die Protokolle des Anwendungsservers. Wenn der

Anwendungsserver so konfiguriert wurde, dass diese Ressource verfügbar sein soll, aber ein Fehler auftritt, wird an dieser Stelle eine Ausnahme angezeigt. Wie lautet die Ausnahme?

●

●

Falls ja, überprüfen Sie die Ausnahme und die Stapelablaufverfolgung. Wenn eine Ausnahme vom

Typ NameNotFoundException (Name nicht gefunden) im Rahmen Ihrer Untersuchung der

Serverprotokolle ein Symptom eines anderen Problems ist, wechseln Sie zu den

Fehlerbehebungsschritten für dieses Problem .

Falls nein, fahren Sie mit Schritt 4 fort.

4. Wenn die Ressource nicht in der JNDI-Struktur aufgeführt ist und beim Start keine Ausnahme angezeigt wird, die erklärt, warum diese nicht zur Verfügung steht, ist der wahrscheinlichste Grund, dass der Anwendungsserver nicht ordnungsgemäß für die Bereitstellung dieser Ressource konfiguriert wurde. Prüfen Sie die Konfiguration des Anwendungsservers. Wurde er für die Bereitstellung dieser

Ressource konfiguriert?

●

●

Falls nein, Siehe Installieren und Bereitstellen vonLiveCycle ES2 für Ihren Anwendungsserver.

Falls ja, handelt es sich nicht um eines der gängigen Probleme, die als Ursache dieses Fehlers gelten.

Wenden Sie sich an den Adobe Enterprise-Support.

JBoss Application Server-Fehlermeldungen

Objektfehler „org.jboss.logging.appender.FileAppender“

(Bekanntes Problem) Wenn in Ihrer LiveCycle ES2 für JBoss-Installation ECM Connector für EMC

Documentum enthalten ist, wird die folgende Fehlermeldung in den Serverprotokollen bei jedem

Neustart des Servers angezeigt:

An org.jboss.logging.appender.FileAppender object is not assignable to an org.apache.log4j.Appender variable

IBM FileNet-Meldungen werden in der Protokolldatei von JBoss Application

Server angezeigt

Um zu verhindern, dass unnötige FEHLER- und WARNUNG-Protokollmeldungen von IBM FileNet erzeugt und in der Protokolldatei von JBoss Application Server angezeigt werden, nehmen Sie folgende Änderung an der Datei log4j.xml vor, die sich im Verzeichnis [JBoss-Stammverzeichnis]/server/all/conf befindet.

1. Suchen Sie die Datei log4j.xml und öffnen Sie sie in einem Editor.

Adobe LiveCycle ES2

Fehlerbehebung in LiveCycle ES2

Fehlermeldungen

WebLogic Server-Fehlermeldungen 55

2. Fugen Sie im Abschnitt [Category] den folgenden Text hinzu:

<category name="com.filenet">

<priority value="FATAL"/>

</category>

3. Speichern und schließen Sie die Datei.

4. Starten Sie den Anwendungsserver neu.

WebLogic Server-Fehlermeldungen

WebLogic-JTA-Zeitlimitfehler

Wenn folgende Fehlermeldung ausgegeben wird, liegt ein WebLogic-Zeitlimitfehler vor:

<Warning> <com.adobe.workflow.AWS> <ap-sun4> <Server_127> <[ACTIVE]

ExecuteThread: '17' for queue: 'weblogic.kernel.Default (self-tuning)'>

<<anonymous>> <BEA1-58E59A31956BB0D8F0AB> <> <1178316054656> <000000>

<javax.ejb.TransactionRolledbackLocalException: EJB Exception: ; nested exception is: javax.ejb.TransactionRolledbackLocalException: EJB Exception: ; nested exception is: weblogic.transaction.internal.TimedOutException:

Transaction timed out after 299 seconds

Um diesen Fehler zu beheben, erhöhen Sie den WebLogic-JTA-Zeitlimitwert auf größer als 300 Sekunden.

(Siehe „Konfigurieren des Transaktionszeitlimits von WebLogic“ in Vorbereiten der Installation von

LiveCycle ES2 .

Fehler beim Bereitstellen von „adobe-livecycle-weblogic.ear“

Wenn folgende Fehlermeldung ausgegeben wird, liegt ein WebLogic-EAR-Bereitstellungsfehler vor:

Could not start application adobe-livecycle-weblogic.

com.adobe.livecycle.cdv.CDVException[ALC-LCM-030-113]: Failed to deploy

EAR.

Zur Behebung dieses Problems stellen Sie sicher, dass WebLogic Server-Verwaltungskonsole nicht gesperrt ist (d. h. Sie prüfen, ob die Schaltfläche „Lock & Edit“ ausgewählt ist). Ist sie gesperrt, zeigt

LiveCycle Configuration Manager an, dass der Bereitstellungsprozess zu 16 % abgeschlossen ist, und in der

WebLogic Server-Verwaltungskonsole wird die EAR-Datei als bereitgestellt, jedoch mit einem installierten

Status angezeigt. Wenn die WebLogic Server-Verwaltungskonsole nicht gesperrt ist, kann LiveCycle

Configuration Manager die EAR-Dateien bereitstellen.

Um dieses Problem zu beheben, stellen Sie sicher, dass die WebLogic Server-Verwaltungskonsole nicht gesperrt ist, und stellen Sie die EAR-Dateien erneut bereit.

Bereitstellungsfehler aufgrund von PermGen-Speicherplatzproblem

Wenn folgende Fehlermeldung ausgegeben wird, liegt ein WebLogic-EAR-Bereitstellungsfehler vor: java.lang.OutOfMemoryError: PermGen space

Um diesen Fehler zu beheben, erhöhen Sie den PermGen-Speicherplatz von 256 auf 512.

Sie können diesen Wert über die WebLogic Server-Verwaltungskonsole ändern.

Adobe LiveCycle ES2

Fehlerbehebung in LiveCycle ES2

Fehlermeldungen

WebSphere Application Server-Fehlermeldungen 56

Fehler beim Bereitstellen der LiveCycle ES2-Module unter

WebLogic/Windows

Es besteht das bekannte Problem, dass bei der Ausführung von WebLogic Server unter Windows

LiveCycle ES2-Module nicht bereitgestellt werden, da die Zeitlimiteinstellung von 5 Sekunden zu kurz ist.

Sie müssen diese Einstellungen folgendermaßen manuell konfigurieren:

●

●

Wechseln Sie zu [Anwendungsserver-Domäne] und öffnen Sie die Datei „startWeblogic.cmd“ in einem

Editor.

Suchen Sie den Eintrag [ADOBE_JAVA_HOME] und fügen Sie den folgenden Parameter hinzu:

-Dweblogic.client.socket.ConnectTimeout = <Zeitlimitwert>

Hinweis: Wenn kein verwalteter Server konfiguriert ist, wird die Verwendung eines

Administrationsservers von LiveCycle Configuration Manager nicht unterstützt.

WebSphere Application Server-Fehlermeldungen

Fehler beim Bereitstellen der Datei „adobe-livecycle-websphere.ear“

In diesem Abschnitt wird erklärt, wie Sie eine fehlgeschlagene Bereitstellung korrigieren, wenn beim

Versuch der Bereitstellung der Datei „adobe-livecycle-websphere.ear“ die folgende Fehlermeldung angezeigt wird:

Could not deploy adobe-livecycle-websphere.ear. com.adobe.livecycle.cdv.CDVException[ALC-LCM-030-112]: Failed to deploy EAR.

Could not deploy adobe-livecycle-websphere.ear.

➤

So korrigieren Sie eine fehlerhafte WebSphere-Bereitstellung:

1. Führen Sie im Befehlsfenster den Befehl limit -n aus.

2. Wenn der Wert 1024 zurückgegeben wird, erhöhen Sie den Wert im Skript wasadmin.sh auf 2048 .

3. Öffnen Sie das Skript „[Anwendungsserver-Stammverzeichnis]/bin/wsadmin.sh“ in einem Texteditor.

Fügen Sie in der Datei hinter der Kopfzeile mit dem Kommentarblock die Zeile ulimit -n 2048 hinzu.

4. Starten Sie WebSphere neu und stellen Sie die Datei „adobe-livecycle-websphere.ear“ mithilfe von

LiveCycle Configuration Manager bereit.

J2CA0294W-Warnmeldungen

Sie können die WebSphere-Protokollierungsstufe ändern, um Warnmeldungen in der Datei

„SystemOut.log“ zu vermeiden, die mit der abgelehnten Verwendung des direkten JNDI-Lookups zusammenhängen.

Um die Warnmeldung J2CA0294W in „SystemOut.log“ zu unterdrücken, ändern Sie die

Protokollierungsstufe in *=info:com.ibm.ejs.j2c.ConnectionFactoryBuilderImpl=severe .

➤

So ändern Sie die Protokollierungsstufen:

1. Melden Sie sich über die URL http://[Hostname]:9060/admin bei der WebSphere-Verwaltungskonsole an und klicken Sie in der Navigationsstruktur auf Troubleshooting > Logs and Trace.

Adobe LiveCycle ES2

Fehlerbehebung in LiveCycle ES2

Fehlermeldungen

WebSphere Application Server-Fehlermeldungen 57

2. Klicken Sie im rechten Fenster auf den Namen des Anwendungsservers und anschließend auf Change

Log Detail Levels.

3. Geben Sie auf der Registerkarte „Configuration“ die folgende Zeichenfolge ein:

*=info:com.ibm.ejs.j2c.ConnectionFactoryBuilderImpl=severe

4. Klicken Sie auf OK und dann auf Save directly to Master Configuration.

Ausführliche Protokollnachrichten bei der Installation von WebSphere

Wenn Sie vermeiden möchten, dass bei der WebSphere-Installation mehrere unnötige

Protokollnachrichten aufgenommen werden, können Sie die Protokollierungsstufe auf „Warnung“ erhöhen, damit Meldungen mit niedrigerer Stufe nicht protokolliert werden.

➤

So ändern Sie die Protokollierungsstufen:

1. Melden Sie sich über die URL http://[Hostname]:9060/admin bei der WebSphere-Verwaltungskonsole an.

2. Klicken Sie in der Navigationsstruktur auf Troubleshooting und klicken Sie anschließend auf Logs and

Trace.

3. Klicken Sie im rechten Fenster auf den Namen des Anwendungsservers und anschließend auf Change

Log Detail Levels.

4. Wählen Sie Runtime und geben Sie org.apache.xml.security.* ein.

5. Klicken Sie auf Message And Trace Levels und anschließend auf Warning.

6. Aktivieren Sie das Kontrollkästchen Save runtime changes to configuration.

7. Klicken Sie auf OK.

Die Datei „adobe-livecycle-websphere.ear“ wird nicht auf der 64-Bit-Version von WebSphere 6.1 bereitgestellt.

Beim Bereitstellen der Datei „adobe-livecycle-websphere.ear“ (manuell oder mithilfe von LiveCycle

Configuration Manager) auf einer 64-Bit-Version eines WebSphere-Anwendungsservers wird eventuell die folgende Fehlermeldung angezeigt:

Error executing deployment: java.lang.IllegalStateException. Error is Unable to acquire application service. Ensure that the org.eclipse.core.runtime bundle is resolved and started (see config.ini)..

java.lang.IllegalStateException: Unable to acquire application service. Ensure that the org.eclipse.core.runtime bundle is resolved and started (see config.ini).

at org.eclipse.core.runtime.internal.adaptor.EclipseAppLauncher.start(EclipseAp pLauncher.java:65)

Tritt dieser Fehler in der WebSphere-Verwaltungskonsole auf, wird empfohlen, dass Sie Ihren

Anwendungsserver auf WebSphere 6.1 Fixpack 15 und SR6 aktualisieren.

Adobe LiveCycle ES2

Fehlerbehebung in LiveCycle ES2

Fehlermeldungen

WebSphere Application Server-Fehlermeldungen 58

Unnötige Meldung „SystemOut“ bei der Bereitstellung von LiveCycle ES2 unter WebSphere 6.1

Es ist ein bekanntes Problem, dass beim Bereitstellen der LiveCycle ES2-Module auf dem WebSphere

Application Server unnötige SystemOut-Meldungen wie etwa die folgende in die Protokolldatei

„system.out“ geschrieben werden:

[2/26/08 19:16:34:303 CST] 00000022 SystemOut

Oflex.management.runtime.messaging.services.remoting.RemotingDestinationCont

rol

[2/26/08 19:16:34:304 CST] 00000022 SystemOut O 9

[2/26/08 19:16:34:305 CST] 00000022 SystemOut O flex.management.runtime.messaging.services.remoting.RemotingDestinationContr

ol

IBM stellt in seiner Liste Available Fixes einen Patch bereit, um dieses Problem zu beheben.

Ausnahme: No trusted certificate found

Ihr WebSphere Application Server meldet möglicherweise Ausnahmen, die den nachfolgend beschriebenen Ausnahmemeldungen ähneln.

An der LiveCycle Administration Console angezeigte Ausnahmen:

Could not connect to Inbox. Error message: com.ibm.jsse2.util.h:

No trusted certificate found; nested exception is: javax.net.ssl.SSLHandshakeException: com.ibm.jsse2.util.h: No trusted certificate found

In WebSphere Application Server-Protokolldateien angezeigte Ausnahmen:

[5/28/08 13:15:30:283 CDT] 00000025 SystemOut O

CWPKI0022E: SSL HANDSHAKE FAILURE: A signer with SubjectDN

"CN=imap.gmail.com, O=Google Inc, L=Mountain View, ST=California, C=US" was sent from target host:port "null:null". The signer may need to be added to local trust store "D:/servers/websphere6.1/profiles/AppSrv01

/config/cells/MN-TOBIKONode01Cell/nodes/MN-TOBIKONode01/trust.p12" located in SSL configuration alias "NodeDefaultSSLSettings" loaded from

SSL configuration file "security.xml". The extended error message from the SSL handshake exception is: "No trusted certificate found".

[5/28/08 13:15:30:283 CDT] 00000025 SystemOut O

[5/28/08 13:15:30:283 CDT] 00000025 ExceptionUtil E

CNTR0020E: EJB threw an unexpected (non-declared) exception during invocation of method "doSupports" on bean "BeanId(adobe-core-websphere

#adobe-dscf.jar#EjbTransactionCMTAdapter, null)". Exception data: java.lang.RuntimeException: Could not connect to Inbox. Error message: com.ibm.jsse2.util.h: No trusted certificate found; nested exception is: javax.net.ssl.SSLHandshakeException: com.ibm.jsse2.util.h: No trusted certificate found

Dieses Problem tritt auf, wenn der WebSphere-Keystore ein erforderliches Zertifikat nicht enthält.

Hierbei ist zu beachten, dass der standardmäßige WebSphere-Keystore nur eine begrenzte Anzahl von Zertifikaten enthält. Führen Sie die folgenden Schritte aus, um ein neues Zertifikat zum

WebSphere-Keystore hinzuzufügen.

Adobe LiveCycle ES2

Fehlerbehebung in LiveCycle ES2

Fehlermeldungen

WebSphere Application Server-Fehlermeldungen 59

➤

So fügen Sie ein neues Zertifikat zum WebSphere-Keystore hinzu:

1. Ermitteln Sie das entsprechende Zertifikat im E-Mail-Dienst.

2. Kopieren Sie das Zertifikat nach [Anwendungsserver-Stammverzeichnis]\profiles\[Servername]\etc. . .

3. Melden Sie sich bei der WebSphere-Verwaltungskonsole an und klicken Sie auf Security > SSL

certificate and key management.

4. Klicken Sie unter „Related Items“ auf Key stores and certificates und anschließend auf

CellDefaultTrustStore.

5. Unter „Additional Properties“ klicken Sie auf Signer certificates und anschließend auf Add.

6. Geben Sie in das Feld Alias einen geeigneten Alias für das Zertifikat ein, das Sie importieren.

7. Geben Sie in das Feld File name den Speicherort ein, an dem Sie das Zertifikat in Schritt 2 installiert

haben, und klicken Sie anschließend auf OK.

8. Klicken Sie auf Save directly to the master configuration. Das Zertifikat, das gerade hinzugefügt wurde, sollte nun als Unterzeichner-Zertifikat aufgelistet werden.

9. Starten Sie WebSphere Application Server neu.

Die Ausnahme „Java NameNotFoundException“

Beim Bootstrapping von User Manager-Komponenten für WebSphere Application Server wird nach dem

Start der Anwendung die folgende Ausnahmefehlermeldung nur einmal angezeigt:

00000043 javaURLContex E NMSV0310E: A JNDI operation on a "java:" name cannot be completed because the server runtime is not able to associate the operation's thread with any J2EE application component. This condition can occur when the JNDI client using the "java:" name is not executed on the thread of a server application request. Make sure that a J2EE application does not execute JNDI operations on "java:" names within static code blocks or in threads created by that J2EE application. Such code does not necessarily run on the thread of a server application request and therefore is not supported by

JNDI operations on "java:" names Exception stack trace: javax.naming.ConfigurationException [Root exception is javax.naming.NameNotFoundException: Name comp/env/ejb not found in context

"java:".]

Sie können diesen Fehler einfach ignorieren.

Unerwartete Ausnahme während DSC-Aufruf

Wenn ein DSC aus einer Transaktion heraus aufgerufen wird, die von einer anderen Anwendung gestartet wurde und auf derselben Instanz von WebSphere 7.x bereitgestellt wurde wie LiveCycle ES2, schlägt der

DSC-Aufruf mit der folgenden Fehlermeldung fehl:

LocalException E CNTR0020E: EJB threw an unexpected (non-declared) exception during invocation of method "getObjectType" on bean

"BeanId(LiveCycleES2#adobe-pof.jar#adobe_POFDataDictionaryLocalEJB, null)".

Exception data: com.ibm.websphere.csi.CSIException: Global tx resume failed;

Adobe LiveCycle ES2

Fehlerbehebung in LiveCycle ES2

Fehlermeldungen

Datenbankfehlermeldungen 60

Dieser Fehler tritt unter WebSphere 7.x nur dann auf, wenn die Datei adobe-utilities.jar

verwendet wird und es sich bei Platform.UTIL.getTransactionManager() um den Benutzer handelt, der den Transaktionsmanager startet.

Dieses Problem lässt sich beheben, wenn Sie die Datei adobe-utilities.jar

nicht zum Starten des

Transaktionsmanagers verwenden. Verwenden Sie stattdessen den folgenden Code zum Erstellen von

UserTransaction:

InitialContext initialContext = new InitialContext();

UserTransaction ut =

(UserTransaction)initialContext.lookup("java:comp/UserTransaction"); ut.begin();

Datenbankfehlermeldungen

In diesem Abschnitt werden Fehlermeldungen beschrieben, die sich auf Ihre LiveCycle ES2-Datenbank beziehen.

Ausnahmen beim mehrfachen Initialisieren der Datenbank

Wenn Sie die LiveCycle ES2-Datenbank initialisieren, nachdem sie bereits initialisiert wurde, werden eventuell Ausnahmen ausgegeben, die darauf hinweisen, dass das POF-Schema bereits initialisiert wurde.

Sie können diesen Fehler einfach ignorieren.

MySQL-Fehler „Too many connections“

Bei hohen Lasten erzeugt MySQL eventuell Fehler vom Typ „Too many connections“. Dieses Problem kann durch Erhöhen der Anzahl der in MySQL zulässigen parallelen Verbindungen behoben werden.

1. Wechseln Sie ins Installationsverzeichnis von MySQL.

2. Suchen Sie die Datei „my.ini“ und öffnen Sie sie in einem Editor.

3. Ändern Sie den Parameter max_connections und legen Sie ihn auf den erforderlichen Wert fest. Der

Standardwert ist 100 .

4. Starten Sie MySQL neu.

J2CA0081E: Method cleanup error on SQL Server

Wenn der Fehler „J2CA0081E: Method cleanup failed while trying to execute method cleanup...“ angezeigt wird, sieht die Stapelablaufverfolgung wie folgt aus:

"00000057 MCWrapper E J2CA0081E: Method cleanup failed while trying to execute method cleanup on ManagedConnection WSRdbManagedConnectionImpl@6d826d82 from resource SP_DS. Caught exception: com.ibm.ws.exception.WsException:

DSRA0080E: An exception was received by the Data Store Adapter. See original exception message: This operation is not supported.. with SQL State : null SQL

Code : 0"

Sie müssen auf SQL Server 2005, JDBC-Treiberversion 1.2, aktualisieren. Laden Sie diesen Treiber vom

Microsoft Download Center herunter.

Adobe LiveCycle ES2

Fehlerbehebung in LiveCycle ES2

Fehlermeldungen

Fehler bei der Datenbankinitialisierung auf WebLogic 61

Fehler bei der Datenbankinitialisierung auf WebLogic

Folgende Ausnahme kann beim Initialisieren der LiveCycle ES2-Datenbank auf WebLogic Server auftreten:

Servlet failed with Exception java.lang.ClassCastException: weblogic.jndi.factories.java.ReadOnlyContextWrapper at com.adobe.livecycle.bootstrap.framework.BootstrapServlet.checkDatasource(Boo tstrapServlet.java:216)

Ändern Sie zur Behebung dieses Problems die Datei „IDP_DS-3079-jdbc.xml“.

➤

So ändern Sie die Datei „IDP_DS-3079-jdbc.xml“:

1. Suchen Sie die Datei IDP_DS-3079-jdbc.xml im Verzeichnis [Anwendungsserver-Domäne]/config/jdbc und öffnen Sie sie in einem Editor.

2. Suchen Sie die Zeile <jndi-name></jndi-name> und löschen Sie sie.

3. Speichern und schließen Sie die Datei und initialisieren Sie die Datenbank neu.

Speicherprobleme unter DB2-Server

Auf der DB2-Konfigurationsseite wird die folgende Fehlermeldung angezeigt:

SQL1585N Es ist kein temporärer Systemtabellenbereich mit einer ausreichenden

Seitengröße vorhanden.

Es folgen die Werte für SQLCODE und SQLSTATE für das Speicherproblem auf dem

DB2-Server. sqlcode: -1584 sqlstate: 57055

SQL1585N Es ist kein temporärer Systemtabellenbereich mit einer ausreichenden

Seitengröße vorhanden.

Weitere Informationen zu diesem Fehler finden Sie in der IBM Knowledge Base unter http://publib.boulder.ibm.com/infocenter/db2luw/v9r5/index.jsp?topic=/com.ibm.db2.luw.messages.sql.

doc/doc/msql01585n.html.

Gehen Sie zur Vermeidung dieses Problems wie folgt vor:

●

Erhöhen Sie den Systemarbeitsspeicher. Weitere Informationen dazu finden Sie im Handbuch

„Vorbereiten der Installation“.

●

Stellen Sie für jede DB2-Instanz mindestens 2 GB Speicherplatz zur Verfügung. Wenn Sie LiveCycle

Content Services ES2 zur Verwendung mit einer DB2-Datenbank installieren, muss der Hostcomputer für die LiveCycle ES2-Datenbank über mindestens 2 GB Arbeitsspeicher (RAM) verfügen.

Adobe LiveCycle ES2

Fehlerbehebung in LiveCycle ES2

Fehlermeldungen

LiveCycle ES2-Fehlermeldungen 62

LiveCycle ES2-Fehlermeldungen

In diesem Abschnitt werden Fehlermeldungen beschrieben, die sich auf Ihre LiveCycle ES2-Installation beziehen.

Ausgabefehlermeldungen

Konvertierung nativer Dateien schlägt fehl unter JBoss/Windows

Beim Konvertieren nativer Dateien, z. B. Microsoft Word in PDF, schlägt PDF Generator ES2 bzw.

PDF Generator 3D ES2 bei der Ausführung auf einem Windows-Betriebssystem eventuell fehl, wobei eine der folgenden ähnliche Ausnahme in die Protokolldatei eingetragen wird:

INFO [PDF Generator] Application server started as user: SYSTEM

Dieses Problem tritt auf, wenn Sie nicht dasselbe Benutzerkonto für Microsoft Office, PDF Generator ES2,

Acrobat für PDF Generator ES2 und Ihren Anwendungsserverprozess verwendet haben.

Um dieses Problem zu beheben, ändern Sie den Benutzer für den Dienst „JBoss for Adobe LiveCycle“ in den Benutzer für Microsoft Office.

➤

So ändern Sie den Benutzer für den Dienst „JBoss for Adobe LiveCycle“:

1. Wählen Sie Start > Systemsteuerung > Verwaltung > Computerverwaltung > Dienste und

Anwendungen > Dienste aus.

2. Doppelklicken Sie auf den Dienst JBoss for Adobe LiveCycle und wählen Sie die Registerkarte

Anmelden aus.

3. Wählen Sie Dieses Konto aus, geben Sie den Benutzernamen und das Kennwort für den Microsoft

Office-Benutzer ein und klicken Sie auf OK.

Konvertierung nativer Dateien schlägt fehl unter JBoss/Solaris

Beim Konvertieren von HTML-Dateien mit den Operationen HTMLToPDF bzw. HTMLURLToPDF schlägt

PDF Generator ES2 bei der Ausführung auf einem Solaris-Betriebssystem unter JBoss eventuell fehl, wobei eine der folgenden ähnliche Ausnahme in die Protokolldatei eingetragen wird: com.adobe.livecycle.generatepdf.client.ConversionException:

ALC-PDG-052-016-The conversion has timed out.

at com.adobe.pdfg.GeneratePDFImpl.htmlURLToPdf

Dieses Problem tritt auf, wenn auf Ihrem System die Bibliothek „libiconv.so.2“ fehlt.

Sie beheben dieses Problem, indem Sie die Bibliothek „libiconv.so.2“ im Verzeichnis „/usr/lib“ installieren.

XMLForm.exe-Berechtigungsfehler unter UNIX oder Linux

In Forms ES2 tritt ein UNIX/Linux-Berechtigungsproblem auf, wenn die folgende Fehlermeldung protokolliert wurde:

Cannot add execute permission on file /[Pfad zu XMLForm.exe]

Adobe LiveCycle ES2

Fehlerbehebung in LiveCycle ES2

Fehlermeldungen

Unerwarteter Dateiendefehler unter WebLogic 63

Um diesen Fehler zu beheben, stellen Sie sicher, dass der Auslagerungsspeicher auf Servern mit UNIX und

Linux mindestens 3 GB groß ist.

Unerwarteter Dateiendefehler unter WebLogic

Wenn die folgende Fehlermeldung angezeigt wird, liegt ein Problem mit LiveCycle-Forms ES2 und

LiveCycle-Output ES2 vor: com.adobe.idp.DocumentError: java.net.SocketException: Unerwartetes Ende der Datei auf dem Server unter com.adobe.idp.Document.passivateInitData(Document.java:867)

Um diesen Fehler zu beheben, stellen Sie sicher, dass der Parameter des Dokuments MaxInlineSize auf einen Wert festgelegt ist, der kleiner ist als der auf dem WebLogic Server definierte IIOP-Parameter für die

Meldungsgröße.

Clientseitige Fehlermeldungen

CORBA COMM_FAILURE-Ausnahmefehler unter WebLogic/Solaris

Wenn während der Ausführung des WebLogic-Servers unter Solaris von dem Client eine CORBA

COMM_FAILURE-Ausnahme ausgegeben wird, muss die folgende zusätzliche Eigenschaft an die clientseitige JVM übergeben werden:

-Dcom.sun.CORBA.transport.ORBTCPReadTimeouts=1:60000:300:1

Der fett dargestellte Wert ist eine durch Doppelpunkt getrennte Liste der Zeitlimitwerte, die entsprechend

Ihren Systemanforderungen festgelegt werden sollten. Folgende Werte werden von links nach rechts angezeigt:

●

●

●

Anfangswartezeit, wenn ein Transport-TCP 0 Byte zurückgibt

Maximale Gesamtwartezeit, wenn ein Transport-TCP 0 Byte zurückgibt

Maximale Gesamtwartezeit, wenn ein Transport-TCP einer GIOP-Kopfzeile 0 Byte zurückgibt

● Zeitabstand in Prozent, der für die Berechnung der Zeit verwendet wird, die gewartet wird, bis ein weiteres Transport-TCP 0 Byte zurückgibt

Auf der Serverseite sind keine Einstellungen erforderlich.

Verschiedene Fehlermeldungen

Locator wird bereits ausgeführt

Wenn Sie zum Zwischenspeichern TCP verwenden, erhalten Sie beim Start des TCP-Locators eventuell folgende Ausnahme:

Exception in thread "main" com.gemstone.gemfire.SystemIsRunningException:

Locator "/usr/prod/lbs/domains/lbsdomain/idplib/caching" is already running.

at com.gemstone.gemfire.internal.ManagerInfo.setManagerStarting

(ManagerInfo.java:65)

Adobe LiveCycle ES2

Fehlerbehebung in LiveCycle ES2

Fehlermeldungen com.adobe.idp.DocumentError 64 at com.gemstone.gemfire.internal.ManagerInfo.setLocatorStarting

(ManagerInfo.java:61) at com.gemstone.gemfire.internal.DistributionLocator.main

(DistributionLocator.java:87) at com.gemstone.gemfire.distributed.Locator.main(Locator.java:359)

[info 2009/08/26 16:18:29.770 PDT <Thread-0> nid=0x15d56d5] Locator stopped

Dieses Problem lösen Sie, indem Sie nach der Sperrdatei .locator

im Ordner caching suchen und diese löschen.

com.adobe.idp.DocumentError

Wenn einige Clusterknoten nicht auf den globalen Dokumentenspeicher (GDS) zugreifen können, erhalten Sie eventuell folgende Fehlermeldung: com.adobe.idp.DocumentError: The document pointing to the file

"B:\lc9_share\docm1245494450089\c5c0f6c0a324c0d45396deb69b6e11db" has expired. Consider increasing the document disposal timeout

Vergewissern Sie sich, dass

● alle Knoten im Cluster zeitlich synchronisiert sind.

● alle Knoten Zugriff auf den globalen Dokumentenspeicher haben.

Wenn dieses Problem weiterhin auftritt, überprüfen Sie Ihr Netzwerk und die Wartezeiten.

IDPSchedulerService befindet sich nicht im Status „Wird ausgeführt“

IDPSchedulerService wird nicht neu gestartet, obwohl Workbench ES2 das Gegenteil anzeigt.

Folgende Ausnahme wird in den Serverprotokollen angezeigt:

ALC-DSC-020-000: com.adobe.idp.dsc.InvalidStateException: Dienst:

IDPSchedulerService befindet sich nicht im Status „Wird ausgeführt“

Sie beheben dieses Problem, indem Sie IDPSchedulerService explizit starten, wenn Sie Scheduler von der Workbench ES2 aus neu starten müssen.