Guide de Migration. Neolane v6.0

Transcription

1 Guide de Migratio Neolae v6.0

2

3 Ce documet, aisi que le logiciel qu'il décrit, est fouri das le cadre d'u accord de licece et e peut être utilisé ou copié que das les coditios prévues par cet accord. Cette publicatio e peut être reproduite ou trasmise, itégralemet ou partiellemet, sous quelque forme et par quelque moye que ce soit, sauf autorisatio écrite préalable de Neolae. Ce documet est sujet à révisios. Neolae e garatit pas l'exhaustivité des iformatios coteues das ce documet. Toute référece à des oms de sociétés das les illustratios fouries 'est utilisée qu'à titre d'exemple et e fait référece à aucue société réelle. Toutes les marques citées sot la propriété de leurs déteteurs respectifs. Microsoft et Widows sot des marques ou des marques déposées apparteat à Microsoft Corporatio aux Etats-Uis et/ou das d'autres pays. Java, MySQL et Ope Office sot des marques commerciales ou des marques déposées apparteat à Oracle Corporatio aux Etats-Uis et das d'autres pays. Liux est la marque déposée de Lius Torvalds aux Etats-Uis et das d'autres pays. Ce produit iclut des logiciels développés par Apache Software Foudatio ( Sauf metio cotraire, les déomiatios sociales, les logos, les produits et marques cités das ce documet, sot la propriété de Neolae S.A. ou de ses filiales. Ils e peuvet être utilisés sas l'autorisatio préalable et écrite de Neolae. Numéro de versio : 6884 Neolae 18 rue Roger Simo Barboux, Arcueil - Frace

4 Table des matières Neolae v6.0 - Guide de Migratio Chapitre 1. Itroductio Présetatio Avertissemets Méthodologie Tests de migratio Procédure de migratio Chapitre 2. Migratio techique Migratio sous Widows Itroductio Prérequis Migratio de la plateforme Migratio du serveur de redirectio (IIS) Redémarrage des services Suppressio et ettoyage de Neolae v Migratio sous Liux Itroductio Prérequis Migratio de la plateforme Migratio du serveur de redirectio (Apache) Redémarrage des services Suppressio et ettoyage de Neolae v Chapitre 3. Paramétrage Coflits Applicatios web Workflows MySQL Trackig JavaScript L'arborescece Neolae v Chapitre 4. Aexes Procédure de retour-arrière Neolae v6.0 - Guide de Migratio 3

5 Neolae 4 Neolae v6.0 - Guide de Migratio

6 CHAPITRE 1 Itroductio Table des matières Présetatio Avertissemets Méthodologie Tests de migratio Procédure de migratio Présetatio Ce documet décrit les différetes étapes de migratio d'ue plateforme Neolae v5.11 vers ue plateforme v6. La migratio doit préalablemet être testée sur l'eviroemet de développemet pour vérifier qu'elle s'exécute sas erreur. La migratio de l'eviroemet de productio e doit être exécutée qu'après ue validatio complète de l'eviroemet de développemet migré. Les ouveautés et évolutios de la plateforme Neolae v6 sot présetées das le documet Notes de versio. Avertissemets La procédure de migratio est réservée à u utilisateur expert. Ce guide présete la procédure à suivre lors d'ue migratio depuis le build Neolae v5.11 le plus récet vers le build v6 le plus récet. Vérifiez la versio de votre serveur à l'aide de la commade lserver pdump. Si vous disposez d'ue versio atérieure à la v5.11, vous devez impérativemet migrer e v5.11 avat d'effectuer ue migratio vers la v6. Les commades liées à la base de doées sot doées à titre d'exemple. Celles-ci peuvet varier e foctio de votre cofiguratio. Cotactez votre admiistrateur de base de doées. Avat toute migratio, vous devez impérativemet effectuer ue sauvegarde de vos doées. Il 'est pas possible de chager de type de moteur de base de doées (SGBD). Par exemple, il 'est pas possible de passer d'u moteur PostgreSQL à u moteur Oracle. Il est cepedat possible de passer d'u moteur Oracle 8 à u moteur Oracle 10. L'esemble du processus de migratio peut predre plusieurs jours. Neolae v6.0 - Guide de Migratio - Itroductio 5

7 Neolae Méthodologie Tests de migratio Les tests de migratio peuvet être effectués de différetes maières, e foctio de votre cofiguratio. Avat de redémarrer les services Neolae, exécutez le script de cautérisatio freezeistace.js permettat de ettoyer la base de doées de tous les objets qui étaiet e cours d'exécutio au momet de la sauvegarde : lserver javascript ms:freezeistace.js -istace:<istace> -arg:<ru dry> Par défaut la commade se lace e mode dry, et liste l'esemble des requêtes qui serot exécutées par la commade, mais sas les lacer. Pour exécuter les requêtes de cautérisatio, utilisez l'argumet ru das la commade. Si vous e disposez d'aucu eviroemet de développemet, les étapes sot les suivates : 1 Dupliquez l'eviroemet de productio. 2 Testez la procédure de migratio sur la copie de l'eviroemet de productio. Si vous disposez d'u eviroemet de développemet, les étapes sot les suivates : 1 Arrêtez tous les développemets e cours et reportez-les sur l'eviroemet de productio. 2 Effectuez ue sauvegarde de la base de doées correspodat à l'eviroemet de développemet. 3 Arrêtez tous les processus Neolae sur l'istace de développemet. 4 Effectuez ue sauvegarde de la base de doées de l'eviroemet de productio et restaurez-la e tat qu'eviroemet de développemet. 5 Assurez-vous que vos sauvegardes sot itègres e tetat de les restaurer. Vérifiez que vous avez bie accès à votre base de doées, vos tables, vos doées, etc. 6 Testez la procédure de migratio sur l'eviroemet de développemet. 7 Si la migratio de l'eviroemet de développemet s'est effectuée sas erreur, migrez l'eviroemet de productio. Avertissemet : L'import/export de packages de doées etre ue plateforme Neolae v5 et ue plateforme v6 'est pas possible e raiso de modificatios effectuées sur la structure des doées. Procédure de migratio La procédure de migratio doit être effectuée sur tous les serveurs, das u ordre spécifique. Das le cas d'ue plateforme stad-aloe (moomachie), les étapes de migratio sot les suivates : 1 Migrez les serveurs de redirectio et de trackig (Apache / IIS). 2 Migrez le serveur marketig. Das le cas d'ue plateforme de mid-sourcig, les étapes de migratio sot les suivates : La commuicatio etre u serveur de marketig v5 et u serveur de mid-sourcig v6 est possible. Si vous décidez de coserver votre serveur marketig e v5, celui-ci doit être mis à jour avec le build v5 le plus récet avat la migratio du serveur de mid-sourcig. 1 Migrez les serveurs de redirectio et de trackig (Apache / IIS). 2 Migrez le serveur de mid-sourcig. 6 Neolae 2013

