Fehlerbehebung bei Installation und Bereitstellung. Adobe LiveCycle ES2

1

Fehlerbehebung bei Installation und Bereitstellung

In diesem Kapitel werden Probleme beim Installieren und Bereitstellen von LiveCycle ES2 beschrieben und

Vorschläge zur ihrer Vermeidung bzw. Umgehung gemacht.

„Installationseinstellungen“ auf Seite 11

„Systemanforderungseinstellungen“ auf Seite 11

„Anwendungsservereinstellungen“ auf Seite 12

„Datenbankinitialisierungseinstellungen“ auf Seite 15

„Sicherheitseinstellungen“ auf Seite 15

„Upgrade-Einstellungen“ auf Seite 16

„Probleme bei Installation, Konfiguration und Bereitstellung“ auf Seite 19

„Fehlerbehebung mit Protokolldateien“ auf Seite 25

Installationseinstellungen

Wenn bei der Installation, Konfiguration und Bereitstellung von LiveCycle ES2 Probleme auftreten, vergewissern Sie sich, dass Sie die Anweisungen in den unter

„Zusätzliche Informationen“ auf Seite 9

aufgelisteten LiveCycle ES2-Dokumenten ordnungsgemäß befolgt haben.

Wenn Sie alle Installations- und Konfigurationsschritte gemäß der Dokumentation ausgeführt haben, finden Sie in den folgenden Abschnitten Probleme, die Ihren ggf. ähneln.

Siehe auch

„Probleme bei Installation, Konfiguration und Bereitstellung“ auf Seite 19

„Fehlermeldungen“ auf Seite 49

Systemanforderungseinstellungen

Speicherplatzprobleme im temporären Verzeichnis

Die Installation des LiveCycle-Installationsprogramms funktioniert nicht auf Systemen, bei denen im temporären Systemverzeichnis nicht genügend Speicherplatz vorhanden ist. In solchen Fällen erhalten

Sie im Konsolenfenster die Meldung, dass /tmp über nicht genügend Speicherplatz verfügt.

Zur Vermeidung dieses Problems müssen Sie sicherstellen, dass Ihr temporäres Verzeichnis über ausreichend Speicherplatz verfügt. Im Handbuch Vorbereiten der Installation von LiveCycle ES2 (Einzelserver) finden Sie Informationen zu den Systemanforderungen.

11

Adobe LiveCycle ES2

Fehlerbehebung in LiveCycle ES2

Fehlerbehebung bei Installation und Bereitstellung

Geringe Leistung von SharePoint Connector-APIs unter Windows Server 2008 12

Geringe Leistung von SharePoint Connector-APIs unter Windows Server 2008

Wenn LiveCycle ES2 unter Windows Server 2008 bereitgestellt wird und der SharePoint Server, mit dem

LiveCycle ES2 kommuniziert, auf einem 64-Bit-Windows-Rechner gehostet wird, werden SharePoint

Content Repository Connector-API-Aufrufe über Workbench ES2 oder LiveCycle ES2-SDK nur langsam verarbeitet.

Deaktivieren Sie auf dem LiveCycle ES2-Server die automatische Abstimmung des TCP-Empfangsfensters oder setzen Sie die Option auf highlyrestricted , um das Problem zu vermeiden.

Verwenden Sie einen der folgenden Befehle: netsh interface tcp set global autotuninglevel=disabled netsh interface tcp set global autotuninglevel=highlyrestricted

Weitere Informationen finden Sie in der Microsoft Knowledge Base.

Dateigrößenbeschränkungen für den LiveCycle ES2-Output-Dienst

Um mit dem LiveCycle ES2-Output-Dienst auf UNIX-Systemen größere Dateien erzeugen zu können, müssen Sie die Obergrenze der Dateigröße auf einen Wert festlegen, der mindestens so groß ist wie die zu erzeugende Datei.

Um Fehler beim Erzeugen von PDF-Dokumenten aus großen Dateien zu vermeiden, müssen Sie den Wert für fsize in /etc/security/limits auf UNIX-Systemen auf einen Wert ändern, der groß genug ist, um alle

Dateigrößen abzudecken.

Anwendungsservereinstellungen

Überprüfen Sie die folgenden Anwendungsservereinstellungen, bevor Sie sich an den Adobe

Enterprise-Support wenden:

●

●

Total transaction lifetime timeout: 300

Ursprüngliche Heap-Größe: 256

●

●

●

Maximale Heap-Größe: 1.024 MB

Prepared Statement Cache: 100

Database Connection Pool Maximum:

●

IDP_DS ist 30.

●

●

●

●

RM_DS ist 20.

BAM-Metadaten-Datenbank ist 20.

Database Connection Pool Maximum:

●

IDP_DS ist 1.

● RM_DS ist 1.

Connection Pool Maximum Connections: 50

Siehe auch

„Fehlermeldungen“ auf Seite 49

Adobe LiveCycle ES2

Fehlerbehebung in LiveCycle ES2

Fehlerbehebung bei Installation und Bereitstellung

Konfigurieren von JBoss zur Verwendung eines nicht standardmäßigen HTTP-Anschlusses 13

Konfigurieren von JBoss zur Verwendung eines nicht standardmäßigen

HTTP-Anschlusses

JBoss Application Server verwendet 8080 als Standard-HTTP-Port. JBoss verfügt außerdem über die vorkonfigurierten Anschlüsse 8180, 8280 und 8380, die in der Datei „jboss-service.xml“ kommentiert werden. Wenn Sie auf Ihrem Computer über eine Anwendung verfügen, die bereits diesen Anschluss verwendet, ändern Sie den von LiveCycle ES2 verwendeten Anschluss, indem Sie die folgenden Schritte ausführen:

1. Öffnen Sie die Datei „jboss-service.xml“ in einem Editor.

JBoss Turnkey-Installation: [JBossES2 -Stammverzeichnis]/server/lc_turnkey/conf/

Manuelle Installation von JBoss: [Anwendungsserver -Stammverzeichnis]/server/all/conf

2. Suchen Sie das folgende mbean und heben Sie den Kommentar auf:

<mbean code="org.jboss.services.binding.ServiceBindingManager"

name="jboss.system:service=ServiceBindingManager">

<attribute name="ServerName">ports-01</attribute>

<attribute name="StoreURL">${jboss.home.url}/docs/examples/binding-manager/sample-bin dings.xml</attribute>

<attribute name="StoreFactoryClassName">

org.jboss.services.binding.XMLServicesStoreFactory

</attribute>

</mbean>

3. Speichern und schließen Sie die Datei.

4. Starten Sie JBoss neu.

JBoss ist nun für die Verwendung des Anschlusses 8180 konfiguriert. Wenn Sie den Anschluss 8280 oder

8380 verwenden möchten, ändern Sie den Attributwert ServerName , um einen der folgenden alternativen Anschlüsse zu verwenden:

Für 8280: ports-02

Für 8380: ports-03

Wenn Sie eine andere Anschlussnummer als die für JBoss vorkonfigurierte konfigurieren möchten, führen

Sie die folgenden Schritte aus:

1. Suchen und öffnen Sie die Datei „deploy/jboss-web.deployer“ im [JBossES2 Stammverzeichnis]

(Turnkey) oder [Anwendungsserver -Stammverzeichnis] (Manuelle Installation von JBoss).

2. Suchen Sie das mbean von Schritt 2 oben und heben Sie den Kommentar auf.

3. Ändern Sie den Wert ServerName in die zu verwendende Anschlussnummer.

4. Speichern und schließen Sie die Datei.

5. Starten Sie JBoss neu.

Adobe LiveCycle ES2

Fehlerbehebung in LiveCycle ES2

Fehlerbehebung bei Installation und Bereitstellung

