bbc Dépannage de LiveCycle ES2 Adobe LiveCycle ES2 Mai 2010 Version 9

Transcription

1 bbc Dépannage de LiveCycle ES2 Adobe LiveCycle ES2 Mai 2010 Version 9

2 2010 Adobe Systems Incorporated and its licensors. All rights reserved. Adobe LiveCycle ES2 (9.0) Troubleshooting LiveCycle ES2 Edition 3.1, May 2010 This guide is licensed for use under the terms of the Creative Commons Attribution Non-Commercial 3.0 License. This License allows users to copy, distribute, and transmit the guide for noncommercial purposes only so long as (1) proper attribution to Adobe is given as the owner of the guide; and (2) any reuse or distribution of the guide contains a notice that use of the guide is governed by these terms. The best way to provide notice is to include the following link. To view a copy of this license, visit Adobe, the Adobe logo, Acrobat, Flash, and LiveCycle are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States and/or other countries. IBM is a trademark of International Business Machines Corporation in the United States, other countries, or both. Red Hat is a registered trademark of Red Hat, Inc. in the United States and other countries. Microsoft, Windows, and Windows Server are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries. Intel and Pentium are trademarks or registered trademark of Intel Corporation or its subsidiaries in the U.S. and other countries. Sun and Java are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries. All other trademarks are the property of their respective owners. Adobe Systems Incorporated, 345 Park Avenue, San Jose, California 95110, USA.

3 Table des matières A propos de ce document... 7 A qui est destiné ce document?... 7 Conventions utilisées dans ce document... 7 Informations complémentaires... 9 Obtenir de l aide Dépannage de l'installation et du déploiement Considérations relatives à l installation...11 Remarques concernant la configuration système requise...11 Problèmes d'espace de répertoire temporaire...11 Performances ralenties des API SharePoint Connector sous Windows Server Limitations de taille de fichier pour le service Output de LiveCycle ES Considérations relatives au serveur d applications...12 Configuration de JBoss pour utiliser un port HTTP qui n'est pas un port par défaut...13 Configuration de mémoire requise pour la configuration de Solaris Considérations à prendre en compte pour l initialisation de la base de données...15 Gestion d un nombre élevé d appels simultanés...15 Considérations sur la sécurité...15 Blocage de XMLForm.exe quand la sécurité de SELinux est en mode «enforcing»...15 Considérations sur la mise à niveau...16 Problème lors de la restauration de LiveCycle ES2 sur un ordinateur portant un autre nom d'hôte...16 Echec du déploiement des fichiers EAR Content Services ES2 sur WebSphere...16 Augmentation des valeurs total transaction lifetime timeout...16 Déploiement des fichiers EAR dans un ordre différent...17 Fichier EAR de Content Services non déployé sur tous les nœuds durant la mise à niveau...17 Mise à niveau incorrecte de certains composants...17 Erreur «Bad version number in.class file» durant la vérification de la base de données...18 Considérations relatives à PDF Generator ES Configuration de PDF Generator ES2 pour la conversion de fichiers MS Office au format PDF...18 Problème connu lors de l'accès à un serveur LiveCycle ES2 sur une session Telnet...18 Résolution de chemins d'accès lors de la conversion de fichiers Excel en fichiers PDF...19 Problèmes d'installation, de configuration et de déploiement...19 Problèmes généraux...19 LiveCycle Configuration Manager ne démarre pas dans l'interface de ligne de commande...19 Problèmes de configuration...19 LiveCycle Configuration Manager maintient l'état pour le pilote incompatible jar sur WebSphere...19 LiveCycle Configuration Manager sélectionne un JDK différent de celui prévu...19 Problèmes de déploiement...20 Erreur lors du déploiement des fichiers EAR...20 Signalement incorrect d'échec de déploiement de fichiers EAR de Content Services ES Déploiement de LiveCycle ES2 dans un environnement distribué...21 Echec de validation du déploiement du module LiveCycle ES2 sur WebSphere

4 Table des matières Dépannage de LiveCycle ES2 4 Erreurs de démarrage/création du déploiement sur Solaris...21 Exhec de validation de la configuration du serveur d'applications lors d'une nouvelle exécution de LiveCycle Configuration Manager...22 Dépannage du serveur d applications...22 Le serveur d applications ne démarre pas JBoss Application Server problèmes...22 Echec du déploiement de Content Services ES2 après un redémarrage du serveur JBoss...22 WebLogic Server problèmes...23 Blocage de LiveCycle Configuration Manager lors du redéploiement d'un fichier EAR...23 WebSphere Application Server problèmes...23 Problèmes lors de la suppression de l'arborescence du répertoire sur WebSphere...23 OutOfMemory PermGen space error (WebSphere sur Solaris)...24 Arrêt de réponse du serveur d'applications (WebSphere et DB2 sur AIX)...24 Exception NullPointerException lors de l'accès à Contentspace ES Dépannage de la base de données LiveCycle ES Paramètres de configuration d IBM DB Dépannage avec des fichiers journaux...25 Fichier journal de LiveCycle ES Fichier journal de LiveCycle Configuration Manager...25 Dépannage de votre serveur d applications avec les fichiers journaux...26 Fichier journal de JBoss...26 Fichier journal de WebLogic...28 Fichier journal de WebSphere...28 Suppression du fichier journal de transaction du serveur d applications Dépannage des tâches d'administration Problèmes d ouverture de session...31 Accès à la page Services dans LiveCycle Administration Console sur JBoss...33 Affichage des pages de connexion même après une authentification SSO...33 Exemple de résolution avec SiteMinder...33 Considérations relatives aux performances...33 Amélioration des performances durant une invocation de service asynchrone...34 Echec de l'invocation à distance avec de serveurs d'applications dans un environnement IPv6 pur...34 Amélioration des performances de Windows Server avec LDAP...34 Configuration du service de programmation pour les URL JNDI autres que les URL par défaut...35 JBoss...35 WebSphere...36 WebLogic...36 Problème de performances et de journalisation excessive d'api FileNet sur WebLogic...37 Erreurs sporadiques de mémoire insuffisante avec WebLogic/JRockit...38 Problèmes de désinstallation...38 Suppression de services, dossiers et fichiers JBoss/MySQL...38 Mode clé en main désactivé suite à une installation ou à une désinstallation incomplète...38 Dépannage des erreurs de sortie...39 Certains fichiers de sortie ne sont pas convertis depuis un dossier de contrôle...39 Diagnostic des problèmes liés au cache...39 Perte de certains fichiers de sortie lorsqu un WebSphere Application Server organisé en grappe s arrête...40 Erreur de chiffrement du mot de passe...40 Filigrane orange indésirable dans la sortie PDF...40

5 Table des matières Dépannage de LiveCycle ES2 5 Erreur «No transaction» suite à la conversion de plusieurs assemblages 3D...41 Possibilité d'interférence du cache du navigateur avec le rendu HTML...43 Erreur «Failure to create directory» sous Windows...43 Erreur «Error while converting image to pdf» sous Windows...43 Echec de la conversion de fichiers OpenOffice.org au format PDF sous Solaris...44 Erreur «Content URL 404 error» lors de l utilisation d un modèle dans LiveCycle Contentspace ES Police Bell Gothic écartée dans LiveCycle ES2 et Designer ES Erreur «Cannot retrieve the resource from Repository Path» lors d'une génération de fichier PDF réussie...46 Erreurs diverses...46 Echec du déploiement de adobe-livecycle-websphere.ear...46 Fonctionnalités de modèle d'application indisponibles...47 Perte du paramètre de niveau pour l'option HTML to PDF...47 Messages d'erreur en anglais au lieu de chaînes localisées dans certains écrans...47 Exception dans le journal du serveur lors de la suppression d'applications Dépannage des messages d'erreur Messages d'erreur du fichier journal de LiveCycle ES Messages d erreur généraux...48 OutOfMemoryError...48 Plus de threads disponibles...48 Threads et allocation de mémoire...49 Exécution du service Document Management pour Content Services ES2 sur du matériel de base Fichier introuvable...52 Classe introuvable...52 nom JNDI introuvable...52 Messages d erreur JBoss Application Server...53 Problème d'objet org.jboss.logging.appender.fileappender...53 Apparition de messages IBM FileNet dans le fichier journal de JBoss Application Server...53 Messages d erreur WebLogic Server...53 Erreur de délai d'expiration JTA de WebLogic...53 Erreur de déploiement d'adobe-livecycle-weblogic.ear...54 Erreur de déploiement due à une erreur de l'espace PermGen...54 Erreur de déploiement des modules de LiveCycle ES2 sous WebLogic/Windows...54 Messages d erreur WebSphere Application Server...55 Erreur de déploiement du fichier adobe-livecycle-websphere.ear...55 Messages d avertissement J2CA0294W...55 Messages de journal détaillés dans l'installation de WebSphere...55 Non-déploiement du fichier adobe-livecycle-websphere.ear dans une version 64 bits de WebSphere Messages SystemOut superflus au cours du déploiement du module LiveCycle ES2 dans WebSphere Exception : No trusted certificate found...57 Exception Java NameNotFoundException...58 Exception inattendue durant l'invocation de convention DSC...58 Messages d erreur de base de données...59 Exceptions connues liées à des initialisations multiples de la base de données...59 Erreur MySQL «Too many connections»...59 J2CA0081E : Method cleanup error on SQL Server...59

6 Table des matières Dépannage de LiveCycle ES2 6 Echec d'initialisation de la base de données sur WebLogic...59 Problèmes de mémoire sur le serveur DB Messages d erreur LiveCycle ES Messages d'erreur de sortie...60 Echec de la conversion de fichiers natifs sur JBoss/Windows...60 Echec de la conversion de fichiers HTML sur JBoss/Windows...61 Erreur d'autorisation XMLForm.exe sous UNIX ou Linux...61 Erreur de fin de fichier inattendue sur WebLogic...61 Messages d'erreur côté client...61 Exception CORBA COMM_FAILURE sur WebLogic/Solaris...61 Messages d erreur divers...62 Localisateur déjà en cours d'exécution...62 com.adobe.idp.documenterror...62 IDPSchedulerService n'est pas en état RUNNING...63

7 A propos de ce document Ce document contient des informations sur le dépannage de nombreux problèmes d'installation, de configuration et d'administration qui peuvent se produire avec un environnement de production Adobe LiveCycle ES2 (Enterprise Suite) version 9.0. A qui est destiné ce document? Ce guide propose des informations aux administrateurs et aux développeurs chargés d installer, de configurer, d administrer ou de déployer des composants LiveCycle ES2. Les informations fournies s adressent donc à un public familiarisé avec les serveurs d applications J2EE, les systèmes d exploitation Linux, Microsoft Windows, AIX ou Solaris, les serveurs de base de données MySQL, Oracle, DB2 ou SQL Server, ainsi que les environnements Web. Conventions utilisées dans ce document Ce document utilise les conventions de désignation ci-après pour les chemins d accès aux fichiers courants. Nom Description Valeur par défaut [racine de LiveCycle ES2] [racine LiveCycle8x] [racine JBossES2] [ACCUEIL_JAVA_Adobe] Répertoire d installation utilisé pour tous les modules de LiveCycle ES2. Ce répertoire contient les sous-répertoires d'adobe LiveCycle Configuration Manager, de LiveCycle ES2 SDK et de chaque module de LiveCycle ES2 installé (avec sa documentation). Il comprend également les sous-répertoires associés aux technologies tierces. Répertoire d installation utilisé pour tous les composants de la solution LiveCycle ES (8.x) version 8.0 ou 8.2. (JBoss clé en main) Répertoire racine du serveur d'applications exécutant LiveCycle ES2. (JBoss clé en main) Répertoire racine du JDK Java installé lors de l'installation de LiveCycle ES2 clé en main. Windows : C:\Adobe\Adobe LiveCycle ES2\ Linux et UNIX : /opt/adobe/adobe livecycle es2/ C:\Adobe\LiveCycle ES\ (pour version 8.0) ou C:\Adobe\LiveCycle8.2 (pour version 8.2) C:\Adobe\Adobe LiveCycle ES2\jboss C:\Adobe\Adobe LiveCycle ES2\Java 7

8 A propos de ce document Dépannage de LiveCycle ES2 Conventions utilisées dans ce document 8 Nom Description Valeur par défaut [racine du serveur d applications] WL_HOME [domaine du serveur d applications] [racine du serveur de base de données] Répertoire racine du serveur d applications exécutant les services LiveCycle ES2. Répertoire d installation de WebLogic spécifié pour la variable d environnement WL_HOME. Domaine configuré sur WebLogic. Le domaine par défaut est appelé base_domain. Emplacement d installation du serveur de base de données LiveCycle ES2. JBoss sous Windows : C:\jboss JBoss sous Linux, Solaris : /opt/jboss WebSphere sous Windows : C:\Program Files\IBM\WebSphere\AppServer WebSphere sous Linux et Solaris : /opt/ibm/websphere/appserver WebSphere sous AIX : /usr/ibm/websphere/appserver ou /opt/ibm/websphere/appserver WebLogic sous Windows : C:\bea\wlserver_10.3 WebLogic sous Linux et UNIX : /bea/wlserver_10.3 WebLogic sous Windows C:\bea WebLogic sous Linux et UNIX : /opt/bea WebLogic sous Windows : C:\bea\user_projects\domains\base_domain WebLogic sous Linux et UNIX : /opt/bea/user_projects/domains/base_domain Dépend du type de base de données et de vos spécifications lors de l installation.

9 A propos de ce document Dépannage de LiveCycle ES2 Informations complémentaires 9 Informations complémentaires Les ressources indiquées dans le tableau ci-dessous peuvent vous aider à connaître LiveCycle ES2. Pour plus de détails sur LiveCycle ES2, les composants de la solution et les outils de développement Préparation de l'environnement pour l'installation et la mise à niveau vers LiveCycle ES2 Installation de LiveCycle ES2 (serveur unique) Configuration de LiveCycle ES2 (grappe de serveurs) Mise à niveau vers LiveCycle ES2 à l aide d une méthode non clé en main Installation de LiveCycle Workbench ES2 Exécution des tâches administratives générales pour LiveCycle ES2 Les autres services et produits qui s intègrent àlivecyclees2 Mises à jour des correctifs, notes techniques et informations complémentaires sur cette version du produit Terminologie de LiveCycle ES2 Voir LiveCycle ES2 Présentation Préparation à l installation de LiveCycle ES2 (serveur unique) Préparation à l'installation LiveCycle ES2 (grappe de serveurs) Préparation à la mise à niveau vers LiveCycle ES2 Installation et déploiement de LiveCycle ES2 à l'aide de la procédure clé en main Installation et déploiement de LiveCycle ES2 pour JBoss Installation et déploiement de LiveCycle ES2 pour WebSphere Installation et déploiement de LiveCycle ES2 pour WebLogic Configuration de grappes du serveur d applications LiveCycle ES2 à l aide de JBoss Configuration de grappes du serveur d applications LiveCycle ES2 à l aide de WebLogic Configuration de grappes du serveur d applications LiveCycle ES2 à l aide de WebSphere Mise à niveau vers LiveCycle ES2 à partir de 8.x (pour JBoss Clé en main) Mise à niveau vers LiveCycle ES2 pour JBoss Mise à niveau vers LiveCycle ES2 pour WebLogic Mise à niveau vers LiveCycle ES2 pour WebSphere Installation de l'environnement de développement Aide à l'administration d Adobe LiveCycle ES2 Adobe LiveCycle ES2 Centre de support LiveCycle LiveCycle ES2 Glossaire

10 A propos de ce document Dépannage de LiveCycle ES2 Obtenir de l aide 10 Obtenir de l aide Cette section décrit la procédure à suivre avant de contacter le service d assistance aux entreprises d Adobe. Si vous n avez pas réussi à corriger les éventuels problèmes à l aide de la documentation de LiveCycle ES2, contactez le service d assistance aux entreprises d Adobe. Pour faciliter le traitement de votre demande, préparez les informations suivantes : Quelles actions exécutiez-vous lorsque le problème est survenu? Pouvez-vous reproduire le problème? Des messages d erreur se sont-ils affichés lorsque le problème est survenu? D autres éléments ont-ils retenu votre attention? Le problème persiste-t-il une fois que vous avez désactivé l option Afficher des messages d erreur HTTP simplifiés dans Internet Explorer (Outils > Options Internet > Avancés)?

11 1 Dépannage de l'installation et du déploiement Cette section présente différents problèmes susceptibles de survenir lors de l installation et du déploiement de LiveCycle ES2, de même que des procédures à exécuter pour éviter ou corriger ces problèmes. «Considérations relatives à l installation», page 11 «Remarques concernant la configuration système requise», page 11 «Considérations relatives au serveur d applications», page 12 «Considérations à prendre en compte pour l initialisation de la base de données», page 15 «Considérations sur la sécurité», page 15 «Considérations sur la mise à niveau», page 16 «Problèmes d'installation, de configuration et de déploiement», page 19 «Dépannage avec des fichiers journaux», page 25 Considérations relatives à l installation Si des problèmes surviennent lors de l installation, de la configuration ou du déploiement de LiveCycle ES2, vérifiez que vous avez suivi les instructions présentées dans les documents sur LiveCycle ES2 répertoriés dans la section «Informations complémentaires», page 9. Si vous avez effectué l installation et la configuration conformément aux instructions présentées dans la documentation et pour plus de détails sur des problèmes semblables à ceux que vous rencontrez, consultez les sections suivantes. Voir aussi «Problèmes d'installation, de configuration et de déploiement», page 19 «Dépannage des messages d'erreur», page 48 Remarques concernant la configuration système requise Problèmes d'espace de répertoire temporaire Le programme d'installation de LiveCycle ne peut pas opérer sur un système n'ayant pas d'espace disponible dans le répertoire temporaire du système. Dans ce cas, un message d'erreur s'affiche dans la fenêtre de la console, indiquant que l'espace disponible dans le répertoire /tmp est insuffisant. Pour éviter ce problème, assurez-vous que l'espace disponible dans le répertoire temporaire est suffisant. Pour plus d'informations sur la configuration système requise, reportez-vous à la section Préparation à l'installation de LiveCycle ES2 (serveur unique). 11

