Partie II : Installation, configuration et déploiement manuels. Adobe Workflow, Form Manager, PDF Generator, assembler, forms, PRINT
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.
Lien public mis à jour
Le lien public vers votre chat a été mis à jour.