Procédure : Fast upgrade Unica Interact

Avant de commencer

Respectez les conditions préalables à la mise à niveau d'Unica Interact 8.6.x/version ultérieure vers Unica Interact 12.1.

Procédure

  1. Assurez-vous que Unica Platform et Unica Campaign sont correctement mis à niveau dans la configuration cible. Installez Interact 12.1 dans la configuration.
  2. Effectuez une sauvegarde pour les bases de données de système source InteractDT, InteractRT, Interact Learning et Interact Production.
  3. Assurez-vous que les fichiers associés à Interact dans le dossier "partition" de Campaign sont copiés du système source vers le système cible.
  4. Restaurez le schéma de base de données sauvegardé sur le système cible.
  5. Créez des sources de données sur le serveur d'applications cible et pointez vers le nouveau schéma de base de données. Pour éviter des modifications manuelles, vous pouvez utiliser les mêmes noms JNDI que ceux du système source.
    Remarque : Veillez à conserver les mêmes noms de schéma cible que les noms de schéma de configuration de base.

Mise à niveau d'Interact DT

Procédure

  1. Mettez à jour setenv.sh avec les valeurs requises pour la mise à niveau. Pour plus de détails sur les variables d'environnement incluses dans le fichier setenv.sh, voir le guide de mise à niveau d'Interact.
    1. Accédez au chemin suivant : <Interact_Home>/interactDT/tools/upgrade/ et définissez les variables suivantes dans le fichier setenv.sh :

      set JAVA_HOME='<Installation Path >/jre'.

      set JDBCDRIVER_CP=Emplacement du pilote de base de données avec le pilote de base de données

      Par exemple : set JDBCDRIVER_CP=/opt/HCL/FastUpgrade12/ojdbc8.jar

      set JDBCDRIVER_CLASS=Datasase driver

      set JDBCDRIVER_URL= URL de la base de données

    2. Au besoin, renommez le fichier journal et modifiez son emplacement.
    3. Naviguez jusqu'à <Interact_Home>\interactDT\tools\upgrade\conf.
    4. Modifiez le fichier ACIUpgradeTaskList.properties et modifiez la valeur de CHOICES_FOR_PREVIOUS_VERSIONS=8.6.x ou une autre version de base à partir de laquelle vous effectuez la mise à niveau.
      Remarque : Si CHOICES_FOR_PREVIOUS_VERSIONS, depuis lequel vous effectuez la mise à niveau, est déjà présent, ne modifiez pas la valeur.

      Pour setenv.sh, vous devez mettre à jour le nom d’utilisateur en indiquant l’utilisateur réel qui exécute l’outil.

      Par exemple : vous devez mettre à jour cette entrée. - $whoami != "root" to $whoami != "username"

      Voici la liste des versions prises en charge pour la sélection d'une version précédente. Les utilisateurs peuvent sélectionner la version qui convient.
      • 8.6.x
      • 9.0.x
      • 9.1.0
      • 9.1.1
      • 9.1.2
      • 10.0.0
      • 10.1.0
      • 11.0.1
      • 11.1.0
      • 12.0.0
      • 12.1.0
  2. Respectez les conditions requises avant d'exécuter l'outil de mise à niveau d'Interact.
    Mettez à jour le fichier jdbc.properties sous :

    <Installation_Home>\install\

    <Interact_Home>\interactDT\tools\upgrade\conf

    Le fichier "jdbc.properties" doit contenir l'URL JDBC correcte, l'ID utilisateur de la base de données système Platform et le mot de passe chiffré. Si ces informations sont incorrectes, l'outil de mise à niveau d'Interact échoue avec des erreurs liées à l'authentification de la base de données.
  3. Exécutez le fichier "aciUpgradeTool.sh/bat" d'Interact. Cet outil de mise à niveau s'exécute de la même manière que l'outil acUpgradeToolexecution ordinaire de Campaign.
  4. Lors de l'exécution de l'outil de mise à niveau, vous êtes invité à fournir les détails de la base de données. Saisissez les détails de la base de données Interact DesignTime.
  5. L'outil vous invitera également à "sélectionner la version de base à mettre à niveau". Vous pouvez voir la version de mise à niveau spécifiée pour CHOICES_FOR_PREVIOUS_VERSIONS.
    Sélectionnez la version de base de la mise à niveau rapide à partir de laquelle la mise à niveau doit être effectuée.
  6. Au terme de l'exécution de l'outil de mise à niveau, vérifiez les journaux associés et assurez-vous qu'aucune erreur n'a été générée pendant la mise à niveau.

Mise à niveau des bases de données Interact RT, Interact Learning et Interact Production