Konfigurieren der Arbeitsspeicheranforderungen für Solaris 10 14

Konfigurieren der Arbeitsspeicheranforderungen für Solaris 10

Nehmen Sie folgende Arbeitsspeicherkonfigurationen vor, um StuckThread-Probleme in

Solaris-Umgebungen zu vermeiden:

●

Fügen Sie die in der Datei „/etc/system“ die rlim-Werte hinzu oder erhöhen Sie sie.

●

Erhöhen Sie den Auslagerungsspeicher auf mindestens das Doppelte des Gesamtarbeitsspeichers

(RAM).

➤

So ändern Sie die

rlim

-Werte:

1. Suchen und öffnen Sie die Datei „/etc/system“.

2. Gehen Sie zum Suchen und Ändern der rlim -Werte wie folgt vor: set rlim_fd_cur : Die anfängliche (weiche) maximale Anzahl von Dateideskriptoren pro Prozess.

Legen Sie für diesen Wert 8192 oder höher fest. set rlim_fd_max: Die harte Grenze der maximalen Anzahl von Dateideskriptoren pro Prozess.

Legen Sie für diesen Wert 8192 oder höher fest. (Diese Änderung ist nur erforderlich, wenn der

Standardwert niedriger als 8192 ist.) Sie müssen über Hauptbenutzerrechte verfügen, um diesen

Wert zu ändern.

Hinweis: Der rlim_fd_max -Wert muss gleich dem oder größer als der rlim_fd_cur -Wert sein.

3. Speichern und schließen Sie die Datei.

4. Starten Sie den Computer neu.

➤

So vergrößern Sie den Auslagerungsspeicher:

1. Erhöhen Sie den Auslagerungsspeicher so, dass der Grenzwert des Gesamtauslagerungsspeichers das

Doppelte des Gesamtarbeitsspeichers (RAM) übersteigt. Beispiel: Wenn Ihr Arbeitsspeicher (RAM) 8 GB groß ist, müssen Sie den Auslagerungsspeicher auf mehr als 16 GB konfigurieren. (Weitere

Informationen finden Sie im Technischen Tipp auf dem Portal der Sun-Community .)

2. Führen Sie falls erforderlich einen Neustart des Computers durch.

➤

So überprüfen Sie die aktualisierten Einstellungen:

1. Starten Sie eine neue Shell.

2. Geben Sie ulimit -n ein und drücken Sie die Eingabetaste.

3. Vergewissern Sie sich, dass der zurückgegebene Wert mit den eingestellten rlim -Werten

übereinstimmt.

4. Geben Sie swap -s ein und drücken Sie die Eingabetaste.

5. Vergewissern Sie sich, dass der zurückgegebene Wert mit dem neu eingestellten Wert für den

Auslagerungsspeicher übereinstimmt.

Falls ein Wert mit den aktualisierten Einstellungen nicht übereinstimmt, stellen Sie sicher, dass Sie die

Schritte zur Aktualisierung wie beschrieben befolgt haben, und starten Sie Ihren Computer neu.

Adobe LiveCycle ES2

Fehlerbehebung in LiveCycle ES2

Fehlerbehebung bei Installation und Bereitstellung

Datenbankinitialisierungseinstellungen 15

Datenbankinitialisierungseinstellungen

Wenn es Probleme beim Initialisieren des LiveCycle ES2-Servers gibt, prüfen Sie Folgendes:

● Die Namen von Datenbankinstanzen dürfen nur alphanumerische Zeichen enthalten.

●

(Linux und UNIX) Die Namen von Datenbankinstanzen dürfen den plattformspezifischen Grenzwert von 8 Zeichen nicht überschreiten.

Wenn die Initialisierung am Anfang des Prozesses fehlschlägt, prüfen Sie Folgendes:

● (Nicht-Turnkey-Installation) Die LiveCycle ES2-Datenbank wurde bereits erstellt und der Benutzer hat Vollzugriff darauf.

●

●

●

Mit dem PING-Befehl ist ein Zugriff auf den Datenbankserver möglich.

Die Datenbank ist leer, d. h. sie enthält keine Tabellen, Sequenzen, Sichten oder Indextabellen.

Der JNDI-Name für IDP_DS wurde erstellt.

Wenn die Initialisierung beim Schreiben in die Registrierung fehlschlägt, überprüfen Sie die

Anwendungsserverprotokolle auf Fehler zu Warteschlangen und Themen. Sind Fehler vorhanden, prüfen

Sie, ob die Warteschlangen und Themen ordnungsgemäß konfiguriert wurden. (Siehe Installieren und

Bereitstellen von LiveCycle ES2 für Ihren Anwendungsserver.)

Siehe auch

„Datenbankfehlermeldungen“ auf Seite 60

Verarbeiten vieler gleichzeitiger Aufrufe

Eine hohe Anzahl gleichzeitiger Aufrufe kann sich negativ aus die Datenbankleistung auswirken. Um einen

Leistungsabfall zu vermeiden, müssen Sie maximale Verbindungs-Poolgröße für die Datenquelle (IDP_DS) auf einen Wert erhöhen, der höher als die Anzahl gleichzeitiger Aufrufe ist.

Sicherheitseinstellungen

XMLForm.exe stürzt ab, wenn sich die SELinux-Sicherheit im „Enforcing“

Modus befindet.

Es können Probleme bei der Ausführung von LiveCycle ES2 auf einem Server auftreten, bei dem sich NSA

Security Enhanced Linux (SELinux) im Modus Enforcing befindet. Bei dieser Konfiguration wird ein

LiveCycle ES2-Prozess, durch den XMLForm.exe aufgerufen wird, nicht ausgeführt. Die Benutzer sind dann nicht in der Lage, das entsprechende Formular in LiveCycle Workspace ES2 zu öffnen, und in der

Protokolldatei Ihres Anwendungsservers wird eine Fehlermeldung wie die folgende angezeigt:

Service XMLFormService: Process ProcessResource(name=XMLForm.exe,pid=0) nicht ordnungsgemäß beendet mit Fehlercode {3}

Um dieses Problem zu beheben, ändern Sie die SELinux-Sicherheit zum Permissive-Mode.

Adobe LiveCycle ES2

Fehlerbehebung in LiveCycle ES2

Upgrade-Einstellungen

Fehlerbehebung bei Installation und Bereitstellung

Upgrade-Einstellungen 16

Problem beim Wiederherstellen von LiveCycle ES2 auf einem Computer mit einem anderen Hostnamen

Importierte LiveCycle 8.x-Prozesse können ein variables Dokumentformular und den Submit PDF

Form-Dienst verwenden. Bei derartigen Prozessen können die Benutzer unter folgenden Umständen kein

Formular zum Abschließen einer Aufgabe senden:

1. Der Prozess wird gestartet, und dann wird eine Sicherung der Datenbank und des globalen

Dokumentenspeichers durchgeführt.

2. LiveCycle ES2 wird auf einem anderen Computer mit einem anderen Hostnamen wiederhergestellt. Im

Verzeichnis des globalen Dokumentenspeichers wurde der Ordner „backup“ in „restore“ umbenannt, und die Datenbank wird wiederhergestellt.

3. Der Benutzer sendet das Formular in Workspace.

Wenn der Benutzer das Formular sendet, wird eine Sicherheitswarnung mit folgender Meldung angezeigt:

„Dieses Dokument hat auf mehr als einen Ort zugegriffen und könnte versuche, Daten auf unterschiedlichen Speicherorten freizugeben. Das könnte ein Datenschutzproblem bewirken.

Möchten Sie wirklich fortfahren?“ Wenn der Benutzer auf „Ja“ klickt, wird folgende Fehlermeldung angezeigt: „Diese Seite kann nicht angezeigt werden.“

