Guide d'installation. Neolane v6.0

Transcription

1 Guide d'istallatio Neolae v6.0

2

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

4 Table des matières Neolae v6.0 - Guide d'istallatio Chapitre 1. Présetatio Objet Architecture géérale Couche de présetatio Couche de logique applicative Couche de persistace Chapitre 2. Cofiguratio requise Matrice de compatibilité Base de doées Serveur applicatif Iterface cliet riche Accès Web Serveur de messagerie Coecteurs CRM Accès à ue base extere (Federated Data Access) Cofiguratio réseau Commuicatio etre les processus Accès à la base de doées Accès depuis l'extérieur Bade passate Chapitre 3. Types de déploiemets Itroductio Déploiemet Stad-aloe (moomachie) Caractéristiques Etapes d'istallatio et de cofiguratio d'ue istace Déploiemet Stadard Caractéristiques Etapes d'istallatio et de cofiguratio d'ue istace Déploiemet Etreprise Caractéristiques Etapes d'istallatio et de cofiguratio d'ue istace Déploiemet Mid-sourcig Caractéristiques Neolae v6.0 - Guide d'istallatio 3

5 Neolae Etapes d'istallatio et de cofiguratio d'ue istace Optios Dedicated Executio Istace et High-Availability Cluster Présetatio Applicatios éligibles Packages Neolae à istaller Matrice de recommadatios architecturales Recommadatios Chapitre 4. Istallatio sous Widows Avat d'istaller Prérequis logiciels sous Widows Etapes de mise e oeuvre Accessibilité Istallatio du serveur Neolae Exécutio du programme d'istallatio Test sommaire de l'istallatio Premier démarrage du serveur Neolae Mot de passe de l'idetifiat iteral Démarrage des services Neolae Itégratio à u serveur Web Présetatio Cofiguratio du serveur Web IIS Mise à dispositio de la cosole cliete Istallatio de la cosole cliete Neolae Chapitre 5. Istallatio sous Liux Avat d'istaller Prérequis logiciels sous Liux Etapes de mise e oeuvre Accessibilité Istallatio des packages Neolae Itroductio Lague par défaut pour le serveur Neolae Distributio basée sur des packages RPM (RHEL et SUSE) Distributio basée sur APT (Debia) Test sommaire de l'istallatio Premier démarrage du serveur Neolae Mot de passe de l'idetifiat iteral Itégratio à u serveur Web Présetatio Cofiguratio du serveur Web Apache Mise à dispositio de la cosole cliete Neolae Chapitre 6. Cofiguratio de Neolae Itroductio Créatio d'ue istace et de la base de doées Créatio et coexio à ue istace Créatio et paramétrage de la base de doées Paramétrage du serveur Itroductio Fichiers de cofiguratio Activatio des processus Paramètres de diffusio Déploiemet d'ue istace Neolae Assistat de déploiemet Paramètres gééraux Caal Neolae 2013

6 Guide d'istallatio Gestio des mails rebods Paramétrage du trackig Caal mobile Optios régioales Accès depuis Iteret Gestio des ressources publiques Purge des doées Chapitre 7. Paramétrages complémetaires Itroductio Paramétrages additioels côté serveur Port Tomcat par défaut Mappig d'u dossier sous Tomcat Persoalisatio des paramètres de diffusio Sécurité et relais des pages dyamiques Trackig redodat Gestio des ressources publiques Workflows e haute dispoibilité Cofiguratio de l'eviroemet sous Liux Itroductio Java Developmet Kit (JDK) par défaut Paramétrages additioels de l'istace Cofiguratio pour l'utilisatio des purl Paramétrage LDAP/Neolae Accès à ue base de doées extere Présetatio Pricipe de foctioemet Pré-requis Paramétrer l'accès à ue base extere Délivrabilité des s Présetatio Pricipe de foctioemet Cotrôler le débit de diffusio Cofiguratio des serveurs Moitorig des serveurs de diffusio Optimisatio de l'evoi d' s : recommadatios Gestio des fuseaux horaires Présetatio Cofiguratio Paramétrage des composats tierce-partie OpeOffice.org Cliet Oracle sous Liux SpamAssassi Paramétrage du coecteur Neolae-Adobe Geesis Présetatio Paramétrage d'adobe Geesis Paramétrage de Neolae Paramétrage des coecteurs CRM Présetatio Etapes de paramétrage Exemple pour Salesforce.com Exemple pour Oracle ODemad Cofiguratio et déploiemet d'u serveur de mid-sourcig Itroductio Etapes d'istallatio et de cofiguratio d'ue istace Déploiemet d'u serveur de mid-sourcig Multiplexage du serveur de mid-sourcig Cofiguratio du trackig sur u serveur de mid-sourcig Neolae v6.0 - Guide d'istallatio 5

7 Neolae Chapitre 8. Aexes Créatio d'ue istace Neolae e lige de commades Commades de créatio d'ue istace Déclaratio d'ue base de doées Créatio de ouvelles istaces Problèmes courats Neolae 2013

8 CHAPITRE 1 Présetatio Table des matières Objet Architecture géérale Couche de présetatio Couche de logique applicative Couche de persistace Objet Ce documet présete : les versios des composats logiciels (bases de doées, systèmes d'exploitatio, serveurs Web, etc.) compatibles avec le déploiemet de Neolae, le type d'ifrastructure à mettre e oeuvre pour des exemples typiques de déploiemet, les étapes d'istallatio de Neolae, le mode de créatio et de cofiguratio d'ue istace et de sa base de doées, les paramétrages complémetaires de l'istace et du serveur, selo votre cofiguratio. E tat qu'éditeur de solutios, ous vous idiquos ci-dessous des ifrastructures matérielles et logicielles de ature à être compatibles avec otre offre. Les recommadatios matérielles présetes das ce documet sot doées à titre d'iformatio sur la base de otre expériece. Elles e sauraiet egager la resposabilité de Neolae. Elles dépedet égalemet des règles pratiquées das votre etreprise, du iveau de criticité et des performaces attedues du projet. Architecture géérale Neolae repose sur ue architecture orietée service (SOA) composée de plusieurs modules foctioels. Ces modules peuvet être déployés sur ue ou plusieurs machies, e u ou plusieurs exemplaires, afi de respecter les cotraites de teue e charge, de dispoibilité et d'isolatio des services. Les cofiguratios de déploiemet possibles sot doc multiples, depuis ue machie uique cetralisat tous les services écessaires, jusqu'à des cofiguratios compreat de multiples serveurs dédiés, évetuellemet sur des sites différets. Neolae v6.0 - Guide d'istallatio - Présetatio 7

9 Neolae Avertissemet : E dehors d'ue prestatio Neolae explicite e la matière, l'istallatio, la mise à jour et la maiteace de tous les composats d'ue plateforme Neolae sot de la resposabilité du ou des admiistrateurs des machies qui les héberget. Il coviedra otammet de mettre e oeuvre les prérequis écessaires au foctioemet des applicatios Neolae, aisi que de respecter la matrice de compatibilité etre les composats (voir Matrice de compatibilité [page 11]). Les couches classiques d'ue applicatio multi-tiers sot les suivates : Couche de présetatio L'accès à l'applicatio peut se faire de différetes maières, e foctio des besois des utilisateurs : cliet riche, cliet léger et itégratio via les API. Cliet riche : l'iterface utilisateur pricipale de l'applicatio est u cliet riche, c'est-à-dire ue applicatio ative (Widows) qui commuique avec le serveur d'applicatio Neolae uiquemet à l'aide de protocoles Iteret stadard (SOAP, HTTP, etc.). Cette cosole présete les avatages d'ue boe ergoomie et d'ue grade productivité, avec ue faible cosommatio e bade passate (utilisatio d'u cache local) et das le cadre d'u déploiemet très simple. E effet, cette cosole se déploie depuis u avigateur, se met automatiquemet à jour et e écessite aucue cofiguratio réseau spécifique, car elle e géère que du trafic HTTP(S). Cliet léger : certaies parties de l'applicatio sot directemet accessibles via u simple avigateur Web, à travers ue iterface utilisateur e HTML, otammet le module de reportig, les phases de validatio des diffusios, les foctioalités du module de Marketig Distribué (cetral/local), le moitorig de l'istace, etc. Ce mode de foctioemet permet d'iclure des foctios Neolae das u itraet ou u extraet. Itégratio par les API : das certais cas, le système est directemet piloté par d'autres applicatios qui utiliset les API Web Services exposées par le biais du protocole SOAP. Couche de logique applicative Neolae repose sur différets processus exécutés côté serveur qui foctioet esemble. Les pricipaux processus sot les suivats : 8 Neolae 2013

10 Présetatio Serveur applicatif (lserver web) Ce processus expose toutes les foctioalités de Neolae via des API Web Services (SOAP - HTTP + XML). De plus, il est capable de géérer dyamiquemet les pages Web utilisées par l'accès HTML à l'applicatio (reportig, formulaires Web, etc.). Pour cela, ce processus itègre le serveur de JSP Apache Tomcat. C'est à ce processus que se coecte la cosole. Moteur de workflow (lserver wfserver) Il assure l'exécutio des processus de workflow défiis das l'applicatio. Il pred égalemet e charge les workflows techiques qui s'exécutet périodiquemet, et otammet les suivats : Trackig : récupératio et cosolidatio des logs de trackig. Il permet d'obteir les logs du serveur de redirectio et créer les idicateurs agrégés utilisés par le module de reportig. Cleaup : ettoyage de la base de doées. Il permet de purger les acies eregistremets et éviter ue croissace expoetielle de la base. Billig : evoi automatique d'u rapport d'activité de la plate-forme (taille de base, ombre d'actios marketig, etc.). Serveur de diffusio (lserver mta) Neolae permet d'exécuter ativemet les diffusios de type . Ce processus agit alors comme u aget de trasfert de mails (MTA) atif pour la diffusio par le protocole SMTP. Il pred e charge la persoalisatio "oe-to-oe" des messages et leur diffusio physique. Il repose sur la otio de jobs de diffusios et gère les reprises automatiques. De plus, lorsque le trackig est activé, il remplace automatiquemet toutes les URL présetes das u message afi de les faire poiter vers le serveur de redirectio. Ce processus peut assurer la persoalisatio et l'evoi automatique vers u prestataire extere pour les diffusios de type SMS, Fax ou Courrier papier. Serveur de redirectio (lserver webmdl) Das le cas des diffusios par , Neolae assure automatiquemet le suivi des ouvertures et clics das les messages (et évetuellemet le suivi des trasactios géérées sur le site Web). Pour cela, les URL présetes das les s sot réécrites afi de poiter vers ce module, qui assure l'eregistremet de passage de l'iteraute avat de le rediriger vers la véritable URL. Afi d'e garatir la dispoibilité maximale, ce processus est totalemet idépedat de la base de doées : les autres processus serveur dialoguet avec lui e utilisat uiquemet des appels SOAP (doc HTTP, HTTPS et XML). Techiquemet, cette foctioalité est implémetée das u module d'extesio d'u serveur HTTP (extesio ISAPI sous IIS, module DSO sous Apache) et 'est accessible que sous Widows. D'autres processus plus techiques sot égalemet dispoibles : Gestio des mails rebods (lserver imail) Ce processus permet de relever automatiquemet les boîtes mail cofigurées pour recevoir les mails rebods retourés e cas d'échec de livraiso d' s. Ces mails sot esuite passés au travers d'u moteur de règles utilisé pour détermier les causes exactes de o-livraiso (destiataire icou, boîte aux lettres pleie, etc.) et mettre à jour l'état de diffusio das la base de doées. Toutes ces opératios sot etièremet automatiques et précofigurées. Etat de diffusio des SMS (lserver sms) Ce processus iterroge à itervalles réguliers le routeur des messages SMS afi de collecter les états d'avacemet des diffusios et de mettre à jour la base de doées. Ecriture des messages de logs (lserver syslogd) Ce processus techique capture les messages de log et traces géérés par tous les autres processus, et assure leur écriture sur disque. Il permet de collecter le maximum d'iformatios utiles au diagostic e cas de problème. Ecriture des logs de trackig (lserver trackiglogd) Ce processus assure l'eregistremet sur disque des logs de trackig géérés par le processus de redirectio. Neolae v6.0 - Guide d'istallatio - Présetatio 9

11 Neolae Surveillace des modules (lserver watchdog) Ce processus techique agit e tat que processus maître qui lace tous les autres. De plus, il les surveille et les relace automatiquemet e cas d'icidet, ce qui assure ue dispoibilité maximale du système. Serveur de statistiques (lserver stat) Ce processus maitiet les statistiques du ombre de coexios, de messages evoyés pour chaque serveur de messagerie vers lequel les messages sot evoyés, aisi que leurs limitatios (ombre maximum de coexios simultaées, de messages par heure et/ou coexio). Il permet égalemet de fédérer plusieurs istaces ou plusieurs machies etre elles si elles partaget les mêmes adresses IP publiques. Couche de persistace La base de doées est utilisée e tat que couche persistate et cotiet quasimet toute l'iformatio gérée par Neolae, à la fois les doées foctioelles (gestio des profils, aboemets, coteus, etc.), les doées techiques (jobs et logs de diffusio, logs de trackig, etc.) et les doées métier (actes d'achat, leads). La fiabilité de la base de doées est primordiale puisque la plupart des composats de Neolae doivet avoir accès à la base afi d'accomplir leurs tâches (hormis le module de redirectio). 10 Neolae 2013

12 CHAPITRE 2 Cofiguratio requise Table des matières Matrice de compatibilité Base de doées Serveur applicatif Iterface cliet riche Accès Web Serveur de messagerie Coecteurs CRM Accès à ue base extere (Federated Data Access) Cofiguratio réseau Commuicatio etre les processus Accès à la base de doées Accès depuis l'extérieur Bade passate Matrice de compatibilité Vous trouverez das ce chapitre toutes les versios des différets systèmes et composats supportées pour cette versio de Neolae. Les évolutios régulières ous obliget à des mises à jour fréquetes de ce documet. E coséquece, ous vous recommados de vérifier que vous disposez bie de sa derière versio. Avertissemet : Les systèmes et versios o listés das ce chapitre e sot pas supportés. Les moteurs de base de doées compatibles sot dispoibles das la sectio Base de doées [page 12], Les élémets de compatibilité relatifs au serveur Neolae sot présetés das la sectio Serveur applicatif [page 13], La cosole Neolae requiert la présece de certais composats : voir Iterface cliet riche [page 16], La coexio e Web Access écessite u avigateur : les versios compatibles sot listées das la sectio Accès Web [page 16], Les iformatios relatives au serveur de messagerie sot dispoibles das la sectio Serveur de messagerie [page 16], Neolae v6.0 - Guide d'istallatio - Cofiguratio requise 11

13 Neolae Efi, les versios des coecteurs CRM compatibles avec Neolae sot dispoibles das la sectio Coecteurs CRM [page 17]. Base de doées Versios Les moteurs de base de doées supportés par Neolae sot les suivats : Moteurs de base de doées DB2 UDB Microsoft SQLServer MySQL Oracle PostgreSQL Versios 9.1 (beta) 9.5 (beta) 9.7 (beta) (32bits & 64bits) 2008R2 (32bits & 64bits) gR2 11g 11gR Cliets ODBC Driver ODBC Driver ODBC Driver SQL Server Native Cliet (2005) SQL Server Native Cliet 1.0. (2008) SQL Server Native Cliet 1.0. (2008) Versios 10.x ou 11.x de SQL*Net (Oracle DB Istat Cliet) Versios 10.x ou 11.x de SQL*Net (Oracle DB Istat Cliet) Attetio! La compatibilité etre toutes les versios serveurs et cliets 'est pas garatie. Le serveur de base de doées peut foctioer sur 'importe quel système d'exploitatio, sas teir compte du système utilisé par le ou les serveurs applicatifs, sous réserve de coectivité réseau etre eux. Limitatios et recommadatios particulières Selo le moteur de base de doées utilisé, les limitatios suivates doivet être prises e compte. Avertissemet : Quel que soit le système d'exploitatio sur lequel le moteur de base de doées est istallé, la coectivité doit être dispoible sur les machies qui exécutet des composats de Neolae. Microsoft SQL Server Le cliet atif doit être istallé sur les serveurs applicatifs Neolae. Vous pouvez vérifier la présece du cliet atif sur le serveur via le paeau de cofiguratio des pilotes ODBC, sous les libellés SQL Native Cliet (pour u cliet SQL Server 2005) ou SQL Server Native Cliet 10.0 (pour u cliet SQL Server 2008 et 2008 R2). Les DLL d'accès suivates doivet doc être présetes : sqlcli.dll pour le cliet SQL Server 2005, sqlcli10.dll pour le cliet SQL Server 2008 et 2008 R2. Les DLL d'accès sot dispoibles sur le site de Microsoft. L'accès à Microsoft SQL Server depuis u serveur applicatif sous Liux 'est pas supporté. 12 Neolae 2013

14 Cofiguratio requise MySQL Avertissemet : Le moteur de base de doées MySQL 'est pas adapté à tous les types de déploiemet, et otammet e volume. Neolae e décoseille doc fortemet l'usage lorsque le volume de la base de doées dépasse 10 Go et/ou lorsque le volume de diffusio ( , sms...) dépasse messages par mois. Ceci est otammet dû à la faiblesse de so modèle de lockig et de so optimiseur SQL, qui e sot pas compatibles avec les besois d'ue applicatio telle que Neolae. Si vos volumes dépasset ces limites, préférez u des autres moteurs de base de doées supportés par Neolae. Sous MySQL, la variable d'eviroemet bilog_format doit être positioée à 'MIXED'. Oracle Les paramètres NLS_NCHAR_CHARACTERSET et NLS_CHARACTERSET doivet avoir été correctemet cofigurés pour u bo foctioemet de la base e Uicode ou e ANSI. Neolae utilise les ecodages par défaut d'oracle. Si vous e utilisez d'autres, il peut se produire ue icompatibilité. Das ce cas, cotactez le support techique. Pour coaître votre ecodage, vous pouvez utiliser la commade sqlplus suivate : SELECT * FROM ls_database_parameters ; Pour ue istallatio e Uicode, le seul ecodage supporté est le suivat : NLS_NCHAR_CHARACTERSET NLS_CHARACTERSET AL16UTF16 ALF32UTF8 Pour ue istallatio e ANSI (o Uicode), le seul ecodage supporté est le suivat : NLS_CHARACTERSET WE8MSWIN1252 Pour vous coecter à sqlplus, utilisez le profil utilisateur Oracle : su - oracle sqlplus [logi] [mot de passe] Cosultez égalemet la sectio Cliet Oracle sous Liux [page 138]. PostgresSQL Nous vous recommados d'istaller le support UTF-8 lors de l'istallatio du moteur de base, afi de pouvoir créer des bases Uicode. Serveur applicatif Systèmes d'exploitatio Les systèmes d'exploitatio supportés par Neolae sot les suivats : Systèmes d'exploitatio Widows Server CetOS Versios 2003 (32bits & 64bits) 2008 (32bits & 64bits) 2008R2 (64bits) 5 (32bits & 64bits) 6 (32bits & 64bits) Sous-versios SP2 mii. SP1 mii. SP1 mii. 5.3 mii. 6.0 mii. Neolae v6.0 - Guide d'istallatio - Cofiguratio requise 13

15 Neolae RHEL Debia SLES SLES SLES 5 (32bits & 64bits) 6 (32bits & 64bits) 5 (32bits & 64bits) 6 (32bits & 64bits) 10 (32bits & 64bits) 11 (64bits) 12 (64bits) 5.3 mii. 6.0 mii mii. 6.0 mii mii mii mii. Neolae est ue applicatio 32 bits qui peut foctioer sur u système d'exploitatio 64 bits. Cepedat, si vous istallez Neolae sur u système d'exploitatio 64 bits, assurez-vous que tous les composats dot Neolae déped sot présets e versio 32 bits ou compatible (OpeSSL, couches d'accès à la base de doées, serveur Web, etc.). L'istallatio de Neolae et ses composats tiers est plus souple sous Debia 32 bits : privilégiez cette versio à ue istallatio sous Debia 64 bits. Vous pouvez utiliser u oyau PAE, par exemple pour gérer davatage de mémoire. Couches d'accès à la base de doées La plupart des composats serveur ot besoi d'accéder à la base de doées, via les couches clietes atives du moteur de base de doées utilisé. Les versios supportées sot les suivates : Pilotes DB2 Microsoft SQL Server MySQL Oracle SQL*Net PostgreSQL Versios MDAC 2.6 mii mii mii. Remarques L'accès passe par le pilote ODBC. L'accès passe par le pilote ODBC. Notez que la versio livrée avec Widows 2003 Server foctioe correctemet avec SQL Server 2005 et Sous Widows, la DLL d'accès est automatiquemet istallée. Sous Uix, ue versio libmysqlcliet.so miimum doit être istallée. Seule la versio 5.1 du cliet est supportée. Oracle DB Istat Cliet Sous Widows, la DLL d'accès est automatiquemet istallée. Sous Uix, ue versio libpq.so (versio 32 bits) doit être istallée. Serveur Web Pour le module Web, utilisé otammet par le trackig, les serveurs Web suivats sot supportés : Serveurs Web Apache Microsoft IIS Versios 2.0 (32 bits) 2.2 (32 et 64 bits) Compatibles avec Widows Server 2003 Widows Server 2008 et Vista Widows Server 2008R2 et Seve Java JDK Le module de géératio de pages Web dyamiques repose sur la techologie JSP 1.2. A cet effet, u moteur Tomcat (d'origie Apache) est iclus das l'applicatio. Il écessite la présece d'u Java Developmet Kit (JDK), istallé sur tous les serveurs sur lesquels l'applicatio Neolae sera istallée. Vous devez istaller u Java Developmet Kit (JDK) sur les machies sur lesquelles vous comptez lacer le serveur applicatif Neolae (lserver web) car il itègre u cotaier de servlets Apache Tomcat utilisés pour la géératio des pages Web dyamiques (reportig, formulaires Web, etc.). L'applicatio a été validée pour le JDK développé par Oracle aisi que pour OpeJDK. Les versios 5 et 6 sot supportées, la versio 6 est recommadée (il est possible de l'istaller e plus d'ue autre versio qui serait déjà utilisée par d'autres applicatios sur la machie). 14 Neolae 2013

16 Cofiguratio requise Das le cas d'ue istallatio sur u serveur 64 bits, vous devez tout de même istaller la versio 32-bits du JDK. Lors de l'istallatio, il 'est pas obligatoire de faire l'itégratio avec les avigateurs Web. Sur ue machie exécutat uiquemet les agets de diffusio (lserver mta) ou le serveur de workflow (lserver wfserver), l'istallatio du JDK 'est pas écessaire. Pour télécharger Java, coectez-vous sur le site : et téléchargez la derière révisio de la versio 6. Attetio : vous devez télécharger u JDK, pas u JRE. Avertissemet : Afi de préserver le bo foctioemet de votre plateforme et coserver la compatibilité avec la versio istallée, vous devez impérativemet désactiver les foctios de mises à jour automatiques du JDK sous Widows et Liux. Pour istaller le JDK das u eviroemet Liux, il est préférable d'utiliser u gestioaire de paquets. Pour Debia, utilisez la commade suivate : aptitude istall opejdk-6-jdk Pour RHEL, utilisez la commade suivate : yum istall opejdk-6-jdk OpeOffice.org Les modules Writer et Calc d'opeoffice.org doivet être istallés sur la ou les machies sur lesquelles s'exécutet le serveur applicatif Neolae (lserver web), otammet afi de pouvoir exporter les rapports au format Excel et PDF. Les versios supportées sot la versio 3.3 et la versio 3.4 (écessite l'activatio de variables d'eviroemet). OpeOffice.org peut être istallé e versio 64 bits sur u système d'exploitatio 64 bits. Das ce cas, l'istallatio d'opeoffice.org requiert l'istallatio d'u JRE 64 bits. Les paramètres spécifiques à predre e compte pour le bo foctioemet d'opeoffice.org avec Neolae sot présetés das les sectios Prérequis logiciels sous Widows [page 43], Prérequis logiciels sous Liux [page 59] et Cofiguratio de l'eviroemet de Neolae sous Liux (optioel) [page 138]. SpamAssassi SpamAssassi permet d'attribuer u score aux s afi de détermier si u message risque d'être cosidéré comme idésirable par les outils ati-spams utilisés à sa réceptio. So istallatio est facultative. Avertissemet : La qualificatio des s par SpamAssassi comme idésirables repose itégralemet sur l'utilisatio d'u esemble de règles de filtrage et de scores. La mise à jour de ces règles, au mois ue fois par jour, est doc idispesable pour que votre istallatio de SpamAssassi et so itégratio das Neolae soiet pleiemet opératioelles et garatisset la pertiece des scores attribués à vos diffusios avat leur evoi. Cette mise à jour est de la resposabilité de l'admiistrateur du serveur qui héberge SpamAssassi. Les deux versios supportées sot 3.2(3.2.5 miimu) et 3.3 (3.3.2 miimum). SpamAssassi écessite u accès iteret HTTP (tcp/80). Neolae v6.0 - Guide d'istallatio - Cofiguratio requise 15

17 Neolae Les étapes d'istallatio et de cofiguratio de SpamAssassi sot présetées das la sectio SpamAssassi [page 139]. Iterface cliet riche L'iterface utilisateur pricipale de l'applicatio est u cliet riche, c'est-à-dire ue applicatio ative qui commuique avec le serveur d'applicatio Neolae uiquemet à l'aide de protocoles Iteret (SOAP, HTTP, etc.). Cette cosole est ue applicatio ative Widows (Wi32), qui foctioe sous les systèmes d'exploitatio suivats : Widows 7, Widows Vista, Widows XP, Widows Server 2008, Widows Server 2008 R2, Widows Server Neolae peut foctioer sous Liux et Mac OSX Itel via u émulateur de type CrossOver (recommadé) ou Wie, mais la compatibilité totale 'est pas garatie. De plus, cette cosole requiert les composats suivats : Iteret Explorer, versio 7 miimum, versio 8 recommadée. plug-i Flash, versio 6 miimum, otammet pour l'affichage des rapports. Accès Web Les opérateurs peuvet accéder à Neolae via le Web. Pour cela, ils doivet disposer d'u avigateur iteret et du plug-i Flash, versio 6 miimum, otammet pour l'affichage des rapports. Les avigateurs supportés sot les suivats : Navigateur Chrome Firefox Iteret Explorer Safari Versios 22 mii. v17 mii mii. Serveur de messagerie Neolae gère ativemet l'evoi d' s. Toutefois, u serveur de messagerie traditioel est écessaire afi de recevoir les retours liés aux mails o livrables (mailer daemos). Les boîtes aux lettres cofigurées sur ce serveur sot automatiquemet relevées et traitées par l'applicatio. Tout serveur de messagerie peut être utilisé dès lors que les boîtes mails cofigurées pour recevoir les mails rebods peuvet être relevées à l'aide du protocole POP3 et que ce serveur préserve les e-têtes SMTP "Message-ID" lors du relevé des s. Par exemple, des déploiemets à base de Qmail, SedMail et Microsoft Exchage sot actuellemet e productio. Toutefois, certaies istallatios de Lotus Notes/Domio ot révélé u problème de préservatio des e-têtes "Message-ID". 16 Neolae 2013

18 Cofiguratio requise Avertissemet : Ce serveur mail peut être exposé à ue lourde charge : e phase iitiale, des listes typiques géèret u taux de 10% de rebods (si vous faites ue première diffusio de mails, il est courat de recevoir mails rebods). Il est doc fortemet décoseillé d'utiliser votre serveur de messagerie d'etreprise pour cette foctio, car il pourrait être fortemet impacté. Il est recommadé de cofigurer u sous-domaie spécifique das votre DNS et u serveur mail dédié à la gestio des mails rebods. Coecteurs CRM L'optio Coecteurs CRM permet à Neolae de gérer l'itégratio avec les logiciels CRM suivats : Salesforce.com, Oracle O Demad (acieemet Siebel O Demad) et Microsoft Dyamics CRM. Le paramétrage des coecteurs CRM est préseté das la sectio Paramétrage des coecteurs CRM [page 148]. Versios Neolae est compatible avec les versios suivates : CRM Microsoft Dyamics CRM 2007 et 2011 Oracle O Demad Salesforce.com Versios des API 2007 et et 21 Avertissemet : Neolae est compatible avec les versios 2007 et 2011 de Microsoft Dyamics CRM. Pour la versio 2011 de Microsoft Dyamics CRM, vous devez istaller la versio 2007 de l'api. Pour Microsoft Dyamics, Neolae est uiquemet compatible avec le mode de déploiemet IFD (Iteret-Facig Deploymet). Seule la versio O Premise de MS Dyamics CRM est supportée. Remarques et limitatios Salesforce.com Les istaces de productio et de test sot supportées. Les règles d'assigatio sot supportées. Oracle O Demad Neolae peut sychroiser 'importe quel objet parmi ceux dispoibles das le modèle stadard d'oracle O Demad. Si vous avez ajouté des tables persoalisées das Oracle O Demad, celles-ci e pourrot pas être récupérées das Neolae. L'API versio v1.0 permet de trier ou filtrer les doées lors d'ue requête, mais e permet pas d'effectuer ces deux actios simultaémet. Les dates evoyées par Oracle O Demad e cotieet pas d'iformatios sur le fuseau horaire. MS Dyamics CRM L'istallatio de plug-is peut modifier le comportemet du CRM, ce qui peut etraîer des problèmes de compatibilité avec Neolae. Limitatios géérales Les éumératios à sélectio multiple e sot pas supportées par Neolae. Neolae v6.0 - Guide d'istallatio - Cofiguratio requise 17

19 Neolae Accès à ue base extere (Federated Data Access) Neolae propose l'optio Federated Data Access (FDA) afi d'exploiter des iformatios stockées das ue ou plusieurs bases de doées exteres. Les moteurs de base de doées compatibles avec cette optio sot les suivats : Moteurs de base de doées DB2 UDB Microsoft SQLServer MySQL Oracle PostgreSQL Sybase Versios 9.1 (beta), 9.5 (beta), 9.7 (beta) R2 5.0, 5.1 9i 10gR2 11g 11gR (mii.), 8.4, 9.0, 9.1 IQ 15.2, 15.4 ASE 15.0, 15.7 Cliets Pilote ODBC SQL Server Native Cliet (2005) SQL Server Native Cliet 1.0. (2008) (32 bits ou 64 bits) SQL Server Native Cliet 1.0. (2008) (32 bits ou 64 bits) Versios 10.x ou 11.x de SQL*Net (Oracle DB Istat Cliet) Versios 10.x ou 11.x de SQL*Net (Oracle DB Istat Cliet) Cofiguratio réseau Commuicatio etre les processus Certais processus de l'applicatio ot besoi de commuiquer etre eux ou d'accéder au réseau, à la fois au LAN et à Iteret. E coséquece, certais ports TCP doivet être ouverts pour ces processus. Serveur de diffusio Pour le serveur de diffusio (lserver mta), les ports suivats doivet être ouverts : Ports 25/tcp (smtp) 53/udp (domai) 38000/tcp (port par défaut) 7777/udp Destiatio N'importe où Serveurs DNS SMS gateway Serveur de statistiques Commetaires Commuicatio SMTP pour la diffusio d' s. Requêtes DNS. Utilisé pour trasmettre le trafic SMS au méta-opérateur NetSize [optio]. Accès au serveur de statistiques. Mails etrats Pour le processus de récupératio des mails etrats (lserver imail), les ports suivats doivet être ouverts : Ports 110/tcp (pop3) 25/tcp (smtp) Destiatio Serveur de mails itere Serveur de mails itere Commetaires Trafic POP3 pour relever les messages rebods. Trafic SMTP pour trasmettre les messages rebods résiduels qui e sot pas automatiquemet traités par les règles prédéfiies. Serveur applicatif Pour le serveur applicatif (lserver web), les ports suivats doivet être ouverts : 18 Neolae 2013

20 Cofiguratio requise Ports 80/tcp (http) 443/tcp (https) Destiatio N'importe où Commetaires Trafic HTTP ou HTTPS (otammet pour l'offre de délivrabilité). Avertissemet : Lorsque plusieurs serveurs applicatifs d'ue plateforme Neolae doivet commuiquer etre eux, il est recommadé de privilégier l'utilisatio du port du serveur Apache Tomcat (par défaut : 8080) plutôt que celle du port HTTP du serveur Web avec lequel l'itégratio du module de redirectio a été réalisée. Ce port doit doc être ouvert etre ces différets serveurs. Etat de diffusio des SMS Pour le suivi des diffusios SMS (lserver sms), le port suivat doit être ouvert : Ports 38000/tcp (port par défaut) Destiatio Passerelle SMS Commetaires Iterroge le statut des files d'attete de diffusio gérées par la passerelle SMS NetSize [optio]. Cliet riche Pour le cliet riche Neolae (lcliet), les ports suivats doivet être ouverts : Ports 80/tcp (http) 443/tcp (https) Destiatio Serveur applicatif Commetaires Trafic (HTTP) SOAP. Accès à la base de doées Tous les composats qui dépedet de la base de doées doivet pouvoir s'y coecter. Cela cocere la plupart des composats, à l'exceptio du serveur de redirectio qui peut travailler seul, et du cliet léger Wi32 qui utilise uiquemet le protocole HTTP (ou HTTPS) pour commuiquer avec le serveur applicatif. Les ports par défaut sot les suivats : Type de base de doées Oracle PostgreSQL Microsoft SQL Server DB2 MySQL Port (défaut) 1521/tcp 5432/tcp 1433/tcp 50000/tcp 3306/tcp Destiatio Serveur de base de doées. Accès depuis l'extérieur De plus, certais composats doivet être accessibles depuis l'iteret public pour les campages d' ig exécutées directemet par la plate-forme Neolae. Pour cela, certais ports doivet être ouverts pour ces composats. Serveur de redirectio Port d'écoute 80/tcp (http) 443/tcp (https) Localisatio N'importe où. Chaque clic sur u lie tracké géère ue requête HTTP sur ce serveur. Serveur Web extere Ce serveur héberge les formulaires Web, pages miroir, etc. Les ports suivats doivet être ouverts : Neolae v6.0 - Guide d'istallatio - Cofiguratio requise 19

21 Neolae Port d'écoute 80/tcp (http) 443/tcp (https) Localisatio N'importe où. Nécessaire quad les formulaires Web sot directemet gérés par la plateforme Neolae, ou lorsque les pages miroir sot utilisées. Serveur applicatif itere (Web) Port d'écoute 80/tcp (http) 443/tcp (https) Localisatio Tous les ordiateurs exécutat le cliet léger ou le cliet riche. Bade passate Autre paramètre-clé de la cofiguratio réseau à predre e compte : la bade passate. Elle est presque toujours sortate et très sollicitée pedat les diffusios d' s. Voici quelques exemples de cofiguratios reposat sur otre expériece : 1 Mb/s pour s par heure (taille moyee de 30 Ko) 8 à 10 Mb/s pour s par heure (taille moyee de 30 Ko) Astuce : Si vous avez des cotraites de bade passate, il est toutefois possible de plaifier l'exécutio des campages d' ig la uit, lorsque celle-ci est mois utilisée. 20 Neolae 2013

22 CHAPITRE 3 Types de déploiemets Table des matières Itroductio Déploiemet Stad-aloe (moomachie) Caractéristiques Etapes d'istallatio et de cofiguratio d'ue istace Déploiemet Stadard Caractéristiques Etapes d'istallatio et de cofiguratio d'ue istace Déploiemet Etreprise Caractéristiques Etapes d'istallatio et de cofiguratio d'ue istace Déploiemet Mid-sourcig Caractéristiques Etapes d'istallatio et de cofiguratio d'ue istace Optios Dedicated Executio Istace et High-Availability Cluster Présetatio Applicatios éligibles Packages Neolae à istaller Matrice de recommadatios architecturales Recommadatios Itroductio La coceptio modulaire de Neolae permet de ombreuses cofiguratios de déploiemet, d'ue istallatio e "stad-aloe" (tous les composats sur ue uique machie) à des cofiguratios d'etreprise impliquat ue architecture etièremet distribuée et redodate via de multiples serveurs. Tout déped des iveaux de performace, de redodace et de sécurité souhaités. Das le cas d'ue cofiguratio sur plusieurs machies, il 'est pas écessaire qu'elles utiliset toutes le même système d'exploitatio. E effet, il est possible d'utiliser par exemple u serveur de redirectio sous Liux + Apache avec des serveurs de diffusio sous Widows. Neolae v6.0 - Guide d'istallatio - Types de déploiemets 21

23 Neolae Déploiemet Stad-aloe (moomachie) Cette cofiguratio regroupe tous les composats sur ue seule machie : processus applicatif (web), processus de diffusio (mta), processus de redirectio (trackig), processus de workflow et tâches plaifiées (wfserver), processus des mails rebods (imail), processus de statistiques (stat). La commuicatio géérale etre les processus est réalisée coformémet au schéma suivat : Ce type de cofiguratio est parfaitemet adapté lorsque les listes gérées cotieet mois de destiataires, et avec, par exemple, les couches logicielles suivates : Liux, Apache, PostgreSQL, Qmail. Lorsque le volume s'accroît, ue variate de cette architecture déporte le serveur de base de doées sur ue autre machie, pour de meilleures performaces. 22 Neolae 2013

24 Types de déploiemets U serveur de base de doées préexistat peut être utilisé, sous réserve qu'il dispose de ressources suffisates. Caractéristiques Avatages Totalemet stad-aloe et coût de cofiguratio faible (aucue licece payate si l'o utilise les composats logiciels, tous Ope Source, listés ci-dessus). Istallatio et cofiguratio réseau simplifiées. Icovéiets Ue machie critique e cas d'icidet. Débit limité pedat les diffusios des messages (selo otre expériece, de l'ordre de quelques dizaies de milliers de mails par heure). Raletissemet possible de l'applicatio pedat les diffusios. Le serveur applicatif doit être accessible depuis l'extérieur (e état placé das la DMZ, par exemple), puisqu'il accueille le serveur de redirectio. Cofiguratio matérielle recommadée Serveur applicatif : processeur quad-core 2 Ghz, 4 Go de mémoire, disque e RAID 1 Soft 80 Go SATA. Serveur applicatif avec base de doées : Bi-quad core 3 Ghz, 4 Go de mémoire ou plus, disque e RAID 10 hardware SAS tr/mi, le ombre dépedat de la taille et de la performace attedue de la base de doées. Etapes d'istallatio et de cofiguratio d'ue istace Prérequis JDK 1.6, Serveur Web (IIS, Apache), Accès à u serveur de base de doées, Boîte pour les mails rebods accessible e POP3, Créatio de deux alias DNS : u premier alias exposé au grad public pour le trackig et poitat vers la machie sur so IP publique ; u deuxième alias exposé aux utilisateurs métier pour l'accès cosole et poitat vers la même machie. Cofiguratio du firewall pour l'ouverture des ports SMTP (25), DNS (53), HTTP (80), HTTPS (443), SQL (1521 pour Oracle, 5432 pour PostgreSQL, etc.). Pour plus d'iformatios, reportez-vous à la sectio Accès à la base de doées [page 19] Les paramètres de l'istace sot les suivats : Nom de l'istace : demo Masque DNS : cosole.eolae.et* (uiquemet pour la coexio des cosoles clietes et pour les rapports) Base de doées : eolae:demo@dbsrv Istaller et cofigurer Neolae sur ue istace moo-machie Les étapes sot les suivates : 1 Respectez la procédure d'istallatio du serveur Neolae : packages lserver et thirdparty sous Liux ou setup.exe sous Widows. Voir sur ce sujet les sectios Istallatio sous Liux [page 59] et Istallatio sous Widows [page 43]. Neolae v6.0 - Guide d'istallatio - Types de déploiemets 23

