Adobe Workflow Manuel utilisateur
c
Installation et configuration de LiveCycle pour JBoss
Novembre 2006
Adobe
®
LiveCycle
™
Version 7.2
© 2006 Adobe Systems Incorporated. Tous droits réservés.
Adobe® LiveCycle™ 7.2 Installation et configuration de LiveCycle pour JBoss® sous Microsoft® Windows® et Linux®
Edition 1.0, Novembre 2006
Si ce guide accompagne un logiciel assorti d'un contrat de licence, le guide et le logiciel dont il traite sont concédés sous licence et ne peuvent être copiés ou utilisés que conformément à cette licence. Sauf autorisation spécifiée dans la licence, aucune partie de ce guide ne peut être reproduite, enregistrée ou transmise par un moyen électronique, mécanique ou autre, sans l'autorisation écrite préalable d'Adobe
Systems Incorporated. Sachez que le contenu de ce manuel est protégé par des droits d'auteur même s'il n'est pas distribué avec un logiciel contenant un contrat de licence de l'utilisateur final.
Les informations contenues dans ce guide sont données à titre purement indicatif. Elles peuvent être modifiées sans préavis et ne constituent pas un engagement de la part d'Adobe Systems Incorporated. Adobe Systems Incorporated ne peut être tenu pour responsable des erreurs ou des inexactitudes apparaissant dans les informations fournies par ce guide.
Nous attirons votre attention sur le fait que les illustrations et images que vous pouvez être amené à incorporer à vos projets peuvent être protégées par des droits d'auteur, auquel cas leur exploitation sans l'autorisation de l'auteur constituerait une violation de ces droits.
Assurez-vous que toutes les autorisations requises ont été accordées par les auteurs.
Toute référence à des noms et à des logos de société dans les exemples ou les exemples de formulaires inclus dans ce logiciel sont utilisés à titre d'exemple uniquement et ne doivent faire référence à aucune société réelle.
Adobe, le logo Adobe, Acrobat, Kozuka Gothic, Kozuka Mincho, LiveCycle, Minion, Myriad, PhotoShop, PostScript et Reader sont des marques ou des marques déposées d'Adobe Systems Incorporated aux Etats-Unis et/ou dans d'autres pays.
BEA WebLogic Server est une marque déposée de BEA Systems, Inc.
IBM, AIX, DB2 et WebSphere sont des marques d'International Business Machines Corporation aux Etats-Unis et/ou dans d'autres pays.
Intel et Pentium sont des marques déposées d'Intel Corporation aux Etats-Unis et dans d'autres pays.
Linux est la marque déposée de Linus Torvalds aux Etats-Unis et dans d'autres pays.
Macintosh est une marque d'Apple Computer, Inc., déposée aux Etats-Unis et dans d'autres pays.
Microsoft, Windows et Windows Server sont des marques ou des marques déposées de Microsoft Corporation aux Etats-Unis et/ou dans d'autres pays.
Novell et SUSE sont des marques déposées de Novell, Inc. aux Etats-Unis et dans d'autres pays.
Oracle est une marque d'Oracle Corporation et peut être déposée dans certaines juridictions.
Red Hat et JBoss sont des marques ou des marques déposées de Red Hat, Inc. aux Etats-Unis et dans d'autres pays.
SUN, Java, JavaScript et Solaris sont des marques ou des marques déposées de Sun Microsystems, Inc. aux Etats-Unis et dans d'autres pays.
Toutes les marques SPARC sont concédées sous licence et sont des marques ou des marques déposées de SPARC International, Inc. Les produits de marque SPARC reposent sur une architecture développée par Sun Microsystems, Inc.
Toutes les autres marques citées sont la propriété de leurs détenteurs respectifs.
Ce logiciel est partiellement basé sur les travaux de l'Independent JPEG Group.
Copyright partiel 1992, 1993 Simmule Turner et Rich Salz. Tous droits réservés.
Ce produit inclut des logiciels développés par Apache Software Foundation (http://www.apache.org/).
Copyright partiel (C) 1991, 1999 Free Software Foundation, Inc. Les bibliothèques JBOSS, OmniORB et JacORB sont concédées sous licence publique générale pour bibliothèques GNU, dont une copie est fournie avec ce logiciel.
Ce produit inclut des logiciels BISAFE et/ou TIPEM de RSA Data Security, Inc.
Ce produit contient des éléments logiciels développés par Brian M. Clapper bmc@clapper.org.
Certaines parties de ce code sont concédées sous licence par Apple Computer, Inc. en vertu des dispositions de la version 2 de l'Apple Public Source License. La version du code source de ces parties ainsi que la licence correspondante sont disponibles à l'adresse http://www.opensource.apple.com/apsl/.
Certaines parties reposent sur les travaux de l'équipe FreeType.
Développé par Celequest. Intègre la technologie distribuée sous licence par Celequest Corporation. Copyright 2005 Celequest Corporation.
Tous droits réservés.
Ce produit inclut des logiciels développés par The Jaxen Project (http://www.jaxen.org/).
Ce programme a été écrit avec MacApp® : ©1985-1988 Apple Computer, Inc. APPLE COMPUTER, INC. N'OFFRE AUCUNE GARANTIE, EXPRESSE
OU TACITE, CONCERNANT CE PRODUIT, NOTAMMENT CONCERNANT SA QUALITE MARCHANDE OU SON ADEQUATION A UN USAGE
PARTICULIER. Le logiciel MacApp est la propriété d'Apple Computer, Inc. et est concédé sous licence à Adobe afin d'être distribué et utilisé exclusivement en association avec les logiciels Adobe.
Les parties concédées sous licence Mozilla Public License Version 1.1, sont disponibles sur le site www.mozilla.org. Le logiciel distribué dans le cadre de la présente licence est distribué « TEL QUEL », SANS AUCUNE GARANTIE, expresse ou autre. Consultez la Licence pour connaître les restrictions et les droits spécifiques à la langue régissant la Licence.
Adobe Systems Incorporated, 345 Park Avenue, San Jose, California 95110, Etats-Unis.
Avis aux utilisateurs finals du gouvernement des Etats-Unis. Le logiciel et la documentation sont des articles commerciaux (« Commercial
Items »), visés à l'article 48 C.F.R., alinéa 2.101, composés d'un logiciel commercial (« commercial computer software ») et d'une documentation relative au logiciel commercial (« commercial computer software documentation »), visés à l'article 48 C.F.R., alinéa 12.212 ou
48 C.F.R., alinéa 227.7202, selon le cas. Conformément à l'article 48 C.F.R., alinéa 12.212 ou 48 C.F.R., alinéas 227.7202-1 à 227.7202-4, selon le cas, le logiciel commercial et la documentation relative au logiciel commercial sont concédés sous licence aux utilisateurs finals du gouvernement américain (a) en tant qu'articles commerciaux uniquement et (b) avec les seuls droits conférés à tout autre utilisateur final tenu par les termes et conditions stipulés ici. Droits non publiés réservés en vertu de la législation américaine sur les droits d'auteur. Adobe
Systems Incorporated, 345 Park Avenue, San Jose, CA 95110, Etats-Unis. Pour les utilisateurs finals du gouvernement des Etats-Unis, Adobe s'engage à respecter toutes les lois sur l'égalité des chances, y compris, si approprié, les dispositions de l'Executive Order 11246, comme modifié, la section 402 de l'Acte d’assistance à la réhabilitation des vétérans du Vietnam (Vietnam Era Veterans Readjustment Assistance Act) de 1974 (38 USC 4212) et la section 503 de l'Acte de réhabilitation (Rehabilitation Act) de 1973, comme modifié, ainsi que les règlements de l'article 41 C.F.R., sections 60-1 à 60-60, 60-250 et 60-741. La clause d'action positive et la réglementation décrites dans la phrase précédente sont incluses par référence.
Table des matières
Conditions supplémentaires pour LiveCycle PDF Generator Elements et LiveCycle PDF
Partie I: Installation clé en main
2 Installation des produits LiveCycle à l'aide de la procédure d'installation clé en main ...... 20
4
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Table des matières
5
Partie II : Installation, configuration et déploiement manuels
10 Configuration des produits LiveCycle pour accéder
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Table des matières
6
Partie III : Configuration après le déploiement
Partie IV : Configuration supplémentaire de LiveCycle Workflow
C Appel de LiveCycle Assembler à l'aide de LiveCycle Workflow et de Watched Folder ......105
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Table des matières
7
Préface
Ce guide fait partie des ressources destinées à vous familiariser avec la suite de produits Adobe®
LiveCycle™ qui facilitent l'automatisation et l'accélération des flux d'informations essentiels en provenance ou à destination des clients, des partenaires, des administrés et des employés.
Contenu du guide
Ce guide décrit les procédures d'installation et de configuration des produits LiveCycle suivants sur
Microsoft® Windows® et Linux®, et explique comment les déployer sur un serveur d'applications JBoss® :
O
O
O
O
O
Adobe LiveCycle Assembler 7.2.1
Adobe LiveCycle Forms 7.2
Adobe LiveCycle Form Manager 7.2
Adobe LiveCycle PDF Generator 7.2 Professional, LiveCycle PDF Generator 7.2 Elements et
LiveCycle PDF Generator 7.2 pour PostScript®
Adobe LiveCycle Print 7.2
O
Adobe LiveCycle Workflow 7.2.1
Ce guide fournit également des informations sur l'installation et la configuration de Watched Folder 1.1.
A qui est destiné ce guide ?
Ce guide propose des informations aux administrateurs et aux développeurs responsables de l'installation, de la configuration, de la gestion ou du déploiement de produits LiveCycle. Il s'adresse donc à un public familiarisé avec les serveurs d'applications, les systèmes d'exploitation Linux et Windows, les serveurs de base de données MySQL, Oracle®, DB2® ou SQL Server, ainsi que les environnements Web.
Conventions utilisées dans ce guide
Ce guide utilise les conventions de désignation suivantes pour les chemins d'accès aux fichiers courants.
Nom
[racine LiveCycle]
Valeur par défaut
Windows :
C:\Adobe\LiveCycle\
Linux :
/opt/adobe/livecycle/
Description
Répertoire d'installation utilisé pour tous les produits LiveCycle. Il contient les sous-répertoires d'Adobe
Configuration Manager, les kits de développement logiciel et chaque produit LiveCycle installé (avec sa documentation).
8
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Préface
Documentation connexe 9
Nom
[racine produit]
[racine du serveur d'applications]
Valeur par défaut
Windows :
C:\Adobe\LiveCycle\Assembler
C:\Adobe\LiveCycle\pdfgenerator
C:\Adobe\LiveCycle\Workflow
C:\Adobe\LiveCycle\Forms
C:\Adobe\LiveCycle\Print
C:\Adobe\LiveCycle\Formmanager
Linux :
/opt/adobe/livecycle/assembler
/opt/adobe/livecycle/pdfgenerator
/opt/adobe/livecycle/workflow
/opt/adobe/livecycle/forms
/opt/adobe/livecycle/print
/opt/adobe/livecycle/formmanager
Windows (installation clé en main) :
C:\Adobe\LiveCycle\jboss\
Windows (installation manuelle) :
C:\jboss
Linux :
/opt/jboss
Répertoire dans lequel vous avez installé JBoss.
Description
Répertoires contenant les répertoires et fichiers spécifiques au produit
(documentation, fichiers de désinstallation, exemples et informations de licence).
Répertoire racine du serveur d'applications exécutant les produits
LiveCycle.
[racine bam jboss]
Répertoire racine de l'instance de
JBoss exécutant Business Activity
Monitor (BAM) Server.
La plupart des informations concernant l'emplacement des répertoires dans ce guide s'appliquent à toutes les plates-formes (tous les noms de fichiers et les chemins d'accès respectent la casse sous Linux).
Les informations concernant une plate-forme spécifique sont indiquées le cas échéant.
Documentation connexe
Ce guide contient des instructions de déploiement des produits LiveCycle sur JBoss. Vous trouverez les guides d'installation et de configuration des produits LiveCycle pour les autres serveurs d'applications pris en charge à l'adresse suivante : www.adobe.com/support/documentation/en/livecycle/
Les ressources figurant dans le tableau ci-après sont destinées à vous aider à utiliser les produits LiveCycle.
Pour plus de détails sur Voir
Les informations générales sur un produit et son intégration à d'autres produits Adobe
Les guides Présentation de chaque produit
L'architecture du produit, l'utilisation des API et le développement d'applications personnalisées à utiliser avec les produits
Les guides du développeur de chaque produit. Par exemple, Developing Custom Application for
LiveCycle Workflow ou Developing Applications for
LiveCycle Assembler.
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Préface
Informations mises à jour sur le produit LiveCycle 10
Pour plus de détails sur
L'API EJB, notamment des descriptions et des explications sur ses différentes classes et méthodes.
Voir
La référence API de chaque produit. La plupart des références API sont installées sous la forme de
JavaDocs avec chaque produit. Toutefois, certaines d'entre elles sont fournies au format PDF avec le produit.
Document Description XML Reference
La syntaxe de la grammaire DDX (Document
Description XML) et des grammaires XML connexes prise en charge par
LiveCycle Assembler
La configuration et le déploiement des dossiers de contrôle
L'aide sur l'administration de Watched Folder
La gestion de l'accès à l'interface utilisateur
Adobe Administrator
L'utilisation de LiveCycle Workflow Designer
Aide sur l'administration de User Management
Création de flux de production ou aide de LiveCycle
Workflow Designer
L'utilisation du kit de développement logiciel de
LiveCycle Workflow pour créer des QPAC (Quick
Process Action Components) qui appellent des méthodes dans les API EJB des produits
LiveCycle
Les guides QPAC, disponibles avec le kit de développement logiciel de LiveCycle. Par exemple,
Using LiveCycle Assembler QPACs ou Using
LiveCycle Forms QPACs.
Les autres services et produits qui s'intègrent aux produits LiveCycle www.adobe.com
Les mises à jour des correctifs, les explications techniques et les informations complémentaires sur cette version du produit www.adobe.com/support/products/enterprise
/index.html
Pour plus de détails sur la documentation supplémentaire disponible pour chaque produit LiveCycle, consultez les fichiers doc_map.pdf situés dans chaque dossier [racine produit]/documentation.
Remarque :
lorsque vous copiez et collez des chaînes depuis ce guide, vous pouvez copier la balise <CR> si les instructions s'étendent sur une ligne du guide.
Informations mises à jour sur le produit LiveCycle
Adobe Systems a publié un article sur le centre de consultation Adobe Knowledge Center afin de communiquer à ses clients toutes les informations de mise à jour des produits LiveCycle. Vous pouvez consulter cet article à l'adresse : www.adobe.com/support/products/enterprise/knowledgecenter/c4811.pdf
.
1
Avant l'installation
Ce chapitre décrit la préparation de votre système à l'installation des produits LiveCycle :
O
« A propos du processus d'installation, de configuration et de déploiement », page 11
O
« Méthodes d'installation, de configuration et de déploiement des produits LiveCycle », page 12
O
O
O
O
« Installation et déploiement de plusieurs produits LiveCycle », page 12
« Configuration système requise », page 13
« Aide-mémoire pour l'installation, la configuration et le déploiement », page 16
« Informations mises à jour sur le produit LiveCycle », page 18
Avant de procéder à l'installation des produits LiveCycle sur votre serveur d'applications, rendez-vous sur la page de téléchargement du produit Adobe LiveCycle à l'adresse suivante pour vérifier que vous disposez bien de la dernière version du logiciel : www.adobe.com/support/products/enterprise/support_downloads.html
A propos du processus d'installation, de configuration et de déploiement
L'installation, la configuration et le déploiement de produits LiveCycle impliquent les procédures suivantes :
Installation : lors de l'installation des produits, tous les fichiers requis sont copiés sur votre système dans une même arborescence d'installation. Pour installer les produits, il vous suffit d'exécuter le programme d'installation. Le répertoire d'installation par défaut est C:\Adobe\LiveCycle (sous
Windows) ou /opt/adobe/livecycle (sous Linux). Toutefois, vous pouvez installer les fichiers dans un autre répertoire. Dans ce guide, le répertoire d'installation par défaut s'appelle [racine LiveCycle]. Pour que plusieurs produits LiveCycle puissent fonctionner ensemble, vous devez tous les installer dans le même emplacement [racine LiveCycle]. Vous pouvez ainsi assembler les différents produits LiveCycle
dans un fichier EAR. Reportez-vous à la section « Installation des produits LiveCycle », page 38 .
Configuration et assemblage : la configuration des produits modifie une série de paramètres déterminant leur fonctionnement. L'assemblage des produits regroupe tous les composants installés dont les produits ont besoin dans un fichier EAR déployable, en tenant compte de vos instructions de configuration. Pour configurer et assembler les produits pour le déploiement, exécutez
Déploiement : le déploiement des produits implique celui du fichier EAR assemblé et de quelques autres fichiers configurés sur le serveur d'applications JBoss sur lequel vous prévoyez d'exécuter la solution LiveCycle. Si vous avez configuré et assemblé plusieurs produits, la plupart des éléments pouvant être déployés pour ces derniers se trouvent dans un seul fichier LiveCycle.ear déployable.
Initialisation de la base de données LiveCycle : l'initialisation de la base de données crée des tables à utiliser avec Adobe User Management et certains produits LiveCycle. Pour déployer un produit
LiveCycle nécessitant une connexion à la base de données LiveCycle, vous devez initialiser celle-ci une fois le déploiement effectué. Reportez-vous à la section
« Initialisation de la base de données », page 67
.
11
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Avant l'installation
Méthodes d'installation, de configuration et de déploiement des produits LiveCycle 12
Méthodes d'installation, de configuration et de déploiement des produits LiveCycle
Vous pouvez utiliser l'une des méthodes suivantes pour installer, configurer et déployer les produits
LiveCycle ou encore initialiser la base de données :
Installation clé en main (Windows/JBoss/MySQL) : permet d'installer les fichiers, d'exécuter
Configuration Manager pour configurer le fichier EAR et les autres composants, puis de lancer automatiquement les tâches suivantes :
O
O
O
Installer et configurer le serveur d'applications JBoss et la base de données MySQL.
Assembler les produits et les déployer sur JBoss.
Initialiser la base de données MySQL.
La procédure d'installation clé en main ne configure pas SSL. (Reportez-vous à la section
« Aide-mémoire pour l'installation et le déploiement clé en main », page 17
).
Installation manuelle : permet d'installer les fichiers, puis d'exécuter Configuration Manager pour configurer le serveur d'applications, le fichier EAR et les autres composants et déployer le fichier EAR.
Vous pouvez également configurer votre serveur d'applications et déployer votre fichier EAR manuellement. Toutefois, vous devez installer, configurer et démarrer manuellement le serveur d'applications et vous devez créer et configurer la base de données avant d'exécuter
Configuration Manager et de le déployer sur le serveur d'applications. Vous devez également exécuter
Configuration Manager une seconde fois (après le déploiement) pour initialiser la base de données.
Reportez-vous à la section « Aide-mémoire pour l'installation et le déploiement manuels », page 17
.
Installation et déploiement de plusieurs produits LiveCycle
Pour déployer plusieurs produits LiveCycle présentés dans ce guide de façon à ce qu'ils puissent interagir, vous devez les installer dans le même emplacement, les assembler dans un seul fichier EAR, puis déployer ce fichier.
Remarque :
pour installer plusieurs produits de la suite de produits LiveCycle 7.2, respectez l'ordre suivant :
O
LiveCycle PDF Generator
O
O
LiveCycle Assembler, LiveCycle Forms, LiveCycle Form Manager, LiveCycle Print,
LiveCycle Workflow
LiveCycle Document Security, LiveCycle Policy Server, LiveCycle Reader Extensions
Pour une documentation détaillée sur l'installation de plusieurs produits, reportez-vous à l'article publié sur le centre de consultation Adobe Knowledge Center à l'adresse : www.adobe.com/support/products/enterprise/knowledgecenter/c4811.pdf
.
Mise à niveau des produits LiveCycle
Pour obtenir des informations sur la mise à niveau des produits LiveCycle, reportez-vous à la section
à niveau des produits LiveCycle vers la version 7.2 ou 7.2.1 », page 118
de ce guide.
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Avant l'installation
A propos de l'installation de Watched Folder 13
A propos de l'installation de Watched Folder
LiveCycle Assembler et LiveCycle PDF Generator peuvent utiliser la fonctionnalité de dossier de contrôle comme méthode de lancement des tâches à traiter. Cependant, LiveCycle Assembler et
LiveCycle PDF Generator reposent sur des technologies de dossier de contrôle différentes.
LiveCycle Assembler utilise le service Watched Folder que vous pouvez installer séparément et configurer avec LiveCycle Workflow et Configuration Manager. Ce service figure dans le fichier déployable
LiveCycle.ear.
LiveCycle PDF Generator utilise une fonctionnalité de dossier de contrôle intégrée qui ne requiert pas d'installation distincte. Les tâches de configuration requises pour les dossiers de contrôle de
LiveCycle PDF Generator sont présentées dans la section « Tâches de post-déploiement de
LiveCycle PDF Generator », page 31
.
Dans ce guide, toutes les autres références à Watched Folder concernant l'installation et la configuration se rapportent au service utilisé par LiveCycle Workflow et LiveCycle Assembler.
Configuration système requise
Cette section fournit des détails sur la configuration logicielle et matérielle requise pour l'exécution des produits LiveCycle.
Remarque :
si vous avez choisi l'option d'installation et de configuration clé en main, seuls le kit de développement Java™ (JDK) et un navigateur Web pris en charge sont requis. La méthode clé en main installe et configure JBoss (ainsi que le serveur Web Apache) et une base de données MySQL.
Le JDK n'est pas un prérequis à LiveCycle PDF Generator. S'il n'est pas encore installé, le programme d'installation clé en main s'en charge.
Logiciels pris en charge
Ce tableau offre un récapitulatif des serveurs d'applications, des navigateurs Web et des versions JDK pris
.
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Logiciels requis
Système d'exploitation
Serveur d'applications
Navigateur Web
JDK
Base de données
Avant l'installation
Logiciels pris en charge 14
Version prise en charge
O
Microsoft Windows Server™ 2003 Enterprise Edition ou Standard
Edition
O
O
O
(LiveCycle Workflow Designer) Microsoft Windows XP Service Pack 2
SUSE™ Linux Enterprise Server 9.0 i386 (32 bits)
Red Hat® Linux Advanced Server 2.1 ou 3.0
Remarque :
LiveCycle PDF Generator Elements et LiveCycle PDF
Generator Professional ne sont pris en charge que par
Microsoft Windows Server 2003.
O
O
JBoss Application Server 3.2.5
JBoss Application Server 3.2.6 (applicable uniquement à BAM
Server, un composant de LiveCycle Workflow Server)
Remarque :
Votre serveur d'applications doit disposer d'une connexion Internet active pour accéder à LiveCycle
Administrator.
O
O
Microsoft Internet Explorer 6.0 pour Windows
Netscape 7.1 ou version ultérieure pour Windows
O
O
O
O
Netscape 7.2 ou version ultérieure pour Linux
Mozilla 1.8 ou version ultérieure pour Windows et Linux
Safari 1.2.3, Safari 1.3, Safari 2.0 (prise en charge de l'utilisateur final pour Macintosh uniquement)
(LiveCycle Forms) Firefox 1.0
Remarque :
LiveCycle PDF Generator prend uniquement en charge
Microsoft Internet Explorer 6.0.
O
J2SDK version 1.4.2_04 ou version ultérieure à la 1.4.2 (la version
1.4.2_10 n'est pas prise en charge)
Vous devez créer ou définir la variable d'environnement
JAVA_HOME
en fonction du répertoire d'installation de Java. Vérifiez que le répertoire
\bin de Java 2 Standard Edition (J2SE) figure dans la variable d'environnement
PATH
. (Ceci n'est pas nécessaire pour
LiveCycle PDF Generator et LiveCycle Assembler.)
O
Microsoft SQL Server 2000 SP 3
O
O
O
O
MySQL 4.1
(Clé en main) HSQLDB 1.7.1 utilisé en tant que base de données
JBoss JMS (HSQLDB 1.7.1 est fourni avec JBoss 3.2.5)
Oracle 9i
Oracle 10g
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Avant l'installation
Associations de plates-formes et de logiciels 15
Logiciels requis
Pilote de base de données
Serveur LDAP
Version prise en charge
O
IBM DB2 : db2jcc.jar et db2jcc_license_cu.jar
O
O
O
O
O
O
O
O
Microsoft SQL Server 2000 : msbase.jar, mssqlserver.jar et msutil.jar
MySQL : mysql-connector-java-3.0.15-ga-bin.jar
Microsoft SQL Server 2000 pour BAM : msbase.jar, mssqlserver.jar et msutil.jar
Oracle - ojdbc14.jar, version 10.2.0.2
Sun ONE 5.1, 5.2
Microsoft Active Directory 2000
Microsoft Active Directory 2003
Novell® eDirectory 8.7
Remarque :
si vous choisissez l'installation clé en main, l'ordinateur cible ne doit pas exécuter d'instances du serveur d'applications JBoss ou du serveur de bases de données MySQL.
Associations de plates-formes et de logiciels
Ce tableau propose un récapitulatif des combinaisons logicielles et de bases de données prises en charge par
JBoss 3.2.5. Pour obtenir une liste complète des logiciels pris en charge sur chaque système d'exploitation,
reportez-vous à la section « Associations de plates-formes et logiciels prises en charge », page 101
.
Remarque :
LiveCycle PDF Generator Elements et LiveCycle PDF Generator Professional fonctionnent uniquement sur la plate-forme Windows Server 2003 Enterprise Edition.
Système d'exploitation
Red Hat Linux Advanced Server 3.0
Microsoft Windows Server 2003 Enterprise Edition ou Standard
Edition
Base de données
Microsoft SQL Server 2000 SP 3
MySQL 4.1
Configuration matérielle requise
Le tableau présenté dans cette section dresse la liste des systèmes d'exploitation pris en charge et du matériel correspondant. Il s'agit de la configuration minimale requise pour tout type d'installation :
O
O
O
Espace disque pour l'installation : 3 Go par produit, hormis LiveCycle PDF Generator qui requiert 3,5 Go.
Espace système temporaire pendant l'installation : 3 Go.
Mémoire pour l'exécution des produits : 1 Go par produit pour chaque unité centrale, hormis
LiveCycle PDF Generator qui requiert 1,5 Go par unité centrale.
Système d'exploitation
Windows Server 2003 Enterprise Edition ou
Standard Edition
Configuration matérielle requise
Processeur Intel® Pentium® 3 ou x86 équivalent, 1 GHz
SUSE Linux Enterprise Server 9.0 i386 (32 bits) Processeur Pentium 3 ou équivalent x86, 1 GHz
Red Hat Linux Advanced Server 2.1 ou 3.0
Processeur Pentium 3 ou équivalent x86, 1 GHz
Adobe LiveCycle Avant l'installation
Installation et configuration de LiveCycle pour JBoss Conditions supplémentaires pour LiveCycle PDF Generator Elements et LiveCycle PDF Generator Professional 16
Conditions supplémentaires pour LiveCycle PDF Generator Elements et
LiveCycle PDF Generator Professional
LiveCycle PDF Generator Elements et LiveCycle PDF Generator Professional doivent être installés sur
Microsoft Windows Server 2003 utilisant les paramètres régionaux en_US. L'utilisateur de Windows qui installe le produit doit posséder des droits administratifs et avoir au préalable installé lui-même
Microsoft Office sur l'ordinateur.
Avant d'installer LiveCycle PDF Generator Elements ou LiveCycle PDF Generator Professional, vous devez vous assurer que ni Adobe Acrobat® Professional ni Acrobat Standard ne sont installés. Si l'un de ces programmes est installé, vous devez le supprimer, puis redémarrer l'ordinateur. Adobe Reader® peut toutefois être installé.
Avant d'installer LiveCycle PDF Generator Elements ou LiveCycle PDF Generator Professional, vous devez
également installer le logiciel prenant en charge les formats de fichier nécessitant la prise en charge de la conversion PDF. LiveCycle PDF Generator Elements et LiveCycle PDF Generator Professional peuvent être
étendus pour convertir ces fichiers supplémentaires au moyen des applications suivantes :
O
O
O
O
Microsoft Office 2000, XP ou 2003
(LiveCycle PDF Generator Professional) Microsoft Office Visio 2003
(LiveCycle PDF Generator Professional) Microsoft Project 2003
(LiveCycle PDF Generator Professional) AutoCAD 2005
O
O
Corel WordPerfect 12
Adobe Photoshop® CS2
Avant de terminer l'installation clé en main de LiveCycle PDF Generator sous Windows, vérifiez que l'outil de ligne de commande Service Control Manager, sc.exe, est installé dans la variable d'environnement Windows. Ce logiciel n'est pas préalablement installé sur certains serveurs Windows. Le fichier sc.exe est installé par défaut dans le répertoire \Windows\system32.
LiveCycle PDF Generator Professional et LiveCycle PDF Generator Elements doivent être installés sur le serveur sur lequel ils doivent être configurés et déployés.
Conditions supplémentaires pour LiveCycle PDF Generator pour PostScript
LiveCycle PDF Generator pour PostScript est pris en charge par tous les systèmes d'exploitation répertoriés à la section
« Logiciels pris en charge », page 13
.
Pour installer LiveCycle PDF Generator pour PostScript sous Linux, vérifiez que l'outil bc (langage de calcul numérique en précision arbitraire) est installé sur l'ordinateur. Vous pouvez télécharger l'outil bc GNU à l'adresse : www.gnu.org/software/bc/bc.html
.
Aide-mémoire pour l'installation, la configuration et le déploiement
Cette section présente les aide-mémoire que vous pouvez utiliser lors du processus d'installation et de configuration. Un aide-mémoire est fourni pour l'installation et la configuration à l'aide de la méthode clé en main ou manuelle.
Avant de lancer l'installation, vérifiez que les fichiers JAR ne sont pas associés à WinZip ou à toute application autre que le programme de lancement java.
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Avant l'installation
Aide-mémoire pour l'installation et le déploiement clé en main 17
Aide-mémoire pour l'installation et le déploiement clé en main
Le tableau suivant indique les étapes nécessaires à l'installation des produits LiveCycle à l'aide de l'option clé en main.
Optez pour ce type d'installation et de configuration si vous ne disposez pas encore d'un serveur d'applications installé et configuré et que vous souhaitez utiliser JBoss ou que vous voulez l'installer et le configurer au plus vite à des fins de test ou de démonstration.
N'utilisez pas l'option clé en main si vous envisagez d'activer SSL. Si vous souhaitez utiliser SSL, optez pour
Tâche Section
Vérifiez que les logiciels nécessaires ont été installés dans l'environnement cible.
« Configuration système requise », page 13
Exécutez le programme d'installation en activant l'option clé en main pour JBoss. Le produit, JBoss et MySQL sont installés et configurés.
« Installation des produits LiveCycle
à l'aide de la procédure d'installation clé en main », page 20
Accédez à Administrator et User Management.
« Accès à Administrator », page 26
Vérifiez le fichier journal.
« Affichage des fichiers journaux », page 66
Aide-mémoire pour l'installation et le déploiement manuels
Le tableau suivant indique les étapes nécessaires à l'installation des produits LiveCycle à l'aide de la procédure manuelle. Le serveur d'applications doit être installé pour que vous puissiez effectuer l'installation.
Ce type d'installation convient aux environnements de production.
Remarque :
si vous installez plusieurs produits, vérifiez qu'ils sont tous installés avant d'exécuter
Configuration Manager pour les configurer et les déployer.
Tâche Section
Vérifiez que les logiciels nécessaires ont été installés dans l'environnement cible.
« Configuration système requise », page 13
Créez la base de données à utiliser avec
User Management, puis installez le serveur d'applications et préparez-le.
« Préparation de l'environnement », page 42
Exécutez le programme d'installation.
Exécutez Configuration Manager et sélectionnez l'assistant de configuration personnalisée. Ce dernier va configurer et assembler les produits.
LiveCycle à déployer », page 49
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Avant l'installation
Informations mises à jour sur le produit LiveCycle 18
Tâche Section
Configurez les paramètres de JBoss. Vous pouvez configurer divers paramètres.
« Configuration manuelle de JBoss », page 54
Déployez les fichiers de déploiement des produits sur le serveur d'applications.
« Déploiement manuel sur JBoss », page 64
Exécutez Configuration Manager pour initialiser la base de données.
Accédez à Administrator et User Management.
« Initialisation de la base de données », page 67
« Accès à Administrator », page 26
Configurez l'accès LDAP.
LiveCycle pour accéder à LDAP », page 69
Configurez SSL sur le serveur d'applications, le cas
échéant.
« Configuration de SSL sur JBoss », page 74
(LiveCycle Workflow) Créez la base de métadonnées BAM et configurez le serveur d'applications pour BAM Server.
« Configuration manuelle de JBoss pour BAM Server », page 77
Vérifiez le fichier journal.
« Affichage des fichiers journaux », page 66
Informations mises à jour sur le produit LiveCycle
Adobe Systems a publié un article sur le centre de consultation Adobe Knowledge Center afin de communiquer à ses clients toutes les informations de mise à jour des produits LiveCycle. Vous pouvez consulter cet article sur le centre de consultation Adobe Knowledge Center à l'adresse : www.adobe.com/support/products/enterprise/knowledgecenter/c4811.pdf
.
Partie I: Installation clé en main
Cette section du guide décrit la procédure d'installation clé en main des produits LiveCycle.
Pour plus de détails sur la configuration et le déploiement manuels des produits, reportez-vous à la section
« Installation, configuration et déploiement manuels », page 34
.
19
2
Installation des produits LiveCycle à l'aide de la procédure d'installation clé en main
Ce chapitre décrit la procédure d'installation des produits LiveCycle à l'aide de la méthode d'installation clé en main. Le processus d'installation clé en main effectue automatiquement toutes les tâches requises pour installer et configurer les produits LiveCycle sur un serveur d'applications JBoss exécuté sous Windows.
Le processus d'installation clé en main réalise les tâches suivantes :
O installation des fichiers du produit ;
O
O
O
O installation d'une version préconfigurée de JBoss 3.2.5 (incluant le serveur Web Apache) ; installation d'une version préconfigurée de MySQL 4.1 ;
(LiveCycle PDF Generator) installation d'un JDK si le système cible n'en contient pas ; démarrage de Configuration Manager ;
O
O
O configuration et assemblage des composants du produit LiveCycle ; déploiement de tous les composants requis sur JBoss ; initialisation de MySQL lors de l'installation des produits LiveCycle nécessitant User Management.
Exécution d'une installation clé en main
Avant d'exécuter l'installation clé en main, vérifiez que l'environnement dans lequel vous installez et déployez les produits LiveCycle correspond à la configuration système requise. (Consultez la remarque de
la section « Configuration système requise », page 13
.) Cette procédure comprend l'installation manuelle de la version requise du JDK. Pendant l'installation clé en main, vous êtes invité à indiquer le répertoire racine du JDK. L'installation clé en main installe alors automatiquement JBoss et MySQL.
Elle définit « localhost » comme nom d'hôte. Le port 8080 est à utiliser pour JBoss et le port 3306 pour MySQL. Si JBoss et MySQL sont déjà installés, vérifiez qu'ils n'utilisent pas ces ports. Vous ne pouvez pas configurer un autre nom d'hôte ou port pour JBoss ou MySQL pendant le processus d'installation et de configuration clé en main.
Par défaut, l'installation clé en main place le produit LiveCycle et tous les composants et logiciels connexes dans le répertoire \Adobe\LiveCycle (appelé [racine LiveCycle]).
Remarque :
pour réussir l'installation, des autorisations de lecture et d'écriture doivent figurer dans le répertoire d'installation. Voici les répertoires d'installation par défaut mais vous pouvez spécifier un autre répertoire, au besoin :
O
Windows : C:\Adobe\LiveCycle\
O
Linux : /opt/adobe/livecycle/
JBoss et MySQL sont installés et exécutés à partir des répertoires [racine LiveCycle]/jboss et [racine LiveCycle]/ mysql, mais vous pouvez spécifier un autre répertoire en saisissant son chemin d'accès ou en le recherchant.
L'installation clé en main crée les services Windows suivants :
O
JBoss pour Adobe LiveCycle
O
MySQL pour Adobe LiveCycle
20
Adobe LiveCycle
Installing and Configuring LiveCycle pour JBoss
Installation des produits LiveCycle à l'aide de la procédure d'installation clé en main
Exécution d'une installation clé en main 21
O
(LiveCycle Workflow) JBoss pour Adobe LiveCycle Workflow BAM
Ces services sont utilisés par Configuration Manager pendant l'installation clé en main. Ils peuvent être démarrés et arrêtés via le Panneau de configuration Windows (Outils d'administration - Services).
Remarque :
si JBoss et MySQL sont déjà installés, vous devez les arrêter avant d'exécuter l'installation clé en main.
Pour l'installation clé en main, il est recommandé d'accepter les options de configuration par défaut. Si vous préférez définir toutes les options de configuration, exécutez la procédure manuelle d'installation, de configuration et de déploiement. Pour plus de détails sur les options de configuration, reportez-vous à la section
« Configuration des produits LiveCycle à déployer », page 49
.
Conseil :
pour accélérer l'installation, désactivez tout logiciel d'analyse antivirus à l'accès pour la durée de la procédure.
Appliquez la procédure suivante pour installer tous les produits à l'exception de LiveCycle PDF Generator.
Reportez-vous à la section
« Pour exécuter l'installation clé en main de LiveCycle PDF Generator : », page 23 .
³
Pour exécuter l'installation clé en main :
1. A la racine du DVD d'installation, cliquez deux fois sur le fichier .exe.
2. Lorsque vous y êtes invité, sélectionnez la langue du programme d'installation et cliquez sur OK.
3. Cliquez sur Suivant dans l'écran de bienvenue.
4. Dans l'écran Avant l'installation, cliquez sur Suivant.
5. Entrez le numéro de série dans la zone de texte, puis cliquez sur Suivant.
6. Lisez l'accord de licence du produit, sélectionnez J'accepte les termes du contrat de licence, puis cliquez sur Suivant.
Remarque :
en fonction du produit que vous installez, il est possible que les étapes suivantes soient à exécuter dans l'ordre inverse.
7. Sélectionnez JBoss, sélectionnez Configurer et déployer automatiquement le produit, puis cliquez sur Suivant.
8. Lisez les informations de licence associées à l'installation de JBoss, sélectionnez J'accepte les termes
du contrat de licence, puis cliquez sur Suivant.
9. Lisez les informations de licence associées à l'installation de MySQL, sélectionnez J'accepte les termes
du contrat de licence, puis cliquez sur Suivant.
10. Au besoin, saisissez le chemin d'accès à votre JDK ou cliquez sur Parcourir pour rechercher son répertoire racine, puis cliquez sur Suivant.
11. Acceptez l'emplacement par défaut du répertoire Adobe indiqué ou cliquez sur Parcourir pour rechercher le répertoire dans lequel installer le produit, puis cliquez sur Suivant.
Remarque :
si vous saisissez le nom d'un répertoire qui n'existe pas, ce dernier est créé pour vous.
12. Vérifiez les détails d'installation, puis cliquez sur Installer. Un écran récapitulatif apparaît lorsque l'installation du produit est terminée.
Adobe LiveCycle
Installing and Configuring LiveCycle pour JBoss
Installation des produits LiveCycle à l'aide de la procédure d'installation clé en main
Exécution d'une installation clé en main 22
13. Dans l'écran récapitulatif, configurez les options suivantes :
O
O
Si vous n'installez qu'un produit LiveCycle ou s'il s'agit du dernier produit LiveCycle que vous installez, sélectionnez Exécuter Configuration Manager, puis cliquez sur Terminer. Passez à l'étape
Si vous prévoyez d'installer d'autres produits LiveCycle, cliquez sur Terminer pour quitter le programme d'installation et exécutez les programmes d'installation des autres produits.
14. Si vous y êtes invité, sélectionnez la langue souhaitée pour l'interface de Configuration Manager et cliquez sur OK.
15. Dans l'écran de bienvenue, cliquez sur Suivant.
16. Dans l'écran du type de configuration, sélectionnez Assistant de configuration classique, puis cliquez Suivant.
17. Dans l'écran Préférences de configuration, sélectionnez Utiliser les valeurs saisies ou Rétablir les
valeurs par défaut, puis cliquez sur Suivant.
Remarque :
cet écran s'affiche uniquement si vous avez précédemment exécuté Configuration Manager.
18. Si nécessaire, dans l'écran de sélection du produit, sélectionnez JBoss comme le type de serveur d'applications utilisé.
19. Au besoin, sélectionnez Création et les produits à configurer et déployer, puis cliquez sur Suivant.
20. (LiveCycle Forms) Dans l'écran de sélection d'Adobe User Management, sélectionnez LiveCycle Forms
avec User Management et Administration ou LiveCycle Forms sans User Management et
Administration, puis cliquez sur Suivant.
21. Dans l'écran Configurer et assembler les produits, cliquez sur Suivant.
22. Vérifiez les détails de l'écran Configuration et assemblage de l'application - Résumé, puis cliquez sur
Suivant. Configuration Manager configure les propriétés des produits LiveCycle à l'aide des valeurs par défaut et assemble les produits dans le fichier LiveCycle.ear.
23. Une fois la configuration et l'assemblage terminés, cliquez sur Suivant.
24. Dans l'écran de déploiement de LiveCycle, cliquez sur Suivant.
25. Dans l'écran de résumé du déploiement des produits, cliquez sur Suivant.
26. Dans la zone URL de base du serveur d'applications, entrez l'URL que Configuration Manager peut utiliser pour se connecter au serveur d'applications, puis cliquez sur Suivant. L'URL doit posséder le format suivant : http://[nomhôte]:[port]
[nomhôte]
correspondant au nom ou à l'adresse IP de l'ordinateur hébergeant le serveur d'applications et
[port]
étant le port du service HTTP que le serveur d'applications utilise (par exemple, http://localhost:8080).
27. Dans l'écran de préparation de la base de données pour LiveCycle, cliquez sur Suivant.
28. Dans l'écran Instructions de déploiement, cliquez sur Suivant.
Adobe LiveCycle
Installing and Configuring LiveCycle pour JBoss
Installation des produits LiveCycle à l'aide de la procédure d'installation clé en main
Exécution d'une installation clé en main 23
29. Dans l'écran d'initialisation de la base de données, cliquez sur Initialiser la base de données pour connecter vos produits LiveCycle à la base de données, puis cliquez sur Suivant.
30. Dans l'écran d'initialisation de la base de données, cliquez sur Initialiser la base de données, puis sur
Suivant une fois la tâche effectuée.
31. Dans l'écran Tâches effectuées, cliquez sur Terminer.
Le déploiement du produit sur JBoss est maintenant terminé, et JBoss doit être en cours d'exécution.
Si ce n'est pas le cas, vous pouvez démarrer le service JBoss pour Adobe LiveCycle à l'aide du service
Windows.
Les services JBoss et MySQL sont installés par défaut avec le type de démarrage « Manuel ». Vous pouvez modifier ce paramètre en sélectionnant Démarrer > Outils d'administration > Services, en recherchant ces services et en les basculant sur « Automatique ». Si vous redémarrez l'ordinateur sans avoir procédé à ce changement, vous devrez lancer manuellement les services JBoss et MySQL.
Le fichier journal de JBoss (server.log) se situe dans le répertoire [racine LiveCycle]/jboss/server/all/log.
Ce fichier contient des informations sur l'activité et la progression de JBoss.
³
Pour exécuter l'installation clé en main de LiveCycle PDF Generator :
1. A la racine du DVD d'installation, cliquez deux fois sur le fichier .exe.
2. Lorsque vous y êtes invité, sélectionnez la langue du programme d'installation et cliquez sur OK.
3. Cliquez sur Suivant dans l'écran de bienvenue.
4. Entrez le numéro de série dans la zone de texte, puis cliquez sur Suivant.
5. (LiveCycle PDF Generator Professional, LiveCycle PDF Generator Elements) Dans l'écran des conditions de pré-installation d'Adobe LiveCycle PDF Generator 7.2, passez en revue les conditions prérequises, puis cliquez sur Suivant.
6. Si vous êtes invité à désactiver le logiciel d'analyse anti-virus, cliquez sur Suivant. Il est recommandé de désactiver le logiciel d'analyse anti-virus pendant le processus d'installation pour optimiser la vitesse d'installation.
7. Lisez l'accord de licence du produit, sélectionnez J'accepte les termes du contrat de licence, puis cliquez sur Suivant.
8. Acceptez l'emplacement par défaut du répertoire Adobe indiqué ou cliquez sur Parcourir pour rechercher le répertoire dans lequel installer le produit, puis cliquez sur Suivant.
Remarque :
si vous saisissez le nom d'un répertoire qui n'existe pas, ce dernier est créé pour vous.
Remarque :
si vous installez plusieurs produits LiveCycle, vous devez tous les installer dans le même répertoire [racine LiveCycle].
9. Sélectionnez JBoss, sélectionnez Configurer et déployer automatiquement le produit, puis cliquez sur Suivant.
10. Au besoin, saisissez le chemin d'accès à votre JDK ou cliquez sur Parcourir pour rechercher son répertoire racine, puis cliquez sur Suivant.
11. Lisez les informations de licence associées à l'installation de JBoss, sélectionnez J'accepte les termes
du contrat de licence, puis cliquez sur Suivant.
Adobe LiveCycle
Installing and Configuring LiveCycle pour JBoss
Installation des produits LiveCycle à l'aide de la procédure d'installation clé en main
Exécution d'une installation clé en main 24
12. Lisez les informations de licence associées à l'installation de MySQL, sélectionnez J'accepte les termes
du contrat de licence, puis cliquez sur Suivant.
13. (LiveCycle PDF Generator Professional, LiveCycle PDF Generator Elements) Saisissez le nom d'utilisateur et le mot de passe de l'administrateur de Microsoft Office (si ces logiciels sont installés), puis cliquez sur Suivant.
14. (LiveCycle PDF Generator Professional, LiveCycle PDF Generator Elements) Dans l'écran Corel
WordPerfect, recherchez l'emplacement du fichier exécutable de Corel WordPerfect (si ce logiciel est installé) et cliquez sur Suivant ou, si Corel WordPerfect n'est pas installé, cliquez sur Suivant.
15. (LiveCycle PDF Generator Professional, LiveCycle PDF Generator Elements) Dans l'écran d'Adobe
Photoshop, recherchez l'emplacement du fichier exécutable d'Adobe Photoshop (si ce logiciel est installé) et cliquez sur Suivant ou, si Photoshop n'est pas installé, cliquez sur Suivant.
16. Vérifiez les détails d'installation, puis cliquez sur Installer. Un écran récapitulatif apparaît lorsque l'installation du produit est terminée.
17. L'écran récapitulatif contient les options suivantes :
O
O
Si vous n'installez qu'un produit LiveCycle ou s'il s'agit du dernier produit LiveCycle que vous installez, sélectionnez Exécuter Configuration Manager, puis cliquez sur Terminer. Passez à l'étape
Si vous prévoyez d'installer d'autres produits LiveCycle, cliquez sur Terminer pour quitter le programme d'installation et exécutez les programmes d'installation des autres produits.
18. Si vous y êtes invité, sélectionnez la langue souhaitée pour l'interface de Configuration Manager et cliquez sur OK.
19. Dans l'écran de bienvenue, cliquez sur Suivant.
20. Sélectionnez Assistant de configuration classique, puis cliquez sur Suivant.
21. Dans l'écran Préférences de configuration, sélectionnez Utiliser les valeurs saisies ou Rétablir les
valeurs par défaut, puis cliquez sur Suivant.
Remarque :
cet écran s'affiche uniquement si vous avez précédemment exécuté
Configuration Manager.
22. Si nécessaire, sélectionnez JBoss comme type de serveur d'applications utilisé.
23. Sélectionnez Plate-forme, puis les produits que vous souhaitez configurer et déployer. Cliquez ensuite sur Suivant.
24. Dans l'écran récapitulatif de configuration et d'assemblage, cliquez sur Suivant.
25. Vérifiez les détails récapitulatifs de configuration, puis cliquez sur Suivant. Configuration Manager configure les propriétés des produits LiveCycle à l'aide des valeurs par défaut et assemble les produits dans le fichier LiveCycle.ear et le fichier supplémentaire pdfg-all.ear ou pdfg-ps-all.ear.
26. Dans l'écran Configurer et assembler les produits, cliquez sur Suivant.
27. Dans la zone URL de base du serveur d'applications, saisissez l'URL que Configuration Manager peut utiliser pour se connecter au serveur d'applications. L'URL doit posséder le format suivant :
Adobe LiveCycle
Installing and Configuring LiveCycle pour JBoss
Installation des produits LiveCycle à l'aide de la procédure d'installation clé en main
Modification des services LiveCycle 25 http://[nomhôte]:[port]
[nomhôte]
correspondant au nom ou à l'adresse IP de l'ordinateur hébergeant le serveur d'applications et
[port]
étant le port du service HTTP que le serveur d'applications utilise
(par exemple, http://localhost:8080
).
28. Dans l'écran de déploiement des produits, cliquez sur Suivant.
29. Dans l'écran Instructions de déploiement, cliquez sur Suivant.
30. Dans l'écran d'initialisation de la base de données, cliquez sur Initialiser la base de données pour connecter vos produits LiveCycle à la base de données, puis cliquez sur Suivant.
31. Dans l'écran Tâches effectuées, cliquez sur Terminer.
Le déploiement du produit sur JBoss est maintenant terminé, et JBoss doit être en cours d'exécution.
Si ce n'est pas le cas, vous pouvez démarrer le service JBoss pour Adobe LiveCycle à l'aide du service
Windows.
Le fichier journal de JBoss (server.log) se situe dans le répertoire [racine LiveCycle]/jboss/server/all/log.
Ce fichier contient des informations sur l'activité et la progression de JBoss.
Modification des services LiveCycle
Par défaut, l'installation clé en main configure les services JBoss pour Adobe LiveCycle et MySQL pour
Adobe LiveCycle pour un démarrage manuel. Si vous souhaitez que ces services démarrent automatiquement, procédez comme suit.
³
Pour modifier les services LiveCycle :
1. Sélectionnez Démarrer > Tous les programmes > Outils d'administration > Services.
2. Cliquez avec le bouton droit de la souris sur le service JBoss pour Adobe LiveCycle, puis sur Propriétés.
3. Dans le menu Type de démarrage, sélectionnez Automatique, puis cliquez sur OK.
4. Cliquez avec le bouton droit de la souris sur le service MySQL pour Adobe LiveCycle, puis sur
Propriétés.
5. Dans le menu Type de démarrage, sélectionnez Automatique, puis cliquez sur OK.
6. (LiveCycle Workflow Business Activity Monitor) Cliquez avec le bouton droit de la souris sur JBoss pour
Adobe LiveCycle Workflow BAM, puis cliquez sur Propriétés.
7. Dans le menu Type de démarrage, sélectionnez Automatique, puis cliquez sur OK.
Etape suivante
Pour LiveCycle Forms et LiveCycle Assembler, vous pouvez à présent déployer une application exemple pour tester l'installation et le déploiement.
(
Voir les sections
« Vérification du déploiement de
et
« Vérification du déploiement de LiveCycle Assembler », page 27
).
Vous pouvez également accéder à Administrator et User Management et commencer à développer des
et aux guides du développeur des produits que vous avez installés.)
3
Après le déploiement
Ce chapitre explique comment utiliser vos produits LiveCycle après les avoir installés, configurés et déployés sur le serveur d'applications :
O
O
O
« Accès à Administrator », page 26
« Accès à User Management », page 27
« Tâches de post-déploiement de LiveCycle Assembler », page 27
O
O
O
O
« Tâches de post-déploiement de LiveCycle Forms », page 28
« Tâches de post-déploiement de LiveCycle Print », page 28
« Tâches de post-déploiement de LiveCycle Form Manager », page 31
« Tâches de post-déploiement de LiveCycle PDF Generator », page 31
Accès à Administrator
Administrator est un portail basé sur le Web donnant accès à de nombreuses pages de configuration qui vous permettent de définir les propriétés d'exécution contrôlant le fonctionnement des produits
LiveCycle. Une fois connecté à Administrator, vous pouvez accéder aux paramètres de User Management,
Adobe JMX Monitor, à la configuration de Watched Folder (installée avec Watched Folder), aux paramètres de Process Manager et du serveur (installés avec LiveCycle Workflow), ainsi qu'aux options de configuration d'administration des autres produits LiveCycle.
Le nom d'utilisateur et le mot de passe par défaut de connexion à Administrator sont administrator et
password. Après la première connexion, vous pouvez accéder à User Management et modifier le mot de passe.
Avant d'accéder à Administrator, vous devez déployer les produits LiveCycle et les exécuter sur le serveur d'applications.
Pour plus de détails sur l'utilisation d'Administrator, consultez l'aide d'Adobe Administration (disponible à partir du menu d'aide de la fenêtre d'Administrator).
³
Pour accéder à Administrator :
1. Saisissez l'URL suivante dans un navigateur Web : http://[nomhôte]:[port]/adminui
Le numéro de port par défaut pour JBoss est 8080.
2. Dans le champ Nom d'utilisateur, entrez administrator
et dans le champ Mot de passe, saisissez password
.
3. Une fois connecté, vous pouvez cliquer sur Services pour accéder aux pages d'Administrator des produits LiveCycle ou sur Options pour accéder aux pages de User Management.
26
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Après le déploiement
Accès à User Management 27
Accès à User Management
User Management permet aux administrateurs de gérer une base de données contenant tous les utilisateurs et groupes synchronisés avec un ou plusieurs annuaires d'utilisateurs tiers. User Management est un outil de gestion des authentifications, des autorisations et des utilisateurs pour les produits
LiveCycle, parmi lesquels LiveCycle PDF Generator, LiveCycle Assembler, LiveCycle Form Manager,
LiveCycle Forms et LiveCycle Workflow.
User Management vous permet également d'activer l'authentification unique entre les produits LiveCycle et les applications protégées par Netegrity SiteMinder à l'aide du langage SAML (Security Assertion
Markup Language). Lorsque l'authentification unique est implémentée, les pages d'ouverture de session utilisateur de LiveCycle ne sont plus obligatoires et ne s'affichent pas si l'utilisateur est déjà authentifié via le portail de son entreprise.
Pour plus de détails sur l'utilisation de User Management, consultez l'aide sur l'administration d'AdobeUser
Management (disponible à partir du menu d'aide de la fenêtre de User Management).
³
Pour accéder à User Management :
1. Dans la page d'accueil d'Administrator, cliquez sur Options.
2. Dans la page Settings, cliquez sur User Management.
Remarque :
pour plus de détails sur la configuration des utilisateurs avec User Management, cliquez sur l'aide de User Management dans l'angle supérieur droit de la page User Management.
³
(LiveCycle Forms) Pour accéder à Administrator sans User Management :
O
Saisissez l'URL suivante dans un navigateur Web : http://[nomhôte]:[port]/FormServerAdmin/settings.html
Tâches de post-déploiement de LiveCycle Assembler
Cette section décrit les tâches de post-déploiement propres à LiveCycle Assembler.
Vérification du déploiement de LiveCycle Assembler
Vous pouvez vérifier que LiveCycle Assembler est déployé et s'exécute correctement en déployant l'exemple pré-intégré. (Consultez le guide Samples Guide for LiveCycle Assembler, situé dans le répertoire
[racine LiveCycle]/Assembler/samples/docs.)
³
Pour déployer l'exemple de LiveCycle Assembler :
1. Accédez au répertoire [racine LiveCycle]/Assembler/samples/build/prebuilt.
2. Déployez le fichier jboss.sample-assembler7.ear en le copiant dans le répertoire [racine du serveur
d'applications]/server/all/deploy.
3. Saisissez l'URL suivante dans un navigateur Web : http://localhost:8080/adobe/livecycle/samples/assembler7/
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Après le déploiement
Tâches de post-déploiement de LiveCycle Forms 28
4. Cliquez sur About Assembler et vérifiez que les informations relatives à LiveCycle Assembler apparaissent dans la fenêtre Result.
Vous pouvez à présent créer des applications pour LiveCycle Assembler. (Consultez le guide Developing
Applications for LiveCycle Assembler.)
Tâches de post-déploiement de LiveCycle Forms
Cette section décrit les tâches de post-déploiement propres à LiveCycle Forms.
Vous pouvez à présent créer des applications personnalisées pour LiveCycle Forms. (Consultez le guide
Developing Custom Applications.) Pour plus de détails sur le module Form Server, reportez-vous au document Form Server Module API Reference. Pour plus de détails sur l'API du module XML Form, reportez-vous au document XML Form Module API Reference.
Vous pouvez installer LiveCycle Print, de manière facultative, pour utiliser LiveCycle Forms afin d'imprimer des formulaires à l'aide des flux d'impression Adobe PostScript, Printer Control Language (PCL) et Zebra
Programming Language (ZPL), en plus des formulaires au format PDF et HTML. Sans LiveCycle Print,
LiveCycle Forms ne peut pas générer de formulaires sous forme de flux d'impression. A la place,
LiveCycle Forms envoie les formulaires sur un réseau et les reproduit sur les périphériques clients, tels que des navigateurs Web, au format PDF ou HTML.
Vérification du déploiement de LiveCycle Forms
Vous pouvez vérifier que LiveCycle Forms est déployé et s'exécute correctement en accédant à l'application Installation Verification Sample installée avec le produit.
³
Pour accéder à l'application Installation Verification Sample :
1. Copiez le fichier FormsIVS.ear du répertoire [racine LiveCycle]/components/forms/samples/ common/ dans le répertoire [racine du serveur d'applications]/server/all/deploy.
2. Redémarrez le serveur d'applications.
3. Saisissez l'URL suivante dans un navigateur Web : http://[nomhôte]:[port]/FormsIVS
[nomhôte] correspond au nom du serveur sur lequel Forms a été déployé. Si vous appelez FormsIVS sur le serveur lui-même, indiquez le nom du serveur au lieu de « localhost ».
Remarque :
pour plus de détails sur l'utilisation de l'application exemple, cliquez sur le lien Aide de la page Exemples du navigateur Web.
Tâches de post-déploiement de LiveCycle Print
Cette section décrit les tâches de post-déploiement propres à LiveCycle Print.
Vérification du déploiement
Vous pouvez vérifier que LiveCycle Print est déployé et s'exécute correctement à l'aide des méthodes suivantes.
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Après le déploiement
Déploiement et exécution de l'application Web PrintIVS 29
O
O
O
Déploiement et exécution de l'application Web Print Installation and Verification Sample (PrintIVS).
Exécution de l'application de la console de soumission d'impression (il n'est pas nécessaire de déployer cette application).
Ces deux applications appellent LiveCycle Print en utilisant l'API LiveCycle Print (cette API utilise le service Web LiveCycle Print).
Exécution de l'application Forms Installation and Verification Sample (FormsIVS). Si LiveCycle Print est déployé, la liste des formats de sortie contient trois options supplémentaires : Postscript, ZPL et PCL.
Pour plus de détails sur l'application Installation Verification Sample, reportez-vous à la section
« Vérification du déploiement de LiveCycle Forms », page 28 .
Outre l'exécution des deux applications exemples d'impression, vous pouvez appeler LiveCycle Print à l'aide de l'application d'impression de l'API du module Form Server. Cette application exemple d'impression est une application console qui appelle LiveCycle Print en utilisant l'API du module
Form Server. Reportez-vous à la section
« Exécution de l'application d'impression de l'API du module
.
Déploiement et exécution de l'application Web PrintIVS
L'application Web PrintIVS se trouve dans le fichier adobe-printSubmitter.ear situé dans le répertoire
[racine LiveCycle]/components/print/common/ear, ainsi que dans le répertoire [racine
LiveCycle]/configurationManager/export une fois que vous avez exécuté Configuration Manager.
Pour exécuter cette application, il est important de comprendre la spécification d'impression, car l'application requiert les mêmes valeurs. (Consultez la section sur les spécifications d'impression du guide
Getting Started de LiveCycle Print.)
³
Pour déployer l'application Web PrintIVS et l'exécuter :
1. Copiez le fichier adobe-printSubmitter.ear du répertoire [racine LiveCycle]/components/print/samples/ common/printsubmitter dans le répertoire [racine du serveur d'applications]/server/all/deploy.
2. Pour exécuter l'application exemple, saisissez http://
[nomhôte
]:[port]/PrintIVS
dans la ligne d'adresse d'un navigateur Web.
3. Saisissez les valeurs requises et cliquez sur Print.
Exécution de l'application de soumission d'impression
L'application de soumission d'impression comprend le fichier lcprint.bat (Windows) ou lcprint.sh (Linux), qui figure dans le répertoire [racine LiveCycle]/components/print/samples/common/lcprint.
Vous pouvez exécuter l'application de soumission d'impression depuis l'invite de commande pour appeler
LiveCycle Print.
³
Pour exécuter l'application de soumission d'impression :
1. Depuis l'invite de commande, accédez au répertoire [racine
LiveCycle]/components/print/samples/common/lcprint.
Si vous n'avez pas effectué l'installation dans le répertoire par défaut, créez une variable d'environnement intitulée
LiveCycleRoot
et définissez sa valeur sur le répertoire d'installation utilisé sur votre système.
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Après le déploiement
Exécution de l'application d'impression de l'API du module Form Server 30
2. Entrez la commande suivante : lcprint <-d,--dataFile filename> <-f,--specFile filename> <-s,--server server:port>
Le premier argument, qui est facultatif, représente le chemin complet d'accès au fichier de données.
Une série de fichiers de données accompagne LiveCycle Print. Ces fichiers se trouvent dans le répertoire [racine LiveCycle]/components/print/samples/common/lcprint /data.
La plupart de ces fichiers contiennent plusieurs enregistrements. Par exemple, le fichier
PurchaseOrder_batch_25.xml contient 25 enregistrements. Vous pouvez créer plusieurs flux d'impression à l'aide d'un fichier de données contenant plusieurs enregistrements. (Consultez la section sur l'utilisation de plusieurs enregistrements de données dans le guide Getting Started de
LiveCycle Print.)
Le second argument est le chemin d'accès complet de la spécification d'impression envoyée à
LiveCycle Print. Vous pouvez modifier le fichier PrintSpecTemplate.xml et l'utiliser. Le fichier
PrintSpecTemplate.xml se trouve dans le même répertoire que le fichier lcprint.bat. (Consultez la section sur les spécifications d'impression du guide Getting Started de LiveCycle Print.)
Dans la spécification d'impression, vous devez spécifier l'emplacement de la conception de formulaire sur laquelle se base le flux d'impression. Les conceptions de formulaires exemples se trouvent dans le répertoire [racine LiveCycle]/components/print/samples/common/lcprint /forms.
Le troisième argument, obligatoire, spécifie le nom et le port du serveur.
Vous pouvez également utiliser l'application de console de soumission d'impression pour récupérer des informations sur une requête précédente. Pour effectuer cette opération, utilisez la commande suivante : lcprint <-r,--result requestId> requestId
correspondant à une valeur de chaîne, comme
59572cd82
, qui spécifie un identificateur de requête. Cette commande renvoie des données obtenues décrivant l'état d'une requête. (Consultez la section sur les données obtenues dans le guide Getting Started de LiveCycle Print.)
Exécution de l'application d'impression de l'API du module Form Server
L'application d'impression de l'API du module Form Server utilise l'API du module Form Server pour appeler LiveCycle Print à partir de l'invite de commande. (Consultez la section sur l'utilisation du module
Form Server dans le guide Getting Started de LiveCycle Print.)
L'application d'impression de l'API du module Form Server consiste en un fichier Java nommé FsPrint.java et situé dans le répertoire [racine LiveCycle]/components/print/samples/common/fsprint. Si vous utilisez
Windows, vous devez exécuter le fichier fsprint.bat situé dans ce répertoire. Si vous utilisez Linux, vous devez exécuter le fichier fsprint.sh.
Remarque :
l'application d'impression de l'API du module Form Server crée un objet
SOAPClient
qui spécifie un point de fin SOAP valide. Le point de fin SOAP par défaut du fichier FsPrint.java est configuré pour le point de fin SOAP par défaut utilisé par JBoss. Si vous déployez
LiveCycle Forms sur un autre serveur d'applications J2EE, vous devez modifier le fichier FsPrint.java en ajoutant ou en supprimant des commentaires au point de fin SOAP approprié. Pour plus de détails sur l'utilisation d'un objet
SOAPClient
, consultez le guide
Developing Custom Applications de LiveCycle Forms.
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Après le déploiement
Tâches de post-déploiement de LiveCycle Form Manager 31
³
Pour exécuter l'application d'impression de l'API du module Form Server :
1. Depuis l'invite de commande, accédez au répertoire de l'application [racine
LiveCycle]/components/print/samples/common/fsprint.
Si vous n'avez pas effectué l'installation dans le répertoire par défaut, créez une variable d'environnement intitulée
LiveCycleRoot
et définissez sa valeur sur le répertoire d'installation utilisé sur votre système.
2. Entrez la commande suivante : fsprint <-argument 1> <-argument2>
Le premier argument est le chemin d'accès complet de la conception de formulaire (fichier XDP). Vous pouvez utiliser une conception de formulaire exemple située dans le répertoire [racine
LiveCycle]/components/print/samples/common/lcprint /forms.
Le second argument, facultatif, définit la destination du flux d'impression. Par exemple, vous pouvez définir un URI de fichier vers un fichier Postscript. Si vous ne spécifiez pas cette valeur, la sortie est écrite dans la sortie standard. Cette valeur est similaire à l'élément
PrintURI
dans la spécification d'impression. (Consultez la section sur les spécifications d'impression du guide Getting Started de
LiveCycle Print.)
Conseil :
le code source de l'application d'impression de l'API du module Form Server se trouve dans le fichier FsPrint.java. Vous pouvez ouvrir ce fichier pour observer la logique applicative qui appelle
LiveCycle Print en utilisant l'API du module Form Server.
Tâches de post-déploiement de LiveCycle Form Manager
Cette section décrit les tâches de post-déploiement propres à LiveCycle Form Manager.
Accès aux pages utilisateur de LiveCycle Form Manager
Une fois User Management configuré de façon à accéder au serveur LDAP de votre entreprise, les utilisateurs peuvent accéder aux pages de l'utilisateur final de LiveCycle Form Manager via l'URL suivante : http://[nomhôte]:[port]/fm
Le numéro de port par défaut pour JBoss est 8080.
Vous pouvez également accéder aux pages de l'utilisateur final à l'aide du nom d'utilisateur
(
Administrator
) et du mot de passe ( password
) par défaut de l'administrateur.
Pour plus de détails sur l'utilisation des pages de l'utilisateur final de LiveCycle Form Manager, consultez l'aide de LiveCycle Form Manager (accessible à partir du menu Aide de la fenêtre LiveCycle Form Manager).
Tâches de post-déploiement de LiveCycle PDF Generator
Cette section décrit les tâches de post-déploiement propres à LiveCycle PDF Generator.
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Après le déploiement
Configuration de sources de travaux 32
Configuration de sources de travaux
Vous pouvez configurer LiveCycle PDF Generator pour accepter des travaux à partir des dossiers de contrôle, des courriers électroniques et de l'interface utilisateur Web (code exemple). Reportez-vous à la section Aide sur l'administration de LiveCycle PDF Generator.
LiveCycle PDF Generator peut également accepter des travaux envoyés via l‘interface de services Web de
LiveCycle PDF Generator. Pour activer cette fonction, il faut que l‘application cliente de services Web exemple installée avec LiveCycle PDF Generator soit modifiée par le développeur avant de pouvoir être utilisée pour envoyer des travaux. Pour plus de détails sur la configuration de ces sources de travaux, consultez le guide Developing Custom Applications de LiveCycle PDF Generator.
Définition de l'imprimante Adobe PDF comme imprimante par défaut
Cette section s'applique à LiveCycle PDF Generator Professional et Elements uniquement.
Vous devez configurer l'imprimante Adobe PDF comme imprimante par défaut sur le serveur.
³
Pour définir l'imprimante Adobe PDF comme imprimante par défaut :
1. Accédez au panneau de l'imprimante dans votre système d'exploitation.
2. Définissez Adobe PDF comme imprimante par défaut.
Installation de polices
Vous pouvez installer les polices utilisées dans les documents convertis par LiveCycle PDF Generator. Les polices peuvent être référencées par des documents PostScript ou EPS ou par des formats de fichier natifs comme ceux utilisés par Microsoft Word ou Microsoft Excel.
Pour que les polices supplémentaires soient disponibles pour toutes les applications, installez les polices en utilisant l'une des méthodes suivantes :
O
Installez les polices dans le dossier approprié :
O
O
O
(Windows) C:\Windows\Fonts
(Linux) /usr/X11R6/lib/X11/fonts
A l'aide de Configuration Manager, dans l‘écran Configuration du Module Font Manager, recherchez le répertoire contenant les polices, puis redéployez le Module Font Manager. Pour plus de détails sur le déploiement du Module Font Manager, reportez-vous à la section
LiveCycle à déployer », page 49
.
Pour consulter la liste des polices installées avec le Module Font Manager, reportez-vous à la section
« Polices installées avec le module Font Manager », page 104 .
Remarque :
les polices du Module Font Manager ne sont pas disponibles pour les applications natives utilisées par LiveCycle PDF Generator pour convertir des formats de fichier natifs. Ces applications natives incluent Microsoft Word et Acrobat. Pour qu'une police soit disponible pour les applications natives, vous devez l'installer dans le dossier des polices système. Si votre serveur LiveCycle PDF Generator fait partie d'un groupe de serveurs, la police doit être installée sur chaque ordinateur utilisé pour héberger les applications natives.
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Après le déploiement
Définition du délai d'expiration de la conversion pour LiveCycle PDF Generator 33
Respect de références de polices
Cette section ne s'applique qu'à LiveCycle PDF Generator Elements et LiveCycle PDF Generator Professional.
Pour les références de polices d'un fichier natif, LiveCycle PDF Generator Elements et LiveCycle PDF Generator
Professional utilisent l'application native avec l'imprimante Adobe PDF pour convertir un format de fichier natif en PDF. L'application native respecte les références de polices figurant dans le répertoire C:\Windows\Fonts.
Pour les références de polices d'un document PDF, ces produits essaient de respecter les références de polices des sources suivantes, dans l‘ordre suivant :
O
O
O
Polices incorporées dans le document PDF
Module Font Manager
C:\WINDOWS\Fonts
Définition du délai d'expiration de la conversion pour LiveCycle PDF Generator
Vous pouvez configurer les paramètres de délai d'expiration de la conversion de LiveCycle PDF Generator au niveau du serveur d'applications ou de la source des travaux. Si le délai d'expiration est configuré à plusieurs niveaux, le niveau le plus bas est pris en compte.
Pour plus de détails sur la configuration de ce paramètre au niveau du serveur d'applications,
reportez-vous à la section « Configuration manuelle de JBoss », page 54
.
³
Pour configurer les paramètres de délai d'expiration de la conversion au niveau de la source des travaux :
O
Dans Administrator, sélectionnez Créer un fichier PDF, puis entrez une valeur en secondes dans le champ
Spécifier un délai d'expiration. Par défaut, cette valeur est lue à partir du fichier server.aes.properties.
³
Pour configurer les paramètres de délai d'expiration de la conversion des dossiers de contrôle et des sources de courrier électronique :
1. Dans Administrator, sélectionnez Services > Adobe LiveCycle PDF Generator > Fichiers de
configuration > Exporter la configuration.
2. Sélectionnez Télécharger la configuration complète et cliquez sur Télécharger. Par défaut, cette valeur est lue à partir du fichier server.aes.properties.
3. Modifiez le fichier native2pdfconfig.xml dans un éditeur de texte et définissez le niveau <timeout>.
4. Téléchargez vos modifications en sélectionnant Importer la configuration, en recherchant l'emplacement du fichier native2pdfconfig.xml, puis en cliquant sur Importer.
Remarque :
le délai d'expiration des API de services Web est lu à partir du fichier server.aes.properties.
Etape suivante
Si vous avez installé et configuré LiveCycle Workflow manuellement, vous devez maintenant configurer le
serveur d'applications JBoss pour BAM Server. Reportez-vous à la section « Configuration manuelle de
JBoss pour BAM Server », page 77
.
Si vous avez installé et configuré LiveCycle Workflow au moyen d'une méthode clé en main, vous pouvez
Partie II : Installation, configuration et déploiement manuels
Cette section du guide décrit les procédures d'installation, de configuration et de déploiement manuelles des produits LiveCycle.
Pour plus de détails sur l'installation, la configuration et le déploiement automatiques des produits, reportez-vous à
34
4
Installation des produits LiveCycle
Ce chapitre explique comment utiliser le programme d'installation pour installer les produits LiveCycle sur un système d'exploitation Windows ou Linux.
Si vous installez LiveCycle PDF Generator (toutes les versions), consultez
.
Remarque :
si vous avez installé plusieurs produits LiveCycle, nous vous recommandons de commencer par installer LiveCycle PDF Generator. Si vous installez LiveCycle PDF Generator après avoir installé d'autres produits LiveCycle, vous devez observer la procédure de la section
« Pour installer LiveCycle PDF Generator avec des produits LiveCycle déjà installés : », page 36 .
:
O
O
O
LiveCycle Assembler
LiveCycle Forms
LiveCycle Form Manager
O
LiveCycle Workflow
Si vous installez LiveCycle Print (pour une utilisation avec LiveCycle Forms), reportez-vous à la section
« Installation de LiveCycle Print », page 39 .
Remarque :
vous devez installer LiveCycle Forms avant LiveCycle Print.
Si vous installez Watched Folder (pour une utilisation avec LiveCycle Workflow et LiveCycle Assembler),
reportez-vous à la section « Installation de Watched Folder », page 40 .
Avant d'effectuer l'installation, vous devez vérifier que votre environnement inclut les logiciels et matériels nécessaires à l'exécution des produits LiveCycle. Vous devez également connaître les options d'installation
Si vous effectuez l'installation dans un emplacement contenant déjà un produit LiveCycle, installez le nouveau produit, exécutez Configuration Manager pour réassembler les produits, annulez le déploiement du produit déployé à partir du serveur d'applications, puis redéployez les fichiers sur le serveur d'applications.
Installation de LiveCycle PDF Generator
La procédure décrite dans cette section s'applique à LiveCycle PDF Generator Professional, LiveCycle PDF
Generator Elements et LiveCycle PDF Generator pour PostScript.
Lorsque vous exécutez le programme d'installation, les informations suivantes sont nécessaires :
O le numéro de série du produit installé ;
O le type d'installation et de configuration réalisées. Reportez-vous à la section
« Méthodes d'installation, de configuration et de déploiement des produits LiveCycle », page 12 .
35
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Installation des produits LiveCycle
Installation de LiveCycle PDF Generator 36
Remarque :
pour réussir l'installation, des autorisations de lecture et d'écriture doivent figurer dans le répertoire d'installation. Voici les répertoires d'installation par défaut mais vous pouvez spécifier un autre répertoire, au besoin :
O
O
Windows : C:\Adobe\LiveCycle\
Linux : /opt/adobe/livecycle/
Vous devez configurer le service JBoss afin qu'il utilise les mêmes propriétés de connexion que l'administrateur Microsoft Office. Configurez les propriétés de connexion du service JBoss à l'aide de la fenêtre Outils d'administration du Panneau de configuration.
Si vous installez LiveCycle PDF Generator Professional ou LiveCycle PDF Generator Elements, assurez-vous qu'Acrobat n'est pas installé sur l'ordinateur.
Sous Linux, le programme d'installation utilise le répertoire racine de l'utilisateur connecté comme répertoire temporaire de stockage des fichiers. Par conséquent, des messages semblables à celui ci-dessous peuvent s'afficher dans la console :
WARNING: could not delete temporary file /home/<username>/ismp001/1556006
Une fois l'installation terminée, vous devez supprimer manuellement les fichiers temporaires.
Conseil :
pour accélérer l'installation, désactivez tout logiciel d'analyse antivirus à l'accès pour la durée de la procédure.
³
Pour installer LiveCycle PDF Generator avec des produits LiveCycle déjà installés :
Si vous avez déjà installé d'autres produits LiveCycle, vous devez compléter les étapes suivantes avant d'installer LiveCycle PDF Generator.
1. Depuis le panneau des services de Windows, sélectionnez JBoss pour Adobe LiveCycle.
2. Arrêtez le service s'il est en cours d'exécution.
3. Cliquez sur le service avec le bouton droit de la souris et ouvrez les propriétés.
4. Sélectionnez l'onglet Log On.
5. Sélectionnez This account.
6. Entrez le nom d'utilisateur et le mot de passe utilisé lors de l'installation des applications Microsoft
Office et Adobe Acrobat.
7. Démarrez le service JBoss for Adobe LiveCycle.
³
Pour installer LiveCycle PDF Generator en vue d'un déploiement manuel :
1. Lancez le programme d'installation situé à la racine du CD d'installation :
O
(Windows) Cliquez deux fois sur le fichier .exe.
O
(Linux) Ouvrez une invite de commande et saisissez :
file_name.bin
Remarque :
vous devrez peut-être modifier les autorisations du programme d'installation sous Linux.
Pour ce faire, saisissez : chmod +x filename.bin
2. Lorsque vous y êtes invité, sélectionnez la langue du programme d'installation et cliquez sur OK.
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Installation des produits LiveCycle
Installation de LiveCycle PDF Generator 37
3. Dans l'écran de bienvenue, cliquez sur Suivant.
4. Entrez le numéro de série dans la zone de texte, puis cliquez sur Suivant.
5. (LiveCycle PDF Generator Professional, LiveCycle PDF Generator Elements) Dans l'écran des conditions de pré-installation d'Adobe LiveCycle PDF Generator 7.2, passez en revue les conditions prérequises, puis cliquez sur Suivant.
6. Si vous êtes invité à désactiver le logiciel d'analyse anti-virus, cliquez sur Suivant. Il est recommandé de désactiver le logiciel d'analyse anti-virus pendant le processus d'installation pour optimiser la vitesse d'installation.
7. Lisez l'accord de licence du produit, sélectionnez J'accepte les termes du contrat de licence, puis cliquez sur Suivant.
8. Acceptez le répertoire par défaut proposé ou cliquez sur Parcourir pour accéder au répertoire où vous souhaitez installer le produit, puis cliquez sur Suivant.
Remarque :
si vous saisissez le nom d'un répertoire qui n'existe pas, ce dernier est créé pour vous.
9. Lorsque l'invite s'affiche, sélectionnez le serveur d'applications sur lequel vous déployez le produit, puis cliquez sur Suivant.
Remarque :
ne sélectionnez pas l'option de configuration et de déploiement automatiques.
10. (LiveCycle PDF Generator Professional, LiveCycle PDF Generator Elements) Dans l'écran Corel
WordPerfect, recherchez le fichier exécutable de Corel WordPerfect (si ce logiciel est installé) et cliquez sur Suivant ou cliquez sur Suivant si Corel WordPerfect n'est pas installé.
11. (LiveCycle PDF Generator Professional, LiveCycle PDF Generator Elements) Dans l'écran Adobe
Photoshop, recherchez le fichier exécutable d'Adobe Photoshop (si ce logiciel est installé) et cliquez sur
Suivant ou cliquez sur Suivant si Photoshop n'est pas installé.
12. Vérifiez les détails d'installation, puis cliquez sur Installer. Le programme d'installation affiche la progression de l'installation. Un écran récapitulatif apparaît lorsque l'installation du produit est terminée.
13. Vérifiez que l'option Exécuter Configuration Manager n'est pas sélectionnée, puis cliquez sur
Terminer.
Attention :
n'exécutez pas Configuration Manager tant que vous n'avez pas installé tous les produits
votre environnement terminées, il vous suffit d'exécuter Configuration Manager une fois pour configurer et assembler les composants déployables. Si vous ajoutez un autre produit
LiveCycle ultérieurement, vous pouvez à nouveau exécuter Configuration Manager pour configurer, assembler et déployer les modules des produits. Reportez-vous à la section
« Configuration des produits LiveCycle à déployer », page 49
.
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Installation des produits LiveCycle
Installation des produits LiveCycle 38
Installation des produits LiveCycle
Cette section s'applique uniquement à LiveCycle Assembler, LiveCycle Forms, LiveCycle Form Manager et LiveCycle WorkFlow.
Lorsque vous exécutez un programme d'installation, les informations suivantes sont nécessaires :
O le numéro de série du produit installé ;
O le type d'installation et de configuration réalisées. Reportez-vous à la section
« Méthodes d'installation, de configuration et de déploiement des produits LiveCycle », page 12 .
Remarque :
pour réussir l'installation, des autorisations de lecture et d'écriture doivent figurer dans le répertoire d'installation. Voici les répertoires d'installation par défaut mais vous pouvez spécifier un autre répertoire, au besoin :
O
O
Windows : C:\Adobe\LiveCycle\
Linux : /opt/adobe/livecycle/
Sous Linux, le programme d'installation utilise le répertoire racine de l'utilisateur connecté comme répertoire temporaire de stockage des fichiers. Par conséquent, des messages semblables à celui ci-dessous peuvent s'afficher dans la console :
WARNING: could not delete temporary file /home/<username>/ismp001/1556006
Une fois l'installation terminée, vous devez supprimer manuellement les fichiers temporaires.
Attention :
vérifiez que le répertoire temporaire du système d'exploitation utilisé possède un espace libre disponible d'au moins 3 Go pour installer le programme :
O
(Windows) Chemin TMP ou TEMP tel que défini dans les variables d'environnement
O
(Linux) Répertoire racine de l'utilisateur connecté
³
Pour installer des produits LiveCycle en vue d'un déploiement manuel :
1. Accédez au répertoire racine du support d'installation. Pour Workflow, accédez au répertoire
AdobeLiveCycleWorkflow7.2.
2. Lancez le programme d'installation :
O
(Windows) Cliquez deux fois sur le fichier .exe.
O
(Linux) Ouvrez une invite de commande et saisissez :
file_name.bin
Attention :
lorsque vous installez le produit sur un système d'exploitation Linux, vous devez vous connecter comme utilisateur racine pour pouvoir installer le produit dans le répertoire d'installation par défaut /opt/adobe/livecycle. Si vous n'êtes pas connecté comme utilisateur racine, vous devez changer de répertoire d'installation et en choisir un auquel vous avez accès
(par exemple, $HOME/adobe/livecycle).
3. Lorsque vous y êtes invité, sélectionnez la langue du programme d'installation et cliquez sur OK.
4. Dans l'écran de bienvenue, cliquez sur Suivant.
5. Lors de la mise à niveau à partir d'une version antérieure, vérifiez dans l'écran de lecture avant installation que vous vous êtes conformé aux instructions de mise à niveau, puis cliquez sur Suivant. Si vous ne procédez pas à une mise à niveau, cliquez sur Suivant.
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Installation des produits LiveCycle
Installation de LiveCycle Print 39
6. Entrez le numéro de série dans la zone de texte, puis cliquez sur Suivant.
7. Si vous êtes invité à désactiver le logiciel d'analyse anti-virus, cliquez sur Suivant. Il est recommandé de désactiver le logiciel d'analyse anti-virus pendant le processus d'installation pour optimiser la vitesse d'installation.
8. Lisez l'accord de licence du produit, sélectionnez J'accepte les termes du contrat de licence, puis cliquez sur Suivant.
Remarque :
en fonction du produit que vous installez, il est possible que les deux étapes suivantes soient à exécuter dans l'ordre inverse.
9. Sélectionnez le serveur d'applications sur lequel vous déployez le produit, puis cliquez sur Suivant.
Remarque :
ne sélectionnez pas l'option de configuration et de déploiement automatiques.
10. Acceptez le répertoire par défaut proposé ou cliquez sur Parcourir pour accéder au répertoire où vous souhaitez installer le produit, puis cliquez sur Suivant.
Remarque :
si vous saisissez le nom d'un répertoire qui n'existe pas, ce dernier est créé pour vous.
Attention :
lorsque vous installez le produit, vous pouvez spécifier un répertoire d'installation différent. Si vous procédez à une installation sous Linux, assurez-vous que le nom du répertoire spécifié ne contient pas d'espaces, faute de quoi le programme n'installera pas le produit.
11. Vérifiez les détails d'installation, puis cliquez sur Installer. Le programme d'installation affiche la progression de l'installation. Un écran récapitulatif apparaît lorsque l'installation du produit est terminée.
12. Vérifiez que l'option Exécuter Configuration Manager n'est pas sélectionnée, puis cliquez sur Terminer.
Attention :
n'exécutez pas Configuration Manager tant que vous n'avez pas installé tous les produits
votre environnement terminées, il vous suffit d'exécuter Configuration Manager une fois pour configurer et assembler les composants déployables. Si vous ajoutez un autre produit
LiveCycle ultérieurement, vous pouvez à nouveau exécuter Configuration Manager pour configurer, assembler et déployer les modules des produits. Reportez-vous à la section
« Configuration des produits LiveCycle à déployer », page 49
.
Remarque :
si vous avez installé LiveCycle Workflow, vous pouvez à présent installer Watched Folder.
Reportez-vous à la section
« Installation de Watched Folder », page 40
.
Remarque :
si vous avez installé LiveCycle Forms, vous pouvez à présent installer LiveCycle Print.
Reportez-vous à la section
« Installation de LiveCycle Print », page 39 .
Installation de LiveCycle Print
Avant d'installer LiveCycle Print, vous devez installer LiveCycle Forms. Reportez-vous à la section
« Installation des produits LiveCycle », page 35
.
³
Pour installer LiveCycle Print :
1. Lancez le programme d'installation situé à la racine du CD d'installation :
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Installation des produits LiveCycle
Installation de Watched Folder 40
O
O
(Windows) Cliquez deux fois sur le fichier adobe_livecycle_print_7_2.exe.
(Linux) Ouvrez une invite de commande et saisissez : adobe_livecycle_print_7_2.bin
Remarque :
vous devrez peut-être modifier les autorisations du programme d'installation sous Linux.
Pour ce faire, saisissez : chmod +x filename.bin
2. Lorsque vous y êtes invité, sélectionnez la langue du programme d'installation et cliquez sur OK.
3. Dans l'écran de bienvenue, cliquez sur Suivant.
4. Lors de la mise à niveau à partir d'une version antérieure, vérifiez dans l'écran de lecture avant installation que vous vous êtes conformé aux instructions de mise à niveau, puis cliquez sur Suivant. Si vous ne procédez pas à une mise à niveau, cliquez sur Suivant.
5. Entrez le numéro de série dans la zone de texte, puis cliquez sur Suivant.
6. Lisez l'accord de licence du produit, sélectionnez J'accepte les termes du contrat de licence, puis cliquez sur Suivant.
7. Acceptez le répertoire par défaut indiqué ou cliquez sur Parcourir et accédez au répertoire [racine
LiveCycle] dans lequel vous avez installé LiveCycle Forms.
Remarque :
vous devez installer LiveCycle Print dans le même répertoire [racine LiveCycle] que
LiveCycle Forms.
8. Vérifiez les détails d'installation, puis cliquez sur Installer. Le programme d'installation affiche la progression de l'installation. Un écran récapitulatif apparaît lorsque l'installation du produit est terminée.
9. Vérifiez que l'option Exécuter Configuration Manager n'est pas sélectionnée, puis cliquez sur
Terminer.
Attention :
n'exécutez pas Configuration Manager tant que vous n'avez pas installé tous les produits
votre environnement terminées, il vous suffit d'exécuter Configuration Manager une fois pour configurer et assembler les composants déployables. Si vous ajoutez un autre produit
LiveCycle ultérieurement, vous pouvez à nouveau exécuter Configuration Manager pour configurer, assembler et déployer les modules des produits. Reportez-vous à la section
« Configuration des produits LiveCycle à déployer », page 49
.
Remarque :
pour tester votre installation avec les applications exemples de LiveCycle Print, vous devez
Installation de Watched Folder
L'installation de Watched Folder place les fichiers de configuration de déploiement requis sur votre ordinateur. Assurez-vous que vous avez installé LiveCycle Workflow et LiveCycle Assembler avant d'exécuter cette procédure.
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Installation des produits LiveCycle
Affichage du journal d'erreurs 41
³
Pour installer Watched Folder :
1. Lancez le programme d'installation à partir du répertoire de Watched Folder sur le DVD d'installation d'Adobe LiveCycle Assembler :
O
(Windows) Cliquez deux fois sur le fichier setupwin32.exe.
O
(Linux) Ouvrez une invite de commande et saisissez : setupLinux.bin
2. Lorsque vous y êtes invité, sélectionnez la langue d'installation et cliquez sur OK.
3. Cliquez sur Suivant dans l'écran de bienvenue.
4. Si vous souhaitez accroître la vitesse d'installation, désactivez le logiciel d'analyse anti-virus, puis cliquez sur Suivant.
5. Lisez l'accord de licence du produit, sélectionnez J'accepte les termes du contrat de licence, puis cliquez sur Suivant.
6. Acceptez l'emplacement par défaut ou cliquez sur Parcourir et accédez à l'emplacement où vous souhaitez installer Watched Folder, puis cliquez sur Suivant.
7. Vérifiez les détails d'installation, puis cliquez sur Installer. Un écran récapitulatif apparaît lorsque l'installation du produit est terminée.
8. Vérifiez que l'option Exécuter Configuration Manager n'est pas sélectionnée, puis cliquez sur
Terminer.
Attention :
n'exécutez pas Configuration Manager tant que vous n'avez pas installé tous les produits
votre environnement terminées, il vous suffit d'exécuter Configuration Manager une fois pour configurer et assembler les composants déployables. Si vous ajoutez un autre produit
LiveCycle ultérieurement, vous pouvez à nouveau exécuter Configuration Manager pour configurer, assembler et déployer les modules des produits. Reportez-vous à la section
« Configuration des produits LiveCycle à déployer », page 49
.
Affichage du journal d'erreurs
Si des erreurs se produisent lors de l'installation, le programme crée un fichier journal nommé log.txt et y consigne les messages d'erreur générés. Le fichier journal se trouve dans le répertoire [racine LiveCycle].
Etapes suivantes
Vous devez à présent préparer la base de données et le serveur d'applications à l'hébergement des
produits LiveCycle. Reportez-vous à la section « Préparation de l'environnement », page 42
.
5
Préparation de l'environnement
Ce chapitre décrit la préparation de votre environnement à l'hébergement des produits LiveCycle. Vous devez effectuer les opérations indiquées dans ce chapitre avant de configurer les produits LiveCycle :
O
O
« Création de la base de données », page 42
« Préparation du serveur d'applications », page 48 .
Il est inutile de réaliser ces opérations si vous procédez à une installation clé en main.
Création de la base de données
Cette section décrit la configuration de la base de données contenant les informations de configuration et les données d'exécution de LiveCycle. Les procédures décrites s'appliquent à tous les produits LiveCycle utilisant User Management. Si vous avez déjà configuré la base de données pour le déploiement d'autres produits LiveCycle, il n'est pas nécessaire de recommencer.
Remarque :
User Management est une fonction optionnelle de LiveCycle Forms.
Si vous installez un produit LiveCycle pour la première fois, vous devez créer une base de données vide.
Toutes les tables nécessaires à la prise en charge des produits LiveCycle sont créées par Configuration
.
Avant de créer la base de données, lisez les conditions préalables à l'installation et installez le logiciel requis. Reportez-vous à la section
« Avant l'installation », page 11
.
Pour plus de détails sur la création de la base de métadonnées BAM de LiveCycle Workflow Server,
reportez-vous à la section « Création de la base de métadonnées BAM », page 77 .
Création d'une base de données MySQL
Utilisez les outils MySQL pour créer une base de données MySQL à utiliser avec les produits LiveCycle ainsi qu'un compte utilisateur MySQL permettant au serveur d'applications de se connecter à la base de données. Vous devez également modifier la configuration du serveur de base de données MySQL. Pour plus de détails sur la création de la base de données et du compte utilisateur, reportez-vous à la documentation de MySQL.
Conseil :
si vous souhaitez configurer un schéma de base de données et de nouveaux utilisateurs dans
MySQL à l'aide d'une interface utilisateur graphique, vous devez installer l'outil
MySQL Administrator. Pour plus de détails, consultez la documentation utilisateur de MySQL.
Le nom de la base de données, le nom d'utilisateur et le mot de passe du compte utilisateur MySQL sont nécessaires à la configuration de la connexion à la base de données sur JBoss.
Compte utilisateur MySQL
Le compte utilisateur MySQL que vous créez requiert ces privilèges pour accéder aux tables de la base de données LiveCycle :
42
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Préparation de l'environnement
Création d'une base de données Oracle 43
O
O
SELECT
INSERT
O
O
O
O
UPDATE
DELETE
CREATE
DROP
O
O
O
O
REFERENCES
INDEX
ALTER
CREATE_TMP_TABLE
O
LOCK_TABLES
Configuration du serveur de bases de données MySQL
Pour éviter d'éventuels problèmes lors du téléchargement de fichiers volumineux vers MySQL, vous devez définir la taille maximale autorisée des paquets de communication sur 25 Mo. Vous pouvez définir cette propriété dans le fichier MySQL my.ini (Windows) ou my.cnf (Linux). Pour plus de détails sur la propriété relative à la taille maximale autorisée des paquets de communication dans MySQL, consultez la page http://dev.mysql.com/doc/mysql/en/packet-too-large.html.
Si votre installation MySQL ne contient pas de fichier my.ini ou my.cnf, vous devez en créer un. Pour plus de détails sur l'emplacement du fichier ou sur la façon de le créer, consultez la documentation de MySQL.
³
Pour personnaliser la configuration MySQL :
1. Ouvrez le fichier my.ini (Windows) ou my.cnf (Linux) dans un éditeur de texte.
2. Ajoutez la ligne suivante à la section
[mysqld]
: max_allowed_packet=25M
3. Enregistrez le fichier, puis fermez-le.
Création d'une base de données Oracle
Si vous ne souhaitez pas utiliser la base de données par défaut générée au cours de l'installation d'Oracle 9i ou 10g, créez-en une à l'aide de l'outil Assistant de configuration de la base de données.
Si un des répertoires LDAP avec lesquels la nouvelle base de données va effectuer sa synchronisation pour authentifier les utilisateurs LiveCycle comprend des enregistrements intégrant des caractères UTF-8, vous devez créer une base de données utilisant le jeu de caractères UTF-8.
Vous devez également créer un nouvel utilisateur pour cette base de données et lui affecter les rôles DBA,
CONNECT et RESOURCE, ainsi que les droits système ACCESS_ANY_WORKSPACE, UNLIMITED TABLESPACE et CREATE VIEW. En cas de déploiement sous Linux, le nom d'utilisateur ne doit pas dépasser 8 caractères.
Sous Windows, cette limite est de 12 caractères.
Le nom d'utilisateur et le mot de passe du nouvel utilisateur créé dans la base de données sont réutilisés lors de la création de la source de données.
Pour plus de détails sur l'utilisation d'Oracle 9i ou 10g, reportez-vous aux manuels d'utilisation correspondants.
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Préparation de l'environnement
Création d'une base de données DB2 44
Création d'une base de données DB2
Pour créer une base de données DB2, exécutez le script fourni dans cette section. Ce script est défini pour un système utilisant 1 Go de mémoire pour la base de données. Si votre système dédie à la base de données une taille de mémoire différente, reportez-vous à la documentation de DB2 pour plus de détails sur la configuration des paramètres système.
Vous devez également créer un utilisateur avec des droits SYSADM et DBADM pouvant servir lors de la configuration de la source de données sur le serveur d'applications. Pour plus de détails sur la création d'un utilisateur, reportez-vous à la documentation de DB2. En cas de déploiement sous Linux, le nom d'utilisateur ne doit pas dépasser 8 caractères. Sous Windows, cette limite est de 12 caractères.
Le nom d'utilisateur et le mot de passe du nouvel utilisateur créé dans la base de données sont réutilisés lors de la création de la source de données.
Après avoir créé la base de données, vous devez la configurer pour permettre plusieurs utilisations
³
Pour créer une base de données DB2 :
1. Sur l'ordinateur hébergeant DB2, créez un nouveau fichier texte contenant le script DB2 suivant : create database dbname using codeset utf-8 territory default; connect to dbname;
CREATE BUFFERPOOL "BP8K" SIZE 50000 PAGESIZE 8192 NOT EXTENDED STORAGE; connect reset; connect to dbname;
CREATE TEMPORARY TABLESPACE DBNAME_TEMP_8K IN DATABASE PARTITION GROUP
IBMTEMPGROUP PAGESIZE 8192 MANAGED BY SYSTEM USING
('DB2_root\DBNAME_TEMP')
EXTENTSIZE 32 PREFETCHSIZE 16 BUFFERPOOL BP8K;
CREATE REGULAR TABLESPACE DBNAME_DATA_8K IN DATABASE PARTITION GROUP
IBMDEFAULTGROUP PAGESIZE 8192 MANAGED BY DATABASE USING
(FILE'DB2_root\DBNAME_DATA'9000) EXTENTSIZE 16 PREFETCHSIZE 16 BUFFERPOOL
BP8K; commit work; connect reset; connect to dbname; alter bufferpool ibmdefaultbp immediate size 96000; alter bufferpool bp8k immediate size 32000; commit work; connect reset; update db cfg for dbname using dbheap 4000; update db cfg for dbname using logbufsz 2048; update db cfg for dbname using locklist 2000; update db cfg for dbname using chngpgs_thresh 40; update db cfg for dbname using logfilsiz 4000; deactivate database dbname; activate database dbname;
2. Apportez les modifications suivantes au script :
O
O
Remplacez les instances de
dbname
et
DBNAME
par le nom que vous souhaitez donner à la base de données LiveCycle.
Remplacez
DB2_root
par le chemin d'accès au répertoire racine dans lequel DB2 est installé.
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Préparation de l'environnement
Configuration d'une base de données DB2 pour plusieurs utilisations simultanées 45
O
O
Vérifiez qu'aucune commande ne contient de saut de ligne et que chacune d'elles est suivie d'un point-virgule (;).
Modifiez
9000
dans la ligne suivante en fonction de la taille de votre base de données :
(FILE'DB2_root\DBNAME_DATA'9000)
Ce chiffre définit le nombre minimum de pages requises pour initialiser la base de données. Vous pouvez également modifier ce chiffre à l'aide des outils d'administration DB2 une fois la base de données initialisée.
3. Enregistrez le fichier texte dans un emplacement accessible par le processeur de ligne de commandes DB2.
4. Ouvrez une invite de commande.
5. (Windows) Saisissez la commande suivante pour ouvrir le processeur de ligne de commande DB2 : db2cmd
6. Saisissez la commande suivante pour exécuter le script : db2 -tf <path_to_script_file>/<script_file_name>
Configuration d'une base de données DB2 pour plusieurs utilisations simultanées
Si vous utilisez une base de données DB2, vous devez la configurer pour plusieurs utilisateurs.
³
Pour configurer la base de données DB2 en vue de plusieurs accès simultanés :
1. Démarrez DB2 Control Center :
O
O
(Windows) Sélectionnez Démarrer > Programmes > IBM DB2 > General Administration Tools >
Control Center.
(Linux) Ouvrez une invite de commande et saisissez : db2jcc
2. Dans l'arborescence de DB2 Control Center, cliquez sur All Databases.
3. Cliquez avec le bouton droit de la souris sur la base de données que vous avez créée pour les produits
LiveCycle et cliquez sur Configuration Advisor.
4. Suivez les étapes de l'assistant de Configuration Advisor et vérifiez que les propriétés de la table suivante sont définies.
Propriété DB2 Valeur requise
Workload type Mixed
Average number of SQL transactions per unit of work
Fewer than 10
Database Administration Priority Faster transaction performance
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Préparation de l'environnement
Création d'une base de données SQL Server 46
Propriété DB2
Populated Database
Isolation Level
Valeur requise
Set according to the current state of the database. The database is not populated if the database has not yet been initialized using Configuration Manager.
Cursor Stability
Création d'une base de données SQL Server
Vous pouvez créer une base de données SQL Server que les produits LiveCycle utiliseront pour stocker les données d'exécution et de configuration. Pour plus de détails sur la création d'une base de données SQL
Server, reportez-vous à la documentation correspondante. Les produits LiveCycle prennent en charge SQL
Server 2000 SP3a.
Créez une base de données SQL Server et un utilisateur doté de droits DB_OWNER pouvant être utilisés lors de la configuration de la source de données sur le serveur d'applications. Pour plus de détails sur la création de la base de données et de l'utilisateur, reportez-vous à la documentation de SQL Server.
Vous pouvez configurer la base de données SQL Server avec les types d'authentification Windows ou SQL
Server. Pour exécuter une base de données avec JBoss, il faut que le type d'authentification soit défini sur
SQL Server.
Remarque :
LiveCycle PDF Generator requiert également une base de données JMS sur SQL Server.
Reportez-vous à la section
« Création d'une base de données JMS sur SQL Server », page 46
.
Création d'une base de données JMS sur SQL Server
Cette section s'applique uniquement à LiveCycle PDF Generator.
Pour déployer LiveCycle PDF Generator sur JBoss en plus de la base de données LiveCycle, vous devez
également créer une base de données Java Message Service (JMS) sur SQL Server.
³
Pour créer une base de données JMS :
1. Sélectionnez Démarrer > Programmes > Microsoft SQL Server > Enterprise Manager.
2. Dans l'arborescence, sélectionnez Console Root > Microsoft SQL Servers > SQL Server
Group > [nom_serveur] > Databases.
3. Cliquez avec le bouton droit de la souris sur Databases, puis sur New Database.
4. Dans le champ Name, donnez un nom à la base de données et cliquez sur OK.
5. Dans l'arborescence, sélectionnez Console Root > Microsoft SQL Servers > SQL Server Group >
[nom_serveur] > Security > Logins.
6. Cliquez avec le bouton droit de la souris sur Logins et sélectionnez New Login.
7. Dans l'écran des propriétés de SQL Server, entrez un nom de connexion dans le champ Name, sélectionnez SQL Server Authentication et saisissez un mot de passe dans le champ Password.
8. Cliquez sur l'onglet Database Access, sélectionnez la base de données créée à l'étape
Permit in Database Role, sélectionnez public et db_owner.
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Préparation de l'environnement
Création d'une base de données JMS sur SQL Server 47
9. Cliquez sur l'onglet Server Roles, sélectionnez Database Creators, puis cliquez sur OK.
11. Dans l'arborescence, cliquez avec le bouton droit de la souris sur Logins, sélectionnez New Login, entrez guest
dans le champ Name, puis sélectionnez SQL Server Authentication.
12. Vérifiez que la base de données par défaut est définie sur la base de données créée à l'étape 4
et que la langue par défaut est le français.
13. Cliquez sur l'onglet Database Access, sélectionnez la base de données créée à l'étape
Permit in Database Role, sélectionnez public, puis cliquez sur OK.
14. Dans l'écran de confirmation du mot de passe, sélectionnez Blank Password et cliquez sur OK.
15. Sélectionnez Démarrer > Programmes > Microsoft SQL Server > Query Analyzer, puis
connectez-vous au moyen de l'authentification utilisateur créée à l'étape 7
.
16. Copiez le script SQL suivant dans la fenêtre Query :
USE YourDatabase;
CREATE TABLE JMS_MESSAGES (MESSAGEID INTEGER NOT NULL,
DESTINATION VARCHAR(150) NOT NULL, TXID INTEGER, TXOP CHAR(1),
MESSAGEBLOB IMAGE, PRIMARY KEY (MESSAGEID, DESTINATION));
CREATE TABLE JMS_TRANSACTIONS (TXID INTEGER);
CREATE TABLE JMS_USERS (USERID VARCHAR(32) NOT NULL,
PASSWD VARCHAR(32) NOT NULL, CLIENTID VARCHAR(128), PRIMARY KEY(USERID));
CREATE TABLE JMS_ROLES (ROLEID VARCHAR(32) NOT NULL,
USERID VARCHAR(32) NOT NULL, PRIMARY KEY(USERID, ROLEID));
CREATE TABLE JMS_SUBSCRIPTIONS (CLIENTID VARCHAR(128) NOT NULL,
SUBNAME VARCHAR(128) NOT NULL, TOPIC VARCHAR(255) NOT NULL,
SELECTOR VARCHAR(255), PRIMARY KEY(CLIENTID, SUBNAME));
INSERT INTO JMS_USERS (USERID, PASSWD) VALUES ('guest', 'guest');
INSERT INTO JMS_USERS (USERID, PASSWD) VALUES ('j2ee', 'j2ee');
INSERT INTO JMS_USERS (USERID, PASSWD, CLIENTID) VALUES ('john', 'needle',
'DurableSubscriberExample');
INSERT INTO JMS_USERS (USERID, PASSWD) VALUES ('nobody', 'nobody');
INSERT INTO JMS_USERS (USERID, PASSWD) VALUES ('dynsub', 'dynsub');
INSERT INTO JMS_ROLES (ROLEID, USERID) VALUES ('guest','guest');
INSERT INTO JMS_ROLES (ROLEID, USERID) VALUES ('j2ee','guest');
INSERT INTO JMS_ROLES (ROLEID, USERID) VALUES ('john','guest');
INSERT INTO JMS_ROLES (ROLEID, USERID) VALUES ('subscriber','john');
INSERT INTO JMS_ROLES (ROLEID, USERID) VALUES ('publisher','john');
INSERT INTO JMS_ROLES (ROLEID, USERID) VALUES ('publisher','dynsub');
INSERT INTO JMS_ROLES (ROLEID, USERID) VALUES ('durpublisher','john');
INSERT INTO JMS_ROLES (ROLEID, USERID) VALUES ('durpublisher','dynsub');
INSERT INTO JMS_ROLES (ROLEID, USERID) VALUES ('noacc','nobody');
17. Dans la première ligne du script, remplacez
YourDatabase
par le nom de la base de données créée à l'étape
.
18. Exécutez le script en cliquant sur la flèche verte de la barre des tâches. L'exécution du script SQL ne doit normalement pas rencontrer de problème.
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Préparation de l'environnement
Préparation du serveur d'applications 48
Préparation du serveur d'applications
Vous devez installer le serveur d'applications que vous utiliserez pour exécuter les produits LiveCycle. Vous devez également exécuter certaines configurations préliminaires sur le serveur d'applications.
Installation du serveur d'applications JBoss
Si vous configurez manuellement JBoss pour exécuter les produits LiveCycle, vous devez télécharger JBoss
Application Server 3.2.5 et l'installer. Vous pouvez télécharger JBoss à l'adresse suivante : http://labs.jboss.com/portal/jbossas/download
Si vous procédez à une installation clé en main, il est inutile d'installer JBoss car Configuration Manager l'installe automatiquement.
www-1.ibm.com/support/docview.wss?rs=180&uid=swg27006876
Dans un navigateur Web, saisissez l'adresse suivante : http://www.oracle.com/technology/software/tech/java/sqlj_jdbc/htdocs/jdbc_10201.html
Etape suivante
Vous devez maintenant configurer les produits LiveCycle pour le déploiement. Reportez-vous à la section
« Configuration des produits LiveCycle à déployer », page 49
.
6
Configuration des produits LiveCycle à déployer
Ce chapitre décrit la procédure de configuration des produits LiveCycle en vue de leur déploiement.
Il suppose que vous avez déjà installé les produits LiveCycle. Si ce n'est pas le cas, reportez-vous à la section
« Installation des produits LiveCycle », page 35
.
L'instance de Configuration Manager installée avec un produit LiveCycle peut être utilisée avec tous les produits LiveCycle. Lorsque vous exécutez Configuration Manager, vous indiquez les produits LiveCycle configurés ainsi que le type de serveur d'applications mis en œuvre dans la solution. Vous pouvez
également définir des propriétés d'exécution pour les produits LiveCycle et activer ou désactiver la sécurité.
Si vous utilisez déjà un ou plusieurs produits LiveCycle, vous devez les configurer et les assembler avec le nouveau produit que vous souhaitez configurer. Pour ce faire, vous devez annuler le déploiement des produits précédemment déployés et sélectionner tous les produits que vous souhaitez assembler pendant la configuration. Les produits existants sont alors inclus dans le fichier LiveCycle.ear et déployés avec le nouveau produit lors du déploiement de ce fichier sur le serveur d'applications.
Remarque :
pour assembler plusieurs produits LiveCycle, vous devez tous les installer dans le même répertoire [racine LiveCycle].
Lorsque Configuration Manager termine la configuration des produits, il place les fichiers à déployer sur le serveur d'applications (LiveCycle.ear, adobe-FontManager.ear et product-related ear) dans le répertoire suivant :
O
O
(Windows) [racine LiveCycle]\configurationManager\export
(Linux) [racine LiveCycle]/configurationManager/export
³
Pour configurer les produits en vue du déploiement :
1. Accédez au répertoire [racine LiveCycle]/configurationManager et démarrez Configuration Manager :
O
(Windows) Cliquez deux fois sur ConfigurationManager.exe.
O
(Linux) Ouvrez une invite de commande et saisissez :
ConfigurationManager.bin
2. Si vous y êtes invité, sélectionnez la langue souhaitée pour l'interface de Configuration Manager et cliquez sur OK.
3. Dans l'écran de bienvenue de Configuration Manager, cliquez sur Suivant.
4. Sélectionnez Assistant de configuration personnalisée et cliquez sur Suivant.
5. Dans l'écran Préférences de configuration, sélectionnez Utiliser les valeurs saisies ou Rétablir les
valeurs par défaut, puis cliquez sur Suivant.
6. Sélectionnez le serveur d'applications installé, puis Création et les produits à configurer et cliquez sur
Suivant.
7. (LiveCycle Forms) Dans l'écran de sélection d'Adobe User Management, sélectionnez LiveCycle Forms
avec User Management et Administration ou LiveCycle Forms sans User Management et
Administration, puis cliquez sur Suivant.
49
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Configuration des produits LiveCycle à déployer
50
8. Vérifiez que seule l'option Configurer et assembler les produits LiveCycle est sélectionnée, puis cliquez sur Suivant.
9. Dans l'écran Configurer et assembler les produits, cliquez sur Suivant.
10. (Facultatif ) si vous utilisez la sécurité SSL sur votre serveur d'applications, sélectionnez Activer SSL et saisissez le mot de passe d'identification SSL dans l'écran de configuration du module Data Manager.
Si vous n'avez pas encore défini les informations d'identification SSL, vous pouvez saisir un mot de passe ici et l'utiliser pour créer ces informations. Reportez-vous à la section « Configuration de SSL sur
JBoss », page 74 .
11. Saisissez un chemin de répertoire à utiliser pour le fichier temporaire des produits Adobe LiveCycle, puis cliquez sur Suivant.
Remarque :
(Linux) Si vous n'êtes pas connecté comme utilisateur racine, spécifiez un répertoire sous votre répertoire racine.
Pour plus de détails sur le fichier temporaire des produits Adobe LiveCycle, consultez la section
« Optimisation de documents en ligne d'entrée et impacts sur la mémoire JVM », page 143 .
12. Dans la suite de l'écran de configuration du module Data Manager, acceptez les valeurs par défaut des propriétés suivantes ou spécifiez de nouvelles valeurs, puis cliquez sur Suivant :
O
Intervalle de balayage du stockage local (en secondes) : durée entre les tentatives de suppression des fichiers obsolètes utilisés pour transmettre les données du document entre les services LiveCycle exécutés sur le même ordinateur.
O
O
O
Intervalle de balayage du stockage global (en secondes) : durée entre les tentatives de suppression des fichiers obsolètes utilisés pour transmettre les données de document entre des services LiveCycle exécutés sur différents ordinateurs. Spécifiez cette propriété uniquement lors du déploiement de produits LiveCycle dans un environnement de groupes de serveurs.
Taille maximale par défaut de la ligne d'entrée (en octets) : nombre maximum d'octets stockés en mémoire lors de l'envoi de documents entre différents composants LiveCycle. Les documents qui dépassent cette valeur sont stockés sur le disque dur. Utilisez cette propriété afin d'améliorer les performances du système. Reportez-vous à la section « Optimisation de documents en ligne d'entrée et impacts sur la mémoire JVM », page 143 .
Délai par défaut avant suppression (en secondes) : durée maximale pendant laquelle un document transmis entre différents composants LiveCycle est considéré comme actif. Lorsque ce délai est écoulé, les fichiers utilisés pour stocker ce document peuvent être supprimés. Utilisez cette propriété pour gérer l'espace disque disponible.
O
O
Utiliser le protocole NFS (Windows uniquement) : sélectionnez cette option lors du déploiement de produits LiveCycle dans un environnement de groupes de serveurs. Les logiciels NFS supplémentaires doivent être installés sur un ordinateur équipé de Windows pour que cette option puisse être activée. Cette option ne concerne pas les déploiements sous Linux.
Répertoire de stockage global : chemin d'accès à un répertoire partagé utilisé pour stocker les documents de longue durée transférés entre les produits LiveCycle. LiveCycle Workflow utilise ce répertoire pour partager des fichiers liés aux processus entre les nœuds de serveurs. LiveCycle
Form Manager utilise ce répertoire pour stocker les fichiers d'index utilisés pour les recherches de texte entier. L'utilisation d'un répertoire NFS partagé peut contribuer à améliorer les performances.
(LiveCycle PDF Generator) Lorsque LiveCycle PDF Generator fonctionne comme un service, vous devez utiliser l'adresse réseau du dossier et non le chemin d'un lecteur mappé pour spécifier un dossier de réseau pour la propriété du répertoire de stockage global. Par exemple,
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Configuration des produits LiveCycle à déployer
51
\\nom_ordinateur\temp correspond à l'adresse réseau du dossier temp sur l'ordinateur nom_ordinateur.
Pour plus de détails sur la propriété du répertoire de stockage global, reportez-vous à la section
« Optimisation de documents en ligne d'entrée et impacts sur la mémoire JVM », page 143 .
13. (LiveCycle Forms, LiveCycle Form Manager, LiveCycle Workflow, LiveCycle Assembler) (Facultatif ) Dans l'écran Configuration de module Font Manager, sélectionnez les polices de LiveCycle Forms à utiliser en plus de celles fournies avec le produit. Dans le champ Répertoire des polices, entrez le chemin du répertoire contenant les polices à ajouter ou recherchez-le, puis cliquez sur Suivant.
Remarque :
les droits d'utilisation relatifs aux polices fournies par des sociétés autres qu'Adobe sont régis par les contrats de licence accompagnant ces polices. Ils ne sont pas couverts par la licence d'utilisation du logiciel Adobe qui vous est concédée. Adobe vous recommande de vous assurer que vous agissez en conformité avec tous les contrats de licence de sociétés tierces applicables avant d'utiliser des polices non-Adobe avec des logiciels Adobe, notamment en ce qui concerne l'utilisation de polices dans des environnements de serveurs.
14. (LiveCycle Assembler) (Facultatif ) Dans l'écran de configuration du groupe de sécurité d'Assembler, indiquez le type de sécurité à mettre en place pour contrôler les autorisations d'exécution des tâches DDX d'Assembler, puis cliquez sur Suivant. Il existe deux types d'authentification utilisateur :
O
O
Entrez un astérisque (*) pour permettre à tous les utilisateurs possédant une entrée valide dans le système LDAP de se connecter.
Laissez le champ vide pour permettre à tous les utilisateurs de se connecter.
15. (LiveCycle Forms, LiveCycle Form Manager, LiveCycle Workflow) (Facultatif ) Dans l'écran de configuration du module Form Server, acceptez les valeurs par défaut des propriétés suivantes ou spécifiez de nouvelles valeurs, puis cliquez sur Suivant :
O
O
Interface utilisateur de validation : type d'interface utilisateur à utiliser pour les formulaires HTML en cas d'erreur de validation. Si vous sélectionnez Liste, toutes les erreurs de validation figurant sur le formulaire apparaissent sous forme de liens. Si vous sélectionnez Zone de message, chaque message d'erreur s'affiche dans une boîte de dialogue contrôlée à l'aide des boutons Suivant et
Précédent. L'emplacement de la liste ou des boutons dépend de l'option sélectionnée pour Rapport de validation.
Rapport de validation : emplacement dans lequel les messages de validation s'affichent.
Sélectionnez l'une des options suivantes :
O
O
O
Cadre à gauche : affiche les messages de validation dans un cadre à gauche du navigateur Web.
Cadre à droite : affiche les messages de validation dans un cadre à droite du navigateur Web.
Cadre en haut : affiche les messages de validation dans un cadre au-dessus du navigateur Web.
O
O
O
O
O
Cadre en bas : affiche les messages de validation dans un cadre sous le navigateur Web.
Pas de cadre à gauche : affiche les messages de validation dans la même fenêtre à gauche du navigateur Web.
Pas de cadre à droite : affiche les messages de validation dans la même fenêtre à droite du navigateur Web.
Pas de cadre en haut : affiche les messages de validation dans la même fenêtre au-dessus du navigateur Web.
Pas de cadre en bas : affiche les messages de validation dans la même fenêtre sous le navigateur Web.
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Configuration des produits LiveCycle à déployer
52
O
O
O
O
O
O
O
Aucun : n'affiche pas les messages de validation.
Pas d'interface utilisateur : renvoie les messages de validation via l'API (avec données). Les messages de validation n'apparaissent pas à l'écran.
O
Pas d'interface utilisateur avec formulaire : renvoie les messages de validation via l'API (avec le formulaire). Les messages de validation n'apparaissent pas à l'écran.
Limite de validation : taille limite du cadre (en pixels) lorsque Rapport de validation est défini sur
Cadre à gauche, Cadre à droite, Cadre en haut ou Cadre en bas. La taille du cadre doit être égale ou supérieure à 0.
Type de sortie : type de sortie HTML renvoyée au navigateur Web. Sélectionnez HTML complet pour afficher le formulaire avec des balises HTML complètes (page HTML complète) ou Corps de
formulaire pour afficher le formulaire avec des balises div (page HTML incomplète).
Paramètres régionaux : langue utilisée pour les messages de validation envoyés aux périphériques clients, tels que les navigateurs Web, dans le cadre des transformations HTML. La langue par défaut est le français. Pour plus de détails sur les valeurs possibles, consultez la section sur les combinaisons de langue et de paramètres régionaux du guide Developing Custom
Applications installé avec LiveCycle Forms.
Jeu de caractères : ensemble de caractères utilisés pour encoder le flux d'octets de sortie. Cette propriété dépend du paramètre sFormPreference spécifié à l'aide de l'API. Pour les transformations HTML, le module Form Server prend en charge les valeurs d'encodage de caractères définies par le package java.nio.charset. Pour afficher la liste des valeurs prises en charge, accédez à la page http://java.sun.com/j2se/1.4.2/docs/guide/intl/encoding.doc.html
.
Cache activé : sélectionnez cette option pour optimiser les performances. Cette option est associée
à la propriété de mise en cache d'une conception de formulaire. Pour plus de détails sur la configuration de cette valeur dans la conception de formulaire, consultez l'aide d'Adobe
LiveCycle Designer.
16. (LiveCycle Forms, LiveCycle Form Manager, LiveCycle Workflow) (Facultatif ) Dans l'écran de configuration du module XMLForm, acceptez les valeurs par défaut des propriétés suivantes ou spécifiez de nouvelles valeurs, puis cliquez sur Suivant :
O
Pool Max : nombre maximum de processus autorisés simultanément. La valeur recommandée pour
Pool Max correspond au nombre total de CPU x 2 + constante (1 ou 2). Lorsque la limite Pool Max est atteinte, les instances de services sont créées à partir de Pool Size.
O
Niveau de tracé : correspond au niveau de tracé. Les options suivantes sont disponibles :
O
Aucun : le tracé n'est pas activé.
O
O
O
Entrer/Quitter : des messages sont consignés chaque fois que vous accédez à une méthode ou que vous la quittez.
Paramètres : des messages sont consignés chaque fois que vous accédez à une méthode ou que vous la quittez, et la valeur de tous les paramètres transmis à chaque méthode est consignée.
O
Détails : des messages sont consignés chaque fois que vous accédez à une méthode ou que vous la quittez. La valeur de tous les paramètres transmis à chaque méthode est consignée, ainsi que tout message supplémentaire.
Consigner les informations sur la durée : sélectionnez cette option pour contrôler les heures de début et de fin des appels. Vous pouvez utiliser cette information pour affiner les performances.
17. Dans l'écran Configuration et assemblage de l'application - Résumé, passez en revue les détails de configuration, puis cliquez sur Suivant.
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Configuration des produits LiveCycle à déployer
53
18. Dans l'écran de résumé de configuration et d'assemblage des produits, cliquez sur Suivant.
19. Dans l'écran Tâches effectuées, cliquez sur Suivant (si vous avez sélectionné une autre tâche de
Configuration Manager à exécuter) ou sur Terminer pour fermer Configuration Manager.
Etape suivante
Vous devez maintenant configurer votre serveur d'applications. Reportez-vous à la section
« Configuration manuelle de JBoss », page 54
.
7
Configuration manuelle de JBoss
Ce chapitre explique comment configurer manuellement le serveur d'applications JBoss pour préparer le déploiement manuel des produits LiveCycle. Vous pouvez également configurer automatiquement votre
Vous devez exécuter les opérations suivantes :
O
Modifier différents fichiers de configuration JBoss sur l'instance de JBoss hébergeant les produits
O
O
Copier le fichier Watched Folder approprié sur JBoss. Reportez-vous à la section
JBoss pour Watched Folder », page 59
.
Créer la source de données pour permettre aux produits LiveCycle de se connecter à la base de données. Reportez-vous à la section
« Connexion de JBoss pour les produits LiveCycle à la base de données LiveCycle », page 59 .
Remarque :
si vous avez installé LiveCycle PDF Generator en plus des produits LiveCycle précédemment installés, vous devez remplacer les informations d'identification du compte d'ouverture de session utilisateur par celles du compte utilisé pour installer Microsoft Office sur l'ordinateur disposant de LiveCycle.
Les procédures décrites dans ce chapitre concernent la configuration du serveur d'applications de tous les produits LiveCycle. Si un produit requiert un autre processus, les étapes sont indiquées. Si vous avez déjà configuré le serveur d'applications pour le déploiement d'autres produits LiveCycle, il est inutile de répéter ces procédures.
Ce chapitre suppose que vous avez configuré la base de données et créé un compte utilisateur pour cette
dernière. Si ce n'est pas le cas, reportez-vous au point « Préparation de l'environnement », page 42
.
Démarrage et arrêt de JBoss
Plusieurs procédures de ce chapitre requièrent que vous arrêtiez et relanciez l'instance de JBoss dans laquelle vous souhaitez déployer les produits LiveCycle.
³
Pour démarrer JBoss :
1. Ouvrez une invite de commande et recherchez [racine du serveur d'applications]/bin.
2. Pour démarrer le serveur, saisissez la commande suivante :
O
(Windows)
run.bat -c all
O
(Linux)
./run.sh -c all
³
Pour arrêter JBoss :
1. Ouvrez une invite de commande et recherchez [racine du serveur d'applications]/bin.
2. Pour arrêter le serveur, saisissez la commande suivante :
O
(Windows)
shutdown.bat -S
O
(Linux)
./shutdown.sh -S
54
Adobe LiveCycle
Installing and Configuring LiveCycle pour JBoss
Configuration manuelle de JBoss
Modification des fichiers de configuration JBoss 55
Modification des fichiers de configuration JBoss
Les éléments suivants doivent être modifiés sur l'instance de JBoss hébergeant les produits LiveCycle :
O le répertoire endorsed ;
O
O le fichier run.bat (Windows) ou run.sh (Linux) ;
JMS ;
O
O
O
O le fichier jacorb.properties ; l'isolation du chargement de classe du fichier EAR ; le nombre maximal de threads ; le fichier dom4j.jar ;
O le fichier cluster-service.xml.
Remarque :
si vous exécutez JBoss sous Red Hat Enterprise Linux Advanced Server 3.0, vous devez définir la variable d'environnement LD_ASSUME_KERNEL sur 2.4.19 à l'aide de la commande d'exportation LD_ASSUME_KERNEL=2.4.19. Vous devez ensuite exécuter JBoss depuis le même shell que celui où vous avez défini la variable d'environnement.
³
Pour créer un répertoire endorsed :
1. Accédez au répertoire [racine du serveur d'applications]/server/all/lib et créez un répertoire nommé
endorsed.
2. Copiez les fichiers suivants du répertoire [racine LiveCycle]/components/um/endorsed vers le répertoire endorsed que vous venez de créer :
O
O
O dom3-xercesImpl-2.4.0.jar
dom3-xml-apis-2.4.0.jar
xalan-2.4.1.jar
³
Pour modifier le fichier run.bat ou run.sh :
1. Accédez au répertoire [racine du serveur d'applications]/bin et ouvrez le fichier suivant dans un éditeur de texte.
O
O
(Windows) run.bat
(Linux) run.sh
Conseil :
désactivez le retour à la ligne automatique lors de la modification pour vous assurer de l'absence de retour à la ligne forcé au niveau de ces lignes de commande.
2. (Windows) Dans le fichier run.bat, localisez la ligne suivante :
"%JAVA%" %JAVA_OPTS% -classpath "%JBOSS_CLASSPATH%" org.jboss.Main %*
Remplacez-la par le texte suivant :
"%JAVA%" %JAVA_OPTS% -classpath "%JBOSS_CLASSPATH%" -Xms128m -Xmx512m
-Dorg.apache.lucene.writeLockTimeout=10000
-Djava.endorsed.dirs=%JBOSS_HOME%/server/all/lib/endorsed org.
jboss.Main -c all %*
Adobe LiveCycle
Installing and Configuring LiveCycle pour JBoss
Configuration manuelle de JBoss
Modification des fichiers de configuration JBoss 56
3. (Linux) Dans le fichier run.sh, localisez la ligne suivante :
# Execute the JVM
"$JAVA" $JAVA_OPTS \
-classpath "$JBOSS_CLASSPATH" \ org.jboss.Main "$@"
Remplacez-la par le texte suivant :
# Execute the JVM
"$JAVA" $JAVA_OPTS -Xms128m -Xmx1024m \
-classpath "$JBOSS_CLASSPATH" \
-Dorg.apache.lucene.writeLockTimeout=10000\
-Djava.endorsed.dirs=$JBOSS_HOME/server/all/lib/endorsed \ org.jboss.Main -c all "$@"
4. (SQL Server) Ajoutez l'argument suivant au texte modifié à l'étape 2
:
-Dadobe.workflow.scheduler.jdbc.delegate=org.quartz.impl.jdbcjobstore
.MSSQLDelegate \
Remarque :
cette commande doit suivre immédiatement la commande -Djava ci-dessus. Sous
Windows, elle doit précéder « org.jboss.Main ».
5. Enregistrez le fichier.
³
Pour modifier la configuration JMS :
1. Accédez au répertoire [racine du serveur d'applications]/server/all/deploy/jms et ouvrez le fichier hajndi-jms-ds.xml dans un éditeur de texte.
2. Ajoutez le texte suivant après la section
JMS XA Resource adapter
:
<tx-connection-factory>
<track-connection-by-tx>true</track-connection-by-tx>
<jndi-name>adobe_JmsQueueXA</jndi-name>
<xa-transaction/>
<adapter-display-name>JMS Adapter</adapter-display-name>
<config-property type="java.lang.String" name="SessionDefaultType">javax.jms.Topic</config-property>
<security-domain-and-application>JmsXARealm
</security-domain-and-application>
<config-property type="java.lang.String" name="JmsProviderAdapterJNDI">java:/DefaultJMSProvider
</config-property>
<tx-connection-factory>
<tx-connection-factory>
<track-connection-by-tx>true</track-connection-by-tx>
<jndi-name>adobe_JmsTopicXA</jndi-name>
<xa-transaction/>
<adapter-display-name>JMS Adapter</adapter-display-name>
<config-property type="java.lang.String" name="SessionDefaultType">javax.jms.Topic
</config-property>
<security-domain-and-application>JmsXARealm
</security-domain-and-application>
Adobe LiveCycle
Installing and Configuring LiveCycle pour JBoss
Configuration manuelle de JBoss
Modification des fichiers de configuration JBoss 57
<config-property type="java.lang.String" name="JmsProviderAdapterJNDI">java:/DefaultJMSProvider
</config-property>
<tx-connection-factory>
3. (LiveCycle PDF Generator, LiveCycle Assembler) Accédez au répertoire [racine du serveur
d'applications]/server/all/deploy/jms et décompressez le fichier jms-ra.rar.
4. (LiveCycle PDF Generator, LiveCycle Assembler) Accédez au répertoire [racine du serveur
d'applications]/server/all/deploy/jms/META-INF et ouvrez le fichier ra.xml dans un éditeur de texte.
5. (LiveCycle PDF Generator, LiveCycle Assembler) Dans le fichier ra.xml, localisez les lignes suivantes :
<config-property-name>Strict</config-property-name>
<config-property-type>java.lang.Boolean</config-property-type>
<config-property-value>true</config-property-value>
Remplacez la valeur true
de
<config-property-value>
par false
et enregistrez les modifications apportées au fichier.
6. Réassemblez le fichier jms-ra.rar.
³
Pour modifier le fichier jacorb.properties :
1. Recherchez le répertoire [racine du serveur d'applications]/server/all/conf et ouvrez le fichier jacorb.properties dans un éditeur de texte.
2. Recherchez la propriété jacorb.poa.thread_pool_max
et attribuez-lui la valeur 16.
³
Pour modifier le nombre maximal de threads :
1. Accédez au répertoire [racine du serveur d'applications]/server/all/deploy/jbossweb-tomcat50.sar/ et ouvrez le fichier server.xml dans un éditeur de texte.
2. Dans l'élément
<connector>
du port 8080, définissez les valeurs suivantes : 75 pour le paramètre maxThreads
, 25 pour le paramètre minSpareThreads et 50 pour le paramètre maxSpareThreads
. Reportez-vous à l'exemple suivant :
<!-- A HTTP/1.1 Connector on port 8080 -->
<Connector port="8080" address="${jboss.bind.address}" maxThreads="75" minSpareThreads="25" maxSpareThreads="50" enableLookups="false" redirectPort="8443" acceptCount="250" connectionTimeout="20000" disableUploadTimeout="true"/>
3. Enregistrez le fichier, puis fermez-le.
³
Pour définir le mode d'isolation de chargement de classe du fichier EAR :
1. Recherchez le répertoire [racine du serveur
d'applications]/server/all/deploy/jbossweb-tomcat50.sar/META-INF et ouvrez le fichier jboss-service.xml dans un éditeur de texte.
2. Localisez l'attribut suivant et définissez-le :
<attribute name="UseJBossWebLoader">false</attribute>
3. Enregistrez le fichier, puis fermez-le.
Adobe LiveCycle
Installing and Configuring LiveCycle pour JBoss
Configuration manuelle de JBoss
Modification des fichiers de configuration JBoss 58
4. Recherchez le répertoire [racine du serveur d'applications]/server/all/conf et ouvrez le fichier jboss-service.xml dans un éditeur de texte.
5. (LiveCycle PDF Generator) Définissez
<attribute name=”Transaction
Timeout”>600</attribute>
sur une valeur adaptée à votre système. Cette valeur doit être supérieure à la valeur définie à la source des travaux (via Administrator après le déploiement).
(Reportez-vous à l'aide à l'administration de LiveCycle PDF Generator.)
6. Dans la section Deployers du fichier, localisez la ligne suivante :
<mbean code="org.jboss.deployment.EARDeployer" name="jboss.j2ee:service=EARDeployer">
:
7. Ajoutez le texte suivant après la ligne.
<!-- Isolate all ears in their own classloader space -->
<attribute name="Isolated">true</attribute>
<!-- Enforce call by value to all remote interfaces -->
<attribute name="CallByValue">true</attribute>
8. Enregistrez le fichier, puis fermez-le.
³
Pour mettre à jour le fichier dom4j.jar :
1. Accédez à l'adresse http://dom4j.org/ et téléchargez une version du fichier dom4j.jar ultérieure à la version 1.5 d'implémentation.
2. Attribuez-lui le nom dom4j.jar.
3. Remplacez le fichier dom4j.jar situé dans le répertoire [racine du serveur d'applications]/lib par le fichier mis à jour que vous avez téléchargé.
Remarque :
ce remplacement est nécessaire car la version de ce fichier incluse dans JBoss 3.2.5 contient des classes org.jaxen.* Ces classes provoquent des conflits avec certains composants des produits LiveCycle.
³
Pour modifier le fichier cluster-service.xml :
1. Recherchez le répertoire [racine du serveur d'applications]/server/all/deploy et ouvrez le fichier cluster-service.xml dans un éditeur de texte.
2. Recherchez l'élément
UDP
et définissez les valeurs d'attribut suivantes :
O
O mcast_port=<random_port_number> ip_ttl="1"
O ip_mcast="false"
La valeur mcast_port
peut être définie sur n'importe quel numéro de port compris entre 30000 et 60000. Chaque instance de JBoss doit utiliser un numéro de port unique, faute de quoi JBoss va tenter de regrouper les serveurs, ce qui aura une incidence sur les performances.
3. Enregistrez le fichier, puis fermez-le.
Adobe LiveCycle
Installing and Configuring LiveCycle pour JBoss
Configuration manuelle de JBoss
Configuration de JBoss pour Watched Folder 59
Configuration de JBoss pour Watched Folder
Si vous déployez Watched Folder pour l'utiliser avec LiveCycle Workflow et LiveCycle Assembler, vous devez exécuter la procédure suivante sur le serveur d'applications sur lequel LiveCycle Workflow et
Watched Folder seront déployés.
³
Pour configurer JBoss pour Watched Folder :
O
Copiez le fichier jboss-watchedfolder-service.xml du répertoire [racine
LiveCycle]/components/watchedFolder/jboss/config dans le répertoire [racine du serveur
d'applications]/server/all/deploy-hasingleton/jms.
Connexion de JBoss pour les produits LiveCycle à la base de données LiveCycle
Vous devez configurer la source de données à connecter à la base de données LiveCycle. Pour JBoss, vous pouvez configurer une source de données MySQL, Oracle 9i, Oracle 10g, DB2 ou SQL Server.
( Voir « Préparation de l'environnement », page 42.
Pour plus de détails sur l'utilisation d'un autre type de base de données que le type par défaut appliqué
à la base de données JBoss JMS, consultez la documentation de JBoss.
Configuration de la source de données MySQL
Pour permettre à JBoss de se connecter à la base de données MySQL contenant les données LiveCycle, vous devez exécuter les tâches suivantes si vous déployez manuellement les produits LiveCycle :
O télécharger le pilote MySQL JDBC et le copier dans l'instance de JBoss dans laquelle vous allez déployer les produits LiveCycle ;
O
Créer un fichier de source de données et le déployer dans l'instance de JBoss dans laquelle vous allez déployer les produits LiveCycle.
Avant de configurer la source de données MySQL, vous devez créer la base de données LiveCycle sur
MySQL. Reportez-vous à la section
« Création d'une base de données MySQL », page 42
.
Lorsque vous effectuez une installation clé en main, le serveur d'applications et les produits sont automatiquement configurés pour interagir avec la base de données MySQL également installée de manière automatique lors de l'installation clé en main.
³
Pour télécharger le pilote JDBC pour MySQL et le copier :
1. Copiez le fichier mysql-connector-java-3.0.15-ga-bin.jar depuis le répertoire [racine
LiveCycle]/configurationManager/lib ou téléchargez-le sur le site Web de MySQL à l'adresse suivante www.mysql.com/products/connector/j/ .
2. Copiez le fichier dans le répertoire [racine du serveur d'applications]/server/all/lib.
³
Pour créer le fichier de source de données MySQL :
1. Ouvrez un éditeur de texte et créez un nouveau fichier texte à l'aide du code suivant :
<?xml version="1.0" encoding="UTF-8"?>
<datasources>
Adobe LiveCycle
Installing and Configuring LiveCycle pour JBoss
Configuration manuelle de JBoss
Configuration de la source de données Oracle 60
<local-tx-datasource>
<jndi-name>IDP_DS</jndi-name>
<connection-url>jdbc:mysql://host_name:port/database_name
</connection-url>
<driver-class>com.mysql.jdbc.Driver</driver-class>
<user-name>database_username</user-name>
<password>password</password>
<min-pool-size>1</min-pool-size>
<max-pool-size>100</max-pool-size>
<blocking-timeout-millis>20000</blocking-timeout-millis>
<idle-timeout-minutes>10</idle-timeout-minutes>
<prepared-statement-cache-size>50</prepared-statement-cache-size>
<transaction-isolation>TRANSACTION_READ_COMMITTED
</transaction-isolation>
</local-tx-datasource>
</datasources>
2. Remplacez le texte en gras par des valeurs spécifiques à votre base de données LiveCycle :
O
host_name
: nom, adresse IP ou chemin d'accès complet de l'ordinateur hébergeant la base de données LiveCycle.
O
port
: port utilisé pour accéder à la base de données LiveCycle. Le port par défaut est 3306.
O
O
database_name
: nom de la base de données contenant les données LiveCycle.
database_username
et
password
: nom d'utilisateur et mot de passe utilisés par le serveur d'applications pour accéder à la base de données LiveCycle.
3. Enregistrez le fichier sous le nom adobe-ds.xml dans le répertoire [racine du serveur
d'applications]/server/all/deploy.
4. Redémarrez JBoss.
Configuration de la source de données Oracle
Pour permettre à JBoss de se connecter à l'espace de stockage d'Oracle 9i ou 10g dans lequel figurent les données LiveCycle, vous devez exécuter les tâches suivantes :
O
Télécharger le pilote Oracle 9i JDBC et le copier dans l'instance de JBoss dans laquelle vous allez déployer les produits LiveCycle.
O
Remarque :
pour Oracle 10g, les classes du pilote JDBC sont disponibles avec l'installation du client ou de la base de données Oracle. Il n'est donc pas nécessaire de les télécharger séparément.
Le pilote JDBC est disponible dans le répertoire [racine serveur base données]/jdbc/lib.
Créer un fichier de source de données et le déployer dans l'instance de JBoss dans laquelle vous allez déployer les produits LiveCycle.
Avant de configurer la source de données Oracle, vous devez créer la base de données LiveCycle sur
Oracle. Reportez-vous à la section « Création d'une base de données Oracle », page 43
.
³
Pour télécharger le pilote JDBC pour Oracle 9i ou 10g et le copier :
1. Téléchargez le fichier ojdbc14.jar adapté à votre base de données sur le site Web d'Oracle à l'adresse www.oracle.com/technology/software/index.html
.
2. Copiez le fichier ojdbc14.jar dans le répertoire [racine du serveur d'applications]/server/all/lib.
Adobe LiveCycle
Installing and Configuring LiveCycle pour JBoss
Configuration manuelle de JBoss
Configuration de la source de données DB2 61
³
Pour créer le fichier de source de données Oracle :
1. Ouvrez un éditeur de texte et créez un nouveau fichier texte à l'aide du code suivant :
<?xml version="1.0" encoding="UTF-8"?>
<datasources>
<local-tx-datasource>
<jndi-name>IDP_DS</jndi-name>
<connection-url>jdbc:oracle:thin:@host_name:port:service_name
</connection-url>
<driver-class>oracle.jdbc.driver.OracleDriver</driver-class>
<user-name>database_username</user-name>
<password>password</password>
<!-- Checks the Oracle error codes and messages for fatal errors -->
<exception-sorter-class-name> org.jboss.resource.adapter.jdbc.vendor.OracleExceptionSorter
</exception-sorter-class-name>
</local-tx-datasource>
</datasources>
Pour plus de détails sur l'URL de connexion d'Oracle, consultez www.oracle.com/technology/tech/java/sqlj_jdbc/htdocs/jdbc_faq.htm#05_04 .
2. Remplacez le texte en gras par des valeurs spécifiques à votre base de données LiveCycle :
O
host_name
: nom, adresse IP ou chemin d'accès complet de l'ordinateur hébergeant la base de données LiveCycle.
O
O
port
: port utilisé pour accéder à la base de données LiveCycle. Le port par défaut est 1521.
service_name
: nom du service de la base de données Oracle.
O
database_username
et
password
: nom d'utilisateur et mot de passe utilisés par le serveur d'applications pour accéder à la base de données LiveCycle.
3. Enregistrez le fichier sous le nom adobe-ds.xml dans le répertoire [racine du serveur
d'applications]/server/all/deploy.
4. Redémarrez JBoss.
Configuration de la source de données DB2
Pour permettre à JBoss de se connecter à la base de données DB2 contenant les données LiveCycle, vous devez exécuter les tâches suivantes :
O télécharger le pilote DB2 JDBC et le copier dans l'instance de JBoss dans laquelle vous allez déployer les produits LiveCycle ;
O créer un fichier de source de données DB2 et le déployer dans l'instance de JBoss dans laquelle vous allez déployer les produits LiveCycle.
Avant de configurer la source de données DB2, vous devez créer la base de données LiveCycle sur DB2.
Reportez-vous à la section
« Création d'une base de données DB2 », page 44
.
³
Pour vous procurer le pilote JDBC pour DB2 et le copier :
1. Copiez les fichiers db2jcc.jar et db2jcc_license_cu.jar à partir des répertoires d'installation DB2.
2. Collez ces fichiers dans le répertoire [racine du serveur d'applications]/server/all/lib.
Adobe LiveCycle
Installing and Configuring LiveCycle pour JBoss
Configuration manuelle de JBoss
Configuration de la source de données SQL Server 62
³
Pour créer le fichier de source de données DB2 :
1. Ouvrez un éditeur de texte et créez un nouveau fichier texte à l'aide du code suivant :
<?xml version="1.0" encoding="UTF-8"?>
<datasources>
<local-tx-datasource>
<jndi-name>IDP_DS</jndi-name>
<connection-url>jdbc:db2://server_name:port/database_name
</connection-url>
<driver-class>com.ibm.db2,jcc.DB2Driver
</driver-class>
<user-name>database_username</user-name>
<password>password</password>
<SelectMethod>Cursor</SelectMethod>
<min-pool-size>1</min-pool-size>
<max-pool-size>100</max-pool-size>
<blocking-timeout-millis>20000</blocking-timeout-millis>
<idle-timeout-minutes>10</idle-timeout-minutes>
</local-tx-datasource>
</datasources>
2. Remplacez le texte en gras par des valeurs spécifiques à votre base de données LiveCycle :
O
server_name
: nom de l'ordinateur exécutant DB2.
O
port
: port utilisé pour accéder à DB2. Le port par défaut est 50000.
O
O
database_name
: nom de la base de données DB2 contenant les données LiveCycle.
Reportez-vous à la section
« Création de la base de données », page 42
.
database_username
et
password
: nom d'utilisateur et mot de passe utilisés par le serveur d'applications pour accéder à la base de données LiveCycle.
3. Enregistrez le fichier sous le nom adobe-ds.xml dans le répertoire [racine du serveur
d'applications]/server/all/deploy.
4. Redémarrez JBoss.
Configuration de la source de données SQL Server
Pour permettre à JBoss de se connecter à la base de données SQL Server contenant les données LiveCycle, vous devez exécuter les tâches suivantes :
O
Télécharger les fichiers du pilote SQL Server JDBC et les copier dans l'instance de JBoss dans laquelle vous allez déployer les produits LiveCycle.
O
Créer un fichier de source de données SQL Server et le déployer dans l'instance de JBoss dans laquelle vous allez déployer les produits LiveCycle.
Avant de configurer la source de données SQL Server, vous devez créer la base de données LiveCycle sur
SQL Server. Reportez-vous à la section
« Création d'une base de données SQL Server », page 46
.
³
Pour télécharger le pilote JDBC pour SQL Server et le copier :
1. Téléchargez le pilote SQL Server 2000 pour JDBC SP3 à partir du site Web de Microsoft www.microsoft.com/sql/downloads et installez-le.
Adobe LiveCycle
Installing and Configuring LiveCycle pour JBoss
Configuration manuelle de JBoss
Configuration de la source de données SQL Server 63
2. Copiez les fichiers msbase.jar, mssqlserver.jar et msutil.jar du répertoire C:\Program Files\Microsoft SQL
Server 2000 Driver for JDBC\lib dans le répertoire [racine du serveur d'applications]/server/all/lib.
³
Pour créer le fichier de source de données SQL Server :
1. Ouvrez un éditeur de texte et créez un nouveau fichier texte à l'aide du code suivant :
<?xml version="1.0" encoding="UTF-8"?>
<datasources>
<local-tx-datasource>
<jndi-name>IDP_DS</jndi-name>
<connection-url>jdbc:microsoft:sqlserver://host_name:port;
DatabaseName=database_name;SelectMethod=Cursor</connection-url>
<driver-class>com.microsoft.jdbc.sqlserver.SQLServerDriver
</driver-class>
<user-name>database_username</user-name>
<password>password</password>
<SelectMethod>Cursor</SelectMethod>
<min-pool-size>1</min-pool-size>
<max-pool-size>100</max-pool-size>
<blocking-timeout-millis>20000</blocking-timeout-millis>
<idle-timeout-minutes>10</idle-timeout-minutes>
<check-valid-connection-sql>SELECT 1</check-valid-connection-sql>
</local-tx-datasource>
</datasources>
2. Remplacez le texte en gras par des valeurs spécifiques à votre base de données LiveCycle :
O
host_name
: nom, adresse IP ou chemin d'accès complet de l'ordinateur hébergeant la base de données LiveCycle.
O
O
port
: port utilisé pour accéder à la base de données LiveCycle. Le port par défaut est 1433.
database_name
: nom de la base de données créée pour servir de base de données LiveCycle.
O
database_username
et
password
: nom d'utilisateur et mot de passe utilisés par le serveur d'applications pour accéder à la base de données LiveCycle.
3. Enregistrez le fichier sous le nom adobe-ds.xml dans le répertoire [racine du serveur
d'applications]/server/all/deploy.
4. Redémarrez JBoss.
Etape suivante
Si vous installez et configurez LiveCycle Workflow tout en prévoyant d'installer et de configurer BAM
Server, vous devez à présent configurer manuellement JBoss pour l'utiliser avec BAM Server.
( Voir « Configuration de JBoss pour BAM Server », page 78.
)
Si vous n'installez pas LiveCycle Workflow, vous devez à présent déployer les autres produits sur la base de données du serveur d'applications. (
Voir « Déploiement sur JBoss », page 65.
8
Déploiement manuel sur JBoss
Ce chapitre décrit la procédure de déploiement de vos produits LiveCycle sur JBoss :
O
« A propos des produits LiveCycle », page 64
O
« Déploiement sur JBoss », page 65
O
O
« Application d'un correctif de pool de connexion pour Watched Folder », page 66
« Affichage des fichiers journaux », page 66
A propos des produits LiveCycle
Avant de déployer les produits LiveCycle, vérifiez que vous avez effectué les opérations suivantes :
O
Vous avez installé le logiciel et les fichiers requis et vous connaissez l'emplacement des répertoires de travail. Reportez-vous à la section
« Configuration système requise », page 13 .
O
O
Vous avez installé les produits LiveCycle. Reportez-vous à la section
.
Vous avez configuré JBoss. Reportez-vous à la section
« Configuration manuelle de JBoss », page 54 .
O
Vous avez exécuté Configuration Manager pour configurer les produits et les assembler conformément aux exigences de votre système et du serveur d'applications. Si vous souhaitez apporter des modifications supplémentaires aux propriétés après le déploiement, vous pouvez exécuter
Configuration Manager pour ce faire, puis redéployer le fichier EAR mis à jour. Reportez-vous à la
section « Configuration des produits LiveCycle à déployer », page 49
.
Si un serveur Web est installé, consultez la documentation correspondante pour plus d'informations sur la configuration requise pour autoriser l'accès au serveur d'applications.
Nom du répertoire JBoss
Ce chapitre fait référence au répertoire racine JBoss 3.2.5 sous le nom [racine du serveur d'applications] et à l'emplacement dans lequel les produits et composants LiveCycle sont installés sous le nom [racine
LiveCycle]. Reportez-vous à la section
« Conventions utilisées dans ce guide », page 8
.
Résumé des composants déployables
Ce tableau reprend les composants déployables des produits LiveCycle.
Composant
adobe-ds.xml
adobe-FontManager.ear
adobe-service.xml
DocumentServicesLibrary.jar
Produit LiveCycle
Tous
Tous
Tous
Tous
64
Adobe LiveCycle
Installing and Configuring LiveCycle pour JBoss
Déploiement manuel sur JBoss
Déploiement sur JBoss 65
Composant
LCM.ear
LiveCycle.ear
adobe-Assembler7.ear
mysql-connector-java-3.0.15-ga-bin.jar
FormsIVS.ear
pdfg-all.ear
pdfg-ps-all.ear
adobe-printSubmitter.ear
Produit LiveCycle
Tous
Tous
LiveCycle Assembler
LiveCycle Assembler et LiveCycle PDF Generator
LiveCycle Forms
LiveCycle PDF Generator Professional et
LiveCycle PDF Generator Elements
LiveCycle PDF Generator for PostScript
LiveCycle Print
Déploiement sur JBoss
Déployez les produits LiveCycle sur JBoss 3.2.5 en copiant les composants déployables dans le répertoire de déploiement. JBoss peut être exécuté ou arrêté lorsque vous copiez les fichiers dans le répertoire. Une fois les fichiers copiés, démarrez ou redémarrez le serveur afin de vous assurer que les services démarrent correctement.
³
Pour déployer des produits LiveCycle sur Jboss :
1. Copiez les fichiers suivants du répertoire [racine LiveCycle]/configurationManager/export dans le répertoire [racine du serveur d'applications]/server/all/deploy :
O
O adobe-FontManager.ear
LiveCycle.ear
2. Copiez le fichier LCM.ear du répertoire [racine LiveCycle]/configurationManager/deploy/jboss dans le répertoire [racine du serveur d'applications]/server/all/deploy.
3. Copiez le fichier adobe-service.xml du répertoire [racine LiveCycle]/configurationManager/ deploy/jboss dans le répertoire [racine du serveur d'applications]/server/all/deploy/jms.
4. Copiez le fichier DocumentServicesLibrary.jar du répertoire [racine LiveCycle]/components/csa/jboss
/lib/adobe dans le répertoire [racine du serveur d'applications]/server/all/lib.
5. (LiveCycle Assembler) Copiez le fichier adobe-Assembler7.ear du répertoire [racine LiveCycle]/ configurationManager/export dans le répertoire [racine du serveur d'applications]/server/all/deploy.
6. (LiveCycle Forms) Copiez le fichier FormsIVS.ear du répertoire [racine LiveCycle]/components/forms
/samples/common dans le répertoire [racine du serveur d'applications]/server/all/deploy.
7. (LiveCycle PDF Generator Professional, LiveCycle PDF Generator Elements) Copiez le fichier pdfg-all.ear du répertoire [racine LiveCycle]/configurationManager/export dans le répertoire [racine du serveur
d'applications]/server/all/deploy.
Adobe LiveCycle
Installing and Configuring LiveCycle pour JBoss
Déploiement manuel sur JBoss
Application d'un correctif de pool de connexion pour Watched Folder 66
8. (LiveCycle PDF Generator for PostScript,) Copiez le fichier pdfg-ps-all.ear du répertoire [racine
LiveCycle]/configurationManager/export dans le répertoire [racine du serveur
d'applications]/server/all/deploy.
9. Relancez JBoss pour vérifier que les applications s'exécutent correctement.
Remarque :
lorsque vous démarrez JBoss, il est possible que plusieurs messages s'affichent dans le fichier journal du serveur JBoss. Ces messages apparaissent si vous n'avez pas encore initialisé la base de données.
Application d'un correctif de pool de connexion pour Watched Folder
Lorsque le chargement de Watched Folder dure depuis un certain temps (délai en heures), JBoss 3.2.5 renvoie une exception car toutes les connexions à la base de données du pool de connexion sont occupées. Il s'agit d'un problème connu dans JBoss 3.2.5. Le correctif du pool de connexion modifie le fichier jboss-jca.sar.
Appliquez ce correctif lors de l'utilisation de Watched Folder dans un environnement de production ou lors du test de Watched Folder en cours de chargement dans un environnement de test. (Le correctif n'est pas nécessaire pour utiliser Watched Folder pour effectuer une démonstration de base ou réaliser des tests.)
³
Pour appliquer le correctif du pool de connexion à JBoss 3.2.5, procédez comme suit :
1. Arrêtez le service JBoss.
2. Remplacez le fichier jboss-jca.sar du répertoire [racine du serveur d'applications]\server\all\deploy par le fichier jboss.-jca.sar du répertoire [racine LiveCycle]\configurationManager\deploy\jboss\.
3. Relancez le service JBoss.
Affichage des fichiers journaux
Les événements comme des erreurs d'exécution ou de démarrage sont enregistrés dans les fichiers journaux du serveur d'applications. Ces fichiers peuvent vous aider à diagnostiquer les problèmes éventuels rencontrés lors du déploiement sur le serveur d'applications. Vous pouvez les ouvrir dans un éditeur de texte.
Les fichiers journaux suivants se trouvent dans le répertoire [racine du serveur
d'applications]/server/all/log :
O
O
O boot.log
server.log.[aaaa-mm-jj] server.log
Etape suivante
Vous devez à présent initialiser la base de données à l'aide de Configuration Manager. (Reportez-vous à la section
« Initialisation de la base de données », page 67
.)
9
Initialisation de la base de données
Ce chapitre décrit la procédure d'initialisation manuelle de la base de données LiveCycle.
Si vous utilisez User Management avec des produits LiveCycle, vous devez exécuter Configuration
Manager pour initialiser la base de données à intégrer à User Management. Le serveur d'applications doit
être en cours de fonctionnement lors de l'exécution de Configuration Manager. L'initialisation de la base de données est une procédure destinée à préparer une base de données pour une utilisation avec des produits LiveCycle, par la création de tables et l'intégration éventuelle de données. Vous devez uniquement exécuter cette procédure lors du premier déploiement du produit.
Au cours de l'initialisation de la base de données, fournissez un port activé SSL uniquement si le serveur d'applications dispose de certificats SSL approuvés. Si le serveur d'applications ne comporte aucun certificat SSL approuvé, un port sur lequel SSL n'est pas activé est requis pour terminer l'initialisation de la base de données. (Reportez-vous à la section
« Configuration de SSL sur JBoss », page 72 .)
Ce chapitre suppose que vous avez configuré la base de données LiveCycle à intégrer au produit et que vous avez déployé ce dernier sur le serveur d'applications. Si ce n'est pas le cas, reportez-vous aux sections
« Préparation de l'environnement », page 42
et
« Déploiement manuel sur JBoss », page 64 .
³
Pour initialiser la base de données :
1. Lancez le serveur d'applications.
2. Démarrez Configuration Manager en accédant au répertoire [racine LiveCycle]/configurationManager et saisissez la commande suivante :
O
O
(Windows)
ConfigurationManager.exe
(Linux)
ConfigurationManager.bin
3. Dans l'écran de bienvenue, cliquez sur Suivant.
4. Dans l'écran du type de configuration, sélectionnez Assistant de configuration personnalisée et cliquez sur Suivant.
5. Dans l'écran Préférences de configuration, sélectionnez Utiliser les valeurs saisies ou Rétablir les
valeurs par défaut, puis cliquez sur Suivant.
6. Dans l'écran de sélection du produit, sélectionnez Création, puis les produits à configurer et déployer.
Cliquez ensuite sur Suivant.
7. Dans l'écran de sélection des tâches, sélectionnez Démarrer la base de données, puis cliquez sur
Suivant.
Remarque :
vous ne devez sélectionner que l'option Démarrer la base de données ; aucune autre option n'est requise.
8. Dans l'écran de l'URL du serveur d'applications, entrez l'URL que Configuration Manager peut utiliser pour se connecter au serveur d'applications dans le champ URL de base du serveur d'applications, puis cliquez sur Suivant. Dans l'écran de préparation de la base de données pour LiveCycle, cliquez sur
Suivant.
67
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Initialisation de la base de données
68
9. Dans l'écran d'initialisation de la base de données, cliquez sur Initialiser la base de données, puis sur
Suivant une fois la tâche effectuée.
10. Dans l'écran Tâches effectuées, cliquez sur Terminer.
Etape suivante
Vous pouvez également configurer les produits LiveCycle pour accéder à LDAP. Reportez-vous à la section
« Configuration des produits LiveCycle pour accéder à LDAP », page 69
.
Si vous utilisez LiveCycle Workflow, vous pouvez à présent installer LiveCycle Workflow Designer.
Reportez-vous à la section
« Installation de LiveCycle Workflow Designer », page 98 .
10
Configuration des produits LiveCycle pour accéder
à LDAP
Ce chapitre décrit la configuration des produits LiveCycle avec LDAP ou LDAP via SSL (LDAPS).
O
« Configuration des produits LiveCycle avec LDAP », page 69
O
« Configuration des produits LiveCycle avec LDAPS », page 70
Attention :
si vous installez et déployez plusieurs produits LiveCycle, vous devez consulter le guide
Installation et configuration approprié pour obtenir les paramètres SSL et de sécurité spécifiques à chaque produit LiveCycle installé.
Configuration des produits LiveCycle avec LDAP
Appliquez la procédure suivante lors de la configuration de User Management pour la prise en charge de l'authentification via LDAP.
³
Pour configurer User Management avec LDAP :
1. Ouvrez un navigateur Web, accédez au site http://
[nomhôte]:[port]
/adminui
et connectez-vous.
Reportez-vous à la section « Accès à Administrator », page 26 .
2. Sélectionnez Paramètres > User Management > Gestion des domaines et cliquez sur Nouveau
domaine.
3. Dans le champ ID, saisissez un identifiant de domaine unique.
4. Entrez le nom du domaine dans la zone Nom.
5. Cliquez sur Ajouter une authentification, puis sélectionnez LDAP dans la liste Fournisseur d'authentification.
Remarque :
il est déconseillé d'utiliser JAAS avec User Management dans LiveCycle 7.2.
6. Cliquez sur OK.
7. Cliquez sur Ajouter un annuaire.
8. Sous Remplir la page avec, sélectionnez une option de configuration d'annuaire comme Valeurs Sun
ONE par défaut.
9. Renseignez au besoin les zones Serveur, Port, SSL et Liaison. Pour plus de détails sur les paramètres, consultez la rubrique sur les options d'annuaire dans l'aide en ligne.
10. Configurez les Options utilisateur et les Options du groupe requises. Pour plus de détails sur les paramètres, consultez la rubrique sur les options d'annuaire dans l'aide en ligne.
11. (Facultatif ) Testez la configuration :
O
Cliquez sur Test.
O
Dans le champ Rechercher du volet Tester l'annuaire, saisissez un nom d'objet, puis dans le champ
avec, sélectionnez le type d'objet, comme ID de connexion.
69
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Configuration des produits LiveCycle pour accéder à LDAP
Configuration des produits LiveCycle avec LDAPS 70
O
Cliquez sur Test. Si le résultat est positif, les détails de votre objet s'affichent. Cliquez ensuite sur
Précédent.
12. Cliquez sur OK pour fermer la page Ajouter un annuaire, puis de nouveau sur OK pour quitter.
Configuration des produits LiveCycle avec LDAPS
Appliquez la procédure suivante lors de la configuration de User Management pour la prise en charge de l'authentification via LDAPS.
³
Pour configurer User Management avec LDAPS :
1. Activez SSL sur le serveur d'annuaire. Pour plus d'informations, consultez la documentation fournie avec l'annuaire.
2. Exportez un certificat client depuis le serveur d'annuaire.
3. Utilisez le programme keytool pour importer le fichier du certificat client dans le magasin de certificats de la JVM par défaut. La procédure peut varier selon la version de JMV installée et les chemins d'installation du client. Par exemple, si vous utilisez JDK 1.4.2, tapez le code suivant lorsque l'invite s'affiche : keytool -import -file client_certificate -alias myalias -keystore jdk142_08/jre/lib/security/cacerts
Spécifiez votre mot de passe (pour Java, le mot de passe par défaut est « changeit
») lorsqu'il vous est demandé. Une fois le certificat importé, un message vous est envoyé confirmant la réussite de l'opération.
4. Activez SSL dans User Management. Pour accéder aux paramètres de User Management, sélectionnez
Paramètres > User Management dans les pages d'Administrator. Lorsque vous configurez les options d'annuaire, sélectionnez Oui pour la propriété SSL et modifiez la propriété Port en conséquence.
Le numéro de port par défaut est 636.
Dépannage
Si vous rencontrez un problème lors de l'utilisation du protocole SSL, utilisez un navigateur LDAP pour vérifier si le système LDAP est accessible lorsque vous utilisez le protocole SSL. Si le navigateur LDAP ne peut pas accéder au système LDAP, le problème concerne la configuration de votre certificat et du serveur d'applications. Si le navigateur LDAP peut accéder au système LDAP, cela signifie que User Management n'est pas configuré correctement.
Partie III : Configuration après le déploiement
Cette section du guide décrit les opérations de configuration complémentaires nécessaires après le déploiement des produits LiveCycle sur le serveur d'applications et l'initialisation de la base de données
LiveCycle.
71
11
Configuration de SSL sur JBoss
Ce chapitre décrit la procédure de création d'informations d'identification et de configuration SSL sur le serveur d'applications afin d'accroître la sécurité de la communication avec le serveur d'applications.
Les informations contenues dans ce chapitre s'appliquent aux méthodes d'installation clé en main et manuelle.
Remarque :
il est conseillé de terminer la procédure d'installation, de configuration et de déploiement des produits LiveCycle et de vérifier qu'ils s'exécutent correctement avant de configurer SSL sur le serveur d'applications.
Il est important de vérifier que les paramètres de sécurité configurés sur le serveur d'applications et dans le fichier LiveCycle.ear sont homogènes.
Attention :
si vous installez et déployez plusieurs produits LiveCycle, vous devez consulter le guide
Installation et configuration approprié pour obtenir les paramètres SSL et de sécurité spécifiques à chaque produit LiveCycle installé.
Si vous n'avez pas encore activé le protocole SSL sur le module Data Manager (assemblé en tant que partie du fichier LiveCycle.ear), exécutez Configuration Manager pour reconfigurer et réassembler les produits en activant
SSL, puis redéployez le fichier LiveCycle.ear. Le mot de passe SSL que vous spécifiez dans Configuration Manager doit correspondre à celui que vous saisissez lors de la configuration de SSL sur le serveur d'applications.
Reportez-vous à la section « Configuration des produits LiveCycle à déployer », page 49
.
Pour configurer SSL sur le serveur d'applications, vous devez effectuer les tâches suivantes :
O
« Création d'informations d'identification SSL », page 72
O
« Configuration de SSL sur JBoss », page 74
Création d'informations d'identification SSL
Pour configurer SSL sur JBoss, vous avez besoin d'informations d'identification SSL à des fins d'authentification. Vous pouvez utiliser l'outil IBM de gestion des clés installé avec l'outil de génération de clés Java pour exécuter les tâches suivantes dans le but de créer des informations d'identification :
O
O
O
Créez une paire de clés publique/privée.
Conservez la clé publique dans un certificat X.509 v1 auto-signé enregistré en tant que chaîne de certificats à un seul élément.
Enregistrez la chaîne de certificats et la clé privée dans un nouveau fichier de stockage des clés.
La commande keytool se situe généralement dans le répertoire Java jre/bin. Utilisez la commande keytool
-genkey pour lancer l'outil de génération des clés et créer une paire de clés. La commande keytool doit comprendre plusieurs options et valeurs d'option, répertoriées dans le tableau suivant. La commande keytool se situe généralement dans le répertoire Java jre/bin et doit comprendre plusieurs options et valeurs d'option, répertoriées dans le tableau suivant.
72
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Configuration de SSL sur JBoss
Création d'informations d'identification SSL 73
Option de génération des clés
-alias
-keyalg
-keystore
-validity
-storepass
Description
Alias du fichier de stockage des clés.
Valeur de l'option
ads-credentials
Algorithme utilisé pour générer la paire de clés.
RSA
Vous pouvez utiliser un autre algorithme, en fonction de la stratégie de votre entreprise.
L'emplacement et le nom du fichier de stockage de clés.
[racine du serveur
d'applications]/server/all/svcnative/ads-ssl.jks
L'emplacement peut comprendre le chemin d'accès absolu au fichier ou dépendre du répertoire courant de l'invite de commande dans laquelle la commande keytool a été saisie.
Nombre de jours pendant lesquels le certificat est considéré comme valide.
Mot de passe protégeant le contenu du fichier de stockage de clés.
3650
Vous pouvez utiliser une autre valeur, en fonction de la stratégie de votre entreprise.
Le mot de passe du fichier de stockage de clés doit correspondre au mot de passe d'identification SSL spécifié pour le module Data Manager à l'aide de
Configuration Manager.
-keypass
-dname
Mot de passe protégeant la clé privée de la paire de clés.
Appliquez le mot de passe utilisé pour l'option
-storepass
. Le mot de passe de clé doit comprendre au moins 6 caractères.
Nom identifiant la personne possédant le fichier de stockage de clés.
"CN=[User name],OU=[Group Name],
O=[Company Name], L=[City Name],
S=[State or province], C=[Country
Code]"
O
[User name]
correspond à l'identifiant de l'utilisateur possédant le fichier de stockage de clés.
O
O
O
O
O
[Group Name]
correspond au groupe de l'entreprise auquel le propriétaire du fichier de stockage de clés appartient.
[Company Name]
correspond au nom de l'entreprise.
[City Name]
correspond à la ville dans laquelle votre entreprise est implantée.
[State or province]
correspond à la région dans laquelle votre entreprise est implantée.
[Country Code]
correspond au code à deux chiffres propre au pays dans lequel votre entreprise est implantée.
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Configuration de SSL sur JBoss
Configuration de SSL sur JBoss 74
Vous pouvez exécuter le fichier de stockage de clés au moyen d'une seule commande qui comprend toutes les informations requises pour créer un tel fichier. Pour plus de détails sur l'utilisation de la commande keytool, consultez le fichier keytool.html inclus dans votre documentation JDK.
³
Pour créer des informations d'identification SSL :
1. Ouvrez une invite de commande et recherchez [racine du serveur d'applications]/server all/svcnative.
2. Entrez la commande suivante :
[JAVA_HOME]
/bin/keytool -genkey -v -alias ads-credentials -keyalg RSA
-keystore "ads-ssl.jks" -validity 3650 -storepass store_password
-keypass key_password -dname "CN=User ID, OU=Group Name, O=Company Name,
L=City Name, S=State, C=Country Code"
Remarque :
vous devez remplacer
[JAVA_HOME]
par le répertoire dans lequel JDK est installé, puis remplacer le texte en gras par les valeurs correspondant à votre environnement.
Le fichier de stockage de clés est créé dans le répertoire [racine du serveur
d'applications]/server/all/svcnative.
Configuration de SSL sur JBoss
Vous pouvez activer SSL sur le serveur d'applications en modifiant les fichiers indiqués dans cette section.
Une fois le protocole SSL configuré, vous devez démarrer manuellement JBoss.
³
Pour configurer SSL sur JBoss :
1. Dans un éditeur de texte, ouvrez le fichier jacorb.properties situé dans le répertoire [racine du serveur
d'applications]/server/all/conf, puis modifiez la configuration SSL afin qu'elle contienne le texte suivant :
#########################
### SSL Configuration ###
#########################
# the qualified classname of the ssl socket factory class jacorb.ssl.socket_factory=org.jacorb.security.ssl.sun_jsse.SSLSocket
Factory
# the qualified classname of the ssl server socket factory class jacorb.ssl.server_socket_factory=org.jacorb.security.ssl.sun_jsse.
SSLServerSocketFactory
# The name and location of the keystore. This should be absolute
# to the directory where this property file resides.
#jacorb.security.keystore=c:/jboss-3.2.5/server/all/svcnative/ ads-ssl.jks
jacorb.security.keystore=<--remplacer par le chemin complet d'ads-ssl.jks--> jacorb.security.keystore_password=votre mot de passe SSL
# trusted ca certs are also in the same keystore jacorb.security.jsse.trustees_from_ks=on jacorb.security.support_ssl=on
#client side ssl supported or enforced?
jacorb.security.ssl.client.supported_options=60 jacorb.security.ssl.client.required_options=0
#client side ssl supported or enforced?
jacorb.security.ssl.server.supported_options=60 jacorb.security.ssl.server.required_options=60
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Configuration de SSL sur JBoss
Configuration de SSL sur JBoss 75
2. Enregistrez le fichier jacorb.properties.
3. Dans un éditeur de texte, ouvrez le fichier server.xml dans le répertoire [racine du serveur
d'applications]/server/all/deploy/jbossweb-tomcat50.sar, puis annulez la mise en commentaire de la section suivante :
<!-- SSL/TLS Connector configuration using the SSL domain keystore
<Connector port="8080" address="${jboss.bind.address}" maxThreads="100" minSpareThreads="5" maxSpareThreads="15" scheme="https" secure="true" clientAuth="false" keystoreFile="${jboss.server.home.dir}/conf/chap8.keystore" keystorePass="rmi+ssl" sslProtocol = "TLS" />
-->
4. Remplacez la valeur de l'attribut keystoreFile
par
"${jboss.server.home.dir}/svcnative/ads-ssl.jks"
, qui représente l'emplacement du fichier de stockage de clés.
5. Remplacez la valeur de l'attribut keystorePass
par le mot de passe du fichier de stockage de clés spécifié lors de la création du fichier de stockage de clés.
6. Enregistrez le fichier server.xml.
7. Dans un éditeur de texte, ouvrez le fichier iiop-service.xml du répertoire [racine du serveur
d'applications]/server/all/deploy, puis annulez la mise en commentaire du texte suivant :
<!-- (uncomment to use IIOP over SSL)
<mbean code="org.jboss.security.plugins.JaasSecurityDomain"
name="jboss.security:service=JaasSecurityDomain,domain=IIOP+SSL">
<constructor>
<arg type="java.lang.String" value="IIOP+SSL"/>
</constructor>
<attribute name="KeyStoreURL">iiop-over-ssl.keystore</attribute>
<attribute name="KeyStorePass">iiop-over-ssl</attribute>
</mbean>
-->
8. Définissez les valeurs des attributs
KeyStoreURL
et
KeyStorePass
pour les adapter à votre configuration :
<attribute name="KeyStoreURL">
[racine du serveur d'applications]/server/all/svcnative/ads-ssl.jks
</attribute>
<attribute name="KeyStorePass">
Mot de passe du fichier de stockage de clés
</attribute>
9. Dans la section
CORBA ORB service
, annulez la mise en commentaire du texte suivant :
<!-- (uncomment to use IIOP over SSL)
<attribute name="SecurityDomain">java:/jaas/IIOP+SSL</attribute>
<depends>jboss.security:serivce=JaasSecurityDomain,domain=IIOP+SSL
</depends>
</mbean>
-->
10. Enregistrez le fichier iiop-service.xml.
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Configuration de SSL sur JBoss
Configuration de SSL sur JBoss 76
11. Redémarrez le serveur d'applications.
12. Pour accéder à Administrator au moyen de SSL, entrez l'adresse suivante dans un navigateur Web : https://
[nomhôte]:[port]
/adminui
Le port par défaut pour JBoss est 8443.
,
Etape suivante
Si vous installez LiveCycle Workflow Business Activity Monitor, vous pouvez maintenant configurer un serveur d'applications pour héberger BAM Server. (Reportez-vous à la section
JBoss pour BAM Server », page 77
.) Vous pouvez également installer LiveCycle Workflow Designer.
Reportez-vous à la section
« Installation de LiveCycle Workflow Designer », page 98 .
12
Configuration manuelle de JBoss pour BAM Server
Ce chapitre s'applique aux licences LiveCycle Workflow permettant d'utiliser Business Activity Monitor
uniquement.
Il explique comment créer la base de métadonnées LiveCycle Workflow Business Activity Monitor et configurer le serveur d'applications JBoss pour BAM Server, un composant de LiveCycle Workflow.
Si vous installez les produits à l'aide de la méthode clé en main, JBoss et MySQL sont automatiquement installés et configurés et il n'est pas nécessaire d'effectuer les procédures de ce chapitre.
Dans ce chapitre, le répertoire racine de l'instance de JBoss que vous configurez pour BAM Server est appelé [racine bam jboss]. Reportez-vous à la section
« Conventions utilisées dans ce guide », page 8
.
Ce chapitre suppose que vous avez installé la base de données LiveCycle. Si ce n'est pas le cas, reportez-vous au point
« Préparation de l'environnement », page 42
.
Installation du serveur d'applications JBoss
Si vous configurez manuellement JBoss pour exécuter BAM Server, vous devez télécharger JBoss
Application Server 3.2.6 et l'installer. Vous pouvez télécharger JBoss à l'adresse suivante : http://labs.jboss.com/portal/jbossas/download
Création de la base de métadonnées BAM
Vous devez créer une base de métadonnées LiveCycle pour enregistrer les définitions des métriques de processus que BAM Server surveille, ainsi que les détails relatifs aux alertes et aux données d'exécution d'objet enregistrées sur le disque.
Les métadonnées BAM pouvant représenter un volume important, vous devez attribuer au moins 50 Mo à la base de métadonnées BAM. Pour les déploiements de production, allouez au moins 200 Mo.
BAM Server peut nécessiter des paramètres spécifiques pour certains aspects de la configuration de la base de métadonnées BAM. Les paramètres dépendent du type de serveur d'applications hébergeant
BAM Server et du type de serveur de base de données utilisé pour enregistrer les métadonnées BAM.
Comptes utilisateur
Vous devez également créer un compte utilisateur utilisable par BAM Server pour se connecter à la base de métadonnées BAM. Ce compte doit disposer de droits d'accès en création, en modification et en mise à jour sur la base de données.
Sous Oracle, le compte utilisateur de la base de données doit être associé à un espace de stockage créé spécifiquement pour les métadonnées BAM.
77
Adobe LiveCycle
Installing and Configuring LiveCycle pour JBoss
Configuration manuelle de JBoss pour BAM Server
Configuration de JBoss pour BAM Server 78
Configuration de JBoss pour BAM Server
Si vous installez LiveCycle Workflow et le déployez manuellement sur JBoss, vous devez installer et configurer manuellement JBoss afin que BAM Server s'exécute correctement.
BAM Server doit être déployé sur une autre instance de JBoss que celle sur laquelle
LiveCycle Workflow Server est déployée. Vous devez configurer les zones suivantes sur l'instance de JBoss exécutant BAM Server :
O
Installez les pilotes de base de données dont JBoss a besoin pour communiquer avec la base de métadonnées Business Activity Monitor et la base de données LiveCycle. Reportez-vous à la section
« Installation des pilotes de base de données sur JBoss pour BAM Server », page 78
.
O
O
O
O
O
O
Créez un fichier de source de données pour permettre à BAM Server de se connecter à la base de métadonnées Business Activity Monitor. Reportez-vous à la section
« Connexion de JBoss à la base de métadonnées BAM », page 78 .
Créez un fichier de source de données pour permettre à BAM Server de se connecter à la base de
Configurez la machine virtuelle Java (JVM) exécutant le serveur d'applications JBoss (reportez-vous à la
section « Configuration des options JVM de JBoss requises », page 83 .)
.
Configurez JBoss afin que les événements Business Activity Monitor ne soient pas dupliqués dans les
.
Changez les ports JBoss pour éviter les conflits avec les autres applications en cours d'exécution sur le même ordinateur. Reportez-vous à la section
« Personnalisation des numéros de port », page 86 .
Installation des pilotes de base de données sur JBoss pour BAM Server
Pour permettre à BAM Server de se connecter à la base de métadonnées Business Activity Monitor et à la base de données LiveCycle, vous devez installer les pilotes des types de bases de données que vous utilisez.
³
Pour installer le pilote JDBC pour SQL Server :
O
Copiez les fichiers de pilote de base de données de SQL Server 2000 (msbase.jar, mssqlserver.jar et msutil.jar) dans le répertoire [racine bam jboss]/server/default/lib.
Remarque :
LiveCycle et BAM Server sont exécutés dans des arborescences complètement différentes de JBoss, ce qui signifie que les pilotes doivent être présents dans chaque arborescence.
En conséquence, il vous faut réinstaller ces pilotes pour BAM Server. Reportez-vous à la section
« Pour télécharger le pilote JDBC pour SQL Server et le copier : », page 62 .
Connexion de JBoss à la base de métadonnées BAM
Vous devez configurer une connexion à la base de métadonnées Business Activity Monitor sur l'instance de JBoss exécutant BAM Server de manière à ce qu'il récupère des informations sur les métriques de processus qu'il surveille.
Adobe LiveCycle
Installing and Configuring LiveCycle pour JBoss
Configuration manuelle de JBoss pour BAM Server
Connexion de JBoss à la base de métadonnées BAM 79
La procédure de configuration de la connexion que vous utilisez dépend du type de base de données utilisé pour stocker les métadonnées Business Activity Monitor :
O
« Connexion à la base de métadonnées BAM sur SQL Server », page 79
Connexion à la base de métadonnées BAM sur SQL Server
Pour permettre à BAM Server de se connecter à la base de données SQL Server stockant les métadonnées Business Activity Monitor, vous devez créer un fichier de source de données et le déployer sur les instances de JBoss exécutant BAM Server. Vous devez également modifier les mappages des types de données par défaut sur JBoss.
³
Pour créer une source de données pour la base de métadonnées Business Activity Monitor sur
SQL Server :
1. Ouvrez un éditeur de texte et créez un nouveau fichier texte à l'aide du code suivant :
<?xml version="1.0" encoding="UTF-8"?>
<datasources>
<no-tx-datasource>
<jndi-name>com.celequest.metadata.metaDatasource</jndi-name>
<connection-url><!--Insert jdbcURL --></connection-url>
<driver-class>com.microsoft.jdbc.sqlserver.SQLServerDriver</driver-class>
<min-pool-size>5</min-pool-size>
<max-pool-size>20</max-pool-size>
<idle-timeout-minutes>5</idle-timeout-minutes>
<track-statements>false</track-statements>
<application-managed-security/>
</no-tx-datasource>
</datasources>
2. Remplacez
<!--Insert jdbcURL -->
à l'intérieur de l'élément connection-url
par le texte suivant :
O
O
O
O
O jdbc:microsoft:sqlserver://[nomhôte]:[port];SelectMethod=cursor; databaseName=[nombd];user=[nom_utilisateur];password=[motdepassebd]
[nom hôte]
correspond au nom de l'ordinateur sur lequel SQL Server 2000 est en cours d'exécution.
[port]
correspond au port utilisé pour accéder à la base de données. Le port par défaut de SQL
Server 2000 est le port 1433.
[nombd]
correspond au nom de la base de métadonnées BAM.
[nom_utilisateur]
correspond au nom du compte utilisateur de la base de données pouvant accéder à la base de métadonnées BAM.
[motdepassebd]
correspond au mot de passe de l'utilisateur
[nom_utilisateur]
.
3. Enregistrez le fichier sous celequest_metadata-ds.xml dans le répertoire [racine bam
jboss]/server/default/deploy.
³
Pour modifier les mappages des types de données par défaut sur SQL Server :
1. Recherchez le répertoire [racine bam jboss]/server/default/conf et ouvrez le fichier standardjbosscmp-jdbc.xml dans un éditeur de texte.
Adobe LiveCycle
Installing and Configuring LiveCycle pour JBoss
Configuration manuelle de JBoss pour BAM Server
Connexion de JBoss pour BAM Server à la base de données LiveCycle 80
2. Dans la section
<defaults>
qui se trouve vers le haut du fichier, modifiez le paramètre indiqué en gras ci-dessous :
<datasource>java:/com.celequest.metadata.metaDatasource</datasource>
<datasource-mapping>MS SQLSERVER2000</datasource-mapping>
<create-table>false</create-table>
...
<list-cache-max>10000</list-cache-max>
3. Recherchez l'élément type-mappings
possédant un élément enfant name
contenant le texte
MS SQLSERVER2000
, puis insérez le code suivant sous l'élément function-mapping
final :
<mapping>
<java-type>com.celequest.metadata.ejb.BigString</java-type>
<jdbc-type>VARBINARY</jdbc-type>
<sql-type>IMAGE</sql-type>
</mapping>
<mapping>
<java-type>com.celequest.jar.Jar</java-type>
<jdbc-type>VARBINARY</jdbc-type>
<sql-type>IMAGE</sql-type>
</mapping>
<mapping>
<java-type>com.celequest.alert.AlertFiring</java-type>
<jdbc-type>VARBINARY</jdbc-type>
<sql-type>IMAGE</sql-type>
</mapping>
<mapping>
<java-type>com.celequest.alert.AlertAck</java-type>
<jdbc-type>VARBINARY</jdbc-type>
<sql-type>IMAGE</sql-type>
</mapping>
<mapping>
<java-type>com.celequest.alert.AlertInstance</java-type>
<jdbc-type>VARBINARY</jdbc-type>
<sql-type>IMAGE</sql-type>
</mapping>
<mapping>
<java-type>com.celequest.util.misc.SerializableWrapper</java-type>
<jdbc-type>VARBINARY</jdbc-type>
<sql-type>IMAGE</sql-type>
</mapping>
4. Enregistrez le fichier, puis fermez-le.
5. Redémarrez JBoss.
Connexion de JBoss pour BAM Server à la base de données LiveCycle
Vous devez configurer une connexion à la base de données LiveCycle sur l'instance de JBoss exécutant
BAM Server de manière à ce qu'il récupère des informations sur les données d'exécution du processus.
La procédure de configuration de la connexion que vous utilisez dépend du type de base de données utilisé pour enregistrer les données LiveCycle :
O
O
« Connexion à la base de données LiveCycle sur SQL Server », page 81
« Connexion à la base de données LiveCycle sur MySQL », page 81
Adobe LiveCycle
Installing and Configuring LiveCycle pour JBoss
Configuration manuelle de JBoss pour BAM Server
Connexion de JBoss pour BAM Server à la base de données LiveCycle 81
Connexion à la base de données LiveCycle sur SQL Server
Pour permettre à BAM Server de se connecter à la base de données LiveCycle, vous devez créer un fichier de source de données et le déployer sur l'instance de JBoss exécutant BAM Server.
³
Pour créer une source de données pour la base de données LiveCycle sur SQL Server 2000 :
1. Ouvrez un éditeur de texte et créez un nouveau fichier texte à l'aide du code suivant :
<?xml version="1.0" encoding="UTF-8"?>
<datasources>
<no-tx-datasource>
<jndi-name>com.celequest.adobe</jndi-name>
<connection-url><!--Insert jdbcURL --></connection-url>
<driver-class>com.microsoft.jdbc.sqlserver.SQLServerDriver
</driver-class>
<!-- The login and password -->
<user-name><!--Insert dbUsername --></user-name>
<password><!--Insert dbPassword --></password>
<min-pool-size>5</min-pool-size>
<max-pool-size>20</max-pool-size>
<idle-timeout-minutes>5</idle-timeout-minutes>
<track-statements>false</track-statements>
<application-managed-security/>
</no-tx-datasource>
</datasources>
2. Remplacez
<!--Insert jdbcURL -->
dans l'élément connection-url
par le texte suivant : jdbc:microsoft:sqlserver://[nomhôte]:[port];SelectMethod=cursor; databaseName=[nombd];user=[utilisateurbd];password=[motdepassebd]
O
[nom hôte]
correspond au nom de l'ordinateur sur lequel SQL Server 2000 est en cours d'exécution.
O
O
O
O
[port]
correspond au port utilisé pour accéder à la base de données LiveCycle. Le port par défaut de SQL Server 2000 est le port 1433.
[nombd]
correspond au nom de la base de données LiveCycle.
[utilisateurbd]
correspond au nom du compte utilisateur de la base de données pouvant accéder à la base de données LiveCycle.
[motdepassebd]
correspond au mot de passe de l'utilisateur
[utilisateurbd]
.
3. Remplacez
<!--Insert dbUsername -->
dans l'élément
<user-name>
par le nom du compte utilisateur de la base de données pouvant accéder à la base de données LiveCycle.
4. Remplacez
<!--Insert dbPassword -->
dans l'élément
<password>
par le mot de passe du nom d'utilisateur spécifié dans l'élément
<user-name>
.
5. Enregistrez le fichier sous adobe-ds.xml dans le répertoire [racine bam jboss]/server/default/deploy/.
Connexion à la base de données LiveCycle sur MySQL
Pour permettre à BAM Server de se connecter à la base de données LiveCycle, vous devez créer un fichier de source de données et le déployer sur l'instance de JBoss exécutant BAM Server.
Adobe LiveCycle
Installing and Configuring LiveCycle pour JBoss
Configuration manuelle de JBoss pour BAM Server
Connexion de JBoss pour BAM Server à la base de données LiveCycle 82
³
Pour installer le pilote JDBC pour MySQL :
1. Téléchargez le fichier mysql-connector-java-3.0.15-ga-bin-jar depuis le site Web de MySQL : http://www.mysql.com/products/connector/j/
2. Copiez le fichier dans le répertoire [racine bam jboss]/server/default/lib.
³
Pour créer une source de données pour la base de données LiveCycle sur MySQL :
1. Ouvrez un éditeur de texte et créez un nouveau fichier texte à l'aide du code suivant :
<?xml version="1.0" encoding="UTF-8"?>
<datasources>
<no-tx-datasource>
<jndi-name>com.celequest.adobe</jndi-name>
<connection-url><![CDATA[<!--Insert jdbcURL -->]]>
</connection-url>
<driver-class>com.mysql.jdbc.Driver</driver-class>
<!-- The login and password -->
<user-name><!--Insert dbUsername --></user-name>
<password><!--Insert dbPassword --></password>
<min-pool-size>5</min-pool-size>
<max-pool-size>20</max-pool-size>
<idle-timeout-minutes>5</idle-timeout-minutes>
<track-statements>false</track-statements>
<application-managed-security/>
</no-tx-datasource>
</datasources>
2. Remplacez
<!--Insert jdbcURL -->
dans l'élément connection-url
par le texte suivant :
O
O
O
O jdbc:mysql://[nom_hôte]/[nom_bd]?user=[nom_utilisateur_bd]&password=
[motdepassebd]&autoReconnect=true&autoReconnectForPools=true
[nom_hôte]
correspond au nom de l'ordinateur sur lequel MySQL est en cours d'exécution.
[nom_bd]
correspond au nom de la base de données LiveCycle.
[nom_utilisateur_bd]
correspond au nom du compte utilisateur de la base de données pouvant accéder à la base de données LiveCycle.
[motdepassebd]
correspond au mot de passe de l'utilisateur
[nom_utilisateur_bd]
.
3. Remplacez
<!--Insert dbUsername -->
dans l'élément user-name
par le nom du compte utilisateur de la base de données pouvant accéder à la base de données LiveCycle.
4. Remplacez
<!--Insert dbPassword -->
dans l'élément password
par le mot de passe du nom d'utilisateur spécifié dans l'élément
<user-name>
.
5. Enregistrez le fichier sous adobe-ds.xml dans le répertoire [racine bam jboss]/server/default/deploy.
Adobe LiveCycle
Installing and Configuring LiveCycle pour JBoss
Configuration manuelle de JBoss pour BAM Server
Configuration des options JVM de JBoss requises 83
Configuration des options JVM de JBoss requises
Vous devez configurer la machine virtuelle Java (JVM) pour prendre en charge BAM Server.
³
Pour configurer les options JVM de JBoss :
1. Accédez au répertoire [racine bam jboss]/bin et ouvrez le fichier de script de démarrage dans un éditeur de texte :
O
O
(Windows) run.bat
(Linux) run.sh
2. Remplacez les paramètres de mémoire
JAVA_OPTS
par 128 M minimum et 768 M maximum, puis ajoutez -server pour optimiser les performances :
O
O
(Windows) set JAVA_OPTS=%JAVA_OPTS% -server -Xms128m -Xmx768m
(Linux) JAVA_OPTS="$JAVA_OPTS -server -Xms128m -Xmx768m"
Dans le cadre de charges de données importantes, augmentez la mémoire maximale à -
Xmax1536m
(1,5 Go).
3. Ajoutez un paramètre
JAVA_OPTS
pour désactiver la double consignation de la sortie système. Voici la solution au bogue 877974 dans JBoss :
O
Windows : définissez JAVA_OPTS=%JAVA_OPTS%
-Dorg.jboss.logging.Log4jService.catchSystemOut=false
-Dorg.jboss.logging.Log4jService.catchSystemErr=false
O
Linux :
JAVA_OPTS="$JAVA_OPTS
-Dorg.jboss.logging.Log4jService.catchSystemOut=false
-Dorg.jboss.logging.Log4jService.catchSystemErr=false"
4. Ajoutez un paramètre
JAVA_OPTS
pour activer la prise en charge des caractères UTF-8 :
O
(Windows) set JAVA_OPTS=%JAVA_OPTS% -Dfile.encoding=utf8
O
(Linux) JAVA_OPTS="$JAVA_OPTS -Dfile.encoding=utf8”
5. Ajoutez un caractère JAVA_OPTS pour augmenter la taille de la pile de thread à 300 :
O
(Windows) set JAVA_OPTS=%JAVA_OPTS% -XX:ThreadStackSize=300
O
(Linux) JAVA_OPTS="$JAVA_OPTS -XX:ThreadStackSize=300”
6. (Facultatif ) Ajoutez un paramètre JAVA_OPTS pour intégrer les options facultatives de JVM :
O
(Windows) set JAVA_OPTS=%JAVA_OPTS% [options JVM]
O
(Linux)
JAVA_OPTS="$JAVA_OPTS [options JVM]
[options JVM]
correspond aux options à inclure au format
-Dcom.celequest.property.[PARAMETRE]=[VALEUR]
7. Enregistrez le fichier du script de démarrage et fermez-le.
Adobe LiveCycle
Installing and Configuring LiveCycle pour JBoss
Configuration manuelle de JBoss pour BAM Server
Options facultatives de JVM pour JBoss 84
Options facultatives de JVM pour JBoss
Vous pouvez configurer plusieurs paramètres JVM facultatifs associés à la base de métadonnées Business
Activity Monitor, notamment la langue, le pays et le niveau d'assemblage. Ces paramètres JVM sont exprimés par des commandes au format suivant :
-Dcom.celequest.property.[PARAMETRE]=[VALEUR]
Ce tableau fournit les valeurs valides de
[PARAMETRE]
et
[VALEUR]
.
Paramètre Description
LANGUAGE
Code ISO pour la langue du serveur.
Par exemple, dans la commande suivante, le paramètre LANGUAGE est défini sur le portugais :
-Dcom.celequest.property.LANGUAGE=PT
COUNTRY
LOCALESORT
STRENGTH
DECOMPOSITION
Code ISO pour le pays du serveur.
Cette option permet d'indiquer si les chaînes sensibles aux paramètres locaux ont
été comparées. Les valeurs valides sont true
et false
:
O
Indiquez true
si vous souhaitez comparer les chaînes sensibles aux paramètres locaux.
O
Indiquez false
si vous ne souhaitez pas comparer les chaînes sensibles aux paramètres locaux.
La valeur par défaut est false
.
Niveau de force d'assemblage correspondant au degré selon lequel les caractères non anglais sont comparés et assemblés.
Les valeurs valides (de la moins sélective à la plus sélective) sont les suivantes : primary
, secondary
, tertiary
et identical
. La valeur par défaut est tertiary
.
Pour plus d'informations sur les paramètres d'assemblage, consultez la documentation de Sun Java à l'adresse suivante : http://java.sun.com/j2se/1.4.2/docs/api/java/util/Locale.html
.
Remarque :
ce paramètre n'est opérationnel que si
LOCALESORT
est défini sur true
.
Mode de décomposition de l'assemblage. Les valeurs valides sont none
, canonical
et full
. La valeur par défaut est canonical
.
Pour plus d'informations sur les paramètres d'assemblage, consultez la documentation de Sun Java à l'adresse suivante : http://java.sun.com/j2se/1.4,2/docs/api/java/util/Locale.html
Remarque :
ce paramètre n'est opérationnel que si
LOCALESORT
est défini sur true
.
Pour configurer plusieurs propriétés, séparez chaque commande par un espace. Par exemple, les commandes suivantes définissent la langue sur le portugais et le paramètre local sur Brésil :
-Dcom.celequest.property.LANGUAGE=PT -Dcom.celequest.property.LOCALE=BR
Adobe LiveCycle
Installing and Configuring LiveCycle pour JBoss
Configuration manuelle de JBoss pour BAM Server
Modification de la configuration des threads de JBoss 85
Modification de la configuration des threads de JBoss
Avant de déployer BAM Server sur JBoss, vous devez modifier la configuration des threads dans le fichier server.xml de JBoss.
³
Pour modifier la configuration des threads :
1. Recherchez le répertoire [racine bam jboss]/server/default/deploy/jbossweb-tomcat50.sar et ouvrez le fichier server.xml.
2. Recherchez l'en-tête
<!-- A HTTP/1.1 Connector on port 8080 -->
.
Remarque :
la valeur de port peut être 9080 si vous exécutez l'installation clé en main et que vous modifiez les threads de JBoss.
3. Modifiez les valeurs de port HTTP dans l'élément
Connector
afin qu'elles correspondent au texte en gras du code XML suivant :
<!-- A HTTP/1.1 Connector on port 9080 -->
<Connector port="9080" address="${jboss.bind.address}"
maxThreads="400"
minSpareThreads="100" maxSpareThreads="75" enableLookups="false" redirectPort="8443" acceptCount="100" connectionTimeout="20000" disableUploadTimeout="true"/>
4. (Facultatif ) Ajoutez les attributs compression
et socketBuffer
au même élément
Connector pour optimiser les performances globales de Business Activity Monitor, comme illustré par le texte en gras de l'exemple suivant :
<!-- A HTTP/1.1 Connector on port 9080 -->
<Connector port="9080" address="${jboss.bind.address}" maxThreads="400" minSpareThreads="100" maxSpareThreads="75" enableLookups="false" redirectPort="8443" acceptCount="100" connectionTimeout="20000" disableUploadTimeout="true"
compression="on" socketBuffer="1045576"
/>
5. Enregistrez le fichier server.xml, puis fermez-le.
6. Redémarrez JBoss.
Configuration de la consignation sur JBoss
Il est possible d'enregistrer les messages envoyés aux journaux de Business Activity Monitor dans le fichier server.log de JBoss. Par défaut, JBoss consigne tous les messages publiés par BAM Server en plus de ses propres messages et de ceux des applications qu'il héberge. Vous pouvez modifier le fichier log4j.xml de
JBoss afin d'empêcher la consignation des messages de Business Activity Monitor dans le fichier journal de JBoss.
Attention :
n'exécutez pas cette procédure lorsque JBoss est en cours d'exécution, faute de quoi JBoss duplique les messages dans la console et le fichier journal.
Remarque :
par défaut, les serveurs Business Activity Monitor publient les messages de gravité des informations. Vous pouvez modifier les messages publiés au moyen de la console d'administration de Business Activity Monitor (BAM) Workbench.
Adobe LiveCycle
Installing and Configuring LiveCycle pour JBoss
Configuration manuelle de JBoss pour BAM Server
Personnalisation des numéros de port 86
³
Pour limiter l'enregistrement de messages Business Activity Monitor par JBoss :
1. Arrêtez JBoss.
2. Dans un éditeur de texte, ouvrez le fichier log4j.xml depuis le répertoire [racine bam
jboss]/default/conf/.
3. Recherchez le code XML suivant :
<root>
<appender-ref ref="CONSOLE"/>
<appender-ref ref="FILE"/>
</root>
4. Supprimez l'élément appender-ref
possédant l'attribut ref
de la valeur
FILE
. L'élément root
doit désormais apparaître comme le code XML suivant :
<root>
<appender-ref ref="CONSOLE"/>
</root>
5. Recherchez la section
Categories
du fichier, puis ajoutez l'élément category
suivant de sorte que
JBoss envoie tous les messages des catégories « org » à la console (comme les messages publiés par
JBoss) sans consigner les messages de la catégorie « com » (com.celequest, par exemple) dans le fichier de consignation :
<category name="org">
<appender-ref ref="FILE"/>
</category>
6. Enregistrez le fichier log4j.xml et redémarrez JBoss.
Personnalisation des numéros de port
Vous devez modifier les ports que JBoss utilise afin d'éviter les conflits avec les ports utilisés par d'autres applications sur l'ordinateur hôte, comme l'instance de JBoss exécutant LiveCycle Workflow Server.
³
Pour modifier les ports :
1. Recherchez le répertoire [racine bam jboss]/server/default/deploy/jbossweb-tomcat50.sar et ouvrez le fichier server.xml dans un éditeur de texte.
2. Modifiez les paramètres de port HTTP et de port de redirection se trouvant dans la section
HTTP/1.1
Connector
:
<!-- A HTTP/1.1 Connector on port 9080 -->
<Connector port="9080" address="${jboss.bind.address}" maxThreads="400" minSpareThreads="100" maxSpareThreads="75" enableLookups="false" redirectPort="18443" acceptCount="100" connectionTimeout="20000" disableUploadTimeout="true"/>
3. Modifiez les paramètres du port AJP et du port de redirection :
<!-- A AJP 1.3 Connector on port 18009 -->
<Connector port="18009" address="${jboss.bind.address}" enableLookups="false" redirectPort="18443" debug="0" protocol="AJP/1.3"/>
Adobe LiveCycle
Installing and Configuring LiveCycle pour JBoss
Configuration manuelle de JBoss pour BAM Server
Personnalisation des numéros de port 87
4. Modifiez la définition du port SSL/TSL :
<!-- SSL/TLS Connector configuration using the admin devl guide keystore
<Connector port="18443" address="${jboss.bind.address}" maxThreads="100" minSpareThreads="5" maxSpareThreads="15" scheme="https" secure="true" clientAuth="false" keystoreFile="${jboss.server.home.dir}/conf/chap8.keystore" keystorePass="rmi+ssl" sslProtocol = "TLS" />
-->
5. Enregistrez le fichier server.xml, puis fermez-le.
6. Recherchez le répertoire [racine bam jboss]/server/default/deploy/http-invoker.sar/META-INF et ouvrez le fichier jboss-service.xml dans un éditeur de texte.
7. Mettez à jour toutes les occurrences de l'attribut
InvokerURLSuffix
:
<attribute name="InvokerURLSuffix">:9080/invoker/...
8. Enregistrez le fichier jboss-service.xml, puis fermez-le.
9. Recherchez le répertoire [racine bam jboss]/server/default/conf et ouvrez le fichier jboss-service.xml.
10. Dans la section
Class Loading
, recherchez l'élément
<mbean code="org.jboss.web.WebService" name="jboss:service=WebService">
et définissez le port sur 18083 :
<attribute name="Port">18083</attribute>
11. Dans la section
JNDI
, recherchez l'élément
<mbean code="org.jboss.naming.NamingService" name="jboss:service=Naming" xmbeandd="resource:xmdesc/NamingService-xmbean.xml">
et définissez le port sur
11099
:
<attribute name="Port">11099</attribute>
12. Associez l'attribut RmiPort au numéro de port
11098
:
<attribute name="RmiPort">11098</attribute>
13. Dans la section
Invokers to the JMX node
, recherchez l'élément
<mbean code="org.jboss.invocation.pooled.server.PooledInvoker" name="jboss:service=invoker,type=pooled"> et associez l'attribut RMIObjectPort au numéro de port
14444
:
<attribute name="RMIObjectPort">14444</attribute>
14. Associez l'attribut
ServerBindPort
au numéro de port
14445
:
<attribute name="ServerBindPort">14445</attribute>
15. Enregistrez le fichier jboss-service.xml, puis fermez-le.
16. Recherchez le répertoire [racine bam jboss]/server/default/deploy/jms et ouvrez le fichier uil2-service.xml dans un éditeur de texte.
17. Dans l'
élément
<mbean code="org.jboss.mq.il.uil2.UILServerILService" name="jboss.mq:service=InvocationLayer,type=UIL2">
, associez l'attribut
ServerBindPort
au numéro de port
18093
:
<attribute name="ServerBindPort">18093</attribute>
Adobe LiveCycle
Installing and Configuring LiveCycle pour JBoss
18. Enregistrez le fichier uil2-service.xml, puis fermez-le.
Configuration manuelle de JBoss pour BAM Server
Déploiement de BAM Server 88
Déploiement de BAM Server
Vous déployez BAM Server sur JBoss en copiant le fichier CAS_Adobe.ear sur l'instance de JBoss configurée pour BAM Server et le fichier CQIntegration.ear sur l'instance de JBoss configurée pour LiveCycle Workflow
Server. JBoss peut être exécuté ou arrêté lorsque vous copiez les fichiers dans les répertoires. Une fois les fichiers copiés, démarrez ou redémarrez le serveur afin de vous assurer que les services démarrent correctement.
³
Pour déployer BAM Server sur Jboss :
1. Copiez le fichier CAS_Adobe.ear du répertoire [racine
LiveCycle]/configurationManager/working/bam/common dans le répertoire [racine bam
jboss]/server/default/deploy.
2. Redémarrez l'instance de JBoss que vous avez configurée pour BAM Server.
3. Copiez le fichier CQIntegration.ear du répertoire [racine
LiveCycle]/configurationManager/working/bam/common dans le répertoire [racine du serveur
d'applications]/server/all/deploy.
4. Redémarrez l'instance de JBoss que vous avez configurée pour LiveCycle Workflow Server.
Etape suivante
Vous devez à présent configurer les propriétés Business Activity Monitor sur LiveCycle Workflow Server et
BAM Server. Reportez-vous à la section « Prise en main de BAM Server », page 90 .
Partie IV : Configuration supplémentaire de
LiveCycle Workflow
Cette section du guide décrit la configuration supplémentaire des installations de LiveCycle Workflow.
89
13
Prise en main de BAM Server
Ce chapitre explique comment exécuter la configuration initiale de LiveCycle Workflow Server pour permettre à BAM Server de surveiller l'activité d'un processus. Vous devez configurer les paramètres de
LiveCycle Workflow Server et BAM Server :
O
O
« Configuration de LiveCycle Workflow Server pour BAM Server », page 90
« Configuration de BAM Server », page 91
Configuration de LiveCycle Workflow Server pour BAM Server
Vous pouvez configurer LiveCycle Workflow pour vous connecter à BAM Server à l'aide de Administrator.
Vous devez indiquer le serveur sur lequel BAM Server est exécuté et les informations relatives au compte utilisateur utilisé pour accéder à BAM Server.
³
Pour configurer LiveCycle Workflow Server pour BAM Server :
1. Connectez-vous à Administrator. Reportez-vous à la section
« Accès à Administrator », page 26 .
2. Cliquez sur Services, puis sur Adobe LiveCycle Workflow.
3. Cliquez sur Paramètres du serveur, puis sur Paramètres de configuration BAM.
4. Spécifiez les valeurs des propriétés suivantes :
O
Hôte : nom d'hôte ou adresse IP du serveur sur lequel BAM Server est exécuté. La valeur par défaut est localhost
.
O
Port : port de service du serveur d'applications sur lequel BAM Server est exécuté. La valeur par défaut correspond au port par défaut du serveur d'applications pour lequel LiveCycle Workflow a
été installé.
O
Nom d'utilisateur : (facultatif ) nom du compte utilisateur de l'administrateur que LiveCycle
Workflow Server utilise pour accéder à BAM Server. Le nom d'utilisateur par défaut est system
.
Remarque :
si vous spécifiez le nom d'utilisateur d'un autre compte utilisateur, vous devez vous assurer que l'utilisateur possède des droits d'administration complets pour BAM Server. Pour plus de détails sur l'administration des comptes utilisateur de BAM, consultez l'aide de
BAM Workbench ou le guide Using LiveCycle Workflow Workbench.
O
Mot de passe : (facultatif ) mot de passe valide du nom d'utilisateur spécifié ci-dessus. Le mot de passe par défaut est manager
.
5. Cliquez sur Enregistrer et redémarrez LiveCycle.ear.
Accès à BAM Workbench et à BAM Dashboard
Une fois BAM Server déployé et exécuté sur le serveur d'applications, vous pouvez accéder à
BAM Workbench et à Business Activity Monitor (BAM) Dashboard par l'intermédiaire d'un navigateur Web.
BAM Workbench comprend des outils d'administration de BAM Server et de configuration de rapports que les utilisateurs consultent dans BAM Dashboard.
90
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Prise en main de BAM Server
Configuration de BAM Server 91
Pour vous connecter aux pages de Business Activity Monitor, vous devez saisir un nom d'utilisateur et un mot de passe. Lorsque vous déployez BAM Server, un compte d'administration par défaut est créé ; le nom d'utilisateur system et le mot de passe manager lui sont attribués.
Conseil :
vous pouvez créer un autre utilisateur d'administration ou modifier l'utilisateur existant à l'aide de BAM Workbench. Si vous modifiez l'utilisateur existant, vous devez adapter les propriétés correspondantes sur LiveCycle Workflow Server. Reportez-vous à la section
LiveCycle Workflow Server pour BAM Server », page 90
.
Pour plus de détails sur l'utilisation des outils fournis avec la structure d'administration, connectez-vous à
BAM Workbench et consultez l'aide.
³
Pour accéder à BAM Workbench :
1. Démarrez BAM Workbench en saisissant http://[nomhôte]:[port]/celequest/workbench dans la ligne d'adresse d'un navigateur Web.
2. Dans le champ User Name, saisissez un nom d'utilisateur valide, puis renseignez le champ Password avec le mot de passe correspondant. Vous pouvez utiliser le nom d'utilisateur et le mot de passe par défaut, soit respectivement system
et manager
.
³
Pour accéder à BAM Dashboard :
1. Démarrez BAM Dashboard en saisissant http://[nomhôte]:[port]/celequest/dashboard dans la ligne d'adresse d'un navigateur Web.
2. Dans le champ User Name, saisissez un nom d'utilisateur valide, puis renseignez le champ Password avec le mot de passe correspondant. Vous pouvez utiliser le nom d'utilisateur et le mot de passe par défaut, soit respectivement system
et manager
.
Configuration de BAM Server
Vous pouvez configurer BAM Server pour la surveillance des processus de LiveCycle Workflow à l'aide de
BAM Workbench. Reportez-vous à la section « Accès à BAM Workbench et à BAM Dashboard », page 90 .
Vous devez utiliser BAM Workbench pour exécuter les tâches suivantes :
O
O
O configurer les paramètres du serveur SMTP pour l'envoi de courriers électroniques ; importer les définitions des métadonnées utilisées pour surveiller les processus de
LiveCycle Workflow ; configurer les paramètres du serveur LDAP pour BAM Server.
Configuration des paramètres SMTP
BAM Server utilise un serveur SMTP pour envoyer des courriers électroniques aux utilisateurs de
Business Activity Monitor. Vous devez indiquer le serveur sur lequel le serveur SMTP est exécuté ainsi que les informations relatives au compte utilisateur avec lequel BAM Server peut accéder au serveur SMTP.
³
Pour configurer les paramètres SMTP :
1. Vérifiez que LiveCycle Workflow Server et les applications BAM Server sont en cours d'exécution.
2. Vérifiez que la base de métadonnées BAM est lancée.
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Prise en main de BAM Server
Importation des définitions de métadonnées de LiveCycle Workflow 92
3. Démarrez BAM Workbench en saisissant http://[nomhôte]:[port]/celequest/workbench dans la ligne d'adresse d'un navigateur Web.
4. Ouvrez une session à l'aide du nom d'utilisateur et du mot de passe configurés pour administrer
Business Activity Monitor. Vous pouvez utiliser le nom d'utilisateur et le mot de passe par défaut, soit respectivement system
et manager
.
5. Si vous vous connectez pour la première fois à BAM Workbench, la boîte de dialogue First Time Setup apparaît. Le cas échéant, cliquez sur Open System Settings, puis sur l'onglet SMTP Configuration.
6. Spécifiez les valeurs des propriétés suivantes :
O
SMTP Host : nom du réseau ou adresse IP du serveur SMTP que BAM Server utilise pour envoyer des messages électroniques.
O
O
O
SMTP From Address : adresse électronique que BAM Server utilise pour recevoir des messages
électroniques.
SMTP User : nom d'utilisateur du compte de messagerie que BAM Server utilise.
SMTP Password : mot de passe de l'utilisateur SMTP.
7. Sélectionnez l'onglet Checkpoint Configuration, puis indiquez l'emplacement du répertoire des journaux de récupération dans le champ Recovery Log Directory.
8. Sélectionnez l'onglet Logging, puis indiquez l'emplacement du répertoire de consignation dans le champ Logging Directory.
9. Cliquez sur OK.
Importation des définitions de métadonnées de LiveCycle Workflow
Vous devez importer les définitions de métadonnées de LiveCycle Workflow pour configurer les métriques de processus contrôlées par BAM Server.
³
Pour importer les définitions de métadonnées de LiveCycle Workflow :
1. Vérifiez que LiveCycle Workflow Server et les applications BAM Server sont lancés.
2. Vérifiez que la base de métadonnées BAM est lancée.
3. Démarrez BAM Workbench en saisissant http://[nomhôte]:[port]/celequest/workbench dans la ligne d'adresse d'un navigateur Web.
4. Cliquez sur l'onglet Administration Console, puis sur Import/Export.
5. Sélectionnez Import Metadata from a JAR file (upload) et saisissez le chemin d'accès complet à l'emplacement du modèle de métadonnées de LiveCycle Workflow BAM adapté au type de base de données utilisé pour la base de données LiveCycle :
O
(SQL Server) adobeimport_SQLServer.jar
O
(MySQL) adobeimport_MySQL.jar
Ces fichiers figurent dans le répertoire [racine LiveCycle]/Workflow/bam/BAMAppTemplate.
6. Cliquez sur OK.
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Prise en main de BAM Server
Configuration des paramètres LDAP pour BAM Server 93
Configuration des paramètres LDAP pour BAM Server
Outre la création manuelle d'utilisateurs et de leurs autorisations, Business Activity Monitor vous permet d'importer les informations relatives aux utilisateurs à partir des fournisseurs LDAP pris en charge. Vous pouvez planifier des synchronisations automatiques ou exécuter des synchronisations manuelles avec le serveur LDAP pour mettre automatiquement à jour les utilisateurs et les rôles existants.
Lors de la synchronisation avec le serveur LDAP, le DN de base de l'utilisateur, l'identification et le mot de passe de connexion, le nom complet, la description et les propriétés de l'adresse électronique sont mis en cache dans la base de métadonnées BAM.
Lorsque BAM Server importe des utilisateurs à partir du serveur LDAP, les groupes LDAP sont convertis en rôles Business Activity Monitor. Les rôles sont attribués aux utilisateurs en fonction du groupe auquel ils appartiennent dans LDAP. Pour plus de détails, reportez-vous à la section
« Restrictions de la connectivité
.
Remarque :
BAM Server s'intègre à tous les fournisseurs LDAP prenant en charge le protocole LDAP version 3.
Restrictions de la connectivité LDAP de BAM Server
Les restrictions suivantes s'appliquent à la connectivité de BAM Server avec le serveur LDAP :
O
Vous pouvez configurer une connexion vers un seul serveur LDAP.
O
O
O
BAM Server crée des rôles suivant les groupes définis sur le serveur LDAP. Lorsque BAM Server rencontre un groupe dont le rôle n'a pas encore été créé, il le crée et lui attribue un ensemble d'autorisations nulles. Vous pouvez modifier ultérieurement les autorisations selon vos besoins.
Reportez-vous à la section « Configuration du mappage du rôle LDAP », page 96 .
Si BAM Server importe un utilisateur qui n'appartient pas à un groupe auquel un rôle Business Activity
Monitor correspond, l'utilisateur est créé mais aucun rôle ne lui est attribué.
Vous ne pouvez pas modifier le rôle attribué à un utilisateur si ce dernier est importé du serveur LDAP.
Vous pouvez attribuer des rôles aux utilisateurs importés en apportant des modifications au serveur LDAP. Vous pouvez, cependant, affecter des utilisateurs créés manuellement aux rôles créés en fonction des groupes LDAP.
Pratiques conseillées pour la connectivité LDAP de BAM Server
Lors de la configuration de la connectivité de BAM Server avec le serveur LDAP, nous vous recommandons fortement de respecter les meilleures pratiques suivantes :
O
Si la connexion au serveur LDAP n'est pas sécurisée, utilisez le protocole SSL.
O
O
Pour l'authentification, Simple Authentication and Security Layer (SASL) constitue la méthode recommandée. En outre, elle est bien prise en charge par LDAP.
Pour des raisons de sécurité, les autorisations d'accès de l'utilisateur de la synchronisation LDAP doivent être limitées à l'interrogation du serveur LDAP. Pour plus de détails sur l'utilisateur de la
.
Attention :
le mot de passe de cet utilisateur est enregistré dans les métadonnées de BAM Server au moyen d'un cryptage symétrique réversible. Par conséquent, toute personne ayant accès aux métadonnées peut obtenir ce mot de passe.
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Prise en main de BAM Server
Configuration des paramètres LDAP pour BAM Server 94
Configuration de la synchronisation LDAP automatique
Vous pouvez planifier la synchronisation automatique de BAM Server à l'aide du serveur LDAP. La synchronisation garantit que les comptes utilisateur et les définitions de rôle que BAM Server enregistre dans la base de métadonnées BAM sont mises à jour avec le contenu du serveur LDAP.
Pendant la synchronisation, BAM Server crée de nouveaux rôles en fonction des nouveaux groupes présents sur le serveur LDAP et supprime les rôles existants en fonction des groupes supprimés du serveur
LDAP depuis la précédente synchronisation.
Remarque :
les rôles sont supprimés même si des utilisateurs créés manuellement leur sont affectés. Pour ces utilisateurs, si les rôles sont supprimés du fait de la synchronisation, les comptes utilisateur continuent d'exister mais ne sont plus affectés aux rôles.
³
Pour configurer la synchronisation LDAP automatique :
1. Démarrez BAM Workbench en saisissant http://[nomhôte]:[port]/celequest/workbench dans la ligne d'adresse d'un navigateur Web.
2. Cliquez sur l'onglet Administration Console, puis sur System Settings.
3. Cliquez sur l'onglet LDAP Synchronization.
4. Sélectionnez l'option LDAP Enabled, si elle n'est pas déjà cochée.
5. Spécifiez les valeurs des propriétés suivantes :
O
O
Initial Context Factory : nom JNDI par l'intermédiaire duquel BAM Server se connecte au serveur LDAP. La valeur par défaut est com.sun.jndi.ldap.LdapCtxFactory
. Il n'est probablement pas nécessaire de modifier cette valeur.
LDAP Server : nom DNS ou adresse IP du serveur LDAP.
O
O
LDAP Port : port sur lequel le serveur LDAP fonctionne. Il s'agit généralement du port 389.
Toutefois, si vous sélectionnez l'option SSL, le port par défaut est habituellement le port 636.
Vous devez vérifier auprès de votre administrateur LDAP le numéro de port à utiliser.
LDAP SSL : sélectionnez cette option si le serveur LDAP est configuré pour utiliser SSL. La sélection de cette option peut avoir un impact sur le paramètre Port LDAP.
O
O
O
LDAP Authentication : méthode d'authentification utilisée par le serveur LDAP. Sélectionnez l'une des options suivantes :
O
Simple
O
O
SASL (Simple Authentication and Security Layer). Sélectionnez cette option pour Sun ONE.
Compare Encrypted Password
LDAP Principal DN Prefix : dans le cadre de la méthode d'authentification simple, le texte que vous indiquez est inséré avant le nom de connexion de l'utilisateur :
O
Pour les serveurs LDAP requérant une connexion DN, définissez cette option sur la valeur de propriété appropriée suivi du signe = (par exemple, cn=
ou uid=
).
O
Pour ActiveDirectory, n'indiquez aucune valeur.
LDAP Principal DN Suffix : dans le cadre de la méthode d'authentification simple, le texte que vous indiquez est inséré après le nom de connexion de l'utilisateur :
O
Pour les serveurs LDAP requérant une connexion DN, définissez cette option sur la chaîne de valeurs appropriée. Le premier caractère du suffixe doit être une virgule (« , »). Par exemple :
,ou=Users,dc=domain,dc=name
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Prise en main de BAM Server
Configuration des paramètres LDAP pour BAM Server 95
O
O
O
Pour ActiveDirectory, qui requiert une connexion simple avec une adresse électronique, définissez cette option sur le symbole
@
suivi du nom de domaine utilisé pour ActiveDirectory.
LDAP Synchronization User : utilisateur qui se connecte au serveur et lit les listes d'utilisateurs et de rôles. Par mesure de sécurité, vous devez spécifier un compte utilisateur qui ne peut que lire le répertoire LDAP.
LDAP Synchronization Password : mot de passe associé à l'utilisateur spécifié pour l'option LDAP
Synchronization User.
6. Cliquez sur Test Connection. La connexion ainsi que la configuration des mappages de l'utilisateur et du rôle sont testées. Si les paramètres de connexion sont corrects, un message indique que la connexion a réussi. Si vous n'avez pas encore configuré le mappage de l'utilisateur et du rôle LDAP, le message renvoie une erreur.
7. Pour configurer le calendrier de synchronisation LDAP, utilisez les boutons Add Schedule, Edit
Schedule et Remove Schedule pour créer le calendrier souhaité.
Remarque :
vous devez configurer la synchronisation au moment où les utilisateurs connectés sont le moins nombreux.
8. Cliquez sur OK.
Configuration du mappage de l'utilisateur LDAP
Vous pouvez configurer les paramètres de mappage de l'utilisateur déterminant les utilisateurs importés et synchronisés à partir du serveur LDAP. Ces paramètres dépendent du fournisseur du serveur LDAP utilisé.
³
Pour configurer les paramètres de mappage de l'utilisateur LDAP :
1. Démarrez BAM Workbench en saisissant http://[nomhôte]:[port]/celequest/workbench dans la ligne d'adresse d'un navigateur Web.
2. Cliquez sur l'onglet Administration Console, puis sur System Settings.
3. Cliquez sur l'onglet LDAP User Mapping.
4. Spécifiez les valeurs des paramètres suivants :
O
LDAP User Base DN : racine de l'arborescence utilisée pour rechercher des utilisateurs. Par exemple :
O
O
(Sun ONE)
OU=people,DC=your domain,DC=com
(Active Directory)
CN=Users,DC=yourdomain,DC=com
O
O
O
LDAP User Search Filter : format approprié au type de serveur LDAP utilisé. Par exemple, votre serveur LDAP peut intégrer un groupe spécial pour les utilisateurs Business Activity Monitor.
Ce filtre permet de s'assurer que seuls les utilisateurs de ce groupe sont importés.
LDAP User LoginID : ID de connexion du fournisseur indiqué. Cette valeur devient l'ID de connexion de l'utilisateur dans Business Activity Monitor.
LDAP User Full Name : entrez cn
si vous utilisez Sun ONE ou Active Directory.
O
O
O
LDAP User Description : entrez description
si vous utilisez Sun ONE ou Active Directory.
LDAP User PrimaryEmail : entrez userPrincipalName
. Ceci renvoie à l'adresse électronique de l'utilisateur dans le répertoire LDAP.
LDAP User EncryptedPassword : entrez le mot de passe associé à l'utilisateur spécifié si vous utilisez Sun ONE ou Tivolie. Ne remplissez pas ce champ pour Active Directory.
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Prise en main de BAM Server
Configuration des paramètres LDAP pour BAM Server 96
5. Cliquez sur l'onglet LDAP Synchronization, puis sur Test Connection pour savoir si l'importation des utilisateurs a réussi.
6. Cliquez sur OK.
Configuration du mappage du rôle LDAP
Vous pouvez configurer les paramètres de mappage du rôle déterminant les groupes ou rôles importés, synchronisés ou les deux. Ces paramètres dépendent du fournisseur du serveur LDAP utilisé.
³
Pour configurer les paramètres de mappage du rôle LDAP :
1. Démarrez BAM Workbench en saisissant http://[nomhôte]:[port]/celequest/workbench dans la ligne d'adresse d'un navigateur Web.
2. Cliquez sur l'onglet Administration Console, puis sur System Settings.
3. Cliquez sur l'onglet LDAP Role Mapping.
4. Spécifiez les valeurs des paramètres suivants :
O
LDAP Role Base DN : format approprié au type de serveur LDAP utilisé :
O
(Sun ONE)
OU=Groups,DC=your domain,DC=com
O
O
(Active Directory)
CN=Users,DC=yourdomain,DC=com
LDAP Role Search Filter : format approprié au type de serveur LDAP utilisé :
O
O
(Sun ONE)
(&(objectclass=groupOfUniqueNames))
(Active Directory)
(&(objectclass=group))
O
O
O
O
O
LDAP Role LoginID : entrez cn
si vous utilisez Sun ONE ou Active Directory.
LDAP Role Full Name : entrez displayname
si vous utilisez Sun ONE ou Active Directory.
LDAP Role Description : entrez description
si vous utilisez Sun ONE ou Active Directory.
LDAP Role Member : nom de la propriété à plusieurs valeurs contenant les membres du rôle :
O
O
(Sun ONE) uniqueMember
(Active Directory)
member
LDAP Role Member is : utilisez l'une des options suivantes :
O
O
Distinguished Name
, si les propriétés de membre du rôle identifient les utilisateurs par l'intermédiaire de leur identifiant, comme cn=jadmin,ou=people,dc=your domain,dc=com
.
Login identification
, si les propriétés de membre du rôle identifient les utilisateurs par la valeur de la propriété utilisée comme identifiant de connexion Business Activity Monitor.
5. Cliquez sur l'onglet LDAP Synchronization, puis sur Test Connection pour savoir si l'importation des utilisateurs a réussi.
6. Cliquez sur OK.
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Prise en main de BAM Server
Configuration des paramètres LDAP pour BAM Server 97
Synchronisation manuelle avec le serveur LDAP
Vous pouvez synchroniser manuellement BAM Server avec le serveur LDAP à tout moment. Les demandes de synchronisation sont placées en file d'attente pour empêcher les synchronisations simultanées.
³
Pour procéder à une synchronisation manuelle avec le serveur LDAP :
1. Démarrez BAM Workbench en saisissant http://[nomhôte]:[port]/celequest/workbench dans la ligne d'adresse d'un navigateur Web.
2. Cliquez sur l'onglet Administration Console, puis sur System Settings.
3. Cliquez sur l'onglet LDAP Synchronization.
4. Cliquez sur Synchronize Now. Le délai d'exécution de la synchronisation dépend de votre environnement. Un message apparaît une fois la synchronisation terminée.
5. Cliquez sur OK.
Etapes suivantes
Vous pouvez à présent installer LiveCycle Workflow Designer. Reportez-vous à la section
LiveCycle Workflow Designer », page 98
.
14
Installation de LiveCycle Workflow Designer
Ce chapitre décrit l'installation de LiveCycle Workflow Designer.
Installation de LiveCycle Workflow Designer
Vous devez exécuter un programme d'installation pour installer LiveCycle Workflow Designer et configurer une connexion à LiveCycle Workflow Server. Lorsque vous lancez le programme d'installation, vous devez spécifier le nom du serveur sur lequel LiveCycle Workflow Server est déployé.
Avant d'installer LiveCycle Workflow Designer, vous devez disposer de J2SDK version 1.4.2_04 ou d'une version ultérieure à la 1.4.2 (la version 1.4.2_10 n'est pas prise en charge).
LiveCycle Workflow Designer est installé à l'emplacement suivant par défaut :
O
(Windows) C:\Adobe\LiveCycle\WorkflowDesigner
O
(Linux) /opt/adobe/livecycle/workflow_designer
³
Pour installer LiveCycle Workflow Designer :
1. Lancez le programme d'installation situé à la racine du support d'installation en saisissant la commande suivante :
O
O
(Windows) adobe_lc_workflow_721_des.exe
(Linux) adobe_lc_workflow_721_des.bin
2. Dans l'écran de bienvenue, cliquez sur Suivant.
3. Lisez l'accord de licence, sélectionnez I accept the terms of the license agreement, puis cliquez sur
Next.
4. Acceptez le répertoire d'installation par défaut ou cliquez sur Browse et recherchez le répertoire dans lequel vous souhaitez installer le produit, puis cliquez sur Next.
Remarque :
si vous saisissez le nom d'un répertoire qui n'existe pas, ce dernier est créé pour vous.
5. Sélectionnez JBoss comme type de serveur d'applications hébergeant LiveCycle Workflow Server, puis cliquez sur Next.
6. Dans la zone de texte, saisissez le nom de l'ordinateur exécutant LiveCycle Workflow Server et cliquez sur Next.
7. Vérifiez les détails de l'installation, puis cliquez sur Back pour modifier les paramètres ou cliquez sur
Install pour continuer.
8. Cliquez sur Finish.
98
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Installation de LiveCycle Workflow Designer
Connexion au serveur d'applications par le biais de ports autres que les ports par défaut 99
9. Si vous n'installez pas LiveCycle Workflow Designer sur le même ordinateur que LiveCycle Workflow
Server, vérifiez que l'heure de l'horloge système est correctement configurée.
Si cette dernière n'est pas comprise dans les deux heures du fuseau horaire utilisé, LiveCycle Workflow
Designer ne peut pas se connecter au serveur d'applications. L'heure de l'horloge système du serveur d'applications doit également être correctement définie.
Connexion au serveur d'applications par le biais de ports autres que les ports par défaut
La configuration par défaut de LiveCycle Workflow Designer utilise des ports JNDI et HTTP par défaut pour la connexion au serveur d'applications. Si le serveur d'applications utilise des numéros de ports non définis par défaut, vous devez modifier manuellement le fichier de configuration de LiveCycle
Workflow Designer.
³
Pour modifier le port utilisé pour les connexions JNDI et HTTP :
1. Ouvrez le fichier qlc-config.xml dans un éditeur de texte depuis l'emplacement suivant :
O
O
(Windows) [racine LiveCycle]/WorkflowDesigner/qlc/
(Linux) [racine LiveCycle]/workflow_designer/qlc/
2. Recherchez l'élément property
portant l'attribut name
de java.naming.provider.url
, puis modifiez l'URL dans l'attribut value
afin d'intégrer le port à utiliser pour les connexions JNDI.
Par exemple, l'élément property
suivant définit le port à utiliser pour les connexions JNDI sur 1099 :
<property name="java.naming.provider.url" value="jnp://localhost:1099/"/>
3. Recherchez l'élément application-services
et remplacez la valeur de l'attribut port
par le port que votre serveur d'applications utilise pour ses connexions HTTP.
Par exemple, l'élément application-services suivant définit le port à utiliser pour les connexions HTTP sur 8080 :
<application-services host="localhost" port="
8080
" context="adobe-services"/>
4. Enregistrez le fichier, puis fermez-le.
Désinstallation de LiveCycle Workflow Designer
LiveCycle Workflow Designer intègre un programme de désinstallation créé pendant l'installation. Le programme de désinstallation supprime les fichiers produit.
³
Pour supprimer LiveCycle Workflow Designer :
1. Lancez le programme de désinstallation :
O
(Windows) Accédez au répertoire [racine LiveCycle]/WorkflowDesigner/_uninst/ et double-cliquez sur uninstall.exe.
O
(Linux) Accédez au répertoire [racine LiveCycle]/workflow_designer/_uninst/ et exécutez uninstall.bin.
2. Lorsque vous y êtes invité, sélectionnez la langue souhaitée pour le programme de désinstallation et cliquez sur OK.
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Installation de LiveCycle Workflow Designer
Désinstallation de LiveCycle Workflow Designer 100
3. Dans l'écran de bienvenue, cliquez sur Next.
4. Vérifiez les informations affichées, puis cliquez sur Uninstall.
5. Si la boîte de dialogue Remove Existing File s'affiche, cliquez sur Yes To All.
6. Cliquez sur Finish.
Etapes suivantes
Vous pouvez maintenant déployer les QPAC. (Consultez le guide Création de flux de production ou l'aide de
LiveCycle Workflow Designer.)
Si vous avez installé Watched Folder et LiveCycle Assembler, vous pouvez créer des flux de production
LiveCycle Assembler à l'aide de LiveCycle Workflow et de Watched Folder », page 105 .
A
Associations de plates-formes et logiciels prises en charge
Cette annexe présente les associations de plates-formes et de logiciels prises en charge pour les produits
LiveCycle. Pour obtenir un récapitulatif des associations de plates-formes, reportez-vous à la section
« Avant l'installation », page 11 .
Remarque :
LiveCycle PDF Generator Elements et LiveCycle PDF Generator Professional fonctionnent uniquement sur la plate-forme Windows Server 2003 Enterprise Edition.
Plate-forme
Windows
Server 2003
Standard Edition
Windows
Server 2003
Enterprise Edition
Serveur d'applications JDK
JBoss 3.2.5
J2SDK version 1.4.2_04
JBoss 3.2.5
JBoss 3.2.5
J2SDK version 1.4.2_04
J2SDK version 1.4.2_04
JBoss 3.2.5
JBoss 3.2.5
IBM WebSphere 5.1.1.5
J2SDK version 1.4.2_04
J2SDK version 1.4.2_04
IBM WebSphere® 5.1.1.5
JDK IBM installé avec
WebSphere
BEA WebLogic
Server® 8.1 SP5
J2SDK version 1.4.2_08
J2SDK version 1.4.2_08
BEA WebLogic Server
8.1 SP5
IBM WebSphere 5.1.1.5
JDK IBM installé avec
WebSphere
IBM WebSphere 5.1.1.5
JDK IBM installé avec
WebSphere
JDK IBM installé avec
WebSphere
Base de données
MS SQL Server 2000 SP3
MySQL 4.1
IBM DB2 8.2
(Version 8.1 Fix Pack 7)
Oracle 9i
Oracle 10g
Oracle 9i
Oracle 9i
Oracle 10g
Oracle 10g
IBM DB2 8.2
(Version 8.1 Fix Pack 7)
MS SQL Server 2000 SP3
101
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Associations de plates-formes et logiciels prises en charge
102
Plate-forme
Red Hat Linux Adv anced Server 2.1, mise à jour 3
Serveur d'applications
JBoss 3.2.5
JBoss 3.2.5
JDK
J2SDK version 1.4.2_04
J2SDK version 1.4.2_04
JBoss 3.2.5
J2SDK version 1.4.2_04
JBoss 3.2.5
JBoss 3.2.5
J2SDK version 1.4.2_04
J2SDK version 1.4.2_04
Red Hat Linux Adv anced Server 3.0
BEA WebLogic Server
8.1 SP5
BEA WebLogic Server
8.1 SP5
IBM WebSphere 5.1.1.5
J2SDK version 1.4.2_08
J2SDK version 1.4.2_08
IBM WebSphere 5.1.1.5
IBM WebSphere 5.1.1.5
JBoss 3.2.5
JBoss 3.2.5
JBoss 3.2.5
JBoss 3.2.5
JDK IBM installé avec
WebSphere
JDK IBM installé avec
WebSphere
JDK IBM installé avec
WebSphere
J2SDK version 1.4.2_04
J2SDK version 1.4.2_04
J2SDK version 1.4.2_04
J2SDK version 1.4.2_04
IBM AIX® 5.2
BEA WebLogic Server
8.1 SP5
BEA WebLogic Server
8.1 SP5
IBM WebSphere 5.1.1.5
J2SDK version 1.4.2_08
J2SDK version 1.4.2_08
IBM WebSphere 5.1.1.5
IBM WebSphere 5.1.1.5
IBM WebSphere 5.1.1.5
IBM WebSphere 5.1.1.5
IBM WebSphere 5.1.1.5
JDK IBM installé avec
WebSphere
JDK IBM installé avec
WebSphere
JDK IBM installé avec
WebSphere
JDK IBM installé avec
WebSphere
JDK IBM installé avec
WebSphere
JDK IBM installé avec
WebSphere
Base de données
MS SQL Server 2000 SP3
MySQL 4.1
Oracle 9i
Oracle 10g
IBM DB2 8.2
(Version 8.1 Fix Pack 7)
Oracle 9i
Oracle 10g
IBM DB2 8.2
(Version 8.1 Fix Pack 7)
Oracle 9i
Oracle 10g
MySQL 4.1
Oracle 9i
Oracle 10g
IBM DB2 8.2
(Version 8.1 Fix Pack 7)
Oracle 9i
Oracle 10g
IBM DB2 8.2
(Version 8.1 Fix Pack 7)
Oracle 9i
Oracle 10g
Oracle 9i
Oracle 10g
IBM DB2 8.2
(Version 8.1 Fix Pack 7)
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Associations de plates-formes et logiciels prises en charge
103
Plate-forme
IBM AIX 5.3
Serveur d'applications JDK
IBM WebSphere 5.1.1.5
JDK IBM installé avec
WebSphere
IBM WebSphere 5.1.1.5
IBM WebSphere 5.1.1.5
JDK IBM installé avec
WebSphere
JDK IBM installé avec
WebSphere
J2SDK version 1.4.2_08
SUN™ Solaris™ 8 BEA WebLogic Server
8.1 SP5
BEA WebLogic Server
8.1 SP5
IBM WebSphere 5.1.1.5
J2SDK version 1.4.2_08
Sun Solaris 9
IBM WebSphere 5.1.1.5
IBM WebSphere 5.1.1.5
JDK IBM installé avec
WebSphere
JDK IBM installé avec
WebSphere
JDK IBM installé avec
WebSphere
J2SDK version 1.4.2_08
BEA WebLogic Server
8.1 SP5
IBM WebSphere 5.1.1.5
SUSE Linux ES 9.0
IBM WebSphere 5.1.1.5
JBoss 3.2.5
JBoss 3.2.5
JBoss 3.2.5
JBoss 3.2.5
BEA WebLogic Server 8.1
SP5
IBM WebSphere 5.1.1.5
JDK IBM installé avec
WebSphere
JDK IBM installé avec
WebSphere
J2SDK version 1.4.2_04
J2SDK version 1.4.2_04
J2SDK version 1.4.2_04
J2SDK version 1.4.2_04
J2SDK version 1.4.2_08
IBM WebSphere 5.1.1.5
JDK IBM installé avec
WebSphere
JDK IBM installé avec
WebSphere
Base de données
Oracle 9i
Oracle 10g
IBM DB2 8.2
(Version 8.1 Fix Pack 7)
Oracle 9i
Oracle 10g
IBM DB2 8.2
(Version 8.1 Fix Pack 7)
Oracle 9i
Oracle 10g
Oracle 9i
Oracle 9i
Oracle 10g
MS SQL Server 2000 SP3
Oracle 9i
Oracle 10g
MySQL 4.1
Oracle 9i
Oracle 9i
Oracle 10g
B
Polices installées avec le module Font Manager
Certains modules nécessitent un accès à des polices installées avec le module Font Manager. Ce dernier contient plusieurs groupes de polices que vous pouvez utiliser dans vos applications personnalisées.
Le module Font Manager n‘est pas utilisé pendant la conversion de documents natifs au format PDF ou de documents PDF dans un autre format.
Vous pouvez ajouter des polices au module Font Manager, qui sera par la suite intégré au fichier
LiveCycle.ear. Pour plus de détails sur l'ajout de vos propres polices, reportez-vous à la section
« Configuration des produits LiveCycle à déployer », page 49
.
Les polices suivantes sont installées avec le module Font Manager :
O
Adobe Serif MM
O
O
O
O
Adobe Sans MM
Adobe Ming Std Light
Adobe Song Std Light
Adobe Myungjo Std Medium
O
O
O
O
Adobe Pi Std
Bell Gothic Std Light
Bell Gothic Std Bold
Bell Gothic Std Black
O
O
O
O
Courier Std
Courier Std Bold
Courier Std Bold Oblique
Courier Std Oblique
O
O
O
O
EuroSign (TTF)
Kozuka Gothic® Std Extra Light
Kozuka Gothic Std Light
Kozuka Gothic Std Regular
O
O
O
O
Kozuka Gothic Std Medium
Kozuka Gothic Std Bold
Kozuka Gothic Std Heavy
Kozuka Gothic Std Medium
O
O
O
O
Kozuka Mincho® Std Extra Light
Kozuka Mincho Std Light
Kozuka Mincho Std Regular
Kozuka Mincho Std Medium
O
O
O
O
O
O
O
O
O
O
O
O
O
O
O
O
O
O
O
O
O
O
O
O
Kozuka Mincho Std Bold
Kozuka Mincho Std Heavy
Kozuka Mincho Pro-VI Regular
Letter Gothic Std Medium
Letter Gothic Std Slanted
Letter Gothic Std Bold
Letter Gothic Std Bold Slanted
Minion® Pro Italic
Minion Pro Semibold
Minion Pro Semibold Italic
Minion Pro Bold
Minion Pro Bold Italic
Minion Pro Regular
Myriad® Pro Light
Myriad Pro Light Italic
Myriad Pro Regular
Myriad Pro Italic
Myriad Pro Bold
Myriad Pro Semibold
Myriad Pro Semibold Italic
Myriad Pro Bold Italic
Myriad Pro Black
Myriad Pro Black Italic
Symbol
104
C
Appel de LiveCycle Assembler à l'aide de
LiveCycle Workflow et de Watched Folder
Cette annexe explique comment appeler LiveCycle Assembler par le biais de LiveCycle Workflow, à l'aide des QPAC LiveCycle Assembler et de Watched Folder.
Elle suppose que vous avez installé, configuré et déployé LiveCycle Assembler, LiveCycle Workflow et
Watched Folder.
Remarque :
vous pouvez implémenter les dossiers de contrôle à utiliser avec LiveCycle PDF Generator mais vous devez les configurer séparément. Le contenu de ce chapitre traite uniquement le service Watched Folder intégrant LiveCycle Workflow et LiveCycle Assembler. Pour plus d'informations sur la configuration des dossiers de contrôle de LiveCycle PDF Generator, reportez-vous à l'aide sur l'administration de LiveCycle PDF Generator, disponible depuis l'interface Web de LiveCycle PDF Generator.
Liste des tâches
A l'aide de Watched Folder ou d'une application cliente que vous avez développée, vous pouvez indiquer
à LiveCycle Workflow d'initier un flux de production activant un QPAC LiveCycle Assembler.
Cette section présente les tâches requises pour configurer un flux de production permettant l'achèvement d'un processus LiveCycle Assembler appelé par Watched Folder. La procédure détaillée nécessaire à la réalisation des tâches figure dans la section ou le document indiqué. Vous devez exécuter les tâches suivant leur ordre d'apparition dans le tableau.
Remarque :
n'exécutez pas Configuration Manager tant que vous n'avez pas terminé d'installer les fichiers pour chacun des produits.
Etape
1
2
3
4
5
Tâche
Déployez les QPAC LiveCycle Assembler sur
LiveCycle Workflow Designer.
Créez et déployez un flux de production comprenant un QPAC LiveCycle Assembler.
Créez un dossier de contrôle sur le système de fichiers.
Connectez-vous à Administrator, puis créez un dossier de contrôle et configurez-le.
Créez un fichier JobConfig.xml.
Voir
Using LiveCycle Assembler QPACs (disponible sur le DVD d'installation de
LiveCycle Assembler ou sur le site Web de
LiveCycle Workflow SDK)
« Déploiement de QPAC et création d'un processus de flux de production », page 106
LiveCycle Workflow Création de flux de
production
Aide de LiveCycle Workflow Designer
« Création et configuration d'un dossier de contrôle », page 109
« Création et configuration d'un dossier de contrôle », page 109
Aide sur l'administration de Watched Folder
« Création d'un fichier JobConfig.xml », page 110
Aide sur l'administration de Watched Folder
105
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Appel de LiveCycle Assembler à l'aide de LiveCycle Workflow et de Watched Folder
Déploiement de QPAC et création d'un processus de flux de production 106
Etape Tâche
6
Préparez les éléments connexes au test ou à la production, parmi lesquels les fichiers PDF d'entrée et un fichier DDX.
7
Soumettez le travail LiveCycle Assembler pour traitement.
Voir
« Préparation des fichiers PDF et DDX », page 112
Developing Applications for LiveCycle
Assembler
Document Description XML Reference
« Soumission du travail LiveCycle Assembler pour traitement », page 113
Developing Custom Applications for
LiveCycle Workflow
Déploiement de QPAC et création d'un processus de flux de production
Deux QPAC permettent de créer des flux de production pour LiveCycle Assembler : le QPAC Assembler et le QPAC CreateDocumentList. Le QPAC Assembler est utilisé pour tous les flux de production
LiveCycle Assembler, que vous utilisiez Watched Folder ou une autre méthode pour initier le processus
(par exemple, des applications clientes ou des services Web).
Cette section explique comment créer un processus de flux de production utilisant le QPAC Assembler, ainsi que les variables requises et les propriétés des actions dans LiveCycle Workflow Designer. Pour plus d'informations sur la création d'un processus de flux de production utilisant le QPAC CreateDocumentList, reportez-vous au guide Using LiveCycle Assembler QPACs.
Les étapes de création d'un processus de flux de production comprenant un QPAC Assembler sont similaires aux étapes de création d'un processus de flux de production à l'aide de
LiveCycle Workflow Designer. La procédure présentée ici fournit des détails propres au QPAC Assembler.
Pour plus d'informations sur la création des flux de production, la configuration des variables et la définition des propriétés des actions dans un QPAC, reportez-vous à la section Création de flux de
production et aux guides Using LiveCycle Assembler QPACs.
Utilisation de fichiers DDX dynamiques ou statiques
Lorsque vous soumettez des travaux à Watched Folder en vue de leur traitement par LiveCycle Workflow et LiveCycle Assembler, vous pouvez utiliser un fichier DDX dynamique ou statique. Lorsque vous créez ou utilisez une application pour soumettre des travaux à LiveCycle Assembler, ce dernier n'utilisant que le flux de production QPAC (sans Watched Folder), vous devez utiliser un fichier DDX statique.
Un flux de production qui utilise un fichier DDX dynamique traite le fichier DDX présent dans le dossier d'entrée d'un dossier de contrôle. Pour utiliser un fichier DDX dynamique dans votre processus de flux de production, vous devez créer une variable
<inputddx> et la spécifier dans les propriétés des actions du QPAC.
Un flux de production qui utilise un fichier DDX statique traite un fichier DDX particulier situé dans le QPAC et utilisé chaque fois que le processus est appelé par le fichier JobConfig.xml. Pour utiliser un fichier DDX statique dans le processus de flux de production, vous devez accéder au fichier DDX et le charger dans le
QPAC lorsque vous configurez les propriétés des actions du flux de production. Vous pouvez utiliser un fichier DDX statique si vous utilisez un dossier de contrôle ou si vous exécutez le processus à l'aide des
QPAC uniquement.
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Appel de LiveCycle Assembler à l'aide de LiveCycle Workflow et de Watched Folder
Configuration d'un QPAC Assembler dans un processus de flux de production 107
Configuration d'un QPAC Assembler dans un processus de flux de production
Lorsque vous créez un nouveau processus de flux de production dans LiveCycle Workflow Designer, vous devez créer des variables que ce dernier utilisera. Lorsque vous ajoutez le QPAC Assembler au flux de production, vous devez définir les propriétés des actions du QPAC. Les propriétés des actions utilisent les variables que vous avez créées.
Vos sélections dans la boîte de dialogue Propriétés des actions varient suivant que vous utilisez un fichier
DDX dynamique ou statique.
Remarque :
les noms de variable utilisés dans ce chapitre, comme
<inputddx>
et
<inputdocmap>
, sont définies par l'utilisateur dans LiveCycle Workflow Designer ; vous pouvez nommer la variable comme bon vous semble à sa création.
Variables pour le QPAC Assembler
Variable
<inputdocmap>
<inputddx>
(requise pour le fichier
DDX dynamique uniquement)
<outputmap>
<joblog>
(non requise lorsque le niveau d'informations consignées est désactivé)
Valeur de la propriété
Type : mappe
de document entrée : sélectionnée sortie : non sélectionnée obligatoire : non sélectionnée
Type : document entrée : sélectionnée sortie : non sélectionnée obligatoire : non sélectionnée
Type : mappe
et document entrée : non sélectionnée sortie : sélectionnée obligatoire : non sélectionnée
Type : document entrée : non sélectionnée sortie : sélectionnée obligatoire : non sélectionnée
Propriétés des actions du QPAC Assembler
Type de flux de production Sélection dans l'onglet Input
Utilisation de Watched Folder avec un fichier DDX dynamique
Use a Document Variable to load the
DDX file : cliquez sur le bouton portant les points de suspension, puis sélectionnez la variable
<inputddx>
.
Sélection dans l'onglet Output
Output Document Map : cliquez sur le bouton portant les points de suspension et sélectionnez la variable
<outputmap>
.
Input Document Map Variable :
Sélectionnez la variable
<inputdocmap>
.
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Appel de LiveCycle Assembler à l'aide de LiveCycle Workflow et de Watched Folder
Configuration d'un QPAC Assembler dans un processus de flux de production 108
Type de flux de production Sélection dans l'onglet Input
Utilisation de Watched Folder avec un fichier DDX statique
Use the Browse button to locate the
DDX file : recherchez le fichier DDX à utiliser.
Utilisation de QPAC uniquement (avec un fichier
DDX statique)
Input Document Map Variable :
Sélectionnez la variable
<inputdocmap>
.
Input Document Map : ne pas sélectionner
Use the Browse button to locate the
DDX file : recherchez le fichier DDX à utiliser.
Sélection dans l'onglet Output
Output Document Map : cliquez sur le bouton portant les points de suspension et sélectionnez la variable
<outputmap>
.
Output Document Map : cliquez sur le bouton portant les points de suspension et sélectionnez la variable
<outputmap>
.
Remarque :
pour plus d'informations sur la sélection des options de l'onglet Configuration, consultez la
section suivante : Consignation des erreurs et modes d'échec dans les flux de production du
.
Consignation des erreurs et modes d'échec dans les flux de production du QPAC Assembler
Lorsque vous configurez un flux de production à l'aide du QPAC Assembler, vous pouvez sélectionner le niveau de consignation des erreurs et le mode d'échec que LiveCycle Workflow utilise lorsque des exceptions se produisent.
Vous pouvez définir le niveau de consignation sur Off (aucune consignation), Normal (messages courts) ou
Debug (descriptions détaillées des erreurs). Vous pouvez associer une variable de processus (par exemple,
<joblog>
) de type
Document au champ Output Log Document pour enregistrer les messages de consignation.
Vous pouvez définir le mode d'échec sur Stall Process ou Terminate Process pour indiquer au QPAC Assembler de bloquer ou de terminer le processus lorsqu'une exception se produit dans LiveCycle Assembler.
En cas d'échec d'un travail lorsque Stall Process est sélectionné, le processus de flux de production est bloqué mais pas terminé. Si la consignation est configurée sur Normal ou Debug, les informations concernant l'exception apparaissent sur la page Stalled Action de LiveCycle Workflow dans Administrator.
Les administrateurs du composant doivent rechercher le processus et le terminer, puis revenir à
Administrator et supprimer l'action bloquée, le cas échéant. Les messages consignés s'affichent sur la page de l'action bloquée mais pas sur la page du processus.
En cas d'échec d'un travail lorsque Terminate Process est sélectionné, le processus de flux de production s'achève lorsqu'une exception est générée. Si la consignation est configurée sur Normal ou Debug, les informations relatives à l'exception sont inscrites dans le fichier journal du composant pour lequel l'exception a été générée. Pour Watched Folder, le fichier journal correspond au fichier activity.log figurant dans le sous-répertoire /failure du dossier de contrôle configuré.
Si vous configurez un QPAC Assembler afin de l'utiliser avec Watched Folder, vous devez définir le mode d'échec sur Terminate Process. Les utilisateurs de Watched Folder peuvent ne pas avoir accès à
Administrator. Par conséquent, si les processus sont bloqués sans être terminés, les utilisateurs ne reçoivent pas de message sur l'exception tant que le processus n'est pas terminé. Configurer le mode d'échec sur Terminate Process garantit que les messages d'erreur sont consignés dans le fichier activity.log, disponible dans le répertoire [dossier de contrôle]/failure (lorsque le niveau de consignation est défini sur Normal ou Debug).
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Appel de LiveCycle Assembler à l'aide de LiveCycle Workflow et de Watched Folder
Création et configuration d'un dossier de contrôle 109
Pour plus d'informations sur la configuration de la consignation des erreurs et les modes d'échec, voir
Using LiveCycle Assembler QPACs.
³
Pour créer un flux de production comprenant un QPAC Assembler :
1. Déployez le QPAC sur LiveCycle Workflow Designer. Reportez-vous à la section Using LiveCycle
Assembler QPACs.
2. Dans LiveCycle Workflow Designer, sélectionnez File > New > Process Category.
3. Sélectionnez la nouvelle catégorie de processus, puis cliquez sur File > New > Process Type.
4. Cliquez avec le bouton droit de la souris sur le nouveau type de processus, puis sélectionnez New
Workflow.
5. Donnez un nom au flux de production, puis utilisez les valeurs par défaut pour les options restantes
(seule l'option synchronous
est sélectionnée).
6. Créez les variables du flux de production, comme indiqué dans le tableau
Assembler », page 107 , en cliquant sur le bouton plus (+) de la palette Variables. Pour plus
d'informations sur la création de variables, consultez l'aide de LiveCycle Workflow Designer.
7. Créez une nouvelle catégorie de composants. (Voir Création de flux de production.)
8. Ajoutez le QPAC Assembler QPAC (déployez le composant) à la nouvelle catégorie de composants, puis définissez les propriétés de l'action du flux de production, comme indiqué dans le tableau de
« Propriétés des actions du QPAC Assembler », page 107
.
9. Enregistrez le processus de flux de production et déployez-le.
Création et configuration d'un dossier de contrôle
Sur votre système de fichiers, créez un répertoire que vous pouvez configurer en tant que dossier de contrôle. Une fois le dossier configuré à l'aide de l'interface de configuration de Watched Folder, il contient les sous-répertoires suivants :
/[dossier de contrôle]
/input
/stage
/failure
/result
/preserve
Pour plus d'informations sur les sous-répertoires, voir Aide sur l'administration de Watched Folder.
Pour soumettre les fichiers à traiter, placez-les dans le répertoire /
[dossier de contrôle]/input
.
Lorsque plusieurs fichiers doivent être intégrés au processus LiveCycle Assembler, ne transférez pas les fichiers de façon individuelle ; créez un répertoire de collecte distinct, placez-y tous les fichiers requis (les fichiers PDF d'entrée et, le cas échéant, le fichier DDX), puis placez le répertoire de collecte dans le répertoire d'entrée du dossier de contrôle.
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Appel de LiveCycle Assembler à l'aide de LiveCycle Workflow et de Watched Folder
Création d'un fichier JobConfig.xml 110
³
Pour créer un dossier de contrôle et le configurer :
1. Créez un répertoire qui servira de dossier de contrôle sur le système de fichiers de votre serveur.
2. Connectez-vous à Administrator.
3. Cliquez sur Services, Watched Folder, puis sur Gestion et état de Watched Folder.
4. Cliquez sur Nouveau dossier de contrôle.
5. Dans le champ Nom du dossier de contrôle, attribuez un nom au dossier de contrôle. (Ce dernier ne doit pas nécessairement correspondre au nom du répertoire créé sur le système de fichiers à l'étape
Nous vous conseillons malgré tout d'utiliser le même nom pour garantir un meilleur suivi.)
6. Dans le champ Chemin du dossier de contrôle, saisissez le chemin complet d'accès au répertoire créé sur le système de fichiers.
7. Dans le champ Modèles de fichier inclus, saisissez le nom du répertoire créé pour contenir les fichiers
PDF d'entrée (que vous placerez dans le répertoire d'entrée du dossier de contrôle). Vous pouvez spécifier plusieurs fichiers ou noms si vous essayez de placer plusieurs fichiers et dossiers dans le dossier de contrôle.
8. Définissez les autres options suivant vos besoins. Pour plus d'informations sur les options disponibles, voir Aide sur l'administration de Watched Folder.
9. Cliquez sur OK.
Conseil :
si vous transférez une grande quantité de fichiers source vers un dossier de contrôle, cette opération peut prendre plusieurs minutes, voire plus. Il est possible que Watched Folder analyse le dossier de contrôle, reconnaisse un nouveau répertoire de collecte et lance un processus de flux de production avant la fin de la copie de tous les fichiers du répertoire. Pour éviter cette situation, vous devez attribuer au répertoire un autre nom que celui analysé par Watched Folder pendant la copie du répertoire dans le répertoire d'entrée. Une fois tous les fichiers d'entrée copiés, vous devez renommer le répertoire de collecte comme indiqué dans la configuration de
Watched Folder (valeur Modèles de fichier inclus).
Création d'un fichier JobConfig.xml
Il est possible de placer le fichier JobConfig.xml à la racine du répertoire d'entrée ou à l'intérieur du répertoire de collecte avec les autres fichiers connexes.
Si vous prévoyez de placer plusieurs travaux (répertoires de collecte) dans le dossier de contrôle de différents flux de production utilisant les fichiers DDX dynamiques, vous devez placer le fichier JobConfig.xml dans les répertoires de collecte individuels soumis au répertoire d'entrée dans le dossier de contrôle.
Si vous prévoyez de soumettre plusieurs travaux au même flux de production utilisant un fichier DDX statique, vous pouvez placer le fichier JobConfig.xml à la racine du répertoire d'entrée. De ce fait, les travaux entrants suivants utilisent ce même fichier JobConfig.xml.
Pour créer un fichier JobConfig.xml, créez un fichier XML similaire aux exemples suivants.
Exemple C.1
Fichier JobConfig.xml pour un fichier DDX dynamique
<?xml version="1.0" encoding="UTF-8"?>
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Appel de LiveCycle Assembler à l'aide de LiveCycle Workflow et de Watched Folder
Création d'un fichier JobConfig.xml 111
<process-config xmlns="http://adobe.com/watchedfolder" xmlns:xsi="http://www.w3.org/2001/ XMLSchema-instance" xsi:schemaLocation="http://adobe.com/watchedfolder
C:\WatchedFolder\schemas\JobConfiguration.xsd">
<process-type>myworkflow</process-type>
<process-variables>
<process-variable>
<filter-pattern>*.pdf</filter-pattern>
<process-variable-type>mappe</process-variable-type>
<process-variable-name>inputdocmap</process-variable-name>
<process-variable-datatype>document</process-variable-datatype>
<process-input>true</process-input>
</process-variable>
<process-variable>
<filter-pattern>*.ddx</filter-pattern>
<process-variable-type>unique</process-variable-type>
<process-variable-name>inputddx</process-variable-name>
<process-variable-datatype>document</process-variable-datatype>
<process-input>true</process-input>
</process-variable>
</process-variables>
</process-config>
Exemple C.2
Fichier JobConfig.xml pour un fichier DDX statique
Utilisez le même fichier JobConfig.xml décrit précédemment, mais omettez la variable de processus
<inputddx>
.
<?xml version="1.0" encoding="UTF-8"?>
<process-config xmlns="http://adobe.com/watchedfolder" xmlns:xsi="http://www.w3.org/2001/ XMLSchema-instance" xsi:schemaLocation="http://adobe.com/watchedfolder
C:\WatchedFolder\schemas\JobConfiguration.xsd">
<process-type>myworkflow</process-type>
<process-variables>
<process-variable>
<filter-pattern>*.pdf</filter-pattern>
<process-variable-type>mappe</process-variable-type>
<process-variable-name>inputdocmap</process-variable-name>
<process-variable-datatype>document</process-variable-datatype>
<process-input>true</process-input>
</process-variable>
</process-variables>
</process-config>
Le contenu du fichier JobConfig.xml est associé aux variables et aux actions définies dans le processus de
Noeud
process-config process-type
Description
Racine du fichier de configuration du travail.
Nom du type de processus de flux de production. Cette valeur doit correspondre à la valeur spécifiée dans le processus de flux de travail de LiveCycle Workflow Designer.
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Appel de LiveCycle Assembler à l'aide de LiveCycle Workflow et de Watched Folder
Préparation des fichiers PDF et DDX 112
Noeud
process-variables process-variable filter-pattern process-variable-type process-variable-name process-variable-datatype process-input
Description
Contient plusieurs nœuds de variable de processus.
Chaque nœud process-variable est associé à une variable intégrée au processus de flux de production. Ses sous-éléments spécifient les valeurs de propriété de chaque variable du processus.
Modèle utilisé pour filtrer tous les fichiers à partir de l'ensemble des fichiers entrants définis pour la variable de processus. Ce modèle correspond au type de fichiers à traiter en rapport avec la variable.
Type de variable d'entrée : unique, liste ou mappe.
Dans l'exemple ci-dessus, la variable
<inputdocmap>
possède le type liste
car elle spécifie un ensemble de documents (tous les fichiers qui seront placés dans le dossier de contrôle). Le type unique
est utilisé pour la variable
<inputddx>
car un seul fichier est intégré.
Nom de la variable de flux de production telle que définie dans le flux de production. Dans l'exemple ci-dessus, les noms de variable
correspondent aux noms créés à la section « Configuration d'un
QPAC Assembler dans un processus de flux de production », page 107
: inputdocmap
et inputddx
Type de flux de production. Deux types de variables sont pris en charge : document et xml. Ceci correspond à l'attribut containedtype
de la variable (et non à l'attribut collectiontype
).
Watched Folder n'utilise pas ce paramètre pour le moment. Laissez cette valeur définie sur true.
Pour plus d'informations sur la création du fichier JobConfig.xml, voir Aide sur l'administration de Watched
Folder.
Préparation des fichiers PDF et DDX
Les fichiers PDF fournis dans le répertoire d'entrée ou défini par le QPAC Assembler doivent correspondre à la valeur du modèle de fichier de l'élément source
du fichier DDX.
Si vous utilisez Watched Folder avec LiveCycle Assembler, vous devez indiquer la variable Input Document
sourceMatch
pour définir le modèle de fichier avec l'élément source. Pour plus d'informations sur la configuration du modèle d'expression rationnelle pour l'attribut sourceMatch
, voir Document Description XML Reference.
Par exemple, dans le fichier DDX, il est possible de spécifier la source PDF de plusieurs façons :
O
Modèle correspondant à des noms de fichier spécifiques :
<PDF source="mysource" sourceMatch="appendix[\d]+[.]pdf" select="1-last"/>
O
Modèle correspondant à une valeur générique :
<PDF source="mysource" sourceMatch=".+[.]pdf" select="1-last"/>
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Appel de LiveCycle Assembler à l'aide de LiveCycle Workflow et de Watched Folder
Soumission du travail LiveCycle Assembler pour traitement 113
Dans les exemples ci-dessus, le modèle correspond à n'importe quel fichier PDF d'entrée commençant par les caractères appendix
suivis d'un chiffre, puis de l'extension .pdf. La valeur générique correspond au moins à un fichier PDF d'entrée comprenant n'importe quel caractère incluant des chiffres et se terminant par .pdf.
Pour plus d'informations sur la configuration de l'élément source dans le fichier DDX, reportez-vous à la section sur la spécification de plusieurs flux d'entrée du guide Developing Applications for LiveCycle
Assembler et de Document Description XML Reference.
Soumission du travail LiveCycle Assembler pour traitement
Vous pouvez soumettre un travail LiveCycle Assembler à Watched Folder par le biais d'un programme utilisant un fichier de commandes qui transfère le produit contenant les fichiers requis au dossier de contrôle configuré. (Les instructions de création d'un fichier ou d'un script de commandes pour effectuer cette action ne sont pas abordées dans ce guide.) Vous pouvez également soumettre un travail manuellement en déplaçant ou en copiant l'ensemble des fichiers dans Watched Folder.
Si vous avez créé un flux de production LiveCycle Assembler dans LiveCycle Workflow Designer qui n'utilise pas Watched Folder, vous pouvez soumettre le travail pour traitement à l'aide d'une application cliente créée au moyen de l'API Java de LiveCycle Workflow. Pour plus d'informations sur le développement d'applications clientes personnalisées pour LiveCycle Workflow, consultez le guide
Developing Custom Applications for LiveCycle Workflow, disponible sur le kit de développement logiciel de
LiveCycle Workflow.
Vous pouvez également soumettre des travaux pour traitement à l'aide de nombreux mécanismes disponibles avec LiveCycle Workflow, comme les services Web, la messagerie électronique et les files d'attente de messages ou des formulaires en ligne. Pour plus d'informations, consultez les guides
Developing Custom Applications for LiveCycle Workflow et Developing Custom QPACs.
Remarque :
lorsque le partage NFS est configuré pour Watched Folder, les fichiers temporaires et les répertoires liés aux travaux Watched Folder sont placés dans le répertoire de stockage global, mais ils ne sont pas automatiquement supprimés une fois le traitement des travaux terminé.
Pour éviter tout problème de performances, vous devez régulièrement supprimer les fichiers portant le nom Session
[NNNN]
, où NNNN correspond à l'identifiant du processus de flux de production du répertoire de stockage global.
L'emplacement par défaut du répertoire de stockage global est le suivant :
{RepTemp]/AdobeDocumentStorage/global. Si [RepTemp] n'est pas spécifié par l'utilisateur dans Configuration Manager, l'emplacement par défaut est java.io.tmpdir.
D
Développement de formulaires pour LiveCycle
Cette annexe contient des informations destinées aux développeurs de formulaires et décrit l'utilisation de
WebDAV avec LiveCycle Form Manager et les éléments requis par les produits LiveCycle pour les différents types de formulaires.
Publication de fichiers à partir de logiciels clients
Les développeurs et les propriétaires de formulaires peuvent utiliser des logiciels clients compatibles
WebDAV pour publier leurs fichiers dans le référentiel des produits LiveCycle utilisé par LiveCycle
Form Manager et y accéder.
Pour que vous puissiez utiliser WebDAV, votre ordinateur doit exécuter un logiciel de gestion de fichiers
(comme l'explorateur Microsoft Windows) pouvant se connecter aux serveurs WebDAV.
Pour créer une connexion à un répertoire WebDAV, vous devez indiquer l'URL de ce dernier. L'adresse ci-après est l'URL par défaut du référentiel de LiveCycle Form Manager : http://[nomhôte]:[port]/appstore/Forms
[nomhôte]
correspond au nom de l'ordinateur exécutant les produits LiveCycle et [port] correspond au port utilisé pour les produits LiveCycle.
Par exemple, supposons que les développeurs de votre entreprise utilisent LiveCycle Designer pour créer des formulaires. Ils souhaitent utiliser la commande de menu Publier de LiveCycle Designer pour copier leurs formulaires et les fichiers correspondants dans le référentiel des produits LiveCycle. Cependant, ils utilisent d'abord l'explorateur Windows pour ajouter un favori réseau créant une connexion à l'URL du référentiel des produits LiveCycle. Cette connexion s'affiche dans les Favoris réseau sous forme de dossier.
Après avoir ajouté ce favori, les développeurs peuvent l'utiliser pour publier des fichiers dans le référentiel.
Conception de formulaires pour les produits LiveCycle
L'utilisation de formulaires avec les produits LiveCycle peut exiger certaines conditions : conception particulière du formulaire, configuration spéciale des produits LiveCycle, voire les deux. Certaines exigences spécifiques s'appliquent à l'utilisation des types de formulaires suivants avec les produits
LiveCycle :
O
Formulaires dynamiques
O
O
O
Formulaires compatibles PDF/A
Formulaires comprenant des formulaires secondaires
Formulaires PDF créés avec Acrobat
Pour plus de détails sur la conception des formulaires à utiliser avec LiveCycle Workflow, consultez le guide
Création de flux de production, installé avec LiveCycle Workflow.
114
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Développement de formulaires pour LiveCycle
Utilisation de formulaires dynamiques avec les produits LiveCycle 115
Utilisation de formulaires dynamiques avec les produits LiveCycle
Les formulaires dynamiques peuvent être développés ou réduits pour contenir la quantité de données saisies. Ils comprennent généralement des boutons permettant d'obtenir les données requises à partir de
LiveCycle Forms. LiveCycle Forms affiche le formulaire contenant les données et le renvoie au client. Le navigateur du client est actualisé pour afficher le formulaire, qui a été développé ou réduit, en fonction du volume des nouvelles données.
Par exemple, certains formulaires permettent aux utilisateurs d'envoyer des requêtes à une base de données en indiquant des critères de recherche. Les données renvoyées s'affichent dans un tableau, sur le même formulaire ou dans un formulaire secondaire. Elles déterminent le nombre de lignes du tableau.
Pour soumettre une requête, l'utilisateur clique sur un bouton pour l'envoyer à LiveCycle Forms.
Les produits LiveCycle prennent en charge l'utilisation de deux types de boutons dans les formulaires dynamiques :
O un bouton mettant à jour les données du formulaire dynamique ;
O un bouton renvoyant un document PDF à un client qui peut alors enregistrer une copie de ce document sur son ordinateur ou l'imprimer.
Les produits LiveCycle différencient ces boutons au moyen de noms qui doivent être utilisés par les formulaires dynamiques. Vous pouvez utiliser les noms par défaut ou configurer les produits LiveCycle
(dans les pages Administrator) pour l'utilisation de noms différents.
Propriété Par défaut
Nom du bouton de nouveau rendu d'impression
RENDERAGAIN
Nom du bouton d'impression
PRINTFORM
Description et options
Ce nom indique aux produits LiveCycle qu'une requête est envoyée à LiveCycle Forms pour que celui-ci affiche le formulaire avec les données à jour.
Ce nom indique aux produits LiveCycle que le bouton crée un document PDF à partir du formulaire en cours et le renvoie à l'utilisateur final.
Intégration des polices dans un formulaire compatible PDF/A
Lors de la création d'une conception de formulaire dédiée à la création d'un formulaire compatible PDF/A de niveau 1B lors du rendu par LiveCycle Forms, toutes les polices utilisées doivent être intégrées à la conception du formulaire. Si les polices ne sont pas intégrées, le formulaire rendu n'est pas compatible
PDF/A de niveau 1B, bien qu'il s'agisse d'un formulaire PDF valide.
Il n'est possible d'intégrer à la conception du formulaire que les polices concédées sous licence pour la visualisation et l'impression. Les polices fournies dans le module Font Manager sont conformes à ces critères.
E
Désinstallation des produits LiveCycle
Ce chapitre décrit la procédure de désinstallation des fichiers produit LiveCycle installés à l'aide de la procédure d'installation manuelle ou clé en main.
Suppression des fichiers produit issus d'une installation clé en main
Chaque produit LiveCycle installé par le biais d'une installation clé en main comprend un programme de désinstallation permettant de supprimer le produit de votre ordinateur. Le programme de désinstallation ne supprime que le produit LiveCycle spécifié. Il ne supprime aucun fichier déployé sur le serveur d'applications ni aucun module partagé par d'autres produits LiveCycle.
La suppression des composants du produit ne supprime ni JBoss ni MySQL. Vous devez supprimer JBoss et
MySQL manuellement. Lorsque vous désinstallez ces services, vous pouvez toujours démarrer JBoss et
MySQL à partir de la ligne de commande.
Attention :
avant de supprimer MySQL, sauvegardez toutes vos données importantes.
³
Pour supprimer les fichiers produit :
1. Accédez au répertoire [racine produit]/_uninst/ et cliquez deux fois sur le fichier [racine
produit]_uninstall.exe. Sous Windows, vous pouvez utiliser l'option Ajout/Suppression de programmes du Panneau de configuration pour lancer le programme de désinstallation.
2. Lorsque vous y êtes invité, sélectionnez la langue souhaitée pour le programme de désinstallation et cliquez sur OK.
3. Suivez les instructions qui s'affichent, puis cliquez sur Terminer.
³
Pour supprimer les services JBoss et MySQL :
1. Vérifiez que les services JBoss et MySQL sont arrêtés. Pour arrêter le service JBoss pour Adobe LiveCycle
à partir d'une invite de commande, saisissez : net stop "JBoss for Adobe LiveCycle"
Pour arrêter le service MySQL pour Adobe LiveCycle à partir d'une invite de commande, saisissez : net stop "MySQL for Adobe LiveCycle"
2. Pour désinstaller manuellement le service JBoss pour Adobe LiveCycle, accédez au répertoire [racine
LiveCycle]/jboss/ et saisissez la commande suivante dans une invite :
JBossService.exe -uninstall "JBoss for Adobe LiveCycle"
3. (LiveCycle Workflow Business Activity Monitor) Désinstallez manuellement le service JBoss pour Adobe
LiveCycle Workflow BAM en accédant au répertoire [racine LiveCycle]/jboss/ et en saisissant la commande suivante dans une invite :
JBossService.exe -uninstall "JBoss for Adobe LiveCycle Workflow BAM"
116
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Désinstallation des produits LiveCycle
Suppression des fichiers produit issus d'une installation manuelle 117
4. Pour désinstaller manuellement le service MySQL pour Adobe LiveCycle, accédez au répertoire [racine
LiveCycle]/jboss/ et saisissez la commande suivante dans une invite :
JBossService.exe -uninstall "MySQL for Adobe LiveCycle"
Remarque :
si vous désinstallez plusieurs produits LiveCycle et que vous avez installé LiveCycle
Assembler ou LiveCycle PDF Generator en dernier, il existe deux exécutables de service :
JavaService.exe et JBossService.exe.
Suppression des fichiers produit issus d'une installation manuelle
Le programme de désinstallation situé dans le répertoire [racine produit] ne supprime aucun fichier déployé sur le serveur d'applications ni aucun module partagé par d'autres produits LiveCycle.
Attention :
l'exécution du programme de désinstallation risque de supprimer l'ensemble du contenu du répertoire d'installation du produit sans autre forme d'avertissement. Avant de continuer, sauvegardez toutes les données importantes.
³
Pour supprimer les fichiers de l'ordinateur :
1. Accédez au répertoire [racine produit]/_uninst/, puis lancez le programme de désinstallation.
O
O
(Windows) Cliquez deux fois sur le fichier .exe. Vous pouvez également utiliser la fonction
Ajout/Suppression de programmes.
(Linux) Ouvrez une invite de commande et saisissez :
file_name.bin
2. Lorsque vous y êtes invité, sélectionnez la langue souhaitée pour le programme de désinstallation et cliquez sur OK.
3. Suivez les instructions qui s'affichent, puis cliquez sur Terminer.
F
Mise à niveau des produits LiveCycle vers la version 7.2 ou 7.2.1
Ce chapitre décrit les tâches inhérentes à la mise à niveau des produits LiveCycle vers la version 7.2 ou la version 7.2.1 pour LiveCycle Assembler et LiveCycle Workflow.
Ce document doit être utilisé avec le guide Installation et configuration de LiveCycle ou le guide Installation
et configuration des produits de sécurité LiveCycle pour votre serveur d'applications. Ce document mentionne certaines sections de ces guides d'installation et de configuration lorsque des compléments d'information sont disponibles.
Pour consulter une liste des plates-formes prises en charge et des configurations requises pour les produits LiveCycle 7.2, reportez-vous au chapitre « Avant l'installation » de ce guide.
Ce chapitre utilise les conventions de désignation suivantes pour les chemins d'accès aux fichiers courants :
[racine LiveCycle] désigne l'emplacement d'installation des produits et composants LiveCycle antérieurs aux versions 7.2 ou 7.2.1.
[racine LiveCycle72] désigne l'emplacement d'installation des produits et composants LiveCycle des versions 7.2 ou 7.2.1.
Les guides Installation et configuration de LiveCycle concernent les produits suivants :
O
LiveCycle Assembler 7.2.1
O
O
Adobe LiveCycle Forms 7.2
Adobe LiveCycle Form Manager 7.2
O
O
O
O
Adobe LiveCycle PDF Generator 7.2
Adobe LiveCycle Print 7.2
Adobe LiveCycle Print 7.2.1
Adobe LiveCycle Workflow Designer 7.2.1
O
Watched Folder 1.1
Les guides Installation et configuration des produits de sécurité LiveCycle concernent les produits suivants :
O
O
O
Adobe LiveCycle Document Security 7.2
Adobe LiveCycle Reader Extensions 7.2
Adobe LiveCycle Policy Server 7.2
Procédures de mise à niveau
Cette section décrit les procédures à suivre lorsque vous mettez à niveau des produits LiveCycle vers la version 7.2 ou 7.2.1.
118
Adobe LiveCycle
Mise à niveau des produits LiveCycle
Mise à niveau des produits LiveCycle vers la version 7.2 ou 7.2.1
Mise à niveau de votre serveur d'applications 119
Mise à niveau de votre serveur d'applications
Assurez-vous d'appliquer les correctifs et Fix Packs nécessaires sur le serveur d'applications sur lequel vous exécutez les produits LiveCycle et procurez-vous les mises à jour des pilotes de base de données. Votre environnement doit correspondre à la configuration système requise décrite dans la section « Logiciels pris en charge » de ce guide.
Utilisation d'installations clé en main ou automatiques pour la mise à niveau
Pour des installations à des fins de déploiement sur WebSphere ou WebLogic, vous pouvez utiliser Configuration
Manager pour configurer et déployer le produit, initialiser la base de données et vérifier le déploiement.
Vous devez annuler le déploiement des composants LiveCycle existants et redémarrer le serveur d'applications avant d'utiliser Configuration Manager pour configurer automatiquement les produits
LiveCycle.
Pour des installations à des fins de déploiement sur JBoss, vous pouvez configurer les produits pour le déploiement et initialiser la base de données à l'aide de Configuration Manager, mais vous devez déployer manuellement les composants du produit. L'option d'installation clé en main est prise en charge uniquement pour la mise à niveau de LiveCycle Reader Extensions.
Si vous exécutez des produits LiveCycle initialement installés avec l'option d'installation clé en main, vous pouvez procéder à la mise à niveau vers la version 7.2 ou 7.2.1 en appliquant les instructions de mise à niveau manuelle ou de configuration automatique fournies dans ce guide. Ce chapitre inclut également les instructions de mise à niveau de LiveCycle Reader Extensions avec l'option d'installation clé en main.
Configuration à l'aide de Configuration Manager durant le processus de mise à niveau
Il est recommandé de ne pas configurer automatiquement le serveur d'applications WebSphere ou
WebLogic à l'aide de Configuration Manager car l'opération pourrait écraser les paramètres de configuration actuels sur votre serveur d'applications.
Lors du processus de mise à niveau, vous devez configurer certaines propriétés d'exécution du produit et du serveur d'applications à l'aide de Configuration Manager. Pour les mises à niveau à partir des versions 7.x, vous devez configurer le produit mis à niveau en utilisant les mêmes valeurs de propriétés.
Le chapitre « Configuration de produits LiveCycle pour le déploiement » des guides Installation et
configuration fournit des informations sur les propriétés que vous devez configurer lors de la mise à niveau du produit.
Résumé du processus de mise à niveau manuelle
Cet aide-mémoire décrit les tâches de haut niveau à effectuer pour exécuter une mise à niveau à partir d'un produit LiveCycle 7.x vers un produit LiveCycle 7.2 ou 7.2.1. Pour des informations détaillées, reportez-vous aux procédures de mise à niveau spécifiques au produit à mettre à niveau.
Les sections indiquées dans la colonne « Voir » se trouvent dans les guides Installation et configuration de votre serveur d'applications, selon le produit installé.
Tâche Voir
Adobe LiveCycle
Mise à niveau des produits LiveCycle
Mise à niveau des produits LiveCycle vers la version 7.2 ou 7.2.1
LiveCycle Forms et LiveCycle Print 120
Sauvegarder la base de données contenant la configuration LiveCycle actuelle et les données d'exécution.
Sauvegarder des copies des fichiers LiveCycle EAR et
WAR actuellement déployés dans un répertoire séparé.
(JBoss) Arrêter les services, le cas échéant (JBoss pour
Adobe LiveCycle, MySQL pour Adobe LiveCycle,
JBoss pour Workflow BAM, AdobeDocumentSecurity ou AdobeReaderExtensions).
Annuler le déploiement des composants LiveCycle du serveur d'applications.
Désinstaller la version précédente des produits
LiveCycle à l'aide du programme de désinstallation.
Appliquer les correctifs et Fix Packs nécessaires sur le serveur d'applications et obtenir les pilotes de base de données mis à jour.
Installer le produit LiveCycle 7.2 ou 7.2.1 dans un emplacement (autre que celui par défaut) de votre système de fichiers. Effectuer l'installation dans un emplacement différent de celui de vos produits
LiveCycle précédents.
Exécuter Configuration Manager pour configurer le produit. Appliquer les données de configuration utilisées dans l'installation d'origine. Pour
WebSphere et WebLogic, vous pouvez déployer automatiquement le produit, initialiser la base de données et vérifier le déploiement à l'aide de
Configuration Manager.
(JBoss) Déployer les composants du produit sur le serveur d'applications.
(JBoss) Exécuter Configuration Manager pour initialiser la base de données.
La documentation du serveur de bases de données
La documentation du serveur d'applications.
Le chapitre « Désinstallation des produits
LiveCycle »
La section « Logiciels pris en charge » du chapitre « Avant l'installation »
Le chapitre « Installation des produits
LiveCycle »
(JBoss) Le chapitre « Configuration de produits LiveCycle pour le déploiement »
(WebLogic, WebSphere) Le chapitre
« Configuration automatique des produits
LiveCycle » ou « Configuration de produits
LiveCycle pour le déploiement »
Le chapitre « Déploiement manuel sur JBoss »
Le chapitre « Initialisation de la base de données »
LiveCycle Forms et LiveCycle Print
Cette section contient des instructions de mise à niveau pour LiveCycle Forms 7.2 et LiveCycle Print 7.2.
Remarque :
vous devez installer LiveCycle Forms 7.2 avant d'installer LiveCycle Print 7.2.
Mise à niveau à partir de Adobe Form Server 6.0 vers LiveCycle Forms 7.2
Cette procédure explique comment effectuer une mise à niveau à partir de Adobe Form Server 6.0 vers
LiveCycle Forms 7.2.
Adobe LiveCycle
Mise à niveau des produits LiveCycle
Mise à niveau des produits LiveCycle vers la version 7.2 ou 7.2.1
LiveCycle Forms et LiveCycle Print 7.x vers LiveCycle Forms et LiveCycle Print 7.2 121
³
Pour effectuer une mise à niveau à partir de Adobe Form Server 6.0 vers LiveCycle Forms 7.2 :
1. Annulez le déploiement du produit précédent sur le serveur d'applications. (Pour en savoir plus, reportez-vous à la documentation de votre serveur d'applications.)
2. Désinstallez le produit précédent à l'aide du programme de désinstallation. (Pour en savoir plus, reportez-vous au guide Installation et configuration de Form Server 6.0.)
3. Mettez à niveau le serveur d'applications et la base de données de sorte qu'ils répondent à la configuration système et logicielle requise pour les produits LiveCycle 7.2.
4. Installez et déployez LiveCycle Forms 7.2, initialisez la base de données en suivant les instructions de ce document relatives à l'option d'installation et de déploiement manuels. Pour WebSphere et WebLogic, vous pouvez déployer automatiquement le produit, initialiser la base de données et vérifier le déploiement à l'aide de Configuration Manager.
Remarque :
si User Management ne figure pas dans l'installation et la configuration de LiveCycle Forms, il n'est pas nécessaire de vous connecter à une base de données, ni d'en suivre les procédures d'initialisation.
LiveCycle Forms et LiveCycle Print 7.x vers LiveCycle Forms et
LiveCycle Print 7.2
Cette procédure décrit la procédure de mise à niveau à partir de LiveCycle Forms 7.0 ou 7.1 vers LiveCycle
Forms 7.2, et de LiveCycle Print 7.1 vers LiveCycle Print 7.2.
Nous vous conseillons d'installer LiveCycle Forms 7.2 dans un nouveau répertoire afin de ne pas écraser la version précédente.
³
Pour récupérer les propriétés de configuration de formulaires (pour LiveCycle Forms 7.0 ou 7.1 configurés
sans User Management) :
1. Saisissez l'URL suivante dans un navigateur Web : http://[nom_hôte]:[port]/FormServerAdmin/settings.html
Le port par défaut pour WebLogic est 7001. Si vous exécutez un serveur géré, vous avez peut-être configuré le serveur d'applications de manière à utiliser un autre numéro de port, tel que 8001. Le port par défaut pour WebSphere est 9080 ; le port par défaut pour JBoss est 8080.
2. Notez les paramètres apparaissant sur cette page.
³
Pour récupérer les propriétés de configuration de formulaires (pour LiveCycle Forms 7.0 ou 7.1 configurés
avec User Management) :
1. Saisissez l'URL suivante dans un navigateur Web : http://[nom_hôte]:[port]/adminui
Le port par défaut pour WebLogic est 7001. Si vous exécutez un serveur géré, vous avez peut-être configuré le serveur d'applications de manière à utiliser un autre numéro de port, tel que 8001. Le port par défaut pour WebSphere est 9080 ; le port par défaut pour JBoss est 8080.
2. Connectez-vous à Administrator.
3. Cliquez sur Services, puis sur Adobe LiveCycle Forms.
Adobe LiveCycle
Mise à niveau des produits LiveCycle
Mise à niveau des produits LiveCycle vers la version 7.2 ou 7.2.1
LiveCycle Forms et LiveCycle Print 7.x vers LiveCycle Forms et LiveCycle Print 7.2 122
4. Notez les paramètres apparaissant sur cette page.
5. Vous devez définir ces propriétés pour la nouvelle installation sur l'écran de configuration du module
Form Server de Configuration Manager, lorsque vous installez et configurez LiveCycle Forms 7.2.
³
Pour procéder à la mise à niveau vers LiveCycle Forms 7.2 et LiveCycle Print 7.2 :
1. Sauvegardez la base de données contenant actuellement les données de configuration et d'exécution de LiveCycle Forms 7.0 ou 7.1.
2. Assurez-vous de posséder une copie des fichiers LiveCycle EAR et WAR actuellement déployés, configurés pour le système opérationnel à mettre à niveau.
3. Sauvegardez les fichiers XDC à partir de LiveCycle Print 7.1.
4. (JBoss) Si votre déploiement de LiveCycle s'exécute sur un serveur d'applications JBoss avec une base de données MySQL installée au moyen de l'option d'installation clé en main, arrêtez le service JBoss pour Adobe LiveCycle et le service MySQL pour Adobe LiveCycle.
5. Annulez le déploiement des fichiers suivants sur votre serveur d'applications :
O
O
O
O
LiveCycle.ear
FormsIVS.ear
adobe-FontManager.war
LCMBootstrapper.war
O adobe-printSubmitter.ear (LiveCycle Print uniquement)
Pour en savoir plus sur l'annulation du déploiement de WebLogic ou WebSphere, reportez-vous à
« Désinstallation des fichiers EAR » dans le guide Installation et configuration de LiveCycle.
Remarque :
lorsque le déploiement du fichier Livecycle.ear est annulé, LiveCycle Print 7.1 ne fonctionne pas.
6. Arrêtez le serveur d'applications WebSphere ou WebLogic Server.
7. Désinstallez les versions précédentes des produits LiveCycle à l'aide du programme de désinstallation.
(Voir « Désinstallation des produits LiveCycle » dans le guide Installation et configuration de LiveCycle correspondant.)
8. Mettez à niveau le serveur d'applications et la base de données de sorte qu'ils répondent à la configuration système et logicielle requise pour LiveCycle Forms 7.2.
9. Installez LiveCycle Forms 7.2 dans un répertoire (autre que celui par défaut), par exemple
C:\Adobe\LiveCycle72\ ou /opt/adobe/livecycle72/. Suivez les instructions du chapitre « Installation des produits LiveCycle » dans le guide Installation et configuration de LiveCycle.
Remarque :
si vous effectuez l'installation ou la mise à niveau de plusieurs produits LiveCycle 7.2, assurez-vous de les installer dans le même répertoire racine [racine LiveCycle72].
10. Copiez le fichier DocumentServicesLibrary.jar, selon votre serveur d'applications :
O
(WebLogic) Du répertoire [racine LiveCycle72]/components/csa/weblogic/lib/adobe vers le répertoire [domaine du serveur d'applications]//lib.
O
(WebSphere) Du répertoire [racine LiveCycle72]/components/csa/websphere/lib/adobe vers le répertoire [racine du serveur d'applications]/optionalLibraries.
Adobe LiveCycle
Mise à niveau des produits LiveCycle
Mise à niveau des produits LiveCycle vers la version 7.2 ou 7.2.1
LiveCycle Forms et LiveCycle Print 7.x vers LiveCycle Forms et LiveCycle Print 7.2 123
O
(JBoss) Du répertoire [racine LiveCycle72]/components/csa/jboss/lib/adobe vers le répertoire [racine du serveur d'applications]/server/all/lib.
Remarque :
modifiez les fichiers XDC installés avec LiveCycle Print 7.2 de sorte qu'ils correspondent à ceux utilisés avec la version 7.1, puis utilisez ces fichiers modifiés. Pour en savoir plus sur les fichiers XDC inclus avec LiveCycle Print, reportez-vous au guide Getting Started et au guide Edition de fichiers XDC pour personnaliser les flux d'impression de LiveCycle Print.
11. Lancez le serveur d'applications.
12. Configurez LiveCycle Forms 7.2 à l'aide de Configuration Manager. (Voir le chapitre « Configuration de produits LiveCycle pour le déploiement » du guide Installation et configuration de LiveCycle.) Dans les différents écrans de Configuration Manager, choisissez les options suivantes :
O
O
O
Type de configuration : sélectionnez Assistant de configuration personnalisée.
Sélection du produit : sélectionnez le serveur d'applications utilisé, ainsi que Plate-forme,
LiveCycle Forms, et LiveCycle Print (le cas échéant).
Sélection d'Adobe User Management : sélectionnez l'une des options suivantes :
O
O
O
LiveCycle Forms avec User Management et Administrator si vous utilisiez LiveCycle Forms avec User Management dans le déploiement précédent
LiveCycle Forms sans User Management ni Administrator si vous n'utilisiez pas LiveCycle
Forms avec User Management
Choix de la tâche : sélectionnez les options suivantes :
O
Configurer et assembler les produits
O
Démarrer la base de données (uniquement si vous intégrez User Management dans la configuration)
Pour WebSphere et WebLogic, sélectionnez également ces options :
O
Déployer les produits
O
Vérifier les produits déployés
13. Suivez les instructions des derniers écrans de Configuration Manager. Acceptez les valeurs par défaut dans Configuration Manager, que votre configuration soit avec User Management et Administrator ou sans User Management ni Administrator.
Remarque :
lorsque vous êtes invité à spécifier l'emplacement du répertoire de stockage global, indiquez l'emplacement que vous utilisez actuellement pour ce répertoire.
Si le déploiement a lieu sur WebSphere ou WebLogic, procédez aux étapes 14 et 15. Si le déploiement a lieu sur JBoss, procédez aux étapes 16 et 17.
14. (WebSphere et WebLogic) Dans l'écran de confirmation des produits à déployer, sélectionnez ces fichiers EAR :
O
O
LiveCycle.ear
adobe-FontManager.ear.
O adobe-printSubmitter.ear (LiveCycle Print uniquement)
15. (WebSphere et WebLogic) Suivez les instructions des écrans de Configuration Manager pour initialiser la base de données et vérifier les produits déployés.
Adobe LiveCycle
Mise à niveau des produits LiveCycle
Mise à niveau des produits LiveCycle vers la version 7.2 ou 7.2.1
LiveCycle Forms et LiveCycle Print 7.x vers LiveCycle Forms et LiveCycle Print 7.2 124
16. (JBoss) Déployez LiveCycle Forms 7.2. (Voir « Déploiement manuel sur JBoss » dans le guide Installation
et configuration de LiveCycle.)
17. (JBoss) (configuration de User Management) Exécutez Configuration Manager pour initialiser la base de données. Sélectionnez Assistant de configuration personnalisée, puis Démarrer la base de
données.
Remarque :
l'initialisation de la base de données est nécessaire pour ajouter de nouvelles colonnes de tables au schéma de la base de données. L'initialisation de la base de données ne modifie pas les données existantes.
18. Déployez les fichiers FormsIVS.ear en appliquant les procédures correspondant à votre serveur d'applications. (Voir « Tâches de post-déploiement de LiveCycle Forms » dans le guide Installation et
configuration de LiveCycle.)
19. Vérifiez le déploiement en suivant les instructions de la section « Tâches de post-déploiement de
LiveCycle Forms » dans le guide Installation et configuration de LiveCycle.
20. Mettez à jour la zone Class Path de l'application en spécifiant l'emplacement des fichiers JAR : formserver-client.jar, adobe-common.jar, datamanager-client.jar et AdobeCSAUtils.jar. Ajoutez le fichier um-client.jar à la zone Class Path de l'application si l'application transmet un objet
InvocationContext
dans l'API du module Form Server. Pour en savoir plus sur ces fichiers, reportez-vous au guide « Developing Custom Applications » situé dans le répertoire [racine
LiveCycle72]/forms/documentation.
³
Pour configurer LiveCycle Forms (si vous n'utilisez pas User Management) :
1. Saisissez l'URL suivante dans un navigateur Web :
http://[nom_hôte]:[port]/FormServerAdmin//settings.html
Le port par défaut pour WebLogic est 7001. Si vous exécutez un serveur géré, vous avez peut-être configuré le serveur d'applications de manière à utiliser un autre numéro de port, tel que 8001. Le port par défaut pour WebSphere est 9080 ; le port par défaut pour JBoss est 8080.
2. Entrez les paramètres notés lors de la récupération des paramètres de configuration de LiveCycle
.
3. Cliquez sur Enregistrer.
Remarque :
les paramètres modifiés ici ne sont pas conservés lors du redémarrage du serveur d'applications.
³
Pour configurer LiveCycle Forms (si vous utilisez User Management) :
1. Saisissez l'URL suivante dans un navigateur Web : http://[nom_hôte]:[port]/adminui
2. Le port par défaut pour WebLogic est 7001. Si vous exécutez un serveur géré, vous avez peut-être configuré le serveur d'applications de manière à utiliser un autre numéro de port, tel que 8001. Le port par défaut pour WebSphere est 9080 ; le port par défaut pour JBoss est 8080.
3. Connectez-vous à Administrator.
Adobe LiveCycle
Mise à niveau des produits LiveCycle
Mise à niveau des produits LiveCycle vers la version 7.2 ou 7.2.1
LiveCycle Form Manager 125
4. Cliquez sur Services, puis sur Adobe LiveCycle Forms.
5. Entrez les paramètres notés lors de la récupération des paramètres de configuration de LiveCycle
.
6. Cliquez sur Enregistrer.
LiveCycle Form Manager
Cette section fournit des instructions pour mettre à niveau LiveCycle Form Manager 7.0.1 vers LiveCycle
Form Manager 7.2. Pour effectuer cette mise à niveau, vous devez mettre à jour les composants de serveur déployés sur le serveur d'applications et initialiser la base de données.
Nous vous conseillons d'installer LiveCycle Form Manager 7.2 dans un nouveau répertoire afin de ne pas
écraser la version précédente.
³
Pour mettre à niveau LiveCycle Form Manager de la version 7.0.1 vers la version 7.2 :
1. Sauvegardez la base de données contenant actuellement les données de configuration et d'exécution de LiveCycle Form Manager 7.0.1.
2. Assurez-vous de posséder une copie des fichiers LiveCycle EAR et WAR actuellement déployés, configurés pour le système opérationnel à mettre à niveau.
3. (JBoss) Si votre déploiement de LiveCycle s'exécute sur un serveur d'applications JBoss avec une base de données MySQL installée au moyen de l'option d'installation clé en main, arrêtez le service JBoss pour Adobe LiveCycle et le service MySQL pour Adobe LiveCycle.
4. Annulez le déploiement des composants LiveCycle Form Manager 7.0.1 suivants en appliquant les instructions du guide Installation et configuration de LiveCycle Form Manager 7.0.1 :
O
O adobe-FontManager.war
LiveCycle.ear
O
LCMBootstrapper.war
Pour en savoir plus sur l'annulation du déploiement de WebLogic ou WebSphere, reportez-vous à
« Désinstallation des fichiers EAR » dans le guide Installation et configuration de LiveCycle.
5. Arrêtez le serveur d'applications WebSphere ou WebLogic Server.
6. Désinstallez la version précédente des produits LiveCycle à l'aide du programme de désinstallation.
(Voir « Désinstallation des produits LiveCycle » dans le guide Installation et configuration de LiveCycle correspondant.)
7. Mettez à niveau le serveur d'applications et la base de données de sorte qu'ils répondent à la configuration système et logicielle requise pour les produits LiveCycle 7.2.
8. Installez LiveCycle Form Manager 7.2 dans un répertoire (autre que celui par défaut), par exemple
C:\Adobe\LiveCycle72\ ou /opt/adobe/livecycle72/. Suivez les instructions du chapitre « Installation des produits LiveCycle » dans le guide Installation et configuration de LiveCycle.
Adobe LiveCycle
Mise à niveau des produits LiveCycle
Mise à niveau des produits LiveCycle vers la version 7.2 ou 7.2.1
LiveCycle Form Manager 126
Remarque :
si vous effectuez l'installation ou la mise à niveau de plusieurs produits LiveCycle 7.2, assurez-vous de les installer dans le même répertoire [racine LiveCycle72].
9. Copiez le fichier DocumentServicesLibrary.jar, selon votre serveur d'applications :
O
(WebLogic) Du répertoire [racine LiveCycle72]/components/csa/weblogic/lib/adobe vers le répertoire [racine du domaine du serveur d'applications]//lib.
O
O
(WebSphere) Du répertoire [racine LiveCycle72]/components/csa/websphere/lib/adobe vers le répertoire [racine du serveur d'applications]/optionalLibraries.
(JBoss) Du répertoire [racine LiveCycle72]/components/csa/jboss/lib/adobe vers le répertoire [racine du serveur d'applications]/server/all/lib.
10. Lancez le serveur d'applications.
11. Configurez LiveCycle Form Manager 7.2 à l'aide de Configuration Manager. (Voir le chapitre
« Configuration de produits LiveCycle pour le déploiement » du guide Installation et configuration de
LiveCycle.) Dans les différents écrans de Configuration Manager, choisissez les options suivantes :
O
O
Type de configuration : sélectionnez Assistant de configuration personnalisée.
Sélection du produit : sélectionnez le serveur d'applications utilisé, ainsi que Plate-forme et le produit en cours de configuration.
O
Choix de la tâche : sélectionnez les options suivantes :
O
Configurer et assembler les produits
O
Démarrer la base de données
Pour WebSphere et WebLogic, sélectionnez également ces options :
O
Déployer les produits
O
Vérifier les produits déployés
12. Suivez les instructions des écrans de Configuration Manager pour configurer le fichier LiveCycle.ear.
Assurez-vous de configurer votre fichier EAR de LiveCycle 7.2 avec les mêmes paramètres que ceux choisis pour la version 7.0.1. Si le déploiement a lieu sur WebSphere ou WebLogic, procédez aux
étapes 13 et 14. Si le déploiement a lieu sur JBoss, procédez aux étapes 15 et 16.
Remarque :
lorsque vous êtes invité à spécifier l'emplacement du répertoire de stockage global, indiquez l'emplacement que vous utilisez actuellement pour ce répertoire.
13. (WebSphere et WebLogic) Dans l'écran de confirmation des produits à déployer, sélectionnez ces fichiers EAR :
O
O
LiveCycle.ear
adobe-FontManager.ear
14. (WebSphere et WebLogic) Suivez les instructions des écrans de Configuration Manager pour initialiser la base de données et vérifier les produits déployés.
15. (JBoss) Déployez les composants LiveCycle Form Manager 7.2. (Voir « Déploiement manuel sur JBoss » dans le guide Installation et configuration de LiveCycle.)
16. (JBoss) Exécutez Configuration Manager pour initialiser la base de données. Sélectionnez Assistant de
configuration personnalisée, puis Démarrer la base de données. (Voir « Initialisation de la base de données » dans le guide Installation et configuration de LiveCycle.)
Adobe LiveCycle
Mise à niveau des produits LiveCycle
Mise à niveau des produits LiveCycle vers la version 7.2 ou 7.2.1
LiveCycle Assembler, LiveCycle Workflow et Watched Folder 127
Remarque :
l'initialisation de la base de données est nécessaire pour ajouter de nouvelles colonnes de tables au schéma de la base de données. L'initialisation de la base de données ne modifie pas les données existantes.
17. Vérifiez le déploiement en suivant les instructions de la section « Tâches de post-déploiement de
LiveCycle Form Manager » dans le guide Installation et configuration de LiveCycle.
Remarque :
vous pouvez également vérifier votre installation et votre configuration en utilisant les exemples fournis à l'adresse suivante : www.adobe.com/devnet/livecycle/samples.html
LiveCycle Assembler, LiveCycle Workflow et Watched Folder
Cette section décrit la procédure à suivre pour mettre à niveau les produits suivants :
O
LiveCycle Workflow 7.0.1 ou 7.2 vers LiveCycle Workflow 7.2.1
O
LiveCycle Assembler 7.2 vers LiveCycle Assembler 7.2.1
O
Watched Folder 1.0 vers Watched Folder 1.1
Si vous mettez à niveau LiveCycle Workflow en tant que produit autonome, ignorez les procédures relatives à Watched Folder ou à LiveCycle Assembler. Watched Folder doit être utilisé avec LiveCycle
Assembler et LiveCycle Workflow ; vous devez installer LiveCycle Workflow avant Watched Folder.
Pour effectuer cette mise à niveau, vous devez mettre à jour les composants de serveur déployés sur le serveur d'applications et initialiser la base de données. Nous vous conseillons d'installer LiveCycle
Assembler 7.2.1 dans un nouveau répertoire afin de ne pas écraser la version précédente.
Lorsque vous configurez LiveCycle Assembler 7.2.1 à l'aide de Configuration Manager, vérifiez que vous avez défini l'option Groupes de sécurité sur la même valeur que pour LiveCycle Assembler 7.2. (Cette valeur peut être un astérisque (*), ce qui autorise la connexion uniquement d'utilisateurs possédant une entrée valide dans le système LDAP, ou vous pouvez ne spécifier aucune valeur, ce qui autorise n'importe quel utilisateur à se connecter.)
³
Pour procéder à la mise à niveau vers LiveCycle Assembler 7.2.1, LiveCycle Workflow 7.2.1 et
Watched Folder 1.1 :
1. Sauvegardez la base de données contenant actuellement les données de configuration et d'exécution de LiveCycle Workflow 7.1 ou 7.2.
2. Assurez-vous de posséder une copie des fichiers LiveCycle EAR et WAR actuellement déployés, configurés pour le système opérationnel à mettre à niveau.
3. (JBoss) Si votre déploiement de LiveCycle s'exécute sur un serveur d'applications JBoss avec une base de données MySQL installée au moyen de l'option d'installation clé en main, arrêtez le service JBoss pour Adobe LiveCycle et le service MySQL pour Adobe LiveCycle.
4. Annulez le déploiement des fichiers suivants sur votre serveur d'applications :
O
O
O
LiveCycle.ear
adobe-FontManager.war
LCMBootstrapper.war
Adobe LiveCycle
Mise à niveau des produits LiveCycle
Mise à niveau des produits LiveCycle vers la version 7.2 ou 7.2.1
LiveCycle Assembler, LiveCycle Workflow et Watched Folder 128
O adobe-Assembler7.ear (LiveCycle Assembler uniquement)
Pour en savoir plus sur l'annulation du déploiement de WebLogic ou WebSphere, reportez-vous à
« Désinstallation des fichiers EAR » dans le guide Installation et configuration de LiveCycle.
5. (WebSphere et WebLogic) Arrêtez le serveur d'applications.
6. Désinstallez les versions précédentes des produits LiveCycle à l'aide du programme de désinstallation.
(Voir « Désinstallation des produits LiveCycle » dans le guide Installation et configuration de LiveCycle.)
7. Installez LiveCycle Assembler 7.2.1 dans un répertoire (autre que celui par défaut), par exemple
C:\Adobe\LiveCycle72\ ou /opt/adobe/livecycle72/. Suivez les instructions du chapitre « Installation des produits LiveCycle » dans le guide Installation et configuration de LiveCycle.
8. Installez LiveCycle Workflow 7.2.1 dans le même répertoire que LiveCycle Assembler 7.2.1 en suivant les instructions fournies dans « Installation des produits LiveCycle », dans le guide Installation et
configuration de LiveCycle associé.
Remarque :
vous pouvez installer LiveCycle Assembler et LiveCycle Workflow dans n'importe quel ordre.
9. Installez Watched Folder dans le même répertoire que LiveCycle Workflow en suivant les instructions fournies dans le chapitre « Installation de Watched Folder » du guide Installation et configuration de
LiveCycle. Vous devez avoir déjà installé LiveCycle Workflow.
Remarque :
si vous effectuez l'installation ou la mise à niveau de plusieurs produits LiveCycle 7.2, assurez-vous de les installer dans le même répertoire [racine LiveCycle72].
10. Copiez le fichier DocumentServicesLibrary.jar, selon votre serveur d'applications :
O
(WebLogic) Du répertoire [racine LiveCycle72]/components/csa/weblogic/lib/adobe vers le répertoire [domaine du serveur d'applications]//lib.
O
O
(WebSphere) Du répertoire [racine LiveCycle72]/components/csa/websphere/lib/adobe vers le répertoire [racine du serveur d'applications]/optionalLibraries.
(JBoss) Du répertoire [racine LiveCycle72]/components/csa/jboss /lib/adobe vers le répertoire [racine
du serveur d'applications]/server/all/lib. Copiez le fichier adobe-service.xml du répertoire
[racine_LiveCycle72]/ configurationManager/deploy/jboss vers le répertoire [racine du serveur
d'applications]/server/all/deploy/jms.
11. Lancez le serveur d'applications.
12. Configurez les produits LiveCycle à l'aide de Configuration Manager. (Voir le chapitre « Configuration de produits LiveCycle pour le déploiement » du guide Installation et configuration de LiveCycle.) Dans les différents écrans de Configuration Manager, choisissez les options suivantes :
O
O
Type de configuration : sélectionnez Assistant de configuration personnalisée.
Sélection du produit : sélectionnez le serveur d'applications utilisé, puis Plate-forme, ainsi que tous les produits que vous avez installés.
Adobe LiveCycle
Mise à niveau des produits LiveCycle
Mise à niveau des produits LiveCycle vers la version 7.2 ou 7.2.1
LiveCycle Assembler, LiveCycle Workflow et Watched Folder 129
O
Choix de la tâche : sélectionnez les options suivantes :
O
Configurer et assembler les produits
O
Démarrer la base de données
Pour WebSphere et WebLogic, sélectionnez également ces options :
O
O
Déployer les produits
Vérifier les produits déployés
13. Suivez les instructions des derniers écrans de Configuration Manager. Assurez-vous de configurer votre fichier LiveCycle 7.2.1 EAR avec les mêmes paramètres que ceux choisis pour la version 7.0.1 ou 7.2. Si le déploiement a lieu sur WebSphere ou WebLogic, procédez aux étapes 14 et 15. Si le déploiement a lieu sur JBoss, procédez aux étapes 16 et 17.
Remarque :
lorsque vous êtes invité à spécifier l'emplacement du répertoire de stockage global, indiquez l'emplacement que vous utilisez actuellement pour ce répertoire.
14. (WebSphere et WebLogic) Dans l'écran Confirmer les produits à déployer, sélectionnez les archives à déployer :
O
O
O adobe-FontManager.ear
LiveCycle.ear
adobe-Assembler7.ear (LiveCycle Assembler uniquement)
15. (WebSphere et WebLogic) Suivez les instructions des écrans de Configuration Manager pour initialiser la base de données et vérifier les produits déployés.
16. (JBoss) Déployez LiveCycle Assembler, LiveCycle Workflow et Watched Folder 7.2. (Voir « Déploiement manuel sur JBoss » dans le guide Installation et configuration de LiveCycle.) Ces composants contiennent les fichiers EAR suivants :
O
O
LiveCycle.ear
adobe-FontManager.ear
O
O
LCM.ear
adobe-Assembler7.ear
17. (JBoss) Exécutez Configuration Manager pour réinitialiser la base de données. Sélectionnez Assistant
de configuration personnalisée, puis Démarrer la base de données. (Voir « Initialisation de la base de données » dans le guide Installation et configuration de LiveCycle.)
18. Mettez à niveau Assembler QPAC. (Voir le guide Upgrading LiveCycle Workflow Designer ou Création de
flux de production, disponibles dans la documentation de LiveCycle Workflow.)
Remarque :
l'initialisation de la base de données est nécessaire pour ajouter de nouvelles colonnes de tables au schéma de la base de données. L'initialisation de la base de données ne modifie pas les données existantes.
19. Vérifiez le déploiement en suivant les instructions de la section « Après le déploiement » dans le guide
Installation et configuration de LiveCycle.
Remarque :
vous pouvez également vérifier votre installation et votre configuration en utilisant les exemples fournis à l'adresse suivante : www.adobe.com/devnet/livecycle/samples.html
Adobe LiveCycle
Mise à niveau des produits LiveCycle
Mise à niveau des produits LiveCycle vers la version 7.2 ou 7.2.1
LiveCycle Workflow Designer 130
LiveCycle Workflow Designer
Vous devez utiliser la version de LiveCycle Workflow Designer fournie par LiveCycle Workflow 7.2.1. Si vous souhaitez utiliser le nouveau User QPAC avec les flux de production existants, vous devez faire migrer vos flux de production.
Vous devez mettre à niveau vos QPAC LiveCycle de LiveCycle Workflow 7.0.1 ou 7.2 vers la version 7.2.1.
Voir « Mise à jour des composants » dans le guide Création de flux de production inclus avec LiveCycle
Workflow Designer.
³
Pour mettre à niveau LiveCycle Workflow Designer :
1. Désinstallez LiveCycle Workflow 7.0.1 Designer.
2. Installez LiveCycle Workflow 7.2.1 Designer. (Voir « Installation de LiveCycle Workflow Designer » dans le guide Installation et configuration de LiveCycle.)
Remarque :
LiveCycle Workflow 7.2.1 fournit un User QPAC mis à jour incluant de nouvelles fonctionnalités. Si l'un de vos flux de production comprend des actions User et que vous souhaitez utiliser ces nouvelles fonctionnalités, vous devez faire migrer vos flux de production. Pour en savoir plus, reportez-vous à la section sur la migration de flux de production à partir des versions précédentes dans le guide Création de flux de production ou l'Aide de LiveCycle Workflow Designer.
BAM Server pour LiveCycle Workflow
Cette section décrit les pratiques générales recommandées pour la mise à niveau vers une nouvelle version de BAM Server. Vous devez utiliser l'utilitaire de mise à niveau de BAM Server pour mettre à niveau les fichiers XML de métadonnées que vous exportez à partir du LiveCycle Workflow Business Activity
Monitor au cours de la mise à niveau.
La mise à niveau de BAM Server implique les tâches suivantes :
O
O
O
O
O
Exportation des métadonnées BAM à l'aide de BAM Workbench
Mise à niveau des métadonnées BAM à l'aide de l'utilitaire de mise à niveau de BAM Server
Annulation du déploiement du fichier EAR de BAM Server sur le serveur d'applications
Suppression des fichiers journaux de récupération et déplacement des tables existantes dans la base de métadonnées BAM
Déploiement du fichier EAR de BAM Server fourni par LiveCycle Workflow 7.2.1
O
Importation des métadonnées BAM mises à niveau à l'aide de BAM Workbench
A propos de l'utilitaire de mise à niveau de BAM Server
L'utilitaire de mise à niveau de BAM Server met à niveau les fichiers de métadonnées exportés de sorte qu'ils comprennent les nouvelles fonctions requises pour la version actuelle du produit.
Cet utilitaire est inclus dans le fichier cqupgrade.jar. Lorsque vous installez LiveCycle Workflow, ce fichier se trouve dans le répertoire [racine LiveCycle]/Workflow/bam/CQUpgrade.
Adobe LiveCycle
Mise à niveau des produits LiveCycle
Mise à niveau des produits LiveCycle vers la version 7.2 ou 7.2.1
A propos de l'utilitaire de mise à niveau de BAM Server 131
Remarque :
l'utilitaire de mise à niveau génère le message « Error parsing input file » lorsque les fichiers ne peuvent pas être mis à niveau. Si cette erreur est générée, le fichier spécifié dans le message est peut-être endommagé. Contactez Adobe Systems pour une assistance.
Syntaxe
La commande suivante permet de mettre à niveau les fichiers qui ont été exportés vers un fichier JAR : java -jar cqupgrade.jar -jar -i inJar.jar [-o outJar.jar]
Paramètres
Vous pouvez utiliser les paramètres suivants dans la commande de l'utilitaire de mise à niveau de BAM
Server :
inJar.jar
: chemin du fichier JAR contenant les métadonnées à mettre à niveau.
utJar.jar
(facultatif ) : chemin du fichier JAR mis à niveau. Si vous ne spécifiez pas ce paramètre, les fichiers mis à niveau sont enregistrés dans le fichier JAR spécifié dans
inJar.jar.
Les exemples suivants présentent des commandes que vous pouvez utiliser pour mettre à niveau les métadonnées stockées dans les fichiers JAR à l'aide de l'utilitaire de mise à niveau de BAM Server :
O
La commande suivante permet de mettre à niveau les fichiers de métadonnées stockés dans un fichier
JAR nommé toUpgrade.jar, situé dans le même répertoire que cqupgrade.jar :
O java -jar cqupgrade.jar -i toUpgrade.jar
La commande suivante permet de mettre à niveau les fichiers de métadonnées du fichier toUpgrade.jar et enregistre les fichiers mis à niveau dans un autre fichier JAR (upgraded.jar). Ce fichier est enregistré dans le même répertoire que cqupgrade.jar : java -jar cqupgrade.jar -i toUpgrade.jar -o upgraded.jar
³
Pour mettre à niveau Business Activity Monitor :
1. Connectez-vous à BAM Workbench.
2. Cliquez sur l'onglet Administration, puis sur Import/Export.
3. Dans le menu Operations, sélectionnez Export Metadata to a JAR File (download).
4. Dans la boîte de dialogue de téléchargement du fichier, cliquez sur Save.
5. Spécifiez un emplacement et un nom de fichier pour le fichier JAR exporté, puis cliquez sur Save.
6. Cliquez sur Close dans la boîte de dialogue Download Complete.
7. Cliquez sur System Settings, puis cliquez sur l'onglet Checkpoint Configuration. Notez le chemin du répertoire indiqué dans la zone Recovery Log Directory. Vous aurez besoin de ce répertoire plus loin dans cette procédure.
8. Arrêtez Business Activity Monitor.
9. Exécutez l'utilitaire de mise à niveau de BAM Server (cqupgrade.jar) pour mettre à niveau les métadonnées exportées dans un fichier JAR. Reportez-vous à la section
« A propos de l'utilitaire de mise à niveau de BAM Server », page 130
.
10. Annulez le déploiement du fichier EAR de BAM Server en suivant les instructions correspondant à votre serveur d'applications :
Adobe LiveCycle
Mise à niveau des produits LiveCycle
Mise à niveau des produits LiveCycle vers la version 7.2 ou 7.2.1
LiveCycle PDF Generator 132
O
O
O
(JBoss) Supprimez les répertoires suivants :
O
[racine bam jboss]server/default/work
O
O
[racine bam jboss]/server/default/tmp
[racine bam jboss]server/default/data
O
[racine bam jboss]server/conf/jboss.web
(WebSphere) Annulez le déploiement de l'ancien fichier EAR de BAM Server à l'aide de la console d'administration WebSphere.
(WebLogic) Annulez le déploiement de l'ancien fichier EAR de BAM Server à l'aide de la console d'administration WebLogic Server.
11. Supprimez tous les fichiers du répertoire du journal de récupération dont les noms sont similaires aux schémas suivants :
O
O
O filestore*.dat
DEFAULTRECOVERYLOGGER_* chkpoint_.x
12. Utilisez vos outils de gestion de base de données pour déplacer les tables de base de données comportant les métadonnées BAM. Vous avez également la possibilité de créer une nouvelle base de métadonnées BAM. Pour plus d'informations sur la base de métadonnées BAM, reportez-vous à
« Création de la base de métadonnées BAM » dans le guide Installation et configuration de LiveCycle de votre serveur d'applications.
13. Déployez la nouvelle version de BAM Server sur le serveur d'applications. (Voir « Déploiement de BAM
Server » dans le guide Installation et configuration de LiveCycle.)
14. Connectez-vous à BAM Workbench.
15. Contrôlez les paramètres de configuration de BAM Server pour vérifier les besoins de mises à jour.
(Voir « Prise en main de BAM Server » dans le guide Installation et configuration de LiveCycle.)
16. Cliquez sur l'onglet Administration, puis sur Import/Export.
17. Dans le menu Operations, sélectionnez Import Metadata from a JAR File (upload).
18. Cliquez sur Browse pour rechercher le fichier JAR contenant les métadonnées BAM mises à niveau, puis cliquez sur OK.
19. Redémarrez l'instance de BAM Server.
LiveCycle PDF Generator
Pour effectuer une mise à niveau à partir de LiveCycle PDF Generator 7.0.1 ou 7.0.2 vers LiveCycle PDF
Generator 7.2, vous devez annuler le déploiement du produit que vous utilisez actuellement avant d'installer et de déployer le nouveau produit.
Les instructions fournies dans cette section s'appliquent à LiveCycle PDF Generator pour PostScript,
LiveCycle PDF Generator Elements et à LiveCycle PDF Generator Professional.
Adobe LiveCycle
Mise à niveau des produits LiveCycle
Mise à niveau des produits LiveCycle vers la version 7.2 ou 7.2.1
LiveCycle PDF Generator 133
³
Pour mettre à niveau LiveCycle PDF Generator 7.0.2 vers LiveCycle PDF Generator 7.2 :
1. Sauvegardez la base de données contenant actuellement les données de configuration et d'exécution de LiveCycle PDF Generator 7.0.1 ou 7.0.2.
2. Assurez-vous de posséder une copie des fichiers LiveCycle EAR et WAR actuellement déployés, configurés pour le système opérationnel à mettre à niveau.
3. (JBoss) Si votre déploiement de LiveCycle PDF Generator s'exécute sur un serveur d'applications JBoss avec une base de données MySQL installée au moyen de l'option d'installation clé en main, arrêtez le service JBoss pour Adobe LiveCycle.
4. Si vous installez LiveCycle PDF Generator Professional ou LiveCycle PDF Generator Elements, désinstallez Adobe Acrobat 7.0.5 à l'aide de l'utilitaire Ajout/Suppression de programmes du Panneau de configuration de Microsoft Windows, puis redémarrez votre système.
5. Annulez le déploiement des composants suivants de LiveCycle PDF Generator conformément aux instructions du guide Installation et configuration de LiveCycle PDF Generator 7.0.2 :
O
O pdfg-all.ear (ou pdfg-ps-all.ear)
LiveCycle.ear
O
O adobe-FontManager.war
LCMBootstrapper.war
Pour en savoir plus sur l'annulation du déploiement de WebLogic ou WebSphere, reportez-vous à
« Désinstallation des fichiers EAR » dans le guide Installation et configuration de LiveCycle.
6. (WebSphere et WebLogic) Arrêtez le serveur d'applications.
7. Désinstallez les versions précédentes des produits LiveCycle à l'aide du programme de désinstallation.
(Voir « Désinstallation des produits LiveCycle » dans le guide Installation et configuration de LiveCycle.)
8. Installez LiveCycle PDF Generator 7.2 dans un répertoire (autre que celui par défaut), par exemple
C:\Adobe\LiveCycle72\ ou /opt/adobe/livecycle72/. Suivez les instructions du chapitre « Installation des produits LiveCycle » dans le guide Installation et configuration de LiveCycle.
Remarque :
si vous effectuez l'installation ou la mise à niveau de plusieurs produits LiveCycle 7.2, assurez-vous de les installer dans le même répertoire [racine LiveCycle72].
9. Copiez le fichier DocumentServicesLibrary.jar, selon votre serveur d'applications :
O
(WebLogic) Du répertoire [racine LiveCycle72]/components/csa/weblogic/lib/adobe vers le répertoire [domaine du serveur d'applications]//lib.
O
O
(WebSphere) Du répertoire [racine LiveCycle72]/components/csa/websphere/lib/adobe vers le répertoire [racine du serveur d'applications]/optionalLibraries.
(JBoss) Du répertoire [racine LiveCycle72]/components/csa/jboss/lib/adobe vers le répertoire
[racine du serveur d'applications]/server/all/lib. Copiez le fichier adobe-service.xml du répertoire
[racine_LiveCycle72]/configurationManager/deploy/jboss vers le répertoire [racine du serveur
d'applications]/server/all/deploy/jms.
10. Lancez le serveur d'applications.
11. Configurez les produits LiveCycle à l'aide de Configuration Manager. (Voir le chapitre « Configuration de produits LiveCycle pour le déploiement » du guide Installation et configuration de LiveCycle.) Dans les différents écrans de Configuration Manager, choisissez les options suivantes :
Adobe LiveCycle
Mise à niveau des produits LiveCycle
Mise à niveau des produits LiveCycle vers la version 7.2 ou 7.2.1
LiveCycle PDF Generator 134
O
O
O
Type de configuration : sélectionnez Assistant de configuration personnalisée.
Sélection du produit : sélectionnez le serveur d'applications utilisé, puis Plate-forme et LiveCycle
PDF Generator.
Choix de la tâche : sélectionnez toutes les options suivantes :
O
O
Configurer et assembler les produits
Démarrer la base de données
Pour WebSphere et WebLogic, sélectionnez également ces options :
O
Déployer les produits
O
Vérifier les produits déployés
12. Suivez les instructions des derniers écrans de Configuration Manager. Assurez-vous de configurer votre fichier EAR de LiveCycle 7.2 avec les mêmes paramètres que ceux choisis pour la version 7.0.2. Si le déploiement a lieu sur WebSphere ou WebLogic, procédez aux étapes 13 et 14. Si le déploiement a lieu sur JBoss, procédez aux étapes 15 et 16.
Remarque :
lorsque vous êtes invité à spécifier l'emplacement du répertoire de stockage global, indiquez l'emplacement que vous utilisez actuellement pour ce répertoire.
13. (WebSphere et WebLogic) Dans l'écran de confirmation des produits à déployer, sélectionnez les archives à déployer :
O
O
O pdfg-all.ear (ou pdfg-ps-all.ear) adobe-FontManager.ear
LiveCycle.ear
14. (WebSphere et WebLogic) Suivez les instructions des écrans de Configuration Manager pour initialiser la base de données et vérifier les produits déployés.
15. (JBoss) Déployez les composants de LiveCycle PDG Generator 7.2 :
O
LiveCycle.ear
O
O adobe-FontManager.ear
LCM.ear
O pdfg-all.ear (ou pdfg-ps-all.ear)
(Voir « Déploiement manuel sur JBoss » dans le guide Installation et configuration de LiveCycle.)
16. (JBoss) Exécutez Configuration Manager pour réinitialiser la base de données. Sélectionnez Assistant
de configuration personnalisée, puis Démarrer la base de données. (Voir « Initialisation de la base de données » dans le guide Installation et configuration de LiveCycle.)
Remarque :
l'initialisation de la base de données est nécessaire pour ajouter de nouvelles colonnes de tables au schéma de la base de données. L'initialisation de la base de données ne modifie pas les données existantes.
17. Vérifiez le déploiement en suivant les instructions de la section « Tâches de post-déploiement de
LiveCycle PDF Generator » dans le guide Installation et configuration de LiveCycle.
Remarque :
vous pouvez également vérifier votre installation et votre configuration en utilisant les exemples fournis à l'adresse suivante : www.adobe.com/devnet/livecycle/samples.html
Adobe LiveCycle
Mise à niveau des produits LiveCycle
Mise à niveau des produits LiveCycle vers la version 7.2 ou 7.2.1
LiveCycle Document Security 135
³
Pour configurer JMS Messaging pour WebSphere exécuté sous Windows :
1. Dans la console d'administration WebSphere, supprimez les files d'attentes, sujets et ports d'écoute de
JMS pour chaque serveur.
2. Configurez WebSphere MQ en suivant les instructions de la section « Configuration des ressources JMS de WebSphere MQ » dans le guide Installation et configuration de LiveCycle.
3. Exécutez les scripts fournis par Configuration Manager pour créer des files d'attente dans l'installation
MQ conformément aux instructions fournies dans « Préparation de WebSphere MQ » dans le guide
Installation et configuration de LiveCycle.
4. Exécutez à nouveau Configuration Manager et sélectionnez la tâche Configurer le serveur
d'applications. Suivez les instructions des écrans de Configuration Manager pour configurer les paramètres du serveur d'applications. (Voir « Modification des paramètres du serveur d'applications » dans le guide Installation et configuration de LiveCycle.) Dans les différents écrans de Configuration
Manager, choisissez les options suivantes :
O
O
O
Paramètres JVM : sélectionnez Ne pas appliquer.
Paramètres JMS : spécifiez les valeurs des propriétés du service MQ.
Création de source de données : sélectionnez Ne pas appliquer.
5. Dans l'écran de configuration du serveur d'applications, cliquez sur Appliquer les paramètres pour configurer le serveur d'applications, puis sur Suivant une fois la tâche terminée.
6. Redémarrez le serveur d'applications et cliquez sur Suivant, dans l'écran Redémarrage du serveur d'applications/de la grappe de serveurs, si vous avez sélectionné une autre tâche de Configuration
Manager à exécuter) ou sur Terminer pour fermer Configuration Manager.
7. Vérifiez que les applications démarrent correctement.
LiveCycle Document Security
Cette section fournit les instructions nécessaires à la mise à niveau de LiveCycle Document Security 7.0 ou
7.1 vers LiveCycle Document Security 7.2. Pour effectuer cette mise à niveau, vous devez mettre à jour les composants de serveur déployés sur le serveur d'applications.
Nous vous conseillons d'installer LiveCycle Document Security 7.2 dans un nouveau répertoire afin de ne pas écraser la version précédente.
³
Pour procéder à la mise à niveau vers LiveCycle Document Security 7.2 :
1. Sauvegardez les fichiers et les dossiers suivants :
O
../trust.xml
O
O
O
O
O
../credentials/
../certificates/
../CRLs/
../keystore
../trust.sig
Adobe LiveCycle
Mise à niveau des produits LiveCycle
Mise à niveau des produits LiveCycle vers la version 7.2 ou 7.2.1
LiveCycle Document Security 136
2. Assurez-vous de posséder une copie des fichiers LiveCycle EAR et WAR actuellement déployés, configurés pour le système opérationnel à mettre à niveau.
3. Annulez le déploiement des composants suivants de LiveCycle Document Security conformément aux instructions du guide Installation et configuration de LiveCycle Document Security 7.0 ou 7.1 :
WebSphere et WebLogic
adobe-FontManager.war
adobe-PDFManipulation.war
adobe-TrustManager.war
DataManagerService.war
ServicesNatives-2.war
adobe-APSProxy.war
JBoss
adobe-FontManager.bar
adobe-PDFManipulation.bar
adobe-TrustManager.bar
AdobeServices.sar
ServicesNatives-2.war
adobe-APSProxy.bar
4. (WebSphere) Configurez les utilisateurs, les rôles et les fichiers d'ouverture de session par défaut en suivant les instructions de la procédure « Pour associer les utilisateurs à des rôles » du guide Installation
et configuration des produits de sécurité LiveCycle. (Vous devez suivre cette procédure à chaque redéploiement du fichier LiveCycle-security.ear.)
5. Redémarrez le serveur d'applications.
6. Désinstallez la version précédente des produits LiveCycle à l'aide du programme de désinstallation.
(Voir « Désinstallation des produits LiveCycle » dans le guide Installation et configuration de LiveCycle correspondant.)
7. Installez LiveCycle Document Security 7.2 dans un répertoire (autre que celui par défaut), par exemple
C:\Adobe\LiveCycle72\ ou /opt/adobe/livecycle72/. Suivez les instructions du chapitre « Installation des produits LiveCycle » dans le guide Installation et configuration des produits de sécurité LiveCycle.
Remarque :
si vous effectuez l'installation ou la mise à niveau de plusieurs produits LiveCycle 7.2, assurez-vous de les installer dans le même répertoire [racine LiveCycle72].
8. Copiez le fichier DocumentServicesLibrary.jar, selon votre serveur d'applications :
O
(JBoss) Du répertoire [racine LiveCycle72]/components/csa/jboss/lib/adobe vers le répertoire [racine du serveur d'applications]/server/all/lib.
O
O
(WebLogic) Du répertoire [racine LiveCycle72]/components/csa/weblogic/lib/adobe vers le répertoire [racine du serveur d'applications]//lib.
(WebSphere) Du répertoire [racine LiveCycle72]/components/csa/websphere/lib/adobe vers le répertoire [racine du serveur d'applications]/optionalLibraries.
9. Configurez LiveCycle Document Security 7.2 à l'aide de Configuration Manager. (Voir « Configuration de produits LiveCycle ».) Dans les différents écrans de Configuration Manager, choisissez les options suivantes :
O
Type de configuration : sélectionnez Assistant de configuration personnalisée.
O
Sélection du produit : sélectionnez le serveur d'applications utilisé, ainsi que Plate-forme et le produit en cours de configuration.
Adobe LiveCycle
Mise à niveau des produits LiveCycle
Mise à niveau des produits LiveCycle vers la version 7.2 ou 7.2.1
LiveCycle Reader Extensions 137
O
O
O
Choix de la tâche : sélectionnez les options suivantes :
O
Configurer et assembler les produits
O
Démarrer la base de données
Pour WebSphere et WebLogic, sélectionnez également ces options :
O
O
Déployer les produits
Vérifier les produits déployés
Choix du répertoire de données d'approbation : sélectionnez Créer un nouveau répertoire de
données d'approbation.
Sélection d'un fichier de stockage des clés : sélectionnez Créer un nouveau fichier de stockage
de clés et une paire de clés.
10. Suivez les instructions des derniers écrans de Configuration Manager. Assurez-vous de configurer votre fichier EAR de LiveCycle 7.2 avec les mêmes paramètres que ceux choisis pour la version 7.0 ou 7.1. Si le déploiement a lieu sur WebSphere ou WebLogic, procédez aux étapes 11 et 12. Si le déploiement a lieu sur JBoss, procédez aux étapes 13 et 14.
Remarque :
lorsque vous êtes invité à spécifier l'emplacement du répertoire de stockage global, indiquez l'emplacement que vous utilisez actuellement pour le fichier temporaire des produits Adobe LiveCycle.
11. (WebSphere et WebLogic) Dans l'écran de confirmation des produits à déployer, sélectionnez les archives à déployer :
O adobe-FontManager.ear
O
O
LiveCycle.ear
LiveCycle-security.ear
12. (WebSphere et WebLogic) Suivez les instructions des écrans de Configuration Manager pour initialiser la base de données et vérifier les produits déployés.
13. (JBoss) Déployez LiveCycle Document Security 7.2. (Voir « Déploiement manuel sur JBoss » dans le guide Installation et configuration des produits de sécurité LiveCycle.)
14. (JBoss) Exécutez Configuration Manager pour réinitialiser la base de données. Sélectionnez Assistant
de configuration personnalisée, puis Démarrer la base de données. (Voir « Initialisation de la base de données » dans le guide Installation et configuration des produits de sécurité LiveCycle.)
15. Redémarrez le serveur d'applications.
16. Vous pouvez également vérifier votre installation et votre configuration en utilisant les exemples fournis à l'adresse suivante : www.adobe.com/devnet/livecycle/samples.html
LiveCycle Reader Extensions
Cette section fournit les instructions nécessaires à la mise à niveau de LiveCycle Reader Extensions 7.0 ou de 7.0.2 vers LiveCycle Reader Extensions 7.2. Pour effectuer cette mise à niveau, vous devez mettre à jour les composants de serveur déployés sur le serveur d'applications.
Remarque :
(JBoss) si vous aviez installé LiveCycle Reader Extensions sous Windows pour un déploiement sur JBoss à l'aide de la méthode d'installation clé en main, reportez-vous à la section sur la
Adobe LiveCycle
Mise à niveau des produits LiveCycle
Mise à niveau des produits LiveCycle vers la version 7.2 ou 7.2.1
LiveCycle Reader Extensions 138 mise à niveau de LiveCycle Reader Extensions à l'aide de l'option d'installation clé en main du guide Installation et configuration des produits de sécurité LiveCycle afin d'obtenir les instructions spécifiques nécessaires.
Nous vous conseillons d'installer LiveCycle Reader Extensions 7.2 dans un nouveau répertoire afin de ne pas écraser la version précédente.
Si vous utilisez des informations d'identification existantes, assurez-vous qu'elles n'ont pas expiré et qu'elles sont encore valides. (Voir « Informations d'identification des droits pour LiveCycle Reader
Extensions » dans le guide Installation et configuration des produits de sécurité LiveCycle.)
Les applications personnalisées utilisant des API existantes prises en charge dans Adobe Document
Services 6.0 pour Reader Extensions ne sont pas prises en charge dans LiveCycle Reader Extensions 7.2. Les applications personnalisées utilisant des API existantes prises en charge dans Adobe Reader Extensions
Server 6.1 sont prises en charge et continuent de fonctionner avec LiveCycle Reader Extensions 7.2.
Les certificats numériques publiés pour une utilisation avec Reader Extensions Server 6.1 sont compatibles avec LiveCycle Reader Extensions 7.2. Si vous effectuez une mise à niveau de la version 6.1 vers la version 7.2, vous ne recevrez pas de nouvelles informations d'identification des droits.
³
Pour mettre à niveau LiveCycle Reader Extensions vers la version 7.2 :
1. Sauvegardez les fichiers et les dossiers suivants dans le répertoire [racine
LiveCycle]/ReaderExtensions/trust :
O
../trust.xml
O
O
O
O
O
../credentials/
../certificates/
../CRLs/
../keystore
../trust.sig
2. Assurez-vous de posséder une copie des fichiers LiveCycle EAR et WAR actuellement déployés, configurés pour le système opérationnel à mettre à niveau.
3. Annulez le déploiement des composants suivants de LiveCycle Reader Extensions conformément aux instructions du guide Installation et configuration de LiveCycle Reader Extensions 7.0 ou 7.0.2 :
WebSphere et WebLogic
adobe-FontManager.war
adobe-PDFManipulation.war
adobe-TrustManager.war
DataManagerService.war
ServicesNatives-2.war
ares.ear
JBoss
adobe-FontManager.bar
adobe-PDFManipulation.bar
adobe-TrustManager.bar
AdobeServices.sar
ServicesNatives-2.war
ares.ear
adobe-CredentialSecurityEJB.ear
adobe-CredentialSecurityEJB.ear
adobe-APSProxy.war
adobe-APSProxy.bar
Adobe LiveCycle
Mise à niveau des produits LiveCycle
Mise à niveau des produits LiveCycle vers la version 7.2 ou 7.2.1
LiveCycle Reader Extensions 139
4. Redémarrez le serveur d'applications.
5. Désinstallez la version précédente des produits LiveCycle à l'aide du programme de désinstallation.
(Voir « Désinstallation des produits LiveCycle » dans le guide Installation et configuration de LiveCycle correspondant.)
6. Installez LiveCycle Reader Extensions 7.2 dans un répertoire (autre que celui par défaut), par exemple
C:\Adobe\LiveCycle72\ ou /opt/adobe/livecycle72/. Suivez les instructions du chapitre « Installation des produits LiveCycle » dans le guide Installation et configuration des produits de sécurité LiveCycle.
Remarque :
si vous effectuez l'installation ou la mise à niveau de plusieurs produits LiveCycle 7.2, assurez-vous de les installer dans le même répertoire [racine LiveCycle72].
7. Copiez le fichier DocumentServicesLibrary.jar, selon votre serveur d'applications :
O
(WebLogic) Du répertoire [racine LiveCycle72]/components/csa/weblogic/lib/adobe vers le répertoire [racine du serveur d'applications]//lib.
O
O
(WebSphere) Du répertoire [racine LiveCycle72]/components/csa/websphere/lib/adobe vers le répertoire [racine du serveur d'applications]/optionalLibraries.
(JBoss) Du répertoire [racine LiveCycle72]/components/csa/jboss/lib/adobe vers le répertoire [racine du serveur d'applications]/server/all/lib.
8. Configurez LiveCycle Reader Extensions 7.2 en utilisant Configuration Manager. (Voir le chapitre
« Configuration de produits LiveCycle pour le déploiement » du guide Installation et configuration des
produits de sécurité LiveCycle.) Dans les différents écrans de Configuration Manager, choisissez les options suivantes :
O
O
O
Type de configuration : sélectionnez Assistant de configuration personnalisée.
Sélection du produit : sélectionnez le serveur d'applications utilisé, ainsi que Plate-forme et le produit en cours de configuration.
Choix de la tâche : sélectionnez les options suivantes :
O
Configurer et assembler les produits
Pour WebSphere et WebLogic, sélectionnez également ces options :
O
Déployer les produits
O
Vérifier les produits déployés
O
O
Choix du répertoire de données d'approbation : sélectionnez Créer un nouveau répertoire de
données d'approbation.
Sélection d'un fichier de stockage des clés : sélectionnez Créer un nouveau fichier de stockage
de clés et une paire de clés.
9. Suivez les instructions des derniers écrans de Configuration Manager. Assurez-vous de configurer votre fichier EAR de LiveCycle 7.2 avec les mêmes paramètres que ceux choisis pour la version 7.0 ou 7.1. Si le déploiement a lieu sur WebSphere ou WebLogic, procédez aux étapes 10 et 11. Si le déploiement a lieu sur JBoss, procédez à l'étape 12.
Remarque :
lorsque vous êtes invité à spécifier l'emplacement du répertoire de stockage global, indiquez l'emplacement que vous utilisez actuellement pour le fichier temporaire des produits Adobe LiveCycle.
10. (WebSphere et WebLogic) Dans l'écran de confirmation des produits à déployer, sélectionnez les archives à déployer :
Adobe LiveCycle
Mise à niveau des produits LiveCycle
Mise à niveau des produits LiveCycle vers la version 7.2 ou 7.2.1
LiveCycle Reader Extensions 140
O
O
O adobe-FontManager.ear
LiveCycle.ear
LiveCycle-security.ear
11. (WebSphere et WebLogic) Suivez les instructions des écrans de Configuration Manager pour initialiser la base de données et vérifier les produits déployés.
12. (JBoss) Déployez LiveCycle Reader Extensions 7.2. (Voir « Déploiement manuel sur JBoss » dans le guide
Installation et configuration des produits de sécurité LiveCycle.)
13. Redémarrez le serveur d'applications.
14. Vérifiez l'installation et la configuration en accédant à l'URL approprié :
O
O
(WebLogic) http://[nom_hôte]:7001/ReaderExtensions ou http://[nom_hôte]:8001/ReaderExtensions (Managed Server)
(WebSphere) http://[nom_hôte]:9080/ReaderExtensions
O
(JBoss) http://[nom_hôte]:8080/ReaderExtensions
15. Saisissez le nom d'utilisateur et le mot de passe créés lors de la configuration de l'utilisateur
LiveCycle Reader Extensions. (Voir « Définition des utilisateurs, des rôles et des fichiers d'ouverture de session » pour JBoss ou WebLogic ou « Pour associer les utilisateurs à des rôles » pour WebSphere dans le guide Installation et configuration des produits de sécurité LiveCycle.)
³
(JBoss) Pour mettre à niveau LiveCycle Reader Extensions à l'aide de la méthode d'installation clé en main :
1. Arrêtez le service AdobeReaderExtensions Windows dans la fenêtre Services de la zone Outils d'administration du Panneau de configuration de Windows.
2. Vérifiez que le port 8080 n'est pas utilisé.
3. « localhost » est spécifié comme hôte et « 8080 » comme port à utiliser par JBoss. Si JBoss est déjà installé, vérifiez qu'il n'utilise pas le port 8080. Vous ne pouvez pas configurer un autre hôte ou port pour JBoss pendant la procédure d'installation et de configuration clé en main.
4. A l'aide de la méthode d'installation clé en main, installez LiveCycle Reader Extensions 7.2 dans un répertoire (autre que celui par défaut), par exemple C:\Adobe\LiveCycle72\. Suivez les instructions de la section « Installation de LiveCycle Reader Extensions ou de LiveCycle Document Security » dans le guide Installation et configuration des produits de sécurité LiveCycle.
5. Vérifiez l'installation et la configuration en accédant à l'URL http://[nom_hôte]:8080/ReaderExtensions.
Remarque :
pour les installations clé en main, le nom d'utilisateur par défaut est administrator et le mot de passe par défaut est password. Pour modifier ces valeurs, reportez-vous à
« Définition des utilisateurs, des rôles et des fichiers d'ouverture de session » dans le guide
Installation et configuration des produits de sécurité LiveCycle.
Remarque :
vous pouvez également vérifier votre installation et votre configuration en utilisant les exemples fournis à l'adresse suivante : www.adobe.com/devnet/livecycle/samples.html
Adobe LiveCycle
Mise à niveau des produits LiveCycle
Mise à niveau des produits LiveCycle vers la version 7.2 ou 7.2.1
LiveCycle Policy Server 141
LiveCycle Policy Server
Cette section fournit des instructions pour mettre à niveau LiveCycle Policy Server 7.0.2 vers LiveCycle
Policy Server 7.2. Pour effectuer cette mise à niveau, vous devez mettre à jour les composants de serveur déployés sur le serveur d'applications et initialiser la base de données.
Nous vous conseillons d'installer LiveCycle Policy Server 7.2 dans un nouveau répertoire afin de ne pas
écraser la version précédente.
³
Pour mettre à niveau LiveCycle Policy Server vers la version 7.2 :
1. Sauvegardez la base de données contenant actuellement les données de configuration et d'exécution de LiveCycle Policy Server 7.0.2.
2. Assurez-vous de posséder une copie des fichiers LiveCycle EAR et WAR actuellement déployés, configurés pour le système opérationnel à mettre à niveau.
3. Annulez le déploiement des composants suivants de LiveCycle Policy Server 7.0.2 :
O
O
O
O
O asn1.jar
jsafe.jar
jsafeJCE.jar
edc-server-spi.jar
edc-server.ear
4. Supprimez les fichiers dom*.jar du répertoire [racine du serveur d'applications]/java/jre/lib/endorsed.
5. Désinstallez la version précédente des produits LiveCycle à l'aide du programme de désinstallation.
(Voir « Désinstallation des produits LiveCycle » dans le guide Installation et configuration de LiveCycle correspondant.)
6. Installez LiveCycle Policy Server 7.2 dans un répertoire (autre que celui par défaut), par exemple
C:\Adobe\LiveCycle72\ ou /opt/adobe/livecycle72/. Suivez les instructions du chapitre « Installation des produits LiveCycle » dans le guide Installation et configuration des produits de sécurité LiveCycle.
Remarque :
si vous effectuez l'installation ou la mise à niveau de plusieurs produits LiveCycle 7.2, assurez-vous de les installer dans le même répertoire [racine LiveCycle72].
7. Déployez Adobe LiveCycle Policy Server 7.2. (Reportez-vous au chapitre relatif au déploiement manuel sur le serveur d'applications dans le guide Installation et configuration des produits de sécurité LiveCycle correspondant à votre serveur d'applications.)
8. Exécutez Configuration Manager pour réinitialiser la base de données. Sélectionnez Assistant de
configuration personnalisée, puis Démarrer la base de données. (Voir « Initialisation de la base de données » dans le guide Installation et configuration des produits de sécurité LiveCycle.)
Remarque :
l'initialisation de la base de données est nécessaire pour ajouter de nouvelles colonnes de tables au schéma de la base de données. L'initialisation de la base de données ne modifie pas les données existantes.
9. Configurez les différents paramètres d'exécution pour LiveCycle Policy Server. (Voir la section « Après le déploiement » du guide Installation et configuration des produits de sécurité LiveCycle.)
Adobe LiveCycle
Mise à niveau des produits LiveCycle
Mise à niveau des produits LiveCycle vers la version 7.2 ou 7.2.1
LiveCycle Policy Server 142
Remarque :
vous pouvez vérifier votre installation et votre configuration en utilisant les exemples fournis à l'adresse suivante : www.adobe.com/devnet/livecycle/samples.html
G
Amélioration des performances du serveur
Cette annexe fournit des conseils généraux que vous pouvez appliquer pour améliorer les performances du serveur lors de l'utilisation des produits LiveCycle.
Optimisation de documents en ligne d'entrée et impacts sur la mémoire JVM
Si vous traitez régulièrement des documents de petite taille, vous pouvez améliorer les performances associées à la vitesse de transfert des documents et à l'espace de stockage en implémentant les configurations de produit LiveCycle suivantes :
O
O
Augmentation de la taille maximale de la ligne d'entrée pour les produits LiveCycle afin qu'elle soit supérieure à la taille de la plupart des documents.
Pour le traitement de fichiers plus volumineux, spécification des répertoires de stockage situés sur un disque à grande vitesse ou un disque RAM.
La taille maximale par défaut de la ligne d'entrée et les répertoires de stockage (répertoire des fichiers temporaires des produits Adobe LiveCycle et répertoire de stockage global) constituent des propriétés du module Data Manager. Vous pouvez configurer le module Data Manager avec Configuration Manager.
Reportez-vous à la section
« Configuration des produits LiveCycle à déployer », page 49
.
Remarque :
la taille maximale par défaut de la ligne d'entrée équivaut à 65 536 octets.
Taille du document et taille maximale de la ligne d'entrée
Lorsque la taille d'un document à traiter avec des produits LiveCycle est inférieure ou égale à la taille maximale de la ligne d'entrée, le document est stocké sur le serveur de la ligne d'entrée et sérialisé sous la forme d'un objet Adobe Document. Le stockage de documents de ligne d'entrée peut considérablement accroître les performances. Cependant, si vous utilisez LiveCycle Workflow, le contenu peut également
être enregistré dans la base de données pour garantir son suivi et l'augmentation de la taille maximale de la ligne d'entrée peut affecter la taille de la base de données.
Un document dont la taille est supérieure à la taille maximale de la ligne d'entrée est stocké dans le système de fichiers local (dans les répertoires de stockage spécifiés à l'aide de Configuration Manager).
L'objet Adobe Document transféré sur le serveur ou provenant de celui-ci constitue alors un simple pointeur vers ce fichier.
Lorsque le contenu du document est en ligne (c'est-à-dire qu'il est inférieur à la taille maximale de la ligne d'entrée), il est enregistré dans la base de données (dans le cadre de la fonction de sérialisation du document). Par conséquent, une augmentation de la taille maximale de la ligne d'entrée peut affecter la taille de la base de données.
Taille maximale du tas de la JVM
L'augmentation de la taille maximale de la ligne d'entrée nécessite plus de mémoire pour le stockage des documents sérialisés, et donc généralement une augmentation de la taille maximale du tas de la JVM. La taille maximale du tas de la JVM ne doit pas dépasser 2 Go.
143
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Amélioration des performances du serveur
Augmentation de la quantité maximale de mémoire affectée à la JVM 144
Un système lourdement chargé et traitant un grand nombre de documents peut rapidement saturer la mémoire du tas JVM. Pour éviter une erreur de mémoire saturée (OutOfMemoryError), vous devez augmenter la taille maximale du tas de la JVM d'un volume correspondant à la taille des documents de la ligne d'entrée multipliée par le nombre de documents généralement exécutés à un moment donné.
Taille maximale du tas de la JVM = (taille des documents de ligne d'entrée) x (nombre moyen de documents traités)
Exemple G.1
Calcul de la taille maximale du tas de la JVM
Dans cet exemple, la taille maximale actuelle du tas de la JVM est définie sur 512 Mo et la taille maximale de la ligne d'entrée sur 64 Ko. Vous devez configurer le serveur pour l'exemple suivant : 10 tâches sont exécutées simultanément et chacune comporte 9 fichiers d'entrée et un fichier de résultat (pour un total de 10 fichiers par tâche et 100 fichiers traités simultanément). La taille de chaque fichier ne dépasse pas
512 Ko.
Pour stocker tous les fichiers dans la ligne d'entrée, la taille maximale de cette dernière doit être définie sur
512 Ko au minimum.
Utilisez l'équation suivante pour calculer l'augmentation de la taille maximale du tas JVM nécessaire :
(512 Ko) x (100) = 51 200 Ko ou 512 Mo
Vous devez augmenter la taille maximale du tas JVM de 512 Mo pour un total de 1 Go.
Fragmentation du tas
Si vous réglez la taille des documents de ligne d'entrée sur de grandes valeurs, vous augmentez le risque d'apparition d'erreurs OutOfMemoryError sur les systèmes sujets à la fragmentation du tas. Pour stocker un document de ligne d'entrée, il faut que la mémoire du tas JVM comporte suffisamment d'espace contigu. Certains systèmes d'exploitation, JVM et algorithmes collecteurs sont sujets à la fragmentation du tas. La fragmentation réduit la quantité d'espace de tas contigu et peut générer un message de mémoire saturée (OutOfMemoryError) même si l'espace disponible total est suffisant.
Par exemple, de précédentes opérations sur le serveur d'applications ont laissé le tas JVM dans un état fragmenté, et le collecteur est incapable de compresser suffisamment le tas pour récupérer de grands blocs d'espace libre. Une erreur OutOfMemoryError peut se produire même si vous avez augmenté la taille maximale du tas JVM en fonction de la ligne d'entrée.
Pour éviter une fragmentation du tas, la taille du document de ligne d'entrée ne doit pas dépasser la taille totale du tas de plus de 0,1 %. Par exemple, une taille maximale du tas JVM de 512 Mo peut prendre en charge une taille maximale de ligne d'entrée de 512 Mo x 0,001 = 0,512 Mo ou 512 Ko.
Augmentation de la quantité maximale de mémoire affectée à la JVM
Cette section s'applique à WebSphere uniquement.
Si vous exécutez LCM ou que vous essayez de générer le code de déploiement EJB au moyen de l'utilitaire de ligne de commande, ejbdeploy, et qu'une erreur OutOfMemory survient, vous devez augmenter la quantité maximale de mémoire affectée à la JVM.
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Amélioration des performances du serveur
Nettoyage des fichiers temporaires du répertoire de stockage global 145
³
Pour augmenter la quantité maximale de mémoire affectée à la JVM
1. Modifiez le script ejbdeploy du répertoire {WAS_install_root}/deploytool/itp/ :
O
O
(Windows) ejbdeploy.bat
(Linux) ejbdeploy.sh
2. Trouvez le paramètre
-Xmx256M
et attribuez à ce dernier une valeur supérieure, telle que
-Xmx1024M
.
3. Enregistrez le fichier.
4. Exécutez ejbdeploy ou relancez LCM.
Nettoyage des fichiers temporaires du répertoire de stockage global
Lorsqu'un processus de flux de production est exécuté, les fichiers temporaires sont placés dans le répertoire de stockage global, mais ils ne sont pas supprimés une fois le processus terminé. Ces fichiers sont placés sous les sous-répertoires et nommés Session[NNNN], NNNN correspondant à l'identifiant du processus de flux de production. Pour éviter de manquer d'espace disque, vous devez régulièrement supprimer les répertoires Session associés aux processus totalement terminés.
Si le répertoire de stockage global n'est pas défini explicitement dans Configuration Manager, il est créé par défaut sous [RepTemp]/AdobeDocumentStorage/global. Si l'utilisateur ne définit pas le [RepTemp] dans Configuration Manager, l'emplacement par défaut est java.io.tmpdir.
Paramètres de configuration de DB2
Si vous exécutez LiveCycle Form Manager 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 message dans les fichiers journaux, modifiez les paramètres de configuration de DB2. Attribuez au paramètre LOCKTIMEOUT la valeur 15 et doublez la valeur des paramètres APPLHEAPSZ, STMTHEAP et SORTHEAP. Redémarrez ensuite la base de données et le serveur d'applications.
Amélioration des performances de Windows Server avec LDAP
L'utilisation du pool de connexion sur la connexion de recherche peut réduire le nombre de ports requis de 50 % étant donné que cette connexion utilise toujours les mêmes informations d'identification pour un domaine donné et que le contexte et les objets liés sont fermés de manière explicite.
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
Amélioration des performances du serveur
Amélioration des performances de Windows Server avec LDAP 146
³
Pour configurer Windows Server pour le pool de connexion :
1. Lancez l'éditeur de registre en cliquant sur Démarrer > Exécuter ; dans le champ Ouvrir, tapez regedit
, puis cliquez sur OK.
2. Accédez à la clé de registre :
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters
3. Dans le volet de droite de l'éditeur de registre, recherchez le nom de la valeur TcpTimedWaitDelay. Si ce nom n'apparaît pas, vous pouvez l'ajouter en sélectionnant Edition > Nouveau > Valeur DWORD dans la barre de menus.
4. Dans la zone Nom, saisissez
TcpTimedWaitDelay
.
Remarque :
si aucun curseur ne clignote dans la zone et que aucune
Nouvelle valeur # n'apparaît, faites un clic droit dans le panneau droit, sélectionnez Renommer dans le menu, puis tapez TcpTimedWaitDelay dans le champ
Nom
.
pour les noms de valeur suivants :
MaxUserPort
,
MaxHashTableSize
et
MaxFreeTcbs.
6. Double-cliquez dans le volet de droite pour définir la valeur TcpTimedWaitDelay. Sous Base, sélectionnez Décimale, puis entrez
30
dans la zone Données de la valeur.
7. Double-cliquez dans le volet de droite pour définir la valeur MaxUserPort. Sous Base, sélectionnez
Décimale, puis entrez
65534
dans la zone Données de la valeur.
8. Double-cliquez dans le volet de droite pour définir la valeur MaxHashTableSize. Sous Base, sélectionnez Décimale, puis entrez
65536
dans la zone Données de la valeur.
9. Double-cliquez dans le volet de droite pour définir la valeur MaxFreeTcbs. Sous Base, sélectionnez
Décimale, puis entrez
16000
dans la zone Données de la valeur.
Attention :
vous pouvez rencontrer de sérieux problèmes si vous modifiez le registre, au moyen de l'éditeur de registre ou d'une autre méthode, de façon incorrecte. Il pourrait être nécessaire ensuite de réinstaller votre système d'exploitation. Modifiez le registre à vos propres risques.
Index
A
accès
application Installation Verification Sample 28
BAM Workbench et BAM Dashboard 90
pages utilisateur de LiveCycle Form Manager 31
tables de base de données LiveCycle 42
Adobe Administrator
Adobe Form Server, mise à niveau vers LiveCycle Forms 120
Adobe LiveCycle Assembler
déploiement, vérification 27, 28
travaux, envoi pour traitement 113
Adobe LiveCycle Document Security
Adobe LiveCycle Form Manager
accès aux pages de l'utilisateur final 31
Adobe LiveCycle Forms
Adobe LiveCycle PDF Generator
base de données JMS, création 46
délai d'expiration de la conversion, paramètre 33
exécution de la méthode clé en main 23
Adobe LiveCycle Print
Adobe LiveCycle Reader Extensions
Adobe LiveCycle Workflow
appel de LiveCycle Assembler 105
configuration pour BAM Server 90
définitions des métadonnées, importation 92
Adobe LiveCycle Workflow Designer
désinstallation 99 fichier de configuration, modification 99
Adobe User Management
Adobe LiveCycle Policy Server
adobe-printSubmitter.ear, fichier 29
affichage
affichage des fichiers journaux 66
aide-mémoire 16 aide-mémoire pour la configuration 16
ajout
polices à utiliser avec LiveCycle Forms 51
annuaire
convention de désignation JBoss 64
application Form Server Module API Print, exécution 30
application Print Submitter, exécution 29
Application Web PrintIVS, déploiement et exécution 29
authentification
utilisation des informations d'identification SSL 72
B
BAM Server
à propos de l'utilitaire de mise à niveau 130
configuration de LiveCycle Workflow 90
connexion de JBoss à la base de données 78
installation des pilotes de la base de données 78
mise à niveau pour LiveCycle Workflow 130
synchronisation avec le serveur LDAP 94, 97
base de données
création de fichiers de sources de données 59
base de données Adobe LiveCycle
à propos de l'initialisation 11
base de données DB2
configuration pour plusieurs utilisations simultanées 45
création de source de données pour JBoss 61
paramètres de configuration 145
147
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss base de données Oracle
création de source de données pour JBoss 60
base de métadonnées BAM
bases de données
pilotes, installation sur BAM Server 78
système d'exploitation pris en charge 15, 101
Business Activity Monitor. Voir entrées BAM
C
comptes utilisateur
Configuration
configuration
base de données DB2 pour plusieurs utilisations simultanées
LiveCycle Workflow pour BAM Server 90
processus de flux de production avec le QPAC Assembler 107
produits LiveCycle pour le déploiement 49
source de données DB2 pour JBoss 61
source de données MySQL pour JBoss 59
source de données Oracle pour JBoss 60
source de données SQL Server pour JBoss 62
Windows Server pour le pool de connexion 146
configuration des threads
Configuration Manager
configuration des répertoires 145
utilisation lors de la mise à niveau 119
utilisation pour configurer les produits LiveCycle 49
configuration matérielle requise 15
configuration système requise 13
connexion
base de métadonnées BAM sur SQL Server 79
JBoss à la base de métadonnées BAM 78
connexion de JBoss à la base de données LiveCycle 59
Index
148
consignation des erreurs, flux de production du QPAC Assembler 108
conventions de désignation, chemin d'accès aux fichiers 8 conventions, nom de chemin d'accès 8
création
fichiers de sources de données 59, 78
informations d'identification SSL 72
D
délai d'expiration de la conversion, LiveCycle PDF Generator, paramètre 33
démarrage
Déploiement
déploiement
configuration des produits LiveCycle pour 49
exemple avec LiveCycle Assembler 27
plusieurs produits LiveCycle 12
désinstallation
LiveCycle Workflow Designer 99
dossiers de contrôle
création du fichier JobConfig.xml 110
E
exemple
accès Installation Verification Sample 28
exemples
application Web PrintIVS, exécution 29 conception de formulaires 29 fichiers de données 29
Form Server Module API Print, exécution 30
LiveCycle Assembler, déploiement 27
F
fichier
accès à l'aide de clients WebDAV 114
fichier cluster-service.xml, modification 58
fichier de sources de données, création 59, 78
fichier dom4j.jar, mise à jour 58
fichiers
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
fichiers BAT et SH PrintExample 30
fichiers d'exécution, modification 55
fichiers DDX
fichiers DDX dynamiques 106 fichiers DDX statiques 106
fichiers de configuration
LiveCycle Workflow Designer, modification 99
fichiers JAR, mise à jour de dom4.jar 58
fichiers journaux, affichage 41, 66
fichiers produit
formulaires Adobe LiveCycle
I
importation des définitions des métadonnées LiveCycle Workflow 92
imprimante Adobe PDF, réglage par défaut 32
informations d'identification, SSL, création 72
initialisation de base de données 11, 67
installation
LiveCycle Workflow Designer 98
pilotes de la base de données pour BAM Server 78
plusieurs produits LiveCycle 12
polices utilisées dans les documents convertis 32
produits LiveCycle pour le déploiement manuel 38
répertoires 20 utilisation de la méthode clé en main 20
utilisation de la méthode manuelle 35
installation automatique
utilisation pour la mise à niveau des produits LiveCycle 119
installation clé en main
utilisation pour la mise à niveau des produits LiveCycle 119
installation manuelle
J
JBoss
appellation du répertoire racine 64 composants déployables 64
configuration de SSL sur JBoss 72, 74
configuration des threads, modification 85
configuration pour BAM Server 78
configuration pour Watched Folder 59
connexion à la base de données de BAM Server 78
connexion à la base de données de LiveCycle 59
fichiers de configuration, modification 55
limitation de l'enregistrement de messages 85
numéros de port, personnalisation 86
JMS
fichiers de configuration, modification 56
journaux d'erreurs, affichage 41
JVM
taille du tas, maximale, augmentation 143
L
LDAP
amélioration des performances de Windows Server 145
configuration de User Management 69
configuration pour BAM Server 93
LiveCycle. Voir Adobe LiveCycle
logiciel
client, publication de fichiers 114
logiciels
combinaisons pour l'installation 15
M
mappage de l'utilisateur, LDAP, configuration 95
mappage du rôle, LDAP, configuration 96
mise à jour de produits LiveCycle 12, 118
modes d'échec, flux de production du QPAC Assembler 108
MySQL
base de données, création 42 compte utilisateur 42
configuration des sources de données pour JBoss 59
connexion à la base de données LiveCycle 81
N
nombre de threads, maximal, modification 57
numéros de port, personnalisation pour JBoss 86
Index
149
Adobe LiveCycle
Installation et configuration de LiveCycle pour JBoss
P
paramètres SMTP, configuration pour BAM Server 91
performances de transfert de documents, augmentation 143
performances, Windows Server, amélioration 145
pilote JDBC
plusieurs produits LiveCycle, installation et déploiement 12
police
polices
installation pour documents convertis 32
intégration aux formulaires compatibles PDF/A 115
sélection à utiliser avec LiveCycle Forms 51
pool de connexion, application d'un correctif à Watched Folder 66
port HTTP, LiveCycle Workflow Designer 99
port JNDI
LiveCycle Workflow Designer 99
prise en charge de JDK 14 prise en charge du navigateur Web 14
processus de flux de production, création 106
produits Adobe LiveCycle
développement de formulaires 114
mise à niveau vers 7.2 ou 7.2.1 118
mises à jour des informations 10
propriétés de configuration, récupération pour la mise à niveau 121
propriétés des actions,QPAC Assembler 107
Q
QPAC
QPAC Assembler
création d'un processus de flux de production 107
R
référentiel, accès à l'aide de clients WebDAV 114
répertoire
répertoire de stockage global
répertoire endorsed, création 55
répertoires
S
serveur d'applications
serveur d‘applications
serveurs d'applications
service JBoss, désinstallation 116
Services Adobe LiveCycle, modification 25
soumission de travaux LiveCycle Assembler à traiter 113
sources de travaux, configuration 32
SQL Server
configuration des sources de données pour JBoss 62
connexion à la base de données LiveCycle 81
création d'une base de données JMS 46
SSL
configuration sur JBoss 72, 74
informations d'identification, création 72
suppression. Voir désinstallation
synchronisation de BAM avec le serveur LDAP 94, 97
systèmes d'exploitation
prise en charge de bases de données 15, 101
T
traitement des travaux LiveCycle Assembler 113
U
User Management. Voir Adobe User Management
V
vérification
déploiement de LiveCycle Assembler 27
déploiement de LiveCycle Forms 28 déploiement de LiveCycle Print 28
W
Watched Folder
appel de LiveCycle Assembler 105
application d'un correctif de pool de connexion 66
Index
150