8 Itroductio 3 Migrez le serveur marketig. Neolae v6.0 - Guide de Migratio - Itroductio 7

9 Neolae 8 Neolae v6.0 - Guide de Migratio

10 CHAPITRE 2 Migratio techique Table des matières Migratio sous Widows Itroductio Prérequis Migratio de la plateforme Migratio du serveur de redirectio (IIS) Redémarrage des services Suppressio et ettoyage de Neolae v Migratio sous Liux Itroductio Prérequis Migratio de la plateforme Migratio du serveur de redirectio (Apache) Redémarrage des services Suppressio et ettoyage de Neolae v Avertissemet : Lors de la migratio, la table NmsRecipiet est recostruite à partir de la défiitio des schémas. Toute modificatio de la structure SQL de cette table effectuée e dehors de Neolae sera perdue. Exemples d'élémets à vérifier : Si vous avez ajouté ue coloe (ou u idex) das la table NmsRecipiet mais que vous e l'avez pas décrite das le schéma, celle-ci e sera pas coservée. L'attribut tablespace repred ses valeurs par défaut. Si vous avez ajouté ue vue qui référece la table NmsRecipiet, vous devez la supprimer avat la migratio. Migratio sous Widows Itroductio Les étapes de migratio sous Widows sot les suivates : 1 Arrêt des services et sauvegarde de la base : voir Prérequis [page 10], 2 Migratio de la plateforme : voir Migratio de la plateforme [page 11], Neolae v6.0 - Guide de Migratio - Migratio techique 9

11 Neolae 3 Migratio du serveur de redirectio (IIS) : voir Migratio du serveur de redirectio (IIS) [page 13], 4 Redémarrage des services : voir Redémarrage des services [page 16], 5 Suppressio et ettoyage de Neolae v5 : voir Suppressio et ettoyage de Neolae v5 [page 22]. Prérequis Arrêt des services Arrêtez tout d'abord tous les processus accédat à la base de doées. 1 Les serveurs utilisat le module de redirectio (service webmdl) doivet être arrêtés. Pour IIS, exécutez la commade suivate : iisreset /stop 2 Le module MTA et ses modules fils (MTACHILD) doivet être arrêtés correctemet à l'aide des commades : lserver stop mta@<om de l'istace> lserver stop mtachild@<om de l'istace> 3 Arrêtez les services Neolae sur tous les serveurs. Coectez-vous e tat qu'admiistrateur et exécutez la commade : et stop lserver5 4 Sur chaque serveur, vérifiez que les services Neolae ot bie été arrêtés. Coectez-vous e tat qu'admiistrateur et exécutez la commade : tasklist /FI "IMAGENAME eq lserver*" La liste des processus actifs aisi que leur idetifiat (PID) correspodat apparaît. Image Name PID Sessio Name Sessio# Mem Usage ========================= ======== ================ =========== ============ lserver.exe 3192 Cosole 1 13,108 K 5 Si u ou plusieurs processus Neolae sot ecore actifs ou bloqués, forcez leur arrêt. Coectez-vous e tat qu'admiistrateur et exécutez la commade : taskkill /F /IM lserver* /T Sauvegarde de la base et de l'istallatio existate 1 Sauvegardez la base de doées Neolae. 2 Sauvegardez le répertoire Neolae v5, à l'aide de la commade suivate : re "Neolae v5" "Neolae v5.back" Avertissemet : Par mesure de précautio, ous vous recommados vivemet de zipper le dossier Neolae v5.back, et de le coserver à u autre emplacemet que le serveur Neolae, sur u support sécurisé. 3 Das la cosole de gestio des services Widows, désactivez le démarrage automatique du service Neolae - Serveur Applicatif Vous pouvez égalemet utiliser la commade suivate : sc cofig lserver5 start= disabled 4 Editez les fichiers cofig-<om de l'istace>.xml (du dossier Neolae v5.back) pour empêcher le démarrage automatique des services MTA, WFSERVER, STAT, etc. Remplacez, par exemple, autostart par _autostart. <?xml versio='1.0'?> <servercof> <shared> <datastore hosts="obiwa*" lag="fr_fr"> <datasource ame="default"> 10 Neolae 2013

