Déploiement de Document Builder sur WebSphere Application Server

Vous pouvez déployer Rational Publishing Engine Document Builder sur WebSphere Application Server version 8.x ou postérieure avec IBM® DB2 ou Oracle.

Avant de commencer

Vous devez installer WebSphere Application Server version 8.x ou postérieure et Rational Publishing Engine avec la fonction RPE Document Builder avant de déployer Document Builder.
Vous devez avoir accès aux fichiers suivants de Document Builder dans le répertoire RPE_HOME\document-builder :
  • Fichier com.ibm.rpe.web.app.ear (ou fichiers rpeng.war et dgaas.war)
A faire : L'application d'entreprise com.ibm.rpe.web.app.ear est une offre groupée de deux applications Web : rpeng.war et dgaas.war. Vous avez le choix entre les deux options de déploiement suivantes :
  • Déployer uniquement l'application d'entreprise com.ibm.rpe.web.app.ear
  • Déployer ensemble les deux applications Web rpeng.war et dgaas.war
Le scénario de déploiement et les exemples montrent illustrent le processus de déploiement de l'application d'entreprise com.ibm.rpe.web.app.ear uniquement.

Procédure

  1. Définissez la sécurité globale.
  2. Définissez la machine JVM.
  3. Définissez la gestion de session.
  4. Définissez la variable d'environnement.
  5. Redémarrez le serveur.
  6. Pour DB2 : Configuration de WebSphere Application Server avec DB2 comme source de données.
  7. Pour Oracle : Configuration de WebSphere Application Server avec Oracle comme source de données.
  8. Déployez Document Builder sur le serveur.
  9. Créez une bibliothèque partagée pour l'application dgaas.
  10. Configurez les utilisateurs pour Document Builder sur WebSphere Application Server.
  11. Associez les bibliothèques partagées aux applications.
  12. Configurez la variable de gestion des licences.

Définition de la sécurité globale sur WebSphere Application Server

Procédure

  1. Démarrez WebSphere Application Server.
  2. Ouvrez la console d'administration dans un navigateur : https://serveur:port/ibm/console

    Par exemple : https://hôte_local:9043/ibm/console

  3. Développez Sécurité et cliquez sur Sécurité globale.
  4. Dans la section Sécurité d'application, vérifiez que la case Activer la sécurité des applications est cochée.
  5. Dans la section Java™ 2, désélectionnez toutes les options. Si l'option Prévenir si des applications accordent des droits d'accès personnalisés est sélectionnée et ne peut pas être éditée :
    1. Sélectionnez l'option Utiliser la sécurité Java 2 pour limiter l'accès aux applications par les ressources locales. L'option Prévenir si des applications accordent des droits d'accès personnalisés est activée.
    2. Désélectionnez l'option Prévenir si des applications accordent des droits d'accès personnalisés.
    3. Désélectionnez l'option Utiliser la sécurité Java 2 pour limiter l'accès de l'application aux ressources locales.
  6. Cliquez sur Appliquer.
  7. Cliquez sur Sauvegarder pour sauvegarder directement les changements apportés à la configuration principale.

Résultats

Capture d'écran de la page Sécurité globale dans WebSphere Application Server

Définition de la machine virtuelle Java

Pourquoi et quand exécuter cette tâche

Définissez les paramètres de la machine virtuelle Java (JVM) suivants dans les propriétés personnalisées de votre serveur d'applications :
  • com.ibm.websphere.jaxrs.server.DisableIBMJAXRSEngine=true
  • org.eclipse.emf.common.util.URI.archiveSchemes=wsjar wszip jar zip

Procédure

  1. Ouvrez la console d'administration dans un navigateur : https://serveur:port/ibm/console

    Par exemple : https://hôte_local:9043/ibm/console

  2. Développez Serveurs > Types de serveurs, puis cliquez sur Serveurs d'applications WebSphere.
  3. Dans la section Serveurs d'applications, cliquez sur votre lien de serveur, par exemple, server1.
  4. Dans l'onglet Configuration, sous la section Infrastructure de serveur, développez Gestion Java et des processus et cliquez sur le lien Définition des processus.
  5. Sous la section Propriétés supplémentaires, cliquez sur le lien Machine virtuelle Java.
  6. Sous la section Propriétés supplémentaires, cliquez sur le lien Propriétés personnalisées.
  7. Dans la table Propriétés personnalisées, cliquez sur Nouvelle.
  8. Sous la section Propriétés générales, spécifiez les valeurs suivantes pour chaque entrée et cliquez sur OK :
    Tableau 1. Propriétés JVM personnalisées pour WebSphere Application Server
    Nom Valeur Description
    com.ibm.websphere.jaxrs.server.DisableIBMJAXRSEngine true Désactive IBM JAXRS
    org.eclipse.emf.common.util.URI.archiveSchemes wsjar wszip jar zip  
  9. Cliquez sur Sauvegarder pour sauvegarder directement les changements apportés à la configuration principale.

