Guide d'exploitation. Neolane v6.0

Transcription

1 Guide d'exploitatio 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 : 6891 Neolae 18 rue Roger Simo Barboux, Arcueil - Frace

4 Table des matières Neolae v6.0 - Guide d'exploitatio Chapitre 1. Architecture géérale de Neolae Architecture miimale Architecture répartie Liste des ports ouverts Chapitre 2. Procédures d'exploitatio Pricipe de cofiguratio Pricipe de foctioemet Admiistratio Paramétrage Chagemet du port d'écoute du module syslogd Fichiers de log Surveillace des processus Neolae Surveillace mauelle Surveillace automatique Surveillace automatique via les scripts de Neolae Commades usuelles Commades de moitorig Commades de lacemet des modules Arrêter les services Redémarrer les services La commade cofig Chapitre 3. Traitemet des doées La sauvegarde Les fichiers physiques La base de doées La restauratio La duplicatio d'eviroemets Itroductio Mise e oeuvre Descriptio du workflow Nettoyage de la base Itroductio Paramétrage Tâches effectuées par le workflow Nettoyage de la base Neolae v6.0 - Guide d'exploitatio 3

5 Neolae Chapitre 4. Mise à jour de Neolae Mise à jour de versio Sous Widows Sous Liux Résoudre les coflits de mise à jour Alerter les postes cliets de la dispoibilité de la mise à jour Exemple de trasformatio e Uicode d'ue istace existate Chapitre 5. Maiteace de la base de doées Liste des tables à maiteir Tables Neolae Tables Cliets Types de maiteace Maiteace au iveau applicatif Maiteace techique Spécificités par SGBDR PostgreSQL Oracle DB SQL Server MySQL Chapitre 6. E cas de problème Fichiers temporaires Performaces de la base Cofiguratio matérielle Cofiguratio de la plateforme Maiteace de la base de doées Cas particuliers Modules et problèmes courats Précisio des logs Remotée des logs de trackig OpeOffice Evoi des s Exécutio des workflows Coexio impossible Seuil de coexios Dr Watso sous Widows XP (cliet) Stack trace sous Liux Ecodage de la base de doées Oracle Réactivatio de la demade de mise à jour de la cosole Perte de mot de passe Comportemet aormal des JSP Neolae 2013

6 CHAPITRE 1 Architecture géérale de Neolae Table des matières Architecture miimale Architecture répartie Liste des ports ouverts Ce chapitre présete l'architecture géérale de Neolae. Architecture miimale Das ue cofiguratio miimale, Neolae foctioe avec : le serveur applicatif Neolae, la base de doées. Neolae v6.0 - Guide d'exploitatio - Architecture géérale de Neolae 5

7 Neolae Ce schéma motre que les seuls flux utilisés das le cadre d'ue architecture miimale sot : 1 du protocole HTTP vers le serveur Neolae depuis Iteret, 2 du protocole SMTP de et vers le serveur Neolae depuis Iteret. Architecture répartie Neolae est composé de multiples modules qui peuvet être répartis etre plusieurs machies. Ce mode de foctioemet présete plusieurs itérêts : répartitio de la charge, mise e place de la redodace de modules, costructio d'ue architecture répartie sur plusieurs prestataires (segmetatio des services fouris). La répartitio des modules sur plusieurs machies offre ue grade souplesse d'utilisatio et ue meilleure adaptabilité. Astuce : Pour plus d'iformatios sur les différetes architectures, reportez-vous au Guide d'istallatio. Liste des ports ouverts Numéro de port 443/tcp ou 80/tcp 6025/tcp 6666/udp (local) 8005/tcp (local) Module Neolae ou applicatio coceré Serveurs Web (Apache/IIS) Serveur OpeOffice.org (Xvfb) Neolae : Syslogd Neolae : module web Paramétrable OUI NON OUI OUI 6 Neolae 2013

8 Architecture géérale de Neolae Numéro de port 8080/tcp 7777 Module Neolae ou applicatio coceré Neolae : module web (tomcat) Serveur de statistiques (stat server) Paramétrable OUI OUI Neolae v6.0 - Guide d'exploitatio - Architecture géérale de Neolae 7

9 Neolae 8 Neolae v6.0 - Guide d'exploitatio

10 CHAPITRE 2 Procédures d'exploitatio Table des matières Pricipe de cofiguratio Pricipe de foctioemet Admiistratio Paramétrage Chagemet du port d'écoute du module syslogd Fichiers de log Surveillace des processus Neolae Surveillace mauelle Surveillace automatique Surveillace automatique via les scripts de Neolae Commades usuelles Commades de moitorig Commades de lacemet des modules Arrêter les services Redémarrer les services La commade cofig Pricipe de cofiguratio La plateforme Neolae repose sur le cocept d'istace semblable à la otio d'hôte virtuel comme c'est le cas par exemple sous Apache. Ce mode de foctioemet permet de mutualiser u serveur e y affectat plusieurs istaces. Chaque istace est totalemet découplée des autres et foctioe avec sa propre base et so propre fichier de cofiguratio. Sur u même serveur, deux élémets sot commus à l'esemble des istaces Neolae : Le mot de passe iteral : il s'agit du mot de passe admiistrateur gééral. Il est commu à toutes les istaces d'u même serveur applicatif. De ombreux paramétrages techiques du serveur : ces paramétrages peuvet tous être surchargés das la cofiguratio spécifique d'ue istace. Les fichiers de cofiguratio sot eregistrés das le répertoire cof du répertoire d'istallatio. La cofiguratio est répartie sur trois fichiers : servercof.xml : cofiguratio géérale pour toutes les istaces. servercof.xml.diff : delta etre la cofiguratio iitiale et la cofiguratio actuelle. Ce fichier est géré automatiquemet par l'applicatio et e doit pas être modifié mauellemet. Il permet de propager automatiquemet les modificatios utilisateur lors d'ue mise à jour de build. Neolae v6.0 - Guide d'exploitatio - Procédures d'exploitatio 9

