Mise à niveau à partir de la version 8.2.0.7 et des versions 8.2.x à l'aide de la migration manuelle

Le programme d'installation de mise à niveau de Marketing Platform peut effectuer automatiquement toute la migration de données requise pour une mise à niveau. Cependant, si les règles de votre organisation n'autorisent pas la migration automatique, vous devez effectuer la procédure de migration pour mettre à niveau Marketing Platform manuellement. Pour effectuer une mise à niveau manuelle vers la version 9.1 de Marketing Platform, vous devez exécuter des scripts SQL spécifiques et définir les propriétés de configuration requises.

Vérifiez que les programmes d'installation suivants se trouvent dans le même répertoire :

Le programme d'installation principal d'IBM®

Le programme d'installation de Marketing Platform

En outre, vérifiez que l'installation de Marketing Platform 8.x est parfaitement opérationnelle et que vous pouvez exécuter les outils de ligne de commande. L'exécution des outils de ligne de commande nécessite trois utilitaires de Marketing Platform situés dans le sous-répertoire tools/bin du répertoire d'installation de Marketing Platform. Les informations complètes sur l'utilisation de ces utilitaires, avec des exemples de commandes pour les tâches courantes, sont disponibles dans les rubriques suivantes :

Utilitaire populateDb

Utilitaire configTool

Utilitaire alertConfigTool

Pour plus d'informations sur la mise à niveau à partir des autres versions, voir Scénarios de mise à niveau de Marketing Platform.

1.	Procédez comme suit pour effectuer une mise à niveau manuelle à partir de version 8.5.0 :

2.	Effectuez une sauvegarde de votre base de données des tables système Marketing Platform.

N'ignorez pas cette étape. Si la mise à niveau échoue, vous ne pourrez pas récupérer votre base de données en amont et vos données seront corrompues.

3.	Annulez le déploiement de votre version actuelle.

4.	Exécutez le programme d'installation principal d'IBM® EMM.

Le programme d'installation principal d'IBM® EMM démarre. Utilisez les instructions suivantes après le démarrage du programme d'installation principal d'IBM® EMM :

Lorsque le programme d'installation principal d'IBM® EMM vous invite à sélectionner un répertoire d'installation, sélectionnez le répertoire d'installation racine et non pas le répertoire d'installation de Marketing Platform qui se trouve sous ce répertoire racine.

Lorsque le programme d'installation principal d'IBM® EMM vous invite à saisir les informations de connexion à la base de données Marketing Platform, entrez les informations qui appartiennent à vos tables système Marketing Platform actuelles.

Le programme d'installation principal d'IBM® EMM se met en pause et lance le programme d'installation de Marketing Platform.

5.	Effectuez les étapes suivantes pendant l'exécution du programme d'installation de Marketing Platform :

a.	Lorsque le programme d'installation de Marketing Platform vous demande un répertoire d'installation, sélectionnez le répertoire de votre installation actuelle de Marketing Platform, généralement nommé Platform.

b.	Laissez le programme d'installation créer une copie de sauvegarde de l'installation précédente de Marketing Platform.

c.	Sélectionnez Configuration manuelle de base de données.

d.	Désélectionnez la case à cocher Exécuter la configuration de Platform.

e.	Suivez les étapes restantes de l'assistant d'installation et entrez les informations demandées.

6.	Utilisez l'utilitaire configTool pour effectuer les étapes suivantes et vous assurer que les scripts SQL que vous allez exécuter à l'étape 7 fonctionneront correctement :

Exportez toutes les propriétés de configuration depuis le noeud racine Affinium. Par exemple, dans Windows™, utilisez la commande suivante pour exporter les propriétés dans le fichier config_property_export.xml, qui est enregistré dans le répertoire d'installation de votre installation de Marketing Platform :

configTool.bat -x -p "Affinium" -f "C:\Unica\Platform\install\ config_property_export.xml"