25 Neolae 2 Ue fois l'istallatio du serveur Neolae termiée, démarrez le serveur applicatif (web) avec la commade lserver web -tomcat (le module Web permet de lacer Tomcat e mode serveur Web autoome e écoute sur le port 8080) et vérifiez que Tomcat démarre correctemet : 12:08:18 > Applicatio server for Neolae Versio (build 6636) of 15/02/ :08:18 > Startig Web server module (pid=28505, tid= )... 12:08:18 > Tomcat started 12:08:18 > Server started La première exécutio du module Web permet de créer les fichiers cofig-default.xml et servercof.xml das le répertoire cof, sous le répertoire d'istallatio. Appuyez sur Ctrl+C pour arrêter le serveur. Voir sur ce sujet les sectios suivates : Pour Liux : Premier démarrage du serveur Neolae [page 64], Pour Widows : Premier démarrage du serveur Neolae [page 48]. 3 Créez l'istace ommée demo avec les masques DNS pour le trackig (ici : trackig.eolae.et) et l'accès aux cosoles clietes (ici : cosole.eolae.et). Pour cela, deux méthodes sot possibles : Créer l'istace via la cosole : Voir à ce sujet Créatio et coexio à ue istace [page 72]. ou Créer l'istace e lige de commade : lserver cofig -addistace:demo/trackig.eolae.et*,cosole.eolae.et* Voir sur ce sujet Commades de créatio d'ue istace [page 163]. 4 Editez le fichier cofig-demo.xml (créé à l'étape précédete et eregistré das le même répertoire que le fichier cofig-default.xml), vérifiez que les processus mta (diffusio), wfserver (workflow), imail (mails rebods) et stat (statistiques) sot activés. Puis cofigurez l'adresse du serveur de statistiques : <?xml versio='1.0'?> <servercof> <shared> <!-- add lag="eg" to datastore to force Eglish for the istace --> <datastore hosts="trackig.eolae.et*,cosole.eolae.et*"> <mappig logical="*" physical="default"/> </datastore> </shared> <mta autostart="true" statserveraddress="localhost"/> 24 Neolae 2013

26 Types de déploiemets <wfserver autostart="true"/> <imail autostart="true"/> <sms autostart="false"/> <listprotect autostart="false"/> </servercof> Voir à ce propos la sectio Activatio des processus [page 85]. 5 Editez le fichier servercof.xml et reseigez le domaie de diffusio puis idiquez les adresses IP (ou host) des serveurs DNS utilisés pour répodre aux requêtes DNS de type MX par le module MTA. <dscofig localdomai="eolae.com" ameservers=" , "/> Le paramètre ameservers 'est utile que sous Widows. Voir sur ces sujets la sectio Paramétrage du serveur [page 84]. 6 Chagez le mot de passe iteral à partir de la commade : lserver cofig -iteralpassword Voir à ce propos la sectio Idetifiat 'iteral' [page 85]. 7 Copiez le programme d'istallatio des cosoles clietes (setup-cliet-6.0.xx.yyyy.exe) das le dossier /datakit/l/fra/jsp. Voir à ce propos les sectios suivates : Pour Liux : Mise à dispositio de la cosole cliete [page 55], Pour Widows : Mise à dispositio de la cosole cliete [page 55]. 8 Suivez la procédure d'itégratio du serveur Web (IIS, Apache) décrite das les sectios suivates : Pour Liux : Itégratio à u serveur Web [page 65], Pour Widows : Itégratio à u serveur Web [page 49]. 9 Démarrez le site Web et testez la redirectio à partir de l'url : Le avigateur doit afficher le message suivat : <redir status="ok" date="2011/02/15 17:18:54.328" build="6636" host="trackig.eolae.et" localhost="localhost"/> Voir à ce propos les sectios suivates : Pour Liux : Lacemet du serveur Web et test de la cofiguratio [page 68], Pour Widows : Lacemet du serveur Web et test de la cofiguratio [page 53]. 10 Démarrez le serveur Neolae (et start lserver6 sous Widows, /etc/iit.d/lserver6 start sous Liux) et lacez à ouveau la commade lserver pdump afi de vérifier la présece de tous les modules actifs. 12:09:54 > Applicatio server for Neolae Versio (build 6648) of 18/02/2011 syslogd@default (7611) MB stat@demo (5988) Mo imail@demo (7830) MB watchdog (27369) MB mta@demo (7831) MB wfserver@demo (7832) MB web@default (28671) MB Astuce : Cette commade permet aussi de coaître la versio et le uméro de build du serveur Neolae istallé sur la machie. 11 Testez le module lserver web à partir de l'url : Cette URL permet d'accéder à la page de téléchargemet du programme d'istallatio cliet. Neolae v6.0 - Guide d'istallatio - Types de déploiemets 25