12 Dépannage de l'installation et du déploiement Dépannage de LiveCycle ES2 Performances ralenties des API SharePoint Connector sous Windows Server Performances ralenties des API SharePoint Connector sous Windows Server 2008 Si LiveCycle ES2 est déployé sous Windows Server 2008, et que le serveur SharePoint avec lequel il communique est hébergé sur un ordinateur 64 bits Windows, les appels API SharePoint Content Repository Connector transmis par Workbench ES2 ou LiveCycle ES2 SDK présentent des performances ralenties. Pour éviter ce problème, désactivez le réglage automatique de la fenêtre de réception TCP ou paramétrez son niveau à highlyrestricted sur le serveur LiveCycle ES2. Utilisez l une des commandes suivantes : netsh interface tcp set global autotuninglevel=disabled netsh interface tcp set global autotuninglevel=highlyrestricted Voir la base de connaissances Microsoft pour plus d'informations. Limitations de taille de fichier pour le service Output de LiveCycle ES2 Pour générer des fichiers volumineux sur des systèmes UNIX à l'aide du service Output de LiveCycle ES2, vous devez définir la limite supérieure de taille de fichier sur une valeur supérieure ou égale à la taille du fichier en cours de génération. Pour éviter des erreurs lors de la génération de documents PDF à partir de fichiers volumineux, modifiez la valeur de fsize dans /etc/security/limits sur les systèmes UNIX en une valeur suffisamment importante pour couvrir toutes les tailles de fichier. Considérations relatives au serveur d applications Vérifiez les paramètres suivants du serveur d applications avant de contacter le service d assistance aux entreprises d Adobe : Délai d expiration de transaction total : 300 Taille initiale du segment de mémoire : 256 Taille maximum du segment : Mo Cache de déclaration préparée : 100 Nombre maximum de pools de connexion à la base de données : IDP_DS a pour valeur 30 RM_DS a pour valeur 20 La base de métadonnées BAM est 20 Nombre minimum de pools de connexion à la base de données : IDP_DS a pour valeur 1 RM_DS a pour valeur 1 Nombre maximum de connexions de pools de connexion : 50

13 Dépannage de l'installation et du déploiement Dépannage de LiveCycle ES2 Configuration de JBoss pour utiliser un port HTTP qui n'est pas un port par défaut 13 Voir aussi «Dépannage des messages d'erreur», page 48 Configuration de JBoss pour utiliser un port HTTP qui n'est pas un port par défaut JBoss Application Server utilise 8080 comme port HTTP par défaut. JBoss possède également des ports 8180, 8280 et 8380 préconfigurés ; ils sont mis en commentaires dans le fichier jboss-service.xml. Si vous possédez sur votre ordinateur une application qui utilise déjà ce port, vous devez modifier celui qui est utilisé par LiveCycle ES2 comme suit : 1. Ouvrez le fichier jboss-service.xml dans un éditeur. installation de JBoss clé en main : [racine JBossES2]/server/lc_turnkey/conf/ installation manuelle de JBoss : [racine serveur d'applications]/server/all/conf/ 2. Recherchez et annulez la mise en commentaire du mbean suivant : <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. Enregistrez le fichier, puis fermez-le. 4. Redémarrez JBoss. JBoss est maintenant configuré pour utiliser le port Si vous souhaitez utiliser les ports 8280 ou 8380, modifiez la valeur de l'attribut ServerName pour utiliser l'un des ports suivants : Pour 8280 : ports-02 Pour 8380 : ports-03 Si vous souhaitez configurer un numéro de port différent de ceux qui sont préconfigurés pour JBoss, exécutez les étapes suivantes : 1. Recherchez et ouvrez le fichier deploy/jboss-web.deployer dans [racine JBossES2] (clé en main) ou [racine serveur d'applications] (installation manuelle de JBoss). 2. Recherchez et annulez la mise en commentaire du mbeam comme décrit dans l'étape 2 ci-dessus. 3. Remplacez la valeur du ServerName par le numéro de port à utiliser. 4. Enregistrez le fichier, puis fermez-le. 5. Redémarrez JBoss.

14 Dépannage de l'installation et du déploiement Dépannage de LiveCycle ES2 Configuration de mémoire requise pour la configuration de Solaris Configuration de mémoire requise pour la configuration de Solaris 10 Pour éviter des problèmes de type StuckThread sur un environnement Solaris, configurez la mémoire comme suit : Augmentez ou réduisez les valeurs de rlim dans le fichier /etc/system. Augmentez l'espace d'échange à au moins deux fois le volume de la RAM. Modifiez les valeurs rlim : 1. recherchez et ouvrez le fichier /etc/system. 2. Localisez et modifiez les valeurs rlim comme suit : set rlim_fd_cur: nombre maximal initial (logique) de descripteurs de fichier par processus. Définissez cette valeur sur 8192 ou plus. set rlim_fd_max: nombre maximal (physique) de descripteurs de fichier par processus. Définissez cette valeur sur 8192 ou plus. (Cette modification n'est requise que si la valeur par défaut est inférieure à 8192). Pour pouvoir modifier cette valeur, vous devez disposer de droits de superutilisateur. Remarque : La valeur rlim_fd_max doit être égale ou supérieure à la valeur rlim_fd_cur. 3. Enregistrez le fichier, puis fermez-le. 4. Redémarrez l ordinateur. Ajoutez de l'espace d'échange : 1. Augmentez l'espace d'échange de façon à ce que la limite totale de celui-ci dépasse le double de la quantité totale de RAM. Par exemple, si vous avez 8 Go de RAM, configurez l'espace d'échange sur une valeur supérieure à 16 Go. (Reportez-vous à la rubrique tech tip sur le portail de la communauté Sun.) 2. Redémarrez l ordinateur si nécessaire. Vérifiez les paramètres mis à jour : 1. Lancez un nouvel interpréteur de commandes. 2. Saisissez ulimit -n, puis appuyez sur Entrée. 3. Vérifiez que la valeur retournée correspond aux valeurs rlim que vous avez définies. 4. Saisissez swap -s, puis appuyez sur Entrée. 5. Vérifiez que la valeur retournée correspond à la nouvelle valeur d'espace d'échange. Si l'une des valeurs ne correspond pas aux paramètres mis à jour, assurez-vous que vous avez exécuté les étapes décrites, puis redémarrez votre ordinateur.

15 Dépannage de l'installation et du déploiement Dépannage de LiveCycle ES2 Considérations à prendre en compte pour l initialisation de la base de données 15 Considérations à prendre en compte pour l initialisation delabasededonnées Si des problèmes surviennent lors de l initialisation du serveur LiveCycle ES2, vérifiez ce qui suit : Le nom des instances de la base de données ne doit contenir que des caractères alphanumériques. (Linux et UNIX) Vérifiez que les noms des instances de base de données ne contiennent pas plus de 8 caractères (limitation spécifique à la plate-forme). En cas d échec de l initialisation au début du processus, vérifiez ce qui suit : (Installation non clé en main) Vérifiez que la base de données LiveCycle ES2 est créée et que l utilisateur dispose de droits complets sur celle-ci. Le serveur de la base de données est accessible lorsque vous exécutez une requête ping sur ce serveur. La base de données est vide, c est-à-dire qu elle ne contient aucune table, séquence, vue ou table d index. Le nom JNDI de IDP_DS est créé. En cas d échec de l initialisation lors de l écriture dans le registre, vérifiez la présence éventuelle d erreurs liées aux files d attente et aux sujets dans les journaux du serveur d applications. Si des erreurs sont répertoriées, vérifiez que les files d attente et les sujets sont correctement configurés. (Reportez-vous au guide Installation et déploiement de LiveCycle ES2 correspondant à votre serveur d applications.) Voir aussi «Messages d erreur de base de données», page 59 Gestion d un nombre élevé d appels simultanés Un nombre élevé d'appels simultanés peut avoir une incidence négative sur les performances de base de données. Pour éviter une dégradation des performances, augmentez la taille maximale de pool de connexions pour la source de données (IDP_DS) de façon à ce qu'elle soit supérieure au nombre prévu (ou réel) d'appels simultanés. Considérations sur la sécurité Blocage de XMLForm.exe quand la sécurité de SELinux est en mode «enforcing» Vous pouvez rencontrer des problèmes lors de l'exécution de LiveCycle ES2 sur un serveur où NSA Security Enhanced Linux (SELinux) est en mode enforcing. Avec cette configuration, un processus LiveCycle ES2 invoquant XMLForm.exe ne fonctionnera pas Les utilisateurs ne sont pas en mesure d'ouvrir le formulaire associé dans LiveCycle Workspace ES2 et un message d'erreur similaire à celui ci-après est consigné dans le fichier journal de votre serveur d'applications : Service XMLFormService: Process ProcessResource(name=XMLForm.exe,pid=0) terminated abnormally with error code {3} Pour corriger ce problème, réglez la sécurité SELinux en mode permissive.

16 Dépannage de l'installation et du déploiement Dépannage de LiveCycle ES2 Considérations sur la mise à niveau 16 Considérations sur la mise à niveau Problème lors de la restauration de LiveCycle ES2 sur un ordinateur portant un autre nom d'hôte Les processus LiveCycle 8.x importés peuvent utiliser une variable Document Form et le service Submit PDF Form. Pour de tels processus, les utilisateurs ne sont pas en mesure de soumettre un formulaire pour exécuter une tâche dans les circonstances suivantes : 1. Le processus est démarré, puis une sauvegarde de la base de données et du stockage global de documents est effectuée. 2. LiveCycle ES2 est restauré sur un autre ordinateur portant un autre nom d'hôte. Dans le répertoire de stockage global de documents (GDS), le dossier «backup» est renommé «restore», puis la base de données est restaurée. 3. L'utilisateur soumet le formulaire dans Workspace. Lorsque l'utilisateur soumet le formulaire, une boîte de dialogue d'avertissement de sécurité affiche le message suivant : «This document has accessed more than one site and might be trying to share data among different locations. This could be a privacy concern. Are you sure you want to continue?» Si l'utilisateur clique sur Oui, le message d'erreur suivant s'affiche : «This page cannot be displayed». Pour éviter ce problème, utilisez le même nom d'hôte lors de la restauration de LiveCycle ES2 à partir d'une sauvegarde. Echec du déploiement des fichiers EAR Content Services ES2 sur WebSphere Lors de la mise à niveau à partir de LiveCycle x vers LiveCycle ES2, le déploiement des fichiers EAR Content Services ES2 risque de ne pas aboutir si l'utilisation des ressources du serveur d'applications est élevée. Le message d'erreur suivant peut s'afficher : SchemaBootstr E org.alfresco.util.logutil error Schema auto-update failed org.alfresco.error.alfrescoruntimeexception: A previous schema upgrade failed or was not completed. Revert to the original database before attempting the upgrade again. Pour résoudre ce problème, procédez comme suit. Augmentation des valeurs total transaction lifetime timeout 1. (WebSphere 6.x) Dans la WebSphere Administrative Console, cliquez sur Servers > Application servers et cliquez sur le nom du serveur. (WebSphere 7.x) Dans la WebSphere Administrative Console, cliquez sur Servers > Server Types > application servers WebSphere, puis cliquez sur le nom du serveur. 2. Cliquez sur Container Settings > Container Services > Transaction Service. 3. Dans l'onglet Configuration, définissez la valeur du paramètre Total transaction lifetime timeout à 900 secondes.

17 Dépannage de l'installation et du déploiement Dépannage de LiveCycle ES2 Fichier EAR de Content Services non déployé sur tous les nœuds durant la mise à niveau Cliquez sur Apply ou sur OK. 5. Redémarrez le serveur d applications. Déploiement des fichiers EAR dans un ordre différent Relancez la mise à niveau. Maintenant, dans LiveCycle Configuration Manager, déployez le fichier EAR Content Services ES2 avant de déployer les autres fichiers EAR. 1. Sur l'écran Deploy LiveCycle ES2 EARs, sélectionnez adobe-contentservices.ear, puis cliquez sur Deploy. 2. Une fois le déploiement du fichier EAR de Content Services ES2 réussi, désélectionnez adobe-contentservices.ear, sélectionnez les autres fichiers EAR, puis cliquez sur Deploy. Fichier EAR de Content Services non déployé sur tous les nœuds durant la mise à niveau Lors d'une mise à niveau vers Content Services ES2 à partir de LiveCycle ES version 8.2 sur une grappe, le fichier EAR de Content Services ES2 est déployé uniquement sur le premier nœud de la grappe. Les deux solutions suivantes permettent de résoudre ce problème, mais chacune présente des inconvénients. Examinez chaque solution pour choisir la meilleure solution pour votre environnement. Durant la mise à niveau, lors de la configuration du fichier EAR de Content Services ES2 à l'aide de LiveCycle Configuration Manager, pointez le répertoire racine d'index pour LiveCycle ES2 sur un emplacement différent de ce qui a été spécifié pour version 8.2. Cette solution permet de démarrer tous les nœuds de la grappe directement à partir de LiveCycle Configuration Manager. Remarque : Avec cette option, le serveur LiveCycle ES2 peut mettre du temps à démarrer si une quantité importante de contenu est enregistrée dans le référentiel de Content Services ES2. C'est pourquoi chaque nœud de la grappe tente de recréer les index. Lors du déploiement de fichiers EAR, assurez-vous qu'un seul des nœuds de la grappe est démarré et spécifiez uniquement les détails relatifs à ce nœud durant l'entièreté du processus de mise à niveau. Cette étape garantit que le serveur LiveCycle ES2 met uniquement à jour les index au lieu de les recréer. Après le démarrage du nœud, copiez manuellement le répertoire d'index de celui-ci vers les autres nœuds de la grappe où vous avez l'intention d'exécuter LiveCycle Configuration Manager. A présent, démarrez les autres nœuds de la grappe. Le fichier EAR de Content Services ES2 sera ensuite déployé avec succès sur tous les nœuds de grappe. Remarque : Bien que la mise en œuvre de cette solution prenne du temps, elle garantit un temps d'indisponibilité minimal du serveur au démarrage. Mise à niveau incorrecte de certains composants Si une mise à niveau à partir de LiveCycle 8.x vers LiveCycle ES2 n'aboutit pas pour quelque raison que ce soit, certains composants risquent de ne pas être mis à niveau correctement lors d'une mise à niveau ultérieure même si vous avez rétabli votre installation à un état antérieur à la mise à niveau. Par exemple : Reader Extensions ES2. Pour résoudre ce problème, vous devez supprimer le fichier shareddata dans le répertoire <racine de LiveCycle ES2>/configurationManager/working/upgrade avant de relancer la mise à niveau.

18 Dépannage de l'installation et du déploiement Dépannage de LiveCycle ES2 Erreur «Bad version number in.class file» durant la vérification de la base de données 18 Cette étape s'ajoute au rétablissement des entités suivantes vers l'état antérieur à la mise à niveau avant la nouvelle tentative de mise à niveau : Base de données lccs_data Répertoire de stockage global de documents Autres dossiers concernés Erreur «Bad version number in.class file» durant la vérification de la base de données (Base de données Oracle uniquement) Lors de la mise à niveau vers la plateforme LiveCycle ES2 utilisant JDK 1.5 qui se connecte à une base de données Oracle, vous devez utiliser le fichier ojdbc5.jar. Si le fichier ojdbc6.jar (par défaut) est utilisé, le message d'erreur «Bad version number in.class file» s'affiche lors de la vérification de la connexion à la base de données dans l'écran LiveCycle ES2 Database. Si ce message d'erreur s'affiche, fermez LiveCycle Configuration Manager, puis redémarrez-le. Dans l'écran LiveCycle ES2 Database, indiquez le fichier ojdbc5.jar. Remarque : Sur une plate-forme LiveCycle ES2 utilisant JDK 1.6, vous pouvez saisir le pilote de base de données comme fichier ojdbc5.jar ou ojdbc6.jar. Considérations relatives à PDF Generator ES2 Les rubriques suivantes traitent des problèmes rencontrés avec PDF Generator ES2 et de leur résolution. Configuration de PDF Generator ES2 pour la conversion de fichiers MS Office au format PDF Il est connu que sur certains serveurs LiveCycle ES2, une stratégie d autorisation DCOM doit être modifiée afin d utiliser PDF Generator ES2 pour la conversion de fichiers d applications Microsoft Office. Si vous ne modifiez pas cette stratégie, le message d erreur suivant apparaît : INFO [STOUT] com.jniwrapper.win32.com.comexception: COM object method returns error code: 0x ; E_FAIL (Unspecified error) Les étapes requises sont répertoriées dans un article de la base de connaissances Microsoft disponible sur le site Aide et support Microsoft. Problème connu lors de l'accès à un serveur LiveCycle ES2 sur une session Telnet Les conversions de format natif en PDF échouent avec affichage d'un message d'erreur lorsque vous accédez à un serveur LiveCycle ES2 en cours d'exécution sous Windows Server 2008 à l'aide du service Telnet et démarrez le serveur d'applications à l'aide d'un script de commandes. Pour éviter ce problème, démarrez le service Telnet en activant l'option Autoriser le service à interagir avec le bureau. Vous pouvez activer cette option lorsque vous modifiez les propriétés du panneau Services dans Windows Server 2008.