Um dieses Problem zu vermeiden, müssen Sie bei der Wiederherstellung von LiveCycle ES2 aus einer

Sicherung denselben Hostnamen verwenden.

Content Services ES2 Die Bereitstellung von EAR schlägt fehl auf WebSphere

Wenn Sie eine Aktualisierung von LiveCycle 8.2.1.x auf LiveCycle ES2 durchführen, kann die Bereitstellung der Content Services ES2-EAR-Datei fehlschlagen, wenn die Ressourcenauslastung des

Anwendungsservers hoch ist. Die folgende Fehlermeldung kann angezeigt werden:

SchemaBootstr E org.alfresco.util.LogUtil error Schema auto-update failed org.alfresco.error.AlfrescoRuntimeException: Eine frühere

Schemaaktualisierung ist fehlgeschlagen oder wurde nicht abgeschlossen.

Stellen Sie die ursprüngliche Datenbank wieder her, bevor Sie die

Aktualisierung erneut durchführen.

Führen Sie zur Behebung dieses Problems die folgenden Schritte aus.

Erhöhen des Zeitüberschreitungswerts für die Gesamttransaktionszeit

1. (WebSphere 6.x) Klicken Sie in der WebSphere-Verwaltungskonsole auf Servers > Application servers und klicken Sie anschließend auf den Namen des Servers.

(WebSphere 7.x) Klicken Sie in der WebSphere-Verwaltungskonsole auf Servers > Server Types >

WebSphere application servers und klicken Sie anschließend auf den Namen des Servers.

2. Klicken Sie auf Container Settings > Container Services > Transaction Service.

3. Legen Sie auf der Registerkarte Configuration den Wert für die Einstellung Total transaction lifetime

timeout auf 900 Sekunden fest.

Adobe LiveCycle ES2

Fehlerbehebung in LiveCycle ES2

Fehlerbehebung bei Installation und Bereitstellung

Beim Upgrade wird die Content Services EAR-Datei nicht an alle Knoten bereitgestellt 17

4. Klicken Sie auf Anwenden oder OK.

5. Starten Sie den Anwendungsserver neu.

Bereitstellen der EARs in einer anderen Reihenfolge

Initiieren Sie die Aktualisierung erneut. Stellen Sie nun die Content Services ES2-EAR-Datei in LiveCycle

Configuration Manager bereit, bevor Sie die anderen EAR-Dateien bereitstellen.

1. Wählen Sie auf dem Bildschirm zur Bereitstellung der EAR-Dateien adobe-contentservices.ear

aus und klicken Sie dann auf Bereitstellen.

2. Deaktivieren Sie nach der erfolgreichen Bereitstellung der Content Services ES2-EAR-Datei adobe-contentservices.ear

, wählen Sie die anderen EAR-Dateien aus und klicken Sie auf

Bereitstellen.

Beim Upgrade wird die Content Services EAR-Datei nicht an alle Knoten bereitgestellt

Bei der Aktualisierung von LiveCycle ES Version 8.2 auf Content Services ES2 auf einem Cluster wird eine Content Services ES2-EAR-Datei für den ersten Knoten bereitgestellt, jedoch nicht für die anderen

Clusterknoten. Es gibt zwei mögliche Abhilfen für dieses Problem, aber beide weisen Nachteile auf.

Prüfen Sie die beiden Abhilfen um zu entscheiden, welche für Ihre Umgebung die beste Lösung ist.

●

Wenn Sie während der Aktualisierung die Content Services ES2-EAR-Dateien unter Verwendung von LiveCycle Configuration Manager konfigurieren, stellen Sie für das Indexstammverzeichnis von

LiveCycle ES2 einen anderen Speicherort ein, als der, der für Version 8.2 angegeben ist. Diese Abhilfe ermöglicht Ihnen, alle Knoten im Cluster direkt über LiveCycle Configuration Manager zu starten.

●

Hinweis: Mit dieser Option benötigt der LiveCycle ES2-Server möglicherweise sehr lange zum Start, wenn Sie eine Vielzahl von Inhalten im Content Services ES2-Repository gespeichert haben.

Die Ursache dafür ist, dass jeder Knoten im Cluster versucht, die Indizes erneut zu erstellen.

Stellen Sie sicher, dass während der Bereitstellung der EAR-Dateien nur einer der Knoten des Clusters gestartet ist und geben Sie die während des gesamten Aktualisierungsprozesses jeweils nur die zu diesem Knoten gehörigen Details an. Dieser Schritt gewährleistet, dass der LiveCycle ES2-Server die

Indizes lediglich aktualisiert und nicht neu erstellt.

Wenn der Knoten erfolgreich startet, kopieren Sie das Verzeichnis mit den Indizes von diesem Knoten zu den anderen Knoten des Clusters, auf denen Sie nicht vorhaben, LiveCycle Configuration Manager auszuführen. Starten Sie jetzt die anderen Knoten des Clusters. Die Content Services ES2-EAR-Datei wird jetzt erfolgreich an alle Cluster-Knoten bereitgestellt.

Hinweis: Obwohl diese Abhilfe sehr zeitaufwendig bei der Umsetzung ist, gewährleistet sie eine

Minimierung der Server-Ausfallzeiten während des Startvorgangs.

Einige Komponenten werden nicht ordnungsgemäß aktualisiert

Wenn ein Aktualisierungsversuch von LiveCycle 8.x auf LiveCycle ES2 aus irgendeinem Grund fehlschlägt, werden einige Komponenten während einer nachfolgenden Aktualisierung möglicherweise auch dann nicht korrekt aktualisiert, wenn der Zustand vor der Aktualisierung wiederhergestellt wurde. Zum Beispiel

Reader Extensions ES2.

Adobe LiveCycle ES2

Fehlerbehebung in LiveCycle ES2

Fehlerbehebung bei Installation und Bereitstellung

Fehler „Falsche Versionsnummer in CLASS-Datei“ während der Datenbanküberprüfung 18

Sie müssen vor einer erneuten Aktualisierung die Datei sharedData im Verzeichnis

„<LiveCycle ES2-Stammverzeichnis>/configurationManager/working/upgrade“ löschen, um dieses

Problem zu beheben.

Zusätzlich zu diesem Schritt müssen Sie die folgenden Entitäten auf den Zustand vor der Aktualisierung zurücksetzen, bevor Sie die Aktualisierung erneut ausführen:

●

Datenbank

●

●

● lccs_data

Globaler Dokumentspeicher

Andere relevante Ordner

Fehler „Falsche Versionsnummer in CLASS-Datei“ während der

Datenbanküberprüfung

(Nur bei Oracle-Datenbank)

Wenn Sie eine Aktualisierung auf eine LiveCycle ES2-Plattform durchführen, die JDK 1.5 verwendet und eine Verbindung zu einer Oracle-Datenbank herstellt, müssen Sie die Datei „ojdbc5.jar“ verwenden.

Wenn die Datei „ojdbc6.jar“ verwendet wird (Standardvorgabe), wird beim Überprüfen der

Datenbankverbindung auf dem Bildschirm „LiveCycle ES2-Datenbank“ die Fehlermeldung „Falsche

Versionsnummer in CLASS-Datei“ angezeigt.

Wenn dieser Fehler angezeigt wird, müssen Sie LiveCycle Configuration Manager beenden und neu starten. Geben Sie auf dem Bildschirm „LiveCycle ES2-Datenbank“ die Datei „ojdbc5.jar“ an.

Hinweis: Auf einer LiveCycle ES2-Plattform, die JDK 1.6 verwendet, können Sie als Datenbanktreiber entweder die Datei „ojdbc5.jar“ oder die Datei „ojdbc6.jar“ angeben.