Résultats

Capture d'écran de la page Propriétés personnalisées dans la console d'administration de WebSphere Application Server

Paramètres de gestion de session

Pourquoi et quand exécuter cette tâche

Définissez les paramètres de gestion de session suivants dans les propriétés personnalisées de votre serveur d'applications :
  • InvalidateOnUnauthorizedSessionRequestException=true

Procédure

  1. Ouvrez la console d'administration dans un navigateur : https://serveur:port/ibm/console

    Par exemple : https://hôte_local:9043/ibm/console

  2. Développez Serveurs > Types de serveurs, puis cliquez sur Serveurs d'applications WebSphere.
  3. Dans la section Serveurs d'applications, cliquez sur votre lien de serveur, par exemple, server1.
  4. Dans l'onglet Configuration, sous la section Paramètres du conteneur, cliquez sur le lien Gestion de session.
  5. Sous la section Propriétés supplémentaires, cliquez sur le lien Propriétés personnalisées.
  6. Dans la table Propriétés personnalisées, cliquez sur Nouvelle.
  7. Sous la section Propriétés générales, spécifiez la valeur suivante et cliquez sur OK :
    Tableau 2. Propriété Gestion de session personnalisée pour WebSphere Application Server
    Nom Valeur Description
    InvalidateOnUnauthorizedSessionRequestException true En réponse à une demande non autorisée, le gestionnaire de session invalide une session au lieu d'émettre un message d'erreur UnauthorizedSessionRequestException.
  8. Cliquez sur Sauvegarder pour sauvegarder directement les changements apportés à la configuration principale.

Résultats

Capture d'écran de la page Propriétés de gestion de session dans la console d'administration de WebSphere Application Server

Définition de la variable d'environnement

Procédure

  1. Ouvrez la console d'administration dans un navigateur : https://serveur:port/ibm/console

    Par exemple : https://hôte_local:9043/ibm/console

  2. Développez Serveurs > Types de serveurs, puis cliquez sur Serveurs d'applications WebSphere.
  3. Dans la section Serveurs d'applications, cliquez sur votre lien de serveur, par exemple, server1.
  4. Dans l'onglet Configuration, sous la section Infrastructure de serveur, développez Gestion Java et des processus et cliquez sur le lien Définition des processus.
  5. Dans l'onglet Configuration, sous la section Propriétés supplémentaires, cliquez sur le lien Entrées d'environnement.
  6. Dans la table Entrées d'environnement, cliquez sur Nouvelle.
  7. Sous la section Propriétés générales, spécifiez les valeurs suivantes pour chaque entrée et cliquez sur OK :
    Tableau 3. Propriétés de la variable d'environnement pour WebSphere Application Server
    Nom Valeur Description
    DGAAS_URL http://<IP_serveur>:<port>/dgaas/ Variable d'environnement du service de génération de document
    VCAP_SERVICES {"sqldb": [{}]} Lorsque vous utilisez DB2 ou Oracle comme base de données, vous devez définir cette variable d'environnement.
    Capture d'écran de la page Entrées d'environnement dans la console d'administration de WebSphere Application Server.
  8. Cliquez sur Sauvegarder pour sauvegarder directement les changements apportés à la configuration principale.

Redémarrez WebSphere Application Server.

Pourquoi et quand exécuter cette tâche

Redémarrez le profil WebSphere Application Server voulu pour le déploiement de Document Builder (com.ibm.rpe.web.app.ear, ou sinon les fichiers rpeng.war et dgaas.war) :

Procédure

  1. Arrêtez WebSphere Application Server.
  2. Démarrez WebSphere Application Server.

Configuration de WebSphere Application Server avec DB2 en tant que source de données

Vous devez préparer une base de données DB2 et configurer la connexion avec Document Builder sur WebSphere Application Server.

Avant de commencer

Vous devez créer une base de données IBM DB2 pour Rational Publishing Engine Document Builder. Cette base de données doit avoir 16K pages et le jeu de codes UTF-8. Par exemple, pour créer une base de données nommée rpedb2 avec 16K pages et le jeu de codes UTF-8, utilisez la commande suivante :
db2 CREATE DATABASE rpedb1 AUTOMATIC STORAGE Yes USING CODESET UTF-8
    TERRITORY US COLLATE USING SYSTEM PAGESIZE 16384;
Dans cet exemple, la base de données s'appelle rpedb1. Pour plus d'informations sur la création d'une base de données, reportez-vous à la documentation du produit DB2.

Création d'un fournisseur JDBC

