Mise à niveau depuis une version 8.0.x, 8.1.x ou 8.2.x antérieure à 8.2.0.7 avec migration manuelle

Le programme d'installation de mise à niveau de Marketing Platform peut effectuer automatiquement toute la migration de données requise par une mise à niveau, mais si votre organisation ne le permet pas, vous devez effectuer cette procédure pour effectuer la mise à niveau manuellement.

Cette procédure s'applique uniquement aux mises à niveau depuis la version 8.0.x, 8.1.x ou 8.2.x antérieure à la version 8.2.0.7 de Marketing Platform. Pour plus d'informations sur la mise à niveau à partir des autres versions, voir Scénarios de mise à niveau pour Marketing Platform.

Assurez-vous d'avoir les éléments suivants dans un répertoire.

Le programme d'installation principal d'IBM®

Le programme d'installation de Marketing Platform

De même, assurez-vous que votre installation de Marketing Platform 8.x est parfaitement opérationnelle et que vous pouvez exécuter les outils de ligne de commande. Cette procédure 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 comme suit.

Utilitaire populateDb

Utilitaire configTool

Utilitaire alertConfigTool

1.	Connectez-vous à IBM® EMM, sélectionnez la page Paramètres > Configuration et déterminez 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 utiliserez ces informations par la suite.

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® .

Le programme d'installation principal d'IBM® démarre. Suivez ces instructions dans le programme d'installation principal d'IBM® .

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

Lorsque le programme d'installation principal d'IBM® 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.

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

5.	Suivez ces instructions dans le programme d'installation de Marketing Platform.

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.

Autorisez le programme d'installation à sauvegarder votre installation précédente.

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

Décochez la case Exécuter la configuration Platform.

Suivez toutes les étapes restantes du programme d'installation de Marketing Platform en entrant toutes les informations demandées.

6.	Une fois tous les programmes d'installation terminés, utilisez l'utilitaire configTool pour exécuter les étapes suivantes pour vous assurer que les scripts SQL que vous allez exécuter fonctionneront correctement.

a.	Exportez toutes les propriétés de configuration à partir du noeud racine Affinium.

Par exemple, la commande suivante exporte les propriétés dans un fichier nommé config_property_export.xml, qui est enregistré dans le répertoire install de votre installation Marketing Platform. Il s'agit d'un exemple pour Windows.

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, la commande suivante supprime les propriétés. Il s'agit d'un exemple pour Windows.

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

c.	Importez les propriétés de configuration exportées.

Par exemple, la commande suivante importe les propriétés d'un fichier nommé config_property_export.xml, situé dans le répertoire de votre installation Marketing Platform. Il s'agit d'un exemple pour Windows.

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

7.	Utilisez le tableau approprié ci-dessous pour localiser les scripts SQL fournis avec votre nouvelle installation de Marketing Platform dans votre base de données des tables système Marketing Platform. Exécutez les scripts SQL dans l'ordre indiqué.

Utilisez ce tableau si vous effectuez une mise à niveau depuis la version 8.0.x
Nom du script	Emplacement
ManagerSchema_type_bd_81upg.sql, où type_bd correspond au type de votre base de données des tables système	db\upgrade80to81
ManagerSchema_type_bd_8201upg.sql, où type_bd correspond au type de votre base de données des tables système	db\upgrade82to8201
ManagerSchema_type_bd_85upg.sql, où type_bd correspond au type de votre base de données des tables système.	db\upgrade82to85
insert_new_85_locales.sql	db\upgrade85to86
ManagerSchema_type_bd_86upg.sql, où type_bd correspond au type de votre base de données des tables système	db\upgrade85to86
insert_new_8601_locales.sql	db\upgrade86to8601
active_portlets.sql	db
ManagerSchema_type_bd_90upg.sql, où type_bd indique le type de base de données de votre base de données des tables système.	db\upgrade86to90