Procédure

  1. Mettez à jour le fichier setenv.sh avec les valeurs requises pour la mise à niveau d'Unica Interact. Pour plus de détails sur les variables d'environnement incluses dans le fichier setenv.sh, voir le guide de mise à niveau d'Unica Interact.
    1. Naviguez jusqu'à <Interact_Home>/tools/upgrade. Définissez les variables suivantes dans le fichier setenv.sh :

      définissez JAVA_HOME = <Installation Path>/jre

      set JDBCDRIVER_CP= Emplacement du pilote de base de données avec le pilote de base de données

      ex : définissez JDBCDRIVER_CP = /opt/HCL/FastUpgrade12/ojdbc8.jar

      set JDBCDRIVER_CLASS = Pilote de la base de données

      set JDBCDRIVER_URL = URL de la base de données

      Si vous utilisez la même base de données avec des schémas différents, l'URL de la base de données peut être la même dans DB2 et Oracle.

      Si vous devez mettre à jour l'URL de la base de données pour SQLServer, mettez à jour la base de données correspondante avant d'exécuter l'outil de mise à niveau.

      Au besoin, renommez le fichier journal et modifiez son emplacement.

    2. Accédez à <Interact_Home>\tools\upgrade\conf, éditez le fichier ACIUpgradeTaskList_crhtab.properties et modifiez la valeur CHOICES_FOR_PREVIOUS_VERSIONS=8.6.x ou une autre version de base à partir de laquelle vous effectuez la mise à niveau.
      Remarque : Si CHOICES_FOR_PREVIOUS_VERSIONS, depuis lequel vous effectuez la mise à niveau, est déjà présent, alors n'apportez aucune modification à la valeur.
    3. Répétez cette modification pour les fichiers ACIUpgradeTaskList_lrntab.properties, ACIUpgradeTaskList_runtab.properties et ACIUpgradeTaskList_usrtab.properties au chemin d'accès mentionné ci-dessus.

    Pour setenv.sh, vous devez mettre à jour le nom d’utilisateur en indiquant l’utilisateur réel qui exécute l’outil.

    Par exemple : vous devez mettre à jour cette entrée. - $whoami != "root" to $whoami != "username"

    Voici la liste des versions prises en charge pour la sélection d'une version précédente. Les utilisateurs peuvent sélectionner la version qui convient.
    • 8.6.x
    • 9.0.x
    • 9.1.0
    • 9.1.1
    • 9.1.2
    • 10.0.0
    • 10.1.0
    • 11.0.1
    • 11.1.0
    • 12.0.0
    • 12.1.0
  2. Condition requise à remplir avant d'exécuter l'outil de mise à niveau d'Interact : Mettez à jour le fichier jdbc.properties sous : <Installation_Home>\install\ <Interact_Home>\tools\upgrade\conf
    Le fichier "jdbc.properties" doit contenir l'URL JDBC correcte, l'ID utilisateur de la base de données système Platform et le mot de passe chiffré. Si ces informations sont incorrectes, l'outil de mise à niveau d'Interact échoue avec des erreurs liées à l'authentification de la base de données.
  3. Exécutez Interact “aciUpgradeTool_crhtab .sh/bat". Cet outil de mise à niveau s'exécute de la même manière que l'outil acUpgradeTool ordinaire.
    1. Lors de l'exécution de l'outil de mise à niveau, vous êtes invité à entrer les détails de la base de données et à mentionner les détails de la base de données Interact DesignTime. L'outil vous invitera également à "sélectionner la version de base à mettre à niveau". La version de la mise à niveau spécifiée s'affiche sous la forme CHOICES_FOR_PREVIOUS_VERSIONS= Sélectionnez la version de base de la mise à niveau rapide à partir de laquelle la mise à niveau doit être effectuée.
    2. Au terme de l'exécution de l'outil de mise à niveau, vérifiez les journaux associés et assurez-vous qu'aucune erreur n'a été générée pendant la mise à niveau.
  4. Exécutez Interact “aciUpgradeTool_runtab.sh/bat". Cet outil de mise à niveau s'exécute de la même manière que l'outil acUpgradeTool ordinaire.
    1. Lors de l'exécution de l'outil de mise à niveau, vous êtes invité à fournir les détails de la base de données. Saisissez les détails de la base de données Interact RunTime. L'outil vous invitera également à sélectionner la version de base à mettre à niveau. La version de la mise à niveau spécifiée s'affiche dans CHOICES_FOR_PREVIOUS_VERSIONS. Sélectionnez la version de base de la mise à niveau rapide à partir de laquelle la mise à niveau doit être effectuée.
    2. Au terme de l'exécution de l'outil de mise à niveau, vérifiez les journaux associés et assurez-vous qu'aucune erreur n'a été générée pendant la mise à niveau.
  5. Exécutez Interact “aciUpgradeTool_lrntab .sh/bat". Cet outil de mise à niveau s'exécute de la même manière que l'outil acUpgradeTool ordinaire.
    1. Lors de l'exécution de l'outil de mise à niveau, vous êtes invité à fournir les détails de la base de données. Saisissez les détails de la base de données Interact Learning. L'outil vous invitera également à "sélectionner la version de base à mettre à niveau". Vous pouvez voir la version de mise à niveau spécifiée avec CHOICES_FOR_PREVIOUS_VERSIONS. Sélectionnez la version de base de la mise à niveau rapide à partir de laquelle la mise à niveau doit être effectuée.
    2. Au terme de l'exécution de l'outil de mise à niveau, vérifiez les journaux associés et assurez-vous qu'aucune erreur n'a été générée pendant la mise à niveau.
  6. Exécutez Interact “aciUpgradeTool_usrtab.sh/bat". Cet outil de mise à niveau s'exécute de la même manière que l'outil acUpgradeTool ordinaire.
    1. Lors de l'exécution de l'outil de mise à niveau, vous êtes invité à fournir les détails de la base de données. Saisissez les détails de la base de données Interact Production/prod. L'outil vous invitera également à "sélectionner la version de base à mettre à niveau". Vous pouvez voir la version de mise à niveau spécifiée avec CHOICES_FOR_PREVIOUS_VERSIONS. Sélectionnez la version de base de la mise à niveau rapide à partir de laquelle la mise à niveau doit être effectuée.
    2. Au terme de l'exécution de l'outil de mise à niveau, vérifiez les journaux associés et assurez-vous qu'aucune erreur n'a été générée pendant la mise à niveau.