Procédure

  1. Démarrez WebSphere Application Server.
  2. Ouvrez la console d'administration dans un navigateur : https://serveur:port/ibm/console et connectez-vous.

    Par exemple : https://hôte_local:9043/ibm/console

  3. Sélectionnez Ressources > JDBC > Fournisseurs JDBC.
  4. Définissez la cellule comme la portée.
    Cellule
  5. Cliquez sur Nouveau.
  6. Dans l'assistant Créer un fournisseur JDBC, sélectionnez :
    1. Type de base de données : DB2
    2. Type de fournisseur : Fournisseur de pilotes DB2 Universal
    3. Type d'implémentation : Source de données XA
    4. Type d'implémentation : Entrez un nom, par exemple, RPE.
    Assistant Créer un fournisseur JDBC
  7. Cliquez sur Suivant.
  8. Dans la section de saisie d'informations sur le chemin d'accès aux classes de la base de données, entrez le chemin d'accès aux classes. Remplacez DB2UNIVERSAL_JDBC_DRIVER_PATH par le répertoire contenant vos fichiers .jar DB2 :
    <DB2UNIVERSAL_JDBC_DRIVER_PATH>/db2jcc.jar
    <DB2UNIVERSAL_JDBC_DRIVER_PATH>/db2jcc_license_cu.jar
    <DB2UNIVERSAL_JDBC_DRIVER_PATH>/db2jcc_license_cisuz.jar
  9. Entrez l'emplacement du répertoire pour le fichier "db2jcc.jar, db2jcc_license_cisuz.jar", qui est sauvegardé en tant que variable WebSphere ${DB2UNIVERSAL_JDBC_DRIVER_PATH}. Par exemple, C:\Program Files\IBM\SQLLIB\java.
  10. Entrez le chemin de bibliothèque native. Par exemple, C:\Program Files\IBM\SQLLIB\java.
  11. Cliquez sur Appliquer.
    Saisie des informations sur le chemin d'accès aux classes de la base de données
  12. Vérifiez que le chemin de bibliothèque native est correct, puis cliquez sur Suivant.
    Chemin de bibliothèque native
  13. Examinez la page de récapitulatif, puis cliquez sur Terminer.
    Chemin de bibliothèque native
  14. Sauvegardez les changements apportés à la configuration principale.

Création d'une source de données pour l'application rpeng

Procédure

  1. Accédez au fournisseur JDBC que vous venez de créer.
    1. Cliquez sur Sources de données.
      Lien Sources de données
    2. Dans la zone Nom de la source de données, entrez rpeng.
    3. Dans la zone Nom JNDI, entrez RPENG_DB et cliquez sur Suivant.
      Saisie des informations de base sur la source de données
  2. Entrez les propriétés spécifiques à la base de données pour la source de données, puis cliquez sur Suivant.
    1. Affectez à l'option Type de pilote la valeur 4.
    2. Dans la zone Nom de la base de données, entrez le nom de la base de données.
    3. Dans la zone Nom du serveur, entrez le nom d'hôte de la machine sur laquelle DB2 s'exécute.
    4. Dans la zone Numéro de port, entrez le numéro de port de votre base de données DB2.
      Saisie des propriétés spécifiques à la base de données pour la source de données
  3. Dans la section de configuration des alias de sécurité, cliquez sur Suivant.
  4. Examinez la page de récapitulatif, puis cliquez sur Terminer.
    Récapitulatif de la source de données
  5. Sauvegardez les changements apportés à la configuration principale.

Création d'une source de données pour l'application dgaas

Procédure

Répétez les étapes décrites dans la rubrique Création d'une source de données pour l'application rpeng, en définissant DGAAS pour le Nom de la source de données et DGAAS_DB pour le Nom JNDI.
Saisie des informations de base sur la source de données

Création d'une entrée de données d'authentification

Procédure

  1. Accédez au fournisseur JDBC RPE et cliquez sur Sources de données.
  2. Sur la page Sources de données, cliquez sur la source de données rpeng.
  3. Dans la section Eléments associés, cliquez sur Données d'authentification JAAS-J2C.
  4. Cliquez sur Nouveau.
  5. Entrez les informations d'authentification pour votre base de données :
    • Pour DB2 : Entrez l'alias, l'ID utilisateur et le mot de passe DB2 et cliquez sur OK.
      Nouvelles données d'authentification
    • Pour Oracle : Entrez l'alias, l'ID utilisateur et le mot de passe Oracle et cliquez sur OK.
      Nouvelles données d'authentification
  6. Sauvegardez les changements apportés à la configuration principale.
  7. Revenez à votre source de données rpeng.
  8. Dans les paramètres Sécurité, sélectionnez la base de données rpedb1 pour les options suivantes :
    1. Alias d'authentification pour la récupération XA
    2. Alias d'authentification gérés par le composant
    3. Alias d'authentification gérés par le conteneur
    Paramètres de sécurité
  9. Cliquez sur OK pour sauvegarder.
  10. Accédez de nouveau à la source de données rpeng et cliquez sur Tester la connexion pour tester la source de données.
    Réussite du test de connexion
  11. Répétez les étapes 7 à 10 avec la source de données dgaas.

Configuration de WebSphere Application Server avec Oracle comme source de données

