Installation d'un fichier Portal Application Archive (PAA)

Après avoir installé HCL Digital Experience, vous pouvez utiliser Solution Installer pour installer les applications qui sont au format Portal Application Archive (PAA).

Avant de commencer

Avant d'installer l'application, consultez le fichier Readme inclus pour obtenir des informations d'installation supplémentaires. Le fichier Readme est situé dans le fichier PAA extrait dans le répertoire de la documentation ou en dehors du fichier PAA dans un fichier de compression de niveau supérieur. Ajoutez des informations, telles que des noms d'assemblage et des paramètres supplémentaires, dont vous aurez peut-être besoin pour les tâches install-paa, update-paa-components ou deploy-paa dans le fichier Readme.
Cluster note : Exécutez les étapes suivantes sur le nœud principal, puis sur tous les nœuds supplémentaires.

Procédure

  1. Ouvrez une invite de commande.
  2. Placez-vous dans le répertoire wp_profile_root/ConfigEngine.
  3. Exécutez la commande suivante :
    • AIX® : ./ConfigEngine.sh install-paa -DPAALocation=paa_file_location -DWasPassword=password -DPortalAdminPwd=password
    • HP-UX: ./ConfigEngine.sh install-paa -DPAALocation=paa_file_location -DWasPassword=password -DPortalAdminPwd=password
    • IBM® i: ConfigEngine.sh install-paa -DPAALocation=paa_file_location -DWasPassword=password -DPortalAdminPwd=password
    • Linux™ : ./ConfigEngine.sh install-paa -DPAALocation=paa_file_location -DWasPassword=password -DPortalAdminPwd=password
    • Solaris: ./ConfigEngine.sh install-paa -DPAALocation=paa_file_location -DWasPassword=password -DPortalAdminPwd=password
    • Windows™ : ConfigEngine.bat install-paa -DPAALocation=paa_file_location -DWasPassword=password -DPortalAdminPwd=password
    • z/OS® : Appliquez la procédure suivante :
      1. Dans le panneau de configuration de Portal, sélectionnez Tâches de configuration d'application.
      2. Sélectionnez Configure content with Solution Installer.
      3. Sélectionnez Installer et déployer une solution.
      4. Sélectionnez Définir les variables.
        Reminder : Appuyez sur la touche F1 pour afficher le panneau d'aide si vous avez besoin d'assistance dans la définition des variables.
      5. Générez les travaux de personnalisation.
      6. Suivez les instructions de la boîte de dialogue de personnalisation pour soumettre les travaux de personnalisation. Si le travail se termine de façon abrupte ou est annulé sans message d'échec, supprimez tous les fichiers journaux du répertoire ConfigEngine/log avant d'exécuter à nouveau le travail.
    Optional parameter : Vous pouvez ajouter le paramètre facultatif suivant à la commande install-paa : -Dwcmdetect=true. Ce paramètre contrôle le comportement des bibliothèques installées HCL Web Content Manager. Si vous incluez ce paramètre, un fichier de propriétés est créé dans le répertoire paa/ComponentName. Le nom du fichier de propriétés correspond au nom de fichier PAA.
  4. A la fin de la tâche, vérifiez que le sous-répertoire suivant existe :
  5. Depuis le sous-répertoire de fichiers PAA, ouvrez le fichier components.properties. Procédez comme suit pour rechercher et résoudre les conflits avec les composants précédemment installés :
    1. Recherchez les paramètres des composants. Les paramètres affectés de la valeur true ne sont pas déjà installés. Les paramètres affectés de la valeur false sont déjà installés.
    2. Pour mettre à jour les composants existants, remplacez la valeur dans le fichier components.properties par true.
    3. Enregistrez vos modifications dans le fichier components.properties.
  6. Facultatif : Procédez comme suit si vous avez inclus le paramètre -Dwcmdetect=true :
    1. Ouvrez le fichier de propriétés dans le répertoire paa/ComponentName.
    2. Affectez à toutes les bibliothèques Web Content Manager à mettre à jour la valeur true.
    3. Affectez à toutes les bibliothèques Web Content Manager pour lesquelles vous voulez conserver l'ancienne version la valeur false.
    4. Sauvegardez vos modifications.
  7. Facultatif : Exécutez la tâche suivante si vous avez modifié des valeurs dans le fichier components.properties :

    Cette tâche met à jour l'enregistrement des composants existants sur ceux du nouvel assemblage.

    • AIX® : ./ConfigEngine.sh update-paa-components -DappName=assemblyName -DWasPassword=password -DPortalAdminPwd=password
    • HP-UX: ./ConfigEngine.sh update-paa-components -DappName=assemblyName -DWasPassword=password -DPortalAdminPwd=password
    • IBM® i: ConfigEngine.sh update-paa-components -DappName=assemblyName -DWasPassword=password -DPortalAdminPwd=password
    • Linux™ : ./ConfigEngine.sh update-paa-components -DappName=assemblyName -DWasPassword=password -DPortalAdminPwd=password
    • Solaris: ./ConfigEngine.sh update-paa-components -DappName=assemblyName -DWasPassword=password -DPortalAdminPwd=password
    • Windows™ : ConfigEngine.bat update-paa-components -DappName=assemblyName -DWasPassword=password -DPortalAdminPwd=password
    • z/OS® : Appliquez la procédure suivante :
      1. Dans le panneau de configuration de Portal, sélectionnez Tâches de configuration d'application.
      2. Sélectionnez Configure content with Solution Installer.
      3. Sélectionnez Installer et déployer une solution.
      4. Sélectionnez Définir les variables.
        Reminder : Appuyez sur la touche F1 pour afficher le panneau d'aide si vous avez besoin d'assistance dans la définition des variables.
      5. Générez les travaux de personnalisation.
      6. Suivez les instructions de la boîte de dialogue de personnalisation pour soumettre les travaux de personnalisation. If the job ends abruptly or is canceled without a failure message, remove all log files from the ConfigEngine/log directory before you rerun the job.
  8. Facultatif : Si vous utilisez le mécanisme SPNEGO (Simple and Protected GSS-API Negotiation Mechanism) pour une connexion unique, procédez comme suit pour le désactiver :
    1. Log on to WebSphere® Integrated Solutions Console.
    2. Accédez à Sécurité > Sécurité globale > Sécurité Web et SIP > Authentifications Web SPNEGO.
    3. Désélectionnez la case Activer SPNEGO.
    4. Sauvegardez vos modifications.
  9. Exécutez la tâche suivante pour déployer le contenu PAA sur HCL :
    • AIX® : ./ConfigEngine.sh deploy-paa -DappName=assemblyName -DWasPassword=password -DPortalAdminPwd=password
    • HP-UX: ./ConfigEngine.sh deploy-paa -DappName=assemblyName -DWasPassword=password -DPortalAdminPwd=password
    • IBM® i: ConfigEngine.sh deploy-paa -DappName=assemblyName -DWasPassword=password -DPortalAdminPwd=password
    • Linux™ : ./ConfigEngine.sh deploy-paa -DappName=assemblyName -DWasPassword=password -DPortalAdminPwd=password
    • Solaris: ./ConfigEngine.sh deploy-paa -DappName=assemblyName -DWasPassword=password -DPortalAdminPwd=password
    • Windows™ : ConfigEngine.bat deploy-paa -DappName=assemblyName -DWasPassword=password -DPortalAdminPwd=password
    • z/OS® : Appliquez la procédure suivante :
      1. Dans le panneau de configuration de Portal, sélectionnez Tâches de configuration d'application.
      2. Sélectionnez Configure content with Solution Installer.
      3. Sélectionnez Installer et déployer une solution.
      4. Sélectionnez Définir les variables.
        Reminder : Appuyez sur la touche F1 pour afficher le panneau d'aide si vous avez besoin d'assistance dans la définition des variables.
      5. Générez les travaux de personnalisation.
      6. Suivez les instructions de la boîte de dialogue de personnalisation pour soumettre les travaux de personnalisation. If the job ends abruptly or is canceled without a failure message, remove all log files from the ConfigEngine/log directory before you rerun the job.
    Clustered environment parameters : Si vous avez effectué un déploiement sur un environnement en cluster et que votre fichier PAA contient des fichiers script XMLAccess, ajoutez les deux paramètres suivants à la tâche deploy-paa :
    • -DmaxTimeToWait
    • -DmaxAppTimeToWait
    Ces valeurs définissent le délai d'attente avant lequel la tâche wplc-wait-for-sync-to-complete synchronise les nœuds. Les valeurs par défaut sont -DmaxTimeToWait=30 et -DmaxAppTimeToWait=5. Les valeurs sont exprimées en minutes. Ajoutez ces paramètres à votre tâche deploy-paa avec des valeurs qui répondent à vos besoins.
    Virtual portal parameters : Si vous effectuez le déploiement sur un portail virtuel, vous devez inclure la racine de contexte et les paramètres du nom d'hôte du portail virtuel. Ajoutez les paramètres -DVirtualPortalHostName et -DVirtualPortalContext à la tâche deploy-paa. Lisez la section Portails virtuels pour plus d'informations.
    Remarque : Par défaut, seuls les composants ayant pour valeur true dans le fichier components.properties sont déployés. Pour déployer tous les composants, ajoutez le paramètre -DforceDeploy=true à la tâche deploy-paa.
  10. Facultatif : Procédez comme suit pour activer SPNEGO :
    1. Log on to WebSphere® Integrated Solutions Console.
    2. Accédez à Sécurité > Sécurité globale > Sécurité Web et SIP > Authentifications Web SPNEGO.
    3. Désélectionnez la case Activer SPNEGO.
    4. Sauvegardez vos modifications.