Hinweise zu PDF Generator ES2

Die folgenden Themen behandeln Probleme mit PDF Generator ES2 und deren Lösungen.

Konfigurieren von PDF Generator ES2 für die Konvertierung von MS Office-Dateien in das PDF-Format

Es ist ein bekanntes Problem, dass bei manchen LiveCycle ES2-Servern eine DCOM-Berechtigungsrichtlinie geändert werden muss, damit PDF Generator ES2 zum Konvertieren von Dateien aus Microsoft

Office-Anwendungen verwendet werden kann. Erfolgt die Änderung nicht, wird die folgende

Fehlermeldung ausgegeben:

INFO [STOUT] com.jniwrapper.win32.com.ComException: COM object method returns error code: 0x80004005; E_FAIL (Unspecified error)

Microsoft hat die erforderlichen Schritte in einem Knowledgebase-Artikel auf der Microsoft Hilfe und

Support -Site dokumentiert.

Adobe LiveCycle ES2

Fehlerbehebung in LiveCycle ES2

Fehlerbehebung bei Installation und Bereitstellung

Bekanntes Problem, wenn der Zugriff auf einen LiveCycle ES2-Server

über eine Telnet-Sitzung erfolgt 19

Bekanntes Problem, wenn der Zugriff auf einen LiveCycle ES2-Server

über eine Telnet-Sitzung erfolgt

Umwandlung nativer Dateiformate in das PDF-Format nicht möglich und Anzeige einer Fehlermeldung, wenn der Zugriff auf einen LiveCycle ES2-Server, der auf Windows Server 2008 läuft, mithilfe des

Telnet-Dienstes erfolgt und der Anwendungsserver mit einem Stapelverarbeitungsskript gestartet wird.

Um dieses Problem zu vermeiden, müssen Sie den Telnet-Dienst mit der ausgewählten Option

Interaktion des Dienstes mit dem Desktop zulassen starten. Sie können diese Option auswählen, wenn Sie die Eigenschaften des Bildschirms Dienste in Windows Server 2008 ändern.

Auflösen von Pfaden beim Konvertieren von Excel-Dateien in PDF-Dateien

Bei Verwendung von PDF Generator ES2 zum Konvertieren einer Excel-Datei in eine PDF-Datei und wenn die Excel-Datei in der Kopfzeile oder Fußzeile eine Dateinamen- und Dateipfadfunktion

( &[Path]&[File] ) enthält, können unerwartete Ergebnisse auftreten. Beim Konvertieren der Datei kopiert PDF Generator ES2 diese in einen temporären Speicherort auf dem LiveCycle ES2-Server und führt die Konvertierung an dieser Kopie durch. Das führt dazu, dass die Dateinamen- und Dateipfadfunktion im

Excel-Dokument in den Namen und Speicherort der temporären Datei aufgelöst werden, und diese Werte werden dann auch in der erzeugten PDF-Datei angezeigt.

Probleme bei Installation, Konfiguration und Bereitstellung

Allgemeine Probleme

LiveCycle Configuration Manager startet in der Befehlszeilenschnittstelle nicht

Dieser Fehler tritt auf, wenn Sie die Umgebungsvariable ADOBE_JAVA_HOME nicht festgelegt haben. Um eine erfolgreiche Installation zu gewährleisten, müssen Sie immer sicherstellen, dass die erforderlichen

Parameter festgelegt wurden, bevor Sie das Installationsprogramm und LiveCycle Configuration Manager starten.

Probleme bei der Konfiguration

LiveCycle Configuration Manager behält den Status für die inkompatible

JAR-Treiberdatei auf WebSphere

Wenn eine inkompatible JAR-Datei im Feld JDBC-Treiber in der Anwendungsserverbibliothek auf dem

Bildschirm Datenquellenkonfiguration angegeben ist, kann der Speicherort der richtigen JAR-Datei erst nach einem Neustart von LiveCycle Configuration Manager angegeben werden.

ojdbc5.jar

ist die richtige JAR-Datei für WebSphere 6.x und ojdbc6.jar

ist die richtige JAR-Datei für

WebSphere 7.x.

Adobe LiveCycle ES2

Fehlerbehebung in LiveCycle ES2

Fehlerbehebung bei Installation und Bereitstellung

Probleme bei der Bereitstellung 20

LiveCycle Configuration Manager wählt eine andere JDK aus als erwartet

Wenn auf Ihrem System JDKs von mehreren Anbietern installiert sind, kann es vorkommen, dass LiveCycle

Configuration Manager eine andere JDK auswählt als die JDK, die in der Umgebungsvariable PATH angegeben ist.

Um dieses Problem zu beheben, starten Sie LiveCycle Configuration Manager mithilfe von

ConfigurationManager.bat

anstelle von ConfigurationManager.exe

.

Tipp: Sie können die LiveCycle Configuration Manager-Protokolle überprüfen, um sicherzustellen, dass die richtige JDK verwendet wird.

Probleme bei der Bereitstellung

Fehler beim Bereitstellen von EAR-Dateien

Abhängig von den zu installierenden LiveCycle ES2-Diensten und Ihrer Systemkonfiguration werden bei der Bereitstellung der EAR-Dateien Fehlermeldungen angezeigt. Tritt dies auf, erhöhen Sie den Wert von

MaxPermSize auf Ihrem Anwendungsserver von 256 auf 512 . Spezifische Anleitungen zum Festlegen dieses Werts auf Ihrem Anwendungsserver finden Sie in Vorbereiten der Installation von LiveCycle ES2 .

Beispielsweise können Sie in WebLogic MaxPermSize hier ändern:

C:\bea\user_projects\domains\base_domain\bin\setDomainEnv.cmd

Fehlerhaftes Melden eines Fehlers beim Bereitstellen von

Content Services ES2-EARs

Wenn bei der Installation von oder beim Upgrade auf LiveCycle ES2 das System langsam oder stark ausgelastet ist, dann meldet LiveCycle Configuration Manager fälschlicherweise einen Fehler bei der

Bereitstellung der Content Services ES2-EAR. Das kann passieren, wenn LiveCycle ES2 installiert wird oder wenn ein LiveCycle-Upgrade von 8.x zu LiveCycle ES2 erfolgt.

Außerdem enthalten die LiveCycle Configuration Manager-Protokolle die folgende Fehlermeldung:

„Failed to make SOAP RPC call: invoke“. Aufgrund dieser fehlerhaften Meldung wird die

LiveCycle Workspace ES2-EAR nicht bereitgestellt und Sie können im LiveCycle Configuration Manager nicht mit dem nächsten Schritt fortfahren.

Wenn dieser Fehler auftritt, gehen Sie folgendermaßen vor:

1. Überprüfen Sie, dass das Zeitlimit für SOAP-Anforderungen entsprechend der Dokumentation festgelegt ist. Weitere Informationen finden Sie im Abschnitt „Konfigurieren der

WebSphere-Zeitlimiteinstellungen“ im Handbuch Installieren und Bereitstellen von LiveCycle ES2 für

WebSphere oder Aktualisieren auf LiveCycle ES2 von 8.x für WebSphere .

2. Überprüfen Sie von der WebSphere-Verwaltungskonsole aus, ob die Content Services ES2EAR ordnungsgemäß bereitgestellt ist und ausgeführt wird. Sollten Sie feststellen, dass die

Content Services ES2-EAR ordnungsgemäß bereitgestellt ist, führen Sie einen der folgenden

Schritte durch:

● Heben Sie im LiveCycle Configuration Manager die Auswahl aller EARs auf, die bereits bereitgestellt und ausgeführt werden, und wählen Sie lediglich die EARs aus, die noch bereitgestellt werden müssen (in diesem Fall „adobe-workspace-client.ear“), und klicken Sie auf Bereitstellen.