b.	Supprimez toutes les propriétés de configuration du noeud racine Affinium. Par exemple, dans Windows™, utilisez la commande suivante pour supprimer les propriétés :

configTool.bat -d -o -p "Affinium"

c.	Importez les propriétés de configuration que vous avez exportées. Par exemple, dans Windows™, utilisez la commande suivante pour importer les propriétés depuis le fichier config_property_export.xml qui est enregistré dans le répertoire d'installation de votre installation de Marketing Platform :

configTool.bat -i -o -f "C:\Unica\Platform\install\ config_property_export.xml"

Dans le répertoire db\upgrade82to85 sous votre installation de Marketing Platform, éditez le script SQL ManagerSchema_DB_Type_86upg.sql, où DB_Type est le type de base de données de votre base de données de la table système. Utilisez les instructions suivantes pour éditer le script SQL ManagerSchema_DB_Type_86upg.sql :

Pour tous les types de base de données, retirez l'instruction suivante :

ALTER TABLE USCH_RUN ADD PAYLOAD NVARCHAR(4000);

Si votre base de données est DB2®, retirez également les instructions suivantes :

ALTER TABLE qrtz_job_details ALTER COLUMN job_data SET DATA TYPE blob(4000);

ALTER TABLE qrtz_triggers ALTER COLUMN job_data SET DATA TYPE blob(4000);

8.	Utilisez le tableau suivant pour localiser les scripts SQL fournis avec votre nouvelle installation de Marketing Platform en fonction de votre base de données de la table système Marketing Platform :

Scripts de mise à niveau depuis la version 8.2.0.7 ou une version 8.2.x postérieure
Nom du script	Emplacement
ManagerSchema_DB_Type_85upg.sql où DB_Type est le type de base de données de la base de données de la table système.	db\upgrade8207xto85
insert_new_85_locales.sql	db\upgrade82to85
ManagerSchema_DB_Type_86upg.sql où DB_Type est le type de base de données de la base de données de la table système.	db\upgrade85to86
insert_new_8601_locales.sql	db\upgrade86to8601
active_portlets.sql	db
ManagerSchema_DB_Type_90upg.sql où DB_Type est le type de base de données de la base de données de la table système.	db\upgrade86to90
ManagerSchema_DB_Type_91upg.sql ou ManagerSchema_DB_Type_91upg_unicode.sql où DB_Type est le type de base de données de la base de données de la table système.	db\upgrade90to91

9.	Exécutez l'une des commandes suivantes :

Pour Windows™ :

installation_directory\platform\tools\bin\upgrade90to91.bat

Pour Unix :

installation_directoryplatform/tools/bin/upgrade90to91.sh

10.	Employez l'utilitaire populateDb pour remplir les tables système avec les propriétés de configuration, les utilisateurs, les groupes et les rôles et droits de sécurité par défaut de Marketing Platform.

L'utilitaire populateDb se trouve dans le répertoire tools/bin sous l'installation de Marketing Platform.

Exemple : populateDb -n Manager

11.	Utilisez l'utilitaire configTool pour importer les propriétés de configuration comme indiqué dans le tableau suivant :

L'utilitaire configTool se trouve dans le répertoire tools/bin sous l'installation de Marketing Platform. Pour plus d'informations sur le fonctionnement des propriétés de configuration, reportez-vous à l'aide en ligne de la page Configuration ou au document IBM® Marketing Platform - Guide d'administration.

Les exemples de commande contenus dans le tableau ci-après s'appliquent au système d'exploitation Windows™.

Fichiers de mise à niveau depuis la version 8.2.0.7 ou une version 8.2.x postérieure

Détails de fichier

Exemple de commande

Ignorez cette procédure d'importation s'il existe une propriété nommée Recherche périodique des noms distinctifs de base LDAP activée sous la catégorie Platform | Sécurité | Détails du mode de connexion | Synchronisation LDAP. Vous avez contrôlé cette propriété à l'étape 1 de cette procédure.