19 Dépannage de l'installation et du déploiement Dépannage de LiveCycle ES2 Résolution de chemins d'accès lors de la conversion de fichiers Excel en fichiers PDF 19 Résolution de chemins d'accès lors de la conversion de fichiers Excel en fichiers PDF Lorsque vous utilisez LiveCycle PDF Generator ES2 pour convertir un fichier Excel en fichier PDF, et que le fichier Excel contient une fonction de chemin d'accès et de nom de fichier (&[Path]&[File]) dans son en-tête ou son pied de page, des résultats inattendus peuvent se produire. Lors de la conversion du fichier, PDF Generator ES2 copie ce dernier dans un emplacement temporaire sur le serveur LiveCycle ES2 et effectue la conversion sur cette copie. Par conséquent, les fonctions de chemin d'accès et de nom de fichier du document Excel résolvent l'emplacement et le nom du fichier temporaire, et ces valeurs apparaissent dans le fichier PDF généré. Problèmes d'installation, de configuration et de déploiement Problèmes généraux LiveCycle Configuration Manager ne démarre pas dans l'interface de ligne de commande Cette erreur se produit lorsque vous n'avez pas défini la variable d'environnement ADOBE_JAVA_HOME. Pour garantir une installation réussie, veillez toujours à ce que les paramètres obligatoires soient définis avant de lancer le programme d'installation et LiveCycle Configuration Manager. Problèmes de configuration LiveCycle Configuration Manager maintient l'état pour le pilote incompatible jar sur WebSphere Si un fichier.jar incompatible est spécifié dans le champ Pilote JDBC dans la bibliothèque du serveur d'applications de l'écran Configuration de la source de données, l'emplacement du fichier.jar correct ne peut être spécifié qu'après le démarrage de LiveCycle Configuration Manager. ojdbc5.jar est le fichier.jar correct pour WebSphere 6.x, et ojdbc6.jar est le fichier.jar correct pour WebSphere 7.x. LiveCycle Configuration Manager sélectionne un JDK différent de celui prévu Si des JDK de plusieurs éditeurs sont installés sur votre système, LiveCycle Configuration Manager risque de sélectionner un JDK différent de celui spécifié dans la variable d'environnement PATH. Pour résoudre ce problème, lancez LiveCycle Configuration Manager à l'aide de ConfigurationManager.bat au lieu de ConfigurationManager.exe. Conseil : Vous pouvez examiner les journaux de LiveCycle Configuration Manager pour vous assurer qu'il utilise le JDK approprié.

20 Dépannage de l'installation et du déploiement Dépannage de LiveCycle ES2 Problèmes de déploiement 20 Problèmes de déploiement Erreur lors du déploiement des fichiers EAR Selon les services LiveCycle ES2 installés et votre configuration système, vous pouvez recevoir des erreurs lors du déploiement des fichiers EAR. Dans ce cas, augmentez la valeur MaxPermSize de votre serveur d'applications de 256 à 512. Pour obtenir des instructions sur la définition de cette valeur sur votre serveur d'applications, reportez-vous au document Préparation à l'installation de LiveCycle ES2. Par exemple, dans WebLogic, vous pouvez modifier le paramètre MaxPermSize ici : C:\bea\user_projects\domains\base_domain\bin\setDomainEnv.cmd Signalement incorrect d'échec de déploiement de fichiers EAR de Content Services ES2 Durant l'installation de LiveCycle ES2 ou une mise à niveau vers cette version, si le système est lent ou soumis à une charge importante, LiveCycle Configuration Manager signale erronément un échec du déploiement des fichiers EAR de Content Services ES2. Cela peut se produire lors de l'installation de LiveCycle ES2 ou de la mise à niveau de LiveCycle de 8.x vers LiveCycle ES2. En outre, les journaux de LiveCycle Configuration Manager contiennent le message d'erreur suivant : «Failed to make SOAP RPC call: invoke». En raison de ce signalement d'erreur incorrect, les fichiers EAR de LiveCycle Workspace ES2 ne sont pas déployés et vous ne pouvez pas passer à l'étape suivante dans LiveCycle Configuration Manager. Si ce message d'erreur s'affiche, procédez comme suit : 1. Vérifiez dans la documentation que le délai de demande SOAP est correctement défini. Consultez la section Configuration des paramètres de délai d expiration de WebSphere du guide Installation et déploiement de LiveCycle ES2 pour WebSphere ou Mise à niveau vers LiveCycle ES2 à partir de 8.x pour WebSphere. 2. Dans WebSphere Administrative Console, vérifiez si le fichier EAR de Content Services ES2 est correctement déployé et en cours d'utilisation. Si vous déterminez que le fichier EAR de Content Services ES2 est correctement déployé, procédez comme suit : Dans LiveCycle Configuration Manager, désélectionnez les fichiers EAR déjà déployés et en cours d'exécution, puis ne sélectionnez que les fichiers EAR non encore déployés (en l'occurrence adobe-workspace-client.ear), puis cliquez sur Déployer. Déployez le fichier EAR de Workspace ES2 (adobe-workspace-client.ear) manuellement à partir de WebSphere Administrative Console. Une fois cette étape exécutée, exécutez de nouveau LiveCycle Configuration Manager, puis sélectionnez les tâches qui suivent le déploiement des fichiers EAR dans LiveCycle Configuration Manager. Remarque : Si LiveCycle Configuration Manager échoue à déployer des fichiers EAR, vous pouvez les déployer manuellement à partir de la console d'administration de votre serveur d'applications. Suivez cette présentation générale pour déployer manuellement les fichiers EAR et poursuivre les tâches de configuration dans LiveCycle Configuration Manager : Déployez manuellement les fichiers EAR requis à partir de la console d'administration de votre serveur d'applications.

21 Dépannage de l'installation et du déploiement Dépannage de LiveCycle ES2 Problèmes de déploiement 21 Fermez l'instance LiveCycle Configuration Manager actuellement en cours d'exécution. Lancez de nouveau LiveCycle Configuration Manager, puis sélectionnez les tâches qui suivent le déploiement des fichiers EAR que vous avez lancé manuellement. Déploiement de LiveCycle ES2 dans un environnement distribué Si l'instance de serveur d'applications (WebSphere) ou de Managed Server (WebLogic) se trouve sur un serveur autre que celui exécutant Deployment Manager (WebSphere) ou Admin Server (WebLogic), vous devez déployer manuellement les fichiers EAR de LiveCycle ES2. Si vous tentez d effectuer le déploiement avec LiveCycle Configuration Manager, un message d erreur s affiche, indiquant que le déploiement aéchoué. Si cette erreur survient lorsque vous utilisez LiveCycle Configuration Manager pour déployer les fichiers EAR, exécutez la procédure suivante. Pour déployer les fichiers EAR de LiveCycle ES2 : 1. Quittez LiveCycle Configuration Manager. 2. Déployez manuellement les fichiers EAR. (Reportez-vous au chapitre «Déploiement manuel» du guide Installation et déploiement de LiveCycle ES2 pour votre serveur d'applications.) 3. Exécutez LiveCycle Configuration Manager et ne sélectionnez les tâches qu après le déploiement des fichiers EAR de LiveCycle ES2. Echec de validation du déploiement du module LiveCycle ES2 sur WebSphere Au cours d une configuration manuelle de WebSphere pour LiveCycle ES2, le message d'erreu suivante peut apparaître : Component deployment failed validation. Cannot connect to server container Dans ce cas, exécutez la procédure suivante. Pour augmenter les valeurs de délai d expiration de transaction maximal et de service ORB : 1. Dans l arborescence de navigation de WebSphere Administrative Console, cliquez sur Servers > Application Servers, puis, dans le volet de droite, cliquez sur le nom du serveur. 2. Sous Container Settings, cliquez sur Container Services > Transaction Service. 3. Augmentez l ensemble des valeurs de délai d expiration afin de corriger cette erreur LiveCycle ES2 : Total transaction lifetime timeout : 1800 Async response timeout : 1800 Maximum transaction timeout : Redémarrez WebSphere Application Server. Erreurs de démarrage/création du déploiement sur Solaris Téléchargez l'outil tar pour GNU et utilisez-le pour extraire tous les fichiers dans un environnement Solaris. N'utilisez pas la commande tar Solaris pour extraire des fichiers, au risque que des erreurs (fichiers manquants, par exemple) et des entrées de journal telles que la suivante apparaissent :

22 Dépannage de l'installation et du déploiement Dépannage de LiveCycle ES2 Dépannage du serveur d applications 22 ERROR[org.apache.catalina.core.ContainerBase.[jboss.web].[localhost].[/invok er]] Exception starting filter ReadOnlyAccessFilter java.lang.classnotfoundexception: org.jboss.invocation.http.servlet.readonlyaccessfilter Exhec de validation de la configuration du serveur d'applications lors d'une nouvelle exécution de LiveCycle Configuration Manager Lorsque vous exécutez de nouveau LiveCycle Configuration Manager après avoir exécuté la configuration et la validation une seule fois, si vous ignorez le déploiement du fichier adobe-lcm-lcvalidation.ear, un message d'erreur s'affiche, indiquant que la validation de la configuration du serveur d'applications a échoué. Cette erreur se produit même si vous avez déployé le fichier adobe-lcm-lcvalidation.ear et validé la configuration. Pour éviter cette erreur, sélectionnez la tâche destinée à déployer le fichier adobe-lcm-lcvalidation.ear et à valider la configuration du serveur d'applications lors de toutes les exécutions suivantes de LiveCycle Configuration Manager. Dépannage du serveur d applications Cette section décrit les problèmes que vous êtes susceptible de rencontrer avec votre serveur d applications, de même que comment les résoudre à l aide des fichiers journaux. Le serveur d applications ne démarre pas. Si le serveur ne démarre pas, procédez comme suit : Examinez le fichier journal du serveur d applications. Vérifiez que le serveur n est pas déjà en cours d exécution. S il l est déjà, il s exécute très certainement mais échoue à s initialiser. Fermez le serveur d applications, puis relancez-le. Vérifiez qu aucun autre processus n utilise l un des ports configurés pour LiveCycle ES2. Consultez la documentation du fabricant. JBoss Application Server problèmes Echec du déploiement de Content Services ES2 après un redémarrage du serveur JBoss Si le déploiement de Content Services ES2 échoue après un redémarrage de JBoss Application Server, ajoutez les processus Java et mysqld-max-nt.exe à la liste des processus sécurisés de votre logiciel antivirus. Le code d'erreur 13 qui apparaît dans les journaux est une erreur de refus d'autorisation.

23 Dépannage de l'installation et du déploiement Dépannage de LiveCycle ES2 WebLogic Server problèmes 23 WebLogic Server problèmes Blocage de LiveCycle Configuration Manager lors du redéploiement d'un fichier EAR LiveCycle Configuration Manager peut se bloquer à une étape non terminée lors du redéploiement d'un fichier EAR LiveCycle ES2 et provoquer l'échec du déploiement du fichier EAR. Ce problème survient de temps en temps lorsque WebLogic Server ne libère pas un fichier EAR actuellement déployé. Pour remédier à ce problème, exécutez la procédure suivante : 1. Arrêtez le LiveCycle Configuration Manager. 2. Supprimez manuellement la version existante du fichier EAR LiveCycle ES2 que vous voulez mettre àjour. 3. Arrêtez puis redémarrez les serveurs WebLogic Server d'administration et gérés. 4. Exécutez LiveCycle Configuration Manager pour déployer le nouveau fichier EAR. WebSphere Application Server problèmes Problèmes lors de la suppression de l'arborescence du répertoire sur WebSphere Si vous ne pouvez pas supprimer une arborescence de répertoire WebSphere, ce peut être dû au fait que le chemin d'accès est trop long. Par exemple, vous ne pouvez peut-être pas supprimer le fichier suivant utilisé par LiveCycle Rights Management ES2 : C:\Program Files\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 Pour résoudre ce problème, associez un lecteur à l'emplacement à partir duquel vous voulez supprimer des fichiers (dans cet exemple, C:\Program Files\IBM\WebSphere\AppServer\profiles\ AppSrv01\installedApps), puis supprimez les fichiers du lecteur source de l'association. Pour associer un emplacement de lecteur et supprimer des fichiers à partir de la ligne de commande : 1. Associez un lecteur à l'emplacement à partir duquel vous voulez effectuer la suppression. Par exemple : net use L: \\<hostname>\c$\program Files\IBM\WebSphere\AppServer\profiles \AppSrv01\installedApps 2. Accédez au lecteur associé. Par exemple : L: 3. Supprimez les fichiers. Par exemple : del /s /q *

24 Dépannage de l'installation et du déploiement Dépannage de LiveCycle ES2 Arrêt de réponse du serveur d'applications (WebSphere et DB2 sur AIX) Revenez au lecteur d'origine. Par exemple : C: 5. Supprimez l'association de lecteurs. Par exemple : net use delete L: Vous pouvez également réduire le nom d'un répertoire dans le chemin d'accès à un seul caractère afin de raccourcir le chemin d'accès, puis supprimer les fichiers. OutOfMemory PermGen space error (WebSphere sur Solaris) Si vous utilisez un serveur d'applications WebSphere sur Solaris, LiveCycle Configuration Manager pourrait échouer lors du déploiement du composant LiveCycle ES2 en générant le message d'erreur OutOfMemory PermGen space. Pour éviter cette erreur, ajoutez le paramètre suivant dans la section Generic JVM Arguments du serveur d'applications : -XX:MaxPermSize=512m Redémarrez le serveur d'applications, puis continuez normalement. Pour plus d'informations, reportez-vous au guide Préparation à l'installation de LiveCycle ES2 (serveur unique). Arrêt de réponse du serveur d'applications (WebSphere et DB2 sur AIX) Si plusieurs utilisateurs se servent de Workbench ES2 en même temps dans une configuration WebSphere+DB2 sous AIX, le serveur LiveCycle ES2 risque d'arrêter de répondre quand un utilisateur tente de déployer une application. Pour éviter cette erreur, procédez comme suit : 1. Ouvrez le fichier [WorkbenchES2_HOME]\workbench.ini à l'aide d'un éditeur de texte. 2. Recherchez la ligne suivante, puis modifiez la valeur en 1. -Dcom.adobe.workbench.unsupported.service.cache.batch.threads=5 3. Enregistrez le fichier, puis fermez-le. Exception NullPointerException lors de l'accès à Contentspace ES2 Si vous rencontrez une exception NullPointerException lorsque vous essayez d'accéder à Contentspace ES2, redémarrez le serveur d'applications et accédez à nouveau à Contentspace ES2. Le problème se produit uniquement sur WebSphere 7.x, pas sur WebSphere 6.x. Dépannage de la base de données LiveCycle ES2 Cette section présente différents problèmes que vous êtes susceptibles de rencontrer avec votre base de données LiveCycle ES2 et propose des procédures pour les éviter ou les corriger.

25 Dépannage de l'installation et du déploiement Dépannage de LiveCycle ES2 Paramètres de configuration d IBM DB2 25 Si votre base de données refuse de démarrer, procédez comme suit : Vérifiez que la base de données dispose d un espace disque suffisant. Vérifiez que la configuration de la base de données est supérieure à la configuration minimale requise. Pour connaître la configuration requise par votre type de base de données, reportez-vous au document Préparation à l installation de LiveCycle ES2 sur un seul serveur. Consultez la documentation du fabricant. Remarque : si l administrateur de votre base de données ne parvient pas à démarrer la base de données après ces vérifications, contactez immédiatement l éditeur de la base de données. Pour garantir la disponibilité continue et les performances de votre base de données LiveCycle ES2, procédez comme suit : Contrôlez la base de données en continu pour détecter tout problème de performance. Contrôlez la croissance de la base de données en continu pour vous assurer qu elle dispose d un espace disque suffisant à tout moment. Vérifiez le taux d'utilisation du composant de LiveCycle ES2 : Les applications LiveCycle Process Management ES2 intenses augmentent la taille de la base de données davantage que les applications PDF Generator ES2 intenses. Consultez la documentation de l éditeur sur les performances des bases de données. Paramètres de configuration d IBM DB2 Si vous utilisez LiveCycle ES2 avec une base de données DB2 et que l ordinateur cesse de répondre, consultez les fichiers journaux du serveur à la recherche de messages indiquant un arrêt fatal (deadlock). Si vous repérez ce type de messages dans les fichiers journaux, modifiez les paramètres de configuration de DB2 : Attribuez au paramètre LOCKTIMEOUT la valeur 15. Doublez les valeurs des paramètres APPLHEAPSZ, STMTHEAP et SORTHEAP. Redémarrez ensuite la base de données et le serveur d applications. Dépannage avec des fichiers journaux Cette section décrit la procédure de dépannage de LiveCycle ES2 à l aide de fichiers journaux. Fichier journal de LiveCycle ES2 Par défaut, le fichier journal de LiveCycle ES2 se situe dans le répertoire [racine LiveCycleES2] est s appelle log.txt. Ce fichier journal se révèle utile pour l analyse des échecs de LiveCycle ES2 et peut vous être demandé lorsque vous appelez le service d assistance aux entreprises d Adobe. Fichier journal de LiveCycle Configuration Manager Par défaut, le fichier journal de LiveCycle Configuration Manager est enregistré dans le répertoire [racine LiveCycleES]\ConfigurationManager\log et est généralement nommé lcm.0.log. Les fichiers journaux permettent d analyser les échecs de LiveCycle Configuration Manager et le service d assistance aux entreprises d Adobe peut vous demander d y faire référence si vous le contactez.