Adobe LiveCycle ES2

Fehlerbehebung in LiveCycle ES2

Fehlerbehebung bei Installation und Bereitstellung

Probleme bei der Bereitstellung 21

●

Stellen Sie die Workspace ES2-EAR-Datei („adobe-workspace-client.ear“) manuell von der

WebSphere-Verwaltungskonsole aus bereit. Führen Sie nach diesem Schritt den LiveCycle

Configuration Manager erneut aus und wählen Sie dann im LiveCycle Configuration Manager die Aufgaben aus, die sich an die Bereitstellung der EARs anschließen.

Hinweis: Wenn der LiveCycle Configuration Manager nicht in der Lage ist, irgendwelche EAR-Dateien bereitzustellen, können Sie diese von der Verwaltungskonsole Ihres Anwendungsservers aus manuell bereitstellen. Folgen Sie dieser allgemeinen Anleitung zur manuellen Bereitstellung von EAR-Dateien und zur Fortsetzung der Konfigurationsaufgaben in LiveCycle Configuration

Manager:

●

●

Stellen Sie die erforderlichen EAR-Dateien von der Verwaltungskonsole Ihres

Anwendungsservers aus manuell bereit.

Schließen Sie die aktuell ausgeführte Instanz von LiveCycle Configuration Manager.

● Starten Sie LiveCycle Configuration Manager erneut und wählen Sie die Aufgaben aus, die im

Anschluss an die von Ihnen manuell durchgeführte Bereitstellung der EARs erfolgen sollen.

Bereitstellen von LiveCycle ES2 in einer verteilten Umgebung

Wenn sich die Anwendungsserver-Instanz (WebSphere) oder der verwaltete Server (WebLogic) auf einem anderen Server befinden, d. h. nicht auf demselben Server wie der Deployment Manager (WebSphere) oder der Verwaltungsserver (WebLogic), dann müssen Sie die LiveCycle ES2-EAR-Dateien manuell bereitstellen. Wenn Sie die Bereitstellung mithilfe von LiveCycle Configuration Manager durchzuführen versuchen, erhalten Sie eine Fehlermeldung, die besagt, dass die Bereitstellung fehlgeschlagen ist.

Führen Sie das folgende Verfahren aus, wenn dieser Fehler bei Verwendung von LiveCycle Configuration

Manager für die Bereitstellung der EAR-Dateien auftritt.

➤

So stellen Sie die LiveCycle ES2-EAR-Dateien bereit:

1. Beenden Sie LiveCycle Configuration Manager.

2. Stellen Sie die EAR-Dateien manuell bereit. (Weitere Informationen finden Sie im Kapitel „Manuelles

Bereitstellen“ unter Installieren und Bereitstellen von LiveCycle ES2 für Ihren Anwendungsserver.)

3. Führen Sie LiveCycle Configuration Manager aus und wählen Sie die Aufgaben erst nach der

Bereitstellung der EAR-Dateien für LiveCycle ES2 aus.

Fehler beim Überprüfen der Bereitstellung des LiveCycle ES2-Moduls auf WebSphere

Beim manuellen Konfigurieren von WebSphere für LiveCycle ES2 wird eventuell folgender Fehler ausgegeben:

Component deployment failed validation. Cannot connect to server container

Führen Sie in diesem Fall die folgenden Schritte aus:

➤

So erhöhen Sie das maximale Transaktionszeitlimit und die ORB-Dienstwerte:

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

Servers und anschließend im rechten Fenster auf den Servernamen.

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

Adobe LiveCycle ES2

Fehlerbehebung in LiveCycle ES2

Fehlerbehebung bei Installation und Bereitstellung

Beheben von Problemen mit dem Anwendungsserver 22

3. Erhöhen Sie alle diese Zeitlimitwerte, um diesen LiveCycle ES2-Fehler zu beheben:

●

Total transaction lifetime timeout: 1800

●

●

Async response timeout: 1800

Maximum transaction timeout: 1800

4. Starten Sie WebSphere Application Server neu.

Unter Solaris können keine Bereitstellungsfehler gestartet/erstellt werden

Laden Sie das GNU-Tool „tar“ herunter und extrahieren Sie damit alle Dateien in einer Solaris-Umgebung.

Verwenden Sie nicht den Solaris-Befehl „tar“, um Dateien zu extrahieren. Andernfalls treten Fehler auf, wie z. B. fehlende Dateien und dem folgenden ähnliche Protokolleinträge:

ERROR[org.apache.catalina.core.ContainerBase.[jboss.web].[localhost].[/invok er]] Exception starting filter ReadOnlyAccessFilter java.lang.ClassNotFound-Ausnahme: org.jboss.invocation.http.servlet.ReadOnlyAccessFilter

Die Konfigurationsüberprüfung des Anwendungsservers schlägt fehl, wenn LiveCycle Configuration Manager erneut ausgeführt wird.

Wenn Sie LiveCycle Configuration Manager nach einmaliger Ausführung der Konfiguration und

Überprüfung erneut ausführen und die Bereitstellung von „adobe-lcm-lcvalidation.ear“ überspringen, wird eine Fehlermeldung angezeigt des Inhalts, dass ein Fehler bei der Überprüfung der

Anwendungsserverkonfiguration aufgetreten ist. Dieser Fehler tritt auf, obwohl Sie bereits die Datei „adobe-lcm-lcvalidation.ear“ bereitgestellt und die Konfiguration überprüft haben.

Zur Vermeidung dieses Fehlers wählen Sie die Aufgabe zur Bereitstellung von

„adobe-lcm-lcvalidation.ear“ und zur Überprüfung der bei allen nachfolgenden Ausführungen von LiveCycle Configuration Manager aus.

Beheben von Problemen mit dem Anwendungsserver

In diesem Abschnitt werden mögliche Probleme beim Betrieb des Anwendungsservers sowie deren

Behebung mithilfe der Protokolldateien beschrieben.

Der Anwendungsserver kann nicht gestartet werden

Wenn der Server nicht gestartet wird, führen Sie die folgenden Schritte aus:

●

Überprüfen Sie die Protokolldatei des Anwendungsservers.

● Prüfen Sie, ob der Server bereits ausgeführt wird. Falls ja, wird er weiter ausgeführt, ohne initialisiert zu werden. Beenden Sie den Anwendungsserver und starten Sie ihn erneut.

●

●

Prüfen Sie, ob ein anderer Prozess einen der für LiveCycle ES2 verwendeten Anschlüsse verwendet.

Informationen hierzu finden Sie in der Dokumentation des Herstellers.

Adobe LiveCycle ES2

Fehlerbehebung in LiveCycle ES2

Fehlerbehebung bei Installation und Bereitstellung

JBoss Application Server-Probleme 23

JBoss Application Server-Probleme

Fehler bei der Content Services ES2-Bereitstellung nach dem Neustart eines

JBoss-Servers

Wenn bei der Bereitstellung von Content Services ES2 nach einem Neustart von JBoss Application Server ein Fehler auftritt, müssen Sie Java-Prozesse und mysqld-max-nt.exe zur Liste der sicheren Prozesse Ihrer

Antivirensoftware hinzufügen.

Der in den Protokollen angezeigte Fehlercode 13 ist ein Zugriffsverweigerungsfehler.

WebLogic Server-Probleme

LiveCycle Configuration Manager reagiert beim erneuten Bereitstellen einer

EAR-Datei nicht mehr

Beim erneuten Bereitstellen einer EAR-Datei für LiveCycle ES2 hält LiveCycle Configuration Manager eventuell an, ohne dass die Phase abgeschlossen ist, und stellt die neue EAR-Datei nicht bereit.

