Mise à niveau vers AEM 6.5 Forms on OSGi

Vous pouvez effectuer une mise à niveau directe à partir d’AEM 6.3 Forms ou AEM 6.4 Forms vers AEM 6.5 Forms.

Le chemin de mise à niveau direct d’AEM 6.0 Forms, AEM 6.1 Forms et AEM 6.2 Forms vers AEM 6.5 Forms n’est pas disponible. Effectuez une mise à niveau intermédiaire vers AEM 6.2 Forms, AEM 6.3 Forms ou AEM 6.4 Forms, puis effectuez une mise à niveau d’AEM 6.3 Forms ou AEM 6.4 Forms vers AEM 6.5 Forms.

Effectuez les étapes suivantes pour mettre à niveau AEM 6.3 Forms ou AEM 6.4 Forms vers AEM 6.5 Forms :

  1. Mettez à niveau l’instance AEM existante vers AEM 6.5. Les étapes sont énumérées ci-dessous :

    1. Installez le dernier Service Pack et les derniers correctifs pour AEM 6.3 Forms ou AEM 6.4 Forms. Pour plus d’informations, voir AEM Sustenance Hub.

    2. Préparez l’instance source pour la mise à niveau. Pour obtenir des instructions détaillées, reportez-vous à l’article Mise à niveau vers AEM 6.5.

    3. Téléchargez AEM 6.5 QuickStart.

    4. (Installations Unix/Linux uniquement) Si vous utilisez UNIX ou Linux en tant que système d’exploitation sous-jacent, ouvrez la fenêtre de terminal, accédez au dossier contenant crx-quickstart et exécutez la commande suivante :

      chmod -R 755 ../crx-quickstart

    5. Mettez à niveau votre instance AEM vers AEM 6.5. Pour obtenir des instructions étape par étape, voir Mettre à niveau vers AEM 6.5.

      Avant de passer aux étapes suivantes, attendez que le journal <crx-repository>/error.log contiennent les messages ServiceEvent REGISTERED et ServiceEvent UNREGISTERED.

      REMARQUE

      Une fois le serveur en marche, quelques lots AEM Forms conservent l’état d’installation. Le nombre de lots peut varier d’une installation à l’autre. Vous pouvez ignorer l’état de ces lots en toute sécurité. Les lots sont répertoriés à l’adresse https://'[serveur]:[port]'/system/console/.

  2. Installation du module complémentaire AEM Forms. Les étapes sont énumérées ci-dessous :

    1. Ouvrez la Distribution de logiciels. Vous avez besoin d’un Adobe ID pour vous connecter à la Distribution de logiciels.

    2. Appuyez sur Adobe Experience Manager disponible dans le menu d’en-tête.

    3. Dans la section Filtres :

      1. Sélectionnez Formulaires dans la liste déroulante Solution.
      2. Sélectionnez la version et le type du package. Vous pouvez également utiliser l’option Rechercher des téléchargements pour filtrer les résultats.
    4. Appuyez sur le nom applicable à votre système d’exploitation, sélectionnez Accepter les conditions du CLUF, puis appuyez sur Télécharger.

    5. Ouvrez Package Manager et cliquez sur Télécharger le package pour télécharger le package.

    6. Sélectionnez le pack et cliquez sur Installer.

      Vous pouvez également télécharger le pack via le lien direct répertorié dans l’article Versions d’AEM Forms.

      REMARQUE

      Une fois le package installé, vous êtes invité à redémarrer l’instance AEM. N’arrêtez pas le serveur immédiatement. Avant d’arrêter le serveur AEM Forms, attendez que les messages ServiceEvent REGISTERED et ServiceEvent UNREGISTERED cessent d’apparaître dans le fichier <crx-repository>/error.log et que le journal soit stable. Notez également que quelques packages peuvent rester à l’état installé. Vous pouvez ignorer l’état de ces packages en toute sécurité.

  3. Redémarrez l’instance AEM.

  4. Procédez aux activités de post-installation.

    • Exécuter l’utilitaire de migration

      L’utilitaire de migration rend les formulaires adaptatifs et les actions de gestion de la correspondance des versions antérieures compatibles avec les formulaires AEM 6.5. Vous pouvez télécharger l’utilitaire à partir de la Distribution de logiciels AEM. Pour des informations détaillées sur la configuration et l’utilisation de l’utilitaire de migration, voir l’utilitaire de migration.

      Si vous utilisez Exemple pour l’intégration du composant brouillons et envois avec la base de données et que vous mettez à niveau à partir d’une version précédente, exécutez les requêtes SQL suivantes après avoir effectué la mise à niveau :

      UPDATE metadata m, additionalmetadatatable am
      SET m.dataType = am.value
      WHERE m.id = am.id
      AND am.key = 'dataType'
      
      DELETE from additionalmetadatatable
      WHERE `key` = 'dataType'
      
    • (Si vous effectuez une mise à niveau à partir d’AEM 6.2 Forms ou de versions précédentes uniquement) Reconfigurer Adobe Sign

      Si vous avez configuré Adobe Sign dans la version précédente d’AEM Forms, reconfigurez Adobe Sign à partir des services cloud AEM. Pour plus d’informations, voir Incorporation d’Adobe Sign à AEM Forms.

    • Prise en charge de jQuery

      Dans AEM 6.5 Forms, la version de jQuery est mise à jour vers la version 3.2.1 et la version de l’interface utilisateur de jQuery est mise à jour vers la version 1.12.1. AEM Form utilise JQuery en mode noConflict. Ainsi, si vous utilisez une autre version de jQuery, aucun problème ne s’affiche lors de l’exécution d’une mise à niveau. Cependant, lorsque vous effectuez une mise à niveau vers AEM 6.5 Forms :

      • Assurez-vous que vos composants personnalisés, le cas échéant, sont compatibles avec les versions jQuery prises en charge.
      • Supprimez les API non prises en charge des composants personnalisés. Voir guide de mise à niveau pour la liste des API supprimées. Par exemple, la prise en charge des API load(), .unload() et .error() est supprimée. Utilisez la méthode .on() à la place des API mentionnées ci-dessus. Par exemple, remplacez $("img").load(fn) par $("img").on("load", fn).
    • (Si vous effectuez une mise à niveau à partir d’AEM 6.2 Forms ou de versions précédentes uniquement) Reconfigurez l’analyse et les rapports

      Dans AEM 6.4 Forms, la variable de trafic pour la source et l’événement de réussite pour l’impression ne sont pas disponibles. Ainsi, lorsque vous effectuez une mise à niveau à partir d’AEM 6.2 Forms ou de versions précédentes, AEM Forms cesse d’envoyer des données au serveur Adobe Analytics et les rapports d’analyse pour les formulaires adaptatifs ne sont pas disponibles. En outre, AEM 6.4 Forms introduit une variable de trafic pour la version de l’analyse de formulaire et de l’événement de réussite pour le temps passé sur un champ. Vous devez donc reconfigurer les analyses et les rapports pour votre environnement AEM Forms. Pour les étapes détaillées, voir Configuration des analyses et des rapports.

  5. Vérifiez que le serveur a été mis à niveau avec succès, que toutes les données ont également été migrées avec succès, et qu’il peut fonctionner normalement.

    • Vérifiez l’état des bundles : assurez-vous que tous les bundles sont actifs.

    • Vérifiez la réplication et la réplication inversée : publiez, remplissez et envoyez quelques formulaires migrés. Vérifiez également les données envoyées.

    • Vérifiez l’accès aux interfaces utilisateur d’administrateur et de développeur : connectez-vous à une instance d’AEM à partir d’un compte administrateur et vérifiez que vous avez accès aux URL suivantes :

      • https://'[server]:[port]'/crx/packmgr
      • https://'[server]:[port]'/crx/de
      • https://'[server]:[port]'/aem/forms.html/content/dam/formsanddocuments
    REMARQUE

    Dans AEM 6.4 Forms, la structure du référentiel crx a changé. Après la mise à niveau d’AEM 6.3 Forms vers AEM 6.5 Forms, utilisez les chemins d’accès modifiés pour la personnalisation que vous créez à nouveau. Pour la liste complète des chemins modifiés, voir Restructuration du référentiel des formulaires dans AEM.

Sur cette page