Si la propriété est absente, effectuez l'importation comme suit :

Fichier : Ldap_Auto_Sync_BaseDN_Settings.xml

Emplacement : répertoire conf\upgrade86to90 dans le répertoire d'installation de Marketing Platform

Finalité : importer une propriété de configuration qui active la recherche d'importations LDAP par nom distinctif (DN)

configTool.bat -i -p "Affinium|suite|security|ldapSynchronization|ldapProperties" -f "C:\Unica\Platform\conf\upgrade86to90\Ldap_Auto_Sync_BaseDN_Settings.xml"

Fichier : interaction_history_scheduler.xml

Emplacement : répertoire conf/upgrade85to86 sous l'installation de Marketing Platform

Finalité : importer les propriétés de configuration de planificateur requises pour Interaction History

configTool.bat -i -p "Affinium|suite|scheduler|taskRegistrations" -f "C:\Unica\Platform\conf\upgrade85to86\interaction_history_scheduler.xml"

Fichier : attribution_modeler_scheduler.xml

Emplacement : répertoire conf/upgrade85to86 dans le répertoire d'installation de Marketing Platform

Finalité : importer les propriétés de configuration de planificateur requises pour Attribution Modeler

configTool.bat -i -p "Affinium|suite|scheduler|taskRegistrations" -f "C:\Unica\Platform\conf\upgrade85to86\attribution_modeler_scheduler.xml"

Fichiers : coremetrics_configuration.xml and coremetrics_navigation.xml

Emplacement : répertoire conf dans le répertoire d'installation de Marketing Platform

Finalité : importer les propriétés de configuration requises pour utiliser SSO avec IBM® Digital Analytics

configTool.bat -i -p "Affinium" -f "C:\Unica\Platform\conf\coremetrics_configuration.xml"

configTool.bat -i -p "Affinium|suite|uiNavigation|mainMenu|Analytics" -f "C:\Unica\Platform\conf\coremetrics_navigation.xml"

Fichier : cognos10_integration.xml

Emplacement : répertoire conf/upgrade85to86 dans le répertoire d'installation de Marketing Platform

Finalité : importer les propriétés de configuration requises pour la génération de rapports

configTool.bat -i -p "Affinium|Report|integrations" -f "C:\Unica\Platform\conf\upgrade85to86\cognos10_integration.xml"

Fichier : aucun fichier, suppression des propriétés

Finalité : supprimer les propriétés de configuration JMS qui ne sont plus utilisées

configTool.bat -d -o -p "Affinium|suite|jmsServer"

configTool.bat -d -o -p "Affinium|suite|jmsPort"

Fichier : LDAP_Anonymous_bind.xml

Emplacement : répertoire conf/upgrade85to86 dans le répertoire d'installation de Marketing Platform

Finalité : uniquement pour une mise à niveau depuis la version 8.2.0 ou ultérieure, importer une nouvelle propriété de configuration LDAP

configTool -i -p "Affinium|suite|security|loginModes|LDAPPartitionLogin" -f C:\Unica\Platform\conf\upgrade85to86\LDAP_Anonymous_bind.xml

Fichier : quicklinks_category.xml

Emplacement : répertoire conf\upgrade86to90 dans le répertoire d'installation de Marketing Platform

Finalité : importer les propriétés des portlets de tableau de bord avec liens rapides

configTool.bat -i -o -p "Affinium|suite" -f "C:\Unica\Platform\conf\upgrade86to90\quicklinks_category.xml"

Fichier : manager_alerts_registration.xml

Emplacement : répertoire conf dans le répertoire d'installation de Marketing Platform

Finalité : importer les propriétés de configuration requises pour créer les options de menu des alertes

configTool.bat -i -o -p "Affinium|suite|uiNavigation|alerts -f "C:\Unica\Platform\conf\manager_alerts_registration.xml"