Exécuter l'utilitaire de migration ILPB

Pourquoi et quand exécuter cette tâche

Pour plus d'informations, voir le Guide de mise à niveau d'Unica Interact.

Exécuter l’utilitaire de migration de stratégie

Pourquoi et quand exécuter cette tâche

Pour plus d'informations, voir le Guide de mise à niveau d'Unica Interact.

Mise à jour des fichiers JDBC dans InteractRT WAR

Pourquoi et quand exécuter cette tâche

Si vous ne voulez pas réutiliser le schéma Platform utilisé dans l'environnement propre 12.0, mais plutôt utiliser un autre schéma utilisateur, effectuez les étapes supplémentaires suivantes :

Procédure

  1. Sauvegardez le fichier interactRT.war depuis l'environnement 12.0 (Interact/interactRT.war).
  2. Déplacez le fichier interactRT.war.
  3. Copiez le fichier jdbc.properties depuis le répertoire Platform/tools/bin et collez-le sous interactRT.war/WEB-INF/classes.
  4. Recréez le nouveau fichier war interactRT.

Mise à niveau ultérieure

Procédure

  1. Enregistrez le filtre d'API Rest Interact DT V2. Accédez au répertoire PLATFORM_HOME/tools/bin . Exécutez les commandes suivantes :

    configTool.bat -vp -p "Affinium|suite|security|apiSecurity|interact" -f <Interact_Home>\interactDT\conf\ Interact_API_V2_Filter.xml

  2. Enregistrement de la version d'Interact :
    1. Exécutez la commande suivante dans l'environnement source et accédez au répertoire PLATFORM_HOME/tools/bin . Exécutez la commande : ./configTool.sh -x -p "Affinium|Interact|about" -f Interact_about.xml
    2. Mettez à jour le nom du produit depuis "IBM Interact" vers "Unica Interact" dans le fichier "Interact_about.xml".
      Remarque : Si vous effectuez une mise à niveau de la version 11.0 à la version 11.x, ne mettez pas à jour le nom du produit dans le fichier "Interact_about.xml".
    3. Copiez la sortie exportée dans le système de destination 12.1 sous le répertoire PLATFORM_HOME/tools/bin.
    4. Modifiez les informations de version dans le fichier "Interact_about.xml" faisant référence à la version d'Interact dans version.txt.
      Par exemple :<value>12.1.0.<Build number as per version.txt></value></property>. Les lignes suivantes sont les lignes de la version 8.6.x.
      <property id="6261" name="support" type="string_property" width="40"> 