12 Migratio techique <dbcx ecrypted="1" logi="eolae:pass" password="mypassword" provider="postgresql" server="myserver.eolae.org"/> </datasource> </datastore> </shared> <mta _autostart="true" statserveraddress="localhost"/> <stat _autostart="true"/> <wfserver _autostart="true"/> <imail _autostart="true"/> <sms _autostart="false"/> </servercof> Migratio de la plateforme Les étapes de déploiemet de Neolae sot les suivates : 1 Istallez le build Neolae v6 le plus récet e exécutat le fichier d'istallatio setup.exe. L'istallatio du serveur Neolae sous Widows est décrite das le Guide d'istallatio. 2 Pour mettre à dispositio le programme d'istallatio de la cosole cliete, copiez le fichier setup-cliet exe das le répertoire d'istallatio de Neolae : C:\Program Files\Neolae\Neolae v6\datakit\l\fra\jsp (ici, ous preos comme exemple le build 6717). Pour plus d'iformatios sur l'istallatio de Neolae sous Widows, cosultez le Guide d'istallatio. 3 Préparez l'istace à sa première utilisatio à l'aide des commades suivates : et start lserver6 et stop lserver6 Ces commades permettet de créer le système de fichiers itere de Neolae v6 : répertoire cof (avec les fichiers cofig-default.xml et servercof.xml), répertoire var, etc. 4 Effectuez ue copie (par écrasemet), depuis le dossier de sauvegarde Neolae v5.back, des fichiers de cofiguratio et des sous-dossiers de chaque istace. Exécutez les commades suivates : Neolae v6.0 - Guide de Migratio - Migratio techique 11

13 Neolae Avertissemet : Pour la première des commades ci-dessous, e copiez pas le fichier cofig-default.xml. copy "Neolae v5.back"/cof/cofig-<om de l'istace>.xml "Neolae v6"/cof/ copy "Neolae v5.back"/customers/* "Neolae v6"/customers/ copy "Neolae v5.back"/var/* "Neolae v6"/var/ 5 Das les fichiers servercof.xml et cofig-default.xml de Neolae v6, appliquez les paramétrages spécifiques que vous aviez das Neolae v5. Pour le fichier servercof.xml, utilisez le fichier Neolae v5/cof/servercof.xml.diff. Lors du report des paramétrages Neolae v5 vers Neolae v6, assurez-vous que les chemis vers les répertoires physiques poitet bie vers Neolae v6 et pas Neolae v5. 6 La migratio 'état pas ue istallatio géérique, vous devez forcer le redémarrage du service trackiglogd. Pour cela, ouvrez le fichier Neolae v6/cof/cofig-default.xml et assurez-vous que le service trackiglogd est bie activé (uiquemet sur le ou les serveurs de trackig/redirectio) : <trackiglogd autostart="true"/> Avertissemet : Si le service trackiglogd 'est pas démarré sur le serveur de trackig, aucue iformatio de trackig e sera remotée. 7 Rechargez la cofiguratio de Neolae v6 à l'aide de la commade suivate : lserver cofig -reload 8 Démarrez le processus de postupgrade à l'aide de la commade suivate : Avertissemet : Vous devez impérativemet spécifier le fuseau horaire à utiliser comme référece au momet du postupgrade (à l'aide de l'optio -timezoe). Das cet exemple, ous utilisos le fuseau horaire Europe/Paris : -timezoe:"europe/paris". Si vous souhaitez utiliser le mode TIMESTAMP WITH TIMEZONE, vous devez égalemet ajouter l'optio -usetimestamptz:1 das la lige de commade du postupgrade. Attetio, e cas d'utilisatio du paramètre -usetimestamptz:1 avec u moteur de base o compatible, votre base de doées sera corrompue et il vous sera alors écessaire de restaurer ue sauvegarde de votre base de doées Neolae v5 et de ré-exécuter la commade ci-dessous. lserver cofig -timezoe:"<fuseau horaire>" -postupgrade -istace:<om de l'istace> Il est possible de modifier le fuseau horaire (paramètre -timezoe) après la migratio via la cosole (oeud Admiistratio>Plate-forme>Optios>WdbcTimeZoe). La gestio des fuseaux horaires est présetée das le Guide d'istallatio. Note pour les utilisateurs d'oracle : Si vous obteez l'erreur ORA lors du postupgrade, cela sigifie qu'il existe ue désychroisatio des fichiers de fuseaux horaires Oracle etre le serveur applicatif et le serveur de base. La procédure de resychroisatio est la suivate : 1 Pour idetifier le fichier de fuseau horaire utilisé, exécutez la commade suivate : select * from v$timezoe_file Les fichiers de fuseau horaire sot e gééral situés das le dossier ORACLE_HOME/oracore/zoeifo/ 12 Neolae 2013

14 Migratio techique 2 Assurez-vous que les fichiers de fuseau horaire sot bie les mêmes sur les deux serveurs. Pour plus d'iformatios, cosultez le site : Avertissemet : Ne redémarrez pas les services Neolae à ce stade. Des modificatios doivet préalablemet être effectuées sur IIS. Migratio du serveur de redirectio (IIS) A ce stade, le serveur IIS doit être arrêté. Voir : Prérequis [page 10]. 1 Ouvrez la cosole Iteret Iformatio Services (IIS) Maager. 2 Modifiez les liaisos (ports d'écoute) du site utilisé pour Neolae v5 : Cliquez avec le bouto droit sur le site utilisé pour Neolae v5 et sélectioez Modifier les liaisos. Pour chaque type de port d'écoute (http et/ou https), sélectioez la lige correspodate et cliquez sur Modifier. Saisissez u autre port que celui qui est reseigé. Par défaut, le port d'écoute est 80 pour le http et 443 pour le https. Vérifiez que le ouveau port est dispoible. Si votre serveur IIS embarque plusieurs sites web pour Neolae cofigurés de maière avacée (port commu et adresses IP différetes), veuillez vous rapprocher de votre admiistrateur. 3 Créez u ouveau site web pour Neolae v6 : Neolae v6.0 - Guide de Migratio - Migratio techique 13

