Mise à jour d'un fichier Portal Application Archive (PAA) existant

Vous pouvez mettre à jour un fichier Portal Application Archive (PAA) existant lorsqu'une nouvelle version est disponible. Le processus n'est pas aussi simple que de remplacer le fichier par un nouveau contenu. Il peut y avoir des différences entre le contenu des deux versions de ce fichier.

Pourquoi et quand exécuter cette tâche

La commande install-paa-update crée une sauvegarde de votre fichier PAA en cours. Elle est stockée dans le répertoire wp_profile_root/paa/backup. La commande effectue ensuite les actions suivantes :
  • Elle désinstalle le fichier PAA d'HCL Digital Experience
  • Elle supprime le contenu du fichier PAA étendu
  • Elle installa la nouvelle version du fichier PAA.

Une fois que vous avez exécuté la commande install-paa-update, vous devez déployer les modifications sur votre système.

PAA file developer note : Mettez à jour le code personnalisé. Aucune génération de code n'est disponible pour une mise à niveau via le processus install-paa régulier. Pour plus d'informations, consultez le guide sur la création de fichiers PAA mis à jour.
Cluster note : Exécutez les étapes suivantes sur le noeud principal, puis sur tous les noeuds supplémentaires.

Procédure

  1. Ouvrez une ligne de commande.
  2. Placez-vous dans le répertoire wp_profile_root/ConfigEngine.
  3. Exécutez la tâche suivante pour mettre à jour le fichier PAA :
    • AIX® HP-UX Linux™ Solaris: ./ConfigEngine.sh install-paa-update -DPAALocation=paaLocation/yourPaa.paa -DappName=assemblyName -DWasPassword=password -DPortalAdminPwd=password
    • IBM® i: ConfigEngine.sh install-paa-update -DPAALocation=paaLocation/yourPaa.paa -DappName=assemblyName -DWasPassword=password -DPortalAdminPwd=password
    • Windows™ : ConfigEngine.bat install-paa-update -DPAALocation=paaLocation/yourPaa.paa -DappName=assemblyName -DWasPassword=password -DPortalAdminPwd=password
    • z/OS® :./ConfigEngine.sh install-paa-update -DappName=assemblyName -DWasPassword=password -DPortalAdminPwd=password
    Optional parameter : Vous pouvez ajouter le paramètre suivant à votre commande install-paa-update : -Dwcmdetect=true. This parameter controls the behavior of the installed HCL Web Content Manager libraries. 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 ayant pour valeur true ne sont pas déjà installés. Les paramètres ayant pour 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 la valeur true à toutes les bibliothèques Web Content Manager que vous souhaitez mettre à jour.
    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® HP-UXLinux™ Solaris: ./ConfigEngine.sh update-paa-components -DappName=assemblyName -DWasPassword=password -DPortalAdminPwd=password
    • IBM® i: 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® : ./ConfigEngine.sh update-paa-components -DappName=assemblyName -DWasPassword=password -DPortalAdminPwd=password
  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 désactiver 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.
  9. Exécutez la tâche suivante pour déployer le contenu PAA mis à jour sur HCL :
    • AIX® HP-UXLinux™ Solaris: ./ConfigEngine.sh deploy-paa -DappName=assemblyName -DWasPassword=password -DPortalAdminPwd=password
    • IBM® i: ConfigEngine.sh deploy-paa -DappName=assemblyName -DWasPassword=password -DPortalAdminPwd=password
    • Windows™ : ConfigEngine.bat deploy-paa -DappName=assemblyName -DWasPassword=password -DPortalAdminPwd=password
    • z/OS® : ./ConfigEngine.sh deploy-paa -DappName=assemblyName -DWasPassword=password -DPortalAdminPwd=password
    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 noeuds. 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. Read Virtual portals for information.
    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. Go to Security > Global security > Web and SIP security > SPNEGO Web authentication.
    3. Cochez la case Activer SPNEGO.
    4. Sauvegardez vos modifications.