Vous devez préparer une base de données Oracle et configurer la connexion avec Document Builder sur WebSphere Application Server.

Avant de commencer

  • Pour créer et configurer une base de données Oracle, l'utilisateur qui prépare la base de données doit disposer de droits d'administration sur la base de données. Cette dernière, ainsi que le stockage de l'espace table et la configuration de stockage appropriée sont créés par un utilisateur doté de droits d'administration système.
  • Selon la version d'Oracle que vous utilisez, le pilote JDBC (Java Database Connectivity) requis est ojdbc7.jar.
  • Pour obtenir la liste des versions de base de données et des pilotes JDBC supportés, voir http://www.ibm.com/software/reports/compatibility/clarity/softwareReqsForProduct.html.
  • Les paramètres de configuration et les options d'espace table utilisés dans cette rubrique sont des exemples et peuvent ne pas s'appliquer en totalité à votre environnement. Par exemple, si vous ne pouvez pas utiliser le paramètre AUTOEXTEND, les fichiers doivent être suffisamment volumineux pour autoriser un accroissement. Ou bien si vous ne pouvez pas utiliser le quota de taille UNLIMITED pour votre utilisateur de base de données, autorisez suffisamment d'espace pour un accroissement rapide.
  • La base de données que vous créez pour l'application Document Builder doit être formatée pour utiliser le jeu de caractères UTF-8. Par défaut, Oracle ne crée pas les bases de données avec ce jeu de caractères. Lorsque vous créez une nouvelle base de données, sélectionnez bien AL32UTF8 dans la configuration de base de données Oracle.

Créer une base de données et un espace de table