Dieses Problem tritt manchmal auf, wenn WebLogic Server eine bereits bereitgestellte EAR-Datei nicht freigibt. Gehen Sie folgendermaßen vor, um dieses Problem zu beheben:

1. Beenden Sie LiveCycle Configuration Manager.

2. Entfernen Sie manuell die vorhandene Version der LiveCycle ES2-EAR-Datei, die Sie aktualisieren möchten.

3. Beenden und starten Sie die Administrations- und die verwalteten WebLogic Server neu.

4. Führen Sie LiveCycle Configuration Manager aus, um die neue EAR-Datei bereitzustellen.

WebSphere Application Server-Probleme

Probleme beim Löschen der Verzeichnisstruktur auf WebSphere

Wenn es nicht möglich ist, eine WebSphere-Verzeichnisstruktur zu löschen, kann es daran liegen, dass der Pfad zu lang ist. Beispielsweise ist es eventuelle nicht möglich, die folgende Datei zu löschen, die von

LiveCycle Rights Management ES2 verwendet wird:

C:\Programme\IBM\WebSphere\AppServer\profiles\AppSrv01\installedApps\

Server1Node01Cell\LiveCycleES2.ear\rest-webservice.war\WEB-INF\classes\com\ adobe\rightsmanagement\webservices\rest\serialization\objects\

RestPolicyInfoSerializer$InternalPolicyInfoStruct.class

Um dieses Problem zu beheben, weisen Sie dem Speicherort, aus dem Sie Dateien löschen möchten

(in diesem Beispiel C:\Programme\IBM\WebSphere\AppServer\profiles\AppSrv01\ installedApps ), einen Laufwerksbuchstaben zu und löschen Sie dann die Daten von diesem zugeordneten Laufwerk.

Adobe LiveCycle ES2

Fehlerbehebung in LiveCycle ES2

Fehlerbehebung bei Installation und Bereitstellung

Der Anwendungsserver reagiert nicht mehr (WebSphere und DB2 auf AIX) 24

➤

So weisen Sie über die Befehlszeile einem Speicherort einen Laufwerksbuchstaben zu und löschen Dateien:

1. Weisen Sie dem Speicherort, von dem Sie löschen möchten, einen Laufwerksbuchstaben zu. Beispiel: net use L: \\<hostname>\C$\Programme\IBM\WebSphere\AppServer\profiles

\AppSrv01\installedApps

2. Wechseln Sie zum zugeordneten Laufwerk: Beispiel:

L:

3. Löschen Sie die Dateien Beispiel: del /s /q *

4. Wechseln Sie wieder zurück zum ursprünglichen Laufwerk. Beispiel:

C:

5. Löschen Sie die Laufwerkszuordnung. Beispiel: net use delete L:

Alternativ können Sie ein Verzeichnis in dem Pfad so umbenennen, das der Verzeichnisname aus nur einem Zeichen besteht, um den Pfad zu verkürzen und dann die Dateien zu löschen.

OutOfMemory PermGen-Speicherplatzfehler (WebSphere auf Solaris)

Wenn Sie den WebSphere-Anwendungsserver auf Solaris verwenden, kann ein LiveCycle Configuration

Manager-Fehler während der Bereitstellung der LiveCycle ES2-Komponente mit der Fehlermeldung

OutOfMemory PermGen-Speicherplatz auftreten.

Um diesen Fehler zu vermeiden, fügen Sie im Abschnitt „Generic JVM Arguments“ des

Anwendungsservers folgenden Parameter hinzu:

-XX:MaxPermSize=512m

Starten Sie den Anwendungsserver neu und fahren Sie dann normal fort. Weitere Informationen finden Sie in Vorbereiten der Installation von LiveCycle ES2 (Einzelserver) .

Der Anwendungsserver reagiert nicht mehr (WebSphere und DB2 auf AIX)

Wenn mehrere Benutzer gleichzeitig Workbench ES2 in einer WebSphere+DB2-Konfiguration auf AIX verwenden, kann es vorkommen, dass der LiveCycle ES2-Server nicht mehr reagiert, wenn ein Benutzer versucht, eine Anwendung bereitzustellen.

Gehen Sie zur Vermeidung dieses Problems wie folgt vor:

1. Öffnen Sie die [WorkbenchES2_HOME]\workbench.ini-Datei mit einem Texteditor.

2. Suchen Sie die folgende Zeile und ändern Sie ihren Wert in 1 :

-Dcom.adobe.workbench.unsupported.service.cache.batch.threads=5

3. Speichern und schließen Sie die Datei.

Adobe LiveCycle ES2

Fehlerbehebung in LiveCycle ES2

Fehlerbehebung bei Installation und Bereitstellung

NullPointerException-Ausnahme beim Zugriff Contentspace ES2 25

NullPointerException-Ausnahme beim Zugriff Contentspace ES2

Tritt beim Zugriff auf Contentspace ES2 eine NullPointerException-Ausnahme auf, starten Sie den

Anwendungsserver erneut und greifen Sie auf Contentspace ES2 erneut zu.

Dieses Problem wird nur bei WebSphere 7.x und nicht bei WebSphere 6.x beobachtet.

Beheben von Problemen mit der LiveCycle ES2-Datenbank

In diesem Abschnitt werden mögliche Probleme beim Betrieb der LiveCycle ES2-Datenbank beschrieben und Vorschläge zur ihrer Vermeidung bzw. Umgehung gemacht.

Wenn Fehler beim Bootstrapping Ihrer Datenbank auftreten, überprüfen Sie Folgendes:

●

●

●

Der Datenbank steht ausreichend Speicherplatz für die Vergrößerung zur Verfügung.

Die Datenbankkonfiguration entspricht den Mindestanforderungen für die Datenbankkonfiguration.

Informationen zu Konfigurationsanforderungen für Ihren Datenbanktyp finden Sie im Dokument

Vorbereiten der Installation von LiveCycle ES2 (Einzelserver) .

Informationen hierzu finden Sie in der Dokumentation des Herstellers.

Hinweis: Ist auch nach diesen Überprüfungen kein erfolgreiches Bootstrapping der Datenbank durch den

Datenbankadministrator möglich, wenden Sie sich umgehend an den Datenbankhersteller.

Führen Sie die folgenden Aufgaben durch, um die fortwährende Verfügbarkeit und Leistung Ihrer

LiveCycle ES2-Datenbank sicherzustellen:

●

Überwachen Sie die Datenbank während des Betriebs ständig auf Leistungsprobleme.

●

●

●

Überwachen Sie das Datenbankwachstum ständig, um sicherzustellen, dass stets genügend

Speicherplatz zur Verfügung steht.

Prüfen Sie die Verwendung von LiveCycle ES2-Komponenten: Ressourcenintensive

LiveCycle-Process Management ES2-Anwendungen führen zu deutlich mehr Datenbankwachstum als ressourcenintensive PDF Generator ES2-Anwendungen.

Informationen dazu finden Sie in der Herstellerdokumentation zur Datenbankleistung.

IBM DB2-Konfigurationseinstellungen

Wenn Sie LiveCycle ES2 mit einer DB2-Datenbank ausführen und der Computer nicht mehr reagiert,

überprüfen Sie die Protokolldateien auf Meldungen im Zusammenhang mit einem Deadlock. Ändern Sie die DB2-Konfigurationsparameter, wenn solche Meldungen in den Protokolldateien vorhanden sind:

●

Stellen Sie den Parameter LOCKTIMEOUT auf 15 ein.

● Verdoppeln Sie die Werte für die Parameter APPLHEAPSZ , STMTHEAP und SORTHEAP .

Sie müssen die Datenbank und den Anwendungsserver anschließend neu starten.

Fehlerbehebung mit Protokolldateien

