Déploiement de l'application Web sur WebSphere Application Server

Vous pouvez déployer l'application Web Rational Publishing Engine sur WebSphere Application Server versions 8.x ou suivantes avec IBM® DB2.

Avant de commencer

Il est impératif d'installer WebSphere Application Server versions 8.x ou suivantes et Rational Publishing Engine avec la fonction Services distants avant de déployer l'application Web.
Vous devez avoir accès aux fichiers suivants de l'application Web qui sont disponibles dans le répertoire RPE_HOME\remote-services :
  • 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. Déployez l'application Web sur le serveur.
  7. Créez une bibliothèque partagée pour l'application dgaas.
  8. Configurez les utilisateurs pour l'application Web sur WebSphere Application Server.
  9. Associez les bibliothèques partagées aux applications.
  10. 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 en tant que 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 souhaité pour déployer l'application Web (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.

Déploiement de l'application Web sur WebSphere Application Server

Avant de commencer

  • Créez une base de données pour Rational Publishing Engine dans DB2
  • Créez la source de données rpeng avec le nom JNDI : RPENG_DB
  • Créez la source de données DGAAS avec le nom JNDI : DGAAS_DB
Pour plus de détails, voir Configuration de WebSphere Application Server avec DB2 en tant que source de données.

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\remote-services\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.
    Conseil : Pour continuer cette étape, vous devez effectuer les étapes décrites dans la rubrique Configuration de WebSphere Application Server avec DB2 en tant que source de données.
    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 votre application Web est déployée sur le serveur, recherchez le message de sortie suivant qui s'affiche dans le journal de traitement :
    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 l'application Web sur le serveur :
    1. Cochez la case com.ibm.rpe.web.app, puis cliquez sur Démarrer.
    2. Si l'application Web 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.

Configuration d'utilisateurs pour l'application Web sur WebSphere Application Server

Pourquoi et quand exécuter cette tâche

Pour effectuer cette tâche, vous devez d'abord effectuer celles qui sont décrites dans la rubrique Configuration d'utilisateurs pour l'application Web 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. Voir Vérification de la variable d'environnement TELELOGIC_LICENSE_FILE.
  2. Redémarrez WebSphere Application Server.

Résultats

Vous pouvez vérifier que l'application Web est déployée 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.

L'application Web Rational Publishing Engine suivante devrait s'afficher dans votre navigateur :

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 Web Rational Publishing Engine indiquée dans 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 l'application Web.