11 Neolae cofig-<istace>.xml (où <istace> est le om de l'istace) : cofiguratio spécifique d'ue istace. Le chargemet de la cofiguratio d'ue istace est réalisé de la maière suivate : 1 Le module charge le fichier servercof.xml pour obteir les paramètres commus à toutes les istaces. 2 Il charge esuite le fichier cofig-<istace>.xml. Les valeurs trouvées das ce derier fichier ot priorité sur les valeurs présetes das le fichier servercof.xml. Ces deux fichiers ot le même format, toute valeur présete das servercof.xml peut être surchargée pour ue istace doée das le fichier cofig-<istace>.xml. Ce pricipe de foctioemet permet ue très grade souplesse das les paramétrages. Pricipe de foctioemet La plateforme Neolae repose techiquemet sur plusieurs modules. Il existe de ombreux modules Neolae. Certais foctioet e cotiu, d'autres sot démarrés poctuellemet pour effectuer des actios d'admiistratio (par exemple : cofigurer la coexio à la base de doées) ou lacer ue tâche récurrete (par exemple : cosolider les iformatios de trackig). O distigue trois types de modules Neolae : Les modules multi-istaces : u seul processus est démarré pour toutes les istaces. Il s'agit des modules web, syslogd, trackiglogd et watchdog (activés à partir du fichier cofig-default.xml). Les modules moo-istace : u processus est démarré par istace. Il s'agit des modules mta, wfserver, imail, sms et stat (activés à partir du fichier cofig-<istace>.xml). Les modules utilitaires : il s'agit de modules démarrés occasioellemet pour réaliser des opératios poctuelles ou récurretes (cleaup, cofig, remotée des logs de trackig, etc.). L'admiistratio de ces modules est assurée par l'outil lige de commade lserver istallé das le répertoire bi du dossier d'istallatio. La sytaxe géérale de l'outil lserver est la suivate : lserver <commade> <argumets de la commade> Pour coaître la liste des modules dispoibles, lacez la commade lserver Les modules dispoibles sot décrits das le tableau suivat : Commade aliascleasig billig cleaup cofig copybase export filecovert import imail istallsetup javascript job merge midsourcig moitor mta package Descriptio Normalisatio des valeurs d'éumératio Trasmissio du rapport d'activité du système à <[email protected]> Nettoyage de la base de doées : supprime les doées obsolètes de la base de doées et lace ue mise à jour des statistiques utilisées par l'optimiseur du moteur de base de doées Modificatio de la cofiguratio du serveur Copie d'ue base de doées Export e lige de commade : permet de lacer e lige de commade u modèle d'export créé depuis le cliet Neolae Coversio de fichier à taille fixe Import e lige de commade : permet de lacer e lige de commade u modèle d'import créé depuis le cliet Neolae Aalyseur des mails etrats Mise à dispositio du fichier d'istallatio du cliet Exécutio de scripts JavaScript, ayat accès aux APIs SOAP Traitemet lige de commade Fusio de formulaires Récupératio des iformatios des evois e mode mid-sourcig Affichage, au format XML, de l'état des processus serveur et des tâches plaifiées, par istace Message Trasfert Aget pricipal Import ou export de fichier de package d'etités 10 Neolae 2013

12 Procédures d'exploitatio Commade pdump prepareda restart ruwf shutdow sms sql start stat stop submitda syslogd trackig trackiglogd watchdog web wfserver Descriptio Affichage de l'état des processus serveur Préparer ue actio de diffusio Redémarrage partiel du serveur Exécutio d'ue istace de workflow Arrêt complet du système Traitemet des otificatios SMS Exécutio de scripts SQL Démarrages additioels Maitiet les statistiques des coexios des MTA Arrêt partiel du système Soumettre ue actio de diffusio Serveur d'écriture des logs et traces Cosolidatio et récupératio des logs de trackig Serveur d'écriture et de purge des logs de trackig Module de démarrage et surveillace Serveur applicatif (HTTP et SOAP) Serveur de workflows Avertissemet : Il existe u derier module : le module de trackig et de relais vers le serveur applicatif qui, pour des raisos de performaces, s'itègre sous la forme d'ue librairie dyamique via des mécaismes atifs à u serveur Web IIS ou Apache. Il 'existe pas de commade Neolae permettat de démarrer ou d'admiistrer ce module, vous devez doc utiliser les commades d'admiistratio du serveur Web. L'usage d'u module et la sytaxe de ses paramètres sot affichés à partir de la commade : lserver [module] -? Exemple : lserver cofig -? Usage: lserver [-verbose:<mode verbeux>] [-? h H] [-versio] [-ocosole] [-tracefile:<fichier>] [-tracefilter:<[type!type],...>] [-istace:<istace>] [-low] [-high] [-queryplas] [-detach] [-iteralpassword:<[motdepasse/ouveaumotdepasse]>] [-postupgrade] [-omerge] [-repair] [-force] [-allistaces] [-addistace:<istace/masques DNS[/lague]>] [-setdblogi:<[sgbd:]compte[:base][/motdepasse]@serveur>] [-datasource:<datasource>] [-addtrackigistace:<istace/masques DNS[/databaseId/[/lague[/motdepasse]]]>] [-trackigpassword:<[motdepasse][/ouveaumotdepasse]>] [-setproxy:<protocole/serveur:port[/logi]>] [-reload] [-applyxsl:<schema/fichier.xsl>] [-filter:<fichier>] [-setactivatiokey:<clé d'activatio>] [-origial:<datakit d'origie>] -verbose : mode verbeux -? : affiche ce message d'aide -versio : affiche le uméro de versio -ocosole : e plus afficher les logs et traces sur la cosole -tracefile : om du fichier de trace à géérer (sas extesio) -tracefilter : filtre pour les traces à géérer. Ex : wdbc,soap,!xtkquery. -istace : istace à utiliser (istace 'default' si optio o présete). -low : démarrer avec ue priorité basse -high : démarrer avec ue priorité haute (o recommadé) -queryplas : géère des traces avec les plas d'exécutios des requêtes SQL. -detach : détache le processus de so paret (optio itere) -iteralpassword : chage le mot de passe du compte itere du serveur. -postupgrade : mettre à jour la base de doées suite à ue motée de versio -omerge : e fusioe pas les etités persoalisées avec les mises à jour -repair : igore les erreurs de mise à jour de structure de la base et force la mise à Neolae v6.0 - Guide d'exploitatio - Procédures d'exploitatio 11

13 Neolae jour des schémas -force : effectue la mise à jour de la base même si elle a déjà été effectuée avec le build courat -allistaces : effectue la mise à jour de la base sur toutes les istaces cofigurées -addistace : ajoute ue ouvelle istace. -setdblogi : fixe les paramètres de coexio à la base de doées d'ue istace. Le SGBD peut être 'oracle', 'postgresql', 'mssql' ou 'odbc' (défaut=postgresql) -datasource : Idique le om de la datasource de l'istace pour lequel les paramètres de coexio serot modifiés. (Si rie 'est précisé, les modificatios s'appliquerot à la datasource 'default' -addtrackigistace : ajoute ue ouvelle istace de trackig. -trackigpassword : chage le mot de passe de trackig d'ue istace. -setproxy : fixe les paramètres de coexio à u serveur proxy. Le protocole peut être 'http', 'https' ou 'all'. -reload : demade au serveur de recharger la cofiguratio des istaces. -applyxsl : applique ue feuille de style XSL sur toutes les etités d'u schéma. -filter : applique le filtre XTK coteu das le fichier lors du chargemet des etités du schéma. -setactivatiokey : fixe la clé d'activatio -origial : datakit de la derière mise à jour. Admiistratio Le démarrage automatique des modules Neolae (web, mta, wfserver, etc.) est assuré par le service lserver. L'istallatio de Neolae paramètre automatiquemet la machie afi que le service lserver démarre pedat la séquece de boot. Les commades suivates permettet de démarrer/arrêter mauellemet le service Neolae : Sous Widows : et start lserver6 et stop lserver6 Sous Liux (e tat que root) : /etc/iit.d/lserver6 start /etc/iit.d/lserver6 stop Voici ue liste des commades usuelles d'admiistratio accessibles sous Liux (e tat que eolae) : Afficher tous les modules Neolae démarrés : /etc/iit.d/lserver6 pdump ou /etc/iit.d/lserver6 status Note : Si vous ajoutez le paramètre -who après la commade pdump, vous récupérez les iformatios sur les coexios e cours (utilisateurs et traitemets). Démarrer/arrêter u module multi-istace ou moo-istace (web, trackiglogd, syslogd, mta, wfserver, imail) : lserver start <module>[@<istace>] lserver stop <module>[@<istace>][-immediate] [-ocosole] Vous pouvez égalemet utiliser la commade lserver restart <module>[@<istace>] pour redémarrer u module. Exemple : lserver start web lserver start mta@mo_istace lserver stop syslogd lserver stop wfserver@mo_istace lserver stop web -immediate lserver restart web 12 Neolae 2013

14 Procédures d'exploitatio Note : Si l'istace 'est pas précisée, il s'agira de l'istace "default". Utilisez l'optio -immediate e cas d'urgece pour forcer l'arrêt immédiat du processus (équivalet à la commade kill -9 sous Uix). Utilisez l'optio -ocosole afi que le module lacé 'affiche rie sur la cosole. Ses logs serot écrits sur disque par le biais du module syslogd. Utilisez l'optio -verbose pour afficher davatage d'iformatios sur les actios du processus. Exemple : lserver restart web -verbose lserver start mta@moistace -verbose Cette optio ajoute des logs supplémetaires. Nous vous coseillos de redémarrer les processus sas l'optio -verbose après avoir obteu vos iformatios afi de e pas surcharger les logs. Démarrer tous les processus Neolae (équivalet à u démarrage du service lserver6) : lserver watchdog -ocosole Arrêter tous les processus Neolae (équivalet à u arrêt du service lserver6) : lserver shutdow Recharger la cofiguratio du module lserver web (et le cas échéat le module d'extesio du serveur web) lorsque les fichiers servercof.xml et cofig-<istace>.xml ot été édités. lserver cofig -reload Note : Certaies modificatios de la cofiguratio e sot pas prises e compte dyamiquemet et écessitet u arrêt/démarrage complet de Neolae. Paramétrage Chagemet du port d'écoute du module syslogd Sous Liux Par défaut, le port d'écoute du module syslogd est le 6666 (udp). Vous pouvez cepedat modifier le port d'écoute à l'aide d'ue variable d'eviroemet. Ue fois paramétrée, cette variable est prise e compte par tous les modules Neolae. Vous devez éditer le fichier customer.sh et ajouter la lige suivate : export TRACE_ADDR=localhost:<port d'écoute> Sous Widows Vous devez créer la variable d'eviroemet TRACE_ADDR avec la valeur localhost: <port d'écoute>. Avertissemet : Nous vous recommados de procéder à des tests afi de vérifier le bo foctioemet de votre plateforme après avoir créé cette variable d'eviroemet. Neolae v6.0 - Guide d'exploitatio - Procédures d'exploitatio 13

15 Neolae Fichiers de log L'arborescece des fichiers de log est la suivate : Chaque module lserver géère u fichier de log eregistré sous le répertoire suivat : <répertoire d'istallatio>/var/<istace>/log/<module>.log. L'eregistremet des logs sur le disque est assuré par le module lserver syslogd. Ce module est similaire au daemo syslog UNIX, mais adapté afi d'avoir u comportemet homogèe etre UNIX et Widows. Les autres modules Neolae 'eregistret pas leurs logs sur le disque : ils délèguet cette tâche au module syslogd e lui evoyat des paquets UDP. Par défaut, la plateforme Neolae est istallée avec le module syslogd, mais il est possible d'utiliser u autre daemo syslog. Les fichiers de log sot créés par ce module das le répertoire log. Les logs des modules multi-istaces sot stockés das le répertoire suivat : <répertoire d'istallatio>/var/default/log/. Le même fichier de log est partagé par toutes les istaces (ex : web.log). Les logs des autres modules sot stockés das u sous-dossier du om de l'istace. Chaque istace possède ses propres fichiers de log. Les fichiers de log multi-istaces sot listés das le tableau suivat : Fichier web.log webmdl.log watchdog.log trackiglogd.log Descriptio Logs du module web (cosole cliete, rapports, API SOAP, etc.) Logs proveat du module de redirectio Logs du module de surveillace des processus Neolae Logs de trackig Les fichiers de log moo-istace sot listés das le tableau suivat : Fichier mta.log mtachild.log wfserver.log ruwf.log imail.log Descriptio Logs du module mta Logs de traitemet de diffusio des messages Logs du module serveur de workflow Logs de l'exécutio d'u workflow Logs du module des mails rebod Avertissemet : Le répertoire redir 'existe que sur les serveurs de redirectio. Le sous-répertoire url cotiet les correspodaces des URLs à rediriger, et le sous-répertoire log cotiet les logs de trackig. Pour géérer des logs de trackig, le module trackiglogd doit avoir été démarré. Les logs sot par défaut limités à deux fichiers de 10Mo par module et par istace. Le deuxième fichier se omme : <ommodule>_2.log. La taille des logs est doc limitée à 2*10Mo par module et par istace. 14 Neolae 2013

16 Procédures d'exploitatio Vous pouvez toutefois coserver des fichiers de taille supérieure. Pour cela, modifiez la valeur du paramètre maxfilesizemb="10" du oeud syslogd das le fichier cof/servercof.xml. Cette valeur représete la taille maximale e Mo d'u fichier de log. Si vous souhaitez u iveau de logs plus élevé, vous pouvez lacer les modules Neolae avec le paramètre -verbose : lserver start <MODULE>@<INSTANCE> -verbose Surveillace des processus Neolae La surveillace du serveur applicatif et du serveur de redirectio (trackig) peut être mauelle ou automatique. Surveillace mauelle Depuis la page d'accueil de Neolae, utilisez les meus Avacé>Supervisio de l'istace pour afficher la page de surveillace des processus Neolae. La page qui s'affiche permet de visualiser l'état de l'istace coectée à savoir : les iformatios relatives à l'istace (versio, om, moteur de base de doées, packages istallés, idicateurs système du serveur), Neolae v6.0 - Guide d'exploitatio - Procédures d'exploitatio 15

17 Neolae la liste des processus maquats et les iformatios d'exécutio (date de démarrage, PID, etc.), ue vue des workflows et des diffusios. Joural des logs Il est possible d'afficher le joural des logs relatif à u processus. Pour cela, cliquez sur u processus, par exemple mta, puis sur Ouvrir le joural des logs. Idicateurs système La liste des idicateurs système permet d'afficher des iformatios cocerat la machie comme la mémoire physique et virtuelle de la machie, les processus e cours d'activité ou so espace disque. Les idicateurs sot différets selo que le serveur est istallé sur ue machie utilisat u système d'exploitatio Liux ou Widows. Das la page Exploitatio de l'istace, cliquez sur le lie Afficher pour dérouler la liste des idicateurs. 16 Neolae 2013

18 Procédures d'exploitatio Sous Widows Pedig evets queued : idicateur propre à Neolae Message Ceter. Reportez-vous à la sectio Seuils de surveillace des évéemets pour plus d'iformatios. Memory : iformatios relatives à la mémoire physique (RAM). Curret value : cosommatio réelle de mémoire. Max Value : quatité totale de mémoire istallée. Available : quatité de mémoire dispoible. Warig : cet idicateur s'affiche lorsque la cosommatio de la mémoire atteit les 80% de la quatité totale. Alert : cet idicateur s'affiche lorsque la cosommatio de la mémoire atteit les 90% de la quatité totale. Lorsque les idicateurs Warig et Alert s'affichet, vous pouvez remédier au problème e ajoutat de la RAM à la machie sur laquelle est istallé le serveur Neolae. Vous pouvez égalemet choisir d'istaller le serveur Neolae sur ue machie dédiée. Swap Memory : iformatios relatives à la mémoire virtuelle qui correspod à u fichier d'échage, soit ue zoe du disque que Widows utilise comme s'il s'agissait de mémoire vive. Curret value : cosommatio réelle de mémoire. Max Value : quatité totale de mémoire. Available : quatité de mémoire dispoible. Warig : cet idicateur s'affiche lorsque la cosommatio de la mémoire atteit les 80% de la quatité totale. Alert : cet idicateur s'affiche lorsque la cosommatio de la mémoire atteit les 90% de la quatité totale. Lorsque les idicateurs Warig et Alert s'affichet, vous pouvez remédier au problème e augmetat la taille du fichier d'échage das les paramètres avacés de Widows. Disk XXX : iformatios relatives aux lecteurs de la machie. Curret value : espace du disque réellemet utilisé. Max Value : capacité totale du disque. Available : espace libre du disque Used : taux d'utilisatio du disque e pourcetage. Neolae v6.0 - Guide d'exploitatio - Procédures d'exploitatio 17

19 Neolae Warig : cet idicateur s'affiche lorsque l'espace disque dispoible atteit les 80% de la capacité totale. Alert : cet idicateur s'affiche lorsque l'espace disque dispoible atteit les 90% de la capacité totale. Number of processes too old : iformatios relatives aux processus Neolae e cours depuis plus d'ue jourée. Curret value : ombre de processus actuellemet e cours. Max Value : ombre maximal de processus autorisés (1). Alert : cet idicateur s'affiche lorsque le ombre de processus est à 1. Lorsque l'idicateur Alert s'affiche, ue des causes possible peut-être que le processus e questio est verrouillé par le moteur de base de doées SQL ou qu'il est e boucle ifiie. Le processus watchdog fouri par Neolae relace automatiquemet la totalité des processus chaque jour et permet de remédier au problème. Vous pouvez cepedat iterrompre le processus coceré vous-même afi de forcer so redémarrage. Sous Liux Pedig evets queued : idicateur propre à Neolae Message Ceter. Reportez-vous à la sectio Seuils de surveillace des évéemets pour plus d'iformatios. Load average (1/5/15 miutes) : iformatios relatives à la charge, soit le taux d'utilisatio du processeur par les processus de la machie, au cours de la derière miute ou des ciq derières miutes ou du derier quart d'heure. Curret value : charge actuelle de la machie. Max value : charge maximale d'utilisatio du ou des processeurs de la machie. Warig : cet idicateur s'affiche lorsque la charge atteit 80% de la valeur maximale autorisée au cours de la derière miute, ou des ciq ou quize derières miutes. Alert : cet idicateur s'affiche lorsque la charge atteit 90% de la valeur maximale autorisée au cours de la derière miute, ou des ciq ou quize derières miutes. Memory : iformatios relatives à la mémoire physique (RAM). Curret value : cosommatio réelle de mémoire. Max Value : quatité totale de mémoire istallée. Available : quatité de mémoire dispoible. 18 Neolae 2013

20 Procédures d'exploitatio Warig : cet idicateur s'affiche lorsque la cosommatio de la mémoire atteit les 80% de la quatité totale. Alert : cet idicateur s'affiche lorsque la cosommatio de la mémoire atteit les 90% de la quatité totale. Lorsque les idicateurs Warig et Alert s'affichet, vous pouvez remédier au problème e ajoutat de la RAM à la machie sur laquelle est istallé le serveur Neolae. Vous pouvez égalemet choisir d'istaller le serveur Neolae sur ue machie dédiée. Swap Memory : iformatios relatives à la mémoire virtuelle qui correspod à u fichier d'échage, soit ue zoe du disque utilisé par le système d'exploitatio comme s'il s'agissait de mémoire vive. Curret value : cosommatio réelle de mémoire. Max Value : quatité totale de mémoire. Available : quatité de mémoire dispoible. Warig : cet idicateur s'affiche lorsque la cosommatio de la mémoire atteit les 80% de la quatité totale. Alert : cet idicateur s'affiche lorsque la cosommatio de la mémoire atteit les 90% de la quatité totale. Lorsque les idicateurs Warig et Alert s'affichet, vous pouvez remédier au problème e augmetat la taille du fichier d'échage. Core Files : iformatios relatives aux fichiers géérés suite au crash d'u processus Neolae. Ces fichiers permettet de diagostiquer les raisos du crash. Curret Value : ombre de fichiers existats. Max Value : ombre maximal de fichiers autorisé (1). Warig : cet idicateur s'affiche lorsque le ombre de fichiers s'approche de 1. Alert : cet idicateur s'affiche lorsque le ombre de fichiers est à 1. Lorsqu'u processus est maquat suite à u crash, il apparaît e rouge das la liste des processus et est relacé automatiquemet par le processus watchdog fouri par Neolae. Number of shared memory segmets : iformatios relatives aux segmets de mémoire partagée par tous les processus Neolae. Curret value : ombre de segmets de mémoire actuellemet utilisés. Max Value : ombre maximal de segmets de mémoire autorisé (2). Warig : cet idicateur s'affiche lorsque le ombre de segmets de mémoire atteit 1. Alert : cet idicateur s'affiche lorsque le ombre de segmets de mémoire atteit 2. Number of processes too old : iformatios relatives aux processus e cours depuis plus d'ue jourée. Curret value : ombre de processus actuellemet e cours. Max Value : ombre maximal de processus autorisés. Warig : cet idicateur s'affiche lorsque le ombre de processus est à 80% de la limite autorisée. Alert : cet idicateur s'affiche lorsque le ombre de processus est à 90% de la limite autorisée. File Hadles : iformatios relatives aux descripteurs de fichier, soit le ombre de fichiers ouverts par processus. Curret value : ombre actuel de descripteurs de fichiers. Max Value : ombre maximal de descripteurs de fichiers autorisé par le système d'exploitatio. Warig : cet idicateur s'affiche lorsque le ombre de descripteurs de fichiers autorisé atteit le seuil de 80%. Alert : cet idicateur s'affiche lorsque le ombre de descripteurs de fichiers autorisé atteit le seuil de 90%. Processes : iformatios relatives aux processus de la machie. Curret value : ombre de processus actuellemet e cours. Max Value : ombre maximal de processus autorisés. Active Processes: ombre de processus actifs. Iactive Processes : ombre de processus iactifs. Warig : cet idicateur s'affiche lorsque le ombre de processus autorisé atteit le seuil de 80% de la valeur maximale autorisée. Alert : cet idicateur s'affiche lorsque le ombre de processus autorisé atteit le seuil de 90% de la valeur maximale autorisée. Neolae v6.0 - Guide d'exploitatio - Procédures d'exploitatio 19

21 Neolae Zombie Processes : iformatios relatives aux processus qui se sot arrêtés, mais qui disposet toujours d'u idetifiat de processus (PID) et restet visibles das la table des processus. Curret value : ombre de processus zombie actuellemet e cours. Max Value : ombre maximal de processus zombie autorisés (2). Warig : cet idicateur s'affiche lorsque le ombre de processus zombie s'approche de 2. Alert : cet idicateur s'affiche lorsque le ombre de processus zombie atteit 2. Paramétrage de la page Le coteu et l'aspect de cette page est cofiguré das le tableau de bord Exploitatio de l'istace, accessible das l'arborescece au iveau du oeud Admiistratio>Gestio des accès>tableaux de bord. Reportez-vous au Guide de cofiguratio pour plus d'iformatios sur le paramétrage des tableaux de bord. Surveillace automatique Neolae propose plusieurs techiques de moitorig automatique. Elles sot présetées ci-dessous. La lige de commade La commade lserver moitor permet de lister u esemble d'idicateurs sur le système et les modules Neolae. Elle géère ue sortie au format XML qui peut être traitée facilemet. De plus, cette commade peut être lacée avec le paramètre -missig qui liste les processus maquats sur cette istace alors que, selo les fichiers de cofiguratio, ils devraiet se trouver e cours d'exécutio. lserver moitor -missig 10:17:59 > Serveur applicatif pour Neolae Versio (build 6749) du 26/07/2011 mta@prod stat@prod wfserver@prod 20 Neolae 2013

22 Procédures d'exploitatio Les iformatios publiées par le serveur Le /r/test La page http(s)://<url du serveur d'applicatio>/r/test permet de tester le serveur de redirectio. Nous vous recommados de tester les serveurs frotaux qui servet au trackig de la même maière. Cette page peut égalemet être utilisée pour tester u répartiteur de charge. Elle affiche ue lige au format XML du type : <redir status='ok' date=' :18:11.112Z' build='6743' host='traiig.eolae.et' localhost='serverame'/> Fréquece : il s'agit d'u test e sollicitat pas de charge, il peut doc être lacé très régulièremet (toutes les secodes, par exemple). Le /l/jsp/pig.jsp Cette page http(s)://<url du serveur d'applicatio>/l/jsp/pig.jsp foctioe selo le même mode que so homologue réseau : il teste ue requête complète passat par apache/tomcat/module web/base de doées et la remotée jusqu'au cliet. Et si tout foctioe correctemet, il revoie OK. Nous vous recommados de lacer ce test sur les machies qui accèdet aux bases de doées (par exemple les mta et les questioaires). Utilisatio : il faut mettre e argumet u toke de sessio associé au logi d'u opérateur qui permet de se coecter à l'istace (voir l'astuce das la sectio Surveillace automatique via les scripts de Neolae [page 24]). Par exemple : Neolae v6.0 - Guide d'exploitatio - Procédures d'exploitatio 21

23 Neolae L'opérateur et so logi doivet avoir été préalablemet cofigurés das la cosole cliete Neolae avec les droits sur les doées de la base. Fréquece : il s'agit d'u test sollicitat peu de charge, il peut doc être lacé assez souvet (toutes les dix secodes par exemple). 22 Neolae 2013

24 Procédures d'exploitatio Le /l/jsp/moitor.jsp Il s'agit d'u test permettat de vérifier qu'u opérateur peut accéder au serveur Neolae via ue page web. Cette page web est la même que celle accessible depuis les meus de la cosole cliete. Nous vous recommados de l'itégrer à vos outils de surveillace (Tivoli, Nagios, etc.). Utilisatio : il faut mettre e argumet u toke de sessio associé au logi d'u opérateur qui permet de se coecter à l'istace (voir l'astuce das la sectio Surveillace automatique via les scripts de Neolae [page 24]). L'opérateur et so logi doivet avoir été préalablemet cofigurés das la cosole cliete Neolae avec les droits et les restrictios sur les doées de la base. Fréquece : il s'agit d'u test complet de tout le serveur, il 'a pas à être lacé fréquemmet (o peut l'effectuer par exemple toutes les dix miutes). Le /l/jsp/soaprouter.jsp Ce jsp représete le poit d'etrée des API de l'applicatio Neolae. Il peut doc servir de moitorig fi de l'applicatio. Il peut égalemet être utilisé pour surveiller les services web Neolae. Il est utilisé das os scripts de surveillace, éamois, il est réservé à des utilisateurs experts. Surveillace selo les types de déploiemets Neolae permet différetes cofiguratios de déploiemet (voir la sectio Types de déploiemets à ce sujet). Das cette sectio, sot détaillées les différetes techiques de moitorig automatique à appliquer selo le type d'istallatio dot vous disposez. Type de déploiemet Moitorig Stad-aloe Stadard Etreprise /r/test et /l/jsp/moitor.jsp sur le serveur Neolae /r/test et /l/jsp/pig.jsp sur les serveurs frotaux /l/jsp/moitor.jsp sur le serveur applicatif /r/test et /l/jsp/pig.jsp sur les serveurs frotaux /r/test et /l/jsp/moitor.jsp sur le serveur applicatif Neolae v6.0 - Guide d'exploitatio - Procédures d'exploitatio 23

25 Neolae Type de déploiemet Moitorig Mid-sourcig /l/jsp/moitor.jsp sur le serveur applicatif Surveillace automatique via les scripts de Neolae Elémets requis Pour ue surveillace automatique, les précautios suivates sot requises avat istallatio : vous devez avoir les fichiers etreport.tgz (istallatio sous Liux) ou etreport.zip (istallatio sous Widows), il est fortemet coseillé de e pas istaller le moitorig sur la machie à surveiller, il est idispesable que la machie sur laquelle il sera istallé possède u JRE ou u JDK, sous Liux, la machie que l'o souhaite moitorer doit posséder le package bc. Procédure d'istallatio La procédure d'istallatio est la suivate : 1 Das la cosole, créez, si besoi, u ouvel opérateur (l'utilisateur 'moitorig' existe déjà), sas lui attribuer de droits. 2 Lacez l'extractio de l'archive. 3 Cosultez le fichier readme. 4 Mettez à jour le fichier de cofiguratio etcof.xml. 5 Mettez à jour le fichier etreport.bat (Widows) ou etreport.sh (Liux). Cofiguratio du fichier etcof.xml Le fichier XML de cofiguratio cotiet les élémets suivats : Elémet 'properties' [page 24], Elémet 'host' [page 24], Les sous-élémets [page 25]. Elémet 'properties' Cet élémet permet de reseiger le paramétrage des mails, soit : mailserver : serveur SMTP utilisé pour evoyer les mails (ex : smtp.domaie.et). mailfrom : adresse de l'expéditeur du rapport (ex: <[email protected]>). recipietlist : la liste des s des destiataires du moitorig. Les s doivet être séparés les us des autres par ue virgule, sas espace. Le mode 'ight' permet de e pas evoyer d' s pedat la trache horaire reseigée, mais de cosolider les iformatios et d'evoyer automatiquemet, à partir de l'heure de fi (par défaut 7:00), u sur l'activité de la uit. Note : L'attribut persisthtmlfile avec la valeur "true" sur l'élémet <property> permet d'eregistrer le derier état du moitorig das le fichier etreport.html. Ce fichier est eregistré das le répertoire d'istallatio. Elémet 'host' Cet élémet paramètre la surveillace sur l'host d'u serveur doé, soit : host ame : om de la machie à surveiller. alias (optioel) : om sous lequel apparaîtra la machie surveillée das le rapport. sessiotoke : permet de s'authetifier sous la forme d'u toke de sessio autorisé. Pour paramétrer le toke de sessio, sélectioez l'opérateur moitorig das la cosole Neolae. Das l'oglet Droit d'accès, idiquez les adresses IP des machies autorisées à surveiller cette istace. Depuis 24 Neolae 2013

26 Procédures d'exploitatio ces machies, vous pourrez alors vous coecter à la page de moitorig avec l'idetifiat moitorig sas avoir besoi de spécifier de mot de passe. Les sous-élémets tcp port : vérifie si le serveur est 'up' ou 'dow'. Vous devez saisir u uméro de port. http : vérifie l'existece du serveur Web (bo foctioemet du serveur applicatif). cs : vérifie les processus sur l'istace reseigée das l'attribut 'istace' (cosommatio mémoire, etc.). redir : vérifie le trackig. Das la plupart des cas, o peut e coserver que les sous-élémets cs et redir. Das tous les cas, o peut surcharger certais oeuds das les sous-élémets (par exemple le oeud port=75 pour surcharger le port utilisé pour la coexio http). Cofiguratio du fichier etreport.bat ou etreport.sh Pour le cofigurer, éditez ce fichier et idiquez le répertoire das lequel a été istallé la JRE ou le JDK. Lacemet du moitorig Pour lacer la surveillace, exécutez le fichier etreport.bat ou etreport.sh à itervalles réguliers, via u script. U rapport est evoyé à la première exécutio, puis seulemet e cas de chagemet d'état. Test du moitorig Pour tester la surveillace, exécutez le fichier etreport.bat ou etreport.sh. U est evoyé aux destiataires spécifiés das le recipietlist du fichier etcof.xml. Commades usuelles Cette sectio propose la liste des commades usuelles sous Neolae. Neolae v6.0 - Guide d'exploitatio - Procédures d'exploitatio 25

27 Neolae La commade lserver est la commade d'etrée de l'esemble de l'applicatif Neolae. La sytaxe de cette commade est la suivate : lserver <commade> <argumets> Le paramètre <commade> correspod au module. Note : Vous pouvez das tous les cas adjoidre l'argumet -ocosole afi de supprimer les commetaires affichés après le lacemet des modules. A cotrario, vous pouvez adjoidre l'argumet -verbose pour afficher plus d'iformatios. Commades de moitorig Note : Pour lister l'esemble des modules, vous devez utiliser la commade : lserver pdump Vous pouvez lui adjoidre le paramètre -who permettat de lister les coexios e cours (base de doées et applicatif). lserver pdump -who 11:00:39 > Serveur applicatif pour Neolae Versio (build 6749) du 26/07/2011 web@default (9984) Mo watchdog (2273) Mo syslogd@default (9931) Mo trackiglogd@default (9985) Mo mta@test (9986) Mo wfserver@test (9987) Mo Coexios Last Access IP Istace Logi 21/07/ :00: default formatio_fr trackig 26/07/ :07: default iteral moitorig Coexio pool Datasource Server Provider Logi default xxxxx myserver myprovider test400 Ue autre commade utile est la commade lserver moitor. Elle permet de lister le fichier XML de moitorig (obteu das le cliet Neolae ou par la page web moitor.jsp). Vous pouvez lui adjoidre le paramètre -missig pour lister les modules absets (erreur das ces modules, arrêt des modules, etc.) lserver moitor -missig 11:00:39 > Serveur applicatif pour Neolae Versio (build 6749) du 26/07/2011 imail@test mta@test wfserver@test Cela correspod aux modules ayat u démarrage automatique mais qui e sot pas lacés. Commades de lacemet des modules La sytaxe pour lacer les modules sera toujours de la forme : lserver start <ommodule>@<instance> lserver stop <ommodule>@<instance> Note : <INSTANCE> correspod au om d'istace, tel que reseigé das les fichiers de cofiguratio, ou default pour les modules moo-istace. 26 Neolae 2013