26 Dépannage de l'installation et du déploiement Dépannage de LiveCycle ES2 Dépannage de votre serveur d applications avec les fichiers journaux 26 Dépannage de votre serveur d applications avec les fichiers journaux Les informations consignées dans les fichiers journaux de votre serveur d applications peuvent vous aider à résoudre les problèmes que vous rencontrez avec votre implémentation de LiveCycle ES2. Si les informations fournies sont insuffisantes pour résoudre le problème, activez la journalisation prolixe pour augmenter le nombre de données consignées. La journalisation prolixe ne doit être activée qu à des fins de dépannage, car elle réduit les performances du système et monopolise l espace disque pour les fichiers journaux. Remarque : il est recommandé de faire appel au service d assistance aux entreprises d Adobe pour résoudre des problèmes à l aide des fichiers journaux prolixes. Fichier journal de JBoss Par défaut, les fichiers journaux de JBoss sont enregistrés dans le répertoire [racine LiveCycleES2]\ jboss\server\all\log sous le nom boot.log et server.log. Ces fichiers permettent d analyser les échecs de démarrage du serveur d applications JBoss et de LiveCycle ES2 ; le service d assistance aux entreprises d Adobe peut vous demander d y faire référence si vous le contactez. Si les informations fournies sont insuffisantes pour résoudre le problème, activez le mode de journalisation TRACE pour augmenter le nombre de données consignées. Pour ce faire, modifiez le fichier [racine du serveur d applications]/conf. Remarque : créez une copie de sauvegarde du fichier [racine du serveur d applications]/conf avant de le modifier. Pour activer la journalisation en mode TRACE dans JBoss : 1. Ouvrez une invite de commande et accédez au répertoire [racine du serveur d applications]/conf. 2. Modifiez le fichier de configuration log4j.xml dans un éditeur de texte. 3. Recherchez l enregistreur automatique <root> dans le fichier et modifiez-le comme suit : <root> <priority value= INFO /> <appender-ref ref= FILE /> </root> 4. Avant l enregistreur automatique <root>, saisissez le texte ci-dessous : <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. Recherchez la chaîne <appender name="file" dans le fichier et modifiez ou saisissez la ligne suivante : <param name= Threadhold value= DEBUG />

27 Dépannage de l'installation et du déploiement Dépannage de LiveCycle ES2 Dépannage de votre serveur d applications avec les fichiers journaux Recherchez la chaîne de caractères <!-- A size based file rolling appender dans le fichier et ajoutez le contenu ci-dessous à sa suite : <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. Enregistrez le fichier log4j.xml, puis fermez-le. Pour désactiver la journalisation en mode TRACE dans JBoss : 1. Ouvrez une invite de commande et accédez au répertoire [racine du serveur d applications]/conf. 2. Modifiez le fichier de configuration log4j.xml dans un éditeur de texte. 3. Recherchez l enregistreur automatique <root> dans le fichier et modifiez-le comme suit : <root> <priority value= INFO /> <appender-ref ref= FILE /> </root> 4. Avant l enregistreur automatique <root>, saisissez le texte ci-dessous : <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. Recherchez la chaîne <appender name="file" dans le fichier et modifiez ou saisissez la ligne suivante : <param name= Threadhold value= DEBUG /> 6. Recherchez la chaîne de caractères <!-- A size based file rolling appender dans le fichier et ajoutez le contenu ci-dessous à sa suite : <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. Enregistrez le fichier log4j.xml, puis fermez-le.

28 Dépannage de l'installation et du déploiement Dépannage de LiveCycle ES2 Dépannage de votre serveur d applications avec les fichiers journaux 28 Fichier journal de WebLogic Par défaut, le fichier journal de WebLogic réside dans le répertoire /var/log/httpd/error_log. Les fichiers journaux permettent d analyser les échecs de démarrage de WebLogic Server et de LiveCycle ES2. Le service d assistance aux entreprises d Adobe peut vous demander d y faire référence si vous le contactez. Si le fichier journal ne fournit pas les informations suffisantes pour vous aider à résoudre les problèmes, vous pouvez définir le niveau de tracé dans le fichier journal afin d en augmenter la quantité de détails consignés. Pour ce faire, modifiez le paramètre LogLevel du fichier [racine du serveur d applications]/ conf/httpd.conf. LogLevel définit la quantité d informations consignées par les messages d erreur dans les journaux d erreurs. LogLevel peut être défini (du moins prolixe au plus prolixe) sur emerg, alert, crit, error, warn, notice, info ou debug. La valeur par défaut de LogLevel est warn. Remarque : créez une copie de sauvegarde du fichier [racine du serveur d applications]/conf/httpd.conf avant de le modifier. Pour activer le niveau de journalisation debug dans WebLogic : 1. Ouvrez une invite de commande et accédez au répertoire [racine du serveur d applications]/conf. 2. Modifiez le fichier de configuration httpd.conf dans un éditeur de texte. 3. Recherchez le paramètre LogLevel dans le fichier et modifiez-le comme suit : LogLevel debug 4. Enregistrez le fichier httpd.conf, puis fermez-le. Une fois les problèmes résolus, répétez les étapes 1 à 4 en remplaçant LogLevel par warn. Fichier journal de WebSphere Par défaut, le fichier journal de WebSphere se trouve dans le répertoire [racine du serveur d applications]/ logs/server1/trace.log. Les fichiers journaux permettent d analyser les échecs de démarrage de WebSphere Application Server et de LiveCycle ES2. Le service d assistance aux entreprises d Adobe peut vous demander d y faire référence si vous le contactez. Si les informations fournies sont insuffisantes pour résoudre les problèmes, activez le mode de journalisation TRACE dans WebSphere Administrative Console pour augmenter le nombre de données consignées. Pour activer le mode de journalisation TRACE dans WebSphere : 1. Ouvrez une session WebSphere Administrative Console, puis dans l arborescence de navigation, cliquez sur Troubleshooting > Logs and Trace. Ensuite, dans la liste des serveurs, cliquez sur server1, puis sur Change Log Detail Levels. 2. Sélectionnez Enable Trace et dans le champ Trace Specification, saisissez com.adobe.*=all=enabled:com.adobe.framework.uitools=all=disabled. [racine du serveur d'applications]/profiles/[nom_profil]/ logs/[nom_serveur]