27 Neolae Saisissez l'idetifiat (logi) iteral avec so mot de passe associé à partir de la page itermédiaire de cotrôle d'accès. Voir à ce propos les sectios suivates : Pour Liux : Mise à dispositio de la cosole cliete Neolae [page 68], Pour Widows : Mise à dispositio de la cosole cliete [page 55]. 12 Lacez la cosole cliete Neolae (récupérée à partir de la page de téléchargemet de l'étape précédete ou lacée directemet sur le serveur pour ue istallatio Widows), paramétrez l'url de coexio du serveur avec l'url et coectez-vous avec l'idetifiat (logi) iteral. Voir Créatio d'ue ouvelle coexio [page 72] et Idetifiat 'iteral' [page 85]. L'assistat de créatio de base de doées apparaît lors de la première coexio : Suivez les étapes de l'assistat et créez la base de doées associée à l'istace de coexio. Voir à ce propos la sectio Créatio et paramétrage de la base de doées [page 74]. Ue fois la créatio de la base de doées termiée, vous devez vous décoecter. 13 Coectez-vous à ouveau à la cosole cliete avec l'idetifiat admi sas mot de passe et lacez l'assistat de déploiemet (meu Outils>Avacé) pour fialiser la cofiguratio de l'istace. Voir à ce sujet la sectio Déploiemet d'ue istace Neolae [page 86]. Les paramètres pricipaux à reseiger sot les suivats : 26 Neolae 2013

28 Types de déploiemets Evoi d' les adresses expéditeur, de répose et la boîte d'erreur pour les mails rebods. Trackig : reseigez l'url extere utilisée pour la redirectio et l'url itere puis cliquez sur Eregistremet auprès du ou des serveurs de trackig et validez sur l'istace demo du serveur de trackig. Voir à ce sujet la sectio Paramétrage du trackig [page 92]. Le serveur Neolae état le serveur applicatif et de redirectio, l'url itere utilisée pour la collecte des logs de trackig et le trasfert des URL est ue coexio itere directe sur Tomcat ( Gestio des mails rebods : reseigez les paramètres de gestio des mails rebods (e pas teir compte de la sectio Mails rebods o traités). Accès depuis Iteret : reseigez les deux URL d'accès pour les rapports ou les formulaires Web et les pages miroir. Déploiemet Stadard Pour cette cofiguratio, trois machies sot écessaires : U serveur applicatif situé das le LAN, qui sert les utilisateurs (préparatio des diffusios, reportig, etc.), Deux machies frotales situées e DMZ derrière u répartiteur de charge. Neolae v6.0 - Guide d'istallatio - Types de déploiemets 27

29 Neolae Les deux machies das la DMZ preet e charge le trackig, la gestio des pages miroir et l'evoi des mails, et sot mises e redodace afi d'obteir ue haute dispoibilité. Le serveur applicatif situé das le LAN sert les utilisateurs et effectue tous les traitemets récurrets (moteur de workflow). Aisi, e cas de pic de charge sur les frotaux, les utilisateurs métier e sot pas impactés. Le serveur de base de doées peut être ue machie déjà existate (ou ue ouvelle machie) disticte de ces trois machies. Il est toutefois possible de cumuler les foctios de serveur applicatif das le LAN et de serveur de base de doées sur la même machie. Ceci suppose cepedat qu'elle foctioe sur u système d'exploitatio supporté par Neolae (Liux ou Widows). La commuicatio géérale etre les serveurs et les processus est réalisée coformémet au schéma suivat : Ce type de cofiguratio peut faire face à u grad ombre de profils de destiataires (de à ), le serveur de base de doées état le pricipal facteur de limite (aisi que la bade passate dispoible). Caractéristiques Avatages Possibilité de basculer tous les processus sur ue seule machie e cas de problème matériel sur l'ue des deux machies. 28 Neolae 2013

30 Types de déploiemets Meilleures performaces globales, puisque les MTA et la redirectio derrière u répartiteur de charge peuvet être déployés sur les deux machies. Avec deux MTA actifs et assez de bade passate, o peut obteir des taux de diffusio d'eviro mails par heure. Cofiguratio matérielle recommadée Serveur applicatif : processeur quad-core à 2 GHz, 4 Go de mémoire, disque e RAID 1 Soft 80 Go SATA. Serveurs frotaux : processeur quad-core à 2 GHz, 4 Go de mémoire, disque e RAID 1 Soft 80 Go SATA. Etapes d'istallatio et de cofiguratio d'ue istace Prérequis JDK 1.6 sur les trois machies, Serveur Web (IIS, Apache) sur les deux frotaux, Accès à u serveur de base de doées sur les trois machies, Boîte pour les mails rebods accessible e POP3, Créatio de deux alias DNS : u premier alias exposé au grad public pour le trackig et poitat vers le répartiteur de charge sur ue adresse IP virtuelle (VIP) qui est esuite distribuée sur les deux frotaux de trackig, u deuxième alias exposé aux utilisateurs métiers pour l'accès cosole et poitat vers serveur applicatif. Cofiguratio du firewall pour l'ouverture des ports SMTP (25), DNS (53), HTTP (80), HTTPS (443), SQL (1521 pour Oracle, 5432 pour PostgreSQL, etc.). Pour plus d'iformatios, reportez-vous à la sectio Accès à la base de doées [page 19] Istaller et cofigurer Neolae pour u déploiemet stadard Istallatio du serveur applicatif Respectez les étapes d'istallatio d'ue istace moo-machie à partir du serveur applicatif Neolae jusqu'à la créatio de la base de doées (étape 12). Voir Istaller et cofigurer Neolae sur ue istace moo-machie [page 23]. La machie 'état pas u serveur de trackig, e pas teir compte de l'itégratio du serveur Web. Les paramètres de l'istace sot les suivats : Nom de l'istace : demo Masque DNS : cosole.eolae.et* (uiquemet pour la coexio des cosoles clietes et pour les rapports) Lague : fraçaise Base de doées : eolae:demo@dbsrv Istallatio des deux serveurs frotaux La procédure d'istallatio et de paramétrage est idetique sur les deux machies. Les étapes sot les suivates : 1 Istallez le serveur Neolae. Voir sur ce sujet les sectios Istallatio sous Liux [page 59] et Istallatio sous Widows [page 43]. 2 Suivez la procédure d'itégratio du serveur Web (IIS, Apache) décrite das les sectios suivates : Pour Liux : Itégratio à u serveur Web [page 65], Pour Widows : Itégratio à u serveur Web [page 49]. 3 Créez l'istace ommée demo. Pour cela, deux méthodes sot possibles : Neolae v6.0 - Guide d'istallatio - Types de déploiemets 29

31 Neolae Créer l'istace via la cosole : Voir à ce sujet Créatio et coexio à ue istace [page 72]. ou Créer l'istace e lige de commade : lserver cofig -addistace:demo/trackig.eolae.et* Voir sur ce sujet Commades de créatio d'ue istace [page 163]. Le om de l'istace est le même que le celui du serveur applicatif. La coexio au serveur avec le module lserver web (pages miroir, désiscriptio) s'effectuera à partir de l'url du répartiteur de charge (trackig.eolae.et). 4 Remplacez le mot de passe iteral par celui du serveur applicatif. Voir à ce propos la sectio Idetifiat 'iteral' [page 85]. 5 Rattachez la base de doées sur l'istace : lserver cofig -setdblogi:postgresql:eolae:demo@dbsrv -istace:demo 6 A partir des fichiers cofig-default.xml et cofig-demo.xml, activez les modules web, trackiglogd et mta. Voir à ce propos la sectio Activatio des processus [page 85]. 7 Editez le fichier servercof.xml et reseigez : la cofiguratio DNS du module MTA : <dscofig localdomai="eolae.com" ameservers=" , "/> Le paramètre ameservers 'est utile que sous Widows. Voir à ce propos la sectio Paramètres de diffusio [page 86]. les serveurs de trackig redodats das les paramètres de la redirectio : <spareserver eabledif="$(hostame)!='frot_srv1'" id="1" url=" <spareserver eabledif="$(hostame)!='frot_srv2'" id="2" url=" 30 Neolae 2013

32 Types de déploiemets Voir à ce propos Trackig redodat [page 109]. 8 Démarrez le site Web et testez la redirectio à partir de l'url : Le avigateur doit afficher les messages suivats (e foctio de l'url redirigée par le répartiteur de charge) : <redir status="ok" date="2011/02/15 17:18:54.328" build="6636" host="trackig.eolae.et" localhost="frot_srv1"/> ou bie <redir status="ok" date="2011/02/15 17:18:54.328" build="6636" host="trackig.eolae.et" localhost="frot_srv2"/> Voir à ce propos les sectios suivates : Pour Liux : Lacemet du serveur Web et test de la cofiguratio [page 68], Pour Widows : Lacemet du serveur Web et test de la cofiguratio [page 53]. 9 Lacez le serveur Neolae. 10 Coectez-vous avec ue cosole cliete Neolae avec l'idetifiat (logi) admi sas mot de passe et lacez l'assistat de déploiemet. Voir à ce sujet la sectio Déploiemet d'ue istace Neolae [page 86]. Le paramétrage est idetique à celui d'ue istace moo-machie à l'exceptio de la cofiguratio du module de trackig. 11 Reseigez l'url extere (celle du répartiteur de charge) utilisée pour la redirectio et les URL iteres des deux serveurs frotaux. Voir à ce propos la sectio Paramétrage du trackig [page 92]. Neolae v6.0 - Guide d'istallatio - Types de déploiemets 31

33 Neolae O utilise l'istace déjà existate des deux serveurs de trackig créés précédemmet e utilisat le mot de passe du logi iteral. Déploiemet Etreprise Il s'agit de la cofiguratio la plus complète. Elle éted la cofiguratio stadard pour ue sécurité accrue et ue dispoibilité supérieure : serveurs de redirectio dédiés, derrière u répartiteur de charge agissat au iveau HTTP ou au iveau TCP, pour ue motée e charge et ue grade dispoibilité, deux serveurs applicatifs, pour u meilleur débit et des capacités de fail-over (foctioemet même e cas de pae d'u serveur), isolés das le LAN. La commuicatio géérale etre les serveurs et les processus est réalisée coformémet au schéma suivat : Le débit attedu das ce type de cofiguratio peut être supérieur à mails par heure avec le paramétrage et la bade-passate adéquats. Caractéristiques Avatages Optimisatio de la sécurité : seuls les services qui ot besoi d'être exposés à l'extérieur sot istallés sur la machie de la DMZ. 32 Neolae 2013

34 Types de déploiemets Haute dispoibilité plus aisée à garatir : seule la machie visible de l'extérieur doit être gérée pour la haute dispoibilité. Icovéiets Coûts du matériel et d'admiistratio plus élevés. Matériel recommadé Serveurs applicatifs : processeur quad-core à 2 GHz, 4 Go de mémoire, disque e RAID 1 Soft 80 Go SATA. Serveurs de redirectio : processeur quad-core à 2 GHz, 2 Go de mémoire, disque e RAID 1 Soft 80 Go SATA. Il est possible de réutiliser u répartiteur de charge déjà déployé pour répartir le trafic vers les serveurs de redirectio. Etapes d'istallatio et de cofiguratio d'ue istace Prérequis JDK 1.6 sur les deux serveurs applicatifs, Serveur Web (IIS, Apache) sur les deux frotaux, Accès à u serveur de base de doées sur les deux serveurs applicatifs, Boîte pour les mails rebods accessible e POP3, Créatio de deux alias DNS sur le répartiteur de charge : u premier alias exposé au grad public pour le trackig et poitat vers le répartiteur de charge sur ue adresse IP virtuelle (VIP) qui est esuite distribuée sur les deux frotaux de trackig, u deuxième alias exposé aux utilisateurs métiers pour l'accès cosole et poitat vers u répartiteur de charge sur ue adresse IP virtuelle (VIP) qui est esuite distribuée sur les deux serveurs applicatifs. Cofiguratio du firewall pour l'ouverture des ports SMTP (25), DNS (53), HTTP (80), HTTPS (443), SQL (1521 pour Oracle, 5432 pour PostgreSQL, etc.). Pour plus d'iformatios, reportez-vous à la sectio Accès à la base de doées [page 19] Istaller et cofigurer Neolae pour u déploiemet "etreprise" Procédure d'istallatio du serveur applicatif 1 Les paramètres de l'istace sot les suivats : Nom de l'istace : demo Masque DNS : trackig.eolae.et*, cosole.eolae.et* (le serveur applicatif gère les URL pour la coexio des cosoles clietes et des rapports, aisi que les URL des pages miroir et de désiscriptio) Lague : fraçaise Base de doées : eolae:demo@dbsrv Les étapes d'istallatio du premier serveur sot les suivates : 1 Respectez la procédure d'istallatio du serveur Neolae : packages lserver et thirdparty sous Liux ou setup.exe sous Widows. Voir sur ce sujet les sectios Istallatio sous Liux [page 59] et Istallatio sous Widows [page 43]. 2 Ue fois l'istallatio du serveur Neolae termiée, démarrez le serveur applicatif (web) avec la commade lserver web -tomcat (le module Web permet de lacer Tomcat e mode serveur Web autoome e écoute sur le port 8080) et vérifiez que Tomcat démarre correctemet : 12:08:18 > Applicatio server for Neolae Versio (build 6636) of 15/02/ :08:18 > Startig Web server module (pid=28505, tid= )... 12:08:18 > Tomcat started 12:08:18 > Server started Neolae v6.0 - Guide d'istallatio - Types de déploiemets 33

35 Neolae La première exécutio du module Web permet de créer les fichiers cofig-default.xml et servercof.xml das le répertoire cof, sous le répertoire d'istallatio. Appuyez sur Ctrl+C pour arrêter le serveur. Voir sur ce sujet les sectios suivates : Pour Liux : Premier démarrage du serveur Neolae [page 64], Pour Widows : Premier démarrage du serveur Neolae [page 48]. 3 Créez l'istace ommée demo avec les masques DNS pour le trackig (ici : trackig.eolae.et) et l'accès aux cosoles clietes (ici : cosole.eolae.et). Pour cela, deux méthodes sot possibles : Créer l'istace via la cosole : Voir à ce sujet Créatio et coexio à ue istace [page 72]. ou Créer l'istace e lige de commade : lserver cofig -addistace:demo/trackig.eolae.et*,cosole.eolae.et* Voir sur ce sujet Commades de créatio d'ue istace [page 163]. 4 Editez le fichier cofig-demo.xml (ouvellemet créé à partir de la commade précédete et préset à côté du fichier cofig-default.xml), vérifiez que les processus mta (diffusio), wfserver (workflow), imail (mails rebods) et stat (statistiques) sot activés. Puis cofigurez l'adresse du serveur de statistiques app: <?xml versio='1.0'?> <servercof> <shared> <!-- add lag="eg" to datastore to force Eglish for the istace --> <datastore hosts="trackig.eolae.et*,cosole.eolae.et*"> <mappig logical="*" physical="default"/> </datastore> </shared> <mta autostart="true" statserveraddress="app"> <wfserver autostart="true"/> <imail autostart="true"/> <sms autostart="false"/> <listprotect autostart="false"/> </servercof> Voir à ce propos la sectio Activatio des processus [page 85]. 34 Neolae 2013

36 Types de déploiemets 5 Editez le fichier servercof.xml et reseigez le domaie de diffusio puis idiquez les adresses IP (ou host) des serveurs DNS utilisés pour répodre aux requêtes DNS de type MX par le module MTA. <dscofig localdomai="eolae.com" ameservers=" , "/> Le paramètre ameservers 'est utile que sous Widows. Voir sur ces sujets la sectio Paramétrage du serveur [page 84]. 6 Chagez le mot de passe iteral à partir de la commade : lserver cofig -iteralpassword Voir à ce propos la sectio Idetifiat 'iteral' [page 85]. 7 Copiez le programme d'istallatio des cosoles clietes (setup-cliet-6.0.xx.yyyy.exe) das le dossier /datakit/l/fra/jsp. Voir à ce propos les sectios suivates : Pour Liux : Mise à dispositio de la cosole cliete Neolae [page 68], Pour Widows : Mise à dispositio de la cosole cliete [page 55]. 8 Démarrez le serveur Neolae (et start lserver6 sous Widows, /etc/iit.d/lserver6 start sous Liux) et lacez à ouveau la commade lserver pdump afi de vérifier la présece de tous les modules actifs. 12:09:54 > Applicatio server for Neolae Versio (build 6648) of 18/02/2011 syslogd@default (7611) MB stat@demo (5988) Mo imail@demo (7830) MB watchdog (27369) MB mta@demo (7831) MB wfserver@demo (7832) MB web@default (28671) MB Astuce : Cette commade permet aussi de coaître la versio et le uméro de build du serveur Neolae istallé sur la machie. 9 Testez le module lserver web à partir de l'url : Cette URL permet d'accéder à la page de téléchargemet du programme d'istallatio cliet. Saisissez l'idetifiat (logi) iteral avec so mot de passe associé à partir de la page itermédiaire de cotrôle d'accès. Voir à ce propos les sectios suivates : Pour Liux : Mise à dispositio de la cosole cliete Neolae [page 68], Pour Widows : Mise à dispositio de la cosole cliete [page 55]. Neolae v6.0 - Guide d'istallatio - Types de déploiemets 35

37 Neolae Procédure d'istallatio du serveur applicatif 2 Les étapes sot les suivates : 1 Istallez le serveur Neolae, 2 Copiez les fichiers de l'istace créée sur le serveur applicatif 1 Le om d'istace du serveur applicatif 1 doit être coservé. 3 Remplacez le mot de passe iteral par celui du serveur applicatif N 1. 4 Rattachez la base de doées sur l'istace : lserver cofig -setdblogi:postgresql:eolae:demo@dbsrv -istace:demo 5 Editez le fichier cofig-demo.xml (ouvellemet créé à partir de la commade précédete et préset à côté du fichier cofig-default.xml), vérifiez que les processus mta (diffusio), wfserver (workflow), imail (mails rebods) et stat (statistiques) sot activés puis cofigurez l'adresse du serveur de statistiques app: <?xml versio='1.0'?> <servercof> <shared> <!-- add lag="eg" to datastore to force Eglish for the istace --> <datastore hosts="trackig.eolae.et*,cosole.eolae.et*"> <mappig logical="*" physical="default"/> </datastore> </shared> <mta autostart="true" statserveraddress="app"> <wfserver autostart="true"/> <imail autostart="true"/> <sms autostart="false"/> <listprotect autostart="false"/> </servercof> Voir à ce propos la sectio Activatio des processus [page 85]. 6 Editez le fichier servercof.xml et reseigez la cofiguratio DNS du module MTA : <dscofig localdomai="eolae.com" ameservers=" , "/> Le paramètre ameservers 'est utile que sous Widows. Voir sur ce sujet la sectio Paramétrage du serveur [page 84]. 7 Démarrez les serveurs Neolae. Voir sur ce sujet les sectios suivates : Pour Liux : Premier démarrage du serveur Neolae [page 64], Pour Widows : Premier démarrage du serveur Neolae [page 48]. Procédure d'istallatio des serveurs frotaux Les procédures d'istallatio et de paramétrage sot idetiques sur les deux machies. Les étapes sot les suivates : 1 Istallez le serveur Neolae, 2 Respectez la procédure d'itégratio du serveur Web (IIS, Apache) décrite das les sectios suivates : Pour Liux : Itégratio à u serveur Web [page 65], Pour Widows : Itégratio à u serveur Web [page 49]. 36 Neolae 2013

38 Types de déploiemets 3 Copiez les fichiers cofig-demo.xml et servercof.xml créés lors de l'istallatio, puis, das le fichier cofig-demo.xml, activez le processus trackiglogd et désactivez les processus mta, imail, wfserver et stat. 4 Editez le fichier servercof.xml et reseigez les serveurs de trackig redodats das les paramètres de la redirectio : <spareserver eabledif="$(hostame)!='frot_srv1'" id="1" url=" <spareserver eabledif="$(hostame)!='frot_srv2'" id="2" url=" 5 Démarrez le site Web et testez la redirectio à partir de l'url : Le avigateur doit afficher les messages suivats (e foctio de l'url redirigée par le répartiteur de charge) : <redir status="ok" date="2011/02/15 17:18:54.328" build="6636" host="trackig.eolae.et" localhost="frot_srv1"/> ou bie <redir status="ok" date="2011/02/15 17:18:54.328" build="6636" host="trackig.eolae.et" localhost="frot_srv2"/> Voir à ce propos les sectios suivates : Pour Liux : Lacemet du serveur Web et test de la cofiguratio [page 68], Pour Widows : Lacemet du serveur Web et test de la cofiguratio [page 53]. 6 Lacez le serveur Neolae. Déploiemet Mid-sourcig Cette cofiguratio présete ue solutio itermédiaire optimale etre le mode hébergé (ASP) et l'iteralisatio. Toute la partie cocerat l'evoi des messages est déportée sur u serveur de "mid-sourcig", hébergé chez Neolae. Avertissemet : Pour mettre e place u déploiemet e Mid-sourcig, vous devez acquérir l'optio correspodate. Vérifiez votre cotrat de licece. Neolae v6.0 - Guide d'istallatio - Types de déploiemets 37

39 Neolae La commuicatio géérale etre les serveurs et les processus est réalisée coformémet au schéma suivat : Les modules de diffusio et de gestio des mails rebods sot désactivés sur l'istace. L'applicatio est cofigurée pour déléguer les evois des messages à u serveur de mid-sourcig distat via des appels SOAP (sur HTTP ou HTTPS). Caractéristiques Avatages Cofiguratio du serveur beaucoup plus simple : il 'est pas écessaire pour le cliet de cofigurer les modules commuiquat avec l'extérieur (mta et imail). Bade passate limitée : l'evoi des s état effectué par le serveur de mid-sourcig, il suffit de prévoir u débit écessaire à l'evoi des doées de persoalisatio au serveur de mid-sourcig. La haute dispoibilité 'est plus écessaire : la problématique est reportée sur le serveur de mid-sourcig (redirectio, pages miroir, serveurs de diffusio, etc.). La base de doées e sort pas de l'etreprise : seules les doées écessaires à l'assemblage des messages sot evoyées au serveur de mid-sourcig (évetuellemet e HTTPS). Ce type de déploiemet peut être ue solutio pour les architectures à gros volumes (beaucoup de destiataires e base), avec u débit d'evoi élevé. Icovéiets U léger délai das la visualisatio des iformatios de diffusio des messages et du reportig lié à la remotée de ces iformatios depuis la base de mid-sourcig. Les questioaires et les formulaires web restet localisés sur la plateforme cliete. Matériel recommadé Serveur applicatif : processeur quad-core à 2 GHz, 4 Go de mémoire, disque e RAID 1 Soft 80 Go SATA. 38 Neolae 2013

40 Types de déploiemets Serveur de base de doées : processeurs bi-quad core 3 GHz, 4 Go de mémoire ou plus, disque e RAID 10 hardware SAS tr/mi, le ombre dépedat de la taille et de la performace attedue de la base de doées. La redirectio est complètemet découplée du mid-sourcig, mais e gééral le serveur de trackig sera mutualisé avec les serveurs de mid-sourcig. Etapes d'istallatio et de cofiguratio d'ue istace Prérequis JDK 1.6 sur le serveur applicatif. Accès à u serveur de base de doées sur le serveur applicatif. Cofiguratio du firewall pour l'ouverture du port HTTP (80) ou HTTPS (443) vers le serveur de mid-sourcig. Istaller et cofigurer Neolae pour u déploiemet e mid-sourcig Reportez-vous à la sectio Cofiguratio et déploiemet d'u serveur de mid-sourcig [page 155]. Optios Dedicated Executio Istace et High-Availability Cluster Présetatio Neolae fourit deux séries d'optios architecturales pré-packagées permettat de dimesioer votre déploiemet : Neolae Dedicated Executio Istace Cette optio fourit u support pour ue istace d'exécutio supplémetaire découplée de l'istace applicative Neolae pricipale e rapport avec ue applicatio doée. Ue istace dédiée peut être hébergée hors site ou bie par u prestataire tiers. Lorsqu'elle est mise e oeuvre, l'exécutio , le trackig, les pages miroir et les messages «bouce» sot pris e charge idépedammet des foctioalités de l'applicatio cetrale. Neolae High-Availability Cluster Cette optio fourit u support pour 2 à N istaces d'exécutio e cofiguratio clusterisée découplées de l'istace applicative Neolae pricipale et ceci e rapport avec ue applicatio doée. Des clusters peuvet être hébergés hors site, das des déploiemets distribués ou bie par des prestataires tiers. E plus des bééfices d'isolatio des processus, l'optio Neolae High-Availability Cluster permet la redodace Neolae v6.0 - Guide d'istallatio - Types de déploiemets 39

41 Neolae aisi que des stratégies «scale out» à base de matériel baalisé pour ue évolutio simplifiée du iveau de service ou de performace. Applicatios éligibles Les optios Neolae Dedicated Executio Istace et Neolae High-Availability Cluster peuvet être exploitées par les applicatios suivates : Neolae Campaig Neolae Leads Neolae Delivery Neolae Message Ceter Packages Neolae à istaller Le tableau suivat vous idique, pour chaque applicatio, les packages à istaller sur la ou les istaces dédiées. Applicatio Neolae Delivery, Campaig, Leads Message Ceter Neolae Iteractio Package à istaller Plate-forme de Mid-sourcig Exécutio des messages trasactioels - Ue istace d'exécutio utilise toujours ue base de doées dédiée. Cette base de doées peut être das ue techologie différete de celle utilisée pour la base pricipale. La base de doées de l'istace dédiée peut utiliser 'importe quel moteur de base de doées (SGBD) supporté ativemet pas Neolae (PostgreSQL, Oracle, SQL Server, etc). Par exemple, si la base pricipale est e SQL Server, l'istace d'exécutio peut être e PostgreSQL. Matrice de recommadatios architecturales Architecture stadard Dedicated Executio Istace High-Availability Cluster Campages et iteractios sortates Jusqu'à eviro 30 millios d' s par mois millios d' s par mois Au-delà de 60 millios d' s par mois 40 Neolae 2013

42 Types de déploiemets Messages trasactioels Jusqu'à plusieurs milliers par jour Jusqu'à par jour Au-delà de par jour Iteractios etrates Quelques iteractios par secode Jusqu'à 10 par secode Au-delà de 10 par secode Dispoibilité Celle de la base pricipale 24/7 sauf pour maiteace et arrêts de l'istace d'exécutio Service 24/7/365 possible Sécurité Datamart est potetiellemet accessible depuis l'iteret public Datamart isolé des composats frotaux exposés sur l'iteret public Datamart est isolé des composats frotaux exposés sur l'iteret public Modèle de déploiemet Tout sur site (peut être o premise ou bie das le cloud) Foctios marketig o premise avec ue exécutio das le cloud possible Foctios marketig o premise avec ue exécutio das le cloud possible ; exécutio das de multiples géographies possible Recommadatios Ue istace d'exécutio doit être dédiée à u service. Vous e pouvez pas istaller u package correspodat à u service auquel vous 'avez pas souscrit. Par exemple, si vous avez souscrit à l'optio Neolae Dedicated Executio Istace pour le service Message Ceter, vous e pouvez istaller que le package Exécutio des messages trasactioels sur l'istace d'exécutio dédiée. Vérifiez votre cotrat de licece. Das la mesure où les istaces dédiées ou clusters sot des istaces Neolae, les recommadatios sot les mêmes que pour ue istace pricipale. Voir à ce sujet le Guide d'exploitatio. Pour dimesioer correctemet l'istace d'u poit de vue base de doées/composats hardware, ous vous ivitos à vous rapprocher des services professioels de Neolae. Neolae v6.0 - Guide d'istallatio - Types de déploiemets 41

43 Neolae 42 Neolae v6.0 - Guide d'istallatio

44 CHAPITRE 4 Istallatio sous Widows Table des matières Avat d'istaller Prérequis logiciels sous Widows Etapes de mise e oeuvre Accessibilité Istallatio du serveur Neolae Exécutio du programme d'istallatio Test sommaire de l'istallatio Premier démarrage du serveur Neolae Mot de passe de l'idetifiat iteral Démarrage des services Neolae Itégratio à u serveur Web Présetatio Cofiguratio du serveur Web IIS Mise à dispositio de la cosole cliete Istallatio de la cosole cliete Neolae Avat d'istaller Prérequis logiciels sous Widows La cofiguratio techique et logicielle requise pour l'istallatio de Neolae est présetée das la sectio Cofiguratio requise [page 11]. Les élémets de paramétrage des logiciels requis pour Widows sot présetés ci-après. OpeOffice.org Ue fois OpeOffice.org istallé, éditez la liste des services Widows et éditez les propriétés du service Neolae. Depuis l'oglet Coexio, cochez l'optio Autoriser le service à iteragir avec le Bureau. Seule l'istallatio des composats traitemet de texte (Writer) et tableur (Calc) est écessaire. La versio e lague aglaise est suffisate. Neolae v6.0 - Guide d'istallatio - Istallatio sous Widows 43

45 Neolae Etapes de mise e oeuvre Istallatio d'u serveur multi-istaces Le processus d'istallatio d'u serveur Neolae, pour u usage multi-istaces, est décrit ci-après, das la sectio Istallatio du serveur Neolae [page 44]. Les étapes pricipales sot les suivates : 1 Istaller le serveur applicatif, voir Exécutio du programme d'istallatio [page 44]. 2 Itégrer à u serveur Web (optioel, e foctio des composats déployés), voir Cofiguratio du serveur Web IIS [page 49]. Paramétrage des istaces Ue fois les étapes d'istallatio termiées, vous devez procéder à la cofiguratio des istaces et de la base de doées et au paramétrage du serveur. Voir à ce sujet le chapitre Cofiguratio de Neolae [page 71]. Accessibilité Couches d'accès base de doées Les couches d'accès pour le moteur de base de doées que vous utilisez doivet être istallées sur votre serveur et accessibles depuis le compte Neolae. Lors du déploiemet de Neolae das u eviroemet Widows, les utilisateurs disposat des droits d'accès écessaires peuvet utiliser la sytaxe UNC (Uiversal/Uiform Namig Covetio) pour les chemis d'accès lors des maipulatios de fichiers sur le réseau. Istallatio du serveur Neolae Exécutio du programme d'istallatio Les étapes d'istallatio du serveur Neolae sot les suivates : 1 Exécutez le fichier setup.exe. 44 Neolae 2013

46 Istallatio sous Widows 2 Sélectioez le type d'istallatio. Plusieurs types d'istallatio sot proposés : Istallatio d'u serveur applicatif : istallatio du serveur applicatif Neolae et de la cosole cliete. Istallatio miimale (Réseau) : istallatio d'u poste cliet depuis le réseau. Seules quelques DLL serot istallées sur la machie, si besoi, et tous les autres composats écessaires serot directemet utilisés sur le disque réseau. Istallatio d'u poste cliet : istallatio des composats écessaires pour l'utilisatio de la cosole cliete Neolae. Istallatio persoalisée : l'utilisateur choisit les élémets à istaller. Sélectioez ue istallatio de type Istallatio d'u serveur applicatif, et validez les différetes étapes, comme ci-dessous : Neolae v6.0 - Guide d'istallatio - Istallatio sous Widows 45

47 Neolae 3 Sélectioez le répertoire d'istallatio : 4 Cliquez sur Termier pour lacer l'istallatio : 46 Neolae 2013

48 Istallatio sous Widows La barre de progressio permet de suivre l'avacemet de l'istallatio : A la fi de l'istallatio, u message vous e cofirme le bo déroulemet : Ue fois l'istallatio termiée, démarrez Neolae pour créer les fichiers de cofiguratio. Voir Premier démarrage du serveur Neolae [page 48]. Test sommaire de l'istallatio Vous pouvez procéder à u test iitial de l'istallatio à l'aide de la commade suivate : lserver pdump Lorsque Neolae 'est pas démarré, la répose est : No task Neolae v6.0 - Guide d'istallatio - Istallatio sous Widows 47

49 Neolae Premier démarrage du serveur Neolae Ue fois le test d'istallatio réalisé, ouvrez l'ivite de commade depuis Démarrer > Programmes > Neolae v6 et saisissez la commade suivate : lserver web Cette commade permet de créer les fichiers cofig-default.xml et servercof.xml das le répertoire [Neolae v6]\cof, où [Neolae v6] est le chemi d'accès au répertoire d'istallatio de Neolae. Ces fichiers serot utilisés pour la cofiguratio des modules du serveur Neolae. Les iformatios affichées sot alors les suivates : 15:30:12 > Serveur applicatif pour Neolae Versio (build 6721) du 10/05/ :30:12 > Démarrage du serveur Web (pid=664, tid=4188)... 15:30:12 > Créatio du fichier de cofiguratio '[Neolae v6]\bi\..\cof\servercof.xml' serveur depuis '[Neolae v6]\bi\..\cof\fra\servercof.xml.sample 15:30:12 > Créatio du fichier de cofiguratio '[Neolae v6]\bi\..\cof\cofig-default.xml' serveur depuis '[Neolae v6]\bi\..\cof\models\cofig-default.xml 15:30:12 > Serveur démarré 15:30:12 > Arrêt demadé (pid=664) 15:30:12 > Arrêt du serveur Web (pid=664, tid=4188)... Saisissez la combiaiso Ctr+C pour arrêter le processus, puis la commade suivate : lserver start web Les iformatios affichées sot alors les suivates : 12:17:21 > Serveur applicatif pour Neolae Versio (build 6633) du 04/02/ :17:21 > Lacemet de la tâche 'web@default' ('lserver web -tracefile:web@default -istace:default -detach -tomcat -autorepair') das u ouveau processus 12:17:21 > Serveur applicatif pour Neolae Versio (build 6633) du 04/02/ :17:21 > Démarrage du serveur Web (pid=29188, tid= )... 12:17:21 > Géératio des chagemets de cofiguratio '[Neolae v6]\bi\..\cof\servercof.xml.diff' etre '[Neolae v6]\bi\..\cof\servercof.xml' et '[Neolae v6]\bi\..\cof\fra\servercof.xml.sample' 12:17:22 > Tomcat démarré 12:17:22 > Serveur démarré Pour l'arrêter, saisissez : lserver stop web Les iformatios affichées sot alors les suivates : 12:18:31 > Serveur applicatif pour Neolae Versio (build 6633) du 04/02/ :18:31 > Arrêt de 'web@default' ('lserver web -tracefile:web@default -istace:default -detach -tomcat -autorepair', pid=29188, tid= ) demadé... 12:18:31 > Arrêt demadé (pid=29188) 12:18:31 > Arrêt du serveur Web (pid=29188, tid= )... Mot de passe de l'idetifiat iteral Le serveur Neolae défiit u idetifiat (logi) techique ommé iteral qui possède tous les droits, sur toutes les istaces. Après ue istallatio récete, cet idetifiat 'a pas de mot de passe. Il est fortemet recommadé d'e défiir u immédiatemet. 48 Neolae 2013

50 Istallatio sous Widows Voir à ce sujet la sectio Idetifiat 'iteral' [page 85]. Démarrage des services Neolae Pour lacer les services Neolae, démarrez le service Neolae à partir du gestioaire des services, ou saisissez la lige de commade suivate (e ayat les droits suffisats) : et start lserver6 Si vous avez besoi d'arrêter les processus Neolae par la suite, saisissez la commade : et stop lserver6 Itégratio à u serveur Web Présetatio Neolae iclut Apache Tomcat pour agir comme poit d'etrée das le code du serveur applicatif via HTTP (et SOAP). Vous pouvez utiliser ce Tomcat itégré pour servir des requêtes HTTP. Das ce cas : le port d'écoute par défaut est le Pour modifier ce port, reportez-vous à la sectio Port Tomcat par défaut [page 106]. vos cosoles clietes se coectet alors e utilisat ue URL de type Cepedat, pour des raisos de sécurité et d'admiistratio, il est coseillé d'utiliser u véritable serveur Web comme poit d'etrée pricipal pour le trafic HTTP lorsque la machie qui fait tourer Neolae est exposée sur Iteret et que vous voulez doer u accès à la cosole depuis l'extérieur de votre réseau. U serveur Web permet égalemet d'assurer la cofidetialité des doées avec le protocole HTTPS. De même, vous devez utiliser u serveur Web lorsque vous souhaitez utiliser les foctioalités de trackig, dispoibles seulemet e tat que module d'extesio d'u serveur Web. Cofiguratio du serveur Web IIS La procédure de cofiguratio d'u serveur Web IIS est essetiellemet graphique. Celle-ci implique l'utilisatio d'u site Web (soit existat, soit à créer) pour l'accès aux ressources du serveur Neolae, à savoir : les fichiers Java (.jsp), les feuilles de styles (.css,.xsl), les images (.pg), la DLL ISAPI pour la redirectio, etc. Les sectios suivates présetet le mode de cofiguratio sous IIS 7. Les paramétrages pour IIS 6 sot globalemet idetiques. Les spécificités pour cette versios sot présetées das la sectio Compatibilité 32 bits de IIS [page 54]. Pour Widows 2003, ue cofiguratio supplémetaire est écessaire. Voir à ce sujet la sectio Compatibilité IIS/Widows Server 2003 [page 55]. Neolae v6.0 - Guide d'istallatio - Istallatio sous Widows 49

51 Neolae Avertissemet : Si le serveur Web IIS 'est pas déjà istallé sur votre machie, vous pouvez lacer l'istallatio via le meu Ajout/suppressio de programmes > Ajouter ou supprimer des foctioalités Widows. Sous IIS 7, e plus des services stadards, vous devez istaller les Extesios ISAPI et les filtres ISAPI. Etapes de cofiguratio Les étapes de cofiguratio sot les suivates : 1 Ouvrez le gestioaire des services iteret (IIS) via le meu Paeau de cofiguratio > Outils d'admiistratio > Gestioaire des services Iteret. 2 Créez et paramétrez le site (Neolae, par exemple) e foctio des cotraites de votre réseau (port TCP de coexio, host DNS, adresse IP). 50 Neolae 2013

52 Istallatio sous Widows Vous devez au miimum idiquer le om du site et le chemi d'accès au répertoire virtuel. Le chemi d'accès au répertoire de base du site Web 'état pas utilisé, o peut référecer le répertoire C:\ietpub\wwwroot. 3 U script VBS permet de cofigurer automatiquemet le paramétrage des ressources utilisées par le serveur Neolae sur le répertoire virtuel créé précédemmet. Pour le lacer, double-cliquez sur le fichier iis_eolae_setup.vbs eregistré das le dossier [Neolae v6]\tomcat-6\cof, où [Neolae v6] est le chemi d'accès au répertoire d'istallatio de Neolae. Das le cas d'ue istallatio Widows serveur 2008/IIS7, vous devez être coecté e tat qu'admiistrateur pour lacer le script VBS ou exécuter le script e tat qu'admiistrateur. Cliquez sur OK si le serveur Web fait office de serveur de redirectio pour le trackig, das le cas cotraire cliquez sur Cacel. Lorsque plusieurs sites sot déjà paramétrés sur le serveur Web, ue page itermédiaire est affichée afi de préciser sur quel site Web doit s'appliquer l'istallatio : saisissez le uméro associé au site puis cliquez sur OK. Neolae v6.0 - Guide d'istallatio - Istallatio sous Widows 51

53 Neolae Cliquez sur OK pour valider le paramétrage de l'applicatio e 32 bits. Si vous disposez d'exécutables e 64 bits, ils e serot pas affectés. U message de cofirmatio doit s'afficher : 4 Das l'oglet Affichage du coteu, vérifiez que la cofiguratio du site Web est bie paramétrée avec les ressources Neolae : Si l'arborescece 'est pas affichée, redémarrez le Gestioaire de service Iteret (IIS). 52 Neolae 2013

54 Istallatio sous Widows Gestio des droits Vous devez esuite régler les accès de sécurité pour l'exécutio de la DLL ISAPI et l'utilisatio des ressources du répertoire d'istallatio Neolae. Pour cela, les étapes sot les suivates : 1 Sélectioez l'oglet Affichage des foctioalités et double-cliquez sur l'icôe Authetificatio. 2 Vérifiez, à partir de l'oglet Sécurité de répertoire des propriétés du site Web, que l'accès aoyme est activé. Au besoi, cliquez sur le lie Edit... pour modifier le paramétrage. Lacemet du serveur Web et test de la cofiguratio Vous devez tester la validité de la cofiguratio. Pour cela, respectez la procédure suivate : 1 Redémarrez le serveur IIS à partir de la lige de commade iisreset 2 Testez le bo foctioemet du module de trackig depuis u avigateur Web via l'url suivate : Le avigateur doit afficher la répose suivate : <redir status='ok' date='2011/01/26 11:52:39.000' build='6636' host='myserver.mydomai.com' localhost='localhost'/> Neolae v6.0 - Guide d'istallatio - Istallatio sous Widows 53

55 Neolae Pour vérifier la présece du module de redirectio, lacez la lige de commade suivate : lserver pdump Elle doit revoyer les iformatios suivates : 12:00:33 > Applicatio server for Neolae Versio (build 6636) of 26/01/2011 webmdl@default (1644) Mo Vous pouvez égalemet vous assurer que la DLL ISAPI est bie chargée. Pour cela, les étapes sot les suivates : 1 Editez les filtres ISAPI pour le site Neolae e cliquat sur l'icôe Mappages de gestioaires. 2 Puis vérifiez le coteu du filtre ISAPI : Compatibilité 32 bits de IIS La versio 6 de IIS peut être e 64 bits. Vous pouvez toutefois permettre à IIS 6.0 d'exécuter des applicatios Web 32 bits sur ue éditio 64 bits de Widows. Veuillez suivre la procédure décrite ci-après pour cofigurer IIS 6.0. Pour lacer ue DLL ISAPI 32 bits, par exemple pour exécuter le module de trackig, vous devez adapter la cofiguratio de IIS. Pour cela, depuis ue ivite de commades, saisissez : cscript %SystemDrive%\ietpub\AdmiScripts\adsutil.vbs set w3svc/apppools/eable32bitappowi64 1 Cliquez sur Ajouter/Supprimer des composats Widows et sélectioez ASP.NET (1 ou 2). 54 Neolae 2013

56 Istallatio sous Widows Istallez les composats ASP.NET 2 pour la versio 32 bits à l'aide de la commade suivate : C:\WINDOWS\microsoft.et\Framework\v2.votreEviroemet\aspet_regiis.exe -i Après avoir effectué cette istallatio, ous vous coseillos de tester le module de trackig. Si vous avez à vous authetifier, chagez le mot de passe du compte IUSR_om de la machie (voir la sectio Etapes de cofiguratio [page 50]). Esuite, cofigurez ce même mot de passe das les propriétés du site Web. Compatibilité IIS/Widows Server 2003 Pour Widows Server 2003, éditez les propriétés du dossier d'istallatio Neolae, à partir de l'explorateur de Widows, et modifiez les permissios e ajoutat le groupe IIS_WPG et IUSR_om de la machie. Puis attribuez-leur les mêmes droits. Mise à dispositio de la cosole cliete Lorsque la machie utilisée pour lacer u serveur applicatif Neolae (lserver web) reçoit les coexios des utilisateurs par la cosole cliete, vous pouvez la cofigurer afi de mettre à dispositio le programme d'istallatio (setup) du cliet riche Neolae à travers ue iterface HTML. Pour cela, vous devez récupérer le package qui cotiet le programme d'istallatio des cosoles (le fichier s'appelle setup-cliet-6.0.x.yyyy.exe, où YYYY est le uméro de build) et le copier das le répertoire d'istallatio de Neolae, sous /datakit/l/fra/jsp. Ue fois que le serveur Neolae a démarré, les utilisateurs fiaux peuvet télécharger le programme d'istallatio de la cosole depuis u avigateur Web (Iteret Explorer, Firefox) via l'url suivate : serveur Neolae>:8080/l/jsp/logo.jsp Cette page écessite u idetifiat/mot de passe défiis das l'applicatio. Astuce : La cosole e écessite pas réellemet de programme d'istallatio. Vous pouvez istaller la cosole sur u lecteur partagé de votre réseau et faire e sorte que les utilisateurs lacet directemet l'exécutable depuis cet edroit. E revache, vous e pourrez alors pas bééficier de la mise à jour automatique de la cosole. Ce mode 'est doc pas recommadé. Neolae v6.0 - Guide d'istallatio - Istallatio sous Widows 55

57 Neolae Afi de permettre aux utilisateurs Neolae de se coecter à l'istace que vous avez créée et paramétrée, ils doivet utiliser la cosole cliete. La procédure d'istallatio est décrite das la sectio Istallatio de la cosole cliete Neolae [page 56]. Istallatio de la cosole cliete Neolae La procédure d'istallatio de la cosole Neolae est décrite ci-dessous. Avat d'istaller la cosole Neolae, cosultez les prérequis listés das la sectio Iterface cliet riche [page 16]. Pour istaller la cosole Neolae, les étapes sot les suivates : 1 Ouvrez u avigateur Web et téléchargez la cosole dispoible à l'adresse suivate : 2 Das la feêtre d'idetificatio, saisissez votre idetifiat (logi) et votre mot de passe. Au besoi, utilisez ceux du compte iteral défiis lors de la créatio de l'istace. 56 Neolae 2013

58 Istallatio sous Widows 3 Cliquez sur le lie Téléchargemet. 4 Téléchargez et eregistrez le fichier setup-cliet-xxx.exe 5 Exécutez le fichier téléchargé sur u poste sous Widows : l'istallatio démarre. 6 Ue fois le programme d'istallatio termié, lacez la cosole depuis le meu Démarrer de Widows (das le groupe de programmes de Neolae). Das le cadre d'ue istallatio Widows, vous pouvez lacer directemet le fichier lcliet.exe préset das le répertoire [Neolae v6]/bi à partir du serveur Widows, où [Neolae v6] est le chemi d'accès au répertoire d'istallatio de Neolae. Pour créer ue ouvelle coexio, reportez-vous à la sectio Créatio d'ue ouvelle coexio [page 72]. Neolae v6.0 - Guide d'istallatio - Istallatio sous Widows 57

59 Neolae 58 Neolae v6.0 - Guide d'istallatio

60 CHAPITRE 5 Istallatio sous Liux Table des matières Avat d'istaller Prérequis logiciels sous Liux Etapes de mise e oeuvre Accessibilité Istallatio des packages Neolae Itroductio Lague par défaut pour le serveur Neolae Distributio basée sur des packages RPM (RHEL et SUSE) Distributio basée sur APT (Debia) Test sommaire de l'istallatio Premier démarrage du serveur Neolae Mot de passe de l'idetifiat iteral Itégratio à u serveur Web Présetatio Cofiguratio du serveur Web Apache Mise à dispositio de la cosole cliete Neolae Avat d'istaller Prérequis logiciels sous Liux La cofiguratio techique et logicielle requise pour l'istallatio de Neolae est présetée das la sectio Cofiguratio requise [page 11]. Neolae v6.0 - Guide d'istallatio - Istallatio sous Liux 59

61 Neolae Avertissemet : Neolae écessite que la librairie C supporte le mode TLS (Thread Local Storage). Ce mode est actif das la plupart des cas, sauf avec certais kerels das lesquels le support Xe a été activé. Pour le vérifier, vous pouvez par exemple utiliser la commade uame -a grep xe. Vous devez impérativemet disposer de la versio d'opessl. Les versios 1.0 et supérieures d'opessl e sot pas compatibles avec Neolae v Sous RHEL : Des problèmes de compatibilité des couches clietes Oracle ot été costatées lorsque SELiux est activé. Reportez-vous au site de support Oracle pour plus d'iformatios. Pour assurer le bo foctioemet de Neolae, ous vous coseillos de désactiver SELiux. Procédez de la maière suivate : Editez le fichier /etc/seliux/cofig Modifiez la lige SELINUX comme suit : SELINUX=disabled Polices de caractères Pour que les rapports cocerat les statistiques MTA (ms/fra/jsp/stat.jsp) s'affichet correctemet, vous devez ajouter des polices supplémetaires. Sous Debia, utilisez la commade : aptitude istall xfots-base xfots-75dpi ttf-bitstream-vera ttf-dejavu Sous Red Hat, la commade à utiliser est la suivate : yum istall xorg-x11-fots-base xorg-x11-fots-75dpi bitstream-vera-fots dejavu-lgc-fots Des polices complémetaires doivet égalemet être istallées pour OpeOffice.org. Voir ci-après. OpeOffice.org Vous trouverez ci-après les étapes requises pour l'istallatio d'opeoffice.org afi d'e assurer le bo foctioemet avec Neolae. Pour faire foctioer Neolae sur ue versio existate d'opeoffice.org, reportez-vous à la sectio Cofiguratio de l'eviroemet de Neolae sous Liux (optioel) [page 138]. Avertissemet : Vous e devez pas istaller OpeOffice.org via les commades : apt-get ou yum. OpeOffice sous Debia Les paramétrages suivats sot écessaires sous Debia : 1 Istallez les polices Widows. Pour cela, téléchargez le package msttcorefots (cité ci-dessus) e ajoutat la lige applicable à votre système d'exploitatio das le fichier sources.list. Par exemple : deb ley mai cotrib o-free 2 Istallez les packages écessaires à OpeOffice.org : xbase-cliets, libxext6, libsm6, xfots-base et msttcorefots ou vérifiez leur présece. apt-get istall xbase-cliets libxext6 libsm6 msttcorefots 3 Téléchargez ue versio DEB d'opeoffice.org 32 ou 64 bits selo votre architecture : 4 Istallez OpeOffice.org. 60 Neolae 2013

62 Istallatio sous Liux Pour valider la boe istallatio d'opeoffice.org, utilisez la lige de commade suivate : soffice '-accept=socket,host=localhost,port=8101;urp;staroffice.servicemaager' -odefault -ocrashreport -orestart -olockcheck -headless -ologo -orestore -ofirststartwizard La cofiguratio est correcte lorsque cette commade e retoure aucue iformatio (lige vide). Patietez ue dizaie de secodes puis effectuez u ctrl-c. OpeOffice sous RPM (RHEL, SUSE) Les paramétrages suivats sot écessaires sous RPM : 1 Istallez les packages écessaires à OpeOffice.org : xorg-x11 et webcore-fots, ou vérifiez leur présece. rpm -Uvh webcore-fots oarch.rpm Le lie de téléchargemet pour le package webcore-fots est le suivat : 2 Téléchargez ue versio RPM d'opeoffice.org 32 ou 64 bits selo votre architecture : 3 Istallez OpeOffice.org. Pour valider la boe istallatio d'opeoffice.org, utilisez la lige de commade suivate : soffice '-accept=socket,host=localhost,port=8101;urp;staroffice.servicemaager' -odefault -ocrashreport -orestart -olockcheck -headless -ologo -orestore -ofirststartwizard La cofiguratio est correcte lorsque cette commade e retoure aucue iformatio (lige vide). Patietez ue dizaie de secodes puis effectuez u ctrl-c. Etapes de mise e oeuvre L'istallatio de Neolae sous Liux doit être réalisée das l'ordre suivat : istallatio du serveur puis paramétrage des istaces. Istallatio d'u serveur multi-istaces Le processus d'istallatio est décrit das ce chapitre. Les étapes de l'istallatio sot les suivates : Etape 1 : Istallatio du serveur applicatif, voir Istallatio des packages Neolae [page 62] Etape 2 : Itégratio à u serveur Web (optioel, e foctio des composats déployés). Avertissemet : Neolae 'est pas ue applicatio 64 bits. Elle peut éamois être istallée sur des machies équipées d'u OS 64 bits, mais ses applicatios tierces doivet rester 32 bits (serveurs web compatibles, jdk, cliets BD). Paramétrage des istaces Ue fois les étapes d'istallatio termiées, vous devez procéder à la cofiguratio des istaces et de la base de doées et au paramétrage du serveur. Voir à ce sujet le chapitre Cofiguratio de Neolae [page 71]. Cosultez égalemet le chapitre Paramétrages complémetaires [page 105] pour répodre à des besois spécifiques. Neolae v6.0 - Guide d'istallatio - Istallatio sous Liux 61

63 Neolae Accessibilité Couches d'accès base de doées Les couches d'accès pour le moteur de base de doées que vous utilisez doivet être istallées sur votre serveur et accessibles depuis le compte Neolae. Selo le moteur de base de doées utilisé, les versios et modes d'istallatio peuvet différer. PostgreSQL Neolae supporte toutes les versios des bibliothèques du cliet PostgreSQL à partir de la versio 7.2 :libpq.so.5, libpq.so.4, libpq.so.3.2 et libpq.so.3.1. Oracle Récupérez la versio des bibliothèques pour Debia 64 bits, soit : libcltsh.so, libcltsh.so.11.1 et libcltsh.so Neolae écessite des couches clietes Oracle de versio 9.2 miimum (même si le serveur peut être de versio iférieure), car ce sot les seules pouvat supporter coveablemet les bases de doées Uicode. Vous pouvez obteir u package RPM Liux depuis Oracle Techology Network. Si vous avez déjà istallé le cliet Oracle mais que l'eviroemet global (par exemple : /etc/profile) 'est pas correctemet cofiguré, vous pouvez ajouter les iformatios maquates das le script l6/customer.sh. Par exemple : vi ~/l6/customer.sh... export ORACLE_HOME=/usr/local/istatcliet_10_2 export TNS_ADMIN=/etc/oracle export LD_LIBRARY_PATH=$ORACLE_HOME/lib:$LD_LIBRARY_PATH Le coteu de la variable d'eviroemet ORACLE_HOME correspod au répertoire d'istallatio d'oracle. Le coteu de la variable TNS_ADMIN doit au répertoire d'eregistremet du fichier tsames.ora. MySQL La versio de la bibliothèque supportée est libmysqlcliet_r.so.16. DB2 La versio des bibliothèques supportées est libdb2.so. Istallatio des packages Neolae Itroductio Neolae est livré avec deux packages : lthirdparty : ce package cotiet tous les composats tiers (parseur Xerces C++, iterpréteur JavaScript, etc.) qui, e gééral, e chaget pas lors des mises à jours mieures. lserver : ce package cotiet les biaires et les fichiers de cofiguratio pour ue versio doée. Les deux packages sot fouris séparémet afi de mettre à jour facilemet ue istallatio existate e téléchargeat et e istallat uiquemet le package lserver. Ces packages sot compilés e GCC 4, ce qui implique des dépedaces de versios spécifiques des bibliothèques qui e sot pas toujours dispoibles sur la plate-forme d'istallatio. Les commades d'istallatio permettet de : copier les fichiers sous /usr/local/eolae, 62 Neolae 2013

64 Istallatio sous Liux créer u compte Liux Neolae (et le groupe associé), avec pour répertoire racie (home directory) : /usr/local/eolae, créer u script de démarrage automatique au démarrage /etc/iit.d/lserver6. L'utilisateur système eolae e doit pas avoir été créé avat de lacer ces commades. Lague par défaut pour le serveur Neolae L'istallatio supporte à la fois le fraçais et l'aglais. Par défaut, le serveur utilise l'aglais. Pour basculer e fraçais, saisissez les commades suivates : su - eolae vi l6/customer.sh et ajoutez la lige export NEOLANE_LANG=fra IMPORTANT : Si vous effectuez l'istallatio pour la première fois, il se peut que le fichier customer.sh 'existe pas ecore sur le serveur. Créez-le et assurez-vous qu'il possède bie des droits d'exécutio. Si ce 'est pas le cas, etrez la commade suivate : chmod +x /usr/local/eolae/l6/customer.sh Pour garatir ue boe lecture des messages système, les cosoles doivet être das ue page de codes correspodat à la lague (ISO ou -15 pour le Fraçais). Distributio basée sur des packages RPM (RHEL et SUSE) 1 Vous devez au préalable accéder aux deux packages de Neolae. Les fichiers sot : lthirdparty6-xxxx-0.i686.rpm lserver6-xxxx-0.i686.rpm (où XXXX est le uméro de build). 2 Pour les istaller, coectez-vous e tat que root et exécutez la commade suivate (ici, ous cosidéreros u build 6644) : rpm -Uvh lthirdparty i686.rpm lserver i686.rpm Distributio basée sur APT (Debia) Debia - 32 bits 1 Vous devez au préalable accéder aux deux packages de Neolae. Les fichiers sot : lthirdparty6-xxxx-liux-2.6-itel.deb lserver6-xxxx-liux-2.6-itel.deb (où XXXX est le uméro de build). 2 Pour les istaller, coectez-vous e tat que root et exécutez la commade suivate (ici, ous cosidéreros u build 6644) : dpkg -i lthirdparty liux-2.6-itel.deb lserver liux-2.6-itel.deb Neolae v6.0 - Guide d'istallatio - Istallatio sous Liux 63

65 Neolae Das le cadre d'ue mise à jour, il 'est écessaire de dépackager le fichier lthirdparty que s'il a été modifié. Debia - 64 bits Sur u système d'exploitatio 64 bits, vous devez utiliser les bibliothèques 32 bits et ue optio spécifique d'istallatio. aptitude istall ia32-libs lib32z1 dpkg -i --force-architecture lthirdparty liux-2.6-itel.deb lserver liux-2.6-itel.deb Test sommaire de l'istallatio Vous pouvez procéder à u test iitial de l'istallatio à l'aide des commades suivates : su - eolae lserver pdump Lorsque Neolae 'est pas démarré, la répose est : o task Premier démarrage du serveur Neolae Ue fois le test d'istallatio réalisé, saisissez la commade suivate : lserver web Les iformatios affichées sot alors les suivates : 17:11:03 > Serveur applicatif pour Neolae Versio (build 6633) du 04/02/ :11:03 > Démarrage du serveur Web (pid=17546, tid= )... 17:11:03 > Créatio du fichier de cofiguratio '/usr/local/eolae/l6/cof/servercof.xml' serveur depuis '/usr/local/eolae/l6/cof/fra/servercof.xml.sample' 17:11:03 > Créatio du fichier de cofiguratio '/usr/local/eolae/l6/cof/cofig-default.xml' serveur depuis '/usr/local/eolae/l6/cof/models/cofig-default.xml' 17:11:03 > Serveur démarré 17:11:08 > Arrêt demadé (pid=17546) 17:11:08 > Arrêt du serveur Web (pid=17546, tid= )... Ces commades permettet de créer les fichiers de cofiguratio cofig-default.xml et servercof.xml. Saisissez la combiaiso Ctr+C pour arrêter le processus, puis la commade suivate : lserver start web Les iformatios affichées sot alors les suivates : 12:17:21 > Serveur applicatif pour Neolae Versio (build 6633) du 04/02/ :17:21 > Lacemet de la tâche 'web@default' ('lserver web -tracefile:web@default -istace:default -detach -tomcat -autorepair') das u ouveau processus 12:17:21 > Serveur applicatif pour Neolae Versio (build 6633) du 04/02/ :17:21 > Démarrage du serveur Web (pid=29188, tid= )... 12:17:21 > Créatio du fichier de cofiguratio '/usr/local/eolae/l6/cof/servercof.xml' serveur depuis '/usr/local/eolae/l6/cof/fra/servercof.xml.sample' 12:17:22 > Tomcat démarré 12:17:22 > Serveur démarré 64 Neolae 2013

66 Istallatio sous Liux Pour l'arrêter, saisissez : lserver stop web Les iformatios affichées sot alors les suivates : 12:18:31 > Serveur applicatif pour Neolae Versio (build 6633) du 04/02/ :18:31 > Arrêt de 'web@default' ('lserver web -tracefile:web@default -istace:default -detach -tomcat -autorepair', pid=29188, tid= ) demadé... 12:18:31 > Arrêt demadé (pid=29188) 12:18:31 > Arrêt du serveur Web (pid=29188, tid= )... Mot de passe de l'idetifiat iteral Le serveur Neolae défiit u idetifiat (logi) techique ommé iteral qui possède tous les droits, sur toutes les istaces. Après ue istallatio récete, cet idetifiat 'a pas de mot de passe. Il est fortemet recommadé d'e défiir u immédiatemet. Voir à ce sujet la sectio Idetifiat 'iteral' [page 85]. Itégratio à u serveur Web Présetatio Neolae iclut Apache Tomcat pour agir comme poit d'etrée das le code du serveur applicatif via HTTP (et SOAP). Vous pouvez utiliser ce Tomcat itégré pour servir des requêtes HTTP. Das ce cas : le port d'écoute par défaut est le Pour modifier ce port, reportez-vous à la sectio Port Tomcat par défaut [page 106]. vos cosoles clietes se coectet alors e utilisat ue URL de type Cepedat, pour des raisos de sécurité et d'admiistratio, il est coseillé d'utiliser u véritable serveur Web comme poit d'etrée pricipal pour le trafic HTTP lorsque la machie qui fait tourer Neolae est exposée sur Iteret et que vous voulez doer u accès à la cosole depuis l'extérieur de votre réseau. U serveur Web permet égalemet d'assurer la cofidetialité des doées avec le protocole HTTPS. De même, vous devez utiliser u serveur Web lorsque vous souhaitez utiliser les foctioalités de trackig, dispoibles seulemet e tat que module d'extesio d'u serveur Web. Cofiguratio du serveur Web Apache 2.2 Sous Debia 32 bits Cette procédure s'applique si vous avez istallé Apache sous ue distributio basée sur APT. Les étapes sot les suivates : 1 Désactivez les modules chargés par défaut à l'aide de la commade suivate : a2dismod auth_basic auth_file authz_default authz_user \ autoidex cgi dir ev egotiatio userdir Assurez-vous que les modules alias, authz_host et mime sot toujours activés. Pour cela, utilisez la commade suivate : a2emod alias authz_host mime 2 Créez le fichier lsrv.load sous /etc/apache2/mods-available et isérez le coteu suivat : LoadModule requesthadler22_module /usr/local/eolae/l6/lib/liblsrvmod.so 3 Créez le fichier lsrv.cof sous /etc/apache2/mods-available à l'aide de la commade suivate : Neolae v6.0 - Guide d'istallatio - Istallatio sous Liux 65

67 Neolae l -s /usr/local/eolae/l6/tomcat-6/cof/apache_eolae.cof \ /etc/apache2/mods-available/lsrv.cof 4 Activez ce module avec la commade suivate : a2emod lsrv Si vous utilisez le module mod_rewrite pour les pages de Neolae, vous devez reommer les fichiers lsrv.load et lsrv.cof e zz-lsrv.load et zz-lsrv.cof. Pour activer le module, lacez la commade suivate : a2emod zz-lsrv 5 Editez le fichier /etc/apache2/evvars et ajoutez les liges suivates : # Added Neolae export LD_LIBRARY_PATH=/usr/local/eolae/l6/lib:$LD_LIBRARY_PATH export USERPATH=/usr/local/eolae 6 Ajoutez les utilisateurs Neolae das le groupe d'utilisateurs Apache et iversemet, comme das l'exemple ci-dessous : adduser eolae www-data adduser www-data eolae 7 Redémarrez Apache : ivoke-rc.d apache2 restart 8 Vérifiez égalemet que les droits sot corrects das le dossier eolae : cd /usr/local/ chow -R eolae:eolae eolae chmod -R 775 eolae chmod 755 eolae Sous Debia 64 bits et autres istallatios mauelles Avertissemet : Vous devez disposer d'u Apache 32 bits. Das la procédure ci-dessous, ous cosidéros que vous avez compilé Apache depuis les sources et qu'il est istallé das les dossiers par défaut. Si ce 'est pas le cas, veuillez l'adapter e coséquece. Les étapes sot les suivates : 1 Editez le fichier de cofiguratio httpd.cof, via la commade suivate : vi /usr/local/apache2/cof/httpd.cof 2 Cofigurez le groupe par défaut d'apache à ogroup, avec l'istructio suivate : Group ogroup Si écessaire, créez le groupe à l'aide de la commade : groupadd ogroup 3 Chagez le om du serveur (ServerName) par défaut et remplacez-le par le om de votre machie. Par exemple, das le cas où la machie s'appelle eolae.customer.com, la commade est la suivate : ServerName eolae.customer.com 66 Neolae 2013

68 Istallatio sous Liux 4 Chargez le module d'extesio Neolae (liblsrvmod.so), via la commade suivate (saisissez la commade sur ue seule lige) : LoadModule requesthadler22_module /usr/local/eolae/l6/lib/liblsrvmod.so (si vous utilisez Apache 2.2) ou LoadModule requesthadler20_module /usr/local/eolae/l6/lib/liblsrvmod.so (si vous utilisez Apache 2.0) 5 Chargez la cofiguratio Neolae. Pour cela, ajoutez à la fi du fichier : Iclude /usr/local/eolae/l6/tomcat-6/cof/apache_eolae.cof Paramétrages complémetaires Quelles que soiet les versios istallées, ous vous coseillos d'ajouter à la fi du fichier httpd.cof : TraceEable off et de modifier ces deux liges de la maière suivate : ServerTokes Prod ServerSigature Off Vous devez égalemet vous assurer qu'apache démarre avec l'eviroemet écessaire au module Neolae. Les étapes sot les suivates : 1 Editez le fichier evvars (automatiquemet sourcé par le script de démarrage Apache), via la commade suivate : vi /usr/local/apache2/bi/evvars 2 Vérifiez les iformatios qu'il cotiet : # Added Neolae export LD_LIBRARY_PATH=/usr/local/eolae/l6/lib:$LD_LIBRARY_PATH export USERPATH=/usr/local/eolae # optioal export NEOLANE_LANG=eg 3 Vérifiez que l'utilisateur qui exécute les processus Apache fait partie du groupe Neolae, afi qu'il puisse écrire les iformatios de trackig : usermod -G eolae obody 4 Et que Neolae puisse écrire das les logs Apache : usermod -G ogroup eolae 5 Vérifiez égalemet que les droits sot corrects das le dossier eolae : cd /usr/local/ chow -R eolae:eolae eolae chmod -R 775 eolae chmod 755 eolae Neolae v6.0 - Guide d'istallatio - Istallatio sous Liux 67

69 Neolae Avat de démarrer Apache, veuillez vous assurer que le fichier customer.sh possède bie des droits d'exécutio. Si ce 'est pas le cas, etrez la commade suivate : chmod +x /usr/local/eolae/l6/customer.sh Voir égalemet la sectio Cofiguratio de l'eviroemet sous Liux [page 112]. Lacemet du serveur Web et test de la cofiguratio Vous pouvez à préset tester la cofiguratio e démarrat Apache. Le module Neolae doit alors afficher sa baière sur la cosole (deux baières sous certais systèmes d'exploitatio) : /etc/iit.d/apache start Les iformatios suivates sot alors affichées : 12:26:28 > Serveur applicatif pour Neolae Versio (build 6636) du 04/02/ :26:28 > Démarrage du serveur Web (pid=29698, tid= )... 12:26:28 > Serveur démarré 12:26:28 > Serveur applicatif pour Neolae Versio (build 6636) du 04/02/ :26:28 > Démarrage du serveur Web (pid=29698, tid= )... 12:26:28 > Serveur démarré Vérifiez esuite qu'il répod correctemet e soumettat ue URL de test. Pour cela, vous pouvez tester depuis la lige de commade e exécutat : telet localhost 80 E retour, vous devez obteir : Tryig Coected to localhost.localdomai. Escape character is '^]'. puis saisissez : GET /r/test Les iformatios suivates sot affichées : <redir status='ok' date='2011/02/04 11:54:36.000' build='6636' host='' localhost='xxxx'/> Coectio closed by foreig host. Vous pouvez égalemet appeler l'url /r/test depuis u avigateur Web. Mise à dispositio de la cosole cliete Neolae Si la machie est utilisée pour lacer u serveur applicatif Neolae (lserver web), elle peut être cofigurée pour mettre à dispositio le programme d'istallatio du cliet riche Neolae à travers ue iterface HTML. Pour cela, il faut récupérer le programme d'istallatio des cosoles (le fichier s'appelle setup-cliet-6.0.x.yyyy.exe, où YYYY est le uméro de build) et le copier das le répertoire d'istallatio de Neolae, sous /usr/local/eolae/l6/datakit/l/fra/jsp. Par exemple : cp setup-cliet exe /usr/local/eolae/l6/datakit/l/fra/jsp Ue fois que le serveur Neolae a démarré, les utilisateurs fiaux peuvet télécharger le programme d'istallatio de la cosole depuis u avigateur Web (Iteret Explorer, Firefox) via l'url suivate : serveur Neolae>:8080/l/jsp/logo.jsp Cette page écessite u idetifiat/mot de passe défiis das l'applicatio. 68 Neolae 2013

70 Istallatio sous Liux Astuce : Il est possible d'istaller la cosole sur u lecteur partagé de votre réseau et faire e sorte que les utilisateurs lacet directemet l'exécutable depuis cet edroit. Toutefois, vous e pourrez alors pas bééficier de la mise à jour automatique de la cosole. Ce mode 'est doc pas recommadé. Voir égalemet la sectio Istallatio de la cosole cliete Neolae [page 56]. Neolae v6.0 - Guide d'istallatio - Istallatio sous Liux 69

71 Neolae 70 Neolae v6.0 - Guide d'istallatio

72 CHAPITRE 6 Cofiguratio de Neolae Table des matières Itroductio Créatio d'ue istace et de la base de doées Créatio et coexio à ue istace Créatio et paramétrage de la base de doées Paramétrage du serveur Itroductio Fichiers de cofiguratio Activatio des processus Paramètres de diffusio Déploiemet d'ue istace Neolae Assistat de déploiemet Paramètres gééraux Caal Gestio des mails rebods Paramétrage du trackig Caal mobile Optios régioales Accès depuis Iteret Gestio des ressources publiques Purge des doées Itroductio Ue fois l'istallatio de Neolae termiée, vous devez e réaliser le paramétrage pour e garatir le bo foctioemet, selo vos cotraites et votre architecture techique. Les étapes de paramétrage d'ue istace Neolae sot présetées das ce chapitre. Elles s'echaîet das l'ordre suivat : 1 Créatio de l'istace et de la coexio associée, voir Créatio et coexio à ue istace [page 72]. 2 Créatio et paramétrage de la base de doées, voir Créatio et paramétrage de la base de doées [page 74]. 3 Paramétrage du serveur Neolae, voir Paramétrage du serveur [page 84]. 4 Déploiemet de l'istace, voir Assistat de déploiemet [page 86]. La cofiguratio d'ue istace implique l'activatio des processus (web, mta, wfserver, etc.) à démarrer sur le serveur et le paramétrage des modules pour l'evoi des s, du trackig, etc. Neolae v6.0 - Guide d'istallatio - Cofiguratio de Neolae 71

73 Neolae Pour chaque istace, l'activatio des processus Neolae est réalisée sur le serveur. Voir à ce sujet la sectio Activatio des processus [page 85]. Des paramétrages complémetaires au iveau de chaque istace peuvet être écessaires, selo les modules utilisés, votre architecture et vos besois et afi d'optimiser le foctioemet de Neolae. Reportez-vous au chapitre Paramétrages complémetaires [page 105]. Créatio d'ue istace et de la base de doées Pour créer ue ouvelle istace aisi que la base de doées Neolae, la procédure est la suivate : 1 Créer la coexio, 2 S'y coecter pour créer l'istace associée, 3 Créer et paramétrer la base de doées. Seul l'idetifiat iteral peut réaliser ces opératios. Voir à ce sujet Idetifiat 'iteral' [page 85]. Créatio et coexio à ue istace Créatio d'ue ouvelle coexio Lacez la cosole Neolae, la feêtre suivate apparaît : Vous devez défiir ue coexio vers votre serveur applicatif Neolae à partir d'ue URL, puis vous y coecter. Vous pouvez utiliser soit u DNS ou u alias de la machie, soit directemet so adresse IP. 72 Neolae 2013

74 Cofiguratio de Neolae Par exemple, vous pouvez utiliser ue URL de type : Vous pouvez coserver le port :8080 s'il 'y a pas d'itégratio avec u serveur Web. Avertissemet : Seuls les caractères a-z, 0-9, le tiret (-) et le poit sot autorisés das l'url de coexio. Créatio et déclaratio d'ue istace Das la feêtre Paramètres de coexio, saisissez l'idetifiat (logi) iteral et so mot de passe associé afi de vous coecter au serveur applicatif Neolae. Utilisez l'assistat de créatio d'istace pour déclarer la ouvelle istace. Das le champ Nom, saisissez le om de l'istace : ce om est utilisé pour géérer u fichier de cofiguratio cofig-<istace>.xml et est utilisé das les paramètres des liges de commade pour idetifier l'istace, il est doc recommadé de choisir u om court, e miuscules et sas caractères spéciaux. Par exemple : prod. Avertissemet : Le om de l'istace accolé au om de domaie e doit pas dépasser 40 caractères. Ceci permet de limiter la taille des e-têtes "Message-ID" et d'éviter qu'u message e soit cosidéré comme u spam, par exemple par u outil comme SpamAssassi. Neolae v6.0 - Guide d'istallatio - Cofiguratio de Neolae 73

75 Neolae Das le champ Noms DNS, saisissez la liste des masques DNS auxquels l'istace doit être attachée. Le serveur Neolae utilise le om d'hôte (hostame) qui apparaît das les requêtes HTTP pour détermier quelle istace atteidre. Le om d'hôte (hostame) est compris etre les caractères et le premier caractère / de l'adresse du serveur. Vous pouvez défiir ici ue liste de valeurs séparées par des virgules. Les caractères? et * peuvet être utilisés comme jokers pour remplacer u ou plusieurs caractères (DNS, port, etc.). Aisi, la valeur demo* foctioera aisi aussi bie avec " que " ou ecore " Avertissemet : Les oms utilisés doivet être défiis das votre DNS. Vous pouvez aussi reseiger la correspodace etre u om DNS et ue adresse IP das le fichier c:/widows/system32/drivers/etc/hosts sous Widows et das le fichier /etc/hosts sous Liux. Vous devrez alors modifier les paramètres de coexio pour utiliser ce om DNS afi de se coecter à l'istace choisie. Le serveur doit être idetifié par ce om, otammet pour la mise e lige des images das les s. E complémet, le serveur doit pouvoir se coecter à lui-même par ce om, et si possible via ue adresse de bouclage (loopback) , otammet pour permettre l'export des rapports e PDF. Sélectioez la lague de l'istace (fraçais ou aglais). Avertissemet : La lague de l'istace e peut pas être modifiée a posteriori. Cliquez sur Ok pour valider la déclaratio de l'istace. Vous devez alors vous recoecter pour procéder à la déclaratio de la base de doées. La créatio d'ue istace peut être exécutée e lige de commade. Voir à ce sujet la sectio Aexes [page 163]. Créatio et paramétrage de la base de doées Lors de la créatio de la base de doées, Neolae propose deux optios distictes : 1 Créer ou recycler ue base de doées : choisissez cette optio lorsque vous souhaitez créer ue ouvelle base de doées ou réutiliser ue base existate. Voir 1er cas : créer / recycler ue base [page 75]. 2 Utiliser ue base existate : choisissez cette optio lorsque ue base vide a déjà été créée par votre admiistrateur et que vous souhaitez l'utiliser, ou pour étedre la structure d'ue base de doées existate. Voir 2e cas : utiliser ue base existate [page 80]. Les étapes de paramétrage sot présetés ci-après. Avertissemet : Les oms de la base de doées, des utilisateurs ou des schémas e doivet pas commecer par u chiffre, i utiliser de caractères spéciaux. Avertissemets Packages Vous e pouvez istaller que les packages correspodat aux optios metioées das votre cotrat de licece. 74 Neolae 2013

76 Cofiguratio de Neolae Message Ceter L'ajout d'u caal de diffusio (Caal mobile, Mobile App Chael, etc.) doit être impérativemet effectué avat l'istallatio du package Message Ceter. Si vous avez démarré u projet Message Ceter sur le caal , puis que vous décidez, au cours du projet, d'ajouter u ouveau caal, vous devez suivre ces étapes : 1 Istallez le caal souhaité, par exemple le Caal mobile, à l'aide de l'assistat d'import de package (Outils > Avacé > Import de package > Package Neolae). 2 Effectuez u import de fichier (Outils > Avacé > Import de package > Fichier), et sélectioez le fichier \datakit\ms\[votre lague]\package\messageceter.xml 3 Das la partie Coteu XML des doées à importer, coservez uiquemet le modèle de diffusio Message Ceter correspodat au caal ajouté. Par exemple, si vous avez ajouté le Caal mobile, coservez uiquemet l'élémet etities correspodat au modèle Message trasactioel mobile (smstriggermessage). 1er cas : créer / recycler ue base Les étapes pour créer ue base de doées ou recycler ue base existate sot présetées ci-après. Certais paramétrages dépedet du moteur de base de doées utilisé. Ces étapes sot les suivates : Etape 1 - Sélectio du moteur de base de doées [page 75], Etape 2 - Coexio au serveur [page 77], Etape 3 - Coexio et caractéristiques de la base de doées [page 78], Etape 4 - Packages à istaller [page 78], Etape 5 - Etapes de la créatio [page 79], Etape 6 - Lacemet de la créatio de la base [page 80]. Etape 1 - Sélectio du moteur de base de doées Sélectioez le moteur de base de doées parmi ceux proposés das la liste déroulate. Neolae v6.0 - Guide d'istallatio - Cofiguratio de Neolae 75

77 Neolae Les moteurs de base de doées supportés sot présetés das la sectio Matrice de compatibilité [page 11]. Idetifiez le serveur et sélectioez le type d'opératio à réaliser. Ici : Créer ou recycler ue base de doées. Selo le moteur de base sélectioé, les iformatios d'idetificatio du serveur diffèret. Pour u moteur Oracle, reseigez le om TNS qui a été défii sur le serveur applicatif. Pour u moteur PostgreSQL, DB2 ou MySQL, idiquez le om DNS (ou l'adresse IP) défii sur le serveur applicatif pour accéder au serveur de base de doées. Pour u moteur Microsoft SQL Server, défiissez : 1 le om DNS (ou l'adresse IP) défii sur le serveur applicatif pour accéder au serveur de base de doées : DNS ou DNS\<istace> (mode istace), 2 le mode d'authetificatio pour l'accès à SQL Server : Authetificatio SQL Server ou Authetificatio Widows NT. 76 Neolae 2013

78 Cofiguratio de Neolae Etape 2 - Coexio au serveur Das la feêtre Accès au serveur, défiissez les paramètres de coexio au serveur de la base de doées. Pour cela, saisissez le om et le mot de passe d'u compte système d'admiistratio qui possède les permissios écessaires pour créer des bases, soit : system pour ue base Oracle, Les droits miimum requis sot : GRANT CONNECT, RESOURCE et UNLIMITED TABLESPACE. sa pour ue base Microsoft SQL Server, postgres pour ue base PostgreSQL, db2ist1 pour ue base DB2, root pour ue base MySQL. Neolae v6.0 - Guide d'istallatio - Cofiguratio de Neolae 77

79 Neolae Etape 3 - Coexio et caractéristiques de la base de doées L'étape suivate permet de cofigurer les paramètres de coexio à la base de doées. Vous devez défiir les paramètres suivats : Idiquez le om de la base de doées à créer. Avertissemet : Pour ue base DB2, om de la base e doit pas excéder 8 caractères. Saisissez le mot de passe du compte associé à cette base. Idiquez si la base doit être Uicode ou o. Pour ue base Oracle, si vous sélectioez le jeu de caractères Uicode, les champs de la base serot de type varchar. Choisissez le fuseau horaire de la base de doées et idiquez évetuellemet si la base doit être e UTC, lorsque cette optio est dispoible. Voir à ce sujet la sectio Gestio des fuseaux horaires [page 135]. Etape 4 - Packages à istaller Sélectioez les packages que vous souhaitez istaller. 78 Neolae 2013

80 Cofiguratio de Neolae Cosultez votre accord de licece afi de vérifier les optios et solutios que vous avez acquises, par exemple l'optio "Gestio de coteu" ou la solutio "Gestio des ressources marketig". Etape 5 - Etapes de la créatio La feêtre Etapes de la créatio offre otammet la possibilité de vérifier et éditer le script SQL utilisé pour créer les tables. Pour ue base Oracle, Microsoft SQL Server, PostgreSQL, l'admiistrateur de bases de doées peut par ailleurs détermier ici des paramètres de stockage à utiliser lors de la créatio des objets base de doées. Pour ue base Oracle, l'utilisateur Neolae doit avoir accès aux librairies Oracle, typiquemet e état membre du groupe oistall. L'optio Fixer ou chager le mot de passe admiistrateur permet de reseiger le mot de passe associé à l'opérateur Neolae ayat les droits admiistrateur. Neolae v6.0 - Guide d'istallatio - Cofiguratio de Neolae 79

81 Neolae Il est vivemet recommadé de défiir le mot de passe du compte admiistrateur Neolae afi de e pas créer de faille de sécurité. Etape 6 - Lacemet de la créatio de la base La derière étape de l'assistat permet de lacer la créatio de la base de doées. Pour cela, cliquez sur le bouto Démarrer. Ue fois la créatio de la base de doées termiée, vous pourrez vous recoecter afi de fialiser le paramétrage de l'istace. Vous devez à préset lacer l'assistat de déploiemet pour termier la cofiguratio de l'istace. Voir Assistat de déploiemet [page 86]. Les paramètres de coexio à la base de doées associés à l'istace sot regroupés das le fichier /cof/cofig-<istace>.xml eregistré das le répertoire d'istallatio de Neolae. Exemple de cofiguratio SQL Server sur la base base601 associée au compte 'eolae' avec so mot de passe crypté : <dbcx ecrypted="1" logi="eolae:base601" password="vmaeh0ieczqvh1+vjii5xunp4q1hafs5y+idlrjphjcvcacaa==" provider="mssql" server="dbsrv"/> 2e cas : utiliser ue base existate La base de doées, aisi que l'utilisateur doivet avoir été créés par l'admiistrateur de base de doées et les droits d'accès correctemet cofigurés. Pour utiliser ue base existate, les étapes de cofiguratio sot les suivates : Etape 1 - Choix du moteur de base de doées [page 81], Etape 2 - Paramètres de coexio à la base de doées [page 82], Etape 3 - Packages à istaller [page 83], Etape 4 - Etapes de la créatio [page 83], 80 Neolae 2013

82 Cofiguratio de Neolae Etape 5 - Lacemet de la créatio de la base [page 84]. Etape 1 - Choix du moteur de base de doées Sélectioez le moteur de base de doées parmi ceux proposés das la liste déroulate. Idetifiez le serveur et sélectioez le type d'opératio à réaliser. Ici : Utiliser ue base de doées existate. Selo le moteur de base sélectioé, les iformatios d'idetificatio du serveur diffèret. Pour u moteur Oracle, reseigez le om TNS qui a été défii sur le serveur applicatif. Pour u moteur PostgreSQL, MySQL ou DB2, idiquez le om DNS (ou l'adresse IP) défii sur le serveur applicatif pour accéder au serveur de base de doées. Pour u moteur Microsoft SQL Server, défiissez : 1 le om DNS (ou l'adresse IP) défii sur le serveur applicatif pour accéder au serveur de base de doées, Neolae v6.0 - Guide d'istallatio - Cofiguratio de Neolae 81

83 Neolae 2 le mode de sécurisatio de l'accès à SQL Server : Authetificatio SQL Server ou Authetificatio Widows NT. Etape 2 - Paramètres de coexio à la base de doées Das la feêtre Base de doées, défiissez les paramètres de coexio à la base de doées. Vous devez défiir les paramètres suivats : Saisissez le om de la base de doées à utiliser, Saisissez le om et le mot de passe du compte associé à cette base, Pour ue base Oracle, il 'est pas écessaire de saisir le om du compte. Idiquez si la base doit être Uicode ou o. 82 Neolae 2013

84 Cofiguratio de Neolae Etape 3 - Packages à istaller Sélectioez les packages que vous souhaitez istaller. Cosultez votre accord de licece afi de vérifier les optios et solutios que vous avez acquises, par exemple l'optio "Gestio de coteu" ou la solutio "Gestio des ressources marketig". Etape 4 - Etapes de la créatio La feêtre Etapes de la créatio offre otammet la possibilité de vérifier et éditer le script SQL utilisé pour créer les tables. Pour ue base Oracle, Microsoft SQL Server, PostgreSQL, l'admiistrateur de bases de doées peut par ailleurs détermier ici des paramètres de stockage à utiliser lors de la créatio des objets base de doées. Pour ue base Oracle, l'utilisateur Neolae doit avoir accès aux librairies Oracle, typiquemet e état membre du groupe oistall. L'optio Fixer ou chager le mot de passe admiistrateur permet de reseiger le mot de passe associé à l'opérateur Neolae ayat les droits admiistrateur. Neolae v6.0 - Guide d'istallatio - Cofiguratio de Neolae 83

85 Neolae Il est vivemet recommadé de défiir le mot de passe du compte admiistrateur Neolae afi de e pas créer de faille de sécurité. Etape 5 - Lacemet de la créatio de la base La derière étape de l'assistat permet de lacer la créatio de la base de doées. Pour cela, cliquez sur le bouto Démarrer. Ue fois la créatio de la base de doées termiée, vous pourrez vous recoecter afi de fialiser le paramétrage de l'istace. Vous devez à préset lacer l'assistat de déploiemet pour termier la cofiguratio de l'istace. Voir Assistat de déploiemet [page 86]. Les paramètres de coexio à la base de doées associés à l'istace sot regroupés das le fichier /cof/cofig-<istace>.xml eregistré das le répertoire d'istallatio de Neolae. Exemple de cofiguratio SQL Server sur la base base601 associée au compte 'eolae' avec so mot de passe crypté : <dbcx ecrypted="1" logi="eolae:base601" password="vmaeh0ieczqvh1+vjii5xunp4q1hafs5y+idlrjphjcvcacaa==" provider="mssql" server="dbsrv"/> Paramétrage du serveur Itroductio La sectio suivate présete les paramétrages obligatoires du serveur pour garatir le bo foctioemet de Neolae das la plupart des cofiguratios. Des paramétrages complémetaires sot proposés das la sectio Paramétrages additioels côté serveur [page 106]. 84 Neolae 2013

86 Cofiguratio de Neolae Idetifiat 'iteral' L'idetifiat iteral est u logi techique à utiliser lors de la phase d'istallatio, pour les paramétrages techiques d'admiistratio et de maiteace. Ce logi 'est pas associé à ue istace. L'opérateur coecté avec cet idetifiat possède tous les droits, sur toutes les istaces. Après ue istallatio récete, cet idetifiat 'a pas de mot de passe. Il est fortemet recommadé d'e défiir u immédiatemet. Pour cela, la commade est la suivate : lserver cofig -iteralpassword Les iformatios suivates sot alors affichées. Saisissez et cofirmez le ouveau mot de passe : 17:33:57 > Applicatio server for Neolae Versio (build 6633) du 04/02/2011 Eter the curret password. Password: Eter the ew password. Password: XXXX Cofirmatio: XXXX 17:34:02 > Password successfully chaged for accout 'iteral' (autheticatio mode 'l') Fichiers de cofiguratio Les fichiers de cofiguratio sot eregistrés das le répertoire cof du répertoire d'istallatio Neolae. La cofiguratio est répartie sur deux fichiers : cofig-<istace>.xml (où istace est le om de l'istace) : cofiguratio spécifique d'ue istace. Si vous mutualisez votre serveur etre plusieurs istaces, vous devez eregistrer les paramètres spécifiques à chaque istace das so fichier associé. servercof.xml : cofiguratio géérale pour toutes les istaces. Ce fichier regroupe les paramètres techiques du serveur Neolae : ces paramètres sot commus à toutes les istaces. Vous trouverez ci-après la descriptio de certais de ces paramètres. Reportez-vous au fichier lui-même pour cosulter l'esemble des paramètres dispoibles. Vous pouvez cofigurer le répertoire de stockage (répertoire var) des doées Neolae (logs, téléchargemets, redirectios, etc.). Pour cela, utilisez la variable système XTK_VAR_DIR: Sous Widows, idiquez la valeur D:\log\Neolae das la variable système XTK_VAR_DIR Sous Liux, das le fichier customer.sh, idiquez : export XTK_VAR_DIR=/app/log/eolae Voir égalemet la sectio Cofiguratio de l'eviroemet sous Liux [page 112]. Activatio des processus L'activatio (ou la désactivatio) des processus Neolae se fait sur le serveur à partir des fichiers cofig-default.xml et cofig-<istace>.xml. Avertissemet : Pour appliquer les modificatios das ces fichiers, si le service Neolae est démarré, vous devez exécuter la commade lserver cofig -reload O distigue deux types de processus : multi-istace et moo-istace. multi-istace : u seul processus est démarré pour toutes les istaces, il s'agit des processus web, syslogd et trackiglogd. L'activatio est paramétrable à partir du fichier cofig-default.xml. Neolae v6.0 - Guide d'istallatio - Cofiguratio de Neolae 85

87 Neolae Exemple : Déclaratio d'u serveur Neolae pour l'accès aux cosoles clietes et pour la redirectio (trackig) : vi l6/cof/cofig-default.xml <web args="-tomcat" autostart="true"/> <!-- to start if the machie is also a redirectio server --> <trackiglogd autostart="true"/> Das cet exemple, le fichier est édité au travers d'ue commade vi sous Liux. Il peut être édité das 'importe quel éditeur de fichiers.txt ou.xml. moo-istace : u processus est démarré par istace (modules : mta, wfserver, imail, sms et stat). L'activatio est paramétrable à partir du fichier de cofiguratio de l'istace cofig-<istace>.xml. Exemple : Déclaratio d'u serveur pour la diffusio, l'exécutio des istaces de workflow et la récupératio des mails rebod : <mta autostart="true" statserveraddress="localhost"/> <wfserver autostart="true"/> <imail autostart="true"/> <stat autostart="true"/> Paramètres de diffusio Les paramètres de diffusio doivet être cofigurés das le fichier servercof.xml. Cofiguratio DNS : reseigez le domaie de diffusio aisi que les adresses IP (ou host) des serveurs DNS utilisés pour répodre aux requêtes DNS de type MX par le module MTA à partir de la sectio <dscofig>. Le paramètre ameservers est idispesable pour ue istallatio sous Widows. Pour ue istallatio Liux, il doit être laissé vide. <dscofig localdomai="eolae.com" ameservers=" , "/> Les autres paramètres de diffusio dispoibles das ce fichier sot présetés das la sectio Persoalisatio des paramètres de diffusio [page 106]. Cosultez égalemet le chapitre Délivrabilité des s [page 125]. Déploiemet d'ue istace Neolae Assistat de déploiemet U assistat graphique accessible à partir de la cosole cliete Neolae permet de reseiger les paramètres de l'istace sur laquelle vous allez vous coecter. 86 Neolae 2013

88 Cofiguratio de Neolae Pour démarrer l'assistat de déploiemet, sélectioez le meu Outils>Avacé>Assistat de déploiemet. Les étapes de paramétrage sot les suivates : 1 Paramètres gééraux [page 87] 2 Caal [page 88] 3 Gestio des mails rebods [page 90] 4 Paramétrage du trackig [page 92] 5 Caal mobile [page 96] 6 Optios régioales [page 98] 7 Accès depuis Iteret [page 98] 8 Gestio des ressources publiques [page 100] 9 Purge des doées [page 104] Paramètres gééraux La première étape de l'assistat de déploiemet permet de reseiger les iformatios géérales relatives à l'istace. Neolae v6.0 - Guide d'istallatio - Cofiguratio de Neolae 87

89 Neolae Iformatios géérales La sectio supérieure permet de reseiger les iformatios suivates : Idetifiat cliet pour la facturatio : il peut s'agir par exemple du om de l'istace et du uméro de versio. Nom usuel du cliet : saisissez le om de votre société. Cette iformatio est otammet utilisée otammet das les lies de désaboemet. Lague : sélectioez la lague de l'istace (fraçais/aglais UK/aglais US) das la liste déroulate. Espace de ommage : saisissez ici u idetifiat court, e miuscules. L'objectif cosiste à distiguer votre cofiguratio spécifique de la cofiguratio d'usie e cas de mise à jour. L'espace de ommage par défaut est cus - pour customer (cliet). Optios techiques La sectio iférieure de la feêtre permet de sélectioer les optios à activer. Les optios dispoibles sot les suivates : Caal pour activer la diffusio par . Voir Caal [page 88]. Trackig : pour activer le trackig du comportemet de l'utilisateur (ouvertures et clics de la populatio ciblée). Voir Paramétrage du trackig [page 92]. Gestio des mails rebods : pour défiir le compte POP utilisé pour relever les s etrats. Voir Gestio des mails rebods [page 90]. Itégratio LDAP : pour cofigurer l'idetificatio d'u utilisateur via u auaire LDAP. Voir Paramétrage LDAP/Neolae [page 114]. Avertissemet : L'itégratio LDAP est optioelle. Vérifiez votre cotrat de licece Neolae. Caal L'étape suivate permet de défiir les iformatios qui serot affichées das l'e-tête des s. Ces paramètres peuvet être surchargés das les modèles de diffusio et, uitairemet au iveau de chaque diffusio (sous réserve que les utilisateurs possèdet les droits appropriés). 88 Neolae 2013

90 Cofiguratio de Neolae Paramètres des s evoyés Idiquez les paramètres suivats : Nom expéditeur : le om de l'expéditeur, Adresse expéditeur : l'adresse de l'expéditeur, Nom de l'adresse de répose : le om, persoalisable, qui sera utilisé lorsque le destiataire clique sur le bouto Répodre de so logiciel de messagerie, Adresse de répose : l'adresse à utiliser lorsque le destiataire clique sur le bouto Répodre de so logiciel de messagerie, Adresse d'erreur : l'adresse des messages e erreur. Il s'agit d'ue adresse techique utilisée pour gérer les rebods, otammet les s reçus par le serveur Neolae si les adresses ciblés 'existet pas. E complémet, vous pouvez idiquer les masques autorisés pour l'adresse expéditeur et l'adresse d'erreur. Au besoi, ces masques doivet être séparés les us des autres par ue virgule. Ce paramétrage est facultatif. Lorsque ces champs sot reseigés, Neolae cotrôle, au momet de l'evoi (ou au momet de l'aalyse, lorsque l'adresse e cotiet pas d'élémets variables), que les adresses reseigées das la diffusio sot valables. Ce foctioemet permet d'éviter l'utilisatio d'adresses qui pourraiet poser des problème de délivrabilité. Les adresses d'expéditio doivet être cofigurées sur le serveur d'evoi. Caractères autorisés das les adresses Vous pouvez ici défiir la liste des caractères autorisés (data policy) das le champ de la base de doées. Les caractères absets de la liste serot iterdits, et doc refusés lors d'ue saisie das la base, mais aussi via u import ou à la validatio d'u formulaire Web. Deux listes sot proposées : Europées uiquemet ou US uiquemet. Elles peuvet être complétées par d'autres caractères, au besoi. Neolae v6.0 - Guide d'istallatio - Cofiguratio de Neolae 89

91 Neolae Optios de diffusio, reprises et quarataies Le lie Paramètres avacés... permet d'accéder aux optios de diffusio, aux paramètres liés aux reprises et aux mises e quarataies. Cette feêtre permet de défiir, pour toutes les campages , les optios de diffusio et de gestio de la qualité des adresses. Paramètres de la diffusio Les optios suivates sot dispoibles : Durée de diffusio des messages : durée maximum au-delà de laquelle la diffusio des messages est arrêtée (par défaut, 5 jours), Durée de validité des ressources e lige : durée pedat laquelle serot coservées toutes les iformatios relatives au profil du destiataire afi de géérer les pages miroir, Exclure les destiataires qui e souhaitet plus être cotactés : lorsque cette optio est sélectioée, la diffusio e sera pas effectuée sur les destiataires e blackliste, Supprimer automatiquemet les doublos : lorsque cette optio est sélectioée, la diffusio e sera pas effectuée sur les adresses s e doublo. Reprises Les iformatios relatives aux reprises sot idiquées das les champs Période des reprises et Nombre de reprises : lorsqu'u destiataire est iatteigable, par exemple si sa boîte mail est pleie, le programme réessayera par défaut de le cotacter 5 fois, espacées d'au mois ue heure (pedat la durée maximum de diffusio des messages). Ces valeurs peuvet être adaptées selo vos besois. Paramètres de mise e quarataie Les optios de cofiguratio pour les mises e quarataies sot les suivates : Durée etre deux erreurs sigificatives : saisissez ue valeur (par défaut "1j" : 1 jour) pour défiir le temps d'attete de l'applicatio avat d'icrémeter le compteur d'erreurs lors d'u échec, Nombre maximum d'erreurs avat mise e quarataie : ue fois atteite la valeur reseigée ici, l' est passé e quarataie (par défaut "5" : l'adresse sera mise e quarataie à la sixième erreur). Cela sigifie que ce cotact sera automatiquemet exclu des prochaies diffusios. Gestio des mails rebods Les mails rebods sot essetiels pour qualifier les erreurs suite à ue diffusio. Ces erreurs serot réparties das les NP@I ue fois que les règles aurot détermié la cause de o aboutissemet du message. Cette étape 'est proposée que lorsque les optios Caal et Gestio des mails rebods sot sélectioées à la première étape de l'assistat de déploiemet. Voir Paramètres gééraux [page 87]. 90 Neolae 2013

92 Cofiguratio de Neolae Das cette étape, vous pouvez défiir les paramètres de gestio des mails rebods. Compte POP de relevé des mails etrats Idiquez les paramètres de coexio au compte de relevé des mails etrats. Libellé : om regroupat les paramètres ci-dessous, Serveur : serveur utilisé pour relever les mails rebods ( s etrats), Sécurité : au besoi, sélectioez la valeur SSL das la liste déroulate, Port : port du serveur (e gééral 110), Compte : om du compte dédié aux rebods, Mot de passe : mot de passe associé au compte. Ue fois les paramètres POP reseigés, cliquez sur Test afi de vérifier que ces paramètres sot corrects. Mails rebods o traités Adresse de trasfert et Adresse pour les erreurs : ces champs peuvet être utilisés pour trasmettre les rebods si aucue des règles 'a pu s'appliquer au mail etrat, Avertissemet : Das la plupart des cofiguratios, il est recommadé de e pas reseiger ces champs. Au besoi, cotactez Neolae pour plus d'iformatios. Serveur SMTP : serveur utilisé pour evoyer ces s (mails sortats). Neolae v6.0 - Guide d'istallatio - Cofiguratio de Neolae 91

93 Neolae Paramétrage du trackig Das l'étape suivate, procédez à la cofiguratio du trackig pour l'istace. L'istace doit être déclarée et eregistrée auprès du ou des serveurs de trackig. Cette étape 'est proposée que lorsque les optios Caal et Trackig sot sélectioées à la première étape de l'assistat de déploiemet. Voir Paramètres gééraux [page 87]. La cofiguratio du trackig web (mode de trackig, créatio et isertio des balises...) est détaillée das le Guide de cofiguratio. Pricipe de foctioemet Lorsque vous activez le trackig sur ue istace, les URL présetes das les diffusios sot trasformées lors de l'evoi afi de permettre d'e assurer le suivi. Les iformatios cocerat les URL exteres (sécurisées ou o) saisies das cette étape de l'assistat de déploiemet sot utilisées pour costruire la ouvelle URL. E plus de ces iformatios, le lie aisi trasformé cotiet : l'idetifiat de la diffusio, l'idetifiat du destiataire et l'idetifiat de l'url. Les iformatios de trackig sot collectées par Neolae sur le ou les serveurs de trackig afi d'alimeter le profil des destiataires aisi que les doées liées à la diffusio (oglets Trackig). Les iformatios cocerat les URL iteres e sot utilisées que par le serveur applicatif Neolae afi de cotacter le ou les serveurs de trackig. Voir à ce sujet la sectio Serveur de trackig [page 92]. Ue fois les URL cofigurées, il est écessaire d'activer le trackig. Pour cela, l'istace doit être eregistrée auprès du ou des serveurs de trackig. Voir à ce sujet la sectio Eregistremet du trackig [page 93]. Serveur de trackig Pour permettre le bo foctioemet du trackig sur cette istace, les iformatios suivates doivet être paramétrées : 92 Neolae 2013

94 Cofiguratio de Neolae URL extere et/ou URL extere sécurisée : saisir l'url de redirectio à utiliser das les s à evoyer. URL itere(s) : URL utilisée(s) uiquemet par le serveur Neolae afi de cotacter le(s) serveur(s) de trackig pour la collecte des logs et le téléchargemet des URL. Il 'est pas écessaire de l'associer à l'istace. Si vous e reseigez pas d'url, par défaut l'url de trackig sera utilisée. Das le cadre d'ue architecture e Mid-Sourcig, vous pouvez exteraliser la gestio du trackig. Pour cela : 1 Sélectioez l'optio Exteraliser la gestio du trackig : vous pourrez aisi utiliser u serveur de mid-sourcig comme serveur de trackig. 2 Reseigez les champs Compte extere et Nom de l'istace pour pouvoir vous coecter au serveur de mid-sourcig. Reportez-vous à la sectio Cofiguratio et déploiemet d'u serveur de mid-sourcig [page 155] pour plus d'iformatios. 3 Cliquez sur le bouto Activer l'istace de trackig pour valider la coexio au serveur. Eregistremet du trackig Ue fois les URL reseigées, vous devez procéder à l'eregistremet du serveur de trackig. Neolae v6.0 - Guide d'istallatio - Cofiguratio de Neolae 93

95 Neolae Cliquez sur le lie Eregistremet auprès du ou des serveurs de trackig et sélectioez ue des optios proposées. Trois types d'architecture sot possibles pour la mise e place du trackig : 1 Ajouter le trackig à ue istace déjà existate Ce choix s'applique das le cas où ue istace a déjà été créée pour d'autres besois (serveur de diffusio, etc.) sur le ou les serveurs qui servirot de serveurs de trackig. Saisissez le mot de passe du compte iteral du ou des serveurs de redirectio, afi de pouvoir cofigurer l'istace de trackig. Si plusieurs serveurs de trackig sot paramétrés, leurs om et mot de passe doivet être les mêmes. Reseiger le om de l'istace et so mot de passe. 2 Créer ue ouvelle istace dédiée au trackig 94 Neolae 2013

96 Cofiguratio de Neolae Cette optio est adaptée das le cas où les istaces de trackig sot réservées au trackig et e comportet aucu autre module applicatif. Saisissez le mot de passe du compte iteral du ou des serveurs de redirectio, afi de pouvoir cofigurer l'istace de trackig. Si plusieurs serveurs de trackig sot paramétrés, ils doivet tous utiliser le même mot de passe. Reseigez le om de l'istace et so mot de passe aisi que les masques DNS qui lui sot associés, par exemple Neolae*. 3 Valider ue istace de trackig précofigurée pour vous Cette optio est utilisée lorsque vous e disposez pas du mot de passe du compte iteral ; das ce cas, u compte de trackig a été précofiguré pour vous sur le ou les serveurs de redirectio. Etrez le mot de passe du compte de trackig du ou des serveurs de redirectio, afi de pouvoir valider l'istace de trackig. Reseigez le om de l'istace à valider et so mot de passe. Cliquez sur Valider pour lacer la procédure d'eregistremet auprès des serveurs de trackig. Neolae v6.0 - Guide d'istallatio - Cofiguratio de Neolae 95

97 Neolae De retour à la feêtre précédete, u message cofirme l'eregistremet auprès du serveur de trackig : IMPORTANT : Das u cotexte stadard d'istallatio, les paramètres relatifs à la recherche des URL e doivet pas être modifiés. Pour tout autre cas, cotactez Neolae. Caal mobile L'étape suivate permet de défiir les paramètres par défaut lors des diffusios vers les mobiles (SMS, MMS et WAP Push). 96 Neolae 2013

98 Cofiguratio de Neolae Avertissemet : Le caal mobile est ue optio : l'étape suivate 'apparaît que si elle a été acquise. Cosultez votre cotrat de licece. Compte par défaut pour le routage des SMS Reseigez les iformatios suivates : Libellé : idiquez u om pour ce compte SMS/ Wap Push/ MMS. Il peut coteir par exemple le om de votre prestataire. Pour les champs Serveur, Port, Compte, Mot de passe, Coecteur, Edpoit evoi, Edpoit rcp, Edpoit otif, cotactez votre prestataire afi d'obteir les paramètres écessaires. Paramètres des SMS evoyés Das la liste déroulate Priorité, sélectioez la valeur "ormale", "haute" ou "urgete" afi de l'appliquer aux messages qui serot diffusés. Paramètres avacés Le lie Paramètres avacés... permet d'accéder aux optios de reprise et de mise e quarataies. Neolae v6.0 - Guide d'istallatio - Cofiguratio de Neolae 97

99 Neolae Reprises Les iformatios relatives aux reprises sot idiquées das les champs Période des reprises et Nombre de reprises : lorsqu'u mobile est iatteigable, le programme réessayera par défaut de le cotacter 5 fois, espacées d'au mois 15 miutes (pedat la durée maximum de diffusio des messages). Ces valeurs peuvet être adaptées selo vos besois. Paramètres de mise e quarataie des mobiles Les optios de cofiguratio pour les mises e quarataies sot les suivates : Durée etre deux erreurs sigificatives : saisissez ue valeur (par défaut "1j" : 1 jour) pour défiir le temps d'attete de l'applicatio avat d'icrémeter le compteur d'erreurs lors d'u échec. Nombre maximum d'erreurs avat mise e quarataie : ue fois atteite la valeur reseigée ici, le uméro de mobile est passé e quarataie (par défaut "5" : le uméro sera mis e quarataie à la sixième erreur). Cela sigifie que ce cotact sera automatiquemet exclu des prochaies diffusios. Optios régioales Cette étape permet d'idiquer des préféreces relatives aux cotraites sur les doées (data policy). Iterpréter les uméros comme iteratioaux : si cette optio est sélectioée, l'applicatio appliquera le format iteratioal aux uméros de téléphoe (le préfixe du pays est alors obligatoire car le ombre de chiffres e sera pas vérifié avat d'appliquer le formatage). Si cette case 'est pas cochée, vous devez préfixer vous-même le uméro de téléphoe iteratioal avec "+" ou "00". Stocker tous les uméros au format iteratioal : cette optio e cocere que les uméros de téléphoe fraçais importés ou édités. O défiit ici si l'o préfère utiliser u format de uméro à 10 chiffres (ex : ) ou u format iteratioal (ex : ) Accès depuis Iteret Cette étape permet de défiir les URL d'accès aux pages Neolae exposées sur Iteret. 98 Neolae 2013

100 Cofiguratio de Neolae Vous devez égalemet y idiquer les optios de publicatio liées aux formulaires Web et aux purl d'accès aux Microsites. Serveurs exposés sur le Web Reseigez das cette page les URL des serveurs pour : 1 Accéder au serveur applicatif exposé sur Iteret : formulaires d'iscriptio / de désiscriptio, extraet, etc. 2 Accéder au serveur applicatif pour les ressources o exposées sur le Web : formulaires, itraet, pages de validatio. 3 Accéder aux pages miroir reseigées des diffusios. Ue page miroir est ue page dyamique qui affiche le coteu de l' . Elle est accessible via u lie iséré das le message adressé au destiataire et peut coteir des élémets de persoalisatio, s'ils ot été défiis. La page miroir permet au destiataire de lire correctemet l' das so avigateur Iteret plutôt que das so outil de messagerie, quel que soit so format de réceptio (texte ou HTML). Toutefois, pour chaque actio de diffusio, les pages miroir e sot géérées que si u coteu HTML a été défii. Neolae offre la possibilité de différecier ces trois URL afi de mieux répartir la charge sur plusieurs plateformes. Mode de publicatio des formulaires et des purl Vous pouvez égalemet sélectioer le mode de publicatio des formulaires Web et des questioaires aisi que celui des purl. Voir à ce propos la sectio??? [page?]. Délai d'ivalidatio des purl Vous pouvez défiir u délai d'ivalidatio des purl. Neolae v6.0 - Guide d'istallatio - Cofiguratio de Neolae 99

101 Neolae Par défaut, les purl sot valides pedat toute la durée de vie du microsite auquel elles sot associées. Vous pouvez prologer leur validité das l'assistat de déploiemet, à partir du champ Délai d'ivalidatio des purl. La valeur par défaut est 90j. Le pricipe est le suivat : lorsqu'ue date de fi a été défiie au iveau du microsite, il 'est affiché que pedat sa période de validité. Lorsqu'u utilisateur souhaite y accéder au-delà de cette période, la page de fermeture est affichée. Toutefois, lors de la publicatio d'u Microsite, toutes les purl de la plateforme Neolae sot égalemet republiées : Neolae vérifie alors la validité de chaque purl. Ue purl est valide pedat toute la période de validité du microsite auquel elle est associée. Lors de la publicatio, les purl qui e sot plus valides sot désactivées : si u utilisateur clique pour accéder à u microsite fermé via ue de ces purl, il obtiet alors ue page d'erreur. Le délai d'ivalidatio permet alors de prologer l'affichage de la page de fermeture. Gestio des ressources publiques Pour être visibles depuis l'extérieur, les images utilisées das les s et les ressources publiques doivet être présetes sur u serveur accessible. Elles pourrot aisi être dispoibles pour les destiataires ou les opérateurs exteres. Les ressources publiques sot accessibles à partir du oeud Admiistratio>Ressources>O-lie>Ressources publiques de l'arborescece Neolae. Elles sot regroupées das ue bibliothèque et peuvet être icluses das les s mais aussi utilisées au iveau des opératios ou des tâches, aisi que pour la gestio de coteu. 100 Neolae 2013

102 Cofiguratio de Neolae La gestio de ces ressources doit être paramétrée das l'assistat de déploiemet. Nouvelle URL des ressources Le premier champ permet de saisir le début de l'url des ressources lorsqu'elles sot mises e lige. Les ressources sot alors accessibles via cette ouvelle URL. Avertissemet : Das u mode par défaut, utilisez : Pour les images des s, l'url Cette valeur peut être surchargée au iveau de chaque diffusio. Pour les ressources publiques, l'url où istace est le om de l'istace de trackig. Gestio des images d'ue diffusio Das ue diffusio, vous pouvez utiliser des images stockées das la bibliothèque de ressources publiques ou toute autre image locale ou stockée sur u serveur. Le mode d'utilisatio et la gestio des images das les s sot présetés das la sectio "Gestio des images das les s" du guide Neolae Delivery. Le champ Masques des URL permet d'idiquer la liste des masques des URL qui serot igorées lors de la mise e lige automatique des images. Par exemple, si vous utilisez des images qui sot stockées sur u site accessible depuis l'extérieur, otammet sur votre site iteret, vous pouvez saisir das ce champ l'url d'accès au site. Vous pouvez saisir plusieurs masques, séparés les us des autres par ue virgule. Neolae v6.0 - Guide d'istallatio - Cofiguratio de Neolae 101

103 Neolae Das l'assistat de diffusio, les images appelées depuis ces URL aurot le statut "Igoré". Modes de publicatio La sectio iférieure de l'assistat de déploiemet permet de sélectioer les optios de publicatio des ressources publiques et des images. Ces optios sot égalemet dispoibles pour les formulaires Web et questioaires aisi que pour les purl paramétrés à l'étape précédete. Les modes de publicatio suivats sot dispoibles : Serveur(s) de trackig Les ressources serot automatiquemet copiées sur les différets serveurs de trackig. Ils sot cofigurés à l'étape Paramétrage du trackig [page 92]. Autre(s) serveur(s) Neolae Vous pouvez utiliser u ou plusieurs autres serveurs Neolae où serot copiées les ressources. Avertissemet : Côté serveur, pour utiliser u serveur Neolae dédié, vous devez créer ue ouvelle istace avec la commade suivate : lserver cofig -addtrackigistace:<trackiga>/<trackiga*> Puis saisissez le mot de passe. Les paramètres du ou des serveurs dédiés sot idiqués das les champs URL médias, Nom de l'istace et Mot de passe. 102 Neolae 2013

104 Cofiguratio de Neolae Script de publicatio mauelle (seulemet pour les ressources publiques) Vous pouvez publier les ressources via u script. Pour les images, il doit les copier depuis le dossier "images" reseigé via l'optio NmsDelivery_ImageSubDirectory vers u ou plusieurs serveurs frotaux. Ces serveurs vot stocker les images afi de les redre accessibles via la ouvelle URL cofigurée. Avertissemet : Vous devez créer ce script : so coteu déped de votre cofiguratio. Le script sera appelé via la commade suivate : [Neolae v6]/copytofrotal.vbs "$(XTK_INSTALL_DIR)\var\<istace>\upload\" "img1,img2,img3" où [Neolae v6] est le chemi d'accès au répertoire d'istallatio de Neolae. Sous Uix, assurez-vous que ce script soit exécutable. E cas de publicatio sur u serveur Neolae, et o via u script de publicatio mauelle, les images d'ue diffusio sot stockées par défaut das le répertoire $(XTK_INSTALL_DIR)/var/res/img/. L'URL correspodate est la suivate : Les ressources publiques sot quat à elles stockées das le répertoire XTK_INSTALL_DIR)/var/res/$(INSTANCE_NAME). L'URL correspodate est la suivate : où istace est le om de l'istace de trackig. Vous pouvez modifier le répertoire de stockage des ressources publiques. Voir à ce sujet la sectio Gestio des ressources publiques [page 110] Neolae v6.0 - Guide d'istallatio - Cofiguratio de Neolae 103

105 Neolae Purge des doées La derière étape de l'assistat de déploiemet permet de paramétrer la purge automatique des doées obsolètes de la base. Les valeurs sot exprimées e jours. Les doées sot supprimées automatiquemet par le workflow Nettoyage de la base (cleaup). Le foctioemet et le paramétrage de ce workflow, aisi que le détail des élémets supprimés, sot présetés das le Guide d'exploitatio. 104 Neolae 2013

106 CHAPITRE 7 Paramétrages complémetaires Table des matières Itroductio Paramétrages additioels côté serveur Port Tomcat par défaut Mappig d'u dossier sous Tomcat Persoalisatio des paramètres de diffusio Sécurité et relais des pages dyamiques Trackig redodat Gestio des ressources publiques Workflows e haute dispoibilité Cofiguratio de l'eviroemet sous Liux Itroductio Java Developmet Kit (JDK) par défaut Paramétrages additioels de l'istace Cofiguratio pour l'utilisatio des purl Paramétrage LDAP/Neolae Accès à ue base de doées extere Présetatio Pricipe de foctioemet Pré-requis Paramétrer l'accès à ue base extere Délivrabilité des s Présetatio Pricipe de foctioemet Cotrôler le débit de diffusio Cofiguratio des serveurs Moitorig des serveurs de diffusio Optimisatio de l'evoi d' s : recommadatios Gestio des fuseaux horaires Présetatio Cofiguratio Paramétrage des composats tierce-partie OpeOffice.org Cliet Oracle sous Liux SpamAssassi Paramétrage du coecteur Neolae-Adobe Geesis Présetatio Paramétrage d'adobe Geesis Paramétrage de Neolae Paramétrage des coecteurs CRM Présetatio Neolae v6.0 - Guide d'istallatio - Paramétrages complémetaires 105

107 Neolae Etapes de paramétrage Exemple pour Salesforce.com Exemple pour Oracle ODemad Cofiguratio et déploiemet d'u serveur de mid-sourcig Itroductio Etapes d'istallatio et de cofiguratio d'ue istace Déploiemet d'u serveur de mid-sourcig Multiplexage du serveur de mid-sourcig Cofiguratio du trackig sur u serveur de mid-sourcig Itroductio Le chapitre suivat présete les paramétrages complémetaires dispoibles et leur mode d'applicatio. Ces paramétrages sot dépedet de votre eviroemet, votre architecture, votre cofiguratio et de vos besois. Paramétrages additioels côté serveur Port Tomcat par défaut Lorsque le port d'écoute 8080 du serveur Tomcat est déjà occupé par ue autre applicatio écessaire à votre cofiguratio, vous devez remplacer le port 8080 par u autre port o utilisé (8090 par exemple). Pour le modifier, éditez le fichier server.xml eregistré das le répertoire /tomcat-6/cof du répertoire d'istallatio de Neolae. Vous devez esuite chager le port de l'url de relais des pages JSP. Pour cela, modifiez le fichier servercof.xml eregistré das le répertoire /cof du répertoire d'istallatio de Neolae : <servercof>... <web cotrolport="8005" httpport="8090"... <url... targeturl=" Mappig d'u dossier sous Tomcat Afi de défiir les paramètres propres aux cliets, vous pouvez créer u fichier user_cotexts.xml das le dossier /tomcat-6/cof, où se trouve égalemet le fichier cotexts.xml. Ce fichier cotiedra des iformatios du type : <Cotext path='/foo' docbase='../customers/foo' reloadable='true' trusted='false'/> crosscotext='true' debug='0' Au besoi, cette opératio doit être reproduite côté serveur. Persoalisatio des paramètres de diffusio Les paramètres de diffusio sot défiis das le fichier de cofiguratio servercof.xml. La cofiguratio géérale du serveur et les commades associées sot présetées das la sectio Paramétrage du serveur [page 84]. E complémet, vous pouvez procéder aux paramétrages suivats, selo vos besois et votre cofiguratio. 106 Neolae 2013

108 Paramétrages complémetaires Relais SMTP : le module MTA agit comme u aget de trasfert de mails atif pour la diffusio par le protocole SMTP (port 25). Il est cepedat possible de le remplacer par u serveur de messagerie relais si la politique de sécurité l'impose, sachat que ce foctioemet dégrade fortemet les performaces e diffusio et limite la capacité de qualifier les erreurs de diffusios sychroes (détectées par l'aalyse du trafic SMTP). Das ce cas, le paramétrage se fait à partir de la cofiguratio du serveur SMTP das la sectio <relay>, vous devez reseiger l'adresse IP (ou host) du serveur SMTP pour le trasfert des mails avec so port associé (25 par défaut). <relay address=" " port="25"/> Avertissemet : Ce mode de foctioemet implique des limitatios importates sur les diffusios. Optimiser les performaces : il est possible de cotrôler la populatio de processus fils (maxspareservers, par défaut 2) afi d'optimiser les performaces de la diffusio e foctio de la puissace des machies et des ressources réseaux dispoibles. Ce paramétrage se réalise sur chacue des machies accueillat le module MTA das la sectio <master> de la cofiguratio des agets de diffusio. <master databasepoolperiodsec="30" databaseretrydelaysec="60" maxspareservers="2" mispareservers="0" startspareservers="0"> Reportez-vous égalemet à la sectio Optimisatio de l'evoi d' s : recommadatios [page 133]. Maîtriser le trafic SMTP sortat : il est possible de gérer les affiités avec les adresses IP pour ue meilleure maîtrise du trafic SMTP sortat. Pour cela, les étapes sot les suivates : 1 Saisissez les affiités das la sectio <IPAffiity> du fichier servercof.xml. Vous pouvez défiir plusieurs oms pour ue même affiité : ces oms doivet être séparés les us des autres par le caractère ;. Exemple : <IPAffiity ame="mid.server;wwserver;local.server"> <IP address="xx.xxx.xx.xx" helohost="myserver.us.eolae.et" publicid="123" excludedomais="eo.*" weight="5"/> Reportez-vous au fichier servercof.xml pour cosulter les paramètres à utiliser. 2 Pour permettre la sélectio de l'affiité das les listes déroulates, vous devez ajouter le ou les oms des affiités das l'éumératio IPAffiity. Neolae v6.0 - Guide d'istallatio - Paramétrages complémetaires 107

109 Neolae Les éumératios sot présetées das le guide Neolae Platform. Il est esuite possible de sélectioer l'affiité à utiliser, comme ci-dessous au iveau des typologies : Cosultez égalemet à ce propos la sectio Cofiguratio des serveurs de diffusios [page 130]. Sécurité et relais des pages dyamiques Par défaut, toutes les pages dyamiques sot relayées automatiquemet au serveur local Tomcat de la machie dot le module Web est démarré. Ce paramétrage est reseigé das la sectio <url> de la cofiguratio du relais des requêtes du fichier ServerCof.xml. Vous pouvez égalemet relayer l'exécutio de la page dyamique sur u serveur distat, das le cas où le module Web 'est pas activé sur la machie. Pour cela, vous devez remplacer la valeur localhost par le om de la machie distate pour les pages JSP et JSSP, les applicatios Web, les rapports et les chaîes. Cosultez le fichier de cofiguratio servercof.xml pour plus d'iformatios sur les différets paramètres dispoibles. Pour les pages JSP, le paramétrage par défaut est le suivat : <url relayhost="true" relaypath="true" targeturl=" urlpath="*.jsp"/> Neolae utilise les pages JSP suivates : /l/jsp/soaprouter.jsp : coexio des cosoles clietes et services Web (API SOAP), /l/jsp/m.jsp : pages miroir, /ms/jsp/webform.jsp : formulaires Web (pour compatibilité v4 seulemet), /l/jsp/logo.jsp : accès aux rapports par le Web et au déploiemet de la cosole cliete, /l/jsp/s.jsp : utilisatio du marketig viral (parraiage et réseaux sociaux). 108 Neolae 2013

110 Paramétrages complémetaires Exemple : Vous pouvez empêcher la coexio des postes cliets de l'extérieur. Pour cela, il suffit de restreidre l'exécutio de soaprouter.jsp et de 'autoriser que l'exécutio des pages miroirs, des lies viraux, des formulaires web et des ressources publics. Les paramètres sot les suivats : <url IPMask="<IP_addresses>" dey="" hostmask="" relayhost="true" relaypath="true" targeturl=" timeout="" urlpath="*.jsp"/> <url IPMask="<IP_addresses>" dey="" hostmask="" relayhost="true" relaypath="true" targeturl=" timeout="" urlpath="*.jssp"/> <url IPMask="" dey="" hostmask="" relayhost="true" relaypath="true" targeturl=" timeout="" urlpath="m.jsp"/> <url IPMask="" dey="" hostmask="" relayhost="true" relaypath="true" targeturl=" timeout="" urlpath="s.jsp"/> <url IPMask="" dey="" hostmask="" relayhost="true" relaypath="true" targeturl=" timeout="" urlpath="webform.jsp"/> <url IPMask="" dey="" hostmask="" relayhost="true" relaypath="true" targeturl=" timeout="" urlpath="/webapp/pub*"/> <url IPMask="" dey="" hostmask="" relayhost="true" relaypath="true" targeturl=" timeout="" urlpath="/jssp/pub*"/> <url IPMask="" dey="" hostmask="" relayhost="true" relaypath="true" targeturl=" timeout="" urlpath="/strigs/pub*"/> <url IPMask="" dey="" hostmask="" relayhost="true" relaypath="true" targeturl=" timeout="" urlpath="/iteractio/pub*"/> <url IPMask="" dey="true" hostmask="" relayhost="false" relaypath="false" targeturl=" timeout="" urlpath="*.jsp"/> <url IPMask="" dey="true" hostmask="" relayhost="false" relaypath="false" targeturl=" timeout="" urlpath="*.jssp"/> Das cet exemple, la valeur <IP_addresses> correspod à la liste des adresses IP (séparées par des virgules) ayat la permissio d'utiliser le module de relais pour ce masque. Avertissemet : Les valeurs doivet être adaptées selo votre cofiguratio et vos cotraites réseau, e particulier si des paramétrages spécifiques ot été développés pour votre istallatio. Trackig redodat Avertissemet : Das le cas d'ue architecture stadard ou etreprise, le serveur applicatif pricipal doit être autorisé à uploader des iformatios de trackig sur chaque machie. Lorsque plusieurs serveurs sot utilisés pour servir la redirectio, ceux-ci devrot pouvoir commuiquer etre eux par des appels SOAP afi de partager les iformatios des URL à rediriger. Il se peut e effet qu'au momet du démarrage de la diffusio tous les serveurs de redirectios e soiet pas dispoibles et e possèdet doc pas le même iveau d'iformatio. Les URL des serveurs redodats doivet être reseigées das la cofiguratio de la redirectio (depuis le fichier servercof.xml). Exemple : <spareserver eabledif="$(hostame)!='frot_srv1'" id="1" url=" <spareserver eabledif="$(hostame)!='frot_srv2'" id="2" url=" La propriété eableif est optioelle (vide par défaut) et permet de 'activer la coexio que si le résultat est vrai ; ceci afi d'obteir ue cofiguratio idetique sur tous les serveurs de redirectio. Pour coaître le hostame de la machie, lacer la commade : hostame -s Neolae v6.0 - Guide d'istallatio - Paramétrages complémetaires 109

111 Neolae Gestio des ressources publiques Les ressources publiques sot présetées das la sectio Gestio des ressources publiques [page 100]. Elles sot stockées das le répertoire /var/res/istace du répertoire d'istallatio de Neolae. L'URL correspodate est la suivate : où istace est le om de l'istace de trackig. Vous pouvez idiquer u autre répertoire e ajoutat u oeud supplémetaire das le fichier cof-<istace>.xml afi de paramétrer le stockage sur le serveur. Les liges suivates doivet alors être ajoutées : <servercof> <shared> <datastore hosts="media*" lag="fra"> <virtualdir ame="images" path="/var/www/images"/> <virtualdir ame="publicfileres" path="$(xtk_install_dir)/var/res/$(instance_name)/"/> </datastore> </shared> </servercof> Avertissemet : Das ce cas, la ouvelle URL des ressources publiques idiquée das la sectio supérieure de la feêtre de l'assistat de déploiemet doit poiter sur ce dossier. Workflows e haute dispoibilité Vous pouvez cofigurer plusieurs serveurs de workflow (wfserver) et les répartir sur deux machies ou plus. Si vous optez pour cette architecture, paramétrez le mode de coexio des répartiteurs de charge e foctio de l'accès à Neolae. Das le cas d'u accès depuis le web, choisissez le mode load balacer afi de limiter les temps de coexio. Si l'accès se fait depuis la cosole Neolae, préférez le mode hash ou sticky ip. Ceci vous permet de maiteir la coexio etre le cliet riche et le serveur et d'éviter qu'ue sessio utilisateur e soit iterrompue au cours d'ue opératio d'import ou d'export par exemple. Défiitio des affiités Vous pouvez choisir de forcer l'exécutio d'u workflow ou d'ue activité de workflow sur ue machie particulière. Vous devez pour cela défiir ue ou plusieurs affiités au iveau du workflow ou de l'activité cocerée. 110 Neolae 2013

112 Paramétrages complémetaires 1 Créez la ou les affiités du workflow ou de l'activité e la tapat das le champ Affiité. Figure 7.1. Créatio d'ue affiité pour u workflow Figure 7.2. Créatio d'ue affiité pour ue activité 2 Ouvrez le fichier l6/cof/cofig-xxx.xml. 3 Modifiez la lige correspodat au module wfserver de la faço suivate : <wfserver autostart="true" affiity="xxx,"/> Neolae v6.0 - Guide d'istallatio - Paramétrages complémetaires 111

113 Neolae Si vous défiissez plusieurs affiités, elles doivet être séparées par ue virgule sas espace : <wfserver autostart="true" affiity="xxx,yyy,"/> Avertissemet : La virgule qui suit le om de l'affiité est écessaire afi que les workflows pour lesquels aucue affiité 'est défiie puisset s'exécuter. Si vous souhaitez 'exécuter que les workflows pour lesquels ue affiité est défiie, modifiez la lige de la faço suivate : <wfserver autostart="true" affiity="xxx"/> Cofiguratio de l'eviroemet sous Liux Itroductio Certaies combiaisos requièret des modificatios de l'eviroemet utilisé pour exécuter Neolae. U fichier spécifique (/usr/local/eolae/l6/customer.sh) peut être créé et édité pour ajouter des modificatios spécifiques à l'eviroemet Neolae. S'il existe, ce fichier est pris e compte lorsque l'o se coecte e tat que eolae et lors du lacemet automatique des processus Neolae au démarrage. Pour que les modificatios soiet prises e compte, il est doc écessaire de se décoecter et se recoecter au compte eolae. Java Developmet Kit (JDK) par défaut Par défaut, le script de cofiguratio de l'eviroemet Neolae (~/l6/ev.sh) recherche le répertoire d'istallatio du JDK. Ce foctioemet 'état pas fiable à 100%, il est souvet écessaire de préciser quel JDK utiliser. Pour cela, vous pouvez forcer la variable d'eviroemet JDK_HOME. Editez le fichier customer.sh à l'aide de la commade vi customer.sh et ajoutez la lige suivate : export JDK_HOME=/usr/java/jdk1.6.0_07 Il s'agit ici d'u exemple. Assurez-vous que la versio du JDK utilisée correspod au om du répertoire. Pour tester la cofiguratio du JDK, coectez-vous e tat qu'utilisateur Neolae système avec la commade suivate : su - eolae Paramétrages additioels de l'istace Cofiguratio pour l'utilisatio des purl Pour utiliser des URL persoalisées (purl) das vos diffusios, ue cofiguratio adéquate doit avoir été réalisée au préalable. U paramétrage gééral doit être réalisé au iveau de l'istace, et uitairemet pour chaque ouveau domaie. La cofiguratio techique de l'istace est la suivate : 1 Le mode de publicatio des purl doit être paramétré das l'assistat de déploiemet. Voir à ce sujet la sectio Assistat de déploiemet [page 86]. 112 Neolae 2013

114 Paramétrages complémetaires 2 Au iveau du serveur Web (Apache ou IIS), il est recommadé de désactiver les robots afi d'iterdire l'idexatio des Microsites, par exemple via le fichier robots.txt. Pour chaque ouveau domaie, les élémets suivats doivet égalemet être cofigurés : 1 Au iveau de la plateforme Neolae, pour pouvoir paramétrer les modèles de purl, les éumératios correspodat aux domaies doivet avoir été créées au iveau du oeud Admiistratio>Plateforme>Eumératios. Cliquez sur le bouto Ajouter pour créer ue ouvelle valeur d'éumératio puis reseigez so om itere et so libellé. 2 Les domaies utilisés das les purl doivet être cofigurés das le fichier de cofiguratio de l'istace, cofig-<istace>.xml, au iveau du paramétrage du serveur de redirectio des purl. <?xml versio='1.0'?> <servercof> <shared> <datastore hosts="evolutio.eolae.com*,media.eolae.com*,trackig.eolae.et*" lag="fra"> <datasource ame="default"> <dbcx ecrypted="1" logi="eolae:mylogi" password="mypassword" provider="db" server="dbserver"/> </datasource> </datastore> </shared>... 3 Votre ifrastructure DNS doit être cofigurée afi de predre e compte les domaies et sous-domaies utilisés das les purl, y compris les certificats liés au protocole https, au besoi. Neolae v6.0 - Guide d'istallatio - Paramétrages complémetaires 113

115 Neolae Parmi les optios de la plateforme Neolae, l'optio NmsPurl_TrackigServers peut idiquer, pour chaque domaie de purl, le serveur de trackig à utiliser pour la redirectio. Par défaut, le serveur utilisé est celui paramétré das l'assistat de déploiemet. Paramétrage LDAP/Neolae Avertissemet : Le module LDAP est u module optioel : cette cofiguratio e doit être réalisée que si vous avez acquis cette optio. Cosultez votre cotrat de licece. Cofiguratio LDAP La cofiguratio LDAP est réalisée das l'assistat de déploiemet. L'optio Itégratio LDAP doit être sélectioée das la première étape de cofiguratio. Voir Assistat de déploiemet [page 86]. 114 Neolae 2013

116 Paramétrages complémetaires La feêtre correspodate permet de cofigurer l'idetificatio des utilisateurs Neolae via l'auaire LDAP spécifié. Idiquez l'adresse du serveur LDAP das le champ Serveur LDAP. Vous pouvez ajouter le uméro de port. Par défaut, le port utilisé est le 389. Sélectioez das la liste déroulate le mécaisme d'authetificatio des utilisateurs : 1 Mot de passe crypté (md5) Mode par défaut. 2 Mot de passe e clair + SSL (TLS) Toute la procédure d'authetificatio (mot de passe compris) est cryptée. Le port sécurisé 636 e doit pas être utilisé das ce mode : Neolae passe automatiquemet e mode sécurisé. Lorsque vous utilisez ce mode d'authetificatio, sous Liux, le certificat est vérifié par la bibliothèque cliet opeldap. Nous vous recommados d'utiliser u certificat SSL valide afi que la procédure d'authetificatio soit cryptée. Das le cas cotraire, les iformatios serot passées e clair. Le certificat 'est pas vérifié sous Widows. 3 Widows NT LAN Maager (NTLM) Authetificatio propriétaire Widows. Le champ Idetifiat uique est utilisé pour le om de domaie seulemet. 4 Distributed Password Autheticatio (DPA) Authetificatio propriétaire Widows. Le champ Idetifiat uique 'est utilisé que pour le om de domaie (domaie.com). 5 Mot de passe e clair (plai text) Aucu cryptage (utiliser e test uiquemet). Choisissez le mode d'idetificatio des utilisateurs : Composer automatiquemet l'idetifiat uique de l'utilisateur (voir l'étape Calcul des idetifiats [page 116]) ou Rechercher l'idetifiat uique de l'utilisateur das l'auaire (voir l'étape Recherche des idetifiats [page 117]). Neolae v6.0 - Guide d'istallatio - Paramétrages complémetaires 115

117 Neolae Compatibilité Les systèmes compatibles dépedet du mécaisme d'authetificatio sélectioé. Le tableau suivat liste les compatibilités e foctio du système d'exploitatio du serveur Neolae et du type de serveur LDAP utilisé. md5 TLS NTLM & DPA plai text OpeLDAP Widows, Liux Liux Widows, Liux Active Directory Liux Widows, Liux Widows Widows, Liux Idetificatio LDAP Calcul des idetifiats Si vous choisissez de calculer les idetifiats, l'étape suivate de l'assistat de déploiemet permet de paramétrer le mode de calcul. Idiquez l'idetifiat uique de l'utilisateur das l'auaire (Distiguished Name - DN) das le champ Idetifiat uique (DN). (logi) sera remplacé par l'idetifiat de l'opérateur Neolae. Avertissemet : Le paramètre dc doit être e miuscules. Sélectioez l'optio Activer la sychroisatio des droits utilisateurs depuis les autorisatios ou groupes de l'auaire afi de sychroiser l'associatio etre les groupes et les utilisateurs das l'auaire LDAP et l'associatio etre les groupes et les utilisateurs das Neolae. Lorsque vous sélectioez cette optio, les champs DN applicatif pour la recherche et Mot de passe du logi applicatif sot actifs. Si vous reseigez ces deux champs. Neolae se coectera alors au serveur LDAP avec so propre logi et mot de passe. S'ils sot vides, Neolae se coectera au serveur de maière aoyme. 116 Neolae 2013

118 Paramétrages complémetaires Recherche des idetifiats Si vous choisissez de faire ue recherche sur l'idetifiat, l'assistat de déploiemet permet de paramétrer la recherche. Das les champs DN applicatif pour la recherche et Mot de passe du logi applicatif idiquez l'idetifiat et le mot de passe avec lesquels Neolae se coectera pour rechercher l'idetifiat. S'ils sot vides, Neolae se coectera au serveur de maière aoyme. Les champs Idetifiat de la base et Etedue de la recherche permettet de détermier le sous-esemble de l'auaire LDAP à partir duquel s'effectuera la recherche. Sélectioez le mode voulu das la liste déroulate : 1 Récursif (mode par défaut). La recherche s'effectue sur toute l'arborescece de l'auaire LDAP, à partir d'u iveau doé. 2 Limité à la base. La recherche s'effectue sur tous les attributs de l'arborescece. 3 Limité au premier sous-iveau de la base. La recherche s'effectue sur tous les attributs de l'arborescece et le premier sous-iveau de l'attribut. Le champ Filtre vous doe la possibilité de spécifier u élémet pour affier l'étedue de la recherche. Neolae v6.0 - Guide d'istallatio - Paramétrages complémetaires 117

119 Neolae Cofiguratio des autorisatios LDAP Cette feêtre est proposée lorsque vous sélectioez l'optio Activer la sychroisatio des droits utilisateurs depuis les autorisatios ou groupes de l'auaire (voir l'étape Activer la sychroisatio des droits utilisateurs depuis les autorisatios ou groupes de l'auaire [page 116]). Vous devez fourir plusieurs paramètres pour retrouver le ou les groupes auxquels appartiet l'utilisateur et les autorisatios dot il dispose par extesio, à savoir : le champ Idetifiat de la base, le champ Etedue de la recherche, Si vous avez choisi de rechercher l'idetifiat de l'utilisateur, vous pouvez sélectioer Réutiliser les paramètres de recherche du DN afi de reporter les valeurs choisies pour l'idetifiat de la base et l'étedue de la recherche das la feêtre précédete. le champ Filtre de recherche de droits, basé sur le logi et l'idetifiat uique de l'utilisateur, le champ Attribut coteat le om du groupe ou de l'autorisatio cocerat l'utilisateur, le champ Masque de correspodace permettat d'extraire le om d'u groupe das Neolae et les droits qui lui sot associés. La recherche sur le om se fait avec des expressios régulières. Sélectioez Autoriser la coexio des utilisateurs déclarés das l'auaire LDAP si l'opérateur 'est pas déclaré das Neolae afi que l'utilisateur se voit attribuer automatiquemet des droits d'accès lors de sa coexio. Cliquez sur Eregistrer pour termier la cofiguratio de l'istace. Gestio des opérateurs Ue fois le paramétrage validé, vous devez défiir quels opérateurs Neolae serot gérés via l'auaire LDAP. 118 Neolae 2013

120 Paramétrages complémetaires Pour utiliser l'auaire LDAP pour l'authetificatio d'u opérateur, éditez le profil de l'opérateur et cliquez sur le lie Paramètres avacés... Sélectioez l'optio Utiliser LDAP pour vérifier le mot de passe : le champ Mot de passe sera alors grisé pour cet opérateur. Cas pratiques Cette sectio propose quelques cas pratiques simples afi de réaliser les paramétrages les mieux adaptés à vos besois. 1 U utilisateur existe das l'auaire LDAP mais 'a pas été créé das Neolae. Neolae peut être cofiguré afi que l'utilisateur accède à Neolae e utilisat so authetificatio LDAP. Pour cela, Neolae doit pouvoir cotrôler la validité du couple idetifiat/mot de passe das l'auaire LDAP. L'opérateur pourra aisi être créé à la volée das Neolae : pour cela, cochez l'optio Autoriser la coexio des utilisateurs déclarés das l'auaire LDAP si l'opérateur 'est pas déclaré das Neolae. Das ce cas, la sychroisatio des groupes doit égalemet être paramétrée : l'optio Activer la sychroisatio des droits utilisateurs depuis les autorisatios ou groupes de l'auaire doit être sélectioée. 2 U utilisateur existe das Neolae mais 'a pas été créé das l'auaire LDAP. Il e pourra alors pas se coecter à Neolae. 3 U groupe 'existe pas das Neolae mais seulemet das l'auaire LDAP. Ce groupe e sera pas créé das Neolae. Vous devez créer le groupe et sychroiser les groupes afi de permettre la correspodace via l'optio Activer la sychroisatio des droits utilisateurs depuis les autorisatios ou groupes de l'auaire. 4 Des groupes existet das Neolae et l'utilisatio de l'auaire LDAP est activée a posteriori : les groupes d'utilisateurs côté Neolae e sot pas remplacés automatiquemet par le coteu des groupes LDAP. De même, si u groupe 'existe que das Neolae, aucu utilisateur LDAP e peut y être ajouté avat que le groupe e soit créé et sychroisé côté LDAP. A propos des groupes Les groupes e sot jamais créés à la volée, i côté Neolae, i côté LDAP. Ils doivet être créés uitairemet à la fois das Neolae et das l'auaire LDAP. Les oms des groupes das l'auaire LDAP doivet correspodre aux oms des groupes das Neolae. Leur masque d'associatio est défii das la derière étape de cofiguratio de l'assistat de déploiemet, par exemple : NEOLANE_(.*). Neolae v6.0 - Guide d'istallatio - Paramétrages complémetaires 119

121 Neolae Accès à ue base de doées extere Présetatio Neolae propose l'optio Federated Data Access afi d'exploiter des iformatios stockées das ue ou plusieurs bases de doées exteres : vous pouvez accéder à des doées exteres das modifier la structure des doées de Neolae. Avertissemet : Le module Federated Data Access (FDA) est optioel. Vérifiez votre cotrat de licece Neolae. Pricipe de foctioemet Neolae Federated Data Access collecte les doées depuis les sources SQL et détecte automatiquemet la structure des tables ciblées. Pour créer le schéma de lecture d'ue base extere, vous devez au préalable la déclarer (voir Créer le schéma des doées [page 122]). Vous pouvez esuite créer so schéma et évetuellemet u ouveau mappig de doées. Voir à ce sujet la sectio Défiir le mappig des doées [page 123]. Ue fois que le schéma de lecture des doées est créé, les doées peuvet être exploitées das les workflows Neolae. Voir à ce sujet le guide Workflows. Pré-requis Versios supportées Les versios supportées sot présetés das la sectio Accès à ue base extere (Federated Data Access) [page 18]. Droits d'accès à la base distate Pour exploiter les doées coteues das ue base extere, l'utilisateur Neolae doit au miimum avoir les droits e 'Ecriture' sur cette base, afi de permettre la créatio des tables de travail. Ces tables sot automatiquemet supprimées par Neolae. E règle géérale, les droits d'accès suivats sot écessaires : CONNECT : coexio à la base distate, READ Data : accès e lecture aux tables coteat les doées du cliet, READ 'MetaData' : accès aux catalogues de doées du serveur afi d'obteir la structure des tables, LOAD : chargemet e masse das des tables de travail (opératio écessaire lorsque l'o travaille sur des collectios et des joitures), CREATE/DROP pour TABLE/INDEX/PROCEDURE/FUNCTION, EXPLAIN (recommadé) : pour le cotrôle des performaces e cas de problème, WRITE Data (selo le scéario d'itégratio). L'admiistrateur de la base de doées doit faire correspodre ces droits avec les droits spécifiques à chaque moteur de base de doées. Paramétrer l'accès à ue base extere Pour permettre la coexio à la base de doées extere, vous devez idiquer les paramètres de coexio, c'est-à-dire la source de doées visée et le om de la table dot les doées doivet être chargées. 120 Neolae 2013

122 Paramétrages complémetaires Avertissemet : L'utilisateur Neolae doit disposer d'u miimum de droits pour exploiter les doées d'ue base extere. Voir à ce sujet la sectio Droits d'accès à la base distate [page 120]. Pour éviter tout dysfoctioemet, les opérateurs qui accédet à des doées distates commues doivet évoluer das des espaces de travail disjoits. Créer ue coexio partagée Pour permettre ue coexio à ue base extere partagée, so paramétrage doit être défii au préalable à partir du oeud Admiistratio>Plate-forme>Comptes exteres : tat que cette coexio est active, la base de doées sera accessible depuis Neolae. Pour cela, cliquez sur le bouto Nouveau et idiquez les paramètres de la base extere. Ue fois les paramètres reseigés, cliquez sur le bouto Tester la coexio pour les valider. Au besoi, vous pouvez désactiver l'accès à cette base sas pour autat e supprimer le paramétrage. Pour cela, dé-sélectioez l'optio Activé. Créer ue coexio poctuelle Vous pouvez défiir directemet ue coexio à base extere à partir des boîtes du workflow. Das ce cas, il s'agira d'ue base extere locale, réservée à ue utilisatio das le cadre du workflow courat : elle e sera pas eregistrée das les comptes exteres. U exemple de mise e oeuvre est proposé das le guide Workflows. Paramétrages complémetaires Au besoi, vous pouvez créer le schéma écessaire à l'exploitatio des doées coteues das ue base extere. De même, Neolae permet de défiir u mappig sur les doées d'ue table extere. Ces paramétrages sot gééraux et e s'appliquet pas exclusivemet au cotexte des workflows. Neolae v6.0 - Guide d'istallatio - Paramétrages complémetaires 121

123 Neolae Pour plus d'iformatios sur la créatio de schémas das Neolae et la défiitio d'u ouveau mappig des doées, cosultez le chapitre "Extesio des schémas" du Guide de cofiguratio. Créer le schéma des doées Pour créer u schéma sur ue base de doées extere, cliquez sur le bouto Nouveau situé au-dessus de la liste des schémas de doées et sélectioez l'optio Accéder à des doées exteres. 122 Neolae 2013

124 Paramétrages complémetaires Saisissez le om du schéma et sa descriptio et sélectioez le compte extere permettat la coexio à la base de doées. Vous avez aisi accès à la liste des tables dispoibles das la base extere. Sélectioez la table coteat les doées à collecter. Cliquez sur Ok pour valider. Neolae détecte automatiquemet la structure de la table sélectioée et géère le schéma logique. Neolae e géère pas les lies. Cliquez sur Eregistrer pour e valider la créatio. Défiir le mappig des doées Neolae permet de défiir u mappig sur les doées d'ue table extere. Neolae v6.0 - Guide d'istallatio - Paramétrages complémetaires 123

125 Neolae Pour cela, ue fois que le schéma de la table extere a été créé, vous devez créer u ouveau mappig de diffusio afi d'utiliser les doées coteues das cette table e tat que cible des actios de diffusios. Pour cela, les étapes sot les suivates : 1 Créez u ouveau mappig de diffusio et sélectioez la dimesio de ciblage, par exemple le schéma que vous veez de créer. 2 Idiquez les champs où sot stockées les iformatios écessaires à la diffusio (om, préom, , adresse postale, etc.). 124 Neolae 2013

126 Paramétrages complémetaires 3 Idiquez les paramètres relatifs au stockage des iformatios, et otammet le suffixe des schémas d'extesio, afi de les idetifier facilemet. Vous pouvez choisir de stocker ou o les exclusios (excludelog), avec les messages (broadlog) ou das ue table disticte. Vous pouvez égalemet gérer ou o le trackig pour ce mappig de diffusio (trackiglog). 4 Sélectioez esuite les extesios qui serot prises e compte. Le type d'extesio déped des paramètres et optios de votre plateforme (cosultez votre cotrat de licece). Cliquez sur le bouto Eregistrer pour lacer la créatio du mappig de diffusio : toutes les tables liées sot créées automatiquemet, selo les paramètres sélectioés. Délivrabilité des s Présetatio La sectio suivate présete les paramétrages écessaires pour cotrôler le débit des istaces Neolae pour l'evoi des messages. Toutes les recommadatios techiques pour assurer le bo evoi et la boe réceptio des messages par ue plate-forme Neolae sot dispoibles das la Note Techique Délivrabilité. Neolae v6.0 - Guide d'istallatio - Paramétrages complémetaires 125

127 Neolae Pricipe de foctioemet Le débit d'ue ou plusieurs istaces Neolae peut être cotrôlé afi de limiter le ombre d' s evoyés e foctio des domaies. Par exemple, il est possible de limiter le débit des adresses e yahoo.com à messages par heure et à messages par heure pour les autres domaies. Le débit des messages doit être cotrôlé pour chacue des adresses IP utilisées par les serveurs de diffusio (mta) pour l'evoi des s. Plusieurs mta repartis sur plusieurs machies et apparteat à différetes istaces Neolae peuvet partager les mêmes adresses IP pour l'evoi d' s : il est doc écessaire qu'u processus coordoe l'utilisatio de ces adresses IP. C'est la foctio du module Neolae stat : il fédère toutes les demades d'ouvertures de coexios et d'evois de messages vers les serveurs de messagerie pour u esemble d'adresses IP. Le serveur de statistiques maitiet aisi le compte des evois et peut autoriser ou refuser les evois das le temps e foctio des quotas défiis. Le serveur de statistiques (stat) est associé à ue base Neolae pour charger sa cofiguratio. Les serveurs de diffusios (mta) sot cofigurés pour cotacter via UDP u serveur de statistiques qui 'appartiet pas écessairemet à leur propre istace. Serveurs de diffusio Le module mta distribue les messages à ses modules fils mtachild. Chaque mtachild prépare les messages, puis demade l'autorisatio au serveur de statistiques avat de les evoyer. Les étapes sot les suivates : 1 Le mta sélectioe les messages éligibles pour l'evoi et les assige à u mtachild dispoible. 2 Le mtachild charge toutes les iformatios écessaires pour costruire le message (coteu, élémets de persoalisatio, attachemets, images, etc.) et trasmet le message au gestioaire d'evoi ( Traffic Shaper). 126 Neolae 2013

128 Paramétrages complémetaires 3 Lorsque le gestioaire d'evoi a reçu l'autorisatio du serveur de statistiques (smtp stat), le message est evoyé au destiataire. Serveur de statistiques Statistiques et limitatios des serveurs de messagerie Le serveur de statistiques maitiet les statistiques suivates pour chaque serveur de messagerie vers lequel des messages sot evoyés : Nombre de coexios ouvertes e istataé, Nombre de messages evoyés das l'heure précédete, Taux de coexios réussies/refusées, Taux de coexios vers des serveurs ijoigables. Parallèlemet, le module charge ue liste de limitatios pour certais serveurs de messagerie : Nombre maximum de coexios simultaées, Nombre maximum de messages par heure, Nombre maximum de messages par coexio. Gestio des adresses IP Le serveur de statistiques peut fédérer plusieurs istaces ou plusieurs machies si elles partaget les mêmes adresses IP publiques. Il 'est doc pas rattaché à ue istace particulière, mais il doit éamois e cotacter ue pour récupérer les limitatios par domaie. Les statistiques d'evoi sot coservées pour chaque MX cible et pour chaque IP source. Par exemple, si le domaie ciblé possède 5 MX et la plateforme peut utiliser 3 adresses IP différetes, le serveur pourra gérer jusqu'à 15 séries d'idicateurs pour ce domaie. L'adresse IP source correspod à l'adresse IP publique, c'est-à-dire à l'adresse telle qu'elle est vue par le serveur de messagerie distat. Cette adresse IP peut différer de celle de la machie hébergeat le mta, si u routeur NAT est préset. Pour cette raiso, le serveur de statistiques utilise u idetifiat correspodat à l'ip publique (publicid). L'associatio etre l'adresse locale et cet idetifiat est déclaré das le fichier de cofiguratio servercof.xml. Cotrôler le débit de diffusio Foctioemet gééral Pour diffuser les messages vers les serveurs de messagerie, le composat Traffic Shaper fait ue demade d'ouverture de coexio auprès du serveur de statistiques. Ue fois la demade acceptée, la coexio est ouverte. Avat l'evoi des messages, le module demade des 'jetos' au serveur. Gééralemet, il s'agit d'u lot miimum de 10 jetos, afi de réduire le ombre de requêtes auprès du serveur. Le serveur coserve e mémoire toutes les statistiques de coexio et d'evoi. E cas de redémarrage, les iformatios sot provisoiremet perdues : chacu des cliets coserve localemet ue copie de ses statistiques d'evoi et les retoure régulièremet au serveur (toutes les 2 miutes). Le serveur peut alors ré-agréger les doées. Neolae v6.0 - Guide d'istallatio - Paramétrages complémetaires 127

129 Neolae Cycle de vie d'u message Cette sectio décrit le traitemet d'u message par le composat Traffic Shaper. Evoi d'u message Lorsqu'u message est evoyé, 3 résultats sot possibles : 1 Success : le message est evoyé avec succès. Le message est mis à jour. 2 Message Failed : le serveur cotacté refuse le message pour le destiataire spécifié. Ce résultat correspod aux codes retour etre 550 et 599, mais certaies exceptios peuvet être défiies. 3 Sessio Failed (pour les versios Neolae 5.11 et suivates) : si le mta reçoit ue répose pour ce message, le message est abadoé (voir Abado d'u message [page 128]). Le message est revoyé sur u autre chemi ou est mis e attete si aucu chemi 'est dispoible immédiatemet (voir Mise e attete d'u message [page 128]). U chemi désige ue coexio etre le mta Neolae et le mta destiatio, le mta Neolae pouvat choisir parmi plusieurs IP de départ et plusieurs adresses IP du domaie destiatio. Abado d'u message Lorsqu'u message est abadoé, il est retouré au mta et 'est plus géré par le mtachild. Le mta décide de l'actio à suivre pour ce message (reprise, abado, mise e quarataie, etc.) e foctio du code répose et des règles. Mise e attete d'u message U message est mis e attete lorsqu'il arrive das la file active mais qu'il 'y a actuellemet aucu chemi dispoible. U chemi est gééralemet marqué o dispoible pour ue durée variable après ue erreur de coexio. La durée d'idispoibilité d'u chemi déped de la fréquece et de l'acieeté des erreurs. Cofiguratio des serveurs Cofiguratio du serveur de statistiques Le serveur de statistiques peut être utilisé par plusieurs istaces : il doit être cofiguré idépedammet des istaces qui vot l'utiliser. Vous devez d'abord défiir la base de doées Neolae qui hébergera la cofiguratio. Cofiguratio de démarrage Par défaut, le module stat est démarré pour chacue des istaces. Lorsque les istaces sot mutualisées sur ue même machie, ou lorsque les istaces partaget les mêmes adresses IP, u seul serveur de statistiques doit être utilisé : les autres doivet être désactivés. Défiitio du port du serveur Par défaut, le serveur de statistiques écoute sur le port Ce port peut être modifié das le fichier servercof.xml. <stat port="1234"/> Cofiguratio des MX La cofiguratio des MX est réalisée das la base de doées depuis la cosole Neolae. Les règles à respecter pour les MX sot défiies das le documet Gestio des MX du dossier Exécutio de campage>admiistratio>gestio des NP@I>Jeux de règles mail de l'arborescece. 128 Neolae 2013

130 Paramétrages complémetaires Avertissemet : Le serveur de statistiques doit être redémarré pour que les modificatios soiet prises e compte. Pour recharger la cofiguratio sas redémarrer le serveur de statistiques, utilisez la commade suivate sur la machie hébergeat le serveur : lserver stat -reload Si ce documet 'existe pas vous pouvez le créer mauellemet. Pour cela : 1 Créez u ouveau jeu de règles mail. 2 Sélectioez le mode Gestio des MX. 3 Saisissez la valeur defaultmxrules das le champ Nom itere. Chaque règle fixe u masque d'adresse du MX. Tout MX dot le om correspod à ce masque est éligible. Le masque peut coteir les caractères géériques "*" et "?". Par exemple, les adresses : a.mx.yahoo.com b.mx.yahoo.com c.mx.yahoo.com sot compatibles avec les masques : *.yahoo.com?.mx.yahoo.com Neolae v6.0 - Guide d'istallatio - Paramétrages complémetaires 129

131 Neolae Exemple de paramétrage : Ces règles sot appliquées das l'ordre : la première règle dot le masque de MX est compatible avec le MX ciblé est appliquée. Les paramètres dispoibles pour chacue des règles sot les suivats : Plage des idetifiats : cette optio permet d'idiquer les plages d'idetifiats (publicid) pour lesquelles la règle s'applique. Vous pouvez idiquer : U ombre : la règle e s'appliquera qu'à ce publicid, Ue plage de ombres (ombre1-ombre2) la règle s'appliquera à tous les publicid compris etre ces deux ombres. Lorsque ce champ est vide, la règle s'applique à tous les idetifiats. Partagé : cette optio idique que la limite du ombre de messages par heure et le ombre de coexios s'appliquet à l'esemble des MX associés à cette règle. Nombre maximum de coexios : ombre maximum de coexios simultaées à u MX depuis ue adresse doée. Nombre maximum de messages : ombre maximum de messages qui peuvet être evoyés sur ue coexio. Au delà, la coexio est fermée puis ue ouvelle est réouverte. Nombre maximum de messages par heure : ombre maximum de messages qui peuvet être evoyés sur ue période d'ue heure pour u MX depuis ue adresse doée. Timeout de coexio : délai maximum pour teter de se coecter à u MX. Avertissemet : Le système d'exploitatio Widows peut émettre u timeout avat cette limite. Cette limite déped de la versio de Widows. Timeout Data : durée maximale d'attete d'ue répose du serveur après l'evoi du coteu du message (sectio DATA du protocole SMTP). Timeout : durée maximale d'attete de répose pour les autres échages avec le serveur SMTP. Cofiguratio des serveurs de diffusios Sychroisatio des horloges Les horloges de l'esemble des serveurs composat la plateforme Neolae (y compris la base de doées), doivet être sychroisées et les systèmes doivet être das le même fuseau horaire. Coordoées du serveur de statistiques L'adresse du serveur de statistiques doit être idiquée au iveau du mta. 130 Neolae 2013

132 Paramétrages complémetaires La propriété statserveraddress de l'élémet mta de la cofiguratio permet de spécifier l'adresse et le uméro de port à utiliser. <mta statserveraddress=" statserver:7777"> [...] </mta> Pour utiliser le serveur de statistiques se trouvat sur la même machie, il faut au miimum reseiger le om de la machie à la valeur localhost: <mta statserveraddress="localhost"> Avertissemet : Si ce champ 'est pas reseigé, le mta e démarrera pas. Liste des adresses IP à utiliser La cofiguratio relative à la gestio du trafic se situe das l'élémet mta/child/smtp du fichier de cofiguratio. Pour chacu des élémets IPAffiity, il est possible de déclarer les adresses IP de la machie qui peuvet être utilisées. Si aucue adresse IP 'est déclarée, le mta utilisera l'adresse IP par défaut de la machie. Exemple: <IPAffiity localdomai="<domai>" ame="default"> <IP address=" " publicid="1" weight="5"/> <IP address=" " helohost="revds1.eolae.com" publicid="2" weight="5"/> <IP address=" " publicid="3" weight="1"/> </IPAffiity> Les paramètres sot les suivats : address : il s'agit de l'adresse IP de la machie hôte du MTA à utiliser. helohost : cet idetifiat représete l'adresse IP telle qu'elle sera vue par le serveur SMTP. publicid : cette iformatio est utile lorsqu'ue adresse IP est partagée par plusieurs mta Neolae derrière u routeur NAT. Le serveur de statistiques utilise cet idetifiat pour mémoriser les statistiques de coexios et d'evois etre ce poit de départ et le serveur cible. weight : permet de défiir la fréquece relative d'utilisatio de l'adresse. Par défaut, toutes les adresses ot u poids égal à 1. Das l'exemple précédet, e coditio ormale, les adresses serot utilisées selo la répartitio suivate : "1": 5 / (5+5+1) = 45% "2": 5 / (5+5+1) = 45% "3": 1 / (5+5+1) = 10% Si, par exemple, la première adresse est iutilisable vers u MX doé, les messages serot evoyés e utilisat la répartitio suivate : "2": 5 / (5+1) = 83% "3": 1 / (5+1) = 17% icludedomais : permet de réserver cette adresse IP aux s apparteat à u domaie particulier. C'est ue liste de masques pouvat coteir u ou plusieurs jokers '*'. Si l'attribut 'est pas reseigé, tous les domaies peuvet utiliser cette adresse IP. Exemple: icludedomais="waadoo.fr,orage.fr,yahoo.*" Neolae v6.0 - Guide d'istallatio - Paramétrages complémetaires 131

133 Neolae excludedomais : exclut ue liste de domaies de cette adresse IP. Ce filtre est applique après le filtre icludedomais. Moitorig des serveurs de diffusio L'état du composat Traffic Shaper peut être visualisé avec u avigateur web via l'url suivate : <URL>/ms/jsp/stat.jsp sur le serveur exécutat le processus stat. Les graphiques représetet ue sythèse de chacu des mtachild. Ces graphiques permettet de visualiser l'activité des serveurs : ils idiquet ce qu'il se passe e sortie. Les iformatios suivates sot affichées das les graphiques : 1 Nombre total de messages evoyés. 2 - Lige bleue : messages prêts à l'evoi arrivat das le Shaper, i.e. derière étape avat l'evoi SMTP (correspod à ce qui etre). 132 Neolae 2013

134 Paramétrages complémetaires - Lige verte : messages evoyés avec succès (correspod à ce qui sort). - Lige rouge : messages abadoés par le Shaper, redus au mta (correspod à ce qui est rejeté sur cette reprise). Ces valeurs sot exprimées e ombre de messages par heure. 3 Représete symboliquemet deux files du Shaper : - Courbe bleue : la file des messages actifs. Ces messages serot evoyés dès que possible. - Courbe kaki : la file 'deferred'. Ces messages e peuvet pas être evoyés das l'immédiat pour cause de limitatio du serveur de statistiques (throttlig) ou parce qu'aucue coexio vers la cible 'est dispoible. L'evoi de ces messages sera teté toutes les 5s, 10s, 20s, 40s,..., 2mi, etc., pedat la durée maximum MaxAgeSec défiie, avat d'être abadoés. 4 Ce graphique présete u détail des messages abadoés (courbe rouge sur le 2e graphe) : il motre la part des messages abadoés sas avoir essayé de les evoyer (e mauve) par rapport aux messages dot l'evoi a échoué (e rouge). Il permet doc de voir la part des messages qui e passet pas das le délai imparti à cause de limitatios par le serveur de statistiques (throttlig) ou à cause de l'idispoibilité de serveurs distats. 5 Coexios SMTP ouvertes ou e cours d'ouverture. 6 Nombre approximatif de mtachild. Optimisatio de l'evoi d' s : recommadatios La ouvelle architecture itere du mta Neolae a u impact sur le paramétrage pour optimiser l'evoi d' s. Voici quelques coseils pour améliorer les evois. Adaptatio du paramétrage das le cadre d'ue migratio depuis ue v4 Cette sectio s'adresse aux cliets migrat depuis ue plateforme Neolae v4. Cepedat, les descriptios des différets paramètres s'appliquet égalemet aux versios postérieures à la v4. Augmeter le ombre de messages par deliverypart Avec u ombre de message par deliverypart plus grad, le serveur de diffusio réduit le ombre d'accès à la base de doées. Valeur coseillée : 0 La valeur peut être modifiée, au choix : au iveau des propriétés d'evoi des modèles de diffusios, Neolae v6.0 - Guide d'istallatio - Paramétrages complémetaires 133

135 Neolae das l'assistat de déploiemet lors du paramétrage du caal . Avertissemet : La modificatio de la valeur par défaut de ce paramètre doit être réservée à des utilisatios très spécifiques, sous la resposabilité d'u utilisateur expert. Augmeter maxmsgperchild Le paramètre maxmsgperchild idique le ombre de messages qui serot traités par le mtachild. Cette optio permet d'éviter de stopper les processus trop fréquemmet (kill) : cela arrive gééralemet à des momets rapprochés, et pedat le redémarrage, aucu message 'est evoyé et o atted que toutes les files d'attete soiet vidées. Ce paramètre doit doc être importat (dizaie de milliers miimum) pour les diffusios volumieuses. Ce paramètre est critique car u mtachild qui atteit cette limite 'acceptera plus de messages mais e s'arrêtera pas tat qu'il 'aura pas termié tous ses evois, ce qui peut predre du temps à cause de la limitatio du serveur de statistiques (throttlig) : quelques messages e attete peuvet bloquer u mtachild très logtemps et réduire cosidérablemet la capacité de diffusio. Valeur coseillée : Augmeter le ombre de coexios simultaées Le ombre maximum de coexios simultaées est idiqué via le paramètre maxsessiosperchild. Pour ue istace migrée depuis ue versio 5.00 ou atérieure, certais paramètres supplémetaires doivet être ajustés. Le paramètre maxsessiosperchild doit être augmeté. Valeur coseillée : Recommadatios géérales Ajuster le paramètre maxwaitigmessages Le paramètre maxwaitigmessages idique le ombre maximum de messages préparés à l'avace par le mtachild. Les messages e sot décomptés de cette liste que lorsqu'ils sot effectivemet evoyés ou abadoés. 134 Neolae 2013

136 Paramétrages complémetaires Ce paramètre est très importat et particulièremet critique si les messages e sot pas triés par domaie. Lorsque le seuil maximum du paramètre maxworkigsetmb (256) est atteit, le serveur de diffusio 'evoie plus de messages. Les performaces dimiuerot très fortemet jusqu'à ce que le mtachild redémarre. Pour palier à ce problème, vous pouvez soit augmeter le plafod du paramètre maxworkigsetmb, soit dimiuer celui du paramètre maxwaitigmessages. Le paramètre maxworkigsetmb se calcule empiriquemet e multipliat le ombre maximum de messages par la taille moyee d'u message, le tout multiplié par 2,5. Par exemple, si u message a ue taille de 50 ko e moyee, et que le paramètre maxwaitigmessages a pour valeur 1000, la mémoire cosommée sera d'eviro 125 Mo. Migratio depuis ue v4 Ue valeur élevée est idispesable mais cette valeur a ue icidece directe sur la cosommatio mémoire. Il faut doc adapter maxworkigsetmb e foctio du ombre de messages préparés et de la taille moyee d'u message. Valeurs coseillées : pour maxwaitigmessages : 2 000, pour maxworkigsetmb : 256. Ajuster le ombre de mtachild Le ombre de child e devrait pas excéder le ombre de processeurs de la machie. Nous vous recommados de e pas dépasser 8 mtachild. L'ordre du millier de sessios semble ue boe valeur. Il faut alors augmeter le ombre de messages par child (maxmsgperchild) pour avoir ue durée de vie suffisate. Migratio depuis ue v4 Vous pouvez réduire le ombre de mtachild, via le paramètre maxspareservers, et augmeter le ombre de sessios par child, via le paramètre maxsessiosperchild. Aisi la réutilisatio des coexios est optimale. Gestio des fuseaux horaires Présetatio Pricipe de foctioemet Neolae v6 permet d'exprimer les dates e teat compte de leur fuseau horaire : les utilisateurs iteratioaux peuvet aisi collaborer à travers le mode sur différets fuseaux horaires. Chacu des pays utilisat la même istace peut gérer l'exécutio des campages, le trackig, l'historisatio, etc., e foctio de l'heure locale. Afi de permettre cette utilisatio de la plateforme Neolae à l'échelle iteratioale, toutes les dates utilisées par le système doivet pouvoir être associées à u fuseau horaire. Aisi, ue date dot le fuseau horaire est cou peut être exportée das 'importe quel autre fuseau horaire, ou idépedammet de tout fuseau horaire. Neolae propose le stockage des dates/heures au format UTC (Uiversal Time Coordiate). Lorsque les doées sot exposées, elles sot coverties das la date/heure locale de l'opérateur. La coversio est réalisée automatiquemet lorsque la base est cofigurée e UTC (voir Cofiguratio [page 136]). Si la base 'est pas cofigurée e UTC, l'iformatio relative au fuseau horaire des dates de la plateforme est stockée das ue optio. Chaque opérateur Neolae est associé à u fuseau horaire : cette iformatio est paramétrée das so profil. Voir à ce sujet le guide Neolae Platform. Lorsque la plateforme Neolae e écessite pas la gestio des fuseaux horaires, il est possible de coserver u mode de stockage au format local, avec u fuseau horaire spécifique associé. Neolae v6.0 - Guide d'istallatio - Paramétrages complémetaires 135

137 Neolae Recommadatios Les fuseaux horaires recouvret plusieurs réalités : le terme peut désiger u décalage costat par rapport à la date UTC, ou les horaires d'ue régio qui peut chager d'heure deux fois das l'aée (heure d'hiver/heure d'été). Par exemple, e postgresql, la commade SET TIME ZONE 'Europe/Paris'; tiedra compte des heures d'été et d'hiver : la date sera exprimée e GMT+1 ou GMT+2 selo la période de l'aée. Par cotre, si l'o utilise commade SET TIME ZONE 0200; le décalage sera toujours GMT+2. Cofiguratio Le mode de stockage des dates et heures est sélectioé lors de la créatio de la base (voir Créatio d'ue ouvelle istace [page 136]). Das le cas d'ue migratio, les heures associées aux dates sot coverties e dates et heures locales (voir Migratio [page 137]). D'u poit de vue techique, les iformatios de type Date+heure peuvet être stockées das la base de doées selo deux modes différets : 1 Format TIMESTAMP WITH TIMEZONE : le moteur de base de doées stocke les dates e UTC. Chaque sessio ouverte aura u fuseau horaire associé et les dates serot coverties e foctio de ce fuseau horaire. Avertissemet : Ce format 'est pas dispoible pour tous les moteurs de bases de doées. Il 'est supporté que sous PostgreSQL, et e versio béta pour Oracle et MySQL. 2 Format local + fuseau horaire local : toutes les dates sot stockées au format local (pas de gestio des décalages horaires) et u fuseau horaire uique leur est associé. Le fuseau horaire est stocké das l'optio WdbcTimeZoe de l'istace Neolae et peut être modifié à partir du meu Admiistratio>Plateforme>Optios de l'arborescece. Créatio d'ue ouvelle istace Afi de permettre à plusieurs utilisateurs iteratioaux de collaborer sur ue même istace, vous devez cofigurer les fuseaux horaires (timezoe) lors de la créatio de l'istace pour gérer les décalages horaires etre les pays. Pour cela, lors de la créatio de l'istace, sélectioez le mode de gestio des dates et heures das la sectio Fuseau horaire de l'étape de cofiguratio de la base de doées. Cochez l'optio Base UTC (champs dates avec fuseau horaire) pour stocker toutes les doées comportat des dates et heures au format UTC (champs SQL et champs XML). 136 Neolae 2013

138 Paramétrages complémetaires Avertissemet : Das la versio actuelle de Neolae, cette optio 'est dispoible que pour le moteur de bases de doées PostgreSQL, et e versio béta pour Oracle et MySQL. Si la base 'est pas UTC, vous pouvez sélectioer le fuseau horaire parmi ceux proposés das la liste déroulate. Vous pouvez égalemet utiliser le fuseau horaire du serveur ou sélectioer l'optio Temps uiversel coordoé (GMT). Lorsque l'optio Base UTC (champs dates avec fuseau horaire) est sélectioée, les champs SQL sot stockés au format TIMESTAMP WITH TIMEZONE. Das le cas cotraire, ils sot stockés au format local et vous devez sélectioer le fuseau horaire à appliquer à la base de doées. Migratio Lors d'ue migratio d'ue versio atérieure de Neolae (sas gestio des fuseaux horaires), vous devez défiir le mode de stockage des dates das la base de doées. Afi de garatir la compatibilité avec les outils exteres accédat à la base de doées Neolae, les champs SQL de type Date+heure restet par défaut stockés au format local. Les champs XML qui cotieet des dates sot désormais stockés e UTC. Lors de so chargemet, si u champ 'est pas e UTC, il y est automatiquemet coverti. Pour cela, Neolae utilisera le fuseau horaire du serveur. Aisi, tous les champs XML serot progressivemet covertis au format UTC. Pour utiliser ue istace existate, ajoutez l'optio WdbcTimeZoe et saisissez le fuseau horaire de l'istace. Avertissemet : Vous devez veiller à paramétrer la boe valeur pour l'optio WdbcTimeZoe : toute modificatio ultérieure pourrait provoquer des icohéreces. Exemple de valeurs possibles : Europe/Paris, Europe/Lodo, America/New_York, etc. Ces valeurs sot issues de la base tz (Olso). Pour plus d'iformatios, cosultez la page suivate : Neolae v6.0 - Guide d'istallatio - Paramétrages complémetaires 137

139 Neolae Paramétrage des composats tierce-partie OpeOffice.org Cofiguratio de l'eviroemet de Neolae sous Liux (optioel) Si vous souhaitez faire foctioer Neolae sur ue versio d'opeoffice.org existate, ue cofiguratio complémetaire est écessaire. Les commades sot les suivates : cd /usr/local/eolae/l6 vi customer.sh Et idiquez les chemis d'accès aux répertoires d'istallatio, par exemple : export OOO_INSTALL_DIR=/opt/opeoffice.org3 export OOO_BASIS_INSTALL_DIR=/opt/opeoffice.org/basis3.3 export OOO_URE_INSTALL_DIR=/opt/opeoffice.org/ure/share Avertissemet : Vous devez relacer le service Neolae afi que les chagemets d'eviroemet soiet pris e compte. Les commades sot les suivates : /etc/iit.d/lserver6 stop /etc/iit.d/lserver6 start Cliet Oracle sous Liux Lorsque vous utilisez Oracle avec Neolae, vous devez cofigurer les couches clietes Oracle sous Liux. Défiitio TNS Vous devez ajouter vos défiitios TNS lors de la phase d'istallatio. Pour cela, les commades sot les suivates : cd /etc mkdir oracle cd oracle vi tsames.ora Paramétrage pour Neolae Pour fialiser l'istallatio du cliet Oracle pour Neolae, vous devez créer u lie symbolique pour le fichier.so utilisé par Neolae. Pour cela, les commades sot les suivates : cd /usr/lib/oracle/ /cliet/lib l -s libcltsh.so.10.1 libcltsh.so Cofiguratio de l'eviroemet de Neolae Pour cofigurer l'eviroemet de Neolae sous Oracle, les commades suivates doivet être exécutées : cd /usr/local/eolae/l6 vi customer.sh IMPORTANT : Si vous effectuez l'istallatio pour la première fois, il se peut que le fichier customer.sh 'existe pas ecore sur le serveur. Créez-le et assurez-vous qu'il possède bie des droits d'exécutio. Si ce 'est pas le cas, etrez la commade suivate : chmod +x /usr/local/eolae/l6/customer.sh Ajoutez les commades suivates, à la fi du fichier : 138 Neolae 2013

140 Paramétrages complémetaires # For Oracle istat cliet export ORACLE_HOME=/usr/lib/oracle/ /cliet export TNS_ADMIN=/etc/oracle export LD_LIBRARY_PATH=$ORACLE_HOME/lib:$LD_LIBRARY_PATH Le coteu de la variable d'eviroemet ORACLE_HOME correspod au dossier d'istallatio d'oracle. Avertissemet : Sous Oracle 11g, vous devez istaller le package libaio 1. La librairie libaio.so.1 est requise par Neolae. SpamAssassi SpamAssassi est u logiciel destié à filtrer les s idésirables. Itégré à Neolae il permet d'attribuer u score aux s créés das la plateforme et d'évaluer le risque que les messages soiet cosidérés comme idésirables par les messageries des destiataires avat qu'ue diffusio e soit lacée. Pour cela, SpamAssassi doit être istallé et cofiguré sur le ou les serveurs d'applicatio de Neolae et requiert u certai ombre de modules additioels e Perl pour foctioer. Le déploiemet et l'itégratio de SpamAssassi décrits das ce chapitre sot basés sur l'istallatio par défaut du logiciel, de même que les règles de filtrage et de scores qui sot celles fouries par SpamAssassi sas modificatio ou optimisatio aucue. L'attributio des scores et la qualificatio des messages reposat exclusivemet sur la cofiguratio des optios de SpamAssassi et sur l'utilisatio des jeux de règles de filtrage, il reviedra à chaque admiistrateur réseau de les adapter aux besois de so etreprise. Avertissemet : La qualificatio des s par SpamAssassi comme idésirables repose itégralemet sur l'utilisatio d'u esemble de règles de filtrage et de scores. La mise à jour de ces règles, au mois ue fois par jour, est doc idispesable pour que votre istallatio de SpamAssassi et so itégratio das Neolae soiet pleiemet opératioelles et garatisset la pertiece des scores attribués à vos diffusios avat leur evoi. Cette mise à jour est de la resposabilité de l'admiistrateur du serveur qui héberge SpamAssassi. L'utilisatio de SpamAssassi das Neolae permet de doer ue idicatio sur le comportemet évetuel des serveurs de messagerie, utilisat eux-mêmes SpamAssassi, à la réceptio des s evoyés par Neolae. Il se peut toutefois que les serveurs de messagerie des fourisseurs d'accès Iteret ou les messageries Web cosidèret malgré tout les messages evoyés par Neolae comme idésirables. La versio de SpamAssassi supportée est la versio et la procédure d'istallatio décrite s'applique aux éditios 32 et 64 bits des serveurs Widows 2003 et Le déploiemet de SpamAssassi et de ses modules e Perl écessite impérativemet que les serveurs d'applicatio Neolae sur lesquels ils sot istallés aiet accès à Iteret via ue coexio HTTP (flux TCP/80). Istallatio sur ue machie Widows Pour istaller et cofigurer SpamAssassi sous Widows afi d'e permettre l'itégratio avec Neolae, les étapes sot les suivates : 1 Istaller SpamAssassi 2 Itégrer SpamAssassi das Neolae Istallatio de SpamAssassi 1 Coectez-vous au portail du support de Neolae à l'aide de vos idetifiats. 2 Accédez au Cetre de Téléchargemet puis parcourrez la page jusqu'à atteidre la sectio Utils. 3 Téléchargez le fichier Neolae Spam Assassi (Widows Istallatio) (1.0). 4 Copiez ce fichier sur le serveur Neolae puis décompressez-le. Neolae v6.0 - Guide d'istallatio - Paramétrages complémetaires 139

141 Neolae Vous pouvez décompresser le fichier à l'emplacemet de votre choix. Cepedat, assurez-vous que le chemi d'accès à ce derier comporte uiquemet des caractères de l'expressio régulière suivate : -_A-Za-z\xA0-\xFF0-9\.\%\@\=\+\,\/\\\:.. 5 Accédez au dossier das lequel vous avez décompressé le fichier puis double-cliquez sur le fichier ru_me.bat afi de lacer le script d'istallatio. Deux cas de figure peuvet se préseter : Si u Shell Widows apparaît et reste affiché durat plusieurs secodes, attedez que l'istallatio et la mise à jour soiet termiées puis appuyez sur Etrée. Si le Shell Widows 'apparaît pas ou s'il apparaît puis disparaît istataémet, procédez comme suit : 1 Double-cliquez sur le fichier portableshell.bat afi d'afficher u Shell Widows. 2 Assurez-vous que le chemi du Shell correspod au dossier das lequel le fichier eolae_spamassassi.zip a été décompressé. Si ce 'est pas le cas, accédez-y grâce à la commade cd. 3 Etrez ru_me.bat puis appuyez sur Etrée afi de lacer le processus d'istallatio et de mise à jour. L'opératio revoie l'ue des valeurs suivates afi d'idiquer le résultat de la mise à jour : 0 : ue mise à jour a été effectuée. 1 : aucue ouvelle mise à jour 'était dispoible. 2 : aucue ouvelle mise à jour 'était dispoible. 3 : la mise à jour a échoué lors de la vérificatio préalable. 4 ou plus : ue erreur s'est produite. 6 Vérifiez que l'istallatio de SpamAssassi s'est bie déroulée e effectuat le test GTUBE (Geeric Test for Usolicited Bulk ) selo la procédure décrite ci-après : 1 Créez u fichier texte et eregistrez-le sous C:\TestSpamMail.txt. 2 Isérez le coteu suivat das ce fichier : Subject: Test Spam Mail (GTUBE) Message-ID: < @example.et> Date: Wed, 23 Jul :30: From: Seder <seder@example.et> To: Recipiet <recipiet@example.et> Precedece: juk MIME-Versio: 1.0 Cotet-Type: text/plai; charset=us-ascii Cotet-Trasfer-Ecodig: 7bit XJS*C4JDBQADN1.NSBN3*2IDNEN*GTUBE-STANDARD-ANTI-UBE-TEST- *C.34X 3 Double-cliquez sur le fichier portableshell.bat afi d'afficher u Shell Widows puis lacez la commade suivate (où "<root>" désige le dossier créé lors de la décompressio du fichier eolae_spamassassi.zip) : <root>\perl\site\bi\spamassassi C:\TestSpamMail.txt Le coteu de cet de test décleche l'attributio par SpamAssassi d'u score de 1000 poits au message. Cela sigifie qu'il a bie été détecté comme idésirable et que l'istallatio a été correctemet réalisée et est désormais foctioelle. Itégratio de SpamAssassi das Neolae 1 Editez le fichier <Chemi vers le répertoire d'istallatio Neolae>/l6/cof/serverCof.xml. 2 Modifiez la valeur de l'attribut commad de l'élémet spamcheck du oeud Web. Pour cela, exécutez la commade suivate : <spamcheck commad="<chemi absolu vers le fichier décompressé>/eolae_spamassassi/call_perl_with_args.bat <chemi absolu vers lserver>/spamcheck/ 140 Neolae 2013

142 Paramétrages complémetaires Avertissemet : Tous les chemis doivet être absolus. Arrêtez puis redémarrez le service Neolae. 3 Vérifiez l'itégratio de SpamAssassi das Neolae e effectuat le test GTUBE (Geeric Test for Usolicited Bulk ) selo la procédure décrite ci-après : Double-cliquez sur le fichier portableshell.bat afi d'afficher u Shell Widows puis lacez la commade suivate : > perl [Chemi vers le répertoire d'istallatio Neolae]\bi\spamcheck.pl C:\TestSpamMail.txt Le coteu de cet de test décleche l'attributio par SpamAssassi d'u score de 1000 poits au message. Cela sigifie qu'il a bie été détecté comme idésirable et que l'itégratio das Neolae a été correctemet réalisée. Elle est désormais foctioelle. 4 Mettez à jour les règles de filtrage et de scores de SpamAssassi Pour ue première mise à jour des règles de filtrage et de scores, lacez la commade suivate das ue ivite de commades MS-DOS : > sa-update --o-gpg Pour effectuer la mise à jour automatisée des règles de filtrage et de scores, utilisez cette même commade das ue tâche système plaifiée. Istallatio sur ue machie Liux Etapes d'istallatio sous Debia Au besoi, istallez Perl et SpamAssassi à l'aide de la commade suivate : apt-get istall spamassassi libxml-writer-perl Das le fichier servercof.xml (dispoible sous /usr/local/eolae/l6/cof/), modifiez la lige <spamcheck comme suit : <spamcheck commad="perl /usr/local/eolae/l6/bi/spamcheck.pl"/> Etapes d'istallatio sous RHEL/Suse Au besoi, istallez Perl et récupérez les packages à l'aide de CPAN : cpa Digest::SHA1 cpa HTML::Parser cpa Net::DNS cpa Mail::SPF cpa XML::LibXML cpa XML::Writer cpa Mail::SpamAssassi Mise à jour des règles de filtrage Les règles de filtrage peuvet être mises à jour automatiquemet à l'aide de l'outil sa-update. Reportez-vous au site officiel de SpamAssasi pour plus d'iformatios. Sous Debia, la mise à jour est automatique et quotidiee. Si cela e devait pas être le cas (par exemple das le cas d'ue istallatio mauelle de Debia), créez u script afi d'automatiser la mise à jour des jeux de règles.!/bi/sh test -x /usr/bi/sa-update exit 0 /usr/sbi/sa-update && /etc/iit.d/spamassassi update Isérez ce script das crotab à l'aide de la commade suivate : crotab-e Neolae v6.0 - Guide d'istallatio - Paramétrages complémetaires 141

143 Neolae Optimisatio des performaces Pour améliorer les performaces sous Liux, éditez le fichier /etc/spamassassi/local.cf et ajoutez la lige suivate à la fi du fichier : ds_available o Paramétrage du coecteur Neolae-Adobe Geesis Présetatio Adobe Geesis est u coecteur qui permet d'itégrer Neolae à Adobe olie Marketig Suite. Adobe Geesis trasmet des doées à Neolae sous forme de segmets portat sur le comportemet des iterautes, suite à ue campage . Iversemet, il evoie les idicateurs et les attributs des campages lacées par Neolae vers Adobe olie Marketig Suite. Reportez-vous au chapitre Coecteur Neolae-Adobe Geesis pour plus d'iformatios. Paramétrage d'adobe Geesis Les étapes suivates décrivet le paramétrage du coecteur Adobe Geesis via u assistat. 1 Coectez-vous au site web d'adobe avec les idetifiats fouris par Adobe. 2 Cliquez sur le module Geesis pour lacer l'assistat de paramétrage. 142 Neolae 2013

144 Paramétrages complémetaires 3 Sélectioez Neolae das la liste des parteaires et faites u glisser/déposer pour le coecter à Adobe olie Marketig Suite. La première page de l'assistat de paramétrage s'affiche. 4 Spécifiez u libellé et ue adresse pour recevoir les otificatios de la part du coecteur. Neolae v6.0 - Guide d'istallatio - Paramétrages complémetaires 143

145 Neolae 5 Copiez le N de compte tel qu'il apparaît das le compte extere Neolae (voir à ce sujet le chapitre Coecteur Neolae-Adobe Geesis). 6 Idiquez les idetifiats qui vot permettre de mesurer l'impact de la campage , soit le om itere de la campage (cid) et l'idetifiat de la table NmsBroadlog (bid). 144 Neolae 2013

146 Paramétrages complémetaires 7 Si besoi est, défiissez des segmets persoalisés. 8 Sélectioez les métriques que Neolae doit trasmettre à Adobe olie Marketig Suite via Adobe Geesis. Neolae v6.0 - Guide d'istallatio - Paramétrages complémetaires 145

147 Neolae 9 Choisissez la méthode pour récupérer les doées, e l'occurrece les idetifiats cid et bid défiis à l'étape Vérifiez le paramétrage das la page résumat les étapes précédetes. 146 Neolae 2013

148 Paramétrages complémetaires 11 Cliquez sur Termier pour fermer l'assistat. Le paramétrage d'adobe Geesis est termié. Paramétrage de Neolae Lorsque la cofiguratio d'adobe Geesis est termiée, redez-vous das Neolae pour achever le paramétrage du coecteur Neolae-Adobe Geesis e effectuat les opératios suivates : 1 Lacez la sychroisatio etre Adobe Geesis et Neolae depuis le compte extere. 2 Vérifiez que les segmets Abado de paier, Achat de produits et Visualisatio de produits ot été créés au iveau du compte extere. 3 Modifiez la formule de trackig depuis le compte extere. 4 Vérifiez que les workflows techiques ot démarrés ou démarrez-les à la mai le cas échéat. Reportez-vous au chapitre Coecteur Neolae-Adobe Geesis pour plus d'iformatios. Neolae v6.0 - Guide d'istallatio - Paramétrages complémetaires 147

149 Neolae Paramétrage des coecteurs CRM Présetatio Neolae propose différets coecteurs CRM pour relier votre plateforme Neolae à vos systèmes tiers. Ces coecteurs CRM permettet par exemple de sychroiser les cotacts, les comptes, les commades, les achats, etc. Ils simplifiet l'itégratio de votre applicatio avec vos différetes applicatios tierces et métiers. La matrice de compatibilité est présetée das la sectio Coecteurs CRM [page 17]. Ces coecteurs permettet d'itégrer rapidemet et simplemet les doées : Neolae propose u assistat dédié pour collecter et sélectioer parmi les tables dispoibles das le CRM. Ils permettet ue sychroisatio bidirectioelle des iformatios afi que les doées cliet soiet à jour simultaémet sur les différets systèmes. Avertissemet : Neolae CRM Coectors est ue optio de Neolae. Vérifiez votre cotrat de licece. Etapes de paramétrage Pour utiliser les coecteurs CRM das Neolae, les étapes sot les suivates : 1 Créatio du compte extere à partir du oeud Admiistratio>Plate-forme>Comptes exteres de l'arborescece Neolae, 2 Collecte des tables CRM à travers l'assistat de cofiguratio, 3 Sychroisatio des éumératios etre Neolae et le CRM, 4 Créatio du worlfow de sychroisatio des objets. La sychroisatio etre Neolae et le CRM est réalisée à travers ue activité de workflow dédiée : coecteur CRM. Cette activité permet de : Importer depuis le CRM, Exporter vers le CRM, Importer les objets supprimés das le CRM, Supprimer des objets das le CRM. Exemple pour Salesforce.com Les étapes de paramétrage pour cofigurer le coecteur Salesforce.com avec Neolae sot les suivates : 1 Créez u ouveau compte extere à partir du oeud Admiistratio>Plate-forme>Comptes exteres de l'arborescece Neolae. 148 Neolae 2013

150 Paramétrages complémetaires 2 Lacez l'assistat de cofiguratio pour géérer les tables CRM dispoibles. L'assistat de cofiguratio permet de collecter les tables et créer le schéma correspodat. Cliquez sur Démarrer pour lacer l'exécutio. Pour valider la cofiguratio, vous devez procéder à ue décoexio/recoexio à la cosole Neolae. Neolae v6.0 - Guide d'istallatio - Paramétrages complémetaires 149

151 Neolae 3 Vérifiez le schéma gééré das Neolae, sous le oeud Admiistratio > Paramétrage > Schéma de doées. 4 Ue fois le schéma créé, vous pouvez sychroiser automatiquemet les éumératios depuis le CRM vers Neolae. Pour cela, cliquez sur le lie Sychroiser des éumératios... et choisissez l'éumératio de Neolae correspodat à l'éumératio du CRM. 150 Neolae 2013

152 Paramétrages complémetaires Vous pouvez remplacer totalemet les valeurs d'ue éumératio Neolae par celles du CRM : pour cela, sélectioez Oui das la coloe Remplacer. Cliquez sur Suivat puis Démarrer pour appliquer la sychroisatio. 5 Vérifiez les valeurs importées sous le meu Admiistratio > Plate-forme > Eumératios. Neolae v6.0 - Guide d'istallatio - Paramétrages complémetaires 151

153 Neolae 6 Pour importer les doées Salesforce, ou exporter les doées Neolae vers Salesforce, vous devez créer u workflow et utiliser l'activité Coecteur CRM. Exemple pour Oracle ODemad Les étapes de paramétrage pour cofigurer le coecteur Oracle ODemad avec Neolae sot les suivates : 1 Créez le compte extere pour permettre à Neolae de se coecter à Oracle. 152 Neolae 2013

154 Paramétrages complémetaires 2 Ouvrez l'assistat de cofiguratio : Neolae découvre automatiquemet les tables du modèle de doées Oracle. 3 Le schéma de doées correspodat est alors accessible das Neolae. Neolae v6.0 - Guide d'istallatio - Paramétrages complémetaires 153

155 Neolae 4 Lacez la sychroisatio des éumératio etre Neolae et Oracle ODemad. 5 Pour importer les doées Oracle ODemad das Neolae, créez u workflow du type suivat : Ce workflow importe les cotacts depuis Oracle ODemad, les sychroise avec les doées Neolae existates, déduplique les cotacts et met à jour la base de doées Neolae. 154 Neolae 2013

156 Paramétrages complémetaires L'activité CRM coector doit être cofigurée comme das l'exemple suivat : 6 Pour exporter les doées Neolae vers Oracle ODemad, créez u workflow comme ci-dessous : Ce workflow collecte les doées utiles via des requêtes, puis exporte ces doées das la table des cotacts d'oracle ODemad. Cofiguratio et déploiemet d'u serveur de mid-sourcig Itroductio Le chapitre suivat présete les étapes d'istallatio et de cofiguratio d'u serveur de mid-sourcig aisi que les étapes de déploiemet d'ue istace permettat à des tiers de soumettre des messages e mode mid-sourcig. L'architecture "mid-sourcig" est présetée das la sectio Déploiemet Mid-sourcig [page 37]. Neolae v6.0 - Guide d'istallatio - Paramétrages complémetaires 155

157 Neolae L'istallatio d'u serveur de mid-sourcig est idetique à celle d'ue istace classique (se référer à la cofiguratio stadard). Il s'agit d'ue istace autoome avec sa propre base de doées, sur laquelle il est possible de lacer des diffusios. Elle cotiet simplemet ue cofiguratio supplémetaire permettat à des istaces distates de lui déléguer des evois à effectuer e mode mid-sourcig. Etapes d'istallatio et de cofiguratio d'ue istace Prérequis JDK 1.6 sur le serveur applicatif. Accès à u serveur de base de doées sur le serveur applicatif. Cofiguratio du firewall pour l'ouverture du port HTTP (80) ou HTTPS (443) vers le serveur de mid-sourcig. Istaller et cofigurer Neolae pour u déploiemet e mid-sourcig La procédure ci-dessous présete ue cofiguratio utilisat u seul serveur de mid-sourcig. Il est égalemet possible de faire appel e parallèle à plusieurs serveurs de mid-sourcig, aisi que de cofigurer l'evoi de certais messages e mode ormal (pour les otificatios de workflow, par exemple). Procédure d'istallatio du serveur applicatif La procédure d'istallatio repred les étapes d'ue istallatio pour ue istace moo machie. Voir Istaller et cofigurer Neolae sur ue istace moo-machie [page 23]. Toutefois, vous devez appliquer les spécificités suivates : 1 A l'étape 5, vous devez désactiver les modules mta (diffusio) et imail (mails rebods). Au cotraire, le module wfserver (workflow) doit rester activé. <?xml versio='1.0'?> <servercof> <shared> <!-- add lag="eg" to datastore to force Eglish for the istace --> <datastore hosts="cosole.eolae.et*"> <mappig logical="*" physical="default"/> </datastore> </shared> <mta autostart="false"/> <wfserver autostart="true"/> <imail autostart="false"/> <sms autostart="false"/> <listprotect autostart="false"/> </servercof> Voir à ce propos la sectio Activatio des processus [page 85]. 2 Les étapes 6,9 et 10 e sot pas écessaires. 3 Lors des étapes 12 et 13, vous devez idiquer le port 8080 das l'url de coexio (car la cosole commuique directemet avec Tomcat sas passer par le serveur Web). L'URL deviet 156 Neolae 2013

158 Paramétrages complémetaires A l'étape 13, sélectioez le package Emissio vers Mid-Sourcig, e complémet des packages à istaller. Avertissemet : Le routage par défaut des diffusios techiques est automatiquemet remplacé par le routage via Mid-sourcig. Cofiguratio du mid-sourcig Depuis la cosole cliete, localisez le compte de mid-sourcig Routage e mid-sourcig, das le dossier /Admiistratio/Comptes exteres/. Reseigez les paramètres URL du serveur, compte, mot de passe et URL de page miroir avec les iformatios fouries par le prestataire hébergeat le serveur de mid-sourcig. Puis, testez la coexio. L'optio Emissio vers Mid-sourcig crée deux workflows Mid-sourcig. Il s'agit d'u traitemet, plaifié par défaut toutes les heures et 20 miutes, qui effectue la collecte des iformatios d'evoi sur le serveur de mid-sourcig. Déploiemet d'u serveur de mid-sourcig 1 Istallatio du serveur applicatif : Avertissemet : Lorsque vous istallez u serveur de mid-sourcig et que vous souhaitez istaller des modules Neolae supplémetaires, il est décoseillé de choisir le module Campaig. Préférez le module Delivery. Neolae v6.0 - Guide d'istallatio - Paramétrages complémetaires 157

159 Neolae Suivez la même procédure que pour u déploiemet stadard e sélectioat uiquemet l'optio Plate-forme de Mid-sourcig. 2 Cofiguratio de la réceptio du mid-sourcig : Fixez le mot de passe du compte de soumissio : das le dossier /Mid-sourcig/Gestio des accès/opérateurs/, l'opérateur mid est utilisé par l'istace distate pour les soumissios e mode mid-sourcig. Vous devez fixer u mot de passe à cet opérateur et le commuiquer à l'admiistrateur de l'istace de soumissio. L'optio Plate-forme de Mid-sourcig crée les dossiers par défaut das lesquels serot stockées les diffusios soumises et l'opérateur par défaut pour effectuer les soumissios. Multiplexage du serveur de mid-sourcig Il est possible de mutualiser ue istace de mid-sourcig pour plusieurs istaces de soumissio. Chaque istace pouvat effectuer des soumissios sera associée à u opérateur das la base de mid-sourcig. Pour créer u secod compte sur le serveur de mid-sourcig : 1 Créez u répertoire libre sous le oeud Mid-sourcig/Diffusios qui sera associé au compte mid-sourcig par défaut (par exemple : prod). 2 Créez u répertoire libre sous le oeud Mid-sourcig/Diffusios qui aura le même om que le compte (par exemple : recette). 158 Neolae 2013

160 Paramétrages complémetaires 3 Créez u ouveau compte depuis le oeud Mid-sourcig/Gestio des accès/ Opérateurs. 4 Das l'oglet Droits d'accès, attribuez à cet opérateur les droits du groupe Soumissios mid-sourcig. Ce droit d'accès est accessible sous Mid-sourcig/ Gestio des accès/ Groupes d'opérateurs. 5 Cliquez sur l'oglet Restrictios pour restreidre l'accès de cet opérateur au répertoire de diffusios mid-sourcig. Neolae v6.0 - Guide d'istallatio - Paramétrages complémetaires 159

161 Neolae 6 Redémarrez le module techique web par la commade suivate : lserver restart web Avertissemet : Vous devez modifier le paramétrage du serveur de mid-sourcig à partir du fichier servercof.xml. Das otre exemple où l'istace s'appelle "recette", la lige suivate doit être ajoutée das la sectio "Gestio des affiités avec les adresses IP", sous la lige existate : <IPAffiity IPMask="" localdomai="" ame="recette.default"/> Vous devez arrêter et redémarrer le serveur pour que cette modificatio soit prise e compte. Cofiguratio du trackig sur u serveur de mid-sourcig Paramétrage du serveur de mid-sourcig 1 Positioez-vous au iveau des opérateurs et sélectioez l'opérateur mid. 2 Das l'oglet Serveurs frotaux complétez les paramètres de coexio au serveur de trackig. Pour créer ue istace de trackig, idiquez l'url du serveur de trackig, le mot de passe du compte iteral du serveur de trackig, aisi que le om de l'istace, so mot de passe et les masques DNS qui lui sot associés. 3 Lorsque vous avez complété les paramètres de coexio, cliquez sur Valider le paramétrage. 4 Si besoi est, défiissez l'emplacemet où serot stockées les images coteues das les diffusios. Pour cela, choisissez u des modes de publicatio dispoible das la liste déroulate. Si vous choisissez l'optio Serveur(s) de trackig, les images serot forcémet copiées sur le serveur de mid-sourcig. Paramétrage de la plateforme cliete 1 Positioez-vous sur le compte extere de routage e mid-sourcig. 160 Neolae 2013

162 Paramétrages complémetaires 2 Das l'oglet Mid-Sourcig, idiquez les paramètres de coexio au serveur de mid-sourcig. 3 Validez votre paramétrage e cliquat sur Tester la coexio. 4 Déclarez l'istace de trackig référecée sur le serveur de mid-sourcig : Cliquez sur le lie Utiliser cette plate-forme comme proxy pour accéder aux serveurs de trackig, Idiquez le om de l'istace de trackig, puis validez la coexio avec le serveur de trackig. Neolae v6.0 - Guide d'istallatio - Paramétrages complémetaires 161

163 Neolae Si l'evoi de messages doit être géré par plusieurs serveurs de mid-sourcig, sélectioez l'optio Routage avec alterace des comptes mid-sourcig utilisés et idiquez les différets serveurs. 162 Neolae 2013

164 CHAPITRE 8 Aexes Table des matières Créatio d'ue istace Neolae e lige de commades Commades de créatio d'ue istace Déclaratio d'ue base de doées Créatio de ouvelles istaces Problèmes courats Créatio d'ue istace Neolae e lige de commades Commades de créatio d'ue istace La créatio d'ue istace peut être exécutée e lige de commade avec la sytaxe : lserver cofig -addistace:istace/masques DNS[/lague] (avec fra et eg pour les valeurs possibles du paramètre [lague]) Exemple : La commade lserver cofig -addistace:istace1/demo*/fra permet de créer ue istace de om istace1 de lague fraçaise avec le masque DNS demo*. Déclaratio d'ue base de doées Vous pouvez associer ue base de doées existate à ue istace. Pour cela, la lige de commade est la suivate : lserver cofig -setdblogi:[sgbd:]compte[:base][/motdepasse]@serveur Les valeurs possibles pour le paramètre [sgdb] sot les suivates : postgresql : pour le moteur PostgreSQL, oracle : pour le moteur Oracle, mssql : pour le moteur SQL Server, DB2 : pour le moteur DB2, mysql : pour le moteur MySQL. Neolae v6.0 - Guide d'istallatio - Aexes 163