Initiation à IBM® Web Application Bridge

L'administrateur de portail collecte des informations sur le fournisseur de contenu et ses applications, puis suit les étapes de configuration de base pour activer Web Application Bridge.

Procédure

  1. Les étapes à exécuter pour activer Web Application Bridge varient selon que la racine de contexte de portail est retirée ou non. Pour savoir comment retirer la racine de contexte de portail, voir Instructions de l'assistant de configuration : Modify site URLs for search engine optimization.
    • Si la racine de contexte de portail est retirée, procédez comme suit :
      1. Exécutez la tâche suivante afin de créer un hôte virtuel pour Web Application Bridge. Cette tâche déploie le servlet de proxy inverse (RPS) sur l'hôte virtuel nouvellement créé et affecte à la racine de contexte RPS la valeur /, le tout automatiquement.
        • AIX® HP-UX Linux™ Solaris:./ConfigEngine.sh deploy-wab-virtual-host -DVirtualHostName=virtualHostName -DVirtualHostAlias=virtualHostAlias -DPortalAdminPwd=password -DPortalAdminId=PortalAdminId -DWasUserid=WasUserid -DWasPassword=password
        • Windows™ : ConfigEngine.bat deploy-wab-virtual-host -DVirtualHostName=virtualHostName -DVirtualHostAlias=virtualHostAlias -DPortalAdminPwd=password -DPortalAdminId=PortalAdminId -DWasUserid=WasUserid -DWasPassword=password
        • IBM® i: ConfigEngine.sh deploy-wab-virtual-host -DVirtualHostName=virtualHostName -DVirtualHostAlias=virtualHostAlias -DPortalAdminPwd=password -DPortalAdminId=PortalAdminId -DWasUserid=WasUserid -DWasPassword=password
        • z/OS® :./ConfigEngine.sh deploy-wab-virtual-host -DVirtualHostName=virtualHostName -DVirtualHostAlias=virtualHostAlias -DWasPassword=password

        virtualHostName est le nom de l'hôte virtuel ; par exemple, wab_host. virtualHostAlias représente le nom d'alias DNS qui est utilisé pour accéder aux applications sur l'hôte virtuel ; par exemple, wab.portal.com. Si virtualHostName et virtualHostAlias sont définis, les valeurs existantes sont utilisées. The task maps the virtualHostAlias on the same URI scheme (http or https) and port that the portal is deployed on.

        Sinon, utilisez un éditeur de texte pour ouvrir le fichier wkplc.properties dans le répertoire wp_profile_root /configEngine/properties. Ensuite, assurez-vous que les paramètres sont dotés des valeurs appropriées :
        • WasUserID
        • WasPassword
        • PortalAdminId
        • PortalAdminPwd
        A présent, vous pouvez exécuter la commande comme suit :
        • AIX® HP-UX Linux™ Solaris:./ConfigEngine.sh deploy-wab-virtual-host -DVirtualHostName=virtualHostName -DVirtualHostAlias=virtualHostAlias
        • Windows™ : ConfigEngine.bat deploy-wab-virtual-host -DVirtualHostName=virtualHostName -DVirtualHostAlias=virtualHostAlias
        • IBM® i: ConfigEngine.sh deploy-wab-virtual-host -DVirtualHostName=virtualHostName -DVirtualHostAlias=virtualHostAlias
        • z/OS® :./ConfigEngine.sh deploy-wab-virtual-host -DVirtualHostName=virtualHostName -DVirtualHostAlias=virtualHostAlias -DWasPassword=password
      2. Pour configurer la connexion unique entre le portail et l'alias d'hôte virtuel qui a été créé à l'étape précédente, procédez comme indiqué ci-après.
        • Log in to WebSphere® Integrated Solutions Console.
        • Go to Security > Global Security > Web and SIP security > Single sign-on (SSO).
        • Entrez le nom de domaine. Par exemple, si l'hôte de portail est portal.domain.ibm.com et que l'alias d'hôte virtuel (VHA) est wab.domain.ibm.com, la valeur de domaine est domain.ibm.com.
        • Redémarrez le serveur WebSphere_Portal.
      3. Entrez l'alias d'hôte virtuel pour configurer le serveur DNS afin de faire en sorte que l'alias d'hôte virtuel soit accessible depuis le poste de travail de l'utilisateur. L'alias d'hôte virtuel doit être accessible depuis tous les postes de travail à partir desquels un accès est établi au serveur de portail. Si le portail est accessible à l'aide du schéma https, assurez-vous que des certificats SSL valides pour les hôtes myhost1.servername.domain.ibm.com et myhost2.servername.domain.ibm.com sont installés. Pour installer les certificats SSL, connectez-vous à WebSphere® Integrated Solutions Console. Ensuite, accédez à Certificat SSL et gestion des clés > Magasins de clés et certificats > NodeDefaultKeyStore > Certificats personnels. Pour plus d'informations, voir Collection de certificats personnels. Si les certificats ne sont pas disponibles pour ces hôtes, vous devez accepter l'exception de sécurité dans le navigateur. Ouvrez l'URL iFrame d'ancrage Web dans une fenêtre de navigateur distincte. Ensuite, actualisez la page de portail pour qu'elle fonctionne et affiche l'application intégrée. Sinon, il se peut que l'application ne fonctionne pas.
    • Si la racine de contexte de portail n'est pas retirée, procédez comme suit :
      1. Définissez la racine de contexte pour l'application wp.vwat.servlet.ear :
        1. Log on to the WebSphere® Integrated Solutions Console.
        2. Go to Applications > Application Types > WebSphere enterprise applications.
        3. Find and click the wp.vwat.servlet.ear application link.
        4. Sous l'en-tête Web Module Properties, cliquez sur Context Root For Web Modules.
        5. Remplacez la racine de contexte par /. Cette étape peut créer des conflits de noms. Ajoutez une règle de réécriture pour éviter ces conflits. Pour plus d'informations, voir les rubriques sur Apache Module mod_rewrite et la spécification d'URL personnalisées courtes.
        6. Cliquez sur OK.
        7. Cliquez sur Sauvegarder pour sauvegarder les modifications que vous avez apportées à la configuration principale.
        8. Stop and restart the wp.vwat.servlet.ear application.
      2. Procédez comme suit si vous avez configuré un serveur Web :
        1. Log in to the WebSphere® Integrated Solutions Console.
        2. Accédez à Applications > Types d'application > Applications d'entreprise WebSphere > wp.vwat.servlet.ear > Gérer les modules.
        3. Procédez comme suit pour mapper l'application wp.vwat.servlet.ear au serveur Web : Pour plus d'informations, accédez au lien Afficher plus d'informations sur cette page dans WebSphere® Integrated Solutions Console.
          1. Cochez la case Sélectionner correspondant à l'application Servlet d'application Web virtuelle.
          2. Sélectionnez le serveur Web dans la zone Clusters et serveurs.
          3. Cliquez sur Appliquer.
        4. Choisissez l'une des options suivantes pour mettre à jour la configuration de plug-in :
          1. Procédez comme suit pour mettre à jour la configuration de plug-in pour toutes les applications WebSphere® Application Server :
            • Accédez à Serveurs > Types de serveur > Serveurs Web > webserver1 > Propriétés de plug-in.
            • Vérifiez que les deux cases à cocher suivantes sont sélectionnées :
              • Générer automatiquement le fichier de configuration du plug-in
              • Propager automatiquement le fichier de configuration du plug-in
            • Cliquez sur Appliquer pour sauvegarder vos modifications.
          2. Procédez comme suit pour mettre jour la configuration de plug-in uniquement pour l'application wp.vwat.servlet.ear :
            • Accédez au répertoire wp_profile_root/config/cells/cell_name /nodes/node_name/servers/web_server_name dans le profil de gestionnaire de déploiement.
            • Effectuez une copie de sauvegarde du fichier plugin-cfg.xml.
            • Ouvrez le fichier plugin-cfg.xml.
            • Ajoutez à l'élément UriGroup du cluster une ligne semblable à celle indiquée ci-dessous :
              <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name="/*"/>
            • Copiez dans le répertoire de base du serveur Web le fichier plugin-cfg.xml mis à jour.
      3. Redémarrez tous les serveurs.
  2. L'administrateur système se connecte à HCL Digital Experience.
  3. L'administrateur système clique sur l'icône Menu d'administration dans la barre d'outils. Il clique ensuite sur Gestion des portlets > Gestionnaire d'application Web virtuelle.
    Avertissement : Do not enter < or > into any of the text boxes.
  4. L'administrateur système clique sur Profils de fournisseur de contenu, puis sélectionne Créer un profil de fournisseur de contenu.
  5. L'administrateur système crée les profils de fournisseur de contenu.
  6. L'administrateur système accède au profil qui a été créé et clique sur Ajouter une règle pour créer une règle.
    Conseil : L'administrateur système doit créer au moins une règle pour le profil du fournisseur de contenu.
  7. L'administrateur système clique sur Applications d'ancrage Web, puis sélectionne Créer une application d'ancrage Web.
  8. L'administrateur système crée les applications d'ancrage Web.
  9. L'administrateur système accède à l'application qui a été créée.
  10. L'administrateur système sélectionne l'un des onglets suivants, puis clique sur Editer pour configurer les paramètres d'ancrage Web :
    Remarque : Si l'administrateur système modifie les informations d'hôte ou de port dans le profil du fournisseur de contenu, vous devez éditer l'application d'ancrage Web et resélectionner le profil. Sinon, l'application d'ancrage Web n'appliquera pas les modifications.
    • Paramètres d'affichage d'ancrage Web
    • IPC côté client pour l'ancrage Web
    • IPC côté serveur pour l'ancrage Web
    • Plug-in
  11. L'créateur de contenu se connecte à HCL.
  12. L'auteur de contenu accède à la barre d'outils du site et effectue l'une des actions suivantes :
    • Crée une page et ajoute le portlet d'Applications d'ancrage Web à la page.
    • Edite une page existante et joute le portlet d'Applications d'ancrage Web à la page.
    Conseil : To get the web dock application to render on a page, the page must either have the Web Dock profile or a profile that includes the wp_webdock module. Editez les propriétés de la page et modifiez le profil ou ajoutez le module wp_webdock au profil appliqué à la page :

    A compter du groupe de correctifs CF03, le profil d'ancrage Web n'existe plus. Si vous utilisez le regroupeur de ressources pour les portlets, aucune autre étape n'est requise. Si vous n'utilisez pas le regroupeur de ressources pour les portlets, ajoutez le module wp_webdock à un profil existant sur votre page.

    1. Connectez-vous au référentiel de thème avec la connexion fs-type1.
    2. Accédez à votre thème.
    3. Ouvrez le fichier de profil dans le répertoire /profiles.
    4. Effectuez une copie du fichier de profil et affectez-lui un nom unique.
    5. Editer le fichier .json et ajoutez l'ID de module wp_webdock.
    6. Copiez le profil que vous avez créé dans le répertoire /profiles.
    7. Invalidez le cache d'agrégateur de ressources pour intégrer vos modifications. Click the Administration menu icon in the toolbar. Cliquez ensuite sur Analyseur de thème > Utilitaires > Centre de contrôle > Invalider le cache. L'invalidation automatique reconnaît automatiquement les modifications apportées aux thèmes basés sur WebDAV. Aucune autre action n'est requise. Pour plus d'informations, voir Utilitaires.
  13. Si un auteur de contenu a des difficultés à afficher les applications d'ancrage Web, procédez comme suit pour mettre à jour le rôle utilisateur :
    1. Log on to HCL as the administrator.
    2. Click the Administration menu icon in the toolbar. Then, click Access > Resource Permissions.
    3. Recherchez la page qui contient l'application d'ancrage Web.
    4. Accordez à l'auteur de contenu les droits d'accès appropriés à la page.
    5. Si la stratégie du fournisseur de contenu est définie pour utiliser l'authentification de base ou par formulaire, procédez comme suit :
      • Accédez à l'application d'ancrage Web et accordez les droits appropriés à l'utilisateur de contenu.
      • Accédez au coffre des identifications utilisé pour l'authentification. Accordez à l'utilisateur de contenu les droits d'accès appropriés sur le coffre des identifications.