In diesem Abschnitt wird beschrieben, wie Sie Fehler in LiveCycle ES2 mithilfe der Protokolldateien beheben.

Adobe LiveCycle ES2

Fehlerbehebung in LiveCycle ES2

Fehlerbehebung bei Installation und Bereitstellung

Protokolldatei von LiveCycle ES2 26

Protokolldatei von LiveCycle ES2

Standardmäßig befindet sich die LiveCycle ES2-Protokolldatei im [LiveCycleES2-Stammverzeichnis] und heißt „log.txt“. Diese Protokolldatei ist bei der Fehleranalyse in LiveCycle ES2 nützlich und wird eventuell vom Adobe Enterprise-Support benötigt.

Protokolldatei von LiveCycle Configuration Manager

Standardmäßig befindet sich die LiveCycle Configuration Manager-Protokolldatei im Verzeichnis

„[LiveCycleES2-Stammverzeichnis]\ConfigurationManager\log“ und heißt „lcm.0.log“ (oder ähnlich).

Die Protokolldateien sind bei der Fehleranalyse in LiveCycle Configuration Manager nützlich und werden eventuell vom Support von Adobe Enterprise benötigt.

Fehlerbehebung beim Anwendungsserver mithilfe der Protokolldateien

Sie können die Informationen in den Protokolldateien des Anwendungsservers verwenden, um Probleme mit Ihrer LiveCycle ES2-Implementierung zu beheben. Falls die Protokolldateien nicht genügend

Informationen für die Fehlerbehebung bereitstellen, können Sie die ausführliche Protokollierung aktivieren, damit mehr Details protokolliert werden. Die ausführliche Protokollierung sollte nur bei der Fehlerbehebung aktiviert werden, da ansonsten die Systemleistung verringert und zusätzlicher

Speicherplatz für Protokolldateien belegt wird.

Hinweis: Sie sollten sich an den Adobe Enterprise-Support wenden, um Probleme mithilfe ausführlicher

Protokolldateien zu beheben.

JBoss-Protokolldatei

Standardmäßig befinden sich die JBoss-Protokolldateien im Verzeichnis „[LiveCycle ES2-Stammverzeichnis]\ jboss\server\all\log“ und heißen „boot.log“ und „server.log“. Die Protokolldateien sind für die

Fehleranalyse bei der Bereitstellung und dem Bootstrapping von JBoss Application Server und

LiveCycle ES2 nützlich und werden eventuell vom Adobe Enterprise-Support benötigt.

Falls die Protokolldateien nicht genügend Informationen für die Fehlerbehebung bereitstellen, können Sie die TRACE-Protokollierung aktivieren, damit mehr Details protokolliert werden. Dazu müssen Sie die Datei

„[Anwendungsserver-Stammverzeichnis]/conf“ bearbeiten.

Hinweis: Erstellen Sie unbedingt eine Sicherungskopie der Datei

„[Anwendungsserver-Stammverzeichnis]/conf“, bevor Sie sie ändern.

➤

So aktivieren Sie die TRACE-Protokollierung in JBoss:

1. Wechseln Sie an einer Eingabeaufforderung zum Verzeichnis

[Anwendungsserver-Stammverzeichnis]/conf.

2. Bearbeiten Sie die Konfigurationsdatei log4j.xml

mit einem Texteditor.

3. Suchen Sie in der Datei das Protokollierungselement <root> und ändern Sie es folgendermaßen:

<root>

<priority value=”INFO” />

<appender-ref ref=”FILE” />

</root>

Adobe LiveCycle ES2

Fehlerbehebung in LiveCycle ES2

Fehlerbehebung bei Installation und Bereitstellung

Fehlerbehebung beim Anwendungsserver mithilfe der Protokolldateien 27

4. Geben Sie oberhalb des Protokollierungselements <root> den folgenden Text ein:

<category name="org.jboss.ejb">

<priority value="TRACE" class="org.jboss.logging.XLevel"/>

<!--Comment the line below if you want to disable tracing -->

<appender-ref ref=”TRACE_FILE” />

<appender-ref ref=”FILE” />

</category>

5. Suchen Sie in der Datei den Eintrag <appender name="FILE" und ändern Sie diesen bzw. geben Sie die folgende Zeile ein:

<param name=”Threadhold” value=”DEBUG” />

6. Suchen Sie in der Datei den Eintrag <!-- A size based file rolling appender und fügen Sie den Appender in die nachfolgende Zeile ein:

<appender name="TRACE_FILE" class="org.jboss.logging.appender.RollingFileAppender">

<errorHandler class="org.jboss.logging.util.OnlyOnceErrorHandler"/>

<param name="File" value="${jboss.server.home.dir}/log/trace.log"/>

<param name="Append" value="false"/>

<param name="MaxFileSize" value="5MB"/>

<param name="MaxBackupIndex" value="2"/>

<layout class="org.apache.log4j.PatternLayout">

<param name="ConversionPattern" value="%d %-5p [%c] %m%n"/>

</layout>

</appender>

7. Speichern und schließen Sie die Datei log4j.xml

.

➤

So deaktivieren Sie die TRACE-Protokollierung in JBoss:

1. Wechseln Sie an einer Eingabeaufforderung zum Verzeichnis

[Anwendungsserver-Stammverzeichnis]/conf.

2. Bearbeiten Sie die Konfigurationsdatei log4j.xml

mit einem Texteditor.

3. Suchen Sie in der Datei das Protokollierungselement <root> und ändern Sie es folgendermaßen:

<root>

<priority value=”INFO” />

<appender-ref ref=”FILE” />

</root>

4. Geben Sie oberhalb des Protokollierungselements <root> den folgenden Text ein:

<category name="org.jboss.ejb">

<priority value="TRACE" class="org.jboss.logging.XLevel"/>

<!--Comment the line below if you want to disable tracing -->

<appender-ref ref=”TRACE_FILE” />

<appender-ref ref=”FILE” />

</category>

5. Suchen Sie in der Datei den Eintrag <appender name="FILE" und ändern Sie diesen bzw. geben Sie die folgende Zeile ein:

<param name=”Threadhold” value=”DEBUG” />

Adobe LiveCycle ES2

Fehlerbehebung in LiveCycle ES2

Fehlerbehebung bei Installation und Bereitstellung

Fehlerbehebung beim Anwendungsserver mithilfe der Protokolldateien 28

6. Suchen Sie in der Datei den Eintrag <!-- A size based file rolling appender und fügen Sie den Appender in die nachfolgende Zeile ein:

<appender name="TRACE_FILE" class="org.jboss.logging.appender.RollingFileAppender">

<errorHandler class="org.jboss.logging.util.OnlyOnceErrorHandler"/>

<param name="File" value="${jboss.server.home.dir}/log/trace.log"/>

<param name="Append" value="false"/>

<param name="MaxFileSize" value="5MB"/>

<param name="MaxBackupIndex" value="2"/>

<layout class="org.apache.log4j.PatternLayout">

<param name="ConversionPattern" value="%d %-5p [%c] %m%n"/>

</layout>

</appender>

7. Speichern und schließen Sie die Datei log4j.xml

.

WebLogic-Protokolldatei

Standardmäßig befindet sich die WebLogic-Protokolldatei im Verzeichnis /var/log/httpd/error_log .

Die Protokolldateien sind bei der Bootstrapping-Fehleranalyse in WebLogic Server und LiveCycle ES2 nützlich und werden eventuell vom Support von Adobe Enterprise benötigt.

Falls die Protokolldatei nicht genügend Informationen für die Fehlerbehebung bereitstellt, können Sie die

Ablaufverfolgungsstufe in der Protokolldatei angeben, damit mehr Details protokolliert werden. Dazu