Utilisez ce tableau si vous effectuez une mise à niveau depuis la version 8.1.x ou 8.2.0
Nom du script	Emplacement
ManagerSchema_type_bd_8201upg.sql, où type_bd correspond au type de votre base de données des tables système	db\upgrade82to8201
ManagerSchema_type_bd_85upg.sql, où type_bd correspond au type de votre base de données des tables système.	db\upgrade82to85
insert_new_85_locales.sql	db\upgrade82to85
ManagerSchema_type_bd_86upg.sql, où type_bd correspond au type de votre base de données des tables système	db\upgrade85to86
insert_new_8601_locales.sql	db\upgrade86to8601
active_portlets.sql	db
ManagerSchema_type_bd_90upg.sql, où type_bd indique le type de base de données de votre base de données des tables système.	db\upgrade86to90

Utilisez ce tableau si vous effectuez une mise à niveau depuis la version 8.2.0.1 et des versions de correctif ultérieures mais antérieures à 8.2.0.7
Nom du script	Emplacement
ManagerSchema_type_bd_85upg.sql, où type_bd correspond au type de votre base de données des tables système.	db\upgrade82to85
insert_new_85_locales.sql	db\upgrade82to85
ManagerSchema_type_bd_86upg.sql, où type_bd correspond au type de votre base de données des tables système	db\upgrade85to86
insert_new_8601_locales.sql	db\upgrade86to8601
active_portlets.sql	db
ManagerSchema_type_bd_90upg.sql, où type_bd indique le type de base de données de votre base de données des tables système.	db\upgrade86to90

8.	Exécutez le script shell ou batch upgrade86to90, situé dans tools\bin\upgrade86to90, dans le répertoire d'installation de Marketing Platform.

9.	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.

Cet utilitaire se trouve dans le répertoire tools/bin, dans votre installation Marketing Platform.

Exemple : populateDb -n Manager

10.	Employez l'utilitaire configTool pour importer les propriétés de configuration, comme indiqué dans le tableau suivant. Les commandes données dans l'exemple correspondent à un système Windows.

L'utilitaire configTool se trouve dans le répertoire tools/bin, dans l'installation Marketing Platform. Les commandes données dans l'exemple correspondent à un système Windows.

Les commandes données dans l'exemple correspondent à un système Windows.

Pour plus d'informations sur le fonctionnement des propriétés de configuration, reportez-vous à l'aide en ligne de la page Paramètres > Configuration ou au document IBM® Marketing Platform - Guide de l'administrateur.

Utilisez ce tableau si vous effectuez une mise à niveau depuis une version 8.0.x, 8.1.x ou 8.2.x antérieure à 8.2.0.7

Nom de fichier, emplacement et finalité

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 dans le répertoire d'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 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 -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.bat -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 : 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 requises pour activer les notifications par courrier électronique

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

configTool.bat -i -o -p "Affinium|suite" -f C:\Unica\Platform\conf\upgrade86to90\notification.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

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

11.	Employez l'utilitaire alertConfigTool pour enregistrer les alertes et les notifications de Marketing Platform comme suit :

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

Exécutez cet utilitaire à partir du répertoire tools\bin. Utilisez en référence le fichier Platform_alerts_configuration.xml situé dans le répertoire conf de votre installation Marketing Platform.

Exemple de commande (Windows) : alertConfigTool.bat -i -f C:\Platform\conf\Platform_alerts_configuration.xml

12.	Pour mettre à niveau le tableau de bord, exécutez le script upgrade85Dashboard qui est situé dans le répertoire tools\bin de votre installation Marketing Platform.

13.	Mettez à jour la page Aide > A propos de, comme suit.

a.	Employez l'utilitaire configTool pour exporter la catégorie Affinium \| Manager \| about (cette catégorie n'est pas visible sur la page de Configuration, car elle est marquée comme masquée).

Exemple de commande (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, comme suit.

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.

<displayNameKey>about.releaseNumber</displayNameKey>

</property>

c.	Employez l'utilitaire configTool pour importer le fichier révisé. Vous devez utiliser l'option –o pour remplacer le noeud. N'oubliez pas que vous devez indiquer le noeud parent lorsque vous importez.

Exemple de commande (Windows™) : configTool.bat –i –p “Affinium|Manager” –f “about.xml” -o

14.	Déployez et vérifiez votre installation, comme décrit dans le chapitre Déploiement d'IBM Marketing Platform.

Après avoir mis à niveau vos applications IBM® EMM, reportez-vous au document IBM® EMM - Guide d'installation et de configuration des rapports pour plus d'informations sur les étapes requises pour mettre à niveau la fonction de génération de rapports.