Procédure : Mise à niveau rapide d'Unica Campaign

Mise à niveau préalable de Unica Campaign

Procédure

  1. Importez la sauvegarde des tables système Unica Campaign depuis l'ancienne version/la version de base vers le schéma des tables système utilisé dans l'environnement propre 12.1.
  2. Effectuez une sauvegarde du répertoire du système de fichiers CAMPAIGN_HOME/partitions/partition1.
  3. Copiez toutes les données des partitions présentes dans les dossiers de partitions de l'ancien environnement vers le dossier de la partition Unica Campaign dans l'environnement propre 12.1.

Mise à niveau d'Unica Campaign

Procédure

  1. Mettez à jour le fichier setenv.sh avec les valeurs requises pour la mise à niveau d'Unica Campaign. Pour plus de détails sur les variables d'environnement incluses dans le fichier setenv.sh, reportez-vous au guide de mise à niveau d'Unica Campaign 12.1.
    1. Accédez au chemin suivant : <chemin d’installation>/Campaign/Tools/Upgrade/11.1.0+to12.1/

      Définissez les variables suivantes dans le fichier setenv.sh :

      Set JAVA_HOME='<Installation Path >/jre'

      Set CAMPAIGN_HOME='<Installation Path>/Campaign'

      Définir LOG_TEMP_DIR='<Installation Path>/Campaign/logs'

      Set JDBCDRIVER_CLASSPATH=<JDBC DRIVER CLASSPATH>

    2. Ajoutez l'option JVM “-DFAST_UPGRADE_VERSION=<BASE_VERSION>"

      Par exemple :

      JAVA_OPTIONS="${JAVA_OPTIONS} -DFAST_UPGRADE_VERSION=8.6.x

    3. Versions prises en charge dans la mise à niveau rapide :
      Mise à niveau depuis la version Option JVM
      8.6.x -DFAST_UPGRADE_VERSION=8.6.x
      9.0.x -DFAST_UPGRADE_VERSION=9.0.x
      9.1.x.x (9.1.x, 9.1.1.x et 9.1.2.x) -DFAST_UPGRADE_VERSION=9.1.x
      10.0.x -DFAST_UPGRADE_VERSION=10.0.x
      10.1.x -DFAST_UPGRADE_VERSION=10.1.x
      11.0.x -DFAST_UPGRADE_VERSION=11.0.x
      11.0.1 -DFAST_UPGRADE_VERSION=11.0.1.x
      11.1 -DFAST_UPGRADE_VERSION=11.1.x
      Remarque : Si vous mettez à niveau Campaign à partir de la version 9.0 ou de versions antérieures, supprimez d'abord l'index cTreatment_IX1 sur la table UA_Treatment avant de démarrer le processus de mise à niveau rapide.
  2. Condition requise à remplir avant d'exécuter l'outil de mise à niveau d'Interact : le fichier "jdbc.properties", situé dans le répertoire <CAMPAIGN_HOME>/install, contient l'URL JDBC correcte, l'ID utilisateur de la base de données système Platform et le mot de passe chiffré. L'utilisateur doit copier-coller le fichier jdbc.properties du répertoire Platform/tools/bin vers le répertoire Campaign/install. Si ces informations sont incorrectes, l'outil de mise à niveau de Campaign échoue avec des erreurs liées à l'authentification de la base de données.
  3. Exécutez l'outil "acUpgradeTool.sh" de Campaign. Cet outil de mise à niveau s'exécute de la même manière que l'outil acUpgradeTool ordinaire. Lors de l'exécution de l'outil de mise à niveau, lorsque vous êtes invité à sélectionner la version de base à mettre à niveau, la version de la mise à niveau spécifiée s'affiche dans l'option JVM "-DFAST_UPGRADE_VERSION=<BASE_VERSION>". Sélectionnez la version de base de la mise à niveau rapide à partir de laquelle la mise à niveau doit être effectuée.
  4. Mise à jour des fichiers JDBC dans Unica Campaign : Dans le serveur d'applications, mettez à jour les détails JNDI (schéma/ID système, ID utilisateur, mot de passe) pour Campaign JNDI en fonction du nouveau schéma de base de données utilisé avec l'environnement 12.1.

Mise à niveau ultérieure de Campaign

Définition de Campaign – Aide > A propos de > Version

Procédure

  1. Modifiez la version d'Unica Campaign dans l'enregistrement Unica Platform :
    1. Exportez la configuration de la version à l'aide de la commande suivante dans l'environnement propre 12.1 :/configTool.sh -x -p "Affinium|Campaign|about" -f <PLATFORM_HOME>/conf/campaign_about.xml
    2. Modifiez le fichier campaign_about.xml généré par la commande ci-dessus. Modifiez la version en 12.1.0.0.GA_BUILD".<GA_BUILD>. Remplacez-la par le numéro de build faisant référence à version.txt à l'emplacement d'installation. 
      <property id="xxxxxx" name="releaseNumber" type="string_property" width="40">
 <value>12.1.0.0.GA_BUILD</value>
 </property>
    3. Importez le fichier mentionné ci-dessus à l'aide de la commande suivante :./configTool.sh -v -i -o -p "Affinium|Campaign" -f <PLATFORM_HOME>/Platform/conf/campaign_about.xml
  2. Exécutez la commande suivante pour mettre à niveau les stratégies de sécurité de Campaign de la version de base vers la version 12.1 et accédez à <Platform_Home/tools/bin>.

    ./populateDb.sh -n Campaign