<value>https://customercentral.unica.com%3C/value%3E</value
    5. Mettez à jour la propriété suivante : 
      <property id="6260" name="java" type="string_property" width="40">
                <value>IBM Corporation 2.4</value>
        </property>
      à 
      <property id="6260" name="java" type="string_property" width="40">
 <value>HCL Technologies Ltd.</value>
 </property>
    6. Exécutez la commande suivante dans l'environnement de destination 12.1 :./configTool.sh -v -o -i -p "Affinium|Interact" -f Interact_about.xml
    7. Pour la version du sous-composant Interact, exécutez les commandes suivantes dans l'environnement de destination 12.1 :

      Accédez au répertoire PLATFORM_HOME/tools/bin.

      Exécutez la commande : ./configTool.sh -i -p "Affinium|Campaign|about|components " -f <INTERACT_HOME>/interactDT/conf/interact_subcomponent_version.xml –o

  3. Cette étape n'est pas requise en cas de mise à niveau depuis la version 11.x. Vous devez remplacer l'ancienne navigation Interact par une nouvelle.
  4. Exécutez les commandes suivantes dans l'environnement de destination 12.1 :

    Supprimez l'ancien menu : configTool.bat -d -p "Affinium|suite|uiNavigation|mainMenu|Campaign|Interactive Channels" -o

    Ajoutez le nouveau menu :

    configTool.sh/bat -i -p "Affinium|suite|uiNavigation|mainMenu"-f "

    full_path_to_Interact_installation_directory/conf/interact_navigation.xml"

  5. Enregistrez les paramètres Unica Interact en tant que menu de configuration sous "Affinium|suite|uiNavigation|settingsmenu" à l'aide de full_path_to_Interact_installation_directory/interactDT/conf/interact_setup_navigation.xml.
  6. Platform – DBResourceBundle : Les étapes suivantes permettent d'importer des regroupements de ressources dans Unica Platform. Exécutez le script ci-dessous comme spécifié :
    1. Naviguez jusqu'à <platform_home>/tools/bin.
    2. Exécutez la commande suivante. DBResourceBundle.sh /bat -P interact-F <Interact_home>/resourcebundles
  7. Si vous avez ajouté des entrées personnalisées dans le fichier "interact_log4j.xml" sur la configuration 8.6 source, vous devez copier ces entrées personnalisées dans la configuration cible dans le fichier cible "interact_log4j2.xml" nouvellement ajouté.
  8. Déployez le fichier WAR Interact RT.
  9. Mettez à jour les URL d'instance de configuration conformément à votre groupe de serveurs défini sous Affinium|Campaign|partitions|partition1|Interact|serverGroups.

Deuxième exécution d'Interact

Procédure

  1. Si vous avez utilisé un groupe de serveurs et une version de Platform différents, répétez les étapes suivantes pour chaque exécution d'Interact.
  2. Installez la nouvelle version de Platform 12.1 avec Interact RT.
  3. Effectuez la mise à niveau de Platform et préparez la configuration. Reportez-vous au guide de mise à niveau de Platform.
  4. Copiez et restaurez la base de données InteractRT de la source vers la cible.
  5. Mettez à niveau la base de données de la base de données source vers 12.1 en exécutant l'utilitaire aciupgrade pour RT.
  6. Créez des sources de données sur le serveur d'applications cible en utilisant les mêmes noms JNDI que la configuration source.
  7. Déployez InteractRT.war.

Important

Mises à jour CFS : Si le client utilise SOAP, générez le code proxy basé sur la nouvelle version WSDL et générez à nouveau le code CFS avec le nouveau proxy.

Notes

Procédure

  • Après la mise à niveau, on constate qu'un nœud de configuration sessionManagement s'affiche sous : Affinium|interact|. La suppression de cette configuration peut s'effectuer à l'aide de l'outil configTool.sh/configTool.bat de Platform.
  • Après la mise à niveau, on constate qu'un nœud de configuration treatmentStore s'affiche sous :Affinium|Interact|services|contactHist|. La suppression de cette configuration peut s'effectuer à l'aide de l'outil configTool.sh/configTool.bat de Platform.
  • Dans ce cas, après le déploiement, pendant l'accès, vous rencontrez l'erreur DB2 SQL Error: SQLCODE=-668, SQLSTATE=57016, SQLERRMC=7, vous contactez alors votre administrateur de base de données et vous exécutez la requête REORG sur les tables de base de données requises.
  • Les étapes de suppression ne sont pas applicables si vous effectuez une mise à niveau de la version 11.x à la version 12.0.

Configurer des rapports Unica Insights avec Interact

Procédez comme suit.

Procédure

  1. Importez les schémas de rapports d'Interact dans la configuration de Platform.

    Accédez à "<INTERACT_HOME>/reports/tools".

    Exécutez le script import_all.sh/bat.

  2. Pour en savoir plus sur les configurations de groupes de rapports, consultez le Guide d'installation et de configuration des rapports Unica Insights.