15 Neolae Cliquez avec le bouto droit sur le dossier Sites et sélectioez Ajouter u site Web. Reseigez le om du site, par exemple Neolae v6. Le chemi d'accès au répertoire de base du site Web 'est pas utilisé, mais le champ Chemi d'accès physique doit être obligatoiremet reseigé. Saisissez par exemple le chemi physique par défaut de IIS : C:\ietpub\wwwroot. Cliquez sur le bouto Se coecter e tat que, et vérifiez que l'optio Utilisateur de l'applicatio est sélectioée. Das les champs Adresse IP et Port, vous pouvez laisser les valeurs par défaut. Si vous souhaitez utiliser d'autres valeurs, vérifiez que l'adresse IP et/ou le port sot dispoibles. Cochez la case Démarrage immédiat du site Web. 4 Exécutez le script iis_eolae_setup.vbs permettat de cofigurer automatiquemet le paramétrage des ressources utilisées par le serveur Neolae sur le répertoire virtuel créé précédemmet. Ce fichier se situe das le dossier [Neolae v6]\tomcat-6\cof, où [Neolae v6] est le chemi d'accès au répertoire d'istallatio de Neolae. La commade permettat d'exécuter le script est la suivate (e tat qu'admiistrateur) : cd C:\Program Files (x86)\neolae\neolae v6\tomcat-6\cof cscript iis_eolae_setup.vbs Cliquez sur OK pour cofirmer l'exécutio du script. 14 Neolae 2013

16 Migratio techique Saisissez le uméro du site Web que vous avez créé précédemmet pour Neolae v6 et cliquez sur OK. Cliquez sur OK pour valider le paramétrage de l'applicatio e 32 bits. Si vous disposez d'exécutables e 64 bits, ils e serot pas affectés. U message de cofirmatio doit s'afficher : Das l'oglet Affichage du coteu, vérifiez que la cofiguratio du site Web est bie paramétrée avec les ressources Neolae : Neolae v6.0 - Guide de Migratio - Migratio techique 15

17 Neolae Si l'arborescece 'est pas affichée, redémarrez le Gestioaire de service Iteret (IIS). Les étapes suivates de cofiguratio de IIS sot décrites das le Guide d'istallatio. Redémarrage des services Das les fichiers cofig-<om de l'istace>.xml, réactivez le démarrage automatique des services MTA, WFSERVER, STAT, etc <?xml versio='1.0'?> <servercof> <shared> <datastore hosts="obiwa*" lag="fr_fr"> <datasource ame="default"> <dbcx ecrypted="1" logi="eolae:pass" password="mypassword" provider="postgresql" server="myserver.eolae.org"/> </datasource> </datastore> </shared> <mta autostart="true" statserveraddress="localhost"/> <stat autostart="true"/> <wfserver autostart="true"/> <imail autostart="true"/> <sms autostart="false"/> </servercof> Sur chacu des serveurs suivats, démarrez IIS puis les services Neolae : 1 Serveur de trackig/redirectio. 2 Serveur de mid-sourcig. 3 Serveur marketig. Avat de passer à l'étape suivate, testez complètemet la ouvelle istallatio, validez la o-régressio et assurez-vous que tout est foctioel, e suivat toutes les recommadatios de la sectio Paramétrage [page 23]. Suppressio et ettoyage de Neolae v5 Avertissemet : Avat de supprimer et ettoyer l'istallatio de Neolae v5, il est impératif de suivre les recommadatios ci-dessous : Effectuez ue validatio compète de la ouvelle istallatio par les équipes foctioelles. Ne procédez à la désistallatio de Neolae v5 qu'ue fois que vous êtes certai qu'u retour arrière 'est pas écessaire. 1 Das IIS, supprimez le site web Neolae v5 puis le pool d'applicatios Neolae v5. 2 Reommez le dossier Neolae v5.back e Neolae v5. 16 Neolae 2013

18 Migratio techique 3 Désistallez Neolae v5 à l'aide de l'assistat d'ajout/suppressio de programme. 4 Supprimez le service Widows lserver5 à l'aide de la commade suivate : sc delete lserver5 5 Redémarrez le serveur. Migratio sous Liux Itroductio Les étapes de migratio sous Liux sot les suivates : 1 Arrêt des services, sauvegarde de la base et désistallatio des packages Neolae v5 : voir Prérequis [page 17], 2 Migratio de la plateforme : voir Migratio de la plateforme [page 19], 3 Migratio du serveur de redirectio (Apache) : voir Migratio du serveur de redirectio (Apache) [page 21], 4 Redémarrage des services : voir Redémarrage des services [page 22], 5 Suppressio et ettoyage de Neolae v5 : voir Suppressio et ettoyage de Neolae v5 [page 22]. Prérequis Arrêt des services Arrêtez d'abord tous les processus accédat à la base de doées, sur toutes les machies cocerées. 1 Coectez-vous e tat que root. 2 Les serveurs utilisat le module de redirectio (service webmdl) doivet être arrêtés. Pour Apache, exécutez la commade suivate : /etc/iit.d/apache2 stop 3 Recoectez-vous e tat que root. 4 Arrêtez les services Neolae sur tous les serveurs. Arrêtez tout d'abord le serveur de trackig, puis le serveur marketig, et efi le serveur de mid-sourcig. /etc/iit.d/lserver5 stop Neolae v6.0 - Guide de Migratio - Migratio techique 17

19 Neolae 5 Sur chaque serveur, vérifiez que les services Neolae ot bie été arrêtés. ps waux grep lserver La liste des processus actifs aisi que leur idetifiat (PID) correspodat apparaît. 6 Si u ou plusieurs processus Neolae sot ecore actifs ou bloqués au bout de quelques miutes, forcez leur arrêt. killall lserver 7 Si certais processus sot toujours actifs au bout de quelques miutes, vous pouvez forcer leur fermeture à l'aide de la commade : killall -9 lserver Sauvegarde de la base et de l'istallatio existate 1 Sauvegardez la base de doées Neolae. 2 Coectez-vous e tat que eolae et sauvegardez le répertoire l5 à l'aide de la commade suivate : su - eolae mv l5 l5.back Avertissemet : Par mesure de précautio, ous vous recommados vivemet de zipper le dossier l5.back, et de le coserver à u autre emplacemet que le serveur Neolae, sur u support sécurisé. 3 Editez les fichiers cofig-<om de l'istace>.xml (du dossier l5.back) pour empêcher le démarrage automatique des services MTA, WFSERVER, STATS, etc. Remplacez, par exemple, autostart par _autostart (toujours e tat que eolae). <?xml versio='1.0'?> <servercof> <shared> <datastore hosts="obiwa*" lag="fr_fr"> <datasource ame="default"> <dbcx ecrypted="1" logi="eolae:pass" password="mypassword" provider="postgresql" server="myserver.eolae.org"/> </datasource> </datastore> </shared> <mta _autostart="true" statserveraddress="localhost"/> <stat _autostart="true"/> <wfserver _autostart="true"/> <imail _autostart="true"/> <sms _autostart="false"/> </servercof> Désistallatio des packages Neolae v5 1 Coectez-vous e tat que root. 2 Idetifiez les packages Neolae istallés à l'aide de la commade suivate. Sous Debia : dpkg -l grep l La liste des packages istallés apparaît : ii lserver lserver ii lthirdparty lthirdparty Sous Red Hat : rpm -qa grep l 18 Neolae 2013

20 Migratio techique 3 Désistallez les packages Neolae v5. Sous Debia : dpkg --purge lserver5 lthirdparty5 Sous Red Hat : rprm -ev lserver5 lthirdparty5 Migratio de la plateforme Les étapes de déploiemet de Neolae sot les suivates : 1 Istallez les packages Neolae v6 les plus récets à l'aide de la commade suivate (ici, ous preos comme exemple la versio 6717 des composats tiers et le build 6764) : Sous Debia : dpkg -i lthirdparty liux-2.6-itel.deb lserver liux-2.6-itel.deb Sous Red Hat : rpm -Uvh lthirdparty i686.rpm lserver i686.rpm Avertissemet : Il est impératif que l'istallatio des packages réussisse pour passer à l'étape suivate. Après l'istallatio des packages, le message suivat apparaît : 'WdbcTimeZoe' optio is missig. L'apparitio de ce message à ce stade est ormale. 2 Pour mettre à dispositio le programme d'istallatio de la cosole cliete, copiez-le das le répertoire d'istallatio de Neolae (ici, ous preos comme exemple le build 6764) : cp setup-cliet exe /usr/local/eolae/l6/datakit/l/fra/jsp Pour plus d'iformatios sur l'istallatio de Neolae sous Liux, cosultez le Guide d'istallatio. 3 Modifiez le fichier.bashrd correspodat à l'utilisateur eolae. Coectez-vous e tat que eolae et exécutez la commade suivate : su - eolae vim ~/.bashrc Lorsque vous vous coectez e tat que Neolae, le message suivat apparaît : l5/ev.sh : No such file or directory. L'apparitio de ce message à ce stade est ormale. A la fi du fichier, remplacez l5/ev.sh par l6/ev.sh. 4 Recoectez-vous e tat que root et préparez l'istace à sa première utilisatio à l'aide des commades suivates : /etc/iit.d/lserver6 start Startig lserver6: [ OK ] /etc/iit.d/lserver6 stop Stoppig lserver6: [ OK ] Neolae v6.0 - Guide de Migratio - Migratio techique 19

21 Neolae Ces commades permettet de créer le système de fichiers itere de Neolae v6 : répertoire cof (avec les fichiers cofig-default.xml et servercof.xml), répertoire var. 5 Effectuez ue copie (par écrasemet), depuis le dossier de sauvegarde l5.back, des fichiers de cofiguratio et des sous-dossiers de chaque istace. Coectez-vous e tat que eolae et exécutez la commade suivate : Avertissemet : Pour la première des commades ci-dessous, e copiez pas le fichier cofig-default.xml. su - eolae cp l5.back/cof/cofig-<om de l'istace>.xml l6/cof/ cp l5.back/customer.sh l6/ cp -r l5.back/customers/* l6/customers/ cp -r l5.back/var/* l6/var/ 6 Das les fichiers servercof.xml et cofig-default.xml de Neolae v6, appliquez les paramétrages spécifiques que vous aviez das Neolae v5. Pour le fichier servercof.xml, utilisez le fichier l5/cof/servercof.xml.diff. Lors du report des paramétrages Neolae v5 vers Neolae v6, assurez-vous que les chemis vers les répertoires physiques poitet bie vers Neolae v6 et pas Neolae v5. 7 La migratio 'état pas ue istallatio géérique, vous devez forcer le redémarrage du service trackiglogd. Pour cela, ouvrez le fichier l6/cof/cofig-default.xml et assurez-vous que le service trackiglogd est bie activé (uiquemet sur le ou les serveurs de trackig/redirectio) : <trackiglogd autostart="true"/> Avertissemet : Si le service trackiglogd 'est pas démarré sur le serveur de trackig, aucue iformatio de trackig e sera remotée. 8 Rechargez la cofiguratio de Neolae v6 à l'aide de la commade suivate : lserver cofig -reload 9 Démarrez le processus de postupgrade à l'aide de la commade suivate (toujours e tat que eolae) : Avertissemet : Vous devez impérativemet spécifier le fuseau horaire à utiliser comme référece au momet du postupgrade (à l'aide de l'optio -timezoe). Das cet exemple, ous utilisos le fuseau horaire Europe/Paris : -timezoe:"europe/paris" Si vous souhaitez utiliser le mode TIMESTAMP WITH TIMEZONE, vous devez égalemet ajouter l'optio -usetimestamptz:1 das la lige de commade du postupgrade. Attetio, e cas d'utilisatio du paramètre -usetimestamptz:1 avec u moteur de base o compatible, votre base de doées sera corrompue et il vous sera alors écessaire de restaurer ue sauvegarde de votre base de doées Neolae v5 et de ré-exécuter la commade ci-dessous. su - eolae lserver cofig -timezoe:<fuseau horaire> -postupgrade -istace:<om de l'istace> 20 Neolae 2013

22 Migratio techique Il est possible de modifier le fuseau horaire après la migratio via la cosole (oeud Admiistratio>Plate-forme>Optios>WdbcTimeZoe). La gestio des fuseaux horaires est présetée das le Guide d'istallatio. Note pour les utilisateurs d'oracle : Si vous obteez l'erreur ORA lors du postupgrade, cela sigifie qu'il existe ue désychroisatio des fichiers de fuseaux horaires Oracle etre le serveur applicatif et le serveur de base. La procédure de resychroisatio est la suivate : 1 Pour idetifier le fichier de fuseau horaire utilisé, exécutez la commade suivate : select * from v$timezoe_file Les fichiers de fuseau horaire sot gééralemet situés das le dossier ORACLE_HOME/oracore/zoeifo/ 2 Assurez-vous que les fichiers de fuseau horaire sot bie les mêmes sur les deux serveurs. Pour plus d'iformatios, cosultez le site : Avertissemet : Ne redémarrez pas les services Neolae à ce stade. Des modificatios doivet préalablemet être effectuées sur Apache. Migratio du serveur de redirectio (Apache) A ce stade, Apache doit être arrêté. Voir : Prérequis [page 17]. 1 Coectez-vous e tat que root. 2 Modifiez les variables d'eviroemet d'apache afi de les faire poiter vers le répertoire l6. Sous Debia : vi /etc/apache2/evvars Sous Red Hat : vi /usr/local/apache2/bi/evvars 3 Exécutez esuite les commades suivates : Sous Debia : Das le fichier lsrv.load, remplacez toutes les occurreces de l5 par l6. vi /etc/apache2/mods-available/lsrv.load Supprimez le lie du fichier lsrv.cof et recréez-le. rm /etc/apache2/mods-available/lsrv.cof l -s /usr/local/eolae/l6/tomcat-6/cof/apache_eolae.cof /etc/apache2/ mods-available/lsrv.cof Sous Red Hat : Das le répertoire /usr/local/apache2/cof, éditez le fichier httpd.cof et remplacez l5 par l6 das les liges ci-dessous. LoadModule requesthadler22_module /usr/local/eolae/l6/lib/liblsrvmod.so Iclude /usr/local/eolae/l6/tomcat-6/cof/apache_eolae.cof 4 Das le fichier alias.cof, les occurreces de l5 doivet être remplacées par l6. Sous Debia, la commade est la suivate : vi /etc/apache2/mods-available/alias.cof Neolae v6.0 - Guide de Migratio - Migratio techique 21

23 Neolae Redémarrage des services Das les fichiers cofig-<om de l'istace>.xml, réactivez le démarrage automatique des services MTA, WFSERVER, STAT, etc <?xml versio='1.0'?> <servercof> <shared> <datastore hosts="obiwa*" lag="fr_fr"> <datasource ame="default"> <dbcx ecrypted="1" logi="eolae:pass" password="mypassword" provider="postgresql" server="myserver.eolae.org"/> </datasource> </datastore> </shared> <mta autostart="true" statserveraddress="localhost"/> <stat autostart="true"/> <wfserver autostart="true"/> <imail autostart="true"/> <sms autostart="false"/> </servercof> Sur chacu des serveurs suivats, démarrez Apache puis les services Neolae : 1 Serveur de trackig/redirectio. 2 Serveur de mid-sourcig. 3 Serveur marketig. Avat de passer à l'étape suivate, testez complètemet la ouvelle istallatio, validez la o-régressio et assurez-vous que tout est foctioel, e suivat toutes les recommadatios de la sectio Paramétrage [page 23]. Suppressio et ettoyage de Neolae v5 Avertissemet : Avat de supprimer et ettoyer l'istallatio de Neolae v5, il est impératif de suivre les recommadatios ci-dessous : Effectuez ue validatio compète de la ouvelle istallatio par les équipes foctioelles. Ne procédez à la désistallatio de Neolae v5 qu'ue fois que vous êtes certai qu'u retour arrière 'est pas écessaire. Supprimez le répertoire l5.back. Coectez-vous e tat que eolae et exécutez la commade suivate : su - eolae rm -rf l5.back Redémarrez le serveur. 22 Neolae 2013

24 CHAPITRE 3 Paramétrage Table des matières Coflits Applicatios web Workflows MySQL Trackig JavaScript L'arborescece Neolae v Coflits La migratio état effectuée au travers d'u postupgrade, des coflits peuvet apparaître au iveau des rapports, formulaires ou applicatios web. Ces coflits peuvet être résolus mauellemet à partir du oeud Admiistratio > Paramétrage > Gestio des packages > Editio des coflits. Pour plus d'iformatio sur la résolutio des coflits, cosultez le Guide d'exploitatio. Applicatios web L'avertissemet suivat apparaît systématiquemet lors de la migratio : The webapp ids have bee modified durig the migratio process. Please make sure to check your scripts/css for broke compatibility (ay cliet side javascript or css dealig directly with aother elemet through its id is impacted). See file 'c:\sv\602\l\build\cs\var\upgrade/postupgrade/webappsmigratio_*************.txt' for details about the refereces that were automatically updated, if ay. Certais composats des applicatios web, par exemple les différets champs d'u formulaire, possèdet des idetifiats. Ces idetifiats utilisés das le code XML des applicatios web, e sot plus géérés de la même maière. Ils e sot pas visibles das l'iterface et vous e devez ormalemet pas les utiliser. Cepedat, das certais cas, il se peut que ces idetifiats aiet été utilisés e paramétrage pour persoaliser l'apparece des applicatios web, par exemple via ue feuille de style ou du code JavaScript. Lors de la migratio, vous devez impérativemet vérifier le fichier de logs dot le chemi est idiqué das l'avertissemet : Le fichier 'est pas vide : celui-ci cotiet des avertissemets correspodat à des icohéreces qui existaiet avat la migratio, et qui existet doc toujours. Il peut s'agir par Neolae v6.0 - Guide de Migratio - Paramétrage 23

25 Neolae exemple de code JavaScript das ue applicatio web référeçat u idetifiat qui 'existe pas. Chaque erreur doit être vérifiée et corrigée. Le fichier est vide : cela sigifie que Neolae 'a détecté aucu problème. Que le fichier soit vide ou o, vous devez vérifier que ces idetifiats e sot pas utilisés e paramétrage à d'autres edroits, et le cas échéat adapter ce paramétrage. Workflows Le om du répertoire d'istallatio de Neolae ayat chagé, il se peut que certais workflows e foctioet pas après la migratio. E effet, si u workflow fait référece au répertoire l5 das l'ue ses activités, celui-ci sera e erreur. Cette référece doit être remplacée par l6. Ue requête SQL peut être exécutée pour idetifier ces workflows (exemple PostgreSQL) : SELECT iworkflowid, siteralname, slabel FROM XtkWorkflow WHERE mdata LIKE '%l5%'; MySQL MySQL e gère pas les fuseaux horaires par défaut. Pour activer la gestio des fuseaux horaires, exécutez la commade suivate : mysql_tzifo_to_sql /usr/share/zoeifo mysql -u root mysql Pour plus d'iformatios, cosultez la page : Si des modificatios de structure de base ot été effectuées, par exemple lors du paramétrage (créatio d'idex spécifiques, créatio de vues SQL, etc ), certaies précautios doivet être prises lors de la migratio. E effet, certaies modificatios peuvet géérer des icompatibilités avec la procédure de migratio. Par exemple, la créatio de vues SQL coteat des champs de type Timestamp 'est pas compatible avec l'optio -usetimestamptz. Nous vous coseillos doc de suivre les recommadatios ci-dessous : 1 Avat la migratio, effectuez ue sauvegarde de la base. 2 Supprimez les modificatios SQL. 3 Lacez le postupgrade. 4 Réitégrez les modificatios SQL. Das cet exemple, ue vue NmcTrackigLogMesssages a été créée et celle-ci cotiet u champ Timestamp ommé tslog. Das ce cas, la procédure de migratio échoue et le message d'erreur suivat apparaît : :57:51.804Z B67B28C0 1 ifo log Updatig table 'NmcTrackigLogMessages' :57:51.804Z B67B28C0 1 error log Erreur PostgreSQL: ERROR: caot alter type of a colum used by a view or rule\detail: rule _RETURN o view mctrackiglogmessagesview depeds o colum "tslog"\ (irc=-2006) :57:51.804Z B67B28C0 1 error log L'ordre SQL 'ALTER TABLE NmcTrackigLogMessages ALTER COLUMN tslog TYPE TIMESTAMPTZ' 'a pas pu être exécuté. (irc=-2006) Pour garatir le bo foctioemet du postupgrade, vous devez impérativemet supprimer la vue avat la migratio, puis la recréer après la migratio, e l'adaptat au mode TIMESTAMP WITH TIMEZONE. Trackig La formule de trackig a été modifiée. Au cours de la migratio, l'aciee formule (v5) est remplacée par la ouvelle (v6). Si vous utilisiez ue formule persoalisée das Neolae v5, ce paramétrage doit être adapté das Neolae v6 (optios NmsTrackig_ClickFormula et NmsTrackig_OpeFormula). 24 Neolae 2013

26 Paramétrage La gestio du trackig web a égalemet été modifiée. Ue fois la migratio v6 effectuée, vous devez lacer l'assistat de déploiemet afi de termier le paramétrage du trackig web. Trois optios sot dispoibles : Trackig Web de sessio : Si le package Neolae Leads 'est pas istallé, cette optio est sélectioée par défaut. Cette optio est la plus avatageuse e termes de performaces et permet de limiter la taille des logs de trackig. Trackig Web permaet : Au cours de la migratio, l'attribut logwebvisitors de l'élémet <trackig/> est supprimé das le fichier servercof.xml. Si l'attribut avait pour valeur true, vous devez sélectioer cette optio. Vérifiez, le cas échéat, que la coloe ssourceid de la table de trackig est idexée. Cette optio a u impact sigificatif sur les performaces. Trackig Web aoyme : Si le package Neolae Leads est istallé, cette optio est sélectioée par défaut. Cette optio est la plus cotraigate e termes de performaces. Comme pour l'optio Trackig Web permaet, la coloe ssourceid doit être idexée (das la table de trackig et la table CrmIcomigLead). Pour plus d'iformatios sur ces trois optios, cosultez le Guide de cofiguratio. JavaScript Neolae v6 itègre ue versio plus récete de l'iterpréteur JavaScript. Cepedat, cette mise à jour est susceptible d'etraîer des dysfoctioemets au iveau de certais scripts. Le moteur précédet état plus permissif, certaies sytaxes foctioaiet ce qui 'est plus le cas avec la ouvelle versio du moteur. A préset, pour modifier ue valeur das u objet XML, il faut d'abord mettre à jour la valeur avat d'ajouter le oeud XML : Acie code Javascript : Neolae v6.0 - Guide de Migratio - Paramétrage 25

27 Neolae var cellstyle = ode.style.copy(); this.styles.appedchild(cellstyle); cellstyle.@width = colum.@width; Nouveau code Javascript : var cellstyle = ode.style.copy(); cellstyle.@width = colum.@width; this.styles.appedchild(cellstyle); L'arborescece Neolae v6 Lors de la migratio, l'arborescece est automatiquemet réorgaisée selo les ouvelles ormes de la v6. Les ouveaux dossiers sot ajoutés, les dossiers obsolètes supprimés et le coteu de ces deriers placés das le dossier «To move». Tous les élémets de ce dossier doivet être vérifiés après la migratio, et pour chacu, le cosultat doit décider s'il souhaite le coserver ou le supprimer. Il doit esuite replacer au bo edroit les élémets à coserver. Ue optio a été ajoutée permettat de désactiver la migratio automatique de l'arborescece. Celle-ci deviet doc mauelle. Les dossiers obsolètes e sot pas supprimés et les ouveaux dossiers e sot pas ajoutés. Cette optio 'est à utiliser que das le cas où l'arborescece d'usie v5 a subi u ombre de modificatios trop importat. L'optio est à ajouter das la cosole, avat la migratio, au iveau du oeud Admiistratio > Optios : Nom itere : NlMigratio_KeepFolderStructure Type de doées : Etier Valeur (texte) : 1 Si vous utilisez cette optio, vous devrez, après la migratio, supprimer les dossiers obsolètes, ajouter les ouveaux dossiers et effectuer toutes les vérificatios écessaires. Liste des ouveaux dossiers : Les dossiers à ajouter après la migratio sot les suivats : Nom itere msautoobjects mscampaigadmi mscampaigmgt mscampaigres msmodels msolieres msproductio msprofilprocess xtkdashboard xtkplatformadmi mslocalorguit msmrm msoperatios Libellé Objets créés automatiquemet Gestio de campage Gestio de campage Gestio de campage Modèles O-lie Exploitatio Traitemets Tableaux de bord Plate-forme Etités orgaisatioelles MRM Opératios Coditio Neolae MRM istallé Neolae Campaig istallé Liste des dossiers obsolètes : Les dossiers obsolètes, à supprimer après la migratio, sot les suivats : Tout le coteu des dossiers obsolètes doit être vérifié, et pour chaque élémet, le cosultat doit décider s'il souhaite le coserver ou le supprimer. Il doit esuite replacer au bo edroit les élémets à coserver. 26 Neolae 2013

28 Paramétrage Nom itere msadmiistratio msdeliverymgt cmcotet cmform cmimage cmjavascript cmjst cmparameters cmsrcschema cmstylesheet msadmipla msresourcepla msresourcesmodels msrootpla msoperator Libellé Admiistratio Exécutio de campage Gestio de coteu Formulaires de saisie Images Codes JavaScript Templates JavaScript Paramétrage Schémas de doées Feuilles de style XSL Admiistratio Ressources Modèles Gestio de campage Opérateurs marketig Coditio Neolae Cotet Maager istallé Neolae Cotet Maager istallé Neolae Cotet Maager istallé Neolae Cotet Maager istallé Neolae Cotet Maager istallé Neolae Cotet Maager istallé Neolae Cotet Maager istallé Neolae Cotet Maager istallé Neolae Campaig istallé Neolae Campaig istallé Neolae Campaig istallé Neolae Campaig istallé Neolae MRM istallé Neolae v6.0 - Guide de Migratio - Paramétrage 27

29 Neolae 28 Neolae v6.0 - Guide de Migratio

30 CHAPITRE 4 Aexes Table des matières Procédure de retour-arrière Procédure de retour-arrière La procédure ci-dessous décrit les étapes à suivre si vous souhaitez effectuer u retour-arrière vers la versio précédete de Neolae. 1 Récupérez la sauvegarde de la base de doées et restaurez-la. 2 Récupérez le dossier Neolae v5.back (l5.back sous Liux), reommez-le e Neolae v5 (l5 sous Liux) et restaurez-le à so emplacemet d'origie. 3 Recofigurez IIS e réaffectat les ports d'écoute afi de rétablir l'itégratio de Neolae v5 au iveau du site Web IIS. 4 Arrêtez le service Neolae v6. 5 Redémarrez IIS. 6 Redémarrez le service Neolae v5. Neolae v6.0 - Guide de Migratio - Aexes 29

31 Neolae 30 Neolae v6.0 - Guide de Migratio