Modifications de la configuration d'Unica Campaign

Procédure

  1. Enregistrement "Filtre d'API REST Campaign" de Campaign :
    1. Accédez au répertoire PLATFORM_HOME/tools/bin.
    2. Exécutez les commandes suivantes : configTool -v -i -p "Affinium|suite|security|apiSecurity|campaign" -f "full_path_to_Campaign_installation_directory\conf\API_Filter.xml" configTool -v -i -p "Affinium|suite|security|apiSecurity|campaign" -f "full_path_to_Campaign_installation_directory\conf\API_V2_Filter.xml" configTool -v -i -p "Affinium|suite|security|apiSecurity|campaign" -f "full_path_to_Campaign_installation_directory\conf\API_V3_Filter.xml"
  2. Enregistrement "Filtre d'API REST Engage" de Campaign :
    1. Accédez au répertoire PLATFORM_HOME/tools/bin.
    2. Exécutez la commande suivante :./configTool.sh -vp -p "Affinium|suite|sécurité|apiSecurity|campaign" -f <CAMPAIGN_HOME>/conf/Engage_API_Filter.xml
  3. Enregistrement de la navigation Optimize

    configTool -v -i -p "Affinium|suite|uiNavigation|mainMenu|Campaign" -f "full_path_to_Campaign_installation_directory\conf\optimize_navigation.xml"

  4. Modifications liées à Campaign Struts

    Dans la mise à niveau de la structure MVC depuis Struts 1.3.8 vers Spring 5.1.18 pour corriger la faille de sécurité (dans Struts 1.3.8) et pour passer à la norme de l'industrie actuelle, des changements ont été apportés à l'extension de certaines URL mentionnées dans la configuration de ".do" à ".go". Les commandes suivantes doivent être exécutées pour qu'elles s'appliquent.

    1. configTool.bat -vp -o -p "Affinium|suite|uiNavigation|settingsMenu|campaignSettingsItem" -f <CAMPAIGN_HOME>/conf/campaign_setup_navigation_spring_update.xml
    2. configTool.bat -vp -o -p "Affinium|suite|uiNavigation|mainMenu|Campaign|Optimize" -f <CAMPAIGN_HOME>/conf/campaign_navigation_optimize_spring_update.xml
    3. configTool.bat -vp -o -p "Affinium|suite|uiNavigation|mainMenu|Campaign|All Offers" -f <CAMPAIGN_HOME>/conf/campaign_navigation_allOffers_spring_update.xml
    4. configTool.bat -vp -o -p "Affinium|Campaign|navigation" -f <CAMPAIGN_HOME>/conf/campaign_configuration_doLogout_spring_update.xml
    5. configTool.bat -vp -o -p "Affinium|suite|uiNavigation|mainMenu|Campaign|All Segments" -f <CAMPAIGN_HOME>/conf/campaign_navigation_allSegments_spring_update.xml
    6. configTool.bat -vp -o -p "Affinium|suite|uiNavigation|mainMenu|Campaign|All Sessions" -f <CAMPAIGN_HOME>/conf/campaign_navigation_allSessions_spring_update.xml
    7. configTool.bat -vp -o -p "Affinium|suite|uiNavigation|mainMenu|Campaign|All Campaigns" -f <CAMPAIGN_HOME>/conf/campaign_navigation_allCampaigns_spring_update.xml
    8. configTool.bat -vp -o -p "Affinium|Campaign|unicaACOOptAdmin" -f <CAMPAIGN_HOME>/conf/campaign_configuration_ext_doLogout_spring_update.xml
    9. configTool.bat -vp -o -p "Affinium|Campaign|navigation" -f <CAMPAIGN_HOME>/conf/campaign_configuration_offerDetails_spring_update.xml
    10. configTool.bat -vp -o -p "Affinium|suite|uiNavigation|mainMenu|Campaign|Monitoring Console" -f <CAMPAIGN_HOME>/conf/campaign_navigation_monitoring_console_spring_update.xml
    11. configTool.bat -vp -o -p "Affinium|Campaign|navigation" -f <CAMPAIGN_HOME>/conf/campaign_configuration_displayOfferList_spring_update.xml
    12. configTool.bat -vp -o -p "Affinium|Campaign|navigation" -f <CAMPAIGN_HOME>/conf/campaign_configuration_flowchartDetails_spring_update.xml
    13. configTool.bat -vp -o -p "Affinium|Campaign|unicaACOOptAdmin" -f <CAMPAIGN_HOME>/conf/campaign_configuration_ext_runOptimizeSession_spring_update.xml
    14. configTool.bat -vp -o -p "Affinium|Campaign|unicaACOOptAdmin" -f <CAMPAIGN_HOME>/conf/campaign_configuration_ext_stopOptimizeSessionRun_spring_update.xml
    15. configTool.bat -vp -o -p "Affinium|Campaign|unicaACOOptAdmin" -f <CAMPAIGN_HOME>/conf/campaign_configuration_ext_optimizeSessionProgress_spring_update.xml
    16. configTool.bat -vp -o -p "Affinium|Campaign|navigation" -f <CAMPAIGN_HOME>/conf/campaign_configuration_optimize_sessionLinkClicked_spring_update.xml
    17. configTool.bat -vp -o -p "Affinium|Campaign|navigation" -f <CAMPAIGN_HOME>/conf/campaign_configuration_optimize_editOptimizeSchedule_spring_update.xml
  5. Modifiez les configurations Campaign dans la configuration Unica Platform :
    1. Modifiez les URL de navigation de Campaign.
    2. Modifiez "serverHost" dans les paramètres pour "unicaACListener" (Affinium|Campaign|unicaACListener).
    3. Si nécessaire, modifiez le DSN sous UA_SYSTEM_TABLES.
    4. Si nécessaire, modifiez le nom JNDI sous UA_SYSTEM_TABLES.
    5. Remappez toutes les tables système dans le mappage des tables Campaign. Pour cela, procédez comme suit :
      1. Arrêtez le programme d'écoute.
      2. Supprimez "unica_tblcache.mgr" sous <CO_HOME>/partitions/partition/conf.
      3. Démarrez le programme d'écoute.
      4. Accédez à Paramètres de Campaign > Mappage de table.
  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. Accédez à <platform_home>/tools/bin
    2. DBResourceBundle.sh /bat -P Campaign -F <Campaign_home>/resourcebundles