Fichier : disablePageTagging.xml

Emplacement : répertoire conf\upgrade82to85 dans le répertoire d'installation de Marketing Platform

Finalité : importer une propriété de configuration qui détermine si IBM® peut collecter des statistiques de base sur les tendances générales d'utilisation des produits

configTool.bat -i -o -p "Affinium|suite" -f "C:\Unica\Platform\conf\upgrade82to85\disablePageTagging.xml"

Fichiers : coremetrics_configuration.xml et coremetrics_navigation.xml

Emplacement : répertoire conf dans le répertoire d'installation de Marketing Platform

Finalité : importer les propriétés de configuration requises pour utiliser SSO avec IBM® Digital Analytics

configTool.bat -i -o -p "Affinium" -f "C:\Unica\Platform\conf\coremetrics_configuration.xml"

configTool.bat -i -o -p "Affinium|suite|uiNavigation|mainMenu|Analytics" -f "C:\Unica\Platform\conf\coremetrics_navigation.xml"

Fichier : scheduler.xml

Emplacement : répertoire db\upgrade90to91 sous l'installation de Marketing Platform

Finalité : propriété booléenne permettant d'activer ou de désactiver la fonction de planificateur dans Marketing Platform

configtool -i -p "Affinium|suite|scheduler" -f "C:\Unica\Platform\conf\upgrade90to91\scheduler.xml"

Fichier : unknownPolling.xml

Emplacement : répertoire db\upgrade90to91 sous l'installation de Marketing Platform

Finalité : importer les propriétés des portlets de tableau de bord avec liens rapides

configtool -i -p "Affinium|suite|scheduler" -f "C:\Unica\Platform\conf\upgrade90to91\unknownPolling.xml"

Fichier : communication_email.xml

Emplacement : répertoire conf\upgrade86to90 dans le répertoire d'installation de Marketing Platform

Finalité : importer les propriétés de configuration permettant d'activer les notifications par courrier électronique Lorsque ces propriétés sont activées, Marketing Platform envoie des courriers électroniques d'alerte système et des notifications aux utilisateurs.

configTool.bat -i -o -p "Affinium|Manager" -f "C:\Unica\Platform\conf\upgrade86to90\communication_email.xml"

Fichier : notification.xml

Emplacement : répertoire conf\upgrade86to90 dans le répertoire d'installation de Marketing Platform

Finalité : importer les propriétés de configuration requises pour la fonctionnalité de notification. Les propriétés suivantes sont ajoutées :

Nombre de jours pendant lesquels les alertes doivent être conservées - 90

Fréquence (en minutes) d'envoi des courriers électroniques - 30

Nombre maximal de tentatives d'envoi d'un courrier électronique - 1

configTool.bat -i -o -p "Affinium|suite" -f "C:\Unica\Platform\conf\upgrade86to90\notification.xml"

Fichier : is_clustered.xml

Emplacement : répertoire conf\upgrade86to90 dans le répertoire d'installation de Marketing Platform

Finalité : propriété booléenne permettant de spécifier si l'instance de Marketing Platform est en cluster. Si vous installez Marketing Platform dans un déploiement en cluster, affectez la valeur True à cette propriété. Sinon, conservez la valeur par défaut, False.

configtool -i -p "Affinium|suite" -f "C:\Unica\Platform\conf\upgrade90to91\is_clustered.xml"

Fichier : taskNotification.xml

Emplacement : répertoire conf\upgrade86to90 dans le répertoire d'installation de Marketing Platform

Finalité : importer la zone Nom de groupe dans laquelle vous pouvez entrer les groupes qui sont notifiés au moyen de notifications planifiées.

Fichier : config_data_filter_cache.xml

Emplacement : répertoire conf\upgrade90to91 sous l'installation de Marketing Platform