28 Procédures d'exploitatio Arrêter les services Pour arrêter les services Neolae, vous pouvez utiliser ue des commades suivates : Si vous avez u accès root ou admiistrateur : Sous Liux : /etc/iit.d/lserver6 stop Sous Widows : et stop lserver6 Sio, das le compte Neolae : lserver shutdow Redémarrer les services De même, afi de démarrer Neolae vous pouvez utiliser ue des commades suivates : Si vous avez u accès root ou admiistrateur : Sous Liux : /etc/iit.d/lserver6 start Sous Widows : et start lserver6 Sio, das le compte Neolae : lserver watchdog -svc -ocosole La commade cofig La commade cofig permet de gérer la cofiguratio du serveur, otammet de re-paramétrer la coexio à la base de doées. Nous utilisos la commade cofig de l'exécutable lserver avec le paramètre -setdblogi. lserver cofig -setdblogi:<[sgbd:]compte[:base][/motdepasse]@serveur> lserver cofig -setdblogi:postgresql:eolae:test6@dbserver Vous devez saisir le mot de passe. Pour chager le mot de passe iteral : lserver cofig -iteralpassword Note : D'ue maière géérale, au lieu de modifier les fichiers de cofiguratio à la mai, vous pouvez utiliser la commade cofig. Pour obteir la liste des paramètres, utiliser le paramètre -? : lserver cofig -? Das le cas d'ue base Oracle, il e faut pas préciser le compte. La sytaxe sera doc la suivate : lserver cofig -setdblogi:oracle:test6@dbserver Neolae v6.0 - Guide d'exploitatio - Procédures d'exploitatio 27

29 Neolae 28 Neolae v6.0 - Guide d'exploitatio

30 CHAPITRE 3 Traitemet des doées Table des matières La sauvegarde Les fichiers physiques La base de doées La restauratio La duplicatio d'eviroemets Itroductio Mise e oeuvre Descriptio du workflow Nettoyage de la base Itroductio Paramétrage Tâches effectuées par le workflow Nettoyage de la base La sauvegarde La sauvegarde est ue opératio primordiale afi de e pas perdre de doées e cas de problème (physique ou système) sur ue machie. Les doées sot stockées das deux edroits disticts : des fichiers physiques sot stockés das les répertoires de Neolae, les autres doées sot stockées das la base de doées. La grade majorité des doées se trouve das la base. Elle représete 99% de l'espace des doées sauvegardées. Les fichiers physiques Ces fichiers sot répartis e plusieurs catégories : Les fichiers de cofiguratio situés das l6/cof Ils permettet de reparamétrer Neolae très rapidemet. Les fichiers de redirectio l6/var/<omistace>/redir Ils se trouvet sur les serveurs de trackig (commuémet appelés "frotaux") et cotieet l'esemble des redirectios des campages effectuées. Ils sot toujours utilisés par les aciees campages. Les fichiers de logs : l6/var/<omistace>/log Ils peuvet être utilisés afi de tracer des problèmes. Les fichiers de cofiguratio des purl (Neolae Microsites) : l6/var/<omistace>/relay Neolae v6.0 - Guide d'exploitatio - Traitemet des doées 29

31 Neolae Idispesables au bo foctioemet des microsites, ces fichiers défiisset la maière dot sot relayées les purl vers les applicatios web. IMPORTANT : Les répertoires à sauvegarder sot doc : l6/cof l6/var/<omistace>/redir (pour chaque istace) l6/var/<omistace>/log (optioel) l6/var/<omistace>/relay (optioel) La base de doées La base de doées cotiet toutes les iformatios affichées das la cosole cliete riche Neolae, aisi que toutes les doées métiers. Avertissemet : La sauvegarde de la base de doées est impérative. Cette opératio est à la charge de votre hébergeur, et plus particulièremet de leurs admiistrateurs de bases de doées. La restauratio La procédure de restauratio sur u serveur vierge est la suivate : sur u système d'exploitatio istallé et paramétré (Réseaux), istallatio des applicatios tierces : serveur WEB, JDK (si écessaire), istallatio des biaires Neolae du même build que le système source, copie des fichiers de cofiguratio, des logs de trackig aisi que des fichiers de redirectio, créatio et remotage de la base de doées, lacemet de Neolae. Note : Pour plus d'iformatios, reportez-vous au Guide d'istallatio. La duplicatio d'eviroemets Itroductio Présetatio L'utilisatio de Neolae requiert l'istallatio et le paramétrage d'u ou plusieurs eviroemets : développemet, test, pré-productio, recette, productio, etc. Chaque eviroemet cotiet ue istace Neolae et chaque istace Neolae est liée à ue ou plusieurs bases de doées. Le serveur applicatif peut exécuter u ou plusieurs processus : la quasi totalité de ces processus accèdet directemet à la base de doées de l'istace. Cette sectio présete les procédures à appliquer pour dupliquer u eviroemet Neolae, c'est-à-dire pour restaurer u eviroemet-source das u eviroemet-cible, et aisi disposer de deux eviroemets de travail idetiques. Les étapes sot les suivates : 1 Créer ue copie des bases de doées de toutes les istaces de l'eviroemet-source, 30 Neolae 2013

32 Traitemet des doées 2 Restaurer ces copies sur toutes les istaces de l'eviroemet-cible, 3 Exécutez le script de cautérisatio ms:freezeistace.js sur l'eviroemet-cible avat sa mise e route. Les serveurs et leur cofiguratio e sot pas impactés par cette procédure. Note : Das Neolae, ue cautérisatio regroupe les actios qui permettet l'arrêt des processus qui iteragisset avec l'extérieur : logs, trackig, diffusios, workflows de campages, etc. Cette étape est écessaire afi de e pas diffuser des messages plusieurs fois (ue fois depuis l'eviroemet omial, ue fois depuis l'eviroemet dupliqué). Avertissemet : U eviroemet peut coteir plusieurs istaces. Chaque istace Neolae est sujette à u cotrat de licece. Le ombre d'eviroemets autorisés est metioé das votre cotrat de licece. La procédure proposée ci-après vous permet de trasférer u eviroemet sas pour autat impacter le ombre d'eviroemets et d'istaces istallées. Avat de commecer Avertissemet : Il est vivemet recommadé de réaliser des sauvegardes complètes des bases de doées de toutes les istaces des eviroemets-source et cible avat toute maipulatio. E cas de problème, vous pourrez aisi restaurer ces sauvegardes et retrouver la cofiguratio iitiale. Afi de mettre e oeuvre la procédure décrite ci-dessous, l'eviroemet-source et l'eviroemet-cible doivet disposer du même ombre d'istaces. Elles doivet avoir la même fialité (istace marketig, de diffusios) et ue cofiguratio similaire. La cofiguratio techique doit correspodre aux pré-requis logiciels. Les mêmes composats doivet être istallés das les deux eviroemets. Mise e oeuvre Procédure de trasfert Nous vous proposos ici de compredre les étapes de trasfert d'u eviroemet-source vers u eviroemet-cible à travers u cas pratique : l'objectif est de restaurer u eviroemet de productio (istace prod) das u eviroemet de développemet (istace recette) afi de travailler das u cotexte qui soit le plus proche possible de la plateforme 'live'. Les étapes ci-dessous doivet être réalisées avec précautio : certais processus peuvet être e cours lors de la copie des bases de doées de l'eviroemet-source. La procédure de cautérisatio (Etape 3 ci-après) permet de e pas diffuser les messages plusieurs fois aux mêmes destiataires et de coserver la cohérece des doées. Avertissemet : La procédure ci-dessous est valide e lagage PostgreSQL, si le lagage SQL est différet (Oracle, MySQL, etc.), les requêtes SQL doivet être adaptées. Das les exemples de commades proposés ci-après, o cosidère ue istace prod et ue istace recette existates sous PostgreSQL. Etape 1 - Sauvegarder les doées de l'eviroemet-source (prod) Copier les bases de doées Vous devez au préalable copier toutes les bases de doées de l'eviroemet-source. Le mode de réalisatio de cette opératio déped du moteur de la base de doées et est sous la resposabilité de l'admiistrateur des bases de doées. Sous PostgreSQL, la commade est la suivate : Neolae v6.0 - Guide d'exploitatio - Traitemet des doées 31

33 Neolae pg_dump mabase > mabase.sql Etape 2 - Exporter la cofiguratio de l'eviroemet cible (recette) La plupart des élémets de cofiguratio diffèret d'u eviroemet à l'autre : comptes exteres (mid-sourcig, routig, etc.), optios techiques (om de la plateforme, DatabaseId, adresses et URL par défaut, etc.). Avat de restaurer la base source sur la base cible, vous devez exporter la cofiguratio de l'eviroemet cible (recette). Vous devez exporter le coteu des deux tables suivates : xtk:optio et ms:extaccout. Cet export permet de coserver la cofiguratio de la recette et de e rafraîchir que les doées de la recette (workflows, modèles, applicatios Web, detiataires, etc.). Pour cela, effectuez u export de package pour les deux élémets suivats : Das u fichier 'optios_recette.xml', exporter la table xtk:optio, sas les eregistremets avec les oms iteres suivats : 'WdbcTimeZoe', 'NmsServer_LastPostUpgrade' et 'NmsBroadcast_RegexRules'. Das u fichier 'extaccout_recette.xml', exporter la table ms:extaccout pour tous les eregistremets dot l'id est différet de 0 (@id <> 0). Vérifiez das chaque fichier que le ombre d'optios/de comptes exportés est égal au ombre de liges à exporter. Note : Le ombre de liges à exporter das u export de package est de 1000 liges. Si le ombre d'optios ou de comptes exteres est supérieur à 1000, il faut procéder à plusieurs exports. Pour plus d'iformatios, cosultez la sectio Export de packages. Etape 3 - Arrêter l'eviroemet cible (recette) Vous devez arrêter les processus Neolae sur tous les serveurs de l'eviroemet-cible. Le mode de réalisatio de cette opératio déped de votre système d'exploitatio. Vous pouvez arrêter tous les processus ou seulemet ceux qui écrivet das la base de doées. Pour arrêter tous les processus, les commades sot les suivates : Sous Widows : et stop lserver6 Sous Liux : /etc/iit.d/lserver6 stop Vérifiez que tous les processus sot bie arrêtés via la commade suivate : lserver pdump Note : Sous Widows, le processus webmdl peut être ecore actif sas impacter le reste des opératios. Vous pouvez égalemet vérifier qu'aucu processus système e subsiste. Pour cela : Sous Widows : ouvrez le Gestioaire des tâches et vérifiez l'absece de tout processus lserver.exe. Sous Liux : exécutez la commade ps aux grep lserver et vérifiez l'absece de tout processus lserver. Etape 4 - Restaurer les bases de doées das l'eviroemet-cible (recette) Pour restaurer les bases de doées-sources das l'eviroemet-cible, la commade est la suivate : psql mabase < mabase.sql Etape 5 - Cautériser l'eviroemet-cible (recette) Afi d'éviter tout dysfoctioemet, les processus relatifs à l'evoi des diffusios et à l'exécutio des workflows e doivet pas s'exécuter automatiquemet au momet de l'activatio de l'eviroemet-cible. 32 Neolae 2013