Vérification fonctionnelle de la mise à niveau ultérieure de Unica Campaign

Procédure

  1. L'URL de navigation de l'application Unica Campaign pointe vers l'ancien environnement de base. Vous devez changer cette URL de navigation pour qu'elle pointe vers l'environnement cible à l'aide du script SQL dans la base de données du système Unica Platform.
  2. Soumettez l'application Unica Campaign à un essai d'acceptation par l'utilisateur. Assurez-vous que tous les diagrammes s'ouvrent et s'exécutent correctement.

Configuration des rapports Unica Insights avec Campaign

Procédez comme suit.

Procédure

  1. Importez les schémas de rapports de Campaign dans la configuration de Platform.
  2. Exécutez les commandes suivantes. Accédez au répertoire Platform_HOME/tools/bin.

    configTool -v -i -o -p "Affinium|Report|about" -f "<CAMPAIGN_HOME>/reports/schema/config_version.xml"

    configTool -v -i -o -p "Affinium|Report|schemas" -f "<CAMPAIGN_HOME>/reports/schema/config_schemas_Campaign.xml"

    configTool -v -i -o -p "Affinium|Report|schemas|Campaign" -f "<CAMPAIGN_HOME>/reports/schema/templates/camp_cust_attributes_template.xml"

    configTool -v -i -o -p "Affinium|Report|schemas|Campaign" -f "<CAMPAIGN_HOME>/reports/schema/templates/camp_performance_template.xml"

    configTool -v -i -o -p "Affinium|Report|schemas|Campaign" -f "<CAMPAIGN_HOME>/reports/schema/templates/offer_performance_template.xml"

    configTool -v -i -o -p "Affinium|Report|schemas|Campaign" -f "<CAMPAIGN_HOME>/reports/schema/templates/camp_offer_response_breakout_template.xml"

    configTool -v -i -o -p "Affinium|Report|schemas|Campaign" -f "<CAMPAIGN_HOME>/reports/schema/templates/camp_offer_contact_status_breakout_template.xml"

    configTool -v -i -o -p "Affinium|Report|schemas|Campaign" -f "<CAMPAIGN_HOME>/reports/schema/base/camp_view.xml"

    configTool -v -i -o -p "Affinium|Report|schemas|Campaign" -f "<CAMPAIGN_HOME>/reports/schema/custom/camp_cust_attributes.xml"

    configTool -v -i -o -p "Affinium|Report|schemas|Campaign" -f "<CAMPAIGN_HOME>/reports/schema/custom/camp_offer_response_breakout.xml"

    configTool -v -i -o -p "Affinium|Report|schemas|Campaign" -f "<CAMPAIGN_HOME>/reports/schema/custom/camp_offer_contact_status_breakout.xml"

    configTool -v -i -o -p "Affinium|Report|schemas|Campaign" -f "<CAMPAIGN_HOME>/reports/schema/custom/camp_performance.xml"

    configTool -v -i -o -p "Affinium|Report|schemas|Campaign" -f "<CAMPAIGN_HOME>/reports/schema/custom/offer_performance.xml"

  3. Mettez à jour la source de données de Campaign dans les fichiers de conception de rapport Unica Insights à l'aide de l'utilitaire Unica Insights.

    InsightsDBUtil -ds=CampaignDS -bPath="<Platform_Home>/Insights/Reports" -DBType=<databasetype> -URL=<databasetype> -user=<database user> -pwd=<database password>

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