ändern Sie den Parameter LogLevel in der Datei „[Anwendungsserver-Stammverzeichnis]/conf/httpd.conf“.

LogLevel bestimmt, wie ausführlich die Fehlermeldungen in den Fehlerprotokollen sind. Für LogLevel gibt es folgende mögliche Werte (von der geringsten zur höchsten Ausführlichkeit): emerg , alert , crit , error , warn , notice , info und debug . Der Standardwert für LogLevel ist warn .

Hinweis: Erstellen Sie unbedingt eine Sicherungskopie der Datei

„[Anwendungsserver-Stammverzeichnis]/conf/httpd.conf“, bevor Sie sie ändern.

➤

So aktivieren Sie den LogLevel-Wert „debug“ in WebLogic:

1. Wechseln Sie an einer Eingabeaufforderung zum Verzeichnis

„[Anwendungsserver-Stammverzeichnis]/conf“.

2. Bearbeiten Sie die Konfigurationsdatei httpd.conf

mit einem Texteditor.

3. Suchen Sie in der Datei den Eintrag LogLevel und ändern Sie ihn folgendermaßen:

LogLevel debug

4. Speichern und schließen Sie die Datei httpd.conf

.

Wenn Sie die Fehlerbehebung abgeschlossen haben, wiederholen Sie die Schritte 1 bis 4, ändern dabei den LogLevel -Wert jedoch in warn .

WebSphere-Protokolldatei

Standardmäßig befindet sich die WebSphere-Protokolldatei im Verzeichnis

„[Anwendungsserver-Stammverzeichnis]\logs/server1/trace.log“. Die Protokolldateien sind bei der

Bootstrapping-Fehleranalyse in WebSphere Application Server und LiveCycle ES2 nützlich und werden eventuell vom Support von Adobe Enterprise benötigt.

Adobe LiveCycle ES2

Fehlerbehebung in LiveCycle ES2

Fehlerbehebung bei Installation und Bereitstellung

Fehlerbehebung beim Anwendungsserver mithilfe der Protokolldateien 29

Falls die Protokolldateien nicht genügend Informationen für die Fehlerbehebung bereitstellen, können

Sie in der Verwaltungskonsole von WebSphere die TRACE-Protokollierung aktivieren, damit mehr Details protokolliert werden.

➤

So aktivieren Sie die TRACE-Protokollierung in

WebSphere

:

1. Melden Sie sich an der WebSphere-Verwaltungskonsole an und klicken Sie in der Navigationsstruktur auf Troubleshooting > Logs and Trace. Klicken Sie in der Liste der Server auf server1 und dann auf

Change Log Detail Levels.

2. Wählen Sie Enable Trace aus und geben Sie in das Feld Trace Specification den folgenden Text ein: com.adobe.*=all=enabled:com.adobe.framework.UITools=all=disabled .

[Anwendungsserver-Stammverzeichnis]/profiles/[Profilname]/ logs/[Servername]

Anzeigen der JVM-Systemausgabe- und Fehlerprotokolle

Die JVM-Systemausgabe- und Fehlerprotokolle sind wichtige Hilfsmittel bei der Diagnose von

Serverstörungen.

➤

So zeigen Sie die JVM-Systemausgabe- und Fehlerprotokolle an:

1. Melden Sie sich bei der WebSphere-Verwaltungskonsole an und klicken Sie in der Navigationsstruktur auf Troubleshooting > Logs and Trace.

2. Klicken Sie auf den Namen des Anwendungsservers und anschließend auf JVM Logs.

3. Klicken Sie auf die Registerkarte Runtime und klicken Sie auf View entweder unter „System.out“, um das JVM-Systemausgabeprotokoll anzuzeigen, oder unter „System.err“, um das Fehlerprotokoll anzuzeigen. Wenn diese Wahlmöglichkeiten nicht zur Verfügung stehen, können Sie die Protokolle

über die Registerkarte Configuration anzeigen, indem Sie die Dateinamen SystemOut.log und

SystemErr.log angeben. Der Standardspeicherort der Dateien lautet wie folgt:

[Anwendungsserver-Stammverzeichnis]/profiles/[Profilname]/ logs/[Servername]

➤

So verhindern Sie das Auftreten von Java-Core-Dumps während der EAR-Bereitstellung oder beim

Neustart des Servers:

Stellen Sie sicher, dass JAVA_HOME_32 nur als Umgebungsvariable festgelegt ist und nicht im PFAD enthalten ist.

➤

So verhindern Sie das wiederholte Auftreten von „reindexImpl started“-Fehlermeldungen in den

WebSphere-Serverprotokollen:

Nach der Content Services ES2-Bereitstellung kann es vorkommen, dass die folgende Fehlermeldung in „SystemOut.log“ wiederholt vorkommt:

IndexTransact I org.alfresco.repo.node.index.IndexTransactionTracker reindexImpl reindexImpl started: org.alfresco.repo.node.index.IndexTransactionTracker@290c290c

Adobe LiveCycle ES2

Fehlerbehebung in LiveCycle ES2

Fehlerbehebung bei Installation und Bereitstellung

Löschen der Transaktionsprotokolldatei des Anwendungsservers 30

Um dieses Problem zu beheben, führen Sie die folgenden Schritte aus:

1. (WebSphere 6.1) Klicken Sie in der WebSphere-Navigationsstruktur auf Server > Anwendungsserver.

(WebSphere 7.x) Klicken Sie in der WebSphere-Navigationsstruktur auf Server > Servertypen >

WebSphere-Anwendungsserver.

2. Klicken Sie im rechten Bereich auf einen der Anwendungsserver.

3. Klicken Sie auf Fehlerbehebung > Details zur Protokollierungsstufe ändern.

4. Navigieren Sie in der Liste Komponenten zum Paket org.alfresco.repo.node.index.IndexTransactionTracker

.

5. Klicken Sie auf das Paket org.alfresco.repo.node.index.IndexTransactionTracker

und wählen Sie Keine Protokollierung.

6. Wiederholen Sie die Schritte 1 bis 5 für die Registerkarten Configuration und Runtime und für alle

Knoten in dem Cluster.

➤

So verhindern Sie wiederholte „Failed job“-Fehlermeldungen, die vom Quartz Scheduler stammen:

Wenn Sie den SOAP-Anschluss für irgendeinen Ihrer LiveCycle ES2-Dienste verwenden, kann ein Problem auftreten, das zur Anzeige wiederholter „Failed job“-Fehlermeldungen, die vom Quartz Scheduler stammen, in der WebSphere-Protokolldatei für alle Knoten im Cluster führt.

Diese Fehlermeldungen treten auch noch auf, nachdem der Knoten, der die Anforderung erfüllt hat, heruntergefahren wurde und ein anderer Knoten den Auftrag abgeschlossen hat.

Um dieses Problem zu vermeiden, ändern Sie mithilfe der Verwaltungskonsole die Protokollkonfiguration für alle Knoten im WebSphere-Cluster. Legen Sie die Protokollierungsstufe für die folgenden Pakete auf schwerwiegend fest:

●

● org.quartz.impl.jdbcjobstore

com.adobe.idp.scheduler.jobstore.DSCJobStoreTX

Löschen der Transaktionsprotokolldatei des Anwendungsservers

Wenn die Bereitstellung der Lösungskomponenten aus irgendeinem Grund fehlschlägt, wird der

Anwendungsserver, der als Host für LiveCycle ES2 dient, nicht neu gestartet, da er versucht, die für ihn vermeintlichen rückgängig gemachten Transaktionen wiederherzustellen, was aber fehlschlägt. Um dieses Problem zu beheben, suchen und löschen Sie die Transaktionsprotokolldatei des

Anwendungsservers und starten den Anwendungsserver neu.