Procédure

  1. En tant qu'administrateur système, créez une base de données, par exemple rpedb avec codage UTF-8 pour Document Builder.
    1. Démarrez l'Assistant de configuration de base de données puis, dans la page d'accueil, cliquez sur Suivant.
    2. Sur la page Opérations, sélectionnez Créer une base de données et cliquez ensuite sur Suivant.
    3. Sur la page des Modèles, sélectionnez Base de données personnalisée et cliquez sur Suivant.
    4. Dans les deux zones Global Database Name et SID, entrez le nom de base de données de stockage de contenu, par exemple CLMDB. Cliquez sur Suivant.
    5. Pour configurer le contrôle de base de données, entrez les informations requises pour la notification d'alerte et (facultatif) activez le planning de sauvegarde de disque quotidien. Pour continuer sans la configuration du contrôle de base de données, cochez la case en regard de Configure Enterprise Manager puis cliquez sur Suivant.
    6. Sur la page des informations d'identification de la base de données, choisissez une option pour votre compte d'utilisateur et cliquez ensuite sur Suivant.
      Remarque : La politique en matière de complexité du mot de passe Oracle exige des mots de passe de 8 caractères minimum. En outre, le mot de passe doit contenir au moins un caractère en majuscule, un caractère en minuscule et un chiffre.
    7. Sur la page suivante, sélectionnez un type de stockage et l'emplacement des fichiers de la base de données. Cliquez sur Suivant.
    8. Sur la page suivante, choisissez une option de récupération de la base de données, puis cliquez sur Suivant.
    9. Sur la page suivante, spécifiez s'il faut ou non ajouter les exemples de schémas à votre base de données. Cliquez sur Suivant.
    10. Sur la page suivante, cliquez sur l'onglet des jeux de caractères et sélectionnez l'option d'utilisation d'Unicode (AL32UTF8). Cliquez sur Suivant.
      Remarque : La sélection du jeu de caractères Unicode (AL32UTF8) vous permet de stocker plusieurs groupes de langues.
    11. Sur la page de stockage de la base de données, vérifiez ou modifiez les objets de base de données et cliquez sur Suivant.
    12. Sur la page suivante, cliquez sur Terminer pour créer la base de données.
    13. Dans la fenêtre Confirmation qui s'affiche, sauvegardez la page le cas échéant en tant que fichier HTML puis cliquez sur OK. Une barre de progression s'affiche afin d'indiquer l'avancement de la création de la base de données.
  2. Ouvrez une fenêtre SQL *Plus et connectez-vous en tant que SYSTEM ou SYSDBA.
  3. Accédez à [RépInstallOracle]/dbhome_1/bin, par exemple /u01/app/oracle/product/12.1.0/dbhome_1/bin, et entrez la commande suivante, motdepasse étant votre mot de passe :
    ./sqlplus sys/[motdepasse]@RPEDB as sysdba
    Connexion à Oracle
  4. Créez un espace de table pour Rational Publishing Engine.

    Pour créer un espace de table pour Rational Publishing Engine, entrez la commande suivante. Remplacez RPE par le nom de l'espace de table, ORACLE_BASE par le chemin d'installation absolu d'Oracle, RPEDB par le nom de la base de données que vous avez créée à l'étape 1, et RPE.DBF par le nom du fichier de données que vous voulez créer.

    CREATE TABLESPACE RPE 
    DATAFILE 'ORACLE_BASE/oradata/RPEDB/RPE.DBF' 
    SIZE 1G AUTOEXTEND ON EXTENT MANAGEMENT LOCAL AUTOALLOCATE;
    Exemple :
    CREATE TABLESPACE RPEDB_TS DATAFILE '/u01/app/oracle/oradata/RPEDB/RPEDB_TS.dbf' SIZE 1G
            AUTOEXTEND ON EXTENT MANAGEMENT LOCAL AUTOALLOCATE;
  5. Créez un espace de table temporaire pour Rational Publishing Engine. Pour créer un espace de table temporaire pour Rational Publishing Engine, entrez la commande suivante. Remplacez RPE_TEMP par le nom de l'espace de table temporaire, ORACLE_BASE par le chemin d'installation absolu d'Oracle, RPEDB par le nom de la base de données que vous avez créée à l'étape 1, et RPE_TEMP.DBF par le nom du fichier temporaire que vous voulez créer.
    CREATE TEMPORARY TABLESPACE RPE_TEMP 
    TEMPFILE 'ORACLE_BASE/oradata/RPEDB/RPE_TEMP.DBF' 
    SIZE 20M AUTOEXTEND ON EXTENT MANAGEMENT LOCAL UNIFORM SIZE 1M;
    Exemple :
    CREATE TEMPORARY TABLESPACE RPEDB_TEMP TEMPFILE
            '/u01/app/oracle/oradata/RPEDB/RPEDB_TEMP.DBF' SIZE 20M AUTOEXTEND ON EXTENT MANAGEMENT
            LOCAL UNIFORM SIZE 1M
  6. Connectez-vous au portail Oracle Enterprise Manager Database Control en tant qu'utilisateur sys. Cliquez sur Stockage > Espaces de table et vérifiez que les espaces de table que vous avez créés sont affichés et accessibles.
    Oracle Enterprise Manager
  7. Une fois les espaces créés, vous devez créer un utilisateur Oracle spécial pour l'utilisation de la base de données Oracle par chaque application. Dans cet exemple, un utilisateur RPE_USER est créé et autorisé. L'utilisateur de base de données Oracle doit pouvoir créer des objets de base de données dans son espace de table (sans limite ou avec un quota d'espace) avec des droits permettant de créer une session, une table, une procédure et des vues. Pour créer un utilisateur de base de données Oracle pour chaque nouvel espace de table, entrez la commande suivante. Remplacez USER_NAME par l'utilisateur que vous voulez créer, PASSWORD par le mot de passe de l'utilisateur, RPEDB_TS par le nom de l'espace de table que vous avez créé à l'étape 4, et RPEDB_TEMP par l'espace de table temporaire que vous voulez créer.
    CREATE USER  USER_NAME IDENTIFIED BY PASSWORD DEFAULT TABLESPACE RPEDB_TS QUOTA UNLIMITED ON
          RPEDB_TS TEMPORARY TABLESPACE RPEDB_TEMP;
    Exemple :
    CREATE USER  RPE_USER IDENTIFIED BY RPEt3st123 DEFAULT TABLESPACE RPEDB_TS QUOTA UNLIMITED
            ON RPEDB_TS TEMPORARY TABLESPACE RPEDB_TEMP;
  8. Pour accorder les droits nécessaires à l'espace de table, entrez les commandes suivantes :
    GRANT CREATE PROCEDURE, CREATE SESSION, CREATE TABLE, CREATE VIEW TO RPE_USER
  9. Maintenant, connectez-vous à SQL *Plus Editor en tant que RPE_USER et vérifiez que vous pouvez vous authentifier ; par exemple :
    ./sqlplus.sh rpe_user/RPEt3st123@RPEDB

Création d'un fournisseur JDBC

Procédure

  1. Démarrez WebSphere Application Server.
  2. Ouvrez la console d'administration dans un navigateur : https://serveur:port/ibm/console et connectez-vous.

    Par exemple : https://hôte_local:9043/ibm/console

  3. Sélectionnez Ressources > JDBC > Fournisseurs JDBC.
  4. Définissez la cellule comme la portée.
    Cellule
  5. Cliquez sur Nouveau.
  6. Dans l'assistant Créer un fournisseur JDBC, sélectionnez :
    1. Type de base de données : Oracle
    2. Type de fournisseur : Pilote JDBC Oracle
    3. Type d'implémentation : Source de données XA
    4. Type d'implémentation : Entrez un nom, par exemple RPE_Oracle.
    Assistant Créer un fournisseur JDBC
  7. Cliquez sur Suivant.
  8. Dans la section Entrer le chemin de classes de la base de données, vérifiez que la section chemin de classes pointe sur l'emplacement de ojdbc7.jar. Le cas échéant, remplacez ojdbc6.jar par ojdbc7.jar et cliquez sur Appliquer. Par exemple :
    ${ORACLE_JDBC_DRIVER_PATH}/odjbc7.jar 
  9. Entrez l'emplacement du répertoire du fichier "ojdbc7.jar", qui est enregistré dans la variable WebSphere ${ORACLE_JDBC_DRIVER_PATH} ; par exemple, /oracle_jdbc.
    Entrée du chemin de classes de la base de données
  10. Examinez la page de récapitulatif, puis cliquez sur Terminer.
    Chemin de bibliothèque native
  11. Sauvegardez les changements apportés à la configuration principale.

Création d'une source de données pour l'application rpeng

Procédure

  1. Accédez au fournisseur JDBC que vous venez de créer.
    1. Cliquez sur Sources de données.
      Lien Sources de données
    2. Dans la zone Nom de la source de données, entrez rpeng.
    3. Dans la zone Nom JNDI, entrez RPENG_DB et cliquez sur Suivant.
      Saisie des informations de base sur la source de données
  2. Entrez les propriétés spécifiques à la base de données pour la source de données, puis cliquez sur Suivant.
    1. Dans la zone URL, entrez l'URL de la base de données Oracle, par exemple jdbc:oracle:thin:@[serveur]:1521/RPEDB.
    2. Décochez la case Utiliser cette source de données dans la CMP (persistance gérée par conteneur) et cliquez sur Suivant.
      Entrée des propriétés spécifiques à la base de données pour la source de données
  3. Dans la section de configuration des alias de sécurité, cliquez sur Suivant.
  4. Examinez la page de récapitulatif, puis cliquez sur Terminer.
    Récapitulatif de la source de données
  5. Sauvegardez les changements apportés à la configuration principale.

Création d'une source de données pour l'application dgaas

Procédure

Répétez les étapes décrites dans la rubrique Création d'une source de données pour l'application rpeng, en définissant DGAAS pour le Nom de la source de données et DGAAS_DB pour le Nom JNDI.
Saisie des informations de base sur la source de données

Création d'une entrée de données d'authentification

Procédure

  1. Accédez au fournisseur JDBC RPE et cliquez sur Sources de données.
  2. Sur la page Sources de données, cliquez sur la source de données rpeng.
  3. Dans la section Eléments associés, cliquez sur Données d'authentification JAAS-J2C.
  4. Cliquez sur Nouveau.
  5. Entrez l'alias, l'ID utilisateur et le mot de passe Oracle et cliquez sur OK.
    Nouvelles données d'authentification
  6. Sauvegardez les changements apportés à la configuration principale.
  7. Revenez à votre source de données rpeng.
  8. Dans les paramètres Sécurité, sélectionnez la base de données rpedb pour les options suivantes :
    1. Alias d'authentification pour la récupération XA
    2. Alias d'authentification gérés par le composant
    3. Alias d'authentification gérés par le conteneur
    Paramètres de sécurité
  9. Cliquez sur OK pour sauvegarder.
  10. Accédez de nouveau à la source de données rpeng et cliquez sur Tester la connexion pour tester la source de données.
    Réussite du test de connexion
  11. Répétez les étapes 7 à 10 avec la source de données dgaas.

Déploiement de Document Builder sur WebSphere Application Server

Avant de commencer

Vérifiez que les actifs suivants sont créés :
  • Une base de données pour Rational Publishing Engine dans DB2 ou Oracle
  • Une source de données rpeng avec le nom JNDI RPENG_DB
  • Une source de données DGAAS avec le nom JNDI DGAAS_DB

Procédure

  1. Ouvrez la console d'administration dans un navigateur : https://serveur:port/ibm/console

    Par exemple : https://hôte_local:9043/ibm/console

  2. Développez Applications et cliquez sur Nouvelle application.
  3. Cliquez sur Nouvelle application d'entreprise.
  4. Dans la fenêtre Préparation de l'installation de l'application, spécifiez le chemin d'accès au fichier com.ibm.rpe.web.app.ear sur un système de fichiers local ou distant.
    • Si vous utilisez un fichier local, sélectionnez Système de fichiers local.
    • Si vous utilisez un fichier distant, sélectionnez Système de fichiers distant.
    Cliquez sur Parcourir pour spécifier le chemin d'accès au fichier com.ibm.rpe.web.app.ear ou entrez-le. Par défaut, le fichier archive se trouve dans RPE_HOME\document-builder\com.ibm.rpe.web.app.ear.
  5. Cliquez sur Suivant.
  6. Sélectionnez Raccourci - Ne demander que si des informations supplémentaires sont requises et cliquez sur Suivant.
  7. Dans la page Sélectionnez ces options d'installation, acceptez les paramètres par défaut, puis cliquez sur Suivant.
    Capture d'écran de la page Sélectionnez ces options d'installation dans la console d'administration de WebSphere Application Server.
  8. Dans la page Mappage des modules vers les serveurs, sélectionnez les modules Rational Publishing Engine et DGaaS, puis cliquez sur Suivant.
  9. Dans la page Mappage de références de ressources vers des ressources, vous devez spécifier la source de données pour les modules Rational Publishing Engine et DGaaS.
    1. Pour l'entrée du module Rational Publishing Engine, dans la colonne Nom JNDI de la ressource cible, cliquez sur Parcourir.
      Capture d'écran de la page Mappage de références de ressources vers des ressources dans la console d'administration de WebSphere Application Server.
    2. Dans la page Nouvelle application, sélectionnez l'option rpeng avec le nom JNDI défini sur RPENG_DB.
      Capture d'écran de la page Nouvelle application dans la console d'administration de WebSphere Application Server.
    3. Cliquez sur Appliquer.
    4. Répétez les étapes de la même manière pour l'entrée du module DGaaS. Dans la colonne Nom JNDI de la ressource cible, cliquez sur Parcourir.
    5. Dans la page Nouvelle application, sélectionnez l'option DGAAS en indiquant DGAAS_DB pour le nom JNDI.
    6. Cliquez sur Appliquer.
    7. Cliquez sur Suivant.
    Capture d'écran de la page Mappage de références de ressources vers des ressources dans la console d'administration de WebSphere Application Server.
  10. Dans la page Mappage des hôtes virtuels des modules Web, sélectionnez les modules Rational Publishing Engine et DGaaS, puis cliquez sur Suivant.
  11. Passez en revue le Récapitulatif, puis cliquez sur Terminer.
    Capture d'écran de la page Récapitulatif dans la console d'administration de WebSphere Application Server.
  12. Pour vérifier que Document Builder est bien déployé sur le serveur, recherchez le message de sortie suivant dans le journal du processus :
    Application com.ibm.rpe.web.app installée avec succès.
  13. Cliquez sur Sauvegarder pour sauvegarder directement les changements apportés à la configuration principale.
    Capture d'écran de la page Journal de traitement dans la console d'administration de WebSphere Application Server.
  14. Développez Applications > Types d'applications, puis cliquez sur Applications d'entreprise WebSphere. L'application com.ibm.rpe.web.app que vous avez ajoutée est répertoriée sous le nom d'application que vous avez entré.
  15. Dans la colonne Nom, cliquez sur le lien com.ibm.rpe.web.app.
    Capture d'écran de la page Applications d'entreprise dans la console d'administration de WebSphere Application Server.
  16. Dans la section des propriétés détaillées, cliquez sur le lien Chargement des classes et détection des mises à jour.
  17. Dans la section Ordre de chargeur de classe, sélectionnez l'option Classes chargées avec un chargeur de classes locales en premier (parent en dernier), puis cliquez sur OK.
    Capture d'écran de la page Chargeur de classe dans la console d'administration de WebSphere Application Server.
  18. Vérifiez les racines de contexte de l'application com.ibm.rpe.web.app :
    1. Sous la section Propriétés des modules Web, cliquez sur Racine de contexte des modules Web.
    2. Vérifiez que la racine de contexte spécifiée pour les modules Web correspond aux valeurs suivantes, puis cliquez sur OK :
      Tableau 4. Vérification des racines de contexte pour l'application com.ibm.rpe.web.app
      Module Web URI Racine de contexte
      Rational Publishing Engine com.ibm.rpe.web.ui.war, WEB-INF/web.xml rpeng
      DGaaS com.ibm.rpe.web.service.docgen.war, WEB-INF/web.xml dgaas
      Capture d'écran de la page Racine de contexte dans la console d'administration de WebSphere Application Server.
    3. Dans l'onglet Configuration, cliquez sur OK.
  19. Cliquez sur Sauvegarder pour sauvegarder directement les changements apportés à la configuration principale.
  20. Démarrez Document Builder sur le serveur :
    1. Cochez la case com.ibm.rpe.web.app, puis cliquez sur Démarrer.
    2. Si Document Builder démarre correctement sur le serveur, le message suivant s'affiche :
      Le démarrage de l'application com.ibm.rpe.web.app installée sur le serveur nom_serveur et le noeud  nom_noeud a réussi.  Vous serez peut-être amené à actualiser l'écran pour afficher le statut actuel.
      Capture d'écran de la page Applications d'entreprise dans la console d'administration de WebSphere Application Server.

Configurer les utilisateurs pour Document Builder sur WebSphere Application Server

Pourquoi et quand exécuter cette tâche

Pour effectuer cette tâche, vous devez effectuer les étapes de la rubrique Configuration des utilisateurs pour Document Builder sur WebSphere Application Server.

Création d'une bibliothèque partagée pour l'application dgaas

Procédure

  1. Accédez à la page Bibliothèques partagées.
  2. Cliquez sur Environnement > Bibliothèques partagées dans l'arborescence de navigation de la console.
  3. Sélectionnez une portée de bibliothèque partagée. Modifiez la portée de la table de collecte pour voir quelles bibliothèques partagées se trouvent dans une cellule, un noeud ou un serveur spécifique. Sélectionnez l'option Node et Server.
    Page Portée des bibliothèques partagées
  4. Cliquez sur Nouveau.
  5. Indiquez le nom, par exemple, dgaas.ear.
  6. Indiquez le chemin d'accès aux classes pour les fichiers HTTP .jar :
    <WAS_HOME>\profiles\AppSrv01\installedApps\<cell Name>\com.ibm.rpe.web.app.ear\dgaas.war\WEB-INF\lib\org.apache.httpcomponents.httpclient_<version>.jar
    <WAS_HOME>\profiles\AppSrv01\installedApps\<cell Name>\com.ibm.rpe.web.app.ear\dgaas.war\WEB-INF\lib\org.apache.httpcomponents.httpcore_<version>.jar
  7. Sélectionnez l'option de chargement de classe Utilisez un chargeur de classe isolé pour cette bibliothèque partagée, puis cliquez sur OK.
    Page Bibliothèques partagées pour la bibliothèque partagée au niveau du conteneur
  8. Cliquez sur Sauvegarder pour mettre à jour les changements apportés à la configuration principale.

Que faire ensuite

Conseil : Depuis Rational Publishing Engine version 2.0.1, il n'est plus nécessaire de créer la bibliothèque partagée supplémentaire, rpe.lib, pour utiliser une licence. Cette tâche est désormais automatisée.

Association de bibliothèques partagées à des applications

Procédure

  1. Cliquez sur Applications > Types d'applications > Applications d'entreprise WebSphere > com.ibm.rpe.web.app > Références de bibliothèque partagée pour accéder à la page Références de bibliothèque partagée.
    Page Bibliothèques partagées pour rpe.lib
  2. Sur la page Références de bibliothèque partagée, sélectionnez une application à laquelle vous souhaitez associer une bibliothèque partagée, com.ibm.rpe.web.app dans le cas présent.
  3. Cliquez sur Références de bibliothèque partagée.
    Page Références de bibliothèque partagée
    .
  4. Sur la page Mappage de bibliothèques partagées, sélectionnez la bibliothèque partagée dgaas.ear que l'application ou les modules utilisent.
  5. Cliquez sur >> pour déplacer les bibliothèques de la liste Disponibles vers la liste Sélectionnées.
    Page Mappage de bibliothèques partagées
  6. Sur la page Références de bibliothèque partagée, cliquez sur OK.
  7. Sauvegardez les changements apportés à la configuration principale.

Configuration de la variable d'attribution de licence

Procédure

  1. Vérifiez la variable d'environnement TELELOGIC_LICENSE_FILE. Par exemple, vous pouvez créer une variable d'environnement pour le fichier de licence dans WebSphere Application Server sur la page Entrées d'environnement :
    Ajout de la variable d'environnement Telelogic
    Pour Linux, le registe se trouve dans $HOME/.flexlmrc pour TELELOGIC_LICENSE_FILE.
  2. Redémarrez WebSphere Application Server.

Résultats

Vous pouvez vérifier que Document Builder est déployé en ouvrant l'URL suivante dans un navigateur : http://serveur:port/rpeng/
Conseil : Le message d'erreur suivant peut s'afficher dans le navigateur Web :
Error 500: com.ibm.websphere.servlet.session.UnauthorizedSessionRequestException:
    SESN0008E: A user authenticated as anonymous has attempted to access a session owned by
    user:defaultWIMFileBasedRealm/uid=rpe_designer,o=defaultWIMFileBasedRealm.
Pour résoudre cette erreur, veillez à définir la propriété InvalidateOnUnauthorizedSessionRequestException de gestion de session à true dans les propriétés personnalisées deWebSphere Application Server. Pour plus d'informations, voir la section Paramètres de gestion de session de cette rubrique.

Vous pouvez vous connecter en indiquant le nom d'utilisateur et le mot de passe de l'utilisateur approprié, tel que rpe_admin, rpe_designer ou rpe_user, et cliquer sur Connexion.

Capture d'écran du journal de l'application Web.

Votre navigateur devrait afficher l'application Document Builder pour Rational Publishing Engine suivante :

Page d'accueil de l'application Web

Vous pouvez vérifier le statut du service de génération de document en entrant http://serveur:port/dgaas/debug dans un navigateur.

Page d'accueil de l'application Web

Que faire ensuite

Au besoin, vous pouvez déployer et exécuter le modèle d'application Newskeeper qui utilise la technologie du service de génération de document pour générer des documents et qui fournit une interface de stockage pour les actifs et les documents de ce service. Pour plus de détails, voir Exécution du modèle Newskeeper.

Configurez l'application Rational Publishing Engine Document Builder indiquée sur la page http://serveur:port/rpeng/. Pour une explication sur la manière dont chaque URL est utilisée et sur les tâches de configuration de chacune des fonctions, voir Adresses URL de Document Builder.