34 Traitemet des doées Pour cela, exécutez la commade suivate : lserver javascript ms:freezeistace.js -istace:<recette> -arg:ru Etape 6 - Vérifier la cautérisatio 1 Vérifier que le seul deliverypart est celui dot l'id est égal à 0 : SELECT * FROM eolae.msdeliverypart; 2 Vérifier que la mise à jour des statuts des diffusios est correcte : SELECT istate, cout(*) FROM eolae.msdelivery GROUP BY istate; 3 Vérifier que la mise à jour des status des workflows est correcte : SELECT istate, cout(*) FROM eolae.xtkworkflow GROUP BY istate; SELECT istatus, cout(*) FROM eolae.xtkworkflow GROUP BY istatus; Etape 7 - Redémarrer le processus Web de l'eviroemet-cible (recette) Sur l'eviroemet-cible, redémarrez les processus Neolae sur tous les serveurs. Note : Avat de redémarrer Neolae sur l'eviroemet recette, il est possible d'appliquer ue procédure de sécurité supplémetaire : e démarrer que le module web. Pour cela, éditez le fichier cofiguratio de votre istace (cofig-recette.xml) puis ajoutez le caractère "_" devat les optios autostart="true" pour chaque module (mta, stat, etc.). Exécuter la commade suivat afi de démarrer le processus web : lserver start web Vérifier que seul le processus web est démarré à l'aide de la commade suivate : lserver pdump Vérifer visuellemet que l'accès à la cosole cliet foctioe. Etape 8 - Importer les optios et les comptes exteres das l'eviroemet-cible (recette) Avertissemet : Attetio : seul le processus web doit être démarré à cette étape. Si ce 'est pas le cas, arrêtez les autres processus e cours avat de poursuivre. Vérifier avat toutes choses les valeurs de plusieurs liges des fichiers avat l'import (par exemple : 'NmsTrackig_Poiter' pour la table des optios et les comptes d'evoi ou de mid-sourcig pour la table des comptes exteres). Pour importer la cofiguratio de la base de doées de l'eviroemet-cible (recette) : 1 Ouvrir la cosole d'admiistratio de la base de doées et purger les comptes exteres (table ms:extaccout) dot l'id est différet de 0 (@id <> 0). 2 Au iveau de la cosole Neolae, importer le package optios_recette.xml précédemmet créé via la foctioalité d'import de package. Vérifier que les optios ot bie été mises à jour das le oeud Admiistratio > Plate-forme > Optios. 3 Au iveau de la cosole Neolae, importer le package extaccout_recette.xml précédemmet créé via la foctioalité d'import de package. Vérifier que les comptes exteres ot bie été importés das le oeud Admiistratio > Plate-forme > Comptes exteres. Neolae v6.0 - Guide d'exploitatio - Traitemet des doées 33

35 Neolae Etape 9 - Redémarrer l'esemble des processus et chager les utilisateurs (recette) Pour démarrer les processus Neolae, les commades sot les suivates : Sous Widows : et start lserver6 Sous Liux : /etc/iit.d/lserver6 start Vérifier que les processus sot bie démarrés via la commade suivate : lserver pdump Chager les utilisateurs pour retrouver les utilisateurs qui existaiet auparavat sur la plate-forme de recette. Descriptio du workflow Nettoyage de la base Itroductio Le workflow Nettoyage de la base (cleaup), accessible à partir du oeud Admiistratio > Exploitatio > Workflows techiques, permet de supprimer les doées obsolètes afi d'éviter ue croissace expoetielle de la base. Le workflow se décleche de maière automatique sas itervetio de l'utilisateur. Paramétrage Le paramétrage du ettoyage de la base s'effectue à deux iveaux : das le plaificateur du workflow et das l'assistat de déploiemet. 34 Neolae 2013

36 Traitemet des doées Le plaificateur Note : Pour plus d'iformatios sur le plaificateur, cosultez la sectio correspodate das le guide Workflows. Par défaut, le workflow Nettoyage de la base est paramétré pour se déclecher tous les jours, à 4 heures du mati. Le plaificateur vous permet de modifier la fréquece de déclechemet du workflow. Les fréqueces dispoibles sot les suivates : Plusieurs fois par jour Quotidie Hebdomadaire Ue seule fois Avertissemet : Pour que le workflow Nettoyage de la base puisse se lacer à la date et heure défiies das le plaificateur, le moteur de workflow (wfserver) doit être démarré. Si ce 'est pas le cas, le ettoyage de la base se déclechera au prochai démarrage du moteur de workflow. Neolae v6.0 - Guide d'exploitatio - Traitemet des doées 35

37 Neolae L'assistat de déploiemet L'Assistat de déploiemet, accessible à partir du meu Outils > Avacé, vous permet de paramétrer la durée pedat laquelle certaies doées sot coservées. Les valeurs sot exprimées e jours. Si ces valeurs e sot pas modifiées, le workflow utilisera les valeurs par défaut. Les champs de la feêtre Purge des doées correspodet aux optios suivates. Ces optios sot utilisées par certaies des tâches exécutées par le workflow Nettoyage de la base : Trackig cosolidé : NmsCleaup_TrackigStatPurgeDelay (voir Nettoyage des logs de trackig [page 41]) Logs de diffusio : NmsCleaup_BroadLogPurgeDelay (voir Nettoyage des logs de diffusio [page 42]) Logs de trackig : NmsCleaup_TrackigLogPurgeDelay (voir Nettoyage des logs de trackig [page 41]) Diffusios supprimées : NmsCleaup_RecycledDeliveryPurgeDelay (voir Nettoyage des diffusios à supprimer ou à recycler [page 37]) Rejets d'import : NmsCleaup_RejectsPurgeDelay (voir Nettoyage des rejets géérés par les imports [page 40]) Profils des visiteurs : NmsCleaup_VisitorPurgeDelay (voir Nettoyage des visiteurs [page 41]) Propositios d'offres : NmsCleaup_PropositioPurgeDelay (voir Nettoyage des propositios [page 43]) Note : Le champ Propositios d'offres est uiquemet dispoible si le module Iteractio est istallé. Evéemets : NmsCleaup_EvetPurgeDelay (voir Nettoyage des évéemets ayat expiré [page 44]) Evéemets historisés : NmsCleaup_EvetHistoPurgeDelay (voir Nettoyage des évéemets ayat expiré [page 44]) Note : Les champs Evéemets et Evéemets historisés sot uiquemet dispoibles si le module Message Ceter est istallé. L'esemble des tâches exécutées par le workflow Nettoyage de la base sot décrites das la sectio qui suit. 36 Neolae 2013

38 Traitemet des doées Tâches effectuées par le workflow Nettoyage de la base A la date et heure défiies das le plaificateur du workflow (voir Le plaificateur [page 35], le moteur de workflow lace le processus de ettoyage de la base. Ce derier se coecte à la base de doées, puis exécute successivemet les tâches, das l'ordre préseté ci-dessous. Avertissemet : Si l'ue de ces tâches échoue, les tâches suivates e serot pas exécutées. Note : Les requêtes SQL comportat u attribut LIMIT sot exécutées de faço répétée jusqu'à ce que toutes les iformatios aiet été traitées. Nettoyage des groupes à supprimer La première tâche exécutée par le workflow Nettoyage de la base supprime de la table NmsGroup tous les groupes ayat pour attribut deletestatus!= 0. Les eregistremets liés à ces groupes et qui existet das d'autres tables sot égalemet supprimés. 1 La liste des groupes à supprimer est récupérée à l'aide de la requête SQL suivate : SELECT igroupid, slabel, itype FROM NmsGroup WHERE ideletestatus <> 0 ORDER BY tslastmodified; 2 Chaque groupe possède plusieurs lies vers d'autres tables. Tous ces lies sot supprimés e masse à l'aide de la requête suivate : DELETE FROM $(relatedtable) WHERE igroupid=$(l) IN (SELECT igroupid FROM $(relatedtable) WHERE igroupid=$(l) LIMIT 5000) où $(relatedtable) est ue table liée à NmsGroup et $(l) est l'idetifiat du groupe. 3 Lorsque le groupe est de type liste, la table associée est supprimée à l'aide de la requête suivate : DROP TABLE grp$(l) 4 Chaque groupe récupéré par l'opératio de type Select est supprimé à l'aide de la requête suivate : DELETE FROM NmsGroup WHERE igroupid=$(l) où $(l) est l'idetifiat du groupe. Nettoyage des diffusios à supprimer ou à recycler Cette tâche purge toutes les diffusios à supprimer ou à recycler. 1 Le workflow Nettoyage de la base sélectioe les diffusios pour lesquelles le champ deletestatus a pour valeur Oui ou Recyclé et dot la date de suppressio est atérieure à la période défiie das le champ Diffusios supprimées (NmsCleaup_RecycledDeliveryPurgeDelay) de l'assistat de déploiemet. Voir à ce sujet L'assistat de déploiemet [page 36]. Cette période est calculée par rapport à la date courate du serveur. 2 La tâche sélectioe esuite, pour chaque serveur de mid-sourcig, la liste des diffusios à supprimer. 3 Le workflow Nettoyage de la base supprime les logs de diffusio, les pièces joites, les iformatios de pages miroir et toute autre doée associée. 4 Avat la suppressio défiitive de la diffusio, le workflow purge les iformatios associées das les tables suivates : Das la table des exclusios de diffusio (NmsDlvExclusio), la requête suivate est utilisée : DELETE FROM NmsDlvExclusio WHERE ideliveryid=$(l) où $(l) est l'idetifiat de la diffusio. Das la table des coupos (NmsCoupoValue), la requête suivate est utilisée (avec des suppressios e masse) : Neolae v6.0 - Guide d'exploitatio - Traitemet des doées 37

39 Neolae DELETE FROM NmsCoupoValue WHERE imessageid IN (SELECT imessageid FROM NmsCoupoValue WHERE EXISTS (SELECT B.iBroadLogId FROM $(BroadLogTableName) B WHERE B.iDeliveryId = $(l) AND B.iBroadLogId = imessageid ) LIMIT 5000) où $(l) est l'idetifiat de la diffusio. Das les tables de logs de diffusio (NmsBroadlogXxx), des suppressios e masse sot exécutées, par groupes de eregistremets. Das les tables de propositios d'offres (NmsPropositioXxx), des suppressios e masse sot exécutées, par groupes de eregistremets. Das les tables de logs de trackig (NmsTrackiglogXxx), des suppressios e masse sot exécutées, par groupes de 5000 eregistremets. Das la table des fragmets de diffusio (NmsDeliveryPart), des suppressios e masse sot exécutées, par groupes de 5000 eregistremets. Cette table cotiet les iformatios de persoalisatio des messages restat à evoyer. Das la table des fragmets de doées de page miroir (NmsMirrorPageIfo), des suppressios e masse sot exécutées, par groupes de 5000 eregistremets. Cette table cotiet les iformatios de persoalisatio de tous les messages qui sot utilisées pour la géératio des pages miroir. Das la table de recherche des pages miroir (NmsMirrorPageSearch), des suppressios e masse sot exécutées, par groupes de 5000 eregistremets. Cette table est u idex de recherche permettat d'accélérer l'accès aux iformatios de persoalisatio stockées das la table NmsMirrorPageIfo. Das la table des logs de traitemets batch (XtkJobLog), des suppressios e masse sot exécutées, par groupes de 5000 eregistremets. Cette table cotiet le joural des diffusios à supprimer. Das la table de trackig des URL d'ue diffusio (NmsTrackigUrl), la requête suivate est utilisée : DELETE FROM NmsTrackigUrl WHERE ideliveryid=$(l) où $(l) est l'idetifiat de la diffusio. Cette table cotiet les URL présetes das les diffusios à supprimer afi de permettre leur trackig. 5 La diffusio est esuite supprimée de la table des diffusios (NmsDelivery) : DELETE FROM NmsDelivery WHERE ideliveryid = $(l) où $(l) est l'idetifiat de la diffusio. Diffusios utilisat le mid-sourcig Le workflow Nettoyage de la base supprime égalemet les diffusios sur le(s) serveur(s) de mid-sourcig. 1 Pour cela, le workflow vérifie que chaque diffusio est iactive (e se basat sur so état). Si ue diffusio est active, elle sera iterrompue avat d'être supprimée. La vérificatio est effectuée e exécutat la requête suivate : SELECT istate FROM NmsDelivery WHERE ideliveryid = $(l) AND istate <> 100; où $(l) est l'idetifiat de la diffusio. 2 Si l'état a pour valeur Démarrage e attete, E cours, Reprise e attete, Reprise e cours, Pause demadée, Pause e cours, ou E pause (valeurs 51, 55, 61, 62, 71, 72, 75), la diffusio est alors stoppée et la tâche procède à la purge des iformatios associées. Nettoyage des diffusios ayat expiré Cette tâche iterrompt les diffusios dot la période de validité a expiré. 1 Le workflow Nettoyage de la base crée la liste des diffusios ayat expiré. Cette liste iclut toutes les diffusios ayat expiré dot l'état est différet de Termié, aisi que les diffusios récemmet arrêtées avec plus de messages o traités. La requête suivate est utilisée : SELECT ideliveryid, istate FROM NmsDelivery WHERE ideletestatus=0 AND iismodel=0 AND ideliverymode=1 AND ( (istate >= 51 AND istate < 85 AND tsvalidity IS NOT NULL AND tsvalidity < $(curretdate) ) OR (istate = 85 AND DateMiusDays(15) < tslastmodified AND itodeliver - iprocessed >= )) où delivery mode 1 correspod au mode Evoi e masse, state 51 correspod à l'état Démarrage e attete, state 85 correspod à l'état Stoppé, et le ombre maximum de logs de diffusio mis à jour e masse sur le serveur de diffusio est de Neolae 2013

40 Traitemet des doées 2 Le workflow iclut esuite la liste des diffusios qui ot récemmet expiré et qui utiliset le mid-sourcig. Les diffusios pour lesquelles les logs de diffusio 'ot pas ecore été récupérés depuis serveur de mid-sourcig e sot pas icluses. La requête utilisée est la suivate : SELECT ideliveryid, tsvalidity, imidremoteid, mdata FROM NmsDelivery WHERE (ideliverymode = 4 AND (istate = 85 OR istate = 95) AND tsvalidity IS NOT NULL AND (tsvalidity < SubDays(GetDate(), 15) OR tsvalidity < $(DateDeDeriereRemoteDesLogs)) AND tslastmodified > SubDays(GetDate(), 15)) 3 La requête suivate est utilisée pour détecter si le compte extere est toujours actif, afi de pouvoir filtrer les diffusios selo la date : SELECT iextaccoutid FROM NmsExtAccout WHERE iactive<>0 AND sname=$(providername) 4 Das la liste de diffusios ayat expiré, les logs de diffusio dot le statut est E attete passet au statut Evoi aulé, et toutes les diffusios de cette liste passet au statut Termié. Les requêtes utilisées sot les suivates : UPDATE $(BroadLogTableName) SET tslastmodified=$(curdate), istatus=7, imsgid=$(bl) WHERE ideliveryid=$(dl) AND istatus=6 où $(curdate) est la date courate du serveur de la base de doées, $(bl) est l'idetifiat du message des logs de diffusio, $(dl) est l'idetifiat de la diffusio, delivery status 6 correspod au statut E attete, et delivery status 7 au statut Evoi aulé. UPDATE NmsDelivery SET istate = 95, tslastmodified = $(curdate), tsbroaded = tsvalidity WHERE ideliveryid = $(dl) où delivery state 95 correspod à l'état Termié, et $(dl) est l'idetifiat de la diffusio. 5 Tous les fragmets (deliveryparts) des diffusios obsolètes sot supprimés et tous les fragmets obsolètes des diffusios de otificatio toujours e cours sot supprimés. Ue suppressio e masse est utilisée pour ces deux tâches. Les requêtes utilisées sot les suivates : DELETE FROM NmsDeliveryPart WHERE ideliverypartid IN (SELECT ideliverypartid FROM NmsDeliveryPart WHERE ideliveryid IN (SELECT ideliveryid FROM NmsDelivery WHERE istate=95 OR istate=85) LIMIT 5000) DELETE FROM NmsDeliveryPart WHERE ideliverypartid IN (SELECT ideliverypartid FROM NmsDeliveryPart WHERE tsvalidity < $(curdate) LIMIT ) où delivery state 95 correspod à l'état Termié, delivery state 85 à l'état Stoppé, et $(curdate) est la date courate du serveur. Nettoyage des pages miroir Cette tâche supprime les ressources web (pages miroir) utilisées par les diffusios. 1 Tout d'abord, la liste des diffusios à purger est récupérée à l'aide de la requête suivate : SELECT ideliveryid, ineedmirrorpage FROM NmsDelivery WHERE iwebrespurged = 0 AND tswebvalidity IS NOT NULL AND tswebvalidity < $(curdate)" où $(curdate) est la date courate du serveur. 2 La table NmsMirrorPageIfo est esuite purgée, si écessaire, à l'aide de l'idetifiat de la diffusio récupéré précédemmet. Ue suppressio e masse est utilisée pour géérer les requêtes suivates : DELETE FROM NmsMirrorPageIfo WHERE imirrorpageifoid IN (SELECT imirrorpageifoid FROM NmsMirrorPageIfo WHERE ideliveryid = $(dl)) LIMIT 5000) DELETE FROM NmsMirrorPageSearch WHERE imessageid IN (SELECT imessageid FROM NmsMirrorPageSearch WHERE ideliveryid = $(dl)) LIMIT 5000) où $(dl) est l'idetifiat de la diffusio. 3 U log est esuite ajouté au joural de la diffusio. 4 Les diffusios purgées sot esuite idetifiées afi de e pas avoir à les retraiter par la suite. La requête suivate est exécutée : UPDATE NmsDelivery SET iwebrespurged = 1 WHERE ideliveryid IN ($(stri)) Neolae v6.0 - Guide d'exploitatio - Traitemet des doées 39

41 Neolae où $(stri) est la liste des idetifiats de diffusio. Nettoyage des tables de travail Cette tâche supprime, das la base de doées, les tables de travail correspodat aux diffusios dot l'état est E éditio, Stoppé ou Supprimée. 1 La liste des tables dot le om commece par wkdlv_ est récupérée e premier lieu avec la requête suivate (postgresql) : SELECT relame FROM pg_class WHERE relame LIKE Lower('wkDlv_') ESCAPE E'\\\\' AND relkid IN ('r','v') AND pg_get_userbyid(relower)<>'postgres' 2 Les tables utilisées par des workflows e cours sot esuite exclues. Pour cela, la liste des diffusios e cours est récupérée à l'aide de la requête suivate : SELECT ideliveryid FROM NmsDelivery WHERE ideliveryid<>0 AND ideletestatus=0 AND istate NOT IN (0,85,100); où 0 est la valeur correspodat à l'état de diffusio E éditio, 85 correspod à l'état Stoppé et 100 correspod à l'état Supprimée. 3 Les tables qui e sot plus utilisées sot supprimées à l'aide de la requête suivate : DROP TABLE wkdlv_15487_1; Nettoyage des rejets géérés par les imports Cette étape permet de supprimer les eregistremets dot les doées 'ot pas été toutes traitées par l'import. 1 Ue suppressio e masse est exécutée sur la table XtkReject avec la requête suivate : DELETE FROM XtkReject WHERE irejectid IN (SELECT irejectid FROM XtkReject WHERE tslog < $(curdate)) LIMIT $(l)) où $(curdate) est la date courate du serveur à laquelle est soustraite la période défiie pour l'optio NmsCleaup_RejectsPurgeDelay (voir L'assistat de déploiemet [page 36]) et $(l) est le ombre maximum d'eregistremets à supprimer e masse. 2 Tous les rejets orphelis sot alors supprimés à l'aide de la requête suivate : DELETE FROM XtkReject WHERE ijobid NOT IN (SELECT ijobid FROM XtkJob) Nettoyage des istaces de workflow Cette tâche purge chaque istace de workflow e utilisat so idetifiat (lworkflowid) et so historique (lhistory). Elle supprime les tables iactives e utilisat à ouveau la tâche de ettoyage des tables de travail. 1 Pour récupérer la liste des workflows à supprimer, la requête suivate est utilisée : SELECT iworkflowid, ihistory FROM XtkWorkflow WHERE iworkflowid<>0 2 Cette requête géère la liste des workflows qui serot utilisés pour supprimer tous les logs associés, les tâches termiées et les évèemets termiés, à l'aide des requêtes suivates : DELETE FROM XtkWorkflowLog WHERE iworkflowid=$(lworkflow) AND tslog < DateMiusDays($(lhistory)) DELETE FROM XtkWorkflowTask WHERE iworkflowid=$(lworkflow) AND istatus<>0 AND tscompletio < DateMiusDays($(lhistory)) DELETE FROM XtkWorkflowEvet WHERE iworkflowid=$(l) AND istatus>2 AND tsprocessig < DateMiusDays($(lHistory)) où $(lworkflow) est l'idetifiat du workflow et $(lhistory) est l'idetifiat de l'historique. 3 Toutes les tables iutilisées sot alors supprimées. Pour cela, toutes les tables sot collectées à l'aide d'u masque de type wkf% utilisat la requête suivate (postgresql) : SELECT relame FROM pg_class WHERE relame LIKE Lower('wkf%') ESCAPE E'\\\\' AND relkid IN ('r','v') AND pg_get_userbyid(relower)<>'postgres' 40 Neolae 2013

42 Traitemet des doées 4 Puis, toutes les tables utilisées par ue istace de workflow e cours sot exclues. La liste des workflows actifs est récupérée à l'aide de la requête suivate : SELECT iworkflowid FROM XtkWorkflow WHERE iworkflowid<>0 AND istate<>20 5 Chaque idetifiat de workflow est esuite récupéré afi de trouver le om des tables utilisées par des workflows e cours. Ces oms sot exclus de la liste de tables récupérée précédemmet. 6 Les tables d'historique des activités de type "requête icrémetale" sot exclues, à l'aide des requêtes suivates : SELECT relame FROM pg_class WHERE relame LIKE Lower('wkfhisto%') ESCAPE E'\\\\' AND relkid IN ('r','v') AND pg_get_userbyid(relower)<>'postgres' SELECT iworkflowid FROM XtkWorkflow WHERE iworkflowid IN ($(strcoditio)) où $(strcoditio) est la liste des oms de tables correspodat au masque wkfhisto%. 7 Les tables restates sot supprimées à l'aide de la requête suivate : DROP TABLE wkf15487_12; Nettoyage des logis de workflows Cette tâche supprime les logis de workflows à l'aide de la requête suivate : DELETE FROM XtkWorkflowLogi WHERE iworkflowid NOT IN (SELECT iworkflowid FROM XtkWorkflow) Nettoyage des tables de travail orphelies Cette tâche supprime les tables de travail orphelies liées à des groupes. La table NmsGroup stocke les groupes à ettoyer (ceux dot le type est différet de 0). Le om des tables de travail a pour préfixe grp. Pour idetifier les groupes à ettoyer, la requête suivate est utilisée : SELECT igroupid FROM NmsGroup WHERE itype>0" Nettoyage des visiteurs Cette tâche ettoie les eregistremets obsolètes de la table des visiteurs à l'aide d'ue suppressio e masse. Les eregistremets obsolètes sot ceux dot la derière modificatio est atérieure à la période de coservatio défiie das l'assistat de déploiemet (voir L'assistat de déploiemet [page 36]). La requête suivate est utilisée : DELETE FROM NmsVisitor WHERE ivisitorid IN (SELECT ivisitorid FROM NmsVisitor WHERE irecipietid = 0 AND tslastmodified < $(tsdate) LIMIT 5000) où $(tsdate) est la date courate du serveur à laquelle est soustraite la période défiie pour l'optio NmsCleaup_VisitorPurgeDelay. Nettoyage des NPAI Cette tâche permet la suppressio, das la table NmsAddress, des eregistremets correspodat à des adresses valides. La requête suivate est utilisée pour effectuer ue suppressio e masse : DELETE FROM NmsAddress WHERE iaddressid IN (SELECT iaddressid FROM NmsAddress WHERE istatus=2 AND tslastmodified < $(tsdate1) AND tslastmodified >= $(tsdate2) LIMIT 5000) où status 2 correspod au statut Valide, $(tsdate1) est la date courate du serveur, et $(tsdate2) correspod à l'optio NmsCleaup_LastCleaup. Nettoyage des aboemets Cette tâche purge, das la table NmsSubscriptio, les aboemets qui ot été supprimés par l'utilisateur, à l'aide d'ue suppressio e masse. La requête suivate est utilisée : DELETE FROM NmsSubscriptio WHERE ideletestatus <>0 Nettoyage des logs de trackig Cette tâche supprime les eregistremets obsolètes des tables de logs de trackig et de webtrackig. Les eregistremets obsolètes sot ceux qui sot atérieurs à la période de coservatio défiie das l'assistat de déploiemet (voir L'assistat de déploiemet [page 36]). 1 Tout d'abord, la liste des tables de logs de trackig est récupérée à l'aide de la requête suivate : Neolae v6.0 - Guide d'exploitatio - Traitemet des doées 41