Finalité : vous permet de configurer le cache de filtre de données. Si la propriété de configuration a pour valeur True, le cache de filtre de données est activé et les performances sont optimisées. Si la propriété de configuration a pour valeur False, la mise en cache n'est pas activée, et toutes les opérations sont effectuées via une connexion à la base de données pour chaque demande de filtre de données. La propriété de configuration est visible sur l'interface utilisateur.

configTool.bat -vp -p "Affinium|Manager|datafiltering" -f "C:\Unica\Platform\conf\upgrade90to91\Config_data_filter_cache.xml"

Si vous modifiez cette valeur, vous devez redémarrer Marketing Platform pour que les modifications soient prises en compte.

Fichier : Refresh_data_filter_cache.xml

Emplacement : répertoire conf\upgrade90to91 sous l'installation de Marketing Platform

Finalité : si la mise en cache de filtre de données est activée, avec cette propriété de configuration, le cache est actualisé chaque fois qu'une modification est apportée aux définitions de filtre de données.

configTool.bat -vp -p "Affinium|Manager|datafiltering" -f "C:\Unica\Platform\conf\upgrade90to91\Refresh_data_filter_cache.xml"

Fichiers : navigation.xml et emm_spss_configuration.xml

Emplacement : conf\upgrade90to91

Finalité : importer les propriétés de configuration IBM® SPSS® Modeler Advantage Marketing Edition.

configTool -i -o -p "Affinium|suite|uiNavigation|mainMenu|Analytics" -f "C:\Unica\Platform\conf\emm_spss_navigation.xml"

configTool -i -o -p "Affinium" -f "C:\Unica\Platform\conf\emm_spss_configuration.xml"

12.	Exécutez l'utilitaire alertConfigTool à partir du répertoire tools\bin sous l'installation de Marketing Platform afin d'enregistrer les alertes et les notifications Marketing Platform.

Exemple de commande (Windows™) :

alertConfigTool.bat -i -f "C:\Platform\conf\Platform_alerts_configuration.xml"

13.	Exécutez le script upgrade85Dashboard à partir du répertoire tools\bin sous l'installation de Marketing Platform pour mettre à niveau le tableau de bord.

14.	Accédez à Aide > A propos de et exécutez les étapes suivantes pour mettre à jour la page A propos de :

a.	Utilisez l'utilitaire configTool pour exporter la catégorie Affinium \| Manager \| about.

La catégorie Affinium | Manager | about n'est pas visible sur la page Configuration car elle est marquée comme cachée.

Exemple (Windows™) :

configTool.bat -x -p "Affinium|Manager|about" -f "C:\Unica\Platform\conf\about.xml"

b.	Editez le fichier XML exporté que vous venez de créer (about.xml dans l'exemple) pour changer le numéro de version et le nom d'affichage. Recherchez la propriété releaseNumber et changez la valeur pour indiquer la version actuelle de Marketing Platform.

Dans l'exemple ci-dessous, remplacez 8.0.0 par votre nouvelle version :

<property name="releaseNumber" type="string">
<displayNameKey>about.releaseNumber</displayNameKey>
<value>9.1.0.0.0.build_number</value>
</property>

c.	Utilisez l'utilitaire configTool pour importer le fichier révisé. Vous devez utiliser l'option -o pour remplacer le noeud. Vous devez spécifier le noeud parent lors de l'importation.

Exemple (Windows™) :

configTool.bat -i -p "Affinium|Manager" -f "about.xml" -o

15.	Déployez et vérifiez votre installation, comme décrit dans le chapitre Déploiement de Marketing Platform.

Une fois que le processus de mise à niveau a abouti et que l'application est active, supprimez les tables liferay à l'aide du script drop-liferay-tables.sql. Le script drop-liferay-tables.sql se trouve dans le répertoire Platform_installation/db/upgrade86to90/drop-liferay-tables.sql.

Pour connaître les étapes supplémentaires requises pour la génération de rapports sur les mises à niveau, voir IBM® EMM Reports Installation and Configuration Guide.