Mise à niveau vers AEM 6.5 Forms LTS on OSGi upgrade-to-aem-forms-osgi

Installation du package complémentaire AEM Forms. Suivez les étapes ci-dessous :

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

2. Sélectionnez Adobe Experience Manager situé dans le menu d’en-tête.

3. Dans la section Filtres :

   1. Sélectionnez Forms 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. Sélectionnez le nom de package applicable à votre système d’exploitation, sélectionnez Accepter les conditions du CLUF, puis sélectionnez Télécharger.

5. Ouvrez le gestionnaire de modules et cliquez sur Charger le package pour charger le package.

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

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

   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 sans risque l’état de ces packages.

   Redémarrez l’instance AEM avec les paramètres de ligne de commande JVM supplémentaires suivants :
   --add-opens java.base/java.util=ALL-UNNAMED --add-exports=java.xml/com.sun.org.apache.xml.internal.serialize=ALL-UNNAMED

   Si le serveur est démarré via un script ou un service, mettez-le à jour en conséquence afin d’inclure les éléments ci-dessus, de sorte qu’ils soient également efficaces après les redémarrages suivants.

   note note
   NOTE
   Il est recommandé d’utiliser la commande « Ctrl+C » pour redémarrer le SDK. Le redémarrage du SDK AEM à l’aide de méthodes alternatives, par exemple l’arrêt des processus Java, peut entraîner des incohérences dans l’environnement de développement AEM.

Exécutez les activités postérieures à l’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 :

  code language-sql
  UPDATE metadata m, additionalmetadatatable am SET m.dataType = am.value WHERE m.id = am.id AND am.key = 'dataType'

  code language-sql
  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 Adobe Sign était configuré dans la version précédente d’AEM Forms, reconfigurez Adobe Sign à partir des services cloud d’AEM. Pour plus de détails, consultez la section Intégrer 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 Forms 6.4, la variable de trafic pour la source et l’événement de succès de 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. AEM 6.4 Forms introduit également une variable de trafic pour la version de l’analyse des formulaires et un événement de succès pour le temps passé sur un champ. Dès lors, vous devez reconfigurer les analyses et les rapports de votre environnement AEM Forms. Pour obtenir des instructions détaillées, consultez la section Configurer les analyses et les rapports.

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érifier la réplication et la réplication inverse : publiez, remplissez et envoyez quelques formulaires migrés. Vérifiez également les données envoyées.

• Vérifier l’accès aux interfaces utilisateur d’administration et de développement : connectez-vous à l’instance AEM à partir d’un compte d’administration 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

Accédez au portail de développement Red Hat :
https://developers.redhat.com/products/eap/download

Téléchargez la distribution JBoss EAP 8 ZIP pour Windows.

Extrayez le fichier ZIP téléchargé dans votre répertoire d’installation préféré.

Notez que ce chemin d’accès au répertoire est <JBOSS_HOME> à utiliser dans ce guide.

Exemple :
C:\jboss-eap-8.0

Créez un répertoire de travail temporaire :

C:\aem\war-config

Copiez cq-quickstart.war dans ce répertoire.

Ouvrez invite de commandes et accédez à votre répertoire de travail :

cd C:\aem\war-config

Extrayez le fichier WAR :

jar -xvf cq-quickstart.war

Vous créez ainsi une structure de répertoires avec des fichiers d’application WEB-INF et autres.

Accédez au répertoire WEB-INF dans le fichier WAR extrait :

cd WEB-INF

Créez un fichier nommé jboss-deployment-structure.xml.

Ajoutez le contenu XML suivant :

<?xml version="1.0" encoding="UTF-8"?>
<jboss-deployment-structure xmlns="urn:jboss:deployment-structure:1.2">
    <deployment>
        <dependencies>
            <module name="jdk.unsupported" />
        </dependencies>
    </deployment>
</jboss-deployment-structure>

Enregistrez et fermez le fichier.

Ouvrez WEB-INF\web.xml dans un éditeur de texte.

Recherchez la section <servlet> contenant la configuration du mode d’exécution :

<!-- Set the runmode per default to author -->
<init-param>
    <param-name>sling.run.modes</param-name>
    <param-value>author</param-value>
</init-param>
<load-on-startup>100</load-on-startup>
</servlet>

Remplacez la balise </servlet> de fermeture et la ligne précédente par :

<init-param>
    <param-name>sling.run.modes</param-name>
    <param-value>author</param-value>
</init-param>
<multipart-config>
    <max-file-size>1048576000</max-file-size>
    <max-request-size>1048576000</max-request-size>
    <file-size-threshold>0</file-size-threshold>
</multipart-config>
<load-on-startup>100</load-on-startup>
</servlet>

Enregistrez et fermez web.xml.

Revenez au répertoire de travail contenant le contenu extrait :

cd C:\aem\war-config

Créez le nouveau fichier WAR :

jar -cvf cq-quickstart.war *

Copiez le cq-quickstart.war recompilé dans le répertoire des déploiements de JBoss :

<JBOSS_HOME>\standalone\deployments

Exemple :
C:\jboss-eap-8.0\standalone\deployments

Ouvrez <JBOSS_HOME>\bin\standalone.conf.bat dans un éditeur de texte.

Modifiez ou ajoutez la ligne suivante pour définir la mémoire de segment :

set "JAVA_OPTS=-Xms4096m -Xmx4096m -XX:MaxMetaspaceSize=512m"

Ouvrez Invite de commandes en tant qu’administrateur.

Accédez au répertoire bin de JBoss :

cd <JBOSS_HOME>\bin

Exemple :
cmd cd C:\jboss-eap-8.0\bin

Démarrez le serveur JBoss :

standalone.bat -b 0.0.0.0 -bmanagement 0.0.0.0

Paramètres:

• -b 0.0.0.0 : lie le serveur à toutes les interfaces réseau
• -bmanagement 0.0.0.0 : lie l'interface de gestion à toutes les interfaces réseau