43 Neolae SELECT distict(strackiglogschema) FROM NmsDeliveryMappig WHERE strackiglogschema IS NOT NULL; 2 Ue suppressio e masse est utilisée pour purger toutes les tables das la liste des tables récupérées précédemmet. La requête utilisée est la suivate : DELETE FROM XtkTrackigLogRcp WHERE itrackiglogid IN (SELECT itrackiglogid FROM XtkTrackigLogRcp WHERE tslog < $(tsdate) LIMIT 5000) où $(tsdate) est la date courate du serveur à laquelle est soustraite la période défiie pour l'optio NmsCleaup_TrackigLogPurgeDelay. 3 La table des statistiques de trackig est purgée à l'aide d'ue suppressio e masse. La requête suivate est utilisée : DELETE FROM NmsTrackigStats WHERE itrackigstatsid IN (SELECT itrackigstatsid FROM NmsTrackigStats WHERE tsstart < $(tsdate) LIMIT 5000) où $(tsdate) est la date courate du serveur à laquelle est soustraite la période défiie pour l'optio NmsCleaup_TrackigStatPurgeDelay. Nettoyage des logs de diffusio Cette tâche permet de purger les logs de diffusio stockés das différetes tables. 1 Pour cela, la liste des schémas de logs de diffusio est récupérée à l'aide de la requête suivate : SELECT distict(sbroadlogschema) FROM NmsDeliveryMappig WHERE sbroadlogschema IS NOT NULL UNION SELECT distict(sbroadlogexclschema) FROM NmsDeliveryMappig WHERE sbroadlogexclschema IS NOT NULL 2 Das le cas de l'utilisatio du mid-sourcig, la table NmsBroadLogMid 'est pas référecée das les mappigs de diffusio. Le schéma ms:broadlogmid est alors ajouté à la liste récupérée par la requête précédete. 3 Le workflow Nettoyage de la base procède esuite à la purge des eregistremets obsolètes das les tables récupérées précédemmet. La requête suivate est utilisée : DELETE FROM $(tablename) WHERE ibroadlogid IN (SELECT ibroadlogid FROM $(tablename) WHERE tslastmodified < $(optio) LIMIT 5000) où $(tablename) est le om de chaque table das la liste de schémas, et $(optio) est la date défiie pour l'optio NmsCleaup_BroadLogPurgeDelay (voir L'assistat de déploiemet [page 36]). 4 Le workflow vérifie efi si la table NmsProviderMsgId existe. Si c'est le cas, tous ses eregistremets obsolètes sot supprimés à l'aide de la requête suivate : DELETE FROM NmsProviderMsgId WHERE ibroadlogid IN (SELECT ibroadlogid FROM NmsProviderMsgId WHERE tscreated < $(optio) LIMIT 5000) où $(optio) correspod à la date défiie pour l'optio NmsCleaup_BroadLogPurgeDelay (voir L'assistat de déploiemet [page 36]). Nettoyage de la table Nms ErrorStat Cette tâche ettoie la table Nms ErrorStat. Le programme pricipal (coalesceerrors) défiit deux dates : Date de début : date du prochai traitemet correspodat à l'optio NmsLastErrorStatCoalesce ou correspodat à la date la plus récete das la table. Date de fi : date courate du serveur. Si la date de début est supérieure ou égale à la date de fi, aucu traitemet 'a lieu. Le message coalesceuptodate apparaît alors. Si la date de début est iférieure à la date de fi, la table Nms ErrorStat est ettoyée. Le ombre total d'erreurs das la table Nms ErrorStat, etre les dates de début et de fi, est récupéré à l'aide de la requête suivate : "SELECT COUNT(*) FROM Nms ErrorStat WHERE tsdate>= $(start) AND tsdate< $(ed)" où $ed et $start sot les dates de début et de fi défiies précédemmet. Si le total est supérieur à 0 : 42 Neolae 2013

44 Traitemet des doées 1 La requête suivate est exécutée afi de e coserver que les erreurs situées au-delà d'u certai seuil (égal à 20) : "SELECT imxip, ipublicid, SUM(iTotalCoectios), SUM(iTotalErrors), SUM(iMessageErrors), SUM(iAbortedCoectios), SUM(iFailedCoectios), SUM(iRefusedCoectios), SUM(iTimeoutCoectios) FROM Nms ErrorStat WHERE tsdate>=$(start ) AND tsdate<$(ed ) GROUP BY imxip, ipublicid HAVING SUM(iTotalErrors) >= 20" 2 Le message coalescigerrors apparaît. 3 Ue ouvelle coexio est créée pour supprimer toutes les erreurs surveues etre les dates de début et de fi. La requête suivate est utilisée : "DELETE FROM Nms ErrorStat WHERE tsdate>=$(start) AND tsdate<$(ed)" 4 Chaque erreur est eregistrée das la table Nms ErrorStat à l'aide de la requête suivate : "INSERT INTO Nms ErrorStat(iMXIP, ipublicid, tsdate, itotalcoectios, itotalerrors, itimeoutcoectios, irefusedcoectios, iabortedcoectios, ifailedcoectios, imessageerrors) VALUES($(lmxip ), $(lpublicid ), $(tsstart ), $(lcoectios ), $(lcoectioerrors ),$(ltimeoutcoectios ), $(lrefusedcoectios ), $(labortedcoectios ), $(lfailedcoectios ), $(lmessageerrors))" où chaque variable correspod à ue valeur récupérée par la requête précédete. 5 La variable start est mise à jour avec les valeurs de la date du traitemet précédet afi de termier la boucle. La boucle et la tâche s'arrêtet. Deux tâches sot esuite exécutées : le ettoyage des tables Nms Error et cleaupnmsmxdomai. Nettoyage de la table Nms Error La requête suivate est utilisée : DELETE FROM Nms Error WHERE imxip NOT IN (SELECT DISTINCT imxip FROM Nms ErrorStat) Cette requête supprime, das la table Nms Error, toutes les liges 'ayat aucu eregistremet associé das la table Nms ErrorStat. Nettoyage de la table NmsMxDomai La requête suivate est utilisée : DELETE FROM NmsMxDomai WHERE imxip NOT IN (SELECT DISTINCT imxip FROM Nms ErrorStat) Cette requête supprime, das la table NmsMxDomai, toutes les liges 'ayat aucu eregistremet associé das la table Nms ErrorStat. Nettoyage des propositios Si le module Iteractio est istallé, cette tâche est exécutée afi de purger les tables NmsPropositioXxx. La liste des tables de propositios est récupérée et ue suppressio e masse est exécutée sur chacue d'etre elles, à l'aide de la requête suivate : DELETE FROM NmsPropositioXxx WHERE ipropositioid IN (SELECT ipropositioid FROM NmsPropositioXxx WHERE tslastmodified < $(optio) LIMIT 5000) où $(optio) est la date défiie pour l'optio NmsCleaup_PropositioPurgeDelay (voir L'assistat de déploiemet [page 36]). Nettoyage des tables de simulatio Cette tâche ettoie les tables de simulatio orphelies (qui e sot plus associées à ue simulatio d'offre ou ue simulatio de diffusio). 1 Pour récupérer la liste des simulatios à ettoyer, la requête suivate est utilisée : SELECT isimulatioid FROM NmsSimulatio WHERE isimulatioid<>0 2 Le om des tables à supprimer est composé du préfixe wksimu_ suivi de l'idetifiat de la simulatio (par exemple : wksimu_456831_aggr). La requête suivate est utilisée : DROP TABLE wksimu_456831_aggr Neolae v6.0 - Guide d'exploitatio - Traitemet des doées 43

45 Neolae Mise à jour des statistiques Si l'optio XtkCleaup_NoStats 'existe pas ou a pour valeur 0 (i.e. l'optio est désactivée), cette tâche est exécutée pour mettre à jour les statistiques de la base de doées. Si l'optio a pour valeur 1 (i.e. l'optio est activée), la mise à jour des statistiques 'est pas exécutée. Cette tâche appelle ue procédure de base de doées. Nettoyage des évéemets ayat expiré Cette tâche ettoie les évéemets reçus et stockés sur les istaces d'exécutio et les évéemets historisés sur ue istace de pilotage. 44 Neolae 2013

46 CHAPITRE 4 Mise à jour de Neolae Table des matières Mise à jour de versio Sous Widows Sous Liux Résoudre les coflits de mise à jour Alerter les postes cliets de la dispoibilité de la mise à jour Exemple de trasformatio e Uicode d'ue istace existate Ce chapitre présete la procédure à suivre pour mettre à jour Neolae avec ue ouvelle versio, côté cliet et côté serveur, et décrit le mode de trasformatio e Uicode d'ue istace existate. Les procédures de migratio de la versio 5.11 vers la versio 6 de Neolae sot présetées das le Guide de migratio. L'opératio de mise à jour doit être effectuée sur l'esemble des serveurs où Neolae est istallé. Neolae repose sur plusieurs processus exécutés côté serveur que vous serez ameé à maipuler lors d'ue mise à jour, e particulier : Serveur applicatif (lserver web) Serveur de diffusio (lserver mta) Serveur de redirectio (webmdl) Note : Reportez-vous au Guide d'istallatio pour davatage d'iformatios sur les différets processus Neolae. Das le cas d'ue architecture de type mid-sourcig, vous devez appliquer cette procédure sur tous les serveurs de mid-sourcig. Si la ouvelle versio implique ue modificatio de la structure de la base, il est recommadé de redémarrer les serveurs das l'ordre suivat : 1 Serveur applicatif (lserver web), 2 Serveur de redirectio (webmdl), 3 Serveur de diffusio (lserver mta). Neolae v6.0 - Guide d'exploitatio - Mise à jour de Neolae 45

47 Neolae Mise à jour de versio Note : Das les commades suivates, les caractères XXXX représetet le uméro de build Neolae. Avertissemet : Il est fortemet coseillé d'effectuer ue sauvegarde de la base de chacue des istaces, avat la mise à jour. Pour plus d'iformatio, reportez-vous à la sectio La sauvegarde [page 29]. Sous Widows Pour mettre à jour Neolae das ue ouvelle versio lors de la livraiso d'u ouveau build, la procédure sous Widows est la suivate : Arrêter les services [page 46], Mettre à jour l'applicatio serveur Neolae [page 46], Sychroiser les ressources [page 47], Redémarrer les services [page 47]. Pour coaître la procédure de mise à jour de la cosole cliete, reportez-vous à la sectio Mise à dispositio de la cosole cliete. Arrêter les services Il est écessaire d'arrêter toutes les istaces du service lserver afi de pouvoir remplacer tous les fichiers avec la ouvelle versio. 1 Arrêtez les services suivats : services Web (IIS) : iisreset /stop service Neolae : et stop lserver6 Avertissemet : Vous devez égalemet vous assurer que le serveur de redirectio (webmdl) est arrêté afi que le fichier lsrvmod.dll, qui est utilisé par IIS, puisse être remplacé par la ouvelle versio. 2 Assurez-vous qu'aucue tâche 'est active à l'aide de la commade lserver pdump. Le résultat suivat doit s'afficher : C:\Program Files\Neolae\Neolae v6\bi>lserver pdump 11:33:39 > Serveur applicatif pour Neolae Versio 6.00 (build 6745) du 11/07/2011 No tasks Vous pouvez évetuellemet utiliser le Gestioaire de tâches de Widows afi de vous assurer que tous les processus sot iactifs. Mettre à jour l'applicatio serveur Neolae Pour exécuter le fichier de mise à jour, respectez les étapes suivates : 1 Lacez l'exécutio de setup.exe Ce fichier peut être téléchargé depuis la page du Support Neolae ( e cliquat sur le lie Cetre de téléchargemet. 2 Sélectioez le mode d'istallatio : choisissez Mise à jour ou réparatio 3 Cliquez sur Suivat. 4 Cliquez sur Termier. Le programme d'istallatio copie alors les ouveaux fichiers. 5 Lorsque l'opératio est termiée, cliquez sur Termier. 46 Neolae 2013

48 Mise à jour de Neolae Sychroiser les ressources Utilisez la commade lserver cofig -postupgrade -allistaces afi d'effectuer les opératios suivates : sychroiser les ressources, mettre à jour les schémas, mettre à jour la base de doées. Note : Cette opératio 'est à effectuer qu'ue seule fois et uiquemet sur u serveur applicatif (lserver web). Vérifiez esuite si la sychroisatio a gééré des erreurs ou des alertes. Voir à ce sujet Résoudre les coflits de mise à jour [page 48]. Astuce : Si vous e voulez effectuer la sychroisatio que sur ue seule base, utilisez la commade lserver cofig -postupgrade -istace:<om_de_l'istace>. Redémarrer les services Les services à redémarrer sot : services Web (IIS) : iisreset /start service Neolae : et start lserver6 Sous Liux Pour mettre à jour Neolae das ue ouvelle versio lors de la livraiso d'u ouveau build, la procédure sous Liux est la suivate : Obteir les packages à jour [page 47], Effectuer la mise à jour [page 47], Redémarrer le serveur web [page 48]. Pour coaître la procédure de mise à jour de la cosole cliete, reportez-vous à la sectio Mise à dispositio de la cosole cliete. Obteir les packages à jour Il faut d'abord obteir les deux packages à jour de Neolae. Les fichiers sot : lthirdparty6-xxxx-0.i686.rpm lserver6-xxxx-0.i686.yyy où YYY représete le suffixe du maager de package. Effectuer la mise à jour Distributio basée sur RPM (RedHat, SuSe) Pour les istaller, exécutez e tat que root : $rpm -Uvh lthirdparty6-xxxx.i686.rpm lserver6-xxxx.i686.rpm Distributio basée sur DEB (Debia) Pour les istaller, exécutez e tat que root : dpkg -i lthirdparty6-xxxx-liux-2.6-itel.deb lserver6-xxxx-liux-2.6-itel.deb Neolae v6.0 - Guide d'exploitatio - Mise à jour de Neolae 47

49 Neolae Note : La sychroisatio des ressources se fait automatiquemet. E revache, vous devez vérifier si elle s'est déroulée sas erreur. Voir à ce sujet la sectio Résoudre les coflits de mise à jour [page 48]. Redémarrer le serveur web Vous devez arrêter Apache afi que la ouvelle librairie soit prise e compte. Pour cela exécutez la commade : /etc/iit.d/apache stop Avertissemet : Il est possible que votre script porte le om httpd plutôt que apache. Vous DEVEZ impérativemet exécuter cette commade jusqu'à obteir la répose suivate : httpd (o pid file) ot ruig Cette opératio est écessaire afi qu'apache pree e compte la ouvelle librairie. Puis redémarrez Apache : /etc/iit.d/apache start Résoudre les coflits de mise à jour Lors de la sychroisatio des ressources, la commade postupgrade permet de détecter si la sychroisatio géère des erreurs ou des avertissemets. Cosulter le résultat de la sychroisatio Le résultat de la sychroisatio peut être cosulté de deux maières : Depuis l'ivite de commades, les erreurs sot matérialisées par u triple chevro >>> et la sychroisatio s'iterrompt immédiatemet. Les avertissemets sot sigalés par u double chevro >> et doivet être résolus lorsque le processus de sychroisatio est termié. A la fi du postupgrade, u résumé est affiché das l'ivite de commade. Par exemple : :48:39.749Z 00002E7A 1 ifo log =========Summary of the update========== :48:39.749Z 00002E7A 1 ifo log eolaetest istace, 6 warig(s) ad 0 error(s) durig the update :48:39.749Z 00002E7A 1 warig log The documet with idetifier 'mobileappdeliveryfeedback' ad type 'xtk:report' is i coflict with the ew versio :48:39.749Z 00002E7A 1 warig log The documet with idetifier 'opesbyuseraget' ad type 'xtk:report' is i coflict with the ew versio :48:39.750Z 00002E7A 1 warig log The documet with idetifier 'deliveryvalidatio' ad type 'ms:webapp' is i coflict with the ew versio :48:39.750Z 00002E7A 1 warig log Documet of idetifier 'ms:icludeview' ad type 'xtk:srcschema' updated i the database ad foud i the file system. You will have to merge the two versios maually. Si l'avertissemet cocere u coflit de ressources, il requiert l'itervetio de l'utilisateur pour être résolu. Le fichier joural postupgrade_< de versio du serveur>_<heure du postupgrade>.log cotiet le résultat de la sychroisatio. Il est dispoible par défaut das le répertoire suivat : <répertoire d'istallatio>/var/<istace>/postupgrade. Les erreurs et les avertissemets correspodet respectivemet aux liges coteat l'attribut error et warig. Résoudre u coflit Pour résoudre u coflit, procédez de la maière suivate : 48 Neolae 2013

50 Mise à jour de Neolae 1 Das l'arborescece de Neolae, positioez-vous das Admiistratio>Gestio des packages>editio des coflits. 2 Sélectioez le coflit que vous souhaitez résoudre das la liste. Il existe trois possibilités de résoudre u coflit : Déclarer comme résolu : requiert ue itervetio de l'utilisateur au préalable. Accepter la ouvelle versio : recommadé si les ressources livrées avec Neolae 'ot pas été modifiées par l'utilisateur. Coserver la versio actuelle : a pour coséquece de refuser la mise à jour de la versio. Avertissemet : Si vous sélectioez ce mode de résolutio, vous risquez de perdre des correctifs iclus das la ouvelle versio. Si vous choisissez de résoudre le coflit mauellemet, procédez comme suit : 1 Das la partie iférieure de la feêtre, faites ue recherche sur la chaîe _coflict_ pour localiser les etités e coflit. L'etité istallée avec la ouvelle versio cotiet l'argumet ew, l'etité correspodat à la versio précédete cotiet l'argumet cus. 2 Supprimez la versio que vous e souhaitez pas coserver. Effacez la chaîe _coflict_argumet_ de l'etité que vous gardez. 3 Positioez-vous sur le coflit que vous veez de résoudre. Cliquez sur l'icôe Actios et sélectioez Déclarer comme résolu. 4 Eregistrez vos modificatios : le coflit est désormais résolu. Alerter les postes cliets de la dispoibilité de la mise à jour Sous Widows Sur la machie sur laquelle est istallé le serveur applicatif Neolae (lserver web), téléchargez puis copiez le fichier setup-cliet-6.xxxx.exe das [chemi de l'applicatio]\datakit\l\fra\jsp Aisi, à la prochaie coexio des postes cliets, ue feêtre idiquera aux utilisateurs la dispoibilité d'ue mise à jour et leur proposera de la télécharger et de l'istaller. Neolae v6.0 - Guide d'exploitatio - Mise à jour de Neolae 49

51 Neolae Note : Assurez-vous que l'utilisateur IIS_WPG a bie les droits d'accès e lecture à ce fichier d'istallatio et reportez-vous au Guide d'istallatio pour davatage d'iformatios. Sous Liux Sur la machie sur laquelle est istallé le serveur applicatif Neolae (lserver web), récupérez le package setup-cliet-6.xxxx.exe et copiez-le sous /usr/local/eolae/l6/datakit/l/fra/jsp : cp setup-cliet-6.xxxx.exe /usr/local/eolae/l6/datakit/l/fra/jsp Aisi, à la prochaie coexio des postes cliets, ue feêtre idiquera aux utilisateurs la dispoibilité d'ue mise à jour et leur proposera de la télécharger et de l'istaller. Note : Assurez-vous que l'utilisateur Apache a bie les droits d'accès e lecture à ce fichier d'istallatio et reportez-vous au Guide d'istallatio pour davatage d'iformatios. Exemple de trasformatio e Uicode d'ue istace existate Soit ue istace prod existate sous Liux/PostgreSQL, les étapes de trasformatio e Uicode de cette istace sot les suivates : 1 Arrêter les processus qui écrivet das la base : su - eolae lserver shutdow 2 Dumper la base : su - postgres pg_dump mabase > mabase.sql 3 Créer ue base Uicode : createdb -E UNICODE mabase_uicode 4 Restaurer la base : psql mabase_uicode < mabase.sql 5 Mettre à jour l'optio qui idique que la base est Uicode : psql mabase_uicode update XtkOptio set sstrigvalue = 'u' sstrigvalue where sname='xtkdatabaseid' ad sstrigvalue ot like 'u%'; 6 Sur les serveurs de trackig : su - eolae cd l6/cof vi cofig-prod.xml Ajouter le caractère u devat la valeur relative à l'idetifiat de la base de doées (databaseid) : <web> <redirectio databaseid="u7f c" trackigpassword="mypassword="/> </web> 7 Sur les serveurs appelat la base : su - eolae cd l6/cof vi cofig-prod.xml 50 Neolae 2013

52 Mise à jour de Neolae Modifier la référece de la base : <datasource ame="default"> <dbcx ecrypted="1" logi="eolae:mabase_uicode" password="xxxx=" provider="postgresql" server="yyyy"/> </datasource> 8 Redémarrer toutes les machies : /etc/iit.d/apache stop /etc/iit.d/lserver6 stop /etc/iit.d/lserver6 start /etc/iit.d/apache start 9 Valider la trasformatio. Pour cela, se coecter via la cosole Neolae et : vérifier que les doées s'affichet correctemet, otammet les caractères accetués, lacer ue diffusio et vérifier que la récupératio du trackig foctioe. Neolae v6.0 - Guide d'exploitatio - Mise à jour de Neolae 51

53 Neolae 52 Neolae v6.0 - Guide d'exploitatio

54 CHAPITRE 5 Maiteace de la base de doées Table des matières Liste des tables à maiteir Tables Neolae Tables Cliets Types de maiteace Maiteace au iveau applicatif Maiteace techique Spécificités par SGBDR PostgreSQL Oracle DB SQL Server MySQL Neolae est u système hautemet trasactioel (base OLTP). De ce fait, la base de doées sous-jacete est fréquemmet mise à jour et, gééralemet, ses performaces se dégradet au fil du temps. Pour y remédier, ue maiteace régulière de la base de doées est écessaire. Avertissemet : Ue base de doées e peut rester performate que si elle bééficie de procédures de maiteace régulières. La maiteace automatique proposée par certais SGBDR 'est pas suffisate et e remplace pas ue maiteace e profodeur. Ceci 'est pas propre à Neolae mais cocere tout système trasactioel de gestio de base de doées relatioelle. Ce chapitre décrit des pricipes pour vous aider à créer des plas de maiteace les mieux adaptés à votre cas. Avertissemet : Les procédures décrites das ce documet sot des recommadatios. Le resposable des plas de maiteace de la base de doées est l'admiistrateur de la base de doées. C'est à lui et o à Neolae que vous devez vous adresser e cas de problème. Neolae v6.0 - Guide d'exploitatio - Maiteace de la base de doées 53

55 Neolae Liste des tables à maiteir La liste des tables à maiteir déped de votre versio de Neolae, de l'utilisatio que vous e faites et de la cofiguratio du modèle de doées. Das la liste qui suit, e sot metioées que les tables les plus sujettes à la fragmetatio. Les impacts sot les suivats : ue surcosommatio de l'espace-disque qui impacte les performaces d'accès à la base, des idex qui 'ot pas été mis à jour depuis logtemps ce qui raletit le temps de répose des requêtes. Tables Neolae A partir de Neolae v4.05 Nom de la table Taille Activité pricipale Commetaires NmsDelivery Petit volume Mises à jour A chaque actio de diffusio correspod u eregistremet. U seul eregistremet peut être mis à jour plusieurs fois tout au log du processus de diffusio. Par coséquet, les idex de cette table se trouvet rapidemet fragmetés. NmsDeliveryPart Volume moye Isertios, mises à jour, suppressios Table de travail das laquelle les eregistremets sot isérés pedat la préparatio de la diffusio, puis mis à jour lors de la diffusio, puis supprimés lorsque la diffusio est termiée. Cette table a tedace à se fragmeter rapidemet, même si sa taille moyee reste modeste. NmsMirrorPageIfo Gros volume Isertios, suppressios Cette table cotiet les iformatios écessaires à la géératio de pages miroir persoalisées. Elle cotiet u champ mémo (CLOB) ce qui a pour coséquece d'augmeter éormémet sa taille. So volume est proportioel à l'historique des pages miroir qui est coservé. NmsDeliveryStat Volume moye Isertios, mises à jour, suppressios Cette table cotiet les statistiques du processus de diffusio. Ses eregistremets sot fréquemmet mis à jour. NmsAddress Volume moye Mises à jour, Isertios Cette table cotiet les iformatios propres aux adresses . Elle est fréquemmet mise à jour lors du processus de mise e quarataie : les eregistremets sot créés lors de la première erreur de diffusio, mis à jour lorsque les compteurs sot modifiés puis supprimés lorsque la diffusio parviet à l'adresse spécifiée. XtkWorkflow Petit volume Mises à jour A chaque istace de workflow correspod u eregistremet, soit peu d'eregistremets. Cepedat la table est fréquemmet mise à jour tout au log du déroulemet du workflow et lors de la mise à jour de so statut. 54 Neolae 2013

56 Maiteace de la base de doées Nom de la table Taille Activité pricipale Commetaires XtkWorkflowTask Petit volume Isertios, mises à jour, suppressios L'exécutio d'ue activité de workflow crée u eregistremet das la table. Le système de purge des doées les supprime ue fois qu'elles sot expirées. XtkWorkflowEvet Petit volume Isertios, mises à jour, suppressios L'activatio d'ue trasitio das u workflow crée u eregistremet das la table. Le système de purge des doées les supprime ue fois qu'elles sot expirées. XtkWorkflowJob Très petit volume Isertios, mises à jour, suppressios Cette table est propre au foctioemet itere du moteur de workflow. Elle sert à evoyer des commades aux workflows (Démarrer, Arrêter, Pause, par exemple). Bie qu'elle soit de petite taille, cette table est prise e compte lors du ettoyage des tables trasactioelles liées aux workflows. A partir des versios 4.05 et 5.00 Nom de la table Taille Activité pricipale Commetaires NmsBroadLog Table la plus volumieuse du système Isertios, mises à jour, suppressios Cette table est la plus volumieuse du système. A chaque message evoyé correspod u eregistremet. Ces eregistremets sot isérés das la table, mis à jour régulièremet pour récupérer le statut de la diffusio puis supprimés lorsque l'historique est purgé. NmsTrackigLog Gros volume Isertios, suppressios Les logs de trackig sot isérés das la table puis supprimés lorsque l'historique est purgé mais e sot pas mis à jour. A partir de Neolae 5.10 Nom de la table Taille Activité pricipale Commetaires NmsBroadlogMsg Petit volume Mises à jour Cette table cotiet des iformatios permettat de qualifier les erreurs SMTP. Elle est de petite taille mais est ameée à être massivemet mise à jour, par coséquet ses idex se trouvet rapidemet fragmetés. Nms ErrorStat Volume moye Isertios, mises à jour, suppressios Cette table cotiet les agrégats des erreurs SMTP classées par domaie. Au départ elle cotiet des iformatios détaillées qui sot agrégées par le workflow de ettoyage lorsqu'elles devieet obsolètes. Neolae v6.0 - Guide d'exploitatio - Maiteace de la base de doées 55

57 Neolae Nom de la table Taille Activité pricipale Commetaires NmsBroadLogMid (sur ue istace de mid-sourcig) Gros volume Isertios, mises à jour, suppressios Cette table 'existe que lorsque l'istace mid-sourcig est e versio 5.10 et ultérieure. Il s'agit de l'ue des tables les plus volumieuses. A chaque message evoyé correspod u eregistremet. Ces eregistremets sot isérés das la table, mis à jour régulièremet pour récupérer le statut de la diffusio puis supprimés lorsque l'historique est purgé. Das le cas d'ue architecture mid-sourcig, il est recommadé de limiter l'historique (habituellemet mois de deux mois). Par coséquet, cette table garde ue taille raisoable, soit mois de 30Go pour 60 millios de liges compreat les doées et les idex. Il est cepedat très importat de la recostruire de temps à autre. NmsBroadLogRcp (lorsque la table NmsRecipiet est utilisée) Gros volume Isertios, mises à jour, suppressios Cette table est l'ue des plus volumieuses. A chaque message evoyé correspod u eregistremet. Ces eregistremets sot isérés das la table, mis à jour régulièremet pour récupérer le statut de la diffusio puis supprimés lorsque l'historique est purgé. Cette table est plus petite e versio 5.10 que la table équivalete e versio 4.05 (NmsBroadLog) du fait que le message texte SMTP est factorisé das la table NmsBroadLogMsg e v5.10. Il est cepedat idispesable de recréer l'idex de cette table régulièremet (toutes les deux semaies est ue boe base de départ) et la recostruire etièremet de temps à autre (tous les mois eviro ou avat que les performaces e soiet trop dégradées). YyyBroadLogXxx (lorsqu'ue table de destiataires extere est utilisée) Gros volume Isertios, mises à jour, suppressios Idem que pour NmsBroadLogRcp mais avec ue table de destiataires extere. Remplacer Yyy et Xxx avec les valeurs utilisées das votre mappig de diffusio. NmsTrackigLogRcp (lorsque la table NmsRecipiet est utilisée) Gros volume Isertios, suppressios Les logs de trackig sot isérés puis supprimés lors de la purge de l'historique. Ils e sot pas mis à jour. Le volume de la table déped de la durée de coservatio de l'historique. YyyTrackigLogXxx (lorsqu'ue table de destiataires extere est utilisée) Gros volume Isertios, suppressios Idem que pour NmsTrackigLogRcp mais avec ue table de destiataires extere. Remplacer Yyy et Xxx avec les valeurs utilisées das votre mappig de diffusio. 56 Neolae 2013

58 Maiteace de la base de doées Nom de la table Taille Activité pricipale Commetaires NmsPropositiosRcp (lorsque la table NmsRecipiet est utilisée) Gros volume Isertios, mises à jour, suppressios Cette table peut être très volumieuse. Elle stocke l'historique de toutes les propositios etrates et sortates visualisées ou evoyées. Les propositios sot isérées puis mises à jour lorsque la persoe accepte ou refuse l'offre, puis supprimées lors de la purge de l'historique. Il est idispesable de recréer l'idex de cette table régulièremet (toutes les deux semaies est ue boe base de départ) et la recostruire etièremet de temps à autre (tous les mois eviro ou avat que les performaces e soiet trop dégradées). YyyPropositiosXxx (lorsqu'ue table de destiataires extere est utilisée) Gros volume Isertios, mises à jour, suppressios Idem que pour NmsPropositiosRcp mais avec ue table de destiataires extere. Remplacer Yyy et Xxx avec les valeurs utilisées das votre mappig de diffusio. Tables Cliets Les tables créées par les cliets (qui 'existet pas das le modèle de doées de Neolae) lors de la mise e place de la plateforme sot égalemet sujettes à la fragmetatio. C'est le cas otammet lorsqu'elles sot fréquemmet mises à jour lors de chargemets de doées ou de procédures de sychroisatio. Ces tables peuvet faire partie du modèle de doées de Neolae (comme NmsRecipiet par exemple). C'est doc à l'admiistrateur de la plateforme Neolae de rechercher l'existece de ces tables spécifiques das le modèle de doées. Il se peut que ces tables e soiet pas explicitemet metioées das les procédures de maiteace. Types de maiteace Maiteace au iveau applicatif Neolae met à votre dispositio u workflow d'usie qui permet d'assurer certaies tâches de maiteace de la base de maière plaifiée. Il s'agit du workflow de ettoyage de la base qui effectue les tâches suivates : suppressio des eregistremets expirés, suppressio des eregistremets orphelis et réiitialisatio du statut des objets qui ot expirés, mise à jour des statistiques de la base de doées. Reportez-vous à la sectio Descriptio du workflow Nettoyage de la base [page 34] pour plus d'iformatios. Avertissemet : Le workflow de ettoyage assure la maiteace au iveau applicatif et o celle de la base de doées (à l'exceptio de la mise à jour des statistiques). Il est cepedat écessaire d'effectuer des opératios de maiteace sur la base. E effet, le fait que la tâche de ettoyage se déroule sas erreur e sigifie pas que la base de doées soit totalemet optimisée. Maiteace techique Le workflow de ettoyage de la base e compred aucu système pour plaifier la maiteace de la base. C'est à vous que reviet la resposabilité de plaifier la maiteace. Pour cela, vous pouvez, au choix : charger l'admiistrateur de votre base de doées de plaifier la maiteace de la base de doées sas recourir aux outils dispoibles das la plateforme Neolae, utiliser le moteur de workflow dispoible das Neolae pour plaifier et suivre les activités de maiteace. Neolae v6.0 - Guide d'exploitatio - Maiteace de la base de doées 57

59 Neolae Ces procédures de maiteace doivet être effectuées régulièremet. Il s'agit, par exemple, des procédures suivates : regéérer l'idex des tables fréquemmet mises à jour, compacter ou recostruire les tables pour leur éviter d'être fragmetées. Plaifier la maiteace La plus grade cotraite des opératios de maiteace est de trouver le momet approprié pour que cela 'impacte pas les performaces de la base de doées ou e bloque l'applicatio du fait du verrouillage des fichiers. Il est courat de lacer les tâches de maiteace ue fois par semaie, pedat ue période de faible activité et e dehors des périodes de sauvegarde, de rechargemet de doées ou de calcul des agrégats. Sur certais systèmes très sollicités il peut être écessaire de le faire plus souvet. Ue opératio de maiteace plus importate, comme la recostructio de toutes les tables peut être faite ue fois par mois, de préférece lorsque les applicatios sot totalemet arrêtées, le système état alors iutilisable. Recostruire ue table Pour recostruire ue table, plusieurs stratégies sot evisageables : Opératios Descriptio Avatages Icovéiets Défragmetatio à chaud Sauvegarde puis restauratio Duplicatio puis reommage et suppressio La plupart des moteurs de base de doées mettet à dispositio des méthodes de défragmetatio. Cette opératio cosiste à sauvegarder la table sous forme de fichier puis à la supprimer de la base de doées et à la restaurer à partir du fichier de sauvegarde. Cette opératio cosiste à créer ue copie de la table et de ses idex, à supprimer la table origielle puis à la remplacer par sa copie après l'avoir reommée. Il suffit d'utiliser la méthode de défragmetatio du moteur de base de doées. Ces méthodes ot l'avatage de préserver l'itégrité des doées, otammet e les verrouillat pedat la défragmetatio. Il s'agit de la faço la plus simple de défragmeter ue table. C'est égalemet la seule evisageable lorsque la base occupe presque tout l'espace-disque. Cette méthode est plus rapide que de faire ue sauvegarde/restauratio car elle géère mois d'e/s du fait qu'il 'y a pas de créatio i de restauratio à partir d'u fichier. Selo les bases, ces méthodes de défragmetatio peuvet être fouries comme ue optio du SGBDR (Cf. Oracle) et e sot pas toujours les plus efficaces sur les tables très volumieuses. La table état supprimée puis recréée, il est impossible de garder l'applicatio e état de foctioemet, même e lecture seule car la table 'est pas accessible pedat la phase de restauratio. Requiert deux fois plus d'espacedisque. Tous les processus qui doivet accéder à la table e écriture doivet être arrêtés. Ils e serot pas affectés par les opératios de duplicatio/reommage/suppressio car les différetes versios de la table sot échagées au derier momet lorsque la défragmetatio est termiée. Spécificités par SGBDR Cette sectio cotiet ue série de recommadatios et de boes pratiques destiées à vous aider à mettre e place les plas de maiteace de vos bases de doées pour chacu des SGBDR supportés par Neolae. Gardez à l'esprit que ce e sot que des recommadatios. C'est à vous qu'il reviet de les adapter e foctio de vos cotraites et de vos procédures iteres. L'admiistrateur de base de doées est la persoe qui doit être resposable de ces procédures. PostgreSQL Détecter les grades tables 1 Ajoutez la vue suivate à votre base de doées : create or replace view uvspace as 58 Neolae 2013

60 Maiteace de la base de doées SELECT c1.relame AS tableame, c2.relame AS idexame, c2.relpages * 8 / 1024 AS size_mbytes, c2.relfileode AS fileame, 0 AS row_cout FROM pg_class c1, pg_class c2, pg_idex i WHERE c1.oid = i.idrelid AND i.idexrelid = c2.oid UNION SELECT pg_class.relame AS tableame, NULL::"ukow" AS idexame, pg_class.relpages * 8 / 1024 AS size_mbytes, pg_class.relfileode AS fileame, cast(pg_class.reltuples as iteger) AS row_cout FROM pg_class WHERE pg_class.relkid = 'r'::"char" ORDER BY 3 DESC, 1, 2 DESC; 2 Lacez la commade suivate pour répertorier les tables volumieuses et les idex : select * from uvspace; Maiteace simple Sous PostgreSQL, les commades habituellemet utilisées sot vacuum full et reidex. Voici u exemple classique de pla de maiteace SQL qui doit être exécuté régulièremet à l'aide de ces deux commades : vacuum full msdelivery; reidex table msdelivery; vacuum full msdeliverystat; reidex table msdeliverystat; vacuum full xtkworkflow; reidex table xtkworkflow; vacuum full xtkworkflowevet; reidex table xtkworkflowevet; vacuum full xtkworkflowjob; reidex table xtkworkflowjob; vacuum full xtkworkflowlog; reidex table xtkworkflowlog; vacuum full xtkworkflowtask; reidex table xtkworkflowtask; vacuum full xtkjoblog; reidex table xtkjoblog; vacuum full xtkjob; reidex table xtkjob; vacuum full msaddress; reidex table msaddress; vacuum full msdeliverypart; reidex table msdeliverypart; vacuum full msmirrorpageifo; reidex table msmirrorpageifo; Neolae v6.0 - Guide d'exploitatio - Maiteace de la base de doées 59

61 Neolae Note : Nous vous coseillos de commecer la maiteace par les tables de petite taille. Si l'opératio de maiteace devait échouer sur les tables volumieuses (ce qui est davatage le cas que sur les petites tables), ue partie de la maiteace serait déjà assurée. Prévoyez égalemet la maiteace des tables spécifiques à votre modèle de doées, otammet celles qui subisset des mises à jour massives. Par exemple, cela peut être le cas pour NmsRecipiet si vous procédez chaque jour à d'importates réplicatios de doées. Les commades vacuum et reidex verrouillet la table ce qui met certais processus e attete pedat toute la durée de la maiteace. La commade vacuum full 'est pas efficace sur les tables très volumieuses (supérieures à 5Go) et peut predre beaucoup de temps. Nous vous décoseillos doc de l'utiliser pour la table YyyNmsBroadLogXxx. Cette opératio de maiteace peut être effectuée par u workflow de Neolae via ue activité de type SQL (voir à ce sujet le guide Workflows). Assurez-vous de lacer la maiteace pedat ue période de faible activité et e dehors des périodes de sauvegarde. Recostruire ue base Il 'existe pas de faço simple d'effectuer ue défragmetatio à chaud d'ue base e PostgreSQL du fait que la commade vacuum full verrouille la table. Il est doc écessaire de lacer sa maiteace lorsque la table 'est pas utilisée. Vous pouvez, au choix : effectuer la maiteace lorsque la plateforme Neolae est arrêtée, arrêter les processus Neolae susceptibles d'écrire das la table qui est e cours de recostructio (par exemple lserver stop wfserver@ om_de_l'istace pour arrêter le processus de workflow). Voici u exemple de défragmetatio de table à l'aide de foctios qui permettet de géérer le lagage de défiitio de doées (LDD) voulu. La requête SQL suivate permet de créer deux ouvelles foctios : GeRebuildTablePart1 et GeRebuildTablePart2 qui peuvet être utilisées pour géérer le LDD destié à recréer ue table. La première foctio permet de créer ue table temporaire ( _tmp das otre exemple) qui est ue copie de la table d'origie. La deuxième foctio supprime la table d'origie et reomme la table temporaire et ses idex comme celle d'origie. L'utilisatio de deux foctios au lieu d'ue permet d'éviter de supprimer défiitivemet la table d'origie au cas où la première foctio échouerait Geerate the CREATE TABLE DDL for a table create or replace fuctio GeTableDDL(text) returs text as $$ declare vstrtable text; vrecfld RECORD; vstrddl text; vstrfields text; vstrnstable text; vstrtablespace text; begi vstrtable = lower($1); vstrddl = ; SELECT pg_catalog.quote_idet(.spame) '.' pg_catalog.quote_idet(c.relame), pg_catalog.quote_idet(t.spcame) INTO vstrnstable, vstrtablespace FROM pg_amespace, pg_class c left outer joi pg_tablespace t o c.reltablespace = t.oid WHERE.oid = c.relamespace AND c.relame = vstrtable; vstrddl = 'CREATE TABLE ' vstrnstable '_tmp('; 60 Neolae 2013

62 Maiteace de la base de doées vstrfields = ; FOR vrecfld IN SELECT pg_catalog.quote_idet(a.attame) ' ' t.typame case whe t.typame='varchar' the '(' cast(a.atttypmod-4 as text) ')' whe t.typame='umeric' the '(' cast((a.atttypmod-4)/65536 as text) ',' cast((a.atttypmod-4)%65536 as text) ')' else ed case whe a.attotull the ' ot ull' else ed case whe a.atthasdef the ' default ' d.adsrc else ed as DDL FROM pg_type t, pg_class c, pg_attribute a LEFT OUTER JOIN pg_attrdef d ON d.adrelid=a.attrelid ad d.adum=a.attum WHERE a.attum > 0 AND a.attrelid = c.oid AND t.oid = a.atttypid AND c.relame = vstrtable ORDER BY a.attum LOOP IF vstrfields <> THEN vstrfields = vstrfields ',' chr(10) ' '; ELSE vstrfields = vstrfields chr(10) ' '; END IF; vstrfields = vstrfields vrecfld.ddl; END LOOP; vstrddl = vstrddl vstrfields chr(10) ')'; if vstrtablespace <> the vstrddl = vstrddl ' TABLESPACE ' vstrtablespace; ed if; vstrddl = vstrddl ';' chr(10); retur vstrddl; END; $$ LANGUAGE plpgsql; Geerate the CREATE INDEX DDL for a table create or replace fuctio GeIdexDDL(text) returs text as $$ declare vstrtable text; vrecidex RECORD; vstrddl text; vifld iteger; vstrfld text; begi vstrtable = lower($1); vstrddl = ; FOR vrecidex IN SELECT i.idkey, i.idisuique, pg_catalog.quote_idet(c.relame) as tableame, pg_catalog.quote_idet(ic.relame) as idexame, pg_catalog.quote_idet(t.spcame) as tablespace FROM pg_class c, pg_idex i, pg_class ic left outer joi pg_tablespace t o ic.reltablespace = t.oid WHERE i.idexrelid = ic.oid AND i.idrelid = c.oid AND c.relame = vstrtable LOOP Neolae v6.0 - Guide d'exploitatio - Maiteace de la base de doées 61

63 Neolae vstrddl = vstrddl 'CREATE '; if vrecidex.idisuique the vstrddl = vstrddl 'UNIQUE '; ed if; vstrddl = vstrddl 'INDEX ' vrecidex.idexame '_tmp ON ' vrecidex.tableame '_tmp('; LOOP FOR vifld IN array_lower(vrecidex.idkey, 1).. array_upper(vrecidex.idkey, 1) SELECT pg_catalog.quote_idet(a.attame) INTO vstrfld FROM pg_attribute a, pg_class c WHERE a.attum = vrecidex.idkey[vifld] AND a.attrelid = c.oid AND c.relame=vstrtable; vstrddl = vstrddl vstrfld; if vifld <> array_upper(vrecidex.idkey, 1) the vstrddl = vstrddl ', '; ed if; END LOOP; vstrddl = vstrddl ')'; if vrecidex.tablespace <> the vstrddl = vstrddl 'TABLESPACE ' vrecidex.tablespace; ed if; vstrddl = vstrddl ';' chr(10); END LOOP; retur vstrddl; END; $$ LANGUAGE plpgsql; Geerate the ALTER INDEX RENAME for a table create or replace fuctio GeReameIdexDDL(text) returs text as $$ declare vstrtable text; vrecidex RECORD; vstrddl text; begi vstrtable = lower($1); vstrddl = ; FOR vrecidex IN SELECT pg_catalog.quote_idet(.spame) as amespace, pg_catalog.quote_idet(ic.relame) as idexame FROM pg_amespace, pg_class c, pg_idex i, pg_class ic WHERE i.idexrelid = ic.oid AND.oid = ic.relamespace AND i.idrelid = c.oid AND c.relame = vstrtable LOOP vstrddl = vstrddl 'ALTER INDEX ' vrecidex.amespace '.' vrecidex.idexame END LOOP; retur vstrddl; END; $$ LANGUAGE plpgsql; '_tmp RENAME TO ' vrecidex.idexame ';' chr(10); 62 Neolae 2013

64 Maiteace de la base de doées Build a copy of a table, with idex create or replace fuctio GeRebuildTablePart1(text) returs text as $$ declare vstrtable text; vstrtmp text; vstrddl text; begi vstrtable = lower($1); vstrddl = ; SELECT GeTableDDL(vstrTable) INTO vstrtmp; vstrddl = vstrddl vstrtmp chr(10); vstrddl = vstrddl 'INSERT INTO ' vstrtable '_tmp SELECT * FROM ' vstrtable ';' chr(10); SELECT GeIdexDDL(vstrTable) INTO vstrtmp; vstrddl = vstrddl vstrtmp chr(10); vstrddl = vstrddl 'VACUUM ANALYSE ' vstrtable '_tmp;' chr(10); retur vstrddl; ed; $$ LANGUAGE plpgsql; Drop the origial table ad reame the copy create or replace fuctio GeRebuildTablePart2(text) returs text as $$ declare vstrtable text; vstrtmp text; vstrddl text; begi vstrtable = lower($1); vstrddl = 'DROP TABLE ' vstrtable ';' chr(10); vstrddl = vstrddl 'ALTER TABLE ' vstrtable '_tmp RENAME TO ' vstrtable ';' chr(10); SELECT GeReameIdexDDL(vstrTable) INTO vstrtmp; vstrddl = vstrddl vstrtmp chr(10); retur vstrddl; ed; $$ LANGUAGE plpgsql; L'exemple qui suit peut être utilisé das u workflow pour recostruire les tables requises plutôt que d'utiliser la commade vacuum/rebuild : fuctio sqlgetmemo(strsql) { var res = sqlselect("s, m:memo", strsql); retur res.s.m.tostrig(); } fuctio RebuildTable(strTable) { // Rebuild a table_tmp var strsql = sqlgetmemo("select GeRebuildTablePart1('"+strTable+"')"); logifo("rebuildig table '"+strtable+"'..."); // logifo(strsql); sqlexec(strsql); // If fails, there is a exceptio throw ad so we do ot delete the origial table strsql = sqlgetmemo("select GeRebuildTablePart2('"+strTable+"')"); logifo("swappig table '"+strtable+"'..."); //logifo(strsql); Neolae v6.0 - Guide d'exploitatio - Maiteace de la base de doées 63

65 Neolae sqlexec(strsql); } RebuildTable('msrecipiet'); RebuildTable('msrcpgrlrel'); //... other tables here Oracle Réduire le volume des tables et des idex Cette opératio peut être effectuée à l'aide de l'optio shrik space dispoible avec la commade alter table/idex. Vous devez d'abord activer l'optio row movemet pour chaque table comme décrit ci-après : alter table msdelivery eable row movemet; alter table msdeliverystat eable row movemet; alter table xtkworkflow eable row movemet; alter table xtkworkflowevet eable row movemet; alter table xtkworkflowjob eable row movemet; alter table xtkworkflowlog eable row movemet; alter table xtkworkflowtask eable row movemet; alter table xtkjoblog eable row movemet; alter table xtkjob eable row movemet; alter table msaddress eable row movemet; alter table msdeliverypart eable row movemet; alter table msmirrorpageifo eable row movemet; Toutes versios cofodues à partir de Neolae 5.10, versios 6 icluses alter table msbroadlogrcp eable row movemet; alter table msbroadlogmid eable row movemet; alter table msbroadlogmsg eable row movemet; alter table ms errorstat eable row movemet; Note : Si la commade eable row movemet échoue, vous devez supprimer toutes les sessios Oracle qui utiliset la table. Coectez-vous e tat que system et exécutez la commade suivate : As system: alter system kill sessio 'sid,serial#'; Vous pouvez esuite compacter les tables comme décrit ci-après : alter table msdelivery shrik space compact; alter table msdelivery shrik space; alter table msdeliverystat shrik space compact; alter table msdeliverystat shrik space; alter table xtkworkflow shrik space compact; alter table xtkworkflow shrik space; alter table xtkworkflowevet shrik space compact; alter table xtkworkflowevet shrik space; alter table xtkworkflowjob shrik space compact; alter table xtkworkflowjob shrik space; alter table xtkworkflowlog shrik space compact; alter table xtkworkflowlog shrik space; alter table xtkworkflowtask shrik space compact; alter table xtkworkflowtask shrik space; alter table xtkjoblog shrik space compact; alter table xtkjoblog shrik space; alter table msaddress shrik space compact; alter table msaddress shrik space; 64 Neolae 2013

66 Maiteace de la base de doées alter table msmirrorpageifo shrik space compact; alter table msmirrorpageifo shrik space; alter table msdeliverypart shrik space compact; alter table msdeliverypart shrik space; Toutes versios cofodues à partir de Neolae 5.10, versios 6 icluses alter table msbroadlogrcp shrik space compact; alter table msbroadlogrcp shrik space; alter table msbroadlogmid shrik space compact; alter table msbroadlogmid shrik space; alter table msbroadlogmsg shrik space compact; alter table msbroadlogmsg shrik space; alter table ms errorstat shrik space compact; alter table ms errorstat shrik space; Faites de même pour les idex comme décrit ci-après (vous devez adapter le om des tables e foctio de votre modèle de doées) : alter idex NMSBROADLOGRCP_LASTMODIFIED shrik space compact; alter idex NMSBROADLOGRCP_LASTMODIFIED shrik space;... Note : Si vous utilisez la versio Etreprise d'oracle, vous pouvez aussi recostruire les idex avec la commade alter idex xxx rebuild olie. DB2 Veuillez cosulter votre admiistrateur de base de doées pour coaître les procédures les mieux adaptées à votre versio de DB2. SQL Server L'exemple préseté das cette sectio cocere SQL Server Si vous utilisez SQL Server 2008, cotactez l'admiistrateur de base de doées pour coaître les procédures de maiteace de cette versio. Si vous utilisez Microsoft SQL Server 2005, vous pouvez effectuer ue grade partie de la maiteace à l'aide de l'assistat mis à dispositio das ce SGBDR. 1 Coectez-vous à Microsoft SQL Server Maagemet Studio avec u idetifiat auquel ot été attribués des droits admiistrateur. 2 Cliquez avec le bouto droit de la souris sur le dossier Gestio>Plas de maiteace et sélectioez Assistat Pla de maiteace das le meu cotextuel. Neolae v6.0 - Guide d'exploitatio - Maiteace de la base de doées 65

67 Neolae 3 Cliquez sur Suivat lorsque la page d'accueil s'affiche. 4 Choisissez le type de pla de maiteace que vous souhaitez créer (exécutio de la maiteace e ue fois ou créatio d'u pla pour chaque tâche de maiteace), puis cliquez sur Modifier. 66 Neolae 2013

68 Maiteace de la base de doées 5 Das la feêtre Propriétés de la plaificatio du travail, choisissez les paramètres d'exécutio voulus et cliquez sur OK puis sur Suivat. 6 Sélectioez les tâches de maiteace à effectuer comme illustré ci-dessous puis cliquez sur Suivat. Note : Nous vous coseillos d'effectuer au mois les tâches de maiteace comme illustré ci-dessus. Vous pouvez égalemet sélectioer la tâche de mise à jour des statistiques si vous le souhaitez, sachat que cette tâche est déjà effectuée par le workflow de ettoyage de la base (voir Descriptio du workflow Nettoyage de la base [page 34]). Neolae v6.0 - Guide d'exploitatio - Maiteace de la base de doées 67

69 Neolae 7 Das la liste déroulate, sélectioez la base sur laquelle vous souhaitez effectuer la tâche Vérifier l'itégrité de la base de doées. 8 Sélectioez la base cocerée et cliquez sur OK puis Suivat. 68 Neolae 2013

70 Maiteace de la base de doées 9 Cofigurez la taille maximale allouée à votre base de doées puis cliquez sur Suivat. Note : Si la taille de la base devait dépasser la limite fixée, le système de maiteace essaiera de détruire les doées o-utilisées pour libérer de l'espace-disque. 10 Effectuez ue réorgaisatio ou ue recostructio de l'idex : Si le taux de fragmetatio de l'idex est compris etre 10% et 40%, il est recommadé d'effectuer ue réorgaisatio : Choisissez la base de doées et les objets (tables ou vues) dot vous voulez réorgaiser l'idex puis cliquez sur Suivat. Neolae v6.0 - Guide d'exploitatio - Maiteace de la base de doées 69

71 Neolae Note : Selo votre cofiguratio vous e pourrez sélectioer que les tables sélectioées précédemmet ou la totalité des tables de votre base de doées. Si le taux de fragmetatio de l'idex est supérieur à 40%, il est recommadé d'effectuer ue recostructio : Choisissez les optios de la tâche de recostructio de l'idex puis cliquez sur Suivat. Note : Le processus de recostructio de l'idex est plus cotraigat e termes d'utilisatio du processeur et verrouille les ressources de la base de doées. Cochez l'optio Keep idex olie while reidexig (Coserver l'idex e lige lors de la réidexatio) si vous souhaitez que l'idex soit dispoible pedat la recostructio. 70 Neolae 2013

72 Maiteace de la base de doées 11 Choisissez les optios du rapport d'activité des tâches de maiteace puis cliquez sur Suivat. 12 Vérifiez la liste des tâches du pla de maiteace puis cliquez sur Termier. Neolae v6.0 - Guide d'exploitatio - Maiteace de la base de doées 71

73 Neolae L'état d'avacemet du pla de maiteace et le statut des différetes étapes s'affiche à l'écra. 13 Lorsque le pla de maiteace est arrivé à so terme, cliquez sur Fermer. 14 Das l'explorateur de SQL Server, double-cliquez sur le dossier Gestio>Plas de maiteace. 72 Neolae 2013

74 Maiteace de la base de doées 15 Sélectioez le pla de maiteace de Neolae : les différetes étapes sot présetées sous la forme d'u workflow. Vous remarquerez qu'u objet a été créé das le dossier SQL Server Aget>Travaux. Cet objet permet de lacer le pla de maiteace. Das otre exemple il 'y a qu'u seul objet car toutes les tâches de maiteace fot partie du même pla de maiteace. Avertissemet : Pour que cet objet puisse s'exécuter, l'aget SQL Server doit être activé. MySQL Utiliser la commade OPTIMIZE TABLE La commade OPTIMIZE TABLE peut être utilisée avec MySQL 5.0 et 5.1. Cepedat, lorsqu'elle est utilisée sur des tables IoDb (ce qui est le cas avec Neolae), so actio est limitée : e sot mises à jour que les statistiques des idex et libère l'espace-disque o-utilisé das le cluster d'idex. Les idex et les tables e sot pas recostruits (voir à ce sujet cette commade verrouille la table ce qui exclut de la lacer lorsque la table est utilisée. Ceci suppose que les opératios de maiteace soiet effectuées e période de faible activité ou lorsque la plateforme Neolae est éteite (avec le risque que certaies opératios 'arrivet pas à leur terme). Neolae v6.0 - Guide d'exploitatio - Maiteace de la base de doées 73

75 Neolae U premier iveau de maiteace peut cosister à lacer la commade OPTIMIZE TABLE sur les tables trasactioelles toutes les deux semaies puis progressivemet toutes les semaies pour les tables les plus utilisées comme idiqué ci-dessous : OPTIMIZE TABLE NmsDelivery; OPTIMIZE TABLE NmsDeliveryStat; OPTIMIZE TABLE XtkWorkflow; OPTIMIZE TABLE XtkWorkflowEvet; OPTIMIZE TABLE XtkWorkflowJob; OPTIMIZE TABLE XtkWorkflowLog; OPTIMIZE TABLE XtkWorkflowTask; OPTIMIZE TABLE XtkJobLog; OPTIMIZE TABLE XtkJob; OPTIMIZE TABLE NmsBroadLogMsg; OPTIMIZE TABLE Nms ErrorStat; OPTIMIZE TABLE NmsAddress; OPTIMIZE TABLE NmsDeliveryPart; OPTIMIZE TABLE NmsMirrorPageIfo; Défragmeter les tables Vous pouvez effectuer ue défragmetatio via ue opératio de Sauvegarde/Restauratio sur les tables cocerées à l'aide d'u script shell comme das l'exemple ci-dessous (à utiliser pour chaque table) : /etc/iit.d/lserver6 stop mysqldump database_ame NmsDelivery > NmsDelivery.sql mysql database_ame < NmsDelivery.sql... /etc/iit.d/lserver6 start Note : Cette opératio doit être effectuée lorsque la plateforme Neolae est éteite afi d'éviter tout risque de perte de doées. Reportez-vous égalemet à la page pour plus d'iformatios. Vous pouvez égalemet utiliser la commade ALTER TABLE comme illustré ci-dessous : ALTER TABLE NmsRecipiet ENGINE=IoDB; ALTER TABLE NmsDeliveryStat ENGINE=IoDB; ALTER TABLE XtkWorkflow ENGINE=IoDB; ALTER TABLE XtkWorkflowEvet ENGINE=IoDB; ALTER TABLE XtkWorkflowJob ENGINE=IoDB; ALTER TABLE XtkWorkflowLog ENGINE=IoDB; ALTER TABLE XtkWorkflowTask ENGINE=IoDB; ALTER TABLE XtkJobLog ENGINE=IoDB; ALTER TABLE XtkJob ENGINE=IoDB; ALTER TABLE NmsBroadLogMsg ENGINE=IoDB; ALTER TABLE Nms ErrorStat ENGINE=IoDB; ALTER TABLE NmsAddress ENGINE=IoDB; ALTER TABLE NmsDeliveryPart ENGINE=IoDB; ALTER TABLE NmsMirrorPageIfo ENGINE=IoDB; Cette commade peut être lacée lorsque le système est actif mais du fait du verrouillage de ombreuses tables pourrait empêcher certaies opératios d'aboutir. Nous vous coseillos doc de le faire pedat des périodes de faible activité. 74 Neolae 2013

76 CHAPITRE 6 E cas de problème Table des matières Fichiers temporaires Performaces de la base Cofiguratio matérielle Cofiguratio de la plateforme Maiteace de la base de doées Cas particuliers Modules et problèmes courats Précisio des logs Remotée des logs de trackig OpeOffice Evoi des s Exécutio des workflows Coexio impossible Seuil de coexios Dr Watso sous Widows XP (cliet) Stack trace sous Liux Ecodage de la base de doées Oracle Réactivatio de la demade de mise à jour de la cosole Perte de mot de passe Comportemet aormal des JSP Ce chapitre liste des erreurs fréquetes aisi que leur mode de résolutio. Fichiers temporaires Si, lorsque vous lacez le système e productio, vous obteez des messages d'erreur (otammet das les jouraux de diffusio), tels que: Uable to reame file '/tmp/tmp0000.tmp' to /usr/local/eolae/l6/bi/..//var/xxx/mta/ xml ;(erro=18, Ivalid cross-device lik) (irc=-52) La cause est la suivate : Neolae géère des fichiers temporaires sous /tmp, puis les reomme pour les déplacer sous /usr/local/eolae/l6/var. Cette erreur se produit lorsque les deux dossiers (/tmp et /usr/local/eolae/l6/var, qui est e fait u lie symbolique vers /var/l6) correspodet à des devices différets. La commade df permet de le vérifier. Neolae v6.0 - Guide d'exploitatio - E cas de problème 75

77 Neolae Pour corriger ce problème, les fichiers temporaires doivet être géérés das le même device que la destiatio. Par exemple e exécutat : $ cd ~/l6/var $ mkdir tmp $ vi ~/l6/customer.sh puis e ajoutat : export TMPDIR=/usr/local/eolae/l6/var/tmp Performaces de la base La plupart des problèmes de performace sot liés à l'etretie de la base de doées. Nous vous proposos quatre axes de recherche pour vous aider à e trouver les causes : la cofiguratio matérielle, l'istallatio et la cofiguratio de la plateforme Neolae, la maiteace de la base de doées, le diagostic e temps réel. Cofiguratio matérielle Vous devez vérifier que la cofiguratio iitiale de la plateforme Neolae est toujours valable et revoir, le cas échéat, les besois de votre cliet e termes de délivrabilité ou de taille de la base. Nous vous coseillos d'effectuer égalemet ue vérificatio complète de la cofiguratio matérielle (CPU, RAM, Système E/S). Cofiguratio de la plateforme Ue mauvaise cofiguratio peut affecter les performaces de la plateforme. Nous vous coseillos de vérifier, etre autre, la cofiguratio réseau, les optios de délivrabilité de la plateforme et le paramétrage des MTA das le fichier servercof.xml. Maiteace de la base de doées Tâche de ettoyage de la base Vous devez vérifier que la tâche de ettoyage de la base foctioe correctemet. Pour cela, cosultez les fichiers jouraux afi d'être sûr qu'ils e cotieet pas d'erreurs. Reportez-vous à la sectio Descriptio du workflow Nettoyage de la base [page 34] pour plus d'iformatios. Plas de maiteace Vous devez vous assurer que la maiteace de la base de doées est correctemet plaifiée et effectuée. Pour cela, reseigez-vous auprès de votre admiistrateur de base de doées pour coaître : so plaig de maiteace, les plas de maiteace déjà exécutés, cosulter les logs des scripts. Avertissemet : Si vous utilisez ue cofiguratio e mid-sourcig, il est importat que les bases de doées soiet correctemet maiteue. Lors de l'aalyse d'ue diffusio sur la plateforme marketig, l'istace marketig evoie des iformatios vers l'istace mid-sourcig. Si le processus raletit, l'activité de l'istace marketig raletira égalemet afi que l'istace de mid-sourcig puisse effectuer ses opératios correctemet. Reportez-vous au chapitre Maiteace de la base de doées [page 53] pour plus d'iformatios. 76 Neolae 2013

78 E cas de problème Gestio des tables temporaires Vous devez vérifier le ombre et la taille des tables temporaires. Lorsqu'elles devieet trop volumieuses, les performaces de la base sot affectées. Ces tables sot créées otammet par les workflows et les diffusios. Elles e disparaisset pas de la base tat que le traitemet des workflows et des diffusios 'est pas termié ou qu'ils 'ot pas été iterrompus ou supprimés. Pour limiter les tables temporaires vous pouvez effectuer les opératios suivates : arrêter ou supprimer les diffusios dot le statut est, au choix, E échec, E cours, Prête à être diffusée, ou E pause. arrêter ou supprimer les workflows qui sot e pause à cause d'ue erreur, arrêter les workflows utilisés pour faire des tests, qui e cotieet pas d'activité Fi et dot le statut est, de ce fait, E pause. Avertissemet : Si cette opératio pred beaucoup de temps et qu'ue fois effectuée, beaucoup d'espace-disque est libéré, il est idispesable d'effectuer ue maiteace e profodeur (recostructio des idex, etc.). Voir à ce sujet le chapitre Maiteace de la base de doées [page 53]. Surveillace des processus Neolae Selo les paramètres d'istallatio de Neolae, vous avez deux outils à votre dispositio pour effectuer la surveillace de votre plateforme : la page d'exploitatio de l'istace. Voir à ce sujet la sectio Surveillace mauelle [page 15]. le script etreport. Voir à ce sujet la sectio Surveillace automatique via les scripts de Neolae [page 24]. Cas particuliers Il peut être écessaire d'effectuer u diagostic e temps-réel pour détermier la cause du problème. Vous devez d'abord vérifier les fichiers jouraux des processus et de la plateforme. Puis, surveillez l'activité de la base lors de la reproductio du problème. Vous devez particulièremet porter votre attetio sur les élémets suivats : le pla d'exécutio de la maiteace, les requêtes SQL e cours d'exécutio, si des processus exteres s'exécutet e même temps (ettoyage, import, calcul d'agrégats, etc.). Modules et problèmes courats Voici ue liste des modules cocerés par des problèmes courats : Module export import imail mta stat ruwf syslogd trackig Périmètre d'exécutio Exécutio d'u traitemet d'export Exécutio d'u traitemet d'import Lecture de la boîte de mails rebods Effectue les evois d' Maitiet les statistiques des coexios des MTA Exécutio d'ue istace de workflow Ecriture des logs Cosolidatio et récupératio des logs de trackig E cas de problème L'opérateur qui a programmé cet export doit le relacer. Possibilité de delta ou relace complète. L'opérateur qui a programmé cet import doit le relacer. Vérificatio de o isertio de doublo das la base de doées. Vérifier ce module lorsque les mails rebods e remotet plus. Vérifier ce module lorsque les mails e partet plus. Vérifier ce module lorsque les mails e partet plus. E cas de problème, relacer ce module. Au besoi, appliquer la procédure pour augmeter la précisio des logs décrite das la sectio Précisio des logs [page 78]. E cas d'absece de logs das les fichiers de log : vérifier si le module utilise bie le port Voir Liste des ports ouverts [page 6]. Vérifier ce module lorsque les logs de trackig e remotet plus. Neolae v6.0 - Guide d'exploitatio - E cas de problème 77

79 Neolae Module trackiglogd watchdog web wfserver Périmètre d'exécutio Serveur d'écriture et de purge des logs de trackig Module de démarrage et surveillace Serveur applicatif (HTTP et SOAP) Serveur de workflows E cas de problème Vérifier ce module lorsque les logs de trackig e remotet plus et qu'il 'y a aucue trace de logs das les fichiers sur le serveur. Voir Remotée des logs de trackig [page 79]. Vérifier ce module si aucu processus e démarre. Vérifier ce module si les coexios cosole et web e marchet pas et provoquet ue erreur de type xtk:sessio. Vérifier ce module si les workflows e s'exécutet pas. Précisio des logs Pour augmeter la précisio des logs, vous pouvez appliquer cette procédure à tous les modules Neolae. Elle cosiste à relacer les processus avec u iveau de logs supérieur. Avertissemet : Cette procédure aule les services e cours sur ce module. Neolae peut foctioer sous deux iveaux de logs : 1 Le mode Verbose, premier iveau après le iveau stadard. Pour l'activer, la commade est la suivate : lserver restart <NOM_MODULE> -verbose Vérifiez que l'erreur s'est bie produite, puis relacez le processus ormalemet : lserver restart <NOM_MODULE> -ocosole 2 Le mode TraceFilter, qui permet d'eregistrer le maximum de logs. Pour l'activer, la commade est la suivate : lserver stop <NOM_MODULE>; lserver <NOM_MODULE> -verbose -tracefilter:* Note : Si vous utilisez tracefilter:*, tous les types de logs sot activés : cm, rdr, ms, jst, timig, wdbc, ldap, soap, xtk, xtkquery, sessio, xtkwriter, etwork, pop3, imail Les types de logs les plus utiles sot les suivats : wdbc (affiche toutes les requêtes SQL), soap (affiche tous les appels SOAP), ldap (affiche toutes les requêtes LDAP lors de l'authetificatio), xtkquery (affiche la liste de toutes les querydef). Il est possible de les utiliser uitairemet (par exemple : tracefilter:soap,wdbc). Vous pouvez aussi tous les activer et choisir d'e exclure certais : -tracefilter:*,!soap Vérifiez que l'erreur s'est bie produite, puis relacez le processus ormalemet : lserver restart <NOM_MODULE> -ocosole Avertissemet : Les logs de ces commades sot stockés das le fichier de log du module. Voici u exemple spécifique au module Web. Les autres modules foctioet comme idiqués ci-dessus. Avat de lacer cette commade, vérifiez qu'aucu processus e cours e peut être impacté. lserver pdump -who Puis arrêtez et redémarrez le module e mode TraceFilter. lserver stop web; LD_PRELOAD=libjsig.so lserver web -tomcat -verbose -tracefilter:* -tracefile:web_debug@default 78 Neolae 2013

80 E cas de problème Autre exemple : lserver stop mta@<nom_instance>; lserver mta -istace:<nom_instance> -tracefilter:* -tracefile:mta_debug@<nom_instance> Note : Le mode Tracefile permet d'eregistrer les logs. Das les exemples ci-dessus, les logs sot eregistrés das les fichiers var/<nom_instance>/mta_debug.log et var/default/web_debug.log. Avertissemet : Sous Widows, vous e devez pas ajouter l'optio LD_PRELOAD. La commade suivate suffit : lserver web -tomcat -verbose -tracefilter:* Vérifiez que le problème se reproduit, puis relacez le module : lserver restart web -tomcat -ocosole Toutes les iformatios sot dispoibles das le fichier /usr/local/eolae/l6/var/default/log/web.log. Remotée des logs de trackig Lorsque les logs de trackig e remotet pas, les causes peuvet être multiples. Nous vous recommados de vérifier les iformatios suivates : Le workflow Trackig est-il e erreur? Le module trackiglogd est-il démarré sur la machie? Des modificatios réseau ot-elles eu lieu? Elles peuvet provoquer la perte de coexio aux serveurs e utilisat l'alias de trackig. Neolae v6.0 - Guide d'exploitatio - E cas de problème 79

81 Neolae OpeOffice Lorsque le message d'erreur semble idiquer que la coexio au serveur OpeOffice.org a échoué, ous vous recommados de valider les poits suivats : Vérifiez la boe cofiguratio d'opeoffice.org. Pour cela, lacez-le ue fois mauellemet, sous u compte avec les droits admiistrateur sous Widows, ou sous le compte de l'utilisateur Neolae sous Liux. Sous Widows, vérifiez que le service Neolae peut iteragir avec le Bureau. Pour cela, ouvrez la liste des services Widows et éditez les propriétés du service Neolae, puis allez sur l'oglet Coexio et cochez l'optio Autoriser le système à iteragir avec le Bureau. Voir à ce propos la sectio correspodate du Guide d'istallatio. Evoi des s Si les messages de vos campages s e partet pas et restet das u état E attete, il est possible que le module MTA e soit pas lacé. Pour le vérifier, puis au besoi le lacer, les étapes sot les suivates : 1 Vérifiez que vos modules mta@<istace> sot bie lacés sur vos serveurs MTA. lserver pdump 11:00:39 > Serveur applicatif pour Neolae Versio 6.X (build XXXX) du JJ/MM/AAAA [...] mta@<nominstance> (9268) Mo [...] 2 Si le MTA 'est pas listé, démarrez-le via la commade suivate : lserver start mta@<nominstance> Note : Remplacez <NOMINSTANCE> par le om de votre istace (prod / dev / etc.). Le om de l'istace peut être idetifié par les fichiers de cofiguratio : [chemi de l'applicatio]l6/cof/cofig-<nominstance>.xml Exécutio des workflows Si les workflows e s'exécutet pas et restet das u état Démarrage e cours, il se peut que le module de workflow e soit pas lacé. Pour le vérifier, puis au besoi le lacer, les étapes sot les suivates : 1 Vérifiez que vos modules wfserver@<istace> sot bie lacés sur votre serveur applicatif pricipal. lserver pdump 11:00:39 > Serveur applicatif pour Neolae Versio 6.X (build XXXX) du JJ/MM/AAAA [...] wfserver@<nominstance> (9340) Mo [...] 2 Si le serveur de workflow 'est pas listé, démarrez-le via la commade suivate : lserver start wfserver@<nominstance> 80 Neolae 2013

82 E cas de problème Note : Remplacez <NOMINSTANCE> par le om de votre istace (prod / dev / etc.). Le om de l'istace peut être idetifié par les fichiers de cofiguratio : [chemi de l'applicatio]l6/cof/cofig-<nominstance>.xml Coexio impossible Si vous 'arrivez plus à vous coecter à votre istace Neolae, les causes peuvet être multiples : de ombreux cotextes peuvet poser problème. Vérifiez les iformatios suivates : 1 Vérificatios du réseau Avez-vous accès à iteret depuis votre ordiateur? Vérifiez que vous pouvez vous coecter à des sites sur Iteret (par exemple). Si vous e pouvez pas vous coecter, il s'agit d'u problème sur votre machie : cotactez votre admiistrateur système. Pouvez-vous vous coecter sur le serveur hébergeat Neolae par u autre service? Coectez-vous e SSH ou tout autre moye sur le serveur. E cas d'impossibilité, il y a u problème réseau chez votre hébergeur, cotactez leur admiistrateur réseau. 2 Vérificatios côté serveur Web (IIS/apache/etc.) Le serveur Web répod-t-il? Coectez-vous à l'url d'accès du serveur Neolae à l'aide d'u avigateur Web : http(s)://<urlserver>. S'il e répod pas alors le serveur web est arrêté sur la machie. Cotactez l'admiistrateur système de votre hébergeur afi de relacer le service. L'itégratio Neolae est-elle bie effectuée? Coectez-vous à l'url : http(s)://<urlserver>/r/test. Le serveur doit vous revoyer u message du type : <redir status='ok' date='aaaa/mm/jj HH:MM:SS' build='xxxx' host='support.eolae.et' localhost='server'/> Si vous 'obteez pas ce résultat, vérifiez das la cofiguratio de votre serveur Web que l'itégratio est bie prise e compte. Pour plus d'iformatios sur cette procédure, reportez-vous au Guide d'istallatio. 3 Vérificatios côté Neolae Le module Web Neolae est-il bie lacé? Coectez-vous à l'url : http(s)://<urlserver>/l/jsp/logo.jsp Si vous obteez ue erreur Tomcat Java : L'itégratio JAVA est-elle correctemet effectuée? Neolae requiert u JDK SUN pour foctioer. So itégratio se fait das le fichier [chemi de l'applicatio]/l6/customer.sh Si vous obteez ue page blache : Le module Web de Neolae est-il bie démarré? Vous devez obteir : lserver pdump 11:00:39 > Serveur applicatif pour Neolae Versio 6.X (build XXXX) du JJ/MM/AAAA [...] web@default (27515) Mo [...] Sio, relacez-le e utilisat la commade suivate : lserver start web Neolae v6.0 - Guide d'exploitatio - E cas de problème 81

83 Neolae Note : orsque vous affichez la liste des modules Neolae et que vous obteez ue répose du type : lserver pdump 11:00:39 > Serveur applicatif pour Neolae Versio 6.X (build XXXX) du JJ/MM/AAAA No tasks Vous devez relacer l'esemble de l'applicatio Neolae. Pour cela, les commades sot les suivates : Si vous avez u accès root ou admiistrateur : Sous Liux : /etc/iit.d/lserver6 start Sous Widows : et start lserver6 Sio, das le compte Neolae : lserver watchdog -svc -ocosole Seuil de coexios Pour des serveurs soumis à de fortes charge, il se peut que le seuil de coexios soit dépassé. Das tous les cas, il est utile d'e coaître la raiso. Il existe trois seuils différets : 1 Le seuil de coexios Web, paramétré das votre serveur web. Pour le modifier, cotactez votre admiistrateur système. 2 Le seuil de coexios base de doées. Pour le modifier, cotactez votre admiistrateur de base de doées. 3 Le seuil de coexios Neolae, dispoible à deux edroits : 1 Côté Tomcat : esemble des requêtes arrivat effectivemet sur le cliet Tomcat Neolae. Ce seuil est paramétré das le fichier l6/tomcat-6/cof/server.xml. L'attribut maxprocessors permet d'augmeter le seuil des requêtes traitées simultaémet. Il peut être augmeté à 250, par exemple : <Coector classname="org.apache.coyote.tomcat6.coyotecoector" port="8080" miprocessors="5" maxprocessors="75" eablelookups="true" redirectport="8443" acceptcout="100" debug="0" coectiotimeout="20000" useurivalidatiohack="false" disableuploadtimeout="true" /> <!-- Note : To disable coectio timeouts, set coectiotimeout value to -1 --> </Coector> 2 Côté base de doées : esemble des coexios ouvertes simultaémet sur la base de doées. Ce seuil est paramétré das le fichier l6/cof/servercof.xml. L'attribut pool situé das datasource permet d'augmeter le seuil des requêtes traitées simultaémet. Il peut être augmeté à 90, par exemple : <pool alivetestdelaysec="600" freecx="0" maxcx="90" maxidledelaysec="1200"/> Dr Watso sous Widows XP (cliet) L'utilitaire Dr Watso peut bloquer le redémarrage de Neolae sous Widows : vous devez le désactiver. Pour cela : 1 Ouvrez ue feêtre de commade DOS depuis le meu Démarrer>Exécuter de Widows. 2 Saisissez la commade suivate : start Drwts32 82 Neolae 2013

84 E cas de problème 3 Désactivez toutes les otificatios : Stack trace sous Liux La stack trace représete ue trace coteue das u fichier de type core. Ce fichier est gééré e cas d'erreur sur la machie. Il peut permettre de coaître l'origie de l'erreur. Note : U fichier core se présete sous le om core.<num>. Il faut que gdb - The GNU Debugger soit istallé sur la machie. Le support techique de Neolae peut vous demader cette stack trace. Pour l'obteir, saisissez les commades suivates sous Liux : su - eolae gdb lserver <corefile> //You get lots of output but the stack trace (or Back trace) ca be obtaied with : (gdb) bt // ad forward all the output : #0 0x0836c189 i ObjectValue::SetPropertyTarget () #1 0x082623b3 i CXtkScriptProperty::VDeclareProperties () #2 0x0826a835 i CXtkScriptCotext::OGetProperty () #3 0x08370b3d i JavaScriptGetProperty () #4 0x557b8aa7 i js_iterpret () from /usr/local/eolae/l6/lib/libmozjs.so #5 0x557afb97 i js_execute () from /usr/local/eolae/l6/lib/libmozjs.so #6 0x f i JS_ExecuteScript () from /usr/local/eolae/l6/lib/libmozjs.so #7 0x i JavaScriptSource::Evaluate () #8 0x0848fa03 i JSTDeliveryCotext::ProcessScript () #9 0x0848fcb6 i JSTDeliveryCotext::ProcessTemplate () #10 0x08460d2b i CDeliveryToolbox::Creat Message () #11 0x080d51fe i CMtaQueue::PrepareMessages () #12 0x080d2b07 i CMtaQueue::Prepare () #13 0x080dca38 i CMtaChild::ORu () #14 0x c i ThreadStartRoutie () #15 0x55575b63 i start_thread () from /lib/tls/libpthread.so.0 #16 0x a i cloe () from /lib/tls/libc.so.6 Le support techique de Neolae peut vous demader de lacer cette commade à l'aide d'u exécutable spécifique (que ous vous fouriros). Neolae v6.0 - Guide d'exploitatio - E cas de problème 83

85 Neolae Das ce cas, il suffit de lacer la commade : gdb lserver <corefile> e remplaçat lserver par l'exécutable fouri par Neolae. Par exemple : gdb lserver.1823 <corefile> Ecodage de la base de doées Oracle Neolae utilise les ecodages par défaut d'oracle. Si vous e utilisez d'autres, il peut se produire ue icompatibilité. Cosultez à ce propos le Guide d'istallatio. Réactivatio de la demade de mise à jour de la cosole Si vous avez coché l'optio Ne pas demader la mise à jour de la cosole et que vous souhaitez réactiver la demade de mise à jour, la procédure est la suivate : 1 Ouvrez l'éditeur de la base de registre via la commade regedit depuis le meu Démarrer>Exécuter de Widows. 2 Das l'arborescece, affichez les optios du oeud \HKEY_CURRENT_USER\Software\Neolae\NL_6\lcliet. 3 Supprimez l'etrée cofadvisedupgrade et fermez l'éditeur de base de registre. Perte de mot de passe Il est possible de chager ou récupérer u mot de passe perdu. Deux cas sot possibles : 84 Neolae 2013

86 E cas de problème Perte du mot de passe d'u opérateur Neolae. Das ce cas, vous pouvez modifier le mot de passe de l'opérateur coceré. Pour cela, coectez-vous avec u opérateur ayat les droits admiistrateurs et remplacez le mot de passe de l'opérateur. Perte du mot de passe iteral. E cas de perte du mot de passe iteral, vous devez le réiitialiser. Pour cela, la procédure est la suivate : 1 Editez le fichier /usr/local/eolae/l6/cof/servercof.xml. 2 Positioez-vous sur la lige iteralpassword. <!-- XTK autheticatio mode iteralpassword : Password of iteral accout --> <xtk iteralpassword="mypassword"/> 3 Supprimez la chaîe etre guillemets, ici par exemple : mypassword Vous obteez aisi la lige suivate : <!-- XTK autheticatio mode iteralpassword : Password of iteral accout --> <xtk iteralpassword=""/> 4 Eregistrez les modificatios et fermez le fichier. 5 Paramétrez esuite le ouveau mot de passe. Pour cela, saisissez les commades suivates : lserver cofig -iteralpassword 11:00:39 > Serveur applicatif pour Neolae Versio 6.X (build XXXX) du jj/mm/aaaa Etrez le mot de passe actuel. Mot de passe : (il est vide) Etrez le ouveau mot de passe. Mot de passe : Cofirmatio : 6 Vous pouvez maiteat vous coecter e Iteral avec votre ouveau mot de passe. Comportemet aormal des JSP Si certaies jsp e s'exécutet pas correctemet, vous devez forcer leur recompilatio. Pour cela, saisissez les commades suivates : lserver stop web cd l6/tomcat-6 rm -r work/ lserver start web Les jsp sot regéérées à la coexio suivate. Neolae v6.0 - Guide d'exploitatio - E cas de problème 85

87 Neolae 86 Neolae v6.0 - Guide d'exploitatio