29 Dépannage de l'installation et du déploiement Dépannage de LiveCycle ES2 Dépannage de votre serveur d applications avec les fichiers journaux 29 Affichage de la sortie système et des journaux d'erreurs JVM Les journaux d erreurs et la sortie système JVM constituent de précieux outils pour résoudre les problèmes que rencontre votre serveur. Pour afficher la sortie système JVM et les journaux d'erreurs : 1. Connectez-vous à WebSphere Administrative Console. Dans l arborescence de navigation, cliquez sur Troubleshooting > Logs and Trace. 2. Cliquez sur le nom du serveur d'applications, puis sur JVM Logs. 3. Cliquez sur l onglet Runtime puis, sous System.out (pour afficher le journal sortie système JVM) ou System.err (pour afficher le journal d erreurs), cliquez sur View. Si l une des sélections n est pas disponible, vous pouvez afficher le tout à partir de l onglet Configuration en indiquant les noms de fichier SystemOut.log et SystemErr.log. Par défaut, les fichiers sont enregistrés à l emplacement suivant : [racine du serveur d'applications]/profiles/[nom_profil]/ logs/[nom_serveur] Pour empêcher l'affichage des vidages Java pendant le déploiement des fichiers EAR ou lors du redémarrage du serveur : Assurez-vous que le paramètre JAVA_HOME_32 est défini comme variable d'environnement uniquement et ne figure pas dans PATH. Pour éviter des messages d'erreur «reindeximpl started» à répétition dans les journaux du serveur WebSphere : Une fois que Content Services ES2 est déployé, il se peut que le message d'erreur suivant apparaisse à plusieurs reprises dans SystemOut.log : IndexTransact I org.alfresco.repo.node.index.indextransactiontracker reindeximpl reindeximpl started: org.alfresco.repo.node.index.indextransactiontracker@290c290c Pour résoudre ce problème, procédez comme suit : 1. (WebSphere 6.1) Dans l'arborescence de navigation de WebSphere, cliquez sur Servers > Application servers. (WebSphere 7.x) Dans l'arborescence de navigation de WebSphere, cliquez sur Servers > Server Types > Websphere application servers. 2. Cliquez sur le nom d'un serveur d'applications dans le volet de droite. 3. Cliquez sur Troubleshooting > Change Log Level Details. 4. Dans la liste Components, accédez au package org.alfresco.repo.node.index.indextransactiontracker. 5. Cliquez sur le package org.alfresco.repo.node.index.indextransactiontracker, puis sélectionnez No Logging. 6. Répétez les étapes 1 à 5 pour les onglets Configuration et Runtime, puis pour tous les nœuds de la grappe.

30 Dépannage de l'installation et du déploiement Dépannage de LiveCycle ES2 Suppression du fichier journal de transaction du serveur d applications 30 Pour empêcher la répétition des messages d'erreur «Failed job» en provenance du planificateur Quartz : Si vous utilisez le port SOAP pour l'un de vos services LiveCycle ES2, vous risquez de rencontrer un problème entraînant l'apparition répétée de messages d'erreur «Failed job» en provenance du planificateur Quartz dans le fichier journal de WebSphere pour tous les nœuds de la grappe. Ces messages d'erreur continuent à apparaître même après que le nœud traitant la demande a été arrêté et qu'un autre nœud a terminé le travail en attente. Pour éviter ce problème, utilisez la console d'administration pour modifier la configuration de tous les nœuds de la grappe WebSphere. Définissez le niveau de journalisation pour les packages suivants sur severe : org.quartz.impl.jdbcjobstore com.adobe.idp.scheduler.jobstore.dscjobstoretx Suppression du fichier journal de transaction du serveur d applications Si, pour une raison quelconque, les composants de la solution ne se déploient pas, le serveur d applications hébergeant LiveCycle ES2 ne peut pas redémarrer, car il tente de récupérer, en vain, ce qu il interprète comme des transactions annulées. Pour résoudre ce problème, repérez et supprimez le fichier journal de transaction du serveur d applications, puis redémarrez ce dernier.

31 2 Dépannage des tâches d'administration Ce chapitre traite d'éventuels problèmes en relation avec votre environnement LiveCycle ES2 déployé et l interface LiveCycle Administration Console, ainsi que du moment auquel il convient de contacter le service d assistance aux entreprises d Adobe. «Problèmes d ouverture de session», page 31 «Considérations relatives aux performances», page 33 «Problèmes de désinstallation», page 38 «Dépannage des erreurs de sortie», page 39 «Erreurs diverses», page 46 Voir aussi «Obtenir de l aide», page 10 «Informations complémentaires», page 9 Problèmes d ouverture de session Si vous ne pouvez pas accéder aux applications Web LiveCycle ES2, comme par exemple aux pages Web LiveCycle Administration Console ou LiveCycle Workspace ES2, vérifiez les conditions suivantes : Vérifiez que la base de données LiveCycle ES2 a été créée et que l utilisateur peut y accéder sans restrictions. Le serveur de la base de données est accessible lorsque vous exécutez une requête ping sur ce serveur. Remarque : seuls les administrateurs ayant les rôles appropriés peuvent accéder à l application Workspace ES2. Pour plus de détails sur les rôles et les autorisations, reportez-vous à l'aide à l'administration de LiveCycle ES2 Administration. Si vous ne pouvez pas ouvrir de session LiveCycle Administration Console en tant qu utilisateur disposant de privilèges d administrateur, procédez comme suit : Essayez d ouvrir une session en tant que Super administrateur, c est-à-dire avec l identifiant utilisateur Administrateur. Cet utilisateur est déclaré systématiquement dans la base de données locale avant d être identifié par un autre fournisseur d authentification. Assurez-vous que les conditions SPI personnalisées décrites ci-dessous existent véritablement. Vérifiez que l utilisateur administrateur a les rôles requis. Si votre arborescence LDAP a un nom d administrateur, les rôles LiveCycle ES2 peuvent avoir été écrasés. Contactez le support d assistance aux entreprises d Adobe. Si vous ne pouvez pas vous connecter aux pages Web de Workspace ES2, vérifiez les conditions suivantes : Vérifiez que le fichier d hôte contient le nom du serveur Workspace ES2. Vérifiez que le serveur Workspace ES2 répond aux requêtes ping. Vérifiez que ni le client ni le serveur Workspace ES2 ne sont bloqués par un pare-feu. Vérifiez que les paramètres du fichier QLC sont corrects (par exemple, le nom du serveur Workspace ES2, le port JNDI ou le port du fournisseur d URL). 31

32 Dépannage des tâches d'administration Dépannage de LiveCycle ES2 Problèmes d ouverture de session 32 Si vous utilisez une condition SPI personnalisée et que vous ne pouvez pas ouvrir de session, vérifiez les conditions suivantes : Vérifiez que l association entre le domaine et son fournisseur d authentification est correcte dans le fichier config.xml. Si elle est incorrecte ou absente, l authentification est vouée à l échec. Le domaine doit être configuré dans le fichier config.xml comme suit : <node name="domains"> <map/> <node name="<domain_name"> <map> <entry key="description" value="any suitable description"/> <entry key="name" value="<domain_name>"/> <entry key="islocal" value="true/false"/> </map> <node name="authconfigs"> <map/> <node name="<profile_name"> <map> <entry key="authprovidernode" value="/adobe/livecycle/config/um/authproviders/<authenticationprovider"/> </map> </node> </node> <node name="directoryconfigs"> Chaque domaine conserve une référence du fournisseur d authentification qu il utilise à des fins d authentification. Assurez-vous que le fournisseur d authentification est configuré dans le fichier config.xml et ce, de la manière suivante : <root type="system"> <map/> <node name="adobe"> <map/> <node name="livecycle"> <map/> <node name="config"> <map/> <node name="um"> <map/> <node name="authproviders"> <map/> <node name="authentication Provider"> <map> <entry key="configured" value="true"/> DOIT AVOIR LA VALEUR TRUE <entry key="visibleinui" value="false"/> <entry key="enabled" value="true"/> <entry key="allowmultipleconfigs" value="false"/> <entry key="classname" value="com.adobe.idp.um.provider.authentication.certificateauthproviderimpl" /> DOIT AVOIR UNE VALEUR NON NULL <entry key="order" value="5"/>

33 Dépannage des tâches d'administration Dépannage de LiveCycle ES2 Accès à la page Services dans LiveCycle Administration Console sur JBoss 33 Accès à la page Services dans LiveCycle Administration Console sur JBoss Si vous accédez à la page Services dans LiveCycle Administration Console et qu'elle s'affiche vide, corrigez ce problème comme suit pour que la page s'affiche correctement. Pour afficher correctement la page Services : 1. Démarrez JBoss Application Server manuellement (sans utiliser le service Windows) via la commande : run -b localhost -c all 2. Dans le fichier d'hôtes Windows enregistré dans le répertoire C:\windows\system32\drivers\ etc... \hosts, ajoutez l'adresse IP et le nom d'hôte du serveur LiveCycle ES2. Affichage des pages de connexion même après une authentification SSO Les pages de connexion Workspace ES2 et LiveCycle Administration Console s'affichent même après la configuration SSO et l'authentification de l'utilisateur. Pour y remédier, il est nécessaire de créer un domaine qui filtre sur /um/login et de l ajouter à la stratégie. Exemple de résolution avec SiteMinder Pour remédier à ce problème avec SiteMinder 6.0, tout en configurant SiteMinder avec LiveCycle ES2, procédez comme suit : 1. Création d'un domaine nommé UM Login qui filtre sur um/login. Routage de l'ensemble des authentifications vers ce domaine. 2. Création d'une règle pour le nouveau domaine. Ce faisant, spécifiez * comme la ressource. 3. Dans la boîte de dialogue Response Properties, spécifiez Auth Response comme nom, puis ajoutez un attribut avec la valeur ADB_USER=<%userattr= cn %>. 4. Ajoutez UM Login à la stratégie en tant que règle. Considérations relatives aux performances Si vous notez des problèmes de performances avec LiveCycle ES2, prenez en compte les points suivants : Problèmes de synchronisation : si un grand nombre de threads sont en attente au même moment dans la même partie du code, effectuez un thread dump (vidage des threads) une fois la congestion résolue. Attention : cette opération peut désactiver la JVM. Ressources externes lentes : si un grand nombre de threads sont en attente d un message de retour d une source externe, effectuez un thread dump (vidage des threads) pour déterminer les threads qui attendent une réponse d une source telle qu une base de données ou un serveur LDAP. Ralentissement du Garbage Collector : si verbosegc effectue fréquemment un compactage, réduisez la quantité de «déchets» générés par l application en utilisant les pools d objets ou la mise en cache. Si vous constatez dans le journal que les cycles de collecte sont très longs dans verbosegc, réduisez la taille de tas maximale.

34 Dépannage des tâches d'administration Dépannage de LiveCycle ES2 Amélioration des performances durant une invocation de service asynchrone 34 Utilisation importante de l unité centrale : si le niveau d utilisation de l unité centrale est supérieur ou égal à 75 %, envisagez d effectuer les opérations suivantes : Réduction de la taille de pool pour le conteneur Web ou les threads ORB. Réduction du nombre de connexions de base de données sur le serveur de base de données. Ajout de ressources de traitement (si le niveau d utilisation de l unité centrale est régulièrement élevé). Réduction du paramètre de nombre maximal de connexions à la source de données, si l unité centrale concernée se trouve sur le serveur de base de données. Amélioration des performances durant une invocation de service asynchrone Pour améliorer les performances durant une invocation asynchrone des services, définissez les arguments JVM suivants : -Dadobe.work-manager.queue-refill-interval=1 -Dadobe.workmanager.memory-control.enabled=false Pour JBoss, ajoutez ces arguments aux fichiers run.bat (Windows) ou au fichier run.sh (UNIX). Reportez-vous à la section Configuration des arguments JVM du guide Installation et déploiement de LiveCycle ES2 pour WebSphere afin d'obtenir des informations sur la définition d'arguments JVM pour WebSphere. Reportez-vous à la section Configuration des arguments JVM du guide Installation et déploiement de LiveCycle ES2 pour WebLogic afin d'obtenir des informations sur la définition d'arguments JVM pour WebLogic. Echec de l'invocation à distance avec de serveurs d'applications dans un environnement IPv6 pur Si votre serveur LiveCycle ES2 est implémenté dans un environnement IPv6 pur, l'invocation à distance de services sur le serveur LiveCycle ES2 risque d'échouer. Ce problème se produit en cas d'utilisation de JDK Sun avec les clients. Pour éviter cette erreur, utilisez le JDK IBM avec les clients quand LiveCycle ES2 est déployé sur des serveurs d'applications dans un environnement IPv6 pur. Amélioration des performances de Windows Server avec LDAP L'utilisation du pool de connexions sur la connexion de recherche peut réduire le nombre de ports requis de 50 %, car cette connexion utilise toujours les mêmes informations d'identification pour un domaine donné, et le contexte et les objets liés sont fermés de manière explicite. Pour configurer Windows Server pour le pool de connexion : 1. Démarrez l éditeur de registre en cliquant sur Démarrer > Exécuter. Dans la zone Ouvrir, saisissez regedit, puis cliquez sur OK. 2. Naviguez jusqu'à la clé de registre HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters.

35 Dépannage des tâches d'administration Dépannage de LiveCycle ES2 Configuration du service de programmation pour les URL JNDI autres que les URL par défaut Dans le volet de droite de l éditeur de registre, recherchez le nom de la valeur TcpTimedWaitDelay. Si ce nom n apparaît pas, sélectionnez Edition > Nouveau > Valeur DWORD pour l ajouter. 4. Dans la zone Nom, saisissez TcpTimedWaitDelay. 5. Si aucun curseur ne clignote dans la zone et que la mention Nouvelle valeur # n apparaît pas, cliquez avec le bouton droit de la souris dans le volet droit, sélectionnez Renommer dans le menu, puis saisissez TcpTimedWaitDelay dans la zone Nom. 6. Répétez les étapes 4 et 5 pour les noms de valeur suivants : MaxUserPort, MaxHashTableSize et MaxFreeTcbs. 7. Cliquez deux fois dans le volet droit pour définir la valeur TcpTimedWaitDelay. Sous Base, sélectionnez Décimale et, dans la zone Valeur, saisissez Cliquez deux fois dans le volet droit pour définir la valeur MaxUserPort. Sous Base, sélectionnez Décimale et, dans la zone Valeur, saisissez Cliquez deux fois dans le volet droit pour définir la valeur MaxHashTableSize. Sous Base, sélectionnez Décimale et, dans la zone Valeur, saisissez Double-cliquez dans le volet droit pour définir la valeur MaxFreeTcbs. Sous Base, sélectionnez Décimale et, dans la zone Valeur, saisissez Attention : vous pouvez rencontrer de graves problèmes si vous modifiez le registre de manière incorrecte à l aide de l éditeur de registre ou d une autre méthode. Vous pourriez être obligé de réinstaller votre système d'exploitation. Modifiez le registre à vos propres risques. Configuration du service de programmation pour les URL JNDI autres que les URL par défaut (Environnements non groupés uniquement) Il est possible que vous deviez configurer plus avant le service de programmation pour lui permettre de fonctionner correctement. JBoss Sur JBoss, si l URL JNDI est différente de l URL JNDI par défaut pour le serveur d applications (pour JBoss : jnp://localhost:1099), il s agit de l URL JNDI de IDP_DS qui est gérée par votre serveur d applications : org.quartz.datasource.idp.java.naming.provider.url Pour définir les propriétés du service de programmation : 1. Créez un fichier appelé dscscheduler.properties. 2. Définissez les valeurs des propriétés ci-dessus selon les besoins pour le nœud de serveur d applications, comme suit : org.quartz.datasource.idp.java.naming.provider.url = jnp://localhost:1099/ org.quartz.jobstore.isclustered = true org.quartz.scheduler.instanceid = AUTO

36 Dépannage des tâches d'administration Dépannage de LiveCycle ES2 Configuration du service de programmation pour les URL JNDI autres que les URL par défaut Ajoutez l'argument JVM -Dadobe.idp.scheduler.properties=[Chemin vers ce fichier]/dscscheduler.properties aux scripts/à la configuration de démarrage du serveur d'applications. WebSphere Sur WebSphere, si l URL JNDI est différente de l URL JNDI par défaut pour le serveur d applications (pour WebSphere : iiop://localhost:2809), il s agit de l URL JNDI de IDP_DS qui est gérée par votre serveur d applications : org.quartz.datasource.idp.java.naming.provider.url Pour définir les propriétés du service de programmation : 1. Créez un fichier appelé dscscheduler.properties. 2. Définissez les valeurs des propriétés ci-dessus selon les besoins pour le nœud de serveur d applications, comme suit : org.quartz.datasource.idp.java.naming.provider.url = iop://localhost:2809/ org.quartz.jobstore.isclustered = true org.quartz.scheduler.instanceid = AUTO 3. Ajoutez l argument JVM -Dadobe.idp.scheduler.properties=[Chemin vers ce fichier]/dscscheduler.properties aux scripts/à la configuration de démarrage du serveur d applications. WebLogic Sur WebLogic, si l URL JNDI est différente de l URL JNDI par défaut pour le serveur d applications (pour WebLogic : t3://localhost:7001), il s agit de l'url JNDI de IDP_DS qui est gérée par votre serveur d'applications : org.quartz.datasource.idp.java.naming.provider.url Pour définir les propriétés du service de programmation 1. Créez un fichier appelé dscscheduler.properties 2. Définissez les valeurs des propriétés ci-dessus selon les besoins pour le nœud de serveur d applications, comme suit : org.quartz.datasource.idp.java.naming.provider.url = t3://localhost:7001/ org.quartz.jobstore.isclustered = true org.quartz.scheduler.instanceid = AUTO 3. Ajoutez l'argument JVM -Dadobe.idp.scheduler.properties=[Chemin vers ce fichier]/ dscscheduler.properties aux scripts/à la configuration de démarrage du serveur d'applications.

37 Dépannage des tâches d'administration Dépannage de LiveCycle ES2 Problème de performances et de journalisation excessive d'api FileNet sur WebLogic 37 Problème de performances et de journalisation excessive d'api FileNet sur WebLogic Pour LiveCycle ES2 installé sur WebLogic Server, les API FileNet peuvent rencontrer des problèmes de performances dus à une journalisation excessive. Pour améliorer les performances dans ces cas, vous devez modifier le niveau de journalisation de «debug» en «Fatal». 1. Sur FileNet Content Server, accédez au répertoire <Install_DIR>\FileNet\ContentEngine\config\samples. 2. Copiez le fichier log4j.properties.client vers l'ordinateur serveur LiveCycle ES2, puis renommez-le en log4j.properties. 3. Ouvrez le fichier log4j.properties, puis mettez en commentaire les entrées relatives aux séquenceurs FileNetTraceAppender et FileNetTraceRollingAppender : #=== FileNetTraceAppender log4j.appender.filenettraceappender=org.apache.log4j.fileappender log4j.appender.filenettraceappender.file=/p8_api_trace.log # This is the layout that the TraceLoggingConfiguration framework on the server uses. # To use this layout, jace.jar must be present in the classpath. #log4j.appender.filenettraceappender.layout=com.filenet.apiimpl.util.tracelayout # Comment out the following lines if using the FileNet TraceLayout log4j.appender.filenettraceappender.layout=org.apache.log4j.patternlayout log4j.appender.filenettraceappender.layout.conversionpattern=%d %5p [%t] - %m\r\n #=== FileNetTraceRollingAppender log4j.appender.filenettracerollingappender=org.apache.log4j.rollingfileappender log4j.appender.filenettracerollingappender.file=/p8_api_trace.log log4j.appender.filenettracerollingappender.maxfilesize=100mb log4j.appender.filenettracerollingappender.maxbackupindex=1 # This is the layout that the TraceLoggingConfiguration framework on the server uses. # To use this layout, jace.jar must be present in the classpath. #log4j.appender.filenettracerollingappender.layout=com.filenet.apiimpl.util.trac elayout # Comment out the following lines if using the FileNet TraceLayout log4j.appender.filenettracerollingappender.layout=org.apache.log4j.patternlayout log4j.appender.filenettracerollingappender.layout.conversionpattern=%d %5p [%t] - %m\r\n Définissez-le l'enregistreur d'événements FileNet sur FATAL, puis supprimez FileNetTraceAppender et FileNetTraceRollingAppender de l'enregistreur d'événements : Remplacez log4j.logger.filenet_error = error, FileNetConsoleAppender, FileNetErrorRollingAppender, FileNetTraceRollingAppender par log4j.logger.filenet_error = fatal, FileNetErrorRollingAppender

38 Dépannage des tâches d'administration Dépannage de LiveCycle ES2 Erreurs sporadiques de mémoire insuffisante avec WebLogic/JRockit 38 Définissez l'enregistreur d'événements API FileNet sur FATAL : Remplacez #log4j.logger.filenet_error.api = warn par log4j.logger.filenet_error.api = fatal 4. Enregistrez le fichier log4j.properties. 5. Ajoutez le chemin d'accès du dossier contenant le fichier log4j.properties à l'entrée FileNet Component ID figurant dans le fichier adobe-component-ext.properties placé sur le serveur d'applications LiveCycle. Sur le serveur d'applications WebLogic, ce fichier se trouve dans [WL_HOME]/user_projects/domains/<nom de domaine>. Par exemple, si le fichier log4j.properties se trouve dans l'emplacement «C:/log4j_file/log4j.properties», ajoutez «C:/log4j_file» au fichier adobe-component-ext.properties. 6. Redémarrez le serveur d applications. Erreurs sporadiques de mémoire insuffisante avec WebLogic/JRockit Si vous constatez des erreurs sporadiques de mémoire insuffisante avec WebLogic 10gR3/JRockit JVM R26.4 (ou version ultérieure), exécutez l'une des tâches suivantes : Portez la taille du tas de la JVM à une valeur supérieure à 4 Go. Ajoutez l'argument suivant aux options de démarrage de la JVM : -XXcompressedRefs=false Problèmes de désinstallation Suppression de services, dossiers et fichiers JBoss/MySQL Si vous décidez de conserver JBoss ou MySQL lors de la désinstallation de LiveCycle ES2, il se peut que vous ne puissiez plus désinstaller ces applications plus tard en utilisant les programmes de désinstallation dans le dossier [racine_livecyclees2]\uninstall_adobe JBoss pour Adobe LiveCycle ES2 ou le dossier [racine_livecyclees2]\uninstall_adobe MySQL pour Adobe LiveCycle ES2. Pour désinstaller JBoss/MySQL manuellement, procédez comme suit : 1. Supprimez les services nommés «JBOSS_FOR_ADOBE_LIVECYCLE_ES2» ou «MySQL for Adobe LiveCycle ES2» à l'aide de la commande suivante : sc delete <nom de service> 2. Supprimez les dossiers et fichiers JBoss/MySQL. Mode clé en main désactivé suite à une installation ou à une désinstallation incomplète Le mode d'installation clé en main n'est plus disponible après l'échec d'une tentative d'installation ou de désinstallation de LiveCycle ES2.

39 Dépannage des tâches d'administration Dépannage de LiveCycle ES2 Dépannage des erreurs de sortie 39 Pour résoudre ce problème, vérifiez si des services nommés «JBOSS_FOR_ADOBE_LIVECYCLE_ES2» ou «MySQL for Adobe LiveCycle ES2» existent déjà sur le système. Si ces services existent, supprimez-les ainsi que les entrées de registre correspondantes avant de lancer une nouvelle installation en mode clé en main. Pour supprimer les services, utilisez la commande suivante : sc delete <nom de service> Dépannage des erreurs de sortie Certains fichiers de sortie ne sont pas convertis depuis un dossier de contrôle Certains serveurs LiveCycle ES2 (généralement les serveurs s exécutant sous UNIX) appellent le processus de conversion avant que tous les fichiers associés ne soient copiés dans le dossier de contrôle et certains fichiers ne sont donc pas pris en compte. Pour éviter ce problème, créez un dossier hors de l arborescence du dossier de contrôle, copiez dans ce dossier tous les fichiers requis, puis copiez l intégralité du dossier à la racine du dossier de contrôle. Diagnostic des problèmes liés au cache Si vous disposez d'un formulaire plus ancien mis en cache et réutilisé à la place d'un formulaire plus récent ou d'une version modifiée du formulaire, vous constaterez des résultats inattendus après la génération du formulaire. Pour résoudre ce problème, appliquez les mises à jour suivantes : Veillez à ce que les paramètres de validation du cache soient définis de manière à ce que le modèle que vous utilisez ait été revalidé. Si une mise à jour a lieu et si le formulaire est à nouveau rendu en l'espace de quelques secondes, il est possible que l'heure du point de contrôle de revalidation ne soit pas encore arrivée et que le formulaire de mise à jour ne soit pas sélectionné. Pour éviter ce problème, définissez la méthode de validation sur Sans condition ou réinitialisez le cache manuellement. Veillez à ce que les formulaires générés en exemplaire unique transmis par valeur contiennent des chaînes UUID vides, de façon à ce qu'ils puissent être traités comme ne pouvant pas être mis en cache. Si vous disposez d'un formulaire pouvant être mis en cache mais ne voyez pas l'avantage de la mise en cache pour les performances, examinez les paramètres suivants : Assurez-vous que les paramètres de Designer ES2 autorisent une mise en cache de formulaires rendus. Assurez-vous que les options de rendu permettent le fonctionnement du cache de rendu. En général, les rendus de documents PDF simples ne peuvent pas être mis en cache, tandis que les formulaires rendus vers le client bénéficient du cache de rendu. Recherchez dans l'arborescence de répertoires physiques du cache le modèle mis en cache et les éléments rendus de votre document pour vous assurer que le formulaire est physiquement mis en cache. Effectuez une copie du formulaire et supprimez manuellement l'uuid du formulaire. Cette opération crée une version du formulaire qui prendra toujours le pas sur le cache. Comparez ensuite les performances respectives des versions du formulaire non mise en cache et mise en cache afin de déterminer le bénéfice résultant de la mise en cache.

40 Dépannage des tâches d'administration Dépannage de LiveCycle ES2 Perte de certains fichiers de sortie lorsqu un WebSphere Application Server organisé en grappe s arrête 40 Perte de certains fichiers de sortie lorsqu un WebSphere Application Server organisé en grappe s arrête Certains fichiers de sortie attendus peuvent être perdus lorsqu un WebSphere Application Server faisant partie d un groupe de serveur s arrête. Cela peut provenir du fait que les requêtes d appel à partir d un dossier de contrôle ne peuvent pas accéder aux fichiers placés dans le dossier d installation, pour différentes raisons liées à l arrêt. Exécutez la procédure suivante pour récupérer les fichiers perdus. Pour récupérer des fichiers à partir d un dossier d installation : 1. Vérifiez que le nœud est redémarré. 2. Ouvrez une session LiveCycle Administration Console et cliquez sur Services > Applications and Services > Gestion des points de fin. 3. Dans la liste Fournisseur, sélectionnez WatchedFolder et cliquez sur Filtre pour afficher les points de fin du dossier de contrôle. 4. Activez la case à cocher correspondant au point de fin du nom du service, puis cliquez sur Désactiver. Le dossier de contrôle est à présent désactivé du processus de traitement des nouveaux fichiers. 5. Attendez que LiveCycle ES2 ait récupéré et traité tous les fichiers auxquels il peut accéder. La durée d attente dépend du temps nécessaire au traitement de l opération appelée et du nombre de fichiers à récupérer. 6. Vérifiez l horodatage des fichiers restant dans le répertoire d installation afin d identifier ceux qui sont assez anciens et qui risqueraient d être perdus suite à un arrêt du serveur. 7. Copiez les fichiers perdus dans le répertoire d entrée. 8. Activez à nouveau le dossier de contrôle pour traiter les nouveaux fichiers d'entrée en répétant les étapes 2 à 4 et en sélectionnant Activer. Erreur de chiffrement du mot de passe Lorsque le mode FIPS (Federal Information Processing Standards) est activé dans LiveCycle ES2 (défini lors de la configuration de LiveCycle ES2 ou manuellement dans les pages Web Paramètres de Core System de LiveCycle Administration Console), le chiffrement du mot de passe n est appliqué à aucun document. Si vous tentez de chiffrer le mot de passe dans un document où le mode FIPS est activé, une erreur indiquant que le chiffrement du mot de passe n est pas autorisé en mode FIPS s affiche. Filigrane orange indésirable dans la sortie PDF Un fichier PDF généré à partir d un document Microsoft Word peut présenter un filigrane orange (et non pas gris) non souhaité, «Adobe LiveCycle PDF Generator Evaluation». (Un filigrane gris est dû à d autres paramètres de LiveCycle ES2.) Cette erreur survient généralement lorsque le fichier example.ps est corrompu, par exemple en raison de nombreuses installations de LiveCycle ES2 sur le même serveur. Pour corriger ce problème, supprimez le fichier C:\Documents and Settings\[utilisateur]\Application Data\Adobe\Adobe PDF\Distiller\Startup\example.ps du serveur d applications sur lequel est exécuté LiveCycle ES2, puis redémarrez le serveur. Dans un environnement organisé en grappe, supprimez le fichier sur tous les serveurs où il réside, puis redémarrez chacun de ces serveurs.

41 Dépannage des tâches d'administration Dépannage de LiveCycle ES2 Erreur «No transaction» suite à la conversion de plusieurs assemblages 3D 41 Erreur «No transaction» suite à la conversion de plusieurs assemblages 3D LiveCycle PDF Generator 3D ES2 connaît parfois des échecs de conversion avec l exception «IllegalStateException: No transaction». Cette erreur survient lorsque le nombre d assemblages 3D à convertir depuis un dossier de contrôle est trop important. Pour éviter ce problème, exécutez l une des procédures suivantes selon votre serveur d applications. Remarque : vous devez exécuter la procédure sur chacune des instances du serveur d applications afin de corriger cette erreur dans la configuration en grappe. Pour corriger une erreur «No transaction» PDF Generator 3D ES2 sur JBoss Application Server : 1. Ouvrez le fichier [racine JBoss]\server\all\deploy\jms\hajndi-jms-ds.xml dans un éditeur de texte. 2. Localisez l élément tx-connection-factory défini pour jndi-name adobe_jmsqueuexa et insérez l élément en gras comme suit : <tx-connection-factory> <track-connection-by-tx>true</track-connection-by-tx> <jndi-name>adobe_jmsqueuexa</jndi-name> <max-pool-size>100</max-pool-size> <xa-transaction/> <rar-name>jms-ra.rar</rar-name> 3. Enregistrez le fichier. 4. Ouvrez le fichier [racine JBoss]\server\all\deploy\adobe-ds.xml dans un éditeur de texte et modifiez les paramètres suivants : Localisez l élément min-pool-size pour jndi-name IDP_DS et passez sa valeur sur 10. Localisez l élément idle-timeout-minutes et passez sa valeur sur Enregistrez le fichier et redémarrez JBoss Application Server. 6. Ouvrez une session LiveCycle Administration Console, puis cliquez sur Services > Applications et services > Gestion des services. 7. Localisez le service Generate3dPDFService : 1.0, puis cliquez sur celui-ci. 8. Dans la zone Server Maximum Conversion Timeout, passez la valeur sur 2700, puis cliquez sur Save. Pour corriger une erreur «No transaction» PDF Generator 3D ES2 sur WebLogic Server : 1. Dans WebLogic Server Administration Console, sous Domain Structure, cliquez sur Services > JDBC > Data Sources. 2. Sous Change Center, cliquez sur Lock & Edit, puis sur IDP_DS. 3. Sur l onglet Configuration, sur la page Connection Pool, passez la valeur de Initial Capacity sur 10, puis cliquez sur Save. 4. Au bas de la page, cliquez sur Advanced et passez la valeur de Inactive Connection Timeout sur Cliquez sur Save, puis sur Activate Changes. 6. Dans WebLogic Server Administration Console, sous Domain Structure, cliquez sur Services > JTA et dans la zone Timeout Seconds, passez la valeur sur 2900.

42 Dépannage des tâches d'administration Dépannage de LiveCycle ES2 Erreur «No transaction» suite à la conversion de plusieurs assemblages 3D Cliquez sur Save, puis sur Activate Changes. 8. Redémarrez WebLogic Server. 9. Ouvrez LiveCycle Administration Console, puis cliquez sur Services > Applications et services > Gestion des services. 10. Localisez le service Generate3dPDFService : 1.0, puis cliquez sur celui-ci. 11. Dans la zone Server Maximum Conversion Timeout, passez la valeur sur 2700, puis cliquez sur Save. Pour corriger une erreur «No transaction» PDF Generator 3D ES2 sur WebSphere Application Server : 1. Dans WebSphere Administrative Console, cliquez sur Servers > Application servers, puis sur le nom du serveur. 2. Sous Container Settings, cliquez sur Container Services > Transaction Service. Procédez aux changements de configuration nécessaires, puis cliquez sur OK : Dans la zone Total transaction lifetime timeout, saisissez Dans la zone Maximum transaction timeout, saisissez Sous Container Settings, cliquez sur Container Services > ORB Service. Dans la zone Request timeout, saisissez 2900, puis cliquez sur OK. 4. Dans l arborescence de navigation, cliquez sur Resources > JMS > Queue connection factories, puis sur JobManagerQueueConnectionFactory. 5. Sous Additional Properties, cliquez sur Connection pool properties. Procédez aux modifications de configuration suivantes, puis cliquez sur OK : Dans la zone Connection timeout, saisissez Dans la zone Maximum connections, saisissez 100. Dans la zone Reap time, saisissez Dans la zone Unused timeout, saisissez Dans l arborescence de navigation, cliquez sur Resources > JMS > Queue connection factories, puis sur QueueConnectionFactory. 7. Sous Additional Properties, cliquez sur Connection pool properties. Procédez aux modifications de configuration suivantes, puis cliquez sur OK : Dans la zone Connection timeout, saisissez Dans la zone Maximum connections, saisissez 100. Dans la zone Reap time, saisissez Dans la zone Unused timeout, saisissez Dans l arborescence de navigation, cliquez sur Resources > JDBC > Data sources, puis dans le volet droit, cliquez sur le nom d une source de données (par exemple, cliquez sur Livecycle - DB2 - IDP_DS). 9. Sous Additional Properties, cliquez sur Connection pool properties. Procédez aux modifications de configuration suivantes, puis cliquez sur OK : Dans la zone Connection timeout, saisissez 1800.

43 Dépannage des tâches d'administration Dépannage de LiveCycle ES2 Possibilité d'interférence du cache du navigateur avec le rendu HTML 43 Dans la zone Minimum connections, saisissez 10. Dans la zone Reap time, saisissez Dans la zone Unused timeout, saisissez Cliquez sur Save directly to the master configuration et redémarrez le WebSphere Application Server. 11. Ouvrez LiveCycle Administration Console, puis cliquez sur Services > Applications et services > Gestion des services. 12. Localisez le service Generate3dPDFService : 1.0, puis cliquez sur celui-ci. 13. Dans la zone Server Maximum Conversion Timeout, passez la valeur sur 2700, puis cliquez sur Save. Possibilité d'interférence du cache du navigateur avec le rendu HTML Si vous effectuez un rendu HTML d un formulaire XDP contenant des références à des images (via des liens ou des images intégrées) ou d un formulaire contenant des données avec des liens ou des données d image, nous vous conseillons de désactiver la mise en cache du navigateur pour éviter que les données mises en cache n interfèrent avec l affichage des images. Erreur «Failure to create directory» sous Windows Sous Windows, vous pouvez rencontrer une erreur au moment de convertir des fichiers PRN au format PDF depuis un point de fin du dossier de contrôle. Cette erreur est due au paramètre de sortie défini dans LiveCycle Administration Console. Lorsque le paramètre de sortie d un point de fin du dossier de contrôle est défini sur %E/%F.pdf, un dossier de sortie possédant pour extension le fichier d origine est créé qui reçoit les fichiers convertis (%E = extension du nom du fichier, %F = nom du fichier). Par exemple, lorsque le fichier example.prn» est converti au format PDF, un nouveau répertoire est créé (s il n existe pas déjà) et le fichier y est stocké. Le résultat obtenu est alors //prn/example.pdf. Sous Windows, prn est réservé aux répertoires système et toute tentative de création d un fichier génère une erreur «Failure to create directory». Pour éviter cette erreur, définissez la valeur du paramètre de sortie du fichier PRN en point de fin PDF sur %E_/%F or %E_Files.%F. (Reportez-vous à l'aide sur l'administration de LiveCycle ES2.) Erreur «Error while converting image to pdf» sous Windows Sous Windows, au moment de convertir un fichier image au format PDF, vous pouvez rencontrer l une des erreurs définies. Pour résoudre cette erreur, configurez le service Generate PDF de sorte qu il utilise la conversion d image Acrobat. Pour configurer la conversion d image Acrobat : 1. Dans LiveCycle Administration Console, accédez au menu Services > Applications et services > Gestion des services, puis cliquez sur GeneratePDFService : Dans l onglet Configuration, dans la zone Use Acrobat Image Conversion (Windows uniquement), saisissez true et cliquez sur Enregistrer.

44 Dépannage des tâches d'administration Dépannage de LiveCycle ES2 Echec de la conversion de fichiers OpenOffice.org au format PDF sous Solaris 44 Echec de la conversion de fichiers OpenOffice.org au format PDF sous Solaris La conversion de fichiers OpenOffice.org au format PDF peut échouer avec une erreur de délai d'expiration sous Solaris si un nom de répertoire temporaire long est spécifié. Le nom de répertoire temporaire ne devrait pas dépasser 20 caractères. Pour résoudre ce problème, procédez comme suit : 1. Accédez à Paramètres > Core System > Configurations de base dans LiveCycle Administration Console. 2. Entrez un nom de répertoire plus court dans le champ Emplacement du répertoire temporaire. Par exemple, /tmp ou /usr/temp. 3. Cliquez sur OK. Erreur «Content URL 404 error» lors de l utilisation d un modèle dans LiveCycle Contentspace ES2 Lorsque vous utilisez le modèle doc_info.php dans LiveCycle Contentspace ES2, vous obtenez parfois un message d erreur indiquant une erreur Content URL. Pour résoudre cette erreur, remplacez le contenu du modèle doc_info.php. Pour remplacer les contenus : 1. Ouvrez une session Contentspace ES2 en tant qu administrateur, puis cliquez sur Company Home > Data Dictionary. 2. Dans le volet de droite, cliquez sur Presentation Templates, puis sur l élément de contenu doc_info.php. 3. Remplacez le contenu du fichier doc_info.php par le texte suivant : <?php $document = $_ALF_MODEL["document"]; if ($document!= null) {?> <h4>current Document Info:</h4> <b>name:</b> <?php echo($document->cm_name);?><br> <b>ref:</b> <?php echo($document-> tostring());?><br> <b>type:</b> <?php echo($document->type);?><br> <b>dbid:</b> <?php echo($document->sys_node_dbid);?><br> <b>content:</b> <a href="<?php $pos1 = strpos ( $document->url, ticket );echo ( substr( $document->url, 0, $pos1-1 ))?>"><?php $pos1 = strpos ( $document->url, ticket );echo ( substr( $document->url, 0, $pos1-1 ))?></a><br> <?php if ($document->hasaspect("cm_countable") == true) {?> <b>counter:</b> <?php echo($document->cm_counter);?><br>

45 Dépannage des tâches d'administration Dépannage de LiveCycle ES2 Police Bell Gothic écartée dans LiveCycle ES2 et Designer ES2 45 <?php }?> <b>aspects:</b> <table> <?php foreach ($document->aspects as $aspect) {?> <tr><td><?php echo($aspect);?></td></tr> <?php }?> </table> <b>properties:</b> <table> <?php foreach ($document->properties as $name=>$value) { echo("<tr><td>".$name." = ".$value."</td></tr>"); }?> </table> <?php } else { echo "No document found!"; }?> 4. Enregistrez le fichier. Police Bell Gothic écartée dans LiveCycle ES2 et Designer ES2 Le serveur LiveCycle ES2 et les installations Designer ES2 n'incluent plus la police Bell Gothic. Si vous effectuez une mise à jour et disposez de formulaires utilisant cette police, remplacez-la par une autre police disponible sur le système ou achetez-la sur le site d'adobe Store. Manière dont un formulaire utilisant la police Bell Gothic est affecté en cours d'exécution : LiveCycle ES2 serveur : si cette police est absente du serveur LiveCycle ES2, PDF Generator ES2 la remplace automatiquement dans le fichier de sortie PDF généré. Designer ES2 : lors de l'ouverture du formulaire dans Designer ES2, la boîte de dialogue Missing Fonts s'affiche, invitant l'utilisateur à remplacer la police manquante.

46 Dépannage des tâches d'administration Dépannage de LiveCycle ES2 Erreur «Cannot retrieve the resource from Repository Path» lors d'une génération de fichier PDF réussie 46 Erreur «Cannot retrieve the resource from Repository Path» lors d'une génération de fichier PDF réussie Après la mise à niveau à partir de LiveCycle 8.0.x, des exceptions telles que l'avertissement suivant apparaissent dans les journaux du serveur durant la récupération d'images à partir du référentiel LiveCycle. En dépit de cette exception, la génération du fichier PDF s'effectue comme prévu FormServerExc W com.adobe.livecycle.formsservice.logging.formslogger logmessage ALC-OUT : Cannot retrieve the resource from Repository Path. Authority component retrieved is "<somestring>". Path component retrieved is "/somefolder/someimage.jpg".underlying Exception is : ALC-REP : Resource [/somefolder/someimage.jpg] does not exist or you do not have sufficient rights to access it. Cette exception se produit en raison de l'utilisation d'une syntaxe incorrecte de l'url pointant sur le référentiel d'images où les ressources sont mises en cache. Si «repository://» est utilisé à la place de «repository:///», la ressource n'est pas mise en cache. Du fait que les ressources n'ont pas été mises en cache dans LiveCycle 8.0.x, les exceptions n'ont pas été vues sur ce système. Pour résoudre ce problème, modifiez les instances de repository:// en repository:/// dans les formulaires migrés à partir de LiveCycle 8.0.x. Erreurs diverses Echec du déploiement de adobe-livecycle-websphere.ear Si vous déployez des composants LiveCycle ES2 vers WebSphere sur une instance localisée du système d'exploitation Windows, le processus de déploiement de LiveCycle Configuration Manager atteint environ 7 % d'exécution, puis adobe-livecycle-websphere.ear ne parvient pas à se déployer. Pour éviter ce problème, procédez comme suit : 1. Sélectionnez LiveCycle Configuration Manager pour configurer les fichiers EAR de LiveCycle ES2, mais ne les déployez pas. 2. Sans quitter LiveCycle Configuration Manager, ouvrez la WebSphere Administrative Console et supprimez l argument JVM suivant de la configuration du serveur. -Dfile.encoding=utf8 3. Redémarrez WebSphere. 4. Dans LiveCycle Configuration Manager, déployez le fichier adobe-livecycle-websphere.ear. 5. Une fois cette opération terminée retournez à la WebSphere Administrative Console. 6. Rajoutez Dfile.encoding=utf8 à l'argument JVM. 7. Redémarrez WebSphere. 8. Retournez dans LiveCycle Configuration Manager et déployez les fichiers EAR restants.

47 Dépannage des tâches d'administration Dépannage de LiveCycle ES2 Fonctionnalités de modèle d'application indisponibles 47 Fonctionnalités de modèle d'application indisponibles Si vous sélectionnez un référentiel ECM comme référentiel de travail dans l'écran Paramètres de configuration des connecteurs ECM de LiveCycle Administration Console, les fonctionnalités du modèle d'application spécifique de LiveCycle ES2 deviennent indisponibles. Par exemple, il se peut que vous ne soyez pas en meure de créer, d'exécuter ou de supprimer des applications LiveCycle ES2. En revanche, vous serez en mesure d'utiliser les processus LiveCycle ES comme précédemment. Perte du paramètre de niveau pour l'option HTML to PDF Le paramètre de niveau de l'écran Home > Services > LiveCycle PDF Generator ES2 > File Type Settings > New > HTML to PDF dans LiveCycle Administration Console est perdu. Par exemple, vous pouvez modifier le paramètre de niveau de Get only 1 level en Get only 2 levels. A présent, cliquez sur une autre option (par exemple, PDF optimizer), puis développez de nouveau HTML to PDF. La valeur du paramètre est rétablie sur Get only 1 level. Pour résoudre ce problème, rétablissez la valeur de ce paramètre sur Get only 2 levels (ou toute autre valeur souhaitée) juste avant de cliquer sur Save. Notez que si vous développez de nouveau la section HTML to PDF, vous verrez l'option Get only 1 level sélectionnée au lieu de l'option Get only 2 levels. Ne vous préoccupez pas de cette discordance d'interface utilisateur car LiveCycle ES2 a correctement enregistré la valeur sélectionnée. Pour vérifier que la valeur sélectionnée a effectivement été enregistrée, procédez comme suit : 1. Dans LiveCycle Administration Console, cliquez sur Home > Services > LiveCycle PDF Generator ES2 > Configuration Files > Export Configuration File pour exporter le fichier de configuration. 2. Dans le fichier de configuration exporté, vérifiez que la valeur de la balise <levels> sous <html2pdfsettings> est correcte. Messages d'erreur en anglais au lieu de chaînes localisées dans certains écrans LiveCycle Administration Console affiche des messages d'erreur en anglais au lieu de chaînes localisées dans certains écrans. Pour résoudre ce problème, modifiez les paramètres régionaux de la JVM afin que les composants côté serveur génèrent des messages d'erreur localisés. Par exemple, ajoutez l'argument JVM suivant pour définir les paramètres régionaux de JVM sur Français : -Duser.language=fr Duser.region=FR Pour plus d'informations, reportez-vous à la page Exception dans le journal du serveur lors de la suppression d'applications Dans Workbench ES2, lorsque vous supprimez une application dont le type de données est référencé dans un processus, une exception est consignée dans le journal du serveur. Toutefois, l'application requise est désinstallée et supprimée avec succès. Ne tenez pas compte de cette erreur.

48 3 Dépannage des messages d'erreur Messages d'erreur du fichier journal de LiveCycle ES2 Cette section décrit les problèmes et les solutions associées aux messages d erreur du fichier journal de LiveCycle ES2. Messages d erreur généraux Cette section décrit les messages d erreur qui ne sont pas spécifiques de LiveCycle ES2 ainsi que les méthodes de résolution des problèmes sous-jacents. OutOfMemoryError Ce type d erreur trouve habituellement son origine dans l un des points suivants : «Plus de threads disponibles», page 48 «Threads et allocation de mémoire», page 49 «Exécution du service Document Management pour Content Services ES2 sur du matériel de base», page 51 Plus de threads disponibles Il existe un grand nombre de types de thread. Cependant, ils entrent le plus souvent dans deux catégories : les threads Java et les threads natifs. Tous les threads s exécutant dans une JVM sont des threads Java, c est-à-dire des instances de la classe Java java.lang.thread. Le code natif (C++/C) crée des threads natifs gérés et synchronisés par le système d exploitation. Principales différences entre ces deux types de thread : Les threads Java sont créés et gérés par du code LiveCycle ES2, le serveur d applications ou la JVM elle-même. Les outils de système d exploitation (perfmon ou le Gestionnaire des tâches) ne «voient» que les threads natifs. Comme le système d exploitation n a aucune visibilité sur les threads Java, lorsque vous les analysez à l aide des outils du système d exploitation tels que perfmon, seuls les threads natifs sont pris en compte. Le seul moyen d obtenir des informations sur les threads Java consiste à effectuer un Java thread dump (vidage des threads Java). Le moyen d y parvenir varie en fonction de votre serveur d applications et de JVM. Consultez la documentation du fabricant. De plus, la JVM étant implémentée en code C/C++, ce code associe les threads Java à des threads natifs. Cette association peut être de type un pour un (1 thread Java pour 1 thread natif) ou plusieurs pour un (plusieurs threads Java pour 1 thread natif). Le fonctionnement précis de cette association est spécifique à la JVM utilisée, mais de manière générale, il s agit d une relation de type 1:1. Il y aura donc un thread natif pour chaque thread Java. Il n y a aucune limitation sur le nombre de threads Java ; toutefois, comme de manière générale la relation est du type un pour un et qu il existe une limitation au nombre de threads natifs, vous pouvez vous retrouver à court de threads Java. Cette limitation dépend des processus (la JVM étant un processus unique) et varie en fonction de chaque système d exploitation. De manière générale, 48

49 Dépannage des messages d'erreur Dépannage de LiveCycle ES2 OutOfMemoryError 49 le nombre de threads par processus ne doit pas dépasser quelques milliers (mais être inférieur à ). Dans tous les cas, avoir plusieurs centaines de threads en cours d exécution pose des problèmes de performances car le système d exploitation doit tous les synchroniser. Threads et allocation de mémoire Un autre problème courant concernant les threads est la quantité de mémoire affectée. Lorsqu un nouveau thread Java est affecté, un montant fixe de mémoire est nécessaire pour la pile du thread. Cet espace est un paramètre optimisable (option -Xss de la JVM Sun ) dont la valeur par défaut est égale à~512ko. Cela signifie que pour 1000threads, 500Mo de mémoire seront nécessaires uniquement pour les piles des threads. Cette affectation de mémoire est en concurrence avec les autres affectations de mémoire effectuées par la JVM (par exemple la mémoire affectée par LiveCycle ES2), ce qui peut provoquer des problèmes. En pratique, lorsque la JVM ne peut pas affecter de mémoire ni créer de threads, elle renvoie une exception OutOfMemory à l appelant, ainsi qu une trace de pile et une explication de l exception. Il est très important de noter ces informations pour déterminer d où vient le problème. Exemple de message signalant deux erreurs et le code explicatif correspondant : unable to create new native thread: java.lang.outofmemoryerror: unable to create new native thread java.lang.outofmemoryerror: Java heap space Ces erreurs signifient que la JVM n a pas pu créer de threads supplémentaires pour l une des raisons suivantes : la limite du nombre de threads par processus a été atteinte ; la pile de threads n a pas pu être affectée. Pour déterminer la raison exacte, vous devez déclencher un thread dump (vidage des threads), également appelé java dump (vidage Java). Les informations générées par un thread dump sont généralement stockées dans le fichier javacore.xxxx.txt, qui se trouve dans l un des répertoires des journaux du serveur d applications. Un thread dump contient un grand nombre d informations, mais vous pouvez déterminer rapidement le nombre de threads en comptant le nombre d occurrences du jeton TID: de la liste. Une entrée type a le format suivant : "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) Si vous constatez qu il y a des milliers de threads, il est très probable que la limite du nombre de threads est atteinte. Un développeur devrait pouvoir identifier les éléments fautifs en analysant la stack trace (trace de pile) de ces threads. Remarque : il est généralement nécessaire de redémarrer le serveur d applications après un thread dump.

50 Dépannage des messages d'erreur Dépannage de LiveCycle ES2 OutOfMemoryError 50 S il n y a que quelques centaines de threads, l exception java.lang.outofmemory n est pas provoquée par la limitation du nombre de threads. Réduisez la taille de la pile de threads (l option -Xss mentionnée plus haut) et relancez LiveCycle ES2 pour voir si le problème est résolu. OutOfMemoryError : erreur d'espace du tas Java L exécution de certaines transactions LiveCycle ES2 peut être plus longue que le délai d expiration par défaut du serveur d applications. Par exemple, le traitement de documents PDF de grande taille peut être très long. Ces erreurs peuvent figurer dans le journal du serveur d applications lorsque des utilisateurs LiveCycle Workbench ES2 font glisser des fichiers volumineux dans l affichage Ressources. Si le journal du serveur d applications contient des messages OutOfMemoryError, augmentez la valeur du délai d expiration des transactions. La valeur recommandée est de 300 secondes (5 minutes). Sur WebLogic, pour être applicable, cette valeur doit être supérieure à celle définie dans la source des travaux via WebLogic Server Administration Console. Sur WebSphere, la valeur du délai d expiration doit être supérieure à celle configurée pour le délai d expiration de transaction maximal. Pour configurer le délai d'expiration des transactions JBoss : 1. Ouvrez [racine du serveur d'applications]/server/all/conf/jboss.service.xml à l'aide d'un éditeur de texte. 2. Recherchez l'élément attribute dont l'attribut name a la valeur TransactionTimeout : <attribute name="transactiontimeout">300</attribute> 3. Modifiez le texte de l'élément attribute pour augmenter le nombre, selon les besoins. 4. Enregistrez jboss.service.xml. Pour configurer le délai d expiration des transactions WebLogic : 1. Ouvrez une session sur WebLogic Server Administration Console et, sous Domain Structure, cliquez sur Environment > Servers. 2. Dans le volet de droite, cliquez sur votre serveur, puis cliquez sur l'onglet Server Start. 3. Cliquez sur Lock & Edit. 4. Dans le volet de gauche, cliquez sur [nom domaine] et, dans le volet de droite, cliquez sur l'onglet JTA. 5. Dans la zone Timeout Seconds, saisissez 300 (ou plus). 6. Cliquez sur Save, puis sur Activate Changes. Pour configurer le délai d'expiration des transactions WebSphere : 1. Dans l'arborescence de navigation de WebSphere Administrative Console, cliquez sur Servers > Application servers > [nom serveur]. 2. Sous Container Settings, cliquez sur Container Services > Transaction Service. 3. Sous General Properties, dans la zone Total transaction lifetime timeout, saisissez 300 (ou plus). 4. Sous General Properties, vérifiez que la valeur de Maximum transaction timeout est supérieure ou égale à la valeur que vous avez spécifiée pour la propriété Total transaction lifetime timeout. 5. Cliquez sur OK.

51 Dépannage des messages d'erreur Dépannage de LiveCycle ES2 OutOfMemoryError 51 Exécution du service Document Management pour Content Services ES2 sur du matériel de base Content Services ES2 utilise plusieurs mémoires cache ce qui améliore considérablement les performances mais consomme une mémoire du tas Java très importante. Il n est pas rare de rencontrer des exceptions OutOfMemory au moment d exécuter le service Document Management pour Content Services ES2 sur du matériel se limitant à la configuration minimale. Vous pouvez contrôler l utilisation de la mémoire en définissant les arguments JVM -Dhibernate.cache.use_second_level_cache=false et -Dhibernate.cache.use_query_cache=false. Pour contrôler l utilisation de la mémoire de Content Services ES2 sur JBoss Application Server : 1. Ouvrez le fichier suivant dans un éditeur de texte : (Windows) [racine du serveur d applications]/bin/run.bat (UNIX) [racine du serveur d applications]/bin/run.sh 2. Sur la ligne JAVA_OPTS, ajoutez ou modifiez les arguments suivants : -Dhibernate.cache.use_second_level_cache=false -Dhibernate.cache.use_query_cache=false 3. Enregistrez le fichier modifié. Pour contrôler l utilisation de la mémoire de Content Services ES2 sur WebLogic Server : 1. Dans WebLogic Server Administration Console, sous Domain Structure, cliquez sur Environment > Servers, puis dans le volet situé à droite, cliquez sur le nom du serveur LiveCycle ES2. 2. Cliquez sur l onglet Configuration > Server Start. 3. Sous Change Center, cliquez sur Lock & Edit. 4. Dans la zone Arguments, ajoutez ou modifiez les arguments JVM suivants : -Dhibernate.cache.use_second_level_cache=false -Dhibernate.cache.use_query_cache=false 5. Cliquez sur Save, puis sur Activate Changes. Pour contrôler l utilisation de la mémoire de Content Services ES2 sur WebSphere Application Server : 1. Ouvrez une session WebSphere Administrative Console, puis dans l arborescence de navigation, cliquez sur Servers > Application servers, puis sur le nom du serveur dans le volet de droite. 2. Sous Server Infrastructure, cliquez sur Java and Process Management > Process Definition. 3. Sous Additional Properties, cliquez sur Java Virtual Machine et dans la zone Generic JVM arguments, ajoutez ou modifiez les arguments JVM suivants : -Dhibernate.cache.use_second_level_cache=false -Dhibernate.cache.use_query_cache=false 4. Cliquez sur Apply, puis sur Save directly to the master configuration.

52 Dépannage des messages d'erreur Dépannage de LiveCycle ES2 404 Fichier introuvable Fichier introuvable Si vous obtenez l erreur 404 Fichier introuvable, vérifiez les points suivants : Vérifiez le problème dans le journal des accès du navigateur. Vérifiez que le fichier EAR a été déployé correctement et que l application est initialisée. Si l URL est à destination du serveur HTTP, vérifiez que le fichier existe bien. Dans le fichier error_log ou error.log, recherchez le nom complet du fichier recherché par le serveur Web. (JBoss) Vérifiez l URL d autant plus qu elle est sensible à la casse. (JBoss) Vérifiez que la racine du contexte de l application Web (la première partie de l URL) figure dans le fichier uriworkermap.properties de la configuration du module externe JK. (JBoss) S il s agit d une JSP, vérifiez que le fichier est présent dans le fichier EAR. L absence d une entrée dans le journal d erreurs du serveur HTTP confirme cette situation. Classe introuvable Si vous obtenez une erreur Classe introuvable, vérifiez l existence éventuelle des problèmes suivants : Le chemin de classe est incorrect ou manquant. Le fichier JAR est obsolète. Il y a un problème de compilation dans la classe. nom JNDI introuvable Si le symptôme est une trace de pile d exception indiquant javax.naming.namenotfoundexception: jdbc/<badname>, vérifiez que le nom attendu est correctement orthographié. Si ce n est pas le cas, corrigez le code. Pour corriger la plupart des exceptions JNDI : 1. Vérifiez l arborescence JNDI sur le serveur d applications LiveCycle ES2. Le nom utilisé apparaît-il dans l arborescence? Si tel est le cas, il est probable que votre code n a pas correctement défini l objet InitialContext utilisé pour la recherche. Celle-ci s effectue dans une arborescence JNDI qui n est pas celle dans laquelle figure la ressource. Pour connaître les valeurs de propriété à utiliser, reportez-vous au document Installation et déploiement de LiveCycle ES2 correspondant à votre serveur d applications. Si ce n est pas le cas, passez à l étape La ressource apparaît-elle dans l arborescence JNDI sous un nom différent de celui figurant dans la recherche? Si c est le cas, vous utilisez un nom de recherche incorrect. Indiquez le nom approprié. Si ce n est pas le cas, passez à l étape Vérifiez les fichiers journaux du serveur d applications lors du démarrage. Si le serveur d applications a été configuré pour que cette ressource soit disponible mais que tout ne fonctionne pas correctement, une exception sera indiquée ici. Une exception est-elle survenue? Si c est le cas, vérifiez la trace de l exception et de la pile. Si, d après vos recherches dans les fichiers journaux, NameNotFoundException s avère être le symptôme d un autre problème, accédez aux étapes de dépannage correspondant à ce problème.

53 Dépannage des messages d'erreur Dépannage de LiveCycle ES2 Messages d erreur JBoss Application Server 53 Si ce n est pas le cas, passez à l étape Si la ressource n est pas présente dans l arborescence JNDI et qu aucune exception au démarrage n explique pourquoi elle n est pas disponible, il se peut que le serveur d applications n ait pas été configuré correctement. Vérifiez la configuration du serveur d applications A-t-il été configuré pour rendre cette ressource disponible? Si ce n est pas le cas, reportez-vous au guide Installation et déploiement delivecycle ES2 correspondant à votre serveur d applications. Si tel est le cas, il ne s agit pas d un problème courant. Contactez le support d assistance aux entreprises d Adobe. Messages d erreur JBoss Application Server Problème d'objet org.jboss.logging.appender.fileappender (Problème connu) Si ECM Connector pour EMC Documentum est inclus dans votre installation de LiveCycle ES2 pour JBoss, le message d'erreur suivant est consigné dans les journaux du serveur à chaque redémarrage du serveur : An org.jboss.logging.appender.fileappender object is not assignable to an org.apache.log4j.appender variable Apparition de messages IBM FileNet dans le fichier journal de JBoss Application Server Pour arrêter d'afficher les messages ERROR et WARNING, générés par IBM FileNet, dans le fichier journal de JBoss Application Server, effectuez les corrections suivantes dans le fichier log4j.xml du répertoire [racine_jboss]/server/all/conf. 1. Recherchez le fichier log4j.xml puis ouvrez-le dans un éditeur. 2. Ajoutez la ligne suivante à la section [catégorie] : <category name="com.filenet"> <priority value="fatal"/> </category> 3. Enregistrez le fichier, puis fermez-le. 4. Redémarrez le serveur d applications. Messages d erreur WebLogic Server Erreur de délai d'expiration JTA de WebLogic Il existe une erreur de délai d'expiration WebLogic si vous recevez le message d'erreur suivant : <Warning> <com.adobe.workflow.aws> <ap-sun4> <Server_127> <[ACTIVE] ExecuteThread: '17' for queue: 'weblogic.kernel.default (self-tuning)'> <<anonymous>> <BEA1-58E59A31956BB0D8F0AB> <> < > <000000> <javax.ejb.transactionrolledbacklocalexception: EJB Exception: ; nested exception is: javax.ejb.transactionrolledbacklocalexception: EJB Exception: ;

54 Dépannage des messages d'erreur Dépannage de LiveCycle ES2 Messages d erreur WebLogic Server 54 nested exception is: weblogic.transaction.internal.timedoutexception: Transaction timed out after 299 seconds Pour corriger ce problème, attribuez une valeur supérieure à 300 secondes au délai d'expiration JTA de WebLogic. Reportez-vous à la section «Configuration du délai d'expiration des transactions WebLogic» dans le guide Préparation à l'installation de LiveCycle ES2. Erreur de déploiement d'adobe-livecycle-weblogic.ear Il existe une erreur de déploiement EAR de WebLogic si vous recevez le message d'erreur suivant : Could not start application adobe-livecycle-weblogic. com.adobe.livecycle.cdv.cdvexception[alc-lcm ]: Failed to deploy EAR. Pour corriger ce problème, vérifiez que WebLogic Server Administration Console n'est pas verrouillée (c'est-à-dire que le bouton Lock & Edit n'est pas sélectionné). Si elle est verrouillée, LiveCycle Configuration Manager indique que le processus de déploiement n'est terminé qu'à 16 % et WebLogic Server Administration Console indique que le fichier EAR est déployé, mais dans un état installé. Si WebLogic Server Administration Console n'est pas verrouillée, LiveCycle Configuration Manager peut déployer les fichiers EAR. Pour corriger ce problème, accédez à WebLogic Server Administration Console, vérifiez qu'elle est déverrouillée et redéployez les fichiers EAR. Erreur de déploiement due à une erreur de l'espace PermGen Il existe une erreur de déploiement EAR de WebLogic si vous recevez le message d'erreur suivant : java.lang.outofmemoryerror: PermGen space Pour corriger ce problème, augmentez la valeur PermGen space de 256 à 512. Vous pouvez modifier cette valeur dans WebLogic Server Administration Console. Erreur de déploiement des modules de LiveCycle ES2 sous WebLogic/Windows Il est connu que, lors de l'exécution de WebLogic Server sous Windows, les modules de LiveCycle ES2 ne sont pas déployés du fait que le paramètre de délai d'expiration de 5 secondes du serveur est trop court. Vous pouvez configurer manuellement ce paramètre de la façon suivante : Accédez à [domaine du serveur d applications] et ouvrez startweblogic.cmd dans un éditeur. Recherchez [ADOBE_JAVA_HOME] et ajoutez le paramètre suivant : -Dweblogic.client.socket.ConnectTimeout = <timeout value> Remarque : LiveCycle Configuration Manager ne prend pas en charge l'utilisation d'un serveur d'administration si aucun serveur géré n'est configuré.

55 Dépannage des messages d'erreur Dépannage de LiveCycle ES2 Messages d erreur WebSphere Application Server 55 Messages d erreur WebSphere Application Server Erreur de déploiement du fichier adobe-livecycle-websphere.ear Cette section explique la procédure à suivre si vous recevez le message d erreur suivant lors du déploiement du fichier adobe-livecycle-websphere.ear : Could not deploy adobe-livecycle-websphere.ear. com.adobe.livecycle.cdv.cdvexception[alc-lcm ]: Failed to deploy EAR. Could not deploy adobe-livecycle-websphere.ear. Pour corriger une erreur de déploiement de WebSphere : 1. Exécutez la commande limit -n dans la fenêtre de commande. 2. Si une valeur de 1024 est renvoyée, remplacez-la par 2048 dans le script wasadmin.sh. 3. Ouvrez le script [racine du serveur d applications]/bin/wsadmin.sh dans un éditeur de texte. Ajoutez la ligne ulimit -n 2048 après l'en-tête du bloc de commentaire du fichier : 4. Redémarrez WebSphere et déployez le fichier adobe-livecycle-websphere.ear à l aide de LiveCycle Configuration Manager. Messages d avertissement J2CA0294W Pour éviter de recevoir des messages d avertissement dans le fichier SystemOut.log file qui sont en rapport avec l utilisation non autorisée d une recherche JNDI directe, vous pouvez changer le niveau de consignation de WebSphere. Pour supprimer le message d avertissement J2CA0294W dans SystemOut.log, vous pouvez redéfinir le niveau de consignation sur *=info:com.ibm.ejs.j2c.connectionfactorybuilderimpl=severe. Pour modifier les niveaux de journalisation : 1. Connectez-vous à WebSphere Administrative Console par l'intermédiaire de l'url et, dans l arborescence de navigation, cliquez sur Troubleshooting > Logs and Trace. 2. Dans le volet de droite, cliquez sur le nom du serveur d'applications, puis sur Change Log Detail Levels. 3. Cliquez sur l'onglet Configuration et entrez la chaîne suivante : *=info:com.ibm.ejs.j2c.connectionfactorybuilderimpl=severe 4. Cliquez sur OK, puis sur Save directly to the master configuration. Messages de journal détaillés dans l'installation de WebSphere Pour éviter que l'installation de WebSphere entraîne l'enregistrement de plusieurs messages de journal superflus, vous pouvez élever le niveau de journalisation à Warning de façon à ce que les messages de niveau inférieur ne soient pas consignés.

56 Dépannage des messages d'erreur Dépannage de LiveCycle ES2 Messages d erreur WebSphere Application Server 56 Pour modifier les niveaux de journalisation : 1. Connectez-vous WebSphere Administrative Console via l URL puis 2. Dans l'arborescence de navigation, cliquez sur Troubleshooting et sélectionnez Logs and Trace. 3. Dans le volet de droite, cliquez sur le nom du serveur d'applications, puis sur Change Log Detail Levels. 4. Sélectionnez Runtime, puis entrez org.apache.xml.security.* 5. Cliquez sur Message And Trace Levels, puis sélectionnez Warning. 6. Activez la case à cocher Save changes to master configuration. 7. Cliquez sur OK. Non-déploiement du fichier adobe-livecycle-websphere.ear dans une version 64 bits de WebSphere 6.1 Lorsque vous déployez le fichier adobe-livecycle-websphere.ear manuellement ou à l aide de LiveCycle Configuration Manager dans une version 64 bits de WebSphere application server, le message d'erreur suivant peut apparaître : 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) Si cette erreur apparaît dans WebSphere Administrative Console, il est recommandé de mettre à jour votre serveur d applications vers WebSphere 6.1 Fixpack 15 et SR6. Messages SystemOut superflus au cours du déploiement du module LiveCycle ES2 dans WebSphere 6.1 Il est connu que, lors du déploiement des modules de LiveCycle ES2 sur WebSphere Application Server, des messages SystemOut superflus sont consignés dans le fichier journal system.out, tels que les messages suivants : [2/26/08 19:16:34:303 CST] SystemOut Oflex.management.runtime.messaging.services.remoting.RemotingDestinationCont rol [2/26/08 19:16:34:304 CST] SystemOut O 9 [2/26/08 19:16:34:305 CST] SystemOut O flex.management.runtime.messaging.services.remoting.adapters.javaadaptercont rol IBM propose un correctif dans sa liste des Correctifs disponibles afin de résoudre ce problème.

57 Dépannage des messages d'erreur Dépannage de LiveCycle ES2 Messages d erreur WebSphere Application Server 57 Exception : No trusted certificate found Il est possible que le WebSphere Application Server génère des exceptions similaires à celles décrites ci-dessous. Exceptions affichées dans LiveCycle Administration Console : 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 Exceptions apparaissant dans les fichiers journaux de WebSphere Application Server : [5/28/08 13:15:30:283 CDT] 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] SystemOut O [5/28/08 13:15:30:283 CDT] 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 Ce problème survient lorsque le fichier de stockage des clés WebSphere ne comporte pas le certificat demandé. Le fichier de stockage des clés WebSphere par défaut comporte seulement un ensemble limité de certificats. Utilisez la procédure suivante pour ajouter un nouveau certificat au fichier de stockage des clés WebSphere. Pour ajouter un nouveau certificat au fichier de stockage de clés de WebSphere : 1. Obtenez le certificat approprié depuis le service de courrier électronique. 2. Copiez le certificat vers [racine du serveur d applications]\profiles\[nom du serveur]\etc Connectez-vous à WebSphere Administrative Console, puis cliquez sur Security > SSL certificate and key management. 4. Sous Related Items, cliquez sur Key stores and certificates, puis sur CellDefaultTrustStore. 5. Sous Additional Properties, cliquez sur Signer certificates, puis sur Add. 6. Dans le champ Alias, saisissez un alias approprié pour le certificat que vous importez. 7. Dans le champ File name, saisissez l emplacement d installation du certificat indiqué à l étape 2, puis cliquez sur OK.

58 Dépannage des messages d'erreur Dépannage de LiveCycle ES2 Messages d erreur WebSphere Application Server Cliquez sur Save directly to the master configuration. Le certificat que vous venez d ajouter doit apparaître dans la liste en tant que certificat du signataire. 9. Redémarrez WebSphere Application Server. Exception Java NameNotFoundException Lorsque vous démarrez les composants User Manager sur WebSphere Application Server, le message d'exception suivant n'apparaît qu'après le démarrage de l'application : 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:".] Vous pouvez ignorer cette erreur sans risque. Exception inattendue durant l'invocation de convention DSC Lors de l'invocation d'une convention DSC à partir d'une transaction démarrée par une autre application déployée en tant que fichier EAR sur l'instance WebSphere 7.x sur laquelle LiveCycle ES2 est déployé, l'invocation de la convention DSC échoue en générant le message d'erreur suivant : 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; Cette erreur se produit pour WebSphere 7.x uniquement quand le fichier adobe-utilities.jar est utilisé et que Platform.UTIL.getTransactionManager() est l'utilisateur qui démarre le gestionnaire de transactions. Pour résoudre ce problème, n'utilisez pas le fichier adobe-utilities.jar pour démarrer le gestionnaire de transactions. Utilisez plutôt le code suivant pour créer UserTransaction : InitialContext initialcontext = new InitialContext(); UserTransaction ut = (UserTransaction)initialContext.lookup("java:comp/UserTransaction"); ut.begin();

59 Dépannage des messages d'erreur Dépannage de LiveCycle ES2 Messages d erreur de base de données 59 Messages d erreur de base de données Cette section décrit des messages d'erreur relatifs à votre base de données LiveCycle ES2. Exceptions connues liées à des initialisations multiples de la base de données Lorsque vous initialisez la base de données LiveCycle ES2 après qu elle a déjà été initialisée, il est possible que des exceptions surviennent, indiquant que le schéma POF a été initialisé. Vous pouvez ignorer cette erreur sans risque. Erreur MySQL «Too many connections» Avec des charges élevées, MySQL peut générer des erreurs «Too many connections». Ce problème peut être résolu en augmentant le nombre de connexions parallèles autorisées par MySQL. 1. Accédez au répertoire d installation de MySQL. 2. Localisez le fichier my.ini et ouvrez-le dans un éditeur de texte. 3. Repérez le paramètre max_connections et modifiez sa valeur. La valeur par défaut est Redémarrez MySQL. J2CA0081E : Method cleanup error on SQL Server Si vous recevez le message d erreur «J2CA0081E: Method cleanup failed while trying to execute method cleanup...», la trace de pile s'affiche comme suit : " 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" Vous devez effectuer une mise à niveau vers le pilote JDBC SQL Server 2005 version 1.2. Téléchargez ce pilote sur la page Microsoft Download Center. Echec d'initialisation de la base de données sur WebLogic Il est possible que vous receviez l'exception suivante lors de l'initialisation de la base de données LiveCycle ES2 sur WebLogic Server : Servlet failed with Exception java.lang.classcastexception: weblogic.jndi.factories.java.readonlycontextwrapper at com.adobe.livecycle.bootstrap.framework.bootstrapservlet.checkdatasource(boo tstrapservlet.java:216) Pour corriger ce problème, modifiez le fichier IDP_DS-3079-jdbc.xml.

60 Dépannage des messages d'erreur Dépannage de LiveCycle ES2 Messages d erreur LiveCycle ES2 60 Pour modifier le fichier IDP_DS-3079-jdbc.xml : 1. Localisez le fichier IDP_DS-3079-jdbc.xml dans le répertoire [domaine du serveur d'applications]/config/jdbc et ouvrez-le dans un éditeur de texte. 2. Localisez la ligne <jndi-name></jndi-name> et supprimez-la. 3. Enregistrez et fermez le fichier, puis réinitialisez la base de données. Problèmes de mémoire sur le serveur DB2 La page de configuration de DB2 affiche le message d'erreur suivant : SQL1585N A temporary table space with sufficient page size does not exist. Following is the SQLCODE and SQLSTATE value specific to memory issue on DB2 server. sqlcode: sqlstate: SQL1585N A temporary table space with sufficient page size does not exist. Pour plus d'informations sur cette erreur, consultez l'article de la Base de connaissances IBM à l'adresse doc/doc/msql01585n.html. Pour éviter ce problème, procédez comme suit : Augmentez la RAM du système. Pour obtenir des conseils, reportez-vous au guide Préparation àl installation. Prévoyez au moins 2 Go d'espace pour chaque instance DB2. Si vous installez LiveCycle Content Services ES2 pour l'utiliser avec une base de données DB2, vous devez disposer d'au moins 2 Go de RAM sur l'ordinateur hébergeant la base de données LiveCycle ES2. Messages d erreur LiveCycle ES2 Cette section décrit des messages d'erreur relatifs à votre installation de LiveCycle ES2. Messages d'erreur de sortie Echec de la conversion de fichiers natifs sur JBoss/Windows S'il est exécuté avec un système d'exploitation Windows, PDF Generator ES2 ou PDF Generator 3D ES2 peut échouer lors de la conversion de fichiers natifs (conversion de documents Microsoft Word au format PDF, par exemple), générant une exception dans le fichier journal similaire à l'exception suivante : INFO [PDF Generator] Application server started as user: SYSTEM Ce problème se produit si vous n'avez pas utilisé le même compte utilisateur pour tout processus de Microsoft Office, PDF Generator ES2, Acrobat pour PDF Generator ES2 et pour le processus de votre serveur d'applications. Pour corriger ce problème, modifiez l'utilisateur du service JBoss pour Adobe LiveCycle afin qu'il soit le même que l'utilisateur de Microsoft Office.

61 Dépannage des messages d'erreur Dépannage de LiveCycle ES2 Erreur de fin de fichier inattendue sur WebLogic 61 Pour modifier l'utilisateur du service JBoss pour Adobe LiveCycle : 1. Sélectionnez Démarrer > Panneau de configuration > Outils d'administration > Gestion de l ordinateur > Services et applications > Services. 2. Cliquez deux fois sur le service JBoss pour Adobe LiveCycle et sélectionnez l'onglet Ouvrir une session. 3. Sélectionnez Ce compte et saisissez le nom d'utilisateur et le mot de passe qui permettent d'exécuter Microsoft Office, puis cliquez sur OK. Echec de la conversion de fichiers HTML sur JBoss/Windows S'il est exécuté sur JBoss sous un système d'exploitation Solaris, PDF Generator ES2 peut échouer lors de la conversion de fichiers HTML à l'aide de l'opération HTMLToPDF ou HTMLURLToPDF, en générant dans le fichier journal une exception similaire à la suivante : com.adobe.livecycle.generatepdf.client.conversionexception: ALC-PDG The conversion has timed out. at com.adobe.pdfg.generatepdfimpl.htmlurltopdf Ce problème se produit lorsque la bibliothèque libiconv.so.2 est manquante sur votre système. Pour le corriger, installez la bibliothèque libiconv.so.2 dans le répertoire /usr/lib. Erreur d'autorisation XMLForm.exe sous UNIX ou Linux Vous pouvez rencontrer un problème d autorisation UNIX et Linux dans Forms ES2 si le message d erreur suivant est journalisé : Cannot add execute permission on file /[chemin_vers_xmlform.exe] Pour corriger ce problème, vérifiez que l espace d échange des serveurs UNIX et Linux est d au moins 3 Go. Erreur de fin de fichier inattendue sur WebLogic Vous rencontrez un problème avec LiveCycle Forms ES2 et LiveCycle Output ES2 si vous recevez le message d'erreur suivant : com.adobe.idp.documenterror: java.net.socketexception: Unexpected end of file from server at com.adobe.idp.document.passivateinitdata(document.java:867) Pour corriger ce problème, vérifiez que la valeur du paramètre Document MaxInlineSize est inférieure au paramètre de taille des messages IIOP défini dans WebLogic Server. Messages d'erreur côté client Exception CORBA COMM_FAILURE sur WebLogic/Solaris Si vous rencontrez une exception CORBA COMM_FAILURE de votre client lors de l'exécution de WebLogic Server sous Solaris, vous devez transmettre la propriété supplémentaire suivante à la JVM côté client : -Dcom.sun.CORBA.transport.ORBTCPReadTimeouts=1:60000:300:1

62 Dépannage des messages d'erreur Dépannage de LiveCycle ES2 Messages d erreur divers 62 La valeur en gras est une liste délimitée par des deux-points des valeurs de délai d'expiration en millisecondes qui doivent être définies en fonction de la configuration système. Les valeurs de gauche à droite sont les suivantes : Temps d'attente initial si une lecture de TCP de transport renvoie 0 octets Temps d'attente cumulé maximal si une lecture de TCP de transport renvoie 0 octets Temps d'attente cumulé maximal si une lecture de TCP de transport d'un en-tête GIOP renvoie 0octets Pourcentage de backoff utilisé pour calculer le temps d'attente sur une lecture de TCP de transport ultérieure de 0 octets Aucun paramètre n'est nécessaire du côté serveur. Messages d erreur divers Localisateur déjà en cours d'exécution Si vous utilisez le protocole TCP pour la mise en cache, il se peut que vous rencontriez l'exception suivante lors du démarrage du localisateur TCP : 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) 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: PDT <Thread-0> nid=0x15d56d5] Locator stopped Pour résoudre ce problème, vérifiez l'existence du fichier de verrou.locatordans le dossier caching, puis supprimez le fichier. com.adobe.idp.documenterror Si certains nœuds de grappe ne peuvent pas accéder au répertoire de stockage global de documents (GDS), il se peut que vous rencontriez le message d'erreur suivant : com.adobe.idp.documenterror: The document pointing to the file "B:\lc9_share\docm \c5c0f6c0a324c0d45396deb69b6e11db" has expired. Consider increasing the document disposal timeout Assurez-vous que : Tous les nœuds de la grappe sont synchronisés. Tous les nœuds au répertoire GDS. Si le problème persiste, recherchez d'éventuels problèmes de réseau et de latence.

63 Dépannage des messages d'erreur Dépannage de LiveCycle ES2 IDPSchedulerService n'est pas en état RUNNING 63 IDPSchedulerService n'est pas en état RUNNING IDPSchedulerService n'a pas redémarré bien que Workbench ES2 indique qu'il a démarré. L'exception suivante apparaît dans les journaux du serveur : ALC-DSC : com.adobe.idp.dsc.invalidstateexception: Service: IDPSchedulerService is not in a RUNNING state Pour résoudre ce problème, démarrez IDPSchedulerService de façon explicite lorsque vous devez redémarrer planificateur à partir de Workbench ES2.