JAHIA CMS ET PORTAL SERVER

Transcription

1 JAHIA CMS ET PORTAL SERVER Guide de l administrateur Installation et configuration de Jahia CMS and Portal Server 5.0 V1.3 Française Jahia Ltd 9 route des jeunes 1227 Carouge Switzerland

2 I p2/102 CONDITIONS D UTILISATION Copyright 2011 Jahia Ltd. ( Tous droits réservés. CETTE DOCUMENTATION EST UN ELEMENT DU LOGICIEL JAHIA. EN INSTALLANT JAHIA, VOUS ACCEPTEZ LES CONDITIONS D UTILISATION DE LA LICENCE DU LOGICIEL JAHIA (JAHIA COLLABORALITVE SOURCE LICENSE ou JCSL) POUR CONSULTER LA LICENCE : SI VOUS N ACCEPTEZ PAS LES CONDITIONS D UTILISATION, N INSTALLEZ PAS LE LOGIGIEL JAHIA SUR VOTRE ORDINATEUR.

3 I p3/102 VUE D ENSEMBLE DU DOCUMENT INTRODUCTION... 6 CHAPITRE 1 : PRE-REQUIS... 7 CHAPITRE 2 : INSTALLATION DE JAHIA CHAPITRE 3 : GESTION DE SITES SOUS JAHIA CHAPITRE 4 : INSTALLATION ET CONFIGURATION AVANCEE DE JAHIA CHAPITRE 5 : MAINTENANCE DE JAHIA CHAPITRE 6 : OPTIMISATION DE JAHIA CHAPITRE 7 : QUESTIONS FREQUEMMENT POSEES LISTE DES ILLUSTRATIONS

4 I p4/102 VUE DÉTAILLÉE INTRODUCTION... 6 CONVENTIONS UTILISÉES DANS CE DOCUMENT... 6 IL Y A DES ERREURS... 6 CHAPITRE 1 : PRE-REQUIS PRÉ- REQUIS DU SYSTÈME SYSTÈMES D EXPLOITATION TESTÉS SERVEURS D APPLICATION JAVA TESTÉS BASES DE DONNÉES TESTÉES: PRÉPARER VOTRE SYSTÈME SOUS WINDOWS SOUS LINUX SOUS SOLARIS SERVEUR D APPLICATION EMBARQUÉE PAR DEFAUT BASE DE DONNÉES EMBARQUÉE...9 CHAPITRE 2 : INSTALLATION DE JAHIA SYSTÈME D EXPLOITATION INSTALLATION SOUS WINDOWS INSTALLATION SOUS LINUX PREMIER LANCEMENT ASSISTANT D INSTALLATION JAHIA LICENCE ET CONDITIONS D UTILISATION DÉFINITION DU SUPER ADMINISTRATEUR CONFIGURATION DU SERVEUR PROPRIÉTÉS DU SERVEUR DE MAIL PROPRIÉTÉS DU SITE VIRTUEL PAR DÉFAUT TEMPLATES (MODÈLES DE PAGES) SOMMAIRE...19 CHAPITRE 3 : GESTION DE SITES SOUS JAHIA ADMINISTRATION : OPTIONS DU SITE GESTION CENTRALISÉE DES PAGES GESTION DES UTILISATEURS GESTION DES GROUPES D UTILISATEURS GESTION DES MODÈLES DE PAGES (TEMPLATES) GESTION DU MOTEUR DE RECHERCHE GESTION DES DÉFINITIONS DES PAGES D ACCUEIL GESTION DES LANGUES MISE EN PRODUCTION SUR SERVEUR DISTANT CRÉER CLIP-PORLET DROITS SUR LE SITE PURGE DES FICHIERS NON UTILISES (À PARTIR DE LA VERSION ) GESTION DES PROPRIÉTÉS DU SERVEUR (ROOT) GESTION DES SITES VIRTUELS GESTION DES CATÉGORIES GESTION DES PROPRIÉTÉS DU SERVEUR GESTION DES PORTLETS JOURNAL D ADMINISTRATION (LOGS) MODIFIER LES PROPRIÉTÉS DU SUPER ADMINISTRATEUR VÉRIFICATIONS ET VALIDATION DE L HTML...61

5 I p5/ STATUT DU SERVEUR ET SYSTEME DE CACHE JAHIA A PROPOS DE JAHIA DROITS SUR LE SERVEUR STATISTIQUES...68 CHAPITRE 4 : INSTALLATION ET CONFIGURATION AVANCEE DE JAHIA ORGANISATION DES FICHIERS JAHIA CONFIGURATION AVANCÉE DES BASES DE DONNÉES MYSQL POSTGRESQL ORACLE MICROSOFT SQL SERVER (JTDS JDBC DRIVERS) CONFIGURATIONS AVANCÉES POUR L AUTHENTIFICATION (SERVEUR LDAP) FICHIERS DE CONFIGURATION LDAP MODIFIER LE NIVEAU DES TRACES (LOGS) CONFIGURATIONS AVANCÉES DU SERVEUR D APPLICATION JAVA APACHE TOMCAT OPTIMISATION CHANGER LES PORTS HTTP SUR LEQUEL JAHIA EST À L ÉCOUTE MISE À JOUR DU SERVEUR D APPLICATION TOMCAT LE FICHIER DE CONFIGURATION JAHIA.PROPERTIES...81 CHAPITRE 5 : MAINTENANCE DE JAHIA COPIES DE SECOURS / MIGRATION DE L ENVIRONNEMENT DE DÉVELOPPEMENT À L ENVIRONNEMENT DE PRODUCTION BASE DE DONNÉES FICHIERS DE DONNÉES JAHIA MODELES DE PAGES JAHIA (TEMPLATES) WEB APPLICATIONS / PORTLETS FICHIERS DE CONFIGURATION SUPERVISION CHAPITRE 6 : OPTIMISATION DE JAHIA AMÉLIORER LES PERFORMANCES DE JAHIA JAVA OPTIMISATION DE LA BASE DE DONNÉES...91 CHAPITRE 7 : QUESTIONS FRÉQUEMMENT POSEES QUE FAIRE EN CAS DE PROBLÈME AVEC MON INSTALLATION JAHIA? ) ACTIVER LE SYSTÈME DE LOGS JAHIA ) L ASSISTANCE TECHNIQUE GRATUITE ET COMMERCIALE DE JAHIA...95 QUELS SONT LES NAVIGATEURS WEB COMPATIBLES AVEC JAHIA? QUELLE EST LA DURÉE D UNE SESSION, ET COMMENT LA CHANGER? COMMENT INSTALLER DEUX INSTANCES DE JAHIA SUR LA MEME MACHINE? COMMENT PUIS-JE ACTIVER LA NOTIFICATION DU PROCESSUS DE WORKFLOW? COMMENT PROCEDER POUR MODIFIER LES PAGES D INTERFACE D ADMINISTRATION JSP DE JAHIA (FENETRES POP-UP)? COMMENT TRADUIRE JAHIA DANS D AUTRES LANGUES? COMMENT CRÉER UN SET DE NOUVEAUX TEMPLATES ET LE DÉPLOYER DANS JAHIA? LISTE DES ILLUSTRATIONS

6 I p6/102 INTRODUCTION Bienvenue dans le Guide d'administration Jahia. Jahia est un système de gestion de contenu et un outil de portail intégré basé sur une plateforme Java. Ce guide est destiné à vous permettre d'installer, de configurer et de maintenir vos serveurs Jahia. CONVENTIONS UTILISÉES DANS CE DOCUMENT Les conventions typographiques suivantes sont utilisées dans ce document : L'italique est utilisé pour : Chemins d'accès système, noms de fichiers, et noms de programmes. Les adresses internet, telles que les noms de domaines et les urls. De nouveaux termes lorsqu'on les défini. Le gras est utilisé pour : Les noms des éléments des interfaces graphiques (noms de fenêtres, boutons, éléments dans les menus, etc.) La chasse fixe est utilisée pour : Les lignes de commande et les options qui doivent être tapées à l identique. Les noms et mots clés des programmes Java, y compris les noms de méthodes, les noms de variables et les noms des classes. Les éléments XML, HTML, XHTML et leurs balises, noms d attributs. Indique une astuce ou un conseil. Indique une note d'information de portée générale. Indique une mise en garde. IL Y A DES ERREURS Nous avons tenté de rédiger le document le plus précis et complet possible, cependant il suffit qu'une fonctionnalité ait changé dans la version finale du logiciel pour que sa description ne corresponde plus exactement à ce qu'elle devrait être. Il est également possible que nous ayons commis des erreurs. Pour consulter les errata et télécharger la dernière version de ce document reportez vous au site suivant :

7 I p7/102 CHAPITRE 1 : PRE-REQUIS Jahia peut être installé sur de multiples systèmes d exploitation, serveurs d applications Java et bases de données. Ce chapitre présente le pré requis minimum. 1. PRÉ- REQUIS DU SYSTÈME Pour utiliser Jahia, il est nécessaire d installer préalablement un Software Development Kit Java 2 (JDK ou Java2SE SDK) version 1.4 ou ultérieure sur votre système. Jahia nécessitant de compiler des pages jsp, le Java Runtime Environment (ou JRE) ne fonctionnera pas seul, vous devez installer le JDK complet (ou Java2SE SDK). Vous trouverez les deux versions pour Linux et Windows sur le site web de SUN : D autres poussés. JDK sont disponibles chez différents éditeurs, mais ceux ci n ont pas fait l objet de tests 1.1 SYSTÈMES D EXPLOITATION TESTÉS Microsoft Windows NT/2000/XP Linux successfully tested with Redhat Enterprise 3 and 4,Debian Solaris 9.x, Solaris 10 MacOSX Les autres systèmes supportant le JDK devraient théoriquement fonctionner, mais n ont pas été testés. 1.2 SERVEURS D APPLICATION JAVA TESTÉS Jahia est principalement développé et testé avec les serveurs d application suivants : Apache Tomcat 5 and + Weblogic 8,9 Websphere 6.02, 6.1 D autres serveurs d application peuvent être utilisés. Toutefois, la plupart des développements et des tests étant réalisés sous Apache Tomcat, l équipe Jahia ne supporte officiellement que cette plateforme. 1.3 BASES DE DONNÉES TESTÉES: HyperSonicSQL 1.7.x MySQL 4.x and 5.0.x PostgreSQL 7.x / 8.x SQL Server 7.0 & 2000 Oracle 9i and 10g Les autres SGBD disposant d un driver jdbc doivent également fonctionner. Reportez vous au chapitre Configurations Avancées pour en savoir plus sur l installation et la configuration de Jahia avec d autres bases de données que la base embarquée Hypersonic.

8 I p8/ PRÉPARER VOTRE SYSTÈME Pour tester si Java est déjà installé sur votre système, tapez la ligne de commande suivante : java version Vous devriez recevoir un message de retour indiquant quelle version de java est installée sur votre système. Notez que le même message vous sera retourné s il n y a qu un JRE (Java Runtime Environement) installé. Si une erreur est retournée suite à la frappe de la commande, c est que vous n avez probablement pas de JDK complet installé. Si vous avez installé d autres versions du JDK, JRE ou d autres serveurs Java sur votre système, nous vous recommandons d effectuer quelques tests afin de vous assurer que Jahia s exécutera sans problème. Vérifiez que vous n avez pas encore de variables TOMCAT_HOME et CATALINA_HOME définies. Notez qu une fois installée Jahia vérifiera au moment de son lancement que ces variables ne sont pas définies et, si elles les sont déjà, interrompra son exécution. Après installation, vous devez définir la variable d environnement JAVA_HOME pointant vers le répertoire contenant votre JVM. Le répertoire d installation par défaut de la JVM SUN sur Windows est "c:\j2sdk1.4.1_xx", où xx est le numéro de version. Jahia vérifie au démarrage que cette variable est convenablement définie, si ce n est pas le cas son exécution est stoppée. Pour définir cette variable, suivez les procédures suivantes : 2.1 SOUS WINDOWS i) Ouvrir le Panneau de Configuration, puis les Options du Système. Puis, selon votre système : Cliquez sur l onglet Avancé et cliquez sur le bouton Variables d environnement (Windows 2000/XP) Cliquez sur l onglet Propriétés et cliquez sur le bouton Environnement (Windows NT) ii) Cliquez sur Nouveau dans la partie de la fenêtre dédiée aux variables système. Saisissez ensuite les informations suivantes : Nom de la variable: JAVA_HOME Valeur de la variable : c:\j2sdk1.4.13_01 (si vous avez installé la JVM à un autre emplacement que celui propose par défaut, modifiez la valeur de la variable en conséquence). Pour installer une machine virtuelle Java sur un système Windows (WindowsNT, Windows2000 ou WindowsXP) vous devez posséder les droits d administration sur la machine. Contactez votre Administrateur Système si vous ne disposez pas des droits suffisants.

9 I p9/102 Figure 1-1 : Variables d'environnement. Cliquez sur OK pour valider votre saisie. La machine virtuelle Java devrait être normalement installée désormais. Veuillez noter que sous Windows NT un redémarrage de votre ordinateur est nécessaire pour que les changements soient pris en compte. 2.2 SOUS LINUX Définissez la variable JAVA_HOME au niveau du répertoire racine de votre JDK. Deux exemples : Supposons que vous avez installé le JDK version 1.4 dans le répertoire /usr/java. Le classpath sera défini en tapant : export JAVA_HOME=usr/java/j2sdk1.4.1_02 (en bash ou ksh) export JAVA_HOME usr/java/j2sdk1.4.1_02 (en csh ou tcsh) 2.3 SOUS SOLARIS Définissez la variable JAVA_HOME au niveau du répertoire racine de votre JDK. Deux exemples : Supposons que vous avez installé le JDK version 1.4 dans le répertoire /usr/java. Le classpath sera défini en tapant : export JAVA_HOME=/usr/java (en ksh) JAVA_HOME=/usr/java;export (en sh) setenv JAVA_HOME /usr/java (en csh ou tcsh) 2.4 SERVEUR D APPLICATION EMBARQUÉE PAR DEFAUT La version standard de Jahia 5.0 est distribuée avec un serveur d application Apache Tomcat embarqué. Aucune configuration manuelle n est requise, celle-ci sera réalisée automatiquement durant l installation de Jahia. Veuillez noter que Jahia est configuré pour tourner par défaut sur le port 8080, et que cela peut créer un conflit s il existe déjà sur votre environnement un autre Tomcat ou tout autre application serveur utilisant le même port. 2.5 BASE DE DONNÉES EMBARQUÉE La version standard de Jahia 5.0 est distribuée avec une base de données HyperSonicSQL embarquée. Si vous souhaitez démarrer votre utilisation de Jahia rapidement, vous pouvez utiliser cette base de données tel quel. Nous verrons qu il est très facile de changer de base de données ultérieurement et de transférer tout le contenu de votre projet.

10 I p10/102 CHAPITRE 2 : INSTALLATION DE JAHIA Ce chapitre décrit pas à pas la façon d'installer Jahia 5.0 et de réaliser les configurations initiales. Jahia est distribué sous forme d'un package compressé (tar.gz) pour Linux et sous forme d'un exécutable avec un assistant d'installation graphique pour Windows. Ce chapitre couvre les deux procédures d'installation. Ce chapitre recouvre l'installation "par défaut" avec le serveur d'application Tomcat embarqué, la base de données Hypersonic et en suivant la procédure guidée grâce à l'assistant d'installation Jahia. Reportez vous au chapitre Configurations avancées si vous souhaitez utiliser Jahia avec d'autres serveurs d'application et/ou d'autres bases de données. 1. SYSTÈME D EXPLOITATION 1.1 INSTALLATION SOUS WINDOWS En premier lieu, lancez l exécutable jahia.exe. Sélectionnez ensuite l emplacement désiré pour installer votre serveur Jahia. N utilisez pas d espaces dans votre chemin d accès au répertoire d installation. Cette opération ajoutera automatiquement une entrée Jahia 5.0 à votre menu Démarrer/Programmes contenant les raccourcis vers vos applications. Cette entrée Jahia 5.0 contient des raccourcis Start Jahia, Stop Jahia et Uninstall Jahia. 1.2 INSTALLATION SOUS LINUX Pour installer le fichier jahia5.0.xxx.tar.gz, rendez vous dans le répertoire dans lequel celui ci a été téléchargé. Décompressez le fichier d archive dans un répertoire, dont le nom ne contient aucun espace. 1.3 PREMIER LANCEMENT Pour lancer Jahia: Windows Cliquez sur Démarrer/Programmes/Jahia x.xx/start Jahia. LINUX Exécutez le script jahia.sh. Attendez que Tomcat ait fini de se charger, puis lancez un navigateur et saisissez l adresse suivante : Où your_host_name est le nom ou l adresse IP de la machine sur laquelle vous avez installé Jahia. Vous pouvez également utiliser localhost ou l adresse IP Cette opération lancera la base de données HyperSonicSQL et ouvrira l assistant de configuration Jahia dans votre navigateur. Vous devrez démarrer et arrêter manuellement Jahia en utilisant les scripts shell jahia.sh et shutdown.sh. Vous pouvez également créer un script qui est exécuté automatiquement chaque fois que votre serveur redémarre. Reportez vous à votre documentation Unix / Linux pour savoir comment faire.

11 I p11/ ASSISTANT D INSTALLATION JAHIA La première fois que vous exécuterez l application Jahia, l Assistant d installation Jahia sera lancé; celui-ci vous guidera pour définir les différents paramètres nécessaires au fonctionnement correct de l application. Figure 2-1 : Premier lancement de Jahia Cet écran est affiché lors de votre premier accès à Jahia. Il affiche les informations concernant l'environnement serveur (serveur http, serveur d'application, version de java ). Vous pouvez choisir la langue dans laquelle la procédure d'installation sera exécutée. Actuellement, 6 langues sont disponibles : Anglais, Français, Allemand, Espagnol, Italien et Chinois. Cliquez sur "Etape suivante" pour poursuivre l'installation. 2.1 LICENCE ET CONDITIONS D UTILISATION Sur cet écran, vous devez choisir l édition de Jahia que vous souhaitez installer selon vos besoins.

12 I p12/102 Figure 2-2 : Licence Jahia Et accepter les conditions d utilisations.

13 I p13/102 Figure 2-3 : Conditions d utilisation 2.2 DÉFINITION DU SUPER ADMINISTRATEUR Choisissez un nom d'utilisateur et un mot de passe. Ceux sont les identifiants du compte qui possèdera tous les droits pour administrer Jahia. Confirmez votre mot de passe en le saisissant une seconde fois. Vous pouvez saisir des informations complémentaires telles que le nom, le prénom et l'adresse de l'administrateur. (Optionnel). : Propriétés de la base de données

14 I p14/102 Figure 2-4 : Super administrateur définition 2.3 CONFIGURATION DU SERVEUR Le premier champ (chemin d'accès au serveur d'application) contient le répertoire courant où est installé Tomcat (ou tout autre serveur d applications). En cas de non détection automatique, veuillez indiquer le répertoire principal de votre serveur d application Java. Sinon, il ne devrait pas être modifié.

15 I p15/102 Figure 2-5 : Paramétrage du serveur Si vous souhaitez modifier la base de données utilisée par Jahia (celle installée par défaut est HypersonicSQL), cliquez sur Propriétés avancées.

16 I p16/102 Figure 2-6 : Propriétés de la base de données Si vous préférez utiliser une autre base de données, vous pouvez régler les paramètres de connexion sur cet écran (reportez vous au chapitre "Options de configuration avancées" pour en savoir plus). Vous avez maintenant la possibilité de sauvegarder tous les fichiers et bigtext dans votre base de données au lieu de les sauvegarder sur le système de fichier classique de votre disque dur. Quand vous avez choisi la base de données souhaitez, cliquez sur Etape suivante pour continuer. 2.4 PROPRIÉTÉS DU SERVEUR DE MAIL Ces paramètres permettent d être notifié par lors d une erreur d utilisation de Jahia Portal Server. Si la notification évènementielle est activée, le destinataire reçoit un message chaque fois qu une erreur apparaît sur Jahia. Vous pouvez spécifier un serveur sortant (SMTP) et une adresse de destination de ces notifications. Vous avez également la possibilité de modifier le niveau de notification des évènements de «désactivé» à «paranoïaque».

17 I p17/102 Aucun = Aucune notification . Standard = s envoyés lorsque des erreurs critiques surviennent. Important = s envoyés dès qu'une erreur survient. Parano= s envoyés dès qu'un warning survient. Cliquez sur Etape Suivante : Figure 2-7 : Propriétés du serveur mail 2.5 PROPRIÉTÉS DU SITE VIRTUEL PAR DÉFAUT Dans cette section, vous allez créer votre site Jahia. Vous aurez besoin de définir différentes informations concernant votre site, la langue utilisée par défaut, ainsi que la création d un compte administrateur pour le site.

18 I p18/102 Figure 2-8 : Propriétés du site virtuel 2.6 TEMPLATES (MODÈLES DE PAGES) Un ensemble de templates est livré par défaut avec Jahia. Lors de l installation de Jahia, vous devez spécifier quel package vous souhaitez utiliser pour la création des pages du site web créé par défaut lors du processus d'installation. Une fois la sélection effectuée, cliquez sur Etape Suivante.

19 I p19/102 Figure 2-9 : Choix de l ensemble de templates 2.7 SOMMAIRE Le dernier écran résume les paramètres choisis lors de l installation. Si vous souhaitez en modifier certains, cliquez sur Etape Précédente. Dans le cas contraire, cliquez sur Sauver Modifications.

20 I p20/102 Figure 2-10 : Résumé Si vous avez correctement configuré Jahia, vous devriez voir apparaître l écran suivant après quelques secondes :

21 I p21/102 Figure 2-11 : Succès de l'installation Cliquer sur "Se connecter à Jahia" fera apparaître la page d'accueil du site virtuel configuré par défaut. Figure 2-12 : Page d'accueil du site virtuel par défaut.

22 I p22/102 CHAPITRE 3 : GESTION DE SITES SOUS JAHIA Pour accéder aux interfaces d'administration de Jahia, authentifiez vous en utilisant le nom d'utilisateur et le mot de passe que vous avez définis lors du processus d'installation (compte Super Administrateur) Une fois authentifiée, cliquez sur le lien Administration dans la barre d'édition apparue tout en haut de la page. Le compte Super Administrateur (root) que vous avez défini lors du processus d'installation, vous donne accès à l'administration du serveur Jahia, ainsi qu'à l'administration des sites virtuels. 1. L'interface Gestion des propriétés du serveur vous permet de gérer et déployer de nouveaux sites, des outils (éditeurs HTML, par exemple) et vérifier le fonctionnement du système. Seul le Super Administrateur (root) peut accéder à ces interfaces. 2. L'interface Options du site vous permet de gérer un site spécifique. Les fonctions telles que la gestion des utilisateurs, des groupes, des templates y sont disponibles. Cette interface est accessible à tous les membres du groupe administrateurs. Le Super Administrateur a également accès aux interfaces d'administration de site virtuel. Pour passer d'un mode d'administration à l'autre, cliquez sur Accéder aux options du site si vous êtes en mode administration serveur et Accéder aux propriétés du serveur si vous êtres en mode administration de site. 1. ADMINISTRATION : OPTIONS DU SITE

23 I p23/102 Figure 3-1 : Administration de site virtuel Cet écran regroupe toutes les entrées vers les outils permettant de gérer la configuration d'un site virtuel. Le Super Administrateur (root) peut accéder à ce panneau de configuration pour chacun des sites virtuels déclarés. L'administrateur de site (siteadmin) n'a accès à ce panneau de configuration que pour le(s) site(s) dont il est responsable et n'a pas accès aux fonctions d'administration du serveur dans son ensemble. 1.1 GESTION CENTRALISÉE DES PAGES Figure 3-2 : Propriétés des pages Via cette interface vous pouvez modifier le template appliqué à n'importe quelle page de votre portail Jahia, en particulier cela peut vous permettre d'appliquer à une page un changement d'apparence très facilement. Notez toutefois que le template "ancien" et celui par lequel vous le remplacez doivent partager des champs communs afin que le contenu puisse continuer à être affiché et manipulé correctement. Reportez vous au Guide du développeur de templates pour plus d'information sur la façon de construire des templates. Choisissez la page sur laquelle vous souhaitez appliquer le changement, puis sélectionnez le template à appliquer. Cliquez sur Sauver Modifications pour valider vos choix. Si vous choisissez un nouveau template qui n'utilise pas les mêmes champs que votre template d'origine, le contenu ne sera plus affiché, mais il n'est toutefois pas perdu. Le contenu demeure en effet stocké dans la base de données utilisée par Jahia et pour le faire réapparaître vous pouvez revenir à votre template d'origine. Cette possibilité peut s'avérer utile en particulier pour tester un template contenant encore des erreurs et revenir à une version que l'on sait être stable.

24 I p24/ GESTION DES UTILISATEURS Figure 3-3 : Liste des utilisateurs Cette interface permet aux administrateurs du site de gérer les utilisateurs déclarés dans Jahia qui auront des droits sur le site. Vous pouvez ajouter, modifier ou effacer des utilisateurs, ainsi qu ajouter des groupes et classer vos utilisateurs dans ces groupes. Veuillez noter que l utilisateur Jahia Administrateur (créé par défaut) ainsi que le compte invité (anonyme) ne peut être effacés. En fait, l utilisateur Jahia Administrateur et Root ne sont pas listés dans l interface car ils ont, par principe, tous les droits sur le site courant.

25 I p25/102 Vous pouvez également parcourir, rechercher et trier les utilisateurs en provenance de différentes sources externes. Actuellement, les utilisateurs peuvent être déclarés directement dans Jahia ou authentifiés via une connexion à un serveur tiers répondant à la norme LDAP. Pour savoir comment configurer une connexion entre Jahia et un serveur LDAP, référez vous au chapitre «Configurations avancées». Dans le cas de figure où vous disposez de plusieurs dizaines ou centaines d utilisateurs, vous pouvez utiliser les fonctions de recherche pour retrouver des utilisateurs spécifiques. Des caractères jokers peuvent être utilisés, par exemple en saisissant «s*» vous trouverez tous les utilisateurs dont le nom commence par «S». Vous pouvez également trier de façon ascendante ou descendante la liste des utilisateurs affichés, en cliquant sur les icônes situées au dessus de la fenêtre de liste. Pour ajouter un utilisateur, cliquez simplement sur Ajouter un nouvel utilisateur, saisissez les informations demandées puis validez en cliquant sur OK. Pour modifier les propriétés d un utilisateur, sélectionnez le dans la liste et cliquez sur Voir/Modifier les propriétés d un utilisateur. Si vous souhaitez utiliser les fonctionnalités de notification par du workflow, vous devez impérativement saisir les adresses associées aux utilisateurs que vous créez. Via le menu Modifier les propriétés d un utilisateur, vous pouvez également définir une page d accueil pour chaque utilisateur. Lorsque l utilisateur s authentifiera, il pourra sélectionner l option «Aller sur ma page d accueil» dans la liste déroulante et sera alors automatiquement envoyé sur cette page. Une fois authentifié, l utilisateur trouvera également un lien vers sa page d accueil dans la barre d édition. Figure 3-4 : Définir les pages d accueil

26 I p26/102 Cliquez deux fois sur OK pour valider. Si vous souhaitez effacer un utilisateur, cliquez sur Supprimer l utilisateur sélectionné. Il sera également effacé de toutes les pages sur lesquelles il possède des droits spécifiques. Veuillez noter que vous ne pouvez pas retirer un utilisateur qui est référencé sur un serveur LDAP (externe). En cliquant sur Gestion des groupes, vous pourrez ajouter ou effacer des groupes et déplacer des utilisateurs vers, depuis et entre les groupes. Voyez les paragraphes suivants pour en savoir plus sur ce sujet. 1.3 GESTION DES GROUPES D UTILISATEURS Figure 3-5 : Interface de gestion des groupes

27 I p27/102 Trois groupes existent par défaut dans Jahia et ne peuvent être supprimés : - administrators : regroupe les utilisateurs possédant tous les droits d'administration sur le site virtuel. - users: regroupe tous les utilisateurs référencés (Jahia ou LDAP) font partie de ce groupe par défaut. - guest : ce groupe représente tous les utilisateurs possibles, anonymes comme authentifiés. Comme l'utilisateur anonyme (utilisateur invité, guest) est considéré dans Jahia comme un utilisateur standard automatiquement connecté en tant qu'invité, si vous ne conférez de droits d'accès à une page qu'au compte utilisateur guest, les autres utilisateurs authentifiés n'auront pas accès à cette page. Si vous souhaitez que la page devienne visible pour tous les utilisateurs, il vous faut alors donner les droits de lecture au groupe guest qui inclut à la fois les utilisateurs authentifiés et non authentifiés. Pour ajouter ou supprimer des utilisateurs d un groupe, sélectionnez un groupe et cliquez sur Editer le groupe sélectionné. Sélectionnez alors un utilisateur de la liste qui s affiche (ou utilisez la touche Ctrl pour sélectionner plusieurs utilisateurs d un coup) puis cliquez sur Supprimer des membres. Si vous souhaitez ajouter de nouveaux utilisateurs au groupe sélectionné, cliquez sur Ajouter des membres. Figure 3-6 : Ajouter de nouveaux utilisateurs dans un groupe Si aucun utilisateur n'apparaît, cliquez sur le bouton "rechercher" pour afficher la liste complète des utilisateurs. Sélectionnez les utilisateurs désirés et cliquez sur le bouton "ok" pour les ajouter au groupe désiré.

28 I p28/102 Deux icônes à droite de l'écran vous aident à gérer les sélections lorsque la liste comporte beaucoup d'utilisateurs. : Sélectionne tous les utilisateurs : Inverse la sélection courante Vous pouvez également copier un groupe et rassembler dans le nouveau groupe tous les utilisateurs du groupe source. Par exemple, sélectionnez le groupe «users» et cliquez sur Copier le groupe sélectionné. Donnez au nouveau groupe un nom qui lui soit propre (par exemple : users_copie) puis cliquez sur OK. Vous avez désormais un second groupe contenant les mêmes membres que le groupe d origine, à savoir «users». Actuellement il n est pas possible de faire des groupes de groupes mais Jahia supporte les groupes LDAP dynamiques. 1.4 GESTION DES MODÈLES DE PAGES (TEMPLATES) Figure 3-7 : Gestion des Templates. Cet écran vous permet de gérer les différents modèles de pages (templates) disponibles dans votre site.

29 I p29/102 Vous pouvez choisir de réaliser un déploiement manuel ou automatique. Cliquez sur Options de gestion des modèles pour activer ou désactiver le Mode de déploiement automatique (case à cocher) puis cliquez sur Sauvegarder. Si vous avez packagé votre ensemble de templates dans un fichier.ear file, vous pouvez copier celui-ci dans le répertoire suivant : TOMCAT_HOME/webapps/jahia/WEB-INF/var/new_templates/nom_de_votre_site_virtuel Si le mode déploiement automatique est activé, les nouveaux templates deviennent disponibles après quelques secondes. Si cela n est pas le cas, cliquez simplement sur Déployer de nouveaux modèles. Vous devrez alors rafraîchir la page pour voir la liste des modèles (templates) mise à jour, ou revenir au menu principal, puis cliquer à nouveau sur le lien Options de Gestion des Modèles. Déploiement manuel de templates Si vous n avez pas préparé vos templates sous forme d un fichier.ear, vous pouvez quand même les déployer en cliquant sur Ajouter manuellement un nouveau modèle. Figure 3-8 : Déploiement manuel d un template. Comme illustré sur l écran ci-dessus, le dossier contenant les templates à déployer doit être placé dans le répertoire :

30 I p30/102 TOMCAT_HOME/webapps/jahia/jsp/jahia/templates/name_of_your_site Par exemple, si vous êtes en train de gérer le site virtuel mycompany, vous devrez copier vos templates dans le répertoire suivant : TOMCAT_HOME/tomcat/webapps/jahia/jsp/jahia/templates/mycompany/ Commencez par saisir le nom du template tel qu il devra apparaître dans les interfaces d édition. Puis renseignez le chemin d accès au répertoire dans lequel vous avez placé votre nouveau template, par rapport au chemin relatif qui vous est indiqué (dans l exemple cité, par rapport à mytemplates/). Finalement, saisissez le nom du fichier jsp qui décrit votre template (par exemple : mon_template.jsp). Si la case à cocher Disponible pour les utilisateurs n est pas cochée, votre template ne sera pas affiché dans la liste des templates utilisables au niveau des interfaces d édition (en particulier l interface de création de nouvelles pages). Lorsque vous éditez la configuration d un template déjà déployé, la case à cocher Template par défaut permet de spécifier si le template en question doit être celui proposé par défaut dans le menu déroulant de l interface d ajout de page. Cliquez sur Sauvegarder. Le message suivant doit apparaître si le template a été correctement déployé. A été ajouté dans Jahia avec succès. Veuillez noter que pour les noms des dossiers et des template le respect de la casse est indispensable. Si un message d erreur s affiche, vérifiez que le nom du fichier que vous avez saisi est correct et que le fichier se trouve bien dans le répertoire indiqué. Droits d accès aux templates Grâce au système de Liste des Contrôles d Accès (ACL) implémenté dans Jahia, vous pouvez gérer les droits sur les templates et spécifier quel(s) utilisateur(s) peuvent utiliser quel(s) template(s). Sélectionnez un template et cliquez sur l onglet Edition. Vous pouvez également double cliquer sur le nom du template. Figure 3-9: Edition de template

31 I p31/102 Cliquez sur l onglet Droits. Figure 3-10 : Gestion des droits sur les templates Par défaut, tous les utilisateurs ont accès à tous les templates disponibles, sous réserve qu ils aient le droit de gérer du contenu (ajouter des pages). Pour retirer le droit d utiliser un template à un utilisateur ou un groupe d utilisateurs, cliquez sur Ajouter des utilisateurs et des groupes. Choisissez les utilisateurs qui ne doivent pas avoir accès au template courant puis validez. Sélectionnez ensuite ces utilisateurs et groupes et modifiez la position du bouton radio en face de «lecture» pour passer la valeur de «oui» à «non». Désormais, les utilisateurs/groupes sélectionnés ne pourront plus voir le template en question dans les interfaces d édition, car on leur en a explicitement retiré les droits.

32 I p32/ GESTION DU MOTEUR DE RECHERCHE Figure 3-11 : Indexation via le moteur de recherche Jahia utilises la technologie Lucene (Jakarta) de la Fondation Apache ( pour indexer son contenu. Lucene est un moteur de recherche plein texte performant qui repose sur un fichier d'index, minimisant ainsi l'utilisation de mémoire vive (RAM). Avant de pouvoir utiliser le moteur de recherche sur votre site, vous devez créer le fichier d'index. Normalement ce fichier est créé automatiquement lorsque vous créez un site virtuel. Vous devez également ré indexer les sites après restauration d'une sauvegarde. Dans tous les autres cas, l'index de recherche est mis à jour automatiquement lorsque du contenu est modifié ou ajouté dans le système. Cliquez sur Etape suivante puis OK pour indexer votre site. Une fois l'opération terminée l'écran suivant doit apparaître : Figure 3-12 : Indexation réussie

33 I p33/102 L index créé est stocké dans un fichier, ainsi il ne vous sera pas nécessaire de le recréer en cas d arrêt et de redémarrage de Jahia. Vous pouvez lancer une optimisation de l index de recherche si vous pensez que celui-ci a besoin d être optimisé pour en améliorer les performances. Vous trouverez ci dessous un résumé de la syntaxe qui peut être utilisée pour effectuer des recherches? Une explication plus détaillée est disponible dans le Guide de l utilisateur Jahia ou sur la page décrivant la syntaxe de recherche sur le site Jakarta Lucene. ( Les opérateurs Booléens Les opérateurs booléens permettent d'associer dans une recherche plusieurs termes selon des combinaisons logiques. Le moteur de recherche comprend les opérateurs suivants : AND, "+", OR, NOT and "-" (Note: les opérateurs doivent toujours êtres saisis en MAJUSCULES) Caractères Jokers Le moteur de recherche supporte l'utilisation de caractères jokers (caractères de substitution) équivalent à une ou plusieurs lettres. Pour utiliser un joker à la place d'une seule lettre uniquement, il faut utiliser le symbole "?". Par exemple pour chercher "text" or "test" vous pouvez utiliser la syntaxe : te?t Pour utiliser un joker à la place de zéro, une ou plusieurs lettres, il faut utiliser le symbole "*". Par exemple, pour chercher test, tests ou tester, vous pouvez utiliser la syntaxe : test* Vous pouvez également utiliser les jokers au milieu des termes recherchés. te*t Groupement de termes Le moteur de recherché supporte l utilisation de parenthèses pour former des sous requêtes. Cette possibilité peut se révéler très utile si vous souhaitez établir des ordres de priorité et d ordonnancement dans vos requêtes. Pour rechercher les termes jahia ou portail associés au terme "intranet" utilisez la requête suivante : (jahia OR portail) AND intranet Ceci élimine tout risque de confusion et rend certain le fait que le mot «intranet» doit exister que les mots «jahia» ou «portail» peuvent exister. Published Web Site Recherche floue Le moteur de recherche permet également d effectuer des recherches «floue» basées sur l algorithme «Levenshtein» ou «Edit». Pour lancer une recherche floue utilisez le caractère «~» à la fin d un mot unique. Par exemple, pour chercher des termes similaires à bourse, indiquez bourse~ ce qui permettra de récupérer les documents contenants les mots boursier ou boursicoter. Recherche par proximité Le moteur de recherche vous permet d effectuer des recherches en indiquant des mots clefs situés à une distance précisée les uns des autres. Par exemple, en indiquant "jahia cms"~10, le moteur de recherche présentera les documents où le mot jahia se situera à 10 mots du terme «CMS». Renforcer un terme Le moteur de recherche vous permet de renforcer la pertinence d un terme par rapport à un autre dans le cadre des mots clefs soumis.

34 I p34/102 Le caractère «^» suivi du coefficient de renforcement permet d indiquer au moteur le mot ou la phrase que vous souhaitez renforcer. Ainsi pour indiquer que le mot «jahia» a plus d importance que celui de «cms» lors de la recherche demandée, il suffit d indiquer : jahia^4 cms Ceci aura pour effet de mettre en avant les documents contenant le mot «jahia». Vous pouvez également renforcer une phrase : ainsi, en indiquant "jahia cms"^4 "jahia portal, les documents contenant «jahia cms» seront considérés comme plus pertinents. Par défaut, le coefficient de renforcement est de 1. Ce coefficient doit être positif même s il peut être plus petit que 1 (par exemple, 0.2) 1.6 GESTION DES DÉFINITIONS DES PAGES D ACCUEIL Figure 3-13 : Définir les pages d accueil Vous pouvez définir une liste des pages définies comme autant de pages d accueil possible pour des utilisateurs ou des groupes. Vous pouvez également spécifier une page utilisée comme page d accueil pour chaque nouvel utilisateur ou groupe au moment de sa création.

35 I p35/102 Pour créer une nouvelle entrée de page d accueil, cliquez sur Ajouter. Figure 3-14 : Ajouter une nouvelle page d accueil Vous ne pouvez actuellement définir comme page d accueil que des pages jahia déjà existantes. Une future version de Jahia permettra sans doute d utiliser le mécanisme des pages d accueil pour créer automatiquement de nouvelles pages basées sur un template pré choisi, lors de la création d un nouvel utilisateur ou groupe. Une fois que vous avez saisi un nom pour la page d accueil et désigné la page Jahia correspondante, cliquez sur Sauvegarder. Pour définir quelle page d accueil doit être utilisée par défaut lors de la création d un nouvel utilisateur ou groupe, cliquez sur Propriétés générales des pages d accueil. Vous pouvez spécifier une page différente pour les utilisateurs et pour les groupes. 1.7 GESTION DES LANGUES Cette interface vous permet de gérer le paramétrage des langues utilisées sur le site virtuel actif. La partie supérieure liste les langues actuellement utilisées sur le site. Pour chaque langue, deux options sont paramétrables : - Actif : si cette option est cochée, la langue devient disponible en mode édition dans les fenêtres de saisie et les visiteurs pourront naviguer sur le site dans cette langue. Une langue au moins doit être active. - Obligatoire : si cette option est cochée, il ne sera pas possible de valider une page (la publier), tant que le contenu n'aura pas été saisi pour la langue en question. Par exemple, si vous créez une nouvelle page

36 I p36/102 en saisissant son titre uniquement en Français, alors que l'anglais est une langue obligatoire, vous ne pourrez valider la page dans aucune langue qui soit. Ce mécanisme est destiné à éviter une publication avant que toutes les langues déclarées comme obligatoires n'aient été traitées. Figure 3-15 : Menu de gestion des langues En configuration intranet ou extranet, il est fréquent que l on souhaite afficher le contenu disponible, quelque soit la langue en cours de consultation par l utilisateur, car l ensemble du contenu n est pas systématiquement traduit. Par exemple, si vous ne souhaitez pas que certaines pages soient totalement vides de contenu dans certaines langues ou un contenu traduit n a pas encore été saisi, vous pouvez activer l option Utiliser plusieurs langues lors de la navigation sur le site.

37 I p37/102 Cette option permet d utiliser le contenu en provenance d une autre langue, si la zone de contenu est vide dans la langue courante consultée par l utilisateur. Imaginez, par exemple, que dans la version anglaise de votre intranet, certaines zones d informations seront affichées en français, car la version anglaise n a pas encore été remplie. Si vous souhaitez retirer une langue active sur un site virtuel, il suffit de décocher la case Actif située en face du nom de la langue et de cliquer sur le bouton Sauver Modifications. Pour ajouter de nouvelles langues sur un site virtuel, sélectionnez-la dans la liste des langues disponibles. Vous remarquerez que de nombreuses langues sont listées plusieurs fois. L explication est que cette liste est intègre la notion de région d utilisation de la langue (Français de France, Français du Canada, par exemple). Jahia se sert de ce paramètre régional pour servir les pages aux navigateurs. Par défaut, Jahia essaie de servir les pages dans la langue spécifiée par le navigateur qui se connecte, sachant que le comportement de Jahia peut être alors différent selon qu il a affaire à un utilisateur Français ( fr_fr ) ou un utilisateur Canadien (fr_ca). Si vous souhaitez utiliser la langue générique (ce que nous recommandons, sauf besoin très spécifique), utilisez simplement la langue French (fr) qui ne spécifie aucune particularité régionale. L utilisation des identifiants de langues régionaux ne sert que dans le cas où vous souhaitez pouvoir servir des contenus différents suivant que vos utilisateurs utilisent un navigateur canadien ou un navigateur français. Cliquez sur l icône pour ajouter la langue sélectionnée à la liste des langues actives sur votre site. Mappings de langues L option mappings des langage est utile quand vous utiliser deux versions locales d une même langue pour un site. Si, par exemple, vous avez déclaré à la fois Français-Canada (fr_ca) et Français-France (fr_fr) comme langues disponibles sur votre site, vous pouvez vouloir préciser quelle langue sera utilisée quand un utilisateur se présentera en s identifiant avec le code générique Français (fr). Cliquez sur Editer les mappings de langages après avoir déclaré vos deux langues fr_fr et fr_ca afin de pouvoir définir celle qui correspondra également à la langue générique (fr). Pour résumer, voici le comportement de Jahia si vous configurez les langues et le mapping de la manière suivante :

38 I p38/102 Figure 3-16 : mapping des langues Comportement de Jahia dans le cas de multiples langues avec variations locales. Identification locale du navigateur fr_ca fr_fr fr autres Comportement de Jahia Le site sera affiché en Français-Canada (fr_ca) Le site sera affiché en Français-France (fr_fr) Le site sera affiché en Français-France (fr_fr) (choix réalisé à partir des options de mapping des langages) Le site en Français-Canada (fr_ca) sera affiché (dans le cas ou il n existe pas de paramètre local à appliquer, Jahia affiche le site en prenant l ordre défini pour les langues comme critère de choix.

39 I p39/ MISE EN PRODUCTION SUR SERVEUR DISTANT Cette option vous permet de créer par exemple votre site internet à partir de votre site intranet en copiant le contenu sur un serveur distant. Figure 3-17 : paramètres pour la mise en production à distance Dans le but d éviter de publier des données confidentielles sur un serveur public distant, seules les données visibles de l utilisateur sélectionné seront copiées. Jahia utilise la syntaxe du «cron» pour vous permettre de définir la fréquence de vos réplications. Vous pouvez décider de mettre à jour votre suite distance, une fois par semaine, Finalement Jahia utilise son système interne XML d import/export pour copier les données.

40 I p40/ CRÉER CLIP-PORLET HTML Clip Portlet Avec cette interface vous pouvez facilement extraire les horaires des trains, les cours de la bourse ou encore les informations concernant la météo de n importe quel site web et en générer une portlet dynamique. Cela gère également les authentifications afin d accéder aux sites web sécurisés. Le Générateur de portlet HTML est composé de 5 étapes. Configuration : Définitions des paramètres (étape optionnelle) Cette étape permet de définir les paramètres avancées pour la navigation à travers la portlet. Une description de chaque paramètre est disponible en cliquant sur le lien «Help». Figure 3-18 : Générateur de portlet HTML définition des paramètres

41 I p41/102 Cliquer sur le bouton «Sauvegarder la configuration par défaut» pour accéder à l écran de gestion des «clippers». Figure 3-19 : Générateur de portlet HTML Ajouter un «clipper» Pour créer un nouveau «clipper», cliquez sur le bouton Nouveau. Etape 1 : Description du Clipper Dans cette étape vous allez définir le nom, le titre, la description et l URL. Dans notre exemple nous allons créer un clipper qui présente les horaires des trains de la CFF de Genève vers Lausanne. Figure 3-20 : Générateur de portlet HTML Création d un clipper

42 I p42/102 Etape 2 : Enregistrement du clipper Vous allez maintenant pouvoir spécifier la séquence des pages nécessaires pour accéder à la page de résultat souhaitée. Pour enregistrer votre séquence, cliquez sur le bouton Commencer et naviguez normalement jusqu à ce que vous arriviez à la page que vous désirez ajouter dans le clipper, puis cliquez sur le bouton Etape Suivante. Figure 3-21 : Générateur de portlet HTML Enregistrement

43 I p43/102 Etape 3 : Edition des paramètres et découpage de la zone d affichage Dépendamment du clipper que vous créez vous pourriez avoir besoin de définir des paramètres : Mapping: Nom du paramètre affiché dans le clipper Valeur utilisée : Affiche la valeur courante Utilisée par défaut: Si vous voulez utiliser la valeur actuelle par défaut Visibilité: Si vous voulez afficher le paramètre à l utilisateur, dans notre exemple nous avons sélectionné les paramètres Départ et Arrivée. Mise à jour automatique: Si vous voulez remplacer la valeur par défaut du paramètre par celle générée par le serveur. Dans notre cas nous avons défini le paramètre Date du jour comme mise à jour automatiquement. Figure 3-22 : Générateur de portlet HTML Edition des paramètres

44 I p44/102 Il nous reste maintenant à sélectionner la partie du clip que nous voulons afficher dans la portlet. Figure 3-23 : Générateur de portlet HTML Sélection Avec l option Découpage, il vous suffit de sélectionner le tag sur lequel vous voulez vous baser pour effectuer le découpage. Etape 4 : Tester votre clipper En cliquant sur le bouton Tester, cela vous permet de visualiser le résultat de votre clipper. Dans notre exemple, vous pouvez voir les 2 paramètres que nous avions définis en tant que visible et leur valeur par défaut.

45 I p45/102 Figure 3-24 : Générateur de portlet HTML Test En cliquant sur le bouton Tester vous allez pouvoir visualiser le résultat final. Figure 3-25 : Générateur de portlet HTML Prévisualisation

46 I p46/102 La dernière étape est maintenant de la déployer pour que celle-ci devienne disponible dans la liste quand vous souhaitez ajouter des portlets. SQL Clip Portlet Ce type de portlet vous permet d afficher le contenu d une table de n importe quel base de données. Figure 3-26 : Générateur de portlet SQL Les paramètres nécéssaires sont les paramètres de connexion à la base de données souhaitées ainsi que la requête SQL. Jahia va alors généré une portlet dynamique avec le résultat de la requête. Les utilisateurs seront capables de trier, extraire ou filtrer les résultats DROITS SUR LE SITE Dans cette section, vous pouvez déléguer les droits de tous les menus à un ou plusieurs utilisateurs. Vous pouvez définir des permissions spécifiques pour toutes les actions disponibles dans les fenêtres d éditions. 5 onglets sont disponibles : L administration Le menu d Edition Le menu Outils Une liste d actions La langue d édition du contenu pour les auteurs.

47 I p47/102 Figure 3-27 : Droits sur le site 1.11 PURGE DES FICHIERS NON UTILISES (À PARTIR DE LA VERSION ) Jahia 5 perment la pubication de documents dans le Jahia Repository puis de les publier sur une ou plusieurs pages. Afin de supprimer les fichiers n étant plus pertinent, cette fonctionnalité permet de supprimer les fichiers non-utilisés. Cette fonctionnalité possède 2 modes : manuel et automatique.

48 I p48/102 Par défaut, cette fonctionnalité est désactivée sur Jahia. Pour pouvoir en bénéficier, il est nécessaire de la paramétrer via un fichier de configuration puis de redémarrer Jahia. La procédure de configuration est décrite plus bas. Figure 3-28 : Purge des fichiers non utliisés Purge manuelle La purge manuelle fournit une interface utlisateur listant tout les fichiers non-utlisés (chemin relatif ainsi que l auteur). En fonction du parametrage, la purge manuelle affiche ces fichiers afin que l administrateur puisse les supprimer en une seul fois ( Lancer la purge ) ou manuellement en utilisant leurs chemins.

49 I p49/102 Figure 3-29 : Purge des fichiers non utliisés mode manuel Purge automatique La purge automatique est une tâche de fond qui purge régulièrement les fichiers non-utilisés. Configuration Cette fonctionnalité est configurée dans le fichier «purge.properties». Les différents paramètres sont : La compte utilisateur qui va supprimer les fichiers en mode «automatique» (root par défaut). username=root Le nombre de fichiers non-utilisés affichés par page (taille de la pagination). paginationsize=100 L emplacement ou seront créé les fichiers de log. Si ce paramètre n est pas fourni, l emplacement par défaut est le dossier d ou la jvm a été lancée. logdirectory= C:\\jahia\\tomcat\\logs\\purge\\ Le nombre de jours d ancienneté d un fichier avant qu il ne puisse être purgé. Par défaut, un fichier doit avoir au moins 7 jours d ancienneté avant d apparaître dans la liste des fichiers à purger. min_upload_time=7 La fréquence de purge en mode automatique. Des exemples de syntaxe pour ce paramètre sont fournis dans le fichier «purge.properties». periodicity= ? * *

50 I p50/102 Le nombre de chemins de la liste qui doivent être scannés. pathnumber=2 La liste des chemins : une liste contenant tous les chemins qui doivent être parcouru par la purge. A noter que dans cette liste, nous spécifierons aussi le type de purge qui doit être appliqué (manuel ou automatique) path1=/site/acme/shared,manual path2=/site/acme/users,auto

51 I p51/ GESTION DES PROPRIÉTÉS DU SERVEUR (ROOT) Continuons par l'interface d'administration du serveur qui n'est accessible qu'au Super Administrateur (root). Figure 3-30: Panneau d'administration du serveur Jahia. 2.1 GESTION DES SITES VIRTUELS

52 I p52/102 Figure 3-31 : Gestion des sites virtuels. Vous pouvez créer plusieurs sites virtuels sur avec un même serveur Jahia. Chaque site peut disposer de ses propres modèles de pages (templates), ses propres composants, utilisateurs, groupes, etc. Par exemple, vous pouvez avoir un premier site accessible à l'adresse url et un second site qui réponde à l'adresse Le site web créé par défaut au moment de l installation de Jahia 5.x apparaît en tête de liste en tant que My Site. Pour ajouter un nouveau site virtuel, cliquez sur Ajouter un Site. Si vous souhaitez modifier les propriétés d un site existant, cliquez sur le lien Modifier en face du nom du site sur lequel vous voulez intervenir. Ajouter un site virtuel

53 I p53/102 Figure 3-32 : Propriétés d'un nouveau site virtuel En premier lieu, saisissez le titre de votre site. Ce titre sera utilisé dans la liste des sites pour le différencier des autres sites virtuels. Puis, saisissez le nom du serveur; cette information indique le nom du serveur sur lequel s exécute Jahia. Vous pouvez spécifier une URL pour chaque nom de serveur, par exemple et si votre DNS est correctement configuré vous pourrez dès lors accéder à ce site virtuel directement en tapant cette URL dans un navigateur web. Rappelez vous que le port par défaut pour accéder à Jahia est le 8080, donc pour accéder à ce site virtuel, vous devrez taper l url suivante: Vous devez également saisir une clé de site. Il s agit d un mot clef qui sera utilisé dans l url d accès à ce site virtuel spécifique. Par exemple, si vous utilisez l adresse localhost et que vous voulez accéder au site virtuel macompagnie l url à saisir ressemblera à ceci :

54 I p54/102 Vous noterez que si vous utilisez un nom de domaine complet pour accéder à votre site virtuel (ex. : vous n'avez pas besoin d'utiliser la clé de site dans l'url. Vous pouvez également ajouter une description du site dans la zone de texte prévue à cet effet. Cochez la première case si vous souhaitez que ce site devienne le site par défaut. Le site par défaut est celui sur lequel le visiteur est redirigé s'il tape l'url de base de Jahia ( Vous devez ensuite définir le compte administrateur pour ce site. L'administrateur de site aura la possibilité de gérer les utilisateurs, les groupes, les templates (modèles de pages) et les composants externes pour ce site particulier. En revanche, un administrateur de site n'a pas les droits pour gérer l'ensemble des propriétés du serveur Jahia (Super Administrateur uniquement), ses capacités demeurent limitées au site virtuel. Vous avez le choix de créer un nouveau compte pour cet administrateur de site ou vous pouvez choisir un compte déjà existant, défini sur un des autres sites virtuels déjà existants. Cliquez sur Etape suivante. Si vous avez sélectionné l option "Créer un nouvel utilisateur" vous devrez saisir les informations pour ce nouveau compte. Si vous avez choisi la seconde option, vous devrez d'abord choisir le site existant à partir duquel vous souhaitez sélectionner un compte utilisateur, puis sélectionner ce compte en particulier. Une fois le nouvel administrateur de site défini, vous devez choisir le package de templates par défaut qui sera utilisé sur ce site. Quand vous installez Jahia 5, 2 ensemble de templates vous sont proposés : Corporate portal templates v2 and Corporate portal. Vous pouvez ajouter votre propre ensemble de templates en plaçant un jar contenant les templates dans \tomcat\webapps\jahia\web-inf\var\shared_templates. Il se déploiera automatiquement après avoir redémarré Tomcat.

55 I p55/102 Figure 3-33 : Choix du package de templates Vous pourrez toujours remplacer le package de templates par le(s) votre(s) une fois le site créé. S vous souhaitez que votre package de templates soit disponible dans cette liste lors de la création d'un nouveau site virtuel, vous devez préparer votre package dans un fichier jar incluant vos templates et un fichier template.xml déclarant et décrivant les différents templates inclus dans ce package, et copier ce jar dans le répertoire suivant : jahia/web-inf/var/shared_templates. 2.2 GESTION DES CATÉGORIES Le contenu stocké par Jahia peut être facilement associé à des catégories (méta données sémantiques) qui permettront de retrouver ou regrouper ce contenu de diverses façons. Cela signifie qu'en créant une liste de catégories et de sous-catégories vous pouvez relier les éléments atomiques de contenu de vos sites (pages, liste de containers, containers) à ces catégories. Il devient alors possible de faire apparaître sur une page tous les objets appartenant à une catégorie (quelque soit l'endroit ou ces objets se trouvent dans le site) ou inversement faire apparaître à côté d'un objet la liste des catégories auxquelles il est rattaché. Imaginez par exemple la page d'accueil du département "Marketing" de votre site sur laquelle il devient possible d'afficher automatiquement toutes les news publiées sur votre site qui ont été associées à la catégorie "marketing".

56 I p56/102 Vous pouvez même réutiliser du contenu depuis un autre site virtuel géré par votre serveur Jahia, le mécanisme des catégories étant transversal à l'ensemble des sites virtuels. Figure 3-34 : Liste des catégories déjà créées Pour chaque catégorie, vous pouvez définir une ou plusieurs propriétés. Par exemple, vous pouvez définir la page associée à cette catégorie, une description de la catégorie ou toute autre propriété que vous souhaitez. Les propriétés peuvent bien entendu être utilisées via les templates de Jahia. Un exemple est fourni par le template categories browsing qui liste automatiquement les contenus reliés à vos catégories. Pour ajouter une nouvelle catégorie, cliquez simplement sur la catégorie parente, puis sur le bouton Ajouter Par défaut, les catégories ne peuvent être vues par l utilisateur«guest», vous devrez donc aller dans le menu de droite, dans la section Droits, ajouter l utilisateur «guest» et lui donner la permission de lire les catégories.

57 I p57/102 Figure 3-35 : Ajout d'une nouvelle catégorie Saisissez la clé de catégorie (un identifiant unique pour chaque catégorie quelque soit le site virtuel concerné), le nom de la catégorie pour chaque langue active (si vous ne saisissez pas de nom, c'est la clé qui sera automatiquement utilisée par Jahia) puis cliquez sur Valider. Si nécessaire, saisissez ensuite un nom de propriété et une valeur associée. Vous pouvez saisir autant de propriétés que souhaité, il n'y a pas de limitations. Désormais, lorsque vous modifiez une page, une liste de containers ou un container de votre site web, vous pourrez cliquer sur l'onglet Catégories et relier votre contenu à une ou plusieurs des catégories définies via cette interface d'administration. 2.3 GESTION DES PROPRIÉTÉS DU SERVEUR Vous pouvez ici changer les configurations de serveur de mail définies à l aide de l Assistant d Installation Jahia

58 I p58/102 Figure 3-36 : Propriétés du serveur. Si vous souhaitez utiliser les fonctions de notification pour être prévenu lorsque des erreurs surviennent, saisissez l'adresse de votre serveur de mail sortant (SMTP), ainsi que votre adresse et l'adresse d'émission. Puis, sélectionnez le niveau de notification souhaité, de Indisponible à Paranoïaque. Ces notifications vous aideront à résoudre des problèmes notamment lorsque vous testerez de nouveaux templates. Assurez vous que votre serveur de mail sortant (SMTP) est bien configuré pour accepter les mails qui seront envoyés par Jahia sans nécessiter d'authentification SMTP. 2.4 GESTION DES PORTLETS Les portlets ou les applications web peuvent facilement se déployer et être utilisés dans Jahia. Une douzaine d applications web sont disponibles avec l installation de Jahia par défaut, allant du gestionnaire de fichier à la gestion des feuilles de temps ou encore du forum. Si votre installation de Jahia n est pas livrée avec ces applications, vous pourrez les télécharger directement à partir de notre site web Vous pouvez également développer de nouvelles applications web. Merci de vous référer au Guide «Jahia Webapps Guide» pour apprendre comment développer de nouvelles applications ou pour en adapter une qui existe déjà. Pour déployer automatiquement votre nouveau composant, vous devrez simplement copier votre fichier.ear ou.war dans le répertoire suivant : TOMCAT_HOME/webapps/jahia/WEB-INF/var/new_webapps/ Après quelques secondes, Jahia va automatiquement déployer le composant. Si vous retournez dans la section Gestion des portlets, vous devriez voir votre nouvelle application. Si vous ne préférez pas les déployer automatiquement, vous pouvez supprimer cette option dans Options de gestions des portlets. Pour déployer manuellement de nouvelles applications, vous pouvez cliquer sur Déployer de nouveaux portlets, le système va alors chercher des applications à déployer dans le répertoire new_webapps ou en passant par Ajouter manuellement un nouveau portlet et en spécifiant le chemin complet de l application. (i.e: /foo/bar/apps.ear on Unix or c:\foo\bar\apps.ear on Windows)

59 I p59/102 Figure 3-37 : Gestion des portlets. 2.5 JOURNAL D ADMINISTRATION (LOGS) Figure 3-38: Gestion des logs d'administration. Jahia conserve une trace de toutes les manipulations effectuées sur les sites (authentification, modifications de contenu, publication ) avec la date, l'heure précise et l'utilisateur qui a réalisé l'action en question. Par défaut, Jahia stocke les 500 dernières entrées dans le journal. Pour visualiser le journal, cliquez sur Afficher les logs.

60 I p60/102 Figure 3-39 : Afficher les logs d'administration. Les logs peuvent être triés ou exportés dans différents formats. 2.6 MODIFIER LES PROPRIÉTÉS DU SUPER ADMINISTRATEUR Vous pouvez changer à n importe quel moment les propriétés du Super Administrateur de Jahia (nom, mot de passe, adresse ,...).

61 I p61/102 Figure 3-40 : Propriétés du Super Administrateur (root) Saisissez simplement les nouvelles valeurs désirées puis cliquez sur OK. 2.7 VÉRIFICATIONS ET VALIDATION DE L HTML Cette fonctionnalité vous permet de personnaliser la vérification interne du code HTML (référence aux liens interne, WAI ) que Jahia peut effectuer sur les riches éléments. Afficher la liste des éditeurs HTML

62 I p62/102 Figure 3-41 : Liste des éditeurs HTML Cette option vous permet d'afficher la liste des éditeurs HTML installés et activés dans Jahia. Les éditeurs disponibles par défaut sont Simple Text (champ de formulaire simple, dans lequel il est possible de saisir manuellement des balises HTML) et l'éditeur FCK Editor (un éditeur offrant des fonctions d'édition HTML basiques, qui est utilisable avec la plupart des navigateurs). Un fichier de configuration spécifie quels éditeurs sont disponibles, leur ordre d affichage, afin que l éditeur par défaut. Ce fichier, htmleditors_config.xml, est situé dans le répertoire suivant : TOMCAT_HOME/webapps/jahia/WEB-INF/etc/htmleditors Les changements apportés à ce fichier peuvent être pris en compte sans redémarrer Jahia, en cliquant sur le lien «Recharger le fichier de configuration des éditeurs Html à partir du disque dur» Filtrage des balises Ce menu vous permet d'ajouter une liste de balises HTML qui seront filtrées (supprimées) lorsque les champs de type Texte Long (faisant appel aux éditeurs HTML) seront sauvegardés. Par exemple, si vous souhaitez supprimer toutes les balises de type <font> pour empêcher les rédacteurs de jouer avec la présentation des textes au détriment du respect de la charte graphique du site. Vous pouvez également décider de filtrer toutes les balises qui ne font théoriquement plus partie de la dernière norme HTML, telles que <b> ou <center>.

63 I p63/102 Figure 3-42 : Liste des balises à filtrer Cliquez sur Ajouter une balise et saisissez le nom de la balise à filtrer sans mettre les caractères "<>" Ainsi, si vous souhaitez filtrer la balise <font> </font>, saisissez simplement "font". Jahia retirera les balises du contenu tout en conservant ce qui se trouve entre les balises. Le filtrage est dépendant de la case (majuscule, minuscule) et s'applique par défaut à tous les sites virtuels déclarés. Toutefois vous pouvez ajouter ou supprimer le filtrage à travers l'écran "Gestion des propriétés de site". Pour quel le filtrage des balises soit fonctionnel, vous devez activer l'option "Nettoyage du code HTML" dans l'écran "Gestion des propriétés de site". Configuration par site Par site, vous avez la possibilité de sélectionner les options disponibles sur les objets de textes riches.

64 I p64/102 Figure 3-43: Configuration des sites virtuels Le nettoyage HTML vous offre la possibilité de définir si un texte riche sera parsé et automatiquement corrigé en cas d erreur de syntaxe HTML. Le filtrage de balises interdites vous permet de retirer automatiquement certains tags entrés par les auteurs. L intégrité des URLs va empêcher la validation d un élément tant que l URL ne sera pas valide. Enfin la vérification des critères WAI forcera le niveau 1 de compatibilité WAI lors de l édition des textes riches. 2.8 STATUT DU SERVEUR ET SYSTEME DE CACHE JAHIA Cet écran vous informe principalement sur l'état et le niveau d'utilisation des différents caches de Jahia, mais aussi sur d'autres aspects de votre environnement comme la mémoire ou le pool de connexion à votre base de données. Ces informations peuvent être particulièrement utiles en cas de problème. Cette interface peut également être utilisée pour réinitialiser certains caches internes de Jahia, ou les caches HTML.

65 I p65/102 Figure 3-44: Statut du serveur et des caches Jahia créé automatiquement une version en cache des pages HTML appelées par les utilisateurs, dans le but d'améliorer les temps de réponse pour les utilisateurs suivants. L'accès aux pages présentes dans le cache peut être de dix à vingt fois plus rapide que l'accès à une page non mise en cache, dans la mesure où cela évite toute connexion vers la base de données et tout traitement processeur inutile. En effet, Jahia doit seulement dans ce cas servir une copie HTML pré stockée de la page, au lieu de calculer la page à partir de tous ses objets sur l'instant.

66 I p66/102 Bien sûr, chaque fois qu'une page est mise à jour, sa version en cache (et toutes les pages impactées) est effacée par Jahia. Par exemple, si vous modifiez le nom de la page d'accueil, toutes les pages en cache seront effacées afin de permettre la mise à jour des menus de navigation qui font appel au nom de la page d'accueil. Par défaut, la taille du cache HTML n'est pas limitée. Comme Jahia stocke une copie de page par utilisateur connecté (chaque utilisateur pouvant avoir des droits différents et donc une version HTML différente de la page in fine) ceci est susceptible d'entraîner une occupation mémoire importante, suivant la taille de votre site et le nombre d'utilisateurs authentifiés. 2.9 A PROPOS DE JAHIA Figure 3-45: A propos de Jahia

67 I p67/102 Cet écran affiche la version de Jahia (release et build). Sont affichés également le nombre actuel d utilisateurs, de modèles de pages et de pages ainsi que leur nombre maximum autorisé par votre licence. Si vous avez besoin d'une clé de licence particulière pour développer sous Jahia, envoyez nous un à l'adresse [email protected] avec les paramètres que vous souhaitez changer. N'oubliez pas que Jahia n'est pas gratuit pour une utilisation sur des serveurs de production. Veuillez consulter la licence Jahia pour connaître vos droits DROITS SUR LE SERVEUR Comme pour la section Droits sur le site, vous pourrez ici associer des droits à un super utilisateur pour effectuer toutes les actions disponibles dans le menu Gestion des propriétés du serveur. Figure 3-46 : Droits sur le serveur

68 I p68/ STATISTIQUES Dans cette section, vous pouvez afficher des statistiques par utilisateur, groupes, pages ou templates pour un site données. Figure 3-47: Statistiques

69 I p69/102 CHAPITRE 4 : INSTALLATION ET CONFIGURATION AVANCEE DE JAHIA Vous découvrirez dans ce chapitre comment configurer Jahia, notamment comment le faire fonctionner avec des logiciels tiers. Ceci inclus les bases de données, ou encore les serveurs LDAP. Vous découvrirez également les options de configuration avancées et certaines astuces. Ce chapitre est réservé aux administrateurs système expérimentés. 1. ORGANISATION DES FICHIERS JAHIA Voici un plan de la structure des répertoires de Jahia. Les répertoires clés sont indiqués en rouge et suivis d'un numéro entre parenthèses. Une courte description des ces répertoires clés peut être trouvée après ce plan. -- tomcat -- bin -- common -- endorsed -- i18n -- lib -- conf (1) -- Catalina -- localhost -- logs (2) -- server -- classes -- lib -- webapps -- [...] -- shared -- classes -- lib -- temp -- webapps (3) -- balancer -- META-INF -- WEB-INF -- [...] -- images -- jahia (4) -- clippers -- htmlpattern -- sqlpattern -- html -- root -- startup -- clipbuilder -- images -- jsp

70 I p70/ clipbuilder -- [...] -- jahia -- administration -- [...] -- chat -- components -- configuration_wizard -- [...] -- css -- [...] -- engines (5) -- [...] -- errors -- events -- htmleditors (6) -- [...] -- images -- javascript -- [...] -- processing -- templates (7) -- [...] -- templates_preview -- topbar -- test -- META-INF -- monitor -- [...] -- slidesearch -- [...] -- txt -- views -- [...] -- WEB-INF -- apps -- classes (8) -- jahiatemplates (9) -- etc (10) -- button -- cas -- config -- definition -- htmleditors -- jetspeed -- [...] -- ldap -- methods -- outputcache -- repository -- services -- [...] -- slide

71 I p71/ spring -- struts -- taglibs -- [...] -- upgrade -- xml_dtd -- lib -- tld -- var -- content (11) -- [...] -- db (12) -- [...] -- dbdata (13) -- field_definitions -- fileextraction -- images -- [...] -- new_templates (14) -- [...] -- new_webapps (15) -- repository -- [...] -- scripts -- [...] -- search_indexes (16) -- [...] -- shared_components (17) -- shared_templates (18) -- templates -- [...] -- tmp -- xslt -- ROOT -- [...] -- webdav -- WEB-INF -- work (19) -- [...] 1. conf : Le répertoire contient les fichiers de configuration de Tomcat, essentiellement les fichiers server.xml et web.xml. Il contient également le fichier de configuration de la base de données. 2. logs : journal des logs produits par Tomcat et Jahia. Catalina.out (linux) et stdout.txt (windows) contiennent les logs courants. 3. webapps : répertoire de Tomcat contenant toutes les servlets (ou applications web) déployées. La servlet jahia se trouve dans ce répertoire, ainsi que les applications web déployées dans Jahia. 4. jahia : la servlet jahia. C'est le répertoire que vous devez copier si vous souhaiter déplacer votre jahia vers une autre machine serveur ou une autre instance de Tomcat, ou encore pour réaliser une copie de secours (backup).reportez vous au chapitre Maintenance de Jahia pour plus de détails.

72 I p72/ engines : ce répertoire contient toutes les pages jsp servant à générer les interfaces d'administration de Jahia. Si vous souhaitez les modifier pour personnaliser votre installation de Jahia, reportez vous à la FAQ) 6. htmleditors : vous trouverez ici tous les fichiers nécessaires au fonctionnement des éditeurs html utilisés dans Jahia. 7. templates : les templates déployés dans chaque site virtuel sont placés ici. Chaque ensemble de template est stocké dans un répertoire dont le nom correspond à la clé du site virtuel. 8. classes : les fichiers de RessourceBundle utilisés pour traduire les interfaces Jahia dans différentes langues sont stockés dans ce répertoire. Il y a normalement au moins 3 fichiers par langue : JahiaAdministrationResources.properties, JahiaEnginesResources. properties et JahiaMessageResources.properties. Pour savoir comment traduire Jahia dans de nouvelles langues, reportez vous au paragraphe correspondant dans le chapitre Questions Fréquemment Posées. 9. jahia_templates : Ce répertoire situé à l'intérieur du répertoire classes contient les resources bundle associés aux sites virtuels déclarés dans Jahia. Le resource bundle pour l ensemble de templates fourni par défaut est Corporate_portal_templates.properties. 10. etc : Le répertoire etc contient la plupart des fichiers de configuration de Jahia. Le sous répertoire Config contient le principal fichier de configuration de Jahia, jahia.properties, de même que les fichiers de configuration pour la base de données et les logs d erreur. Htmleditors contient le fichier permettant de configurer certaines valeurs propres aux différents éditeurs HTML installés. Reportez vous à la section Editeurs HTML du chapitre Gestion de sites sous Jahia pour en savoir plus. Ldap contient les fichiers de configuration pour établir la connexion à un annuaire LDAP. Vous trouverez plus d informations sur les connections LDAP plus bas dans ce même chapitre. Slide contient les fichiers pour configurer le stockage des fichiers. 11. content : les informations qui ne sont pas stockées dans la base de données sont stockées ici. Le répertoire Slide contient tous les fichiers transférés (upload) sur le serveur via les interfaces Jahia ou via votre client webdav. Le répertoire bigtext contient toutes les données des champs de type Texte Long (bigtext). 12. db : les scripts de création de base de données pour créer le schéma et se connecter aux bases se trouvent dans ce répertoire. 13. dbdata : si vous utilisez la base embarquée HypersonicSQL le contenu de la base sera stocké ici. 14. new_templates : Si vous souhaitez déployer de nouveaux templates dans un site virtuel existant, copier votre fichier.jar contenant vos templates dans le sous répertoire correspondant au site virtuel en question. Pour savoir comment créer un fichier.jar prêt à déployer, référez vous au chapitre Questions Fréquemment Posées. 15. new_webapps : Si vous souhaitez déployer une nouvelle application web dans un site virtuel, copiez simplement le fichier.war ou.ear de cette application dans le sous répertoire correspondant à votre site virtuel. 16. search_indexes : Lorsque le moteur de recherche indexe votre site, le fichier d'index est stocké dans ce répertoire. Vous n'avez besoin de lancer une indexation manuellement que lorsque vous venez d'installer Jahia (première initialisation de Lucene). Après cette première indexation, le contenu de votre site est automatiquement indexé. Lorsque vous créez de nouveaux sites virtuels, ils seront également indexés automatiquement.

73 I p73/ shared_components : Chaque fois que vous déployez un nouveau site virtuel, les applications web placées dans ce répertoire seront automatiquement déployées dans ce site. 18. shared_templates : Les packages de templates que vous placez dans ce répertoire seront disponibles lorsque vous déciderez de déployer un nouveau site virtuel. 19. work : Ce répertoire contient une version compilée (par exemple simple_jsp.class) et une version lisible (par exemple simple_jsp.java) de vos templates, ou des templates des interfaces d administration Jahia, si vous n utilisez pas les interfaces pré compilées. Ceci peut se révéler utile en cas d erreur sur un template apparaissant dans les traces de Tomcat, par exemple : sitemap_jsp.java:984: illegal start of expression. Si vous voulez être certain que tous les fichiers jsp décrivant les templates sont bien recompilés après une modification, vous pouvez éventuellement effacer le répertoire Standalone situé dans le répertoire Work. Au prochain accès à une page, Tomcat recompilera tous les jsp utilisés par cette page. Une telle opération est cependant rarissime, dans la mesure où il suffit normalement de passer du mode «en ligne» au mode «édition» pour forcer Tomcat à prendre en compte un changement effectué sur un fichier jsp. 2. CONFIGURATION AVANCÉE DES BASES DE DONNÉES Jahia est livré par défaut avec une base de données embarquée : HyperSonicSQL. Si vous souhaitez commencer rapidement à développer votre projet Jahia, vous pouvez utiliser cette base de données telle quelle s installe par défaut. Il est très fortement conseillé de changer de base de données avant tout passage en production, HyperSonicSQL n étant pas prévu pour supporter ni des gros volumes de données, ni de fortes charges. Vous verrez plus loin qu il est très simple de transférer le contenu de votre base de données d un SGBD à un autre. Les réglages par défaut de Jahia permettent de travailler avec HyperSonic, PostgreSQL, MySQL, Microsoft SQL Server et Oracle. D autres bases peuvent être ajoutées manuellement au besoin (voir plus bas). 2.1 MYSQL L adresse de la base par défaut (chaîne de connexion) pour MySQL est : jdbc:mysql://localhost/jahia?useunicode=true&characterencoding=utf-8 Où localhost doit être remplacé par l url complète d accès à la base (mysql.mydomain.com) ou l adresse IP du serveur MySQL si celui ci n est pas présent sur la même machine que le serveur Jahia. Où jahia est le nom de la base par défaut dans laquelle les tables jahia seront crées. Si votre serveur MySQL ne répond pas sur le port standard (3306), vous devez ajouter :port après le nom de la base, en remplaçant port par le numéro de port correct. 2.2 POSTGRESQL L adresse de la base par défaut (chaîne de connexion) pour PostgreSQL est :

74 I p74/102 jdbc:postgresql:jahia Où jahia est le nom de la base par défaut dans laquelle les tables jahia seront crées. Si votre serveur PostreSQL est situé sur une machine distante et/ou répond sur un port autre que le port par défaut (5432) l URL de la base doit être de la forme suivante : jdbc:postgresql://host:port/database Assurez vous que votre serveur PostgreSQL accepte les connections. Reportez vous à la documentation de votre SGBD pour prendre connaissance des instructions détaillées pour configurer postgresql afin qu il accepte les connections TCP. 2.3 ORACLE Jahia est livré également avec un driver JDBC pour Oracle. Ce driver fonctionne avec Oracle 9i et 10g. L adresse par défaut (chaîne de connexion) pour Oracle est : jdbc:oracle:thin:@localhost:1521:jahia où localhost doit être remplacé par le nom de domaine complet (oracle.mydomain.com) un l adresse IP du server Oracle s il n est pas situé sur la même machine que le serveur Jahia où jahia est le nom par défaut de la base de données dans laquelle les tables de Jahia sont créées. Le port 1521 est le port standard utilisé par Oracle. Si votre serveur Oracle est configuré pour répondre sur un autre port, vous devez changer ce paramètre sans la chaîne de connexion. 2.4 MICROSOFT SQL SERVER (JTDS JDBC DRIVERS) Jahia fournit également un driver JDBC pour MS SQL Server 6.5, 7.x et 2000 développé au sein du projet jtds. Les drivers jtds sont basés sur le travail du FreeTDS project. Vous pouvez trouver plus d informations à ce propos sur L adresse par défaut (chaîne de connexion) pour Microsoft SQL Server est : jdbc:jtds:sqlserver://localhost/jahia où localhost doit être remplacé par le nom de domaine complet (sqlserver.mydomain.com) un l adresse IP du server MS SQL s il n est pas situé sur la même machine que le serveur Jahia où jahia est le nom par défaut de la base de données dans laquelle les tables de Jahia sont créées. Le port 3306 est le port standard utilisé par MS SQL. Si votre serveur MS SQL est configuré pour répondre sur un autre port, vous devez ajouter :port après l adresse de la base de données, en remplaçant port par le numéro de port utilisé par votre base jdbc:jtds:sqlserver://localhost:port/jahia D autres drivers JDBC sont disponibles gracieusement auprès de Microsoft, mais ne peuvent pas être fournis directement avec Jahia en raison de la politique de licence de Microsoft.

75 I p75/102 Ces drivers ne fonctionnent qu avec SQL Server 2000 et peuvent être obtenus à l adresse : Les fichiers.jar téléchargés doivent être placés dans le dossier : TOMCAT_HOME/webapps/jahia/WEB-INF/lib/ Vous devez alors également modifier le script de création de base de données. Le script fourni par défaut avec Jahia se trouve dans le répertoire : TOMCAT_HOME/webapps/jahia/WEB-INF/var/db/sqlserver_tds.script Modifiez les lignes suivantes dans le fichier sqlserver_tds.script: par : jahia.database.name = SQL Server jtds JDBC Drivers jahia.database.driver = net.sourceforge.jtds.jdbc.driver jahia.database.url = jdbc:jtds:sqlserver://localhost:1433/jahia jahia.database.name = SQL Server 2000 MS JDBC Drivers jahia.database.driver = com.microsoft.jdbc.sqlserver.sqlserverdriver jahia.database.url = jdbc:microsoft:sqlserver://localhost/jahia Puis sauvegardez le fichier sous un nouveau nom. Ces nouvelles options seront automatiquement disponibles dans le menu déroulant de l interface d administration «Réglages de la base de données» au prochain redémarrage de Jahia. 3. CONFIGURATIONS AVANCÉES POUR L AUTHENTIFICATION (SERVEUR LDAP) Jahia peut se connecter à un serveur LDAP existant dans le but de gérer une authentification unique (single-sign on). Vous pouvez même utiliser un serveur LDAP conjointement avec le système interne de gestion des utilisateurs de Jahia. Cela peut s avérer utile si vous souhaitez que des utilisateurs non référencés dans le serveur LDAP puissent accéder à votre site jahia (par exemple, des partenaires ou des clients, qui accéderaient à votre extranet) tandis que vos collaborateurs sont, eux, bien référencés dans votre serveur LDAP. Actuellement, Jahia a été testé avec succès avec OpenLDAP et Microsoft ActiveDirectory (qui est un serveur LDAP), mais devrait fonctionner correctement avec n importe quel autre serveur LDAP, considérant que Jahia n impose pas un schéma particulier. 3.1 FICHIERS DE CONFIGURATION LDAP Pour connecter un serveur LDAP vous devez modifier les fichiers suivants : jahia/web-inf/etc/spring/applicationcontext-services.xml : Dé commenter les 4 sections concernant LDAP: Le bean JahiaUserManagerLDAPProvider

76 I p76/102 <!-- <bean id="jahiausermanagerldapprovider" class="org.jahia.services.usermanager.jahiausermanagerldapprovider" parent="jahiaservicetemplate" factory-method="getinstance"> <property name="cacheservice"> <ref bean="jahiacacheservice"/> </property> <property name="key"> <value>ldap</value> </property> <property name="defaultprovider"> <value>false</value> </property> <property name="readonly"> <value>true</value> </property> <property name="priority"> <value>2</value> </property> </bean> --> L entry qui contient la réference au bean dé commenté précédemment <!-- --> <entry> <key><value>ldap</value></key> <ref bean="jahiausermanagerldapprovider" /> </entry> Le bean JahiaGroupManagerLDAPProvider <!-- <bean id="jahiagroupmanagerldapprovider" class="org.jahia.services.usermanager.jahiagroupmanagerldapprovider" parent="jahiaservicetemplate" factory-method="getinstance"> <property name="cacheservice"> <ref bean="jahiacacheservice"/> </property> <property name="incrementorservice"> <ref bean="jahiaincrementorsdbservice"/> </property> <property name="key"> <value>ldap</value> </property> <property name="defaultprovider"> <value>false</value> </property> <property name="readonly"> <value>true</value> </property> <property name="priority">

77 I p77/102 <value>2</value> </property> </bean> --> L entry qui contient la reference au bean dé commenté précédemment <!-- <entry> <key><value>ldap</value></key> <ref bean="jahiagroupmanagerldapprovider" /> </entry> --> jahia/web-inf/etc/ldap/users.ldap.properties and groups.ldap.properties : Les deux fichiers dans lesquels vous configurez votre connexion vers le serveur LDAP pour les utilisateurs et les groupes sont : users.ldap.properties et groups.ldap.properties. Ils sont placés dans le répertoire suivant : TOMCAT_HOME/webapps/jahia/WEB-INF/etc/ldap/ Les paramètres suivants du fichier users.ldap.properties doivent être définis : users.ldap.url users.ldap.public.bind.dn users.ldap.authentification.mode url : permet de spécifier l'url et le port du serveur LDAP. Généralement, elle se présente sous la forme ldap://host_name:port_number/ public.bind.dn : le DN à utiliser pour se connecter au serveur LDAP avec un niveau de droits suffisant pour pouvoir parcourir ou rechercher l entrepôt de données. authentification.mode : le mode d'authentification à utiliser au niveau du répertoire LDAP. Généralement "simple" mode. Il s'agît d'une configuration LDAP spécifique qui dépend de la configuration de votre serveur LDAP. Si votre serveur LDAP requiert une authentification pour pouvoir naviguer à travers son contenu, dé commentez cette ligne et définissez la propriété suivante : users.ldap.public.bind.password Pour réaliser l association entre les paramètres de recherche de Jahia sur les utilisateurs (tels que prénom, nom) et les propriétés de l annuaire LDAP, vous devez utilisez les paramètres suivants : users.ldap.username.attribute.map users.ldap.firstname.attribute.map users.ldap.lastname.attribute.map users.ldap. .attribute.map users.ldap.organization.attribute.map

78 I p78/102 Si la recherche ne spécifie pas de JahiaUser ou un autre attribut sur lequel chercher, la propriété suivante est utilisée pour savoir sur que attributs LDAP construire les filtres de recherche : users.ldap.search.wildcards.attributes Le nombre maximum de résultats retournés par l annuaire peut être configuré en utilisant la propriété : users.ldap.search.countlimit Vous devez modifier les paramètres similaires dans groups.ldap.properties si vous souhaitez utiliser les groupes LDAP dans Jahia. 4. MODIFIER LE NIVEAU DES TRACES (LOGS) Lorsque vous installez une version release de Jahia (par opposition à une extraction CVS), le niveau des traces est place au minimum pour éviter de ralentir Jahia. Si vous avez besoin d augmenter le niveau de traces produites, pour des besoins de corrections d erreurs de développement par exemple, vous devez modifier le fichier log4j.xml qui se trouve dans le répertoire : TOMCAT_HOME/webapps/jahia/WEB-INF/etc/config Log4J définit les niveaux de traces de la façon suivante (de la plus verbeuse à la moins étendue): ALL < DEBUG < INFO < WARN < ERROR < FATAL < OFF A la fin du fichier se trouve la partie <root>... </root>. Changez <priority value="info"/> en <priority value="debug"/> pour obtenir plus d informations dans la console. Vous pouvez également changer ce réglage pour certaines parties de Jahia comme Slide ou pdfbox. Vous pouvez également ajouter votre propre journal de traces sur un ensemble de classes spécifique, par exemple : <category name="org.apache.axis"> <priority value="info"/> </category> Par défaut, les traces sont produites sur la console. Sous Windows, les traces sont affichées dans la fenêtre DOS dans laquelle Tomcat est exécuté. Sous Linux, les traces sont produites dans le fichier catalina.out. Jahia utilisant Apache log4j pour gérer son système de traces, vous pouvez utiliser des outils tels que Chainsaw (sous ensemble du projet log4j) pour améliorer le confort de travail sur les messages du journal. Il est permet de changer à la volée le niveau des traces sans avoir à arrêter et relancer Jahia. Ceci est très utile lorsque vous avec besoin d étendre temporairement le niveau d informations produites sur un serveur en production, mais ne voulez pas causer d interruption de service. Jahia vérifie tout changement au niveau du fichier log4j.xml toutes les 60 secondes. N oubliez pas de faire le changement inverse une fois les traces obtenues, l augmentation du niveau des traces dégradant de façon très significative les performances globales de l application.

79 I p79/ CONFIGURATIONS AVANCÉES DU SERVEUR D APPLICATION JAVA Jahia a été développé avec approche neutre vis-à-vis des éditeurs tiers, afin de fonctionner avec la plupart des serveurs d application J2EE. Par défaut, Jahia est développé et testé avec le servlet Apache Tomcat qui est l implémentation de référence. Toutes les fonctionnalités de Jahia sont disponibles sur cette plateforme. Utiliser la couche CMS de Jahia sur un autre serveur d application ne devrait demander que des modifications mineures. A titre d exemple, plusieurs utilisateurs de Jahia font fonctionner l application sous BEA Weblogic ou IBM Websphere. Vous trouverez ci-après différents conseils pour améliorer les réglages de Tomcat. Veuillez noter que le journal de traces (logs) est susceptible d utiliser un important espace de stockage sur disque sur le mode DEBUG est utilisé. Suivant l espace disque disponible sur votre serveur il peut être intéressant de vérifier l espace disponible et de nettoyer les traces sur des bases régulières. 5.1 APACHE TOMCAT OPTIMISATION Si vous souhaitez allouer plus de mémoire au process java sur lequel Tomcat s'exécute, vous pouvez effectuer des modifications au niveau de Tomcat pour spécifier le minimum et le maximum de mémoire utilisable par l'application (la zone mémoire réservée à l'usage exclusif de la Machine Virtuelle Java). Augmenter la mémoire allouée peut être une bonne idée sachant que Java produit une erreur java.lang.outofmemory si la mémoire est saturée. Pour effectuer cette opération, ouvrez le fichier catalina.sh (Linux) ou catalina.bat (Windows) et ajoutez la ligne suivante en tête de fichier, juste après les lignes commentées : CATALINA_OPTS="-XmsINITSIZEm -XmxMAXSIZEm" Où INITSIZE est la mémoire allouée au démarrage en MegaBytes Où MAXSIZE est la mémoire maximum autorisée en MegaBytes. Si cette ligne n'est pas ajoutée, la valeur INITSIZE par défaut est de 32 et la valeur MAXSIZE est de 128. Définir une taille mémoire initiale (INITSIZE) plus importante permettra de moins utiliser les mécanismes de ramasse-miettes (garbage collection) ce qui est plus efficace. La valeur du paramètre MAXSIZE dépend bien sûr de la mémoire totale disponible sur votre système, et ne dois bien évidemment pas excéder celle-ci. La valeur MAXSIZE recommandée doit se situer entre 1/2 et ¾ de la mémoire physique du système. Nous avons déterminé que le réglage suivant fonctionnait relativement bien sur un système disposant de 512 Mb : CATALINA_OPTS="-Xms64m -Xmx384m" 5.2 CHANGER LES PORTS HTTP SUR LEQUEL JAHIA EST À L ÉCOUTE Par défaut, Jahia est livré avec Tomcat configuré pour répondre aux requêtes HTTP sur le port Il s'agît d'une mesure de précaution sachant que certains serveurs peuvent déjà avoir des applications web tournant sur le port HTTP standard (port 80) Pour modifier le port d'écoute de Tomcat, ouvrez le fichier suivant :

80 I p80/102 TOMCAT_HOME/conf/server.xml Autour de la ligne 76, dans la section intitulée "Define a non-ssl HTTP/1.1 Connector", vous trouverez la définition suivante : <connector classname="org.apache.catalina.connector.http.httpconnector" port="8080" minprocessors="5" maxprocessors="75" enablelookups="true" redirectport="8443" acceptcount="10" debug="0" connectiontimeout="60000"/> Remplacez la valeur du port indiquée par celle que vous souhaitez utiliser pour faire tourner Jahia. Si vous ne voulez pas que Tomcat procède à des reverse lookups (au cas où vous soyez derrière un firewall qui filter ce type de requêtes par exemple), spécifiez la valeur du paramètre enablelookups à "false". Modifiez également dans la partie URL's du fichier jahia.properties (TOMCAT_HOME/webapps/jahia/WEB/INF/etc/config/) au niveau de la ligne 88 le paramètre suivant : jahiawebappsdeployerbaseurl = http\://localhost\:8080 et remplacez le port 8080 par celui que vous désirez. Notez qu au redémarrage de Jahia, le script de démarrage essayera toujours d atteindre Jahia sur le port 8080, vous devrez donc saisir la nouvelle URL manuellement dans votre navigateur. Par exemple, si vous avez défini le port 80 comme nouveau port de réponse de Tomcat, l URL correcte sera désormais : Vous pouvez modifier les scripts bin/jahia.bat ou bin/jahia.sh pour intégrer votre modification de port et faire en sorte que le script lance automatiquement votre navigateur vers la bonne URL. Vous devrez également changer les fichiers HTML suivants : TOMCAT_HOME/webapps/jahia/html/startup/launch_jahia.html TOMCAT_HOME/webapps/jahia/html/startup/launch_admin.html Tomcat est également à l écoute sur un port particulier pour recevoir ses ordres d interruption. Ce port est, par défaut, le Il n existe pas de raison particulière pour changer cette configuration, à moins que ce port ne soit déjà utilisé par une autre application, ou si vous avez plusieurs Tomcats exécutés sur la même machine. Pour changer ce port, recherchez la ligne qui suit au début du fichier server.xml : <Server port="8005" shutdown="shutdown" debug="0"> Et changez la valeur du paramètre Server port. 5.3 MISE À JOUR DU SERVEUR D APPLICATION TOMCAT Si vous souhaitez mettre à jour le serveur d application Tomcat ou installer Jahia dans une installation de Tomcat indépendante, vous devrez effectuer plusieurs changements. Les fichiers de démarrage suivants doivent être copiés du Tomcat fourni avec Jahia vers le Tomcat souhaité : - bin\catalina.sh - bin\catalina.bat - bin\setclasspath.bat

81 I p81/102 - bin\setclasspath.sh Les librairies suivantes doivent être copiées du Tomcat fourni avec Jahia vers le Tomcat souhaité : - common\ endorsed\dom3-xercesimpl jar - common\ endorsed\ dom3-xmlparserapis jar - all librairies in shared\lib\ - the «org» directory and subdirectories in shared\classes\ Le fichier suivant doit être copié du Tomcat fourni avec Jahia vers le Tomcat souhaité : - conf\catalina\localhost\jahia.xml Les fichiers de configuration de Tomcat suivants doivent être mis à jour : - conf\context.xml : remplace <Context> with <Context antijarlocking="true"> au début du fichier. - conf\server.xml : pour les non SSL HTTP/1.1 connector et pour le 1.3 Connector AJP, ajouter le paramètre suivant à la fin du tag : emptysessionpath="true". The HTTP Connector ressemblera à: <Connector port="8080" maxhttpheadersize="8192" maxthreads="150" minsparethreads="25" maxsparethreads="75" enablelookups="false" redirectport="8443" acceptcount="100" connectiontimeout="20000" disableuploadtimeout="true" emptysessionpath="true"/> et le connector AJP : <Connector port="8009" enablelookups="false" redirectport="8443" protocol="ajp/1.3" emptysessionpath="true"/> Vous devez enfin copier l application web Jahia en copiant le répertoire webapps/jahia de l installation par défaut vers l installation souhaitée. 5.4 LE FICHIER DE CONFIGURATION JAHIA.PROPERTIES La plupart des informations de configuration de Jahia sont stockées dans un fichier appelé jahia.properties. Ce fichier se trouve dans le répertoire suivant : TOMCAT_HOME/webapps/jahia/WEB-INF/etc/config Certaines de ces configurations peuvent être modifiées directement via le panneau d'administration de Jahia (web), mais certaines ne peuvent être modifiées qu'en éditant manuellement ce fichier. Nous allons parcourir ces paramètres pour comprendre leur utilité et voir en quoi il est possible de les modifier.

82 I p82/102 ### Server ########################## release = server = Tomcat serverhomediskpath = C\:\\Jahia\\ jahia5.0\\tomcat\\ Le paramètre serverhomediskpath indique le répertoire d installation de Tomcat (ici, sur un système Windows). Dans le cas où vous déplaceriez votre répertoire Jahia vers une autre installation de Tomcat, n oubliez pas de changer ce paramètre pour refléter l emplacement du Tomcat utilisé. ### URL's ########################### [...] jahiatemplateshttppath = /jahia/jsp/jahia/templates/ jahiaengineshttppath = /jahia/jsp/jahia/engines/ jahiajavascripthttppath = /jahia/jsp/jahia/javascript/jahia.js jahiawebappsdeployerbaseurl = http\://localhost\:8080 siteidinurl = false Une fois Jahia installé, le répertoire des webapps Jahia est stocké dans les 4 premiers paramètres. Si vous souhaitez modifier le «servlet name» afin de remplacer par par exemple, vous devez effectuer cette modification dans le fichier web.xml de Jahia (voir le fichier /tomcat/webapps/jahia/html/startup/howto_change_jahia_jahia.html pour plus de détails) Le paramètre siteidinurl indique si vous souhaitez imposer l id du site dans l adresse web (par exemple : même si ce n est nécessaire. Par défaut, si le site virtuel peut être identifié via le nom du serveur (par exemple si vous avez indiqué l adresse comme nom de serveur dans l interface d administration des sites virtuels, vous accéderez à votre site par l adresse l id du site n apparaîtra donc pas dans l url. ### Jahia Mail ###################### [...] Toute cette section peut être modifiée via l'interface d'administration web de Jahia. ### Database ######################## db_support_embedded_select_statement = false Cette section est normalement configurée via l interface d administration de Jahia. Toutefois, si vous décidez de passer d une base qui supporte les requêtes SQL imbriquées (sous requêtes), à une base qui ne les supporte pas (par exemple MYSQL < 4.1) vous devez passer ce paramètre de true à false. ### Characters encoding ############## utf8encoding = false defaultresponsebodyencoding = UTF-8 defaulturiencoding = UTF-8 Le paramètre d encodage utf8encoding est défini lors de l installation et ne doit pas être changé. ### Cache settings ################### [...] #max_cached_contentfieldcache = 20000

83 I p83/102 Par défaut, les caches «back-end» n on pas de limite. Si vous souhaitez indiquer une limite, veuillez utiliser la syntaxe suivante : max_cached_cachename = LIMIT ou CACHENAME est le nom du cache correspondant dans l interface d administration «Statut des caches et du serveur» entre parenthèse, et LIMIT est un nombre correspondent au maximum d entrées que vous souhaitez cacher. Vous devrez dé commenter les lignes des caches concernés en effaçant le symbole «#» au début de la ligne. Limiter la taille d un cache peut être très utile dans le cas où vous avez un nombre d élément très élevé dans certains caches, occasionnant des saturations de mémoire sur votre serveur ### Output cache ##################### outputcacheactivated = true # the following value is in milliseconds, set to -1 for no time expiration outputcachedefaultexpirationdelay = -1 Le paramètre outputcacheactivated permet d activer / désactiver l utilisation du cache HTML sur Jahia. Le cache HTML de Jahia conserve en mémoire durant un certain temps (ou jusqu à l extinction du serveur) des copies statiques de chaque page web générée. Ceci améliore considérablement les performances puisqu il aucun accès base de données n est nécessaire et aucun traitement processeur sur les pages mises en cache. Dans certaines circonstances, il se peut que vous souhaitiez toutefois désactiver cette fonctionnalité ; dans ce cas il suffit de placer la valeur du paramètre à false. Si le cache HTML est activé, vous pouvez également spécifier le temps (en millisecondes) de conservation des pages en mémoire, grâce au paramètre outputcachedefaultexpirationdelay. Par exemple, une valeur de indique que les pages stockées dans le cache HTML de Jahia expirent une heure après la génération de la page, qu il y ait eu des accès à la page entre temps ou non. La valeur par défaut est -1, ce qui signifie qu aucun délai d expiration n est appliqué sur les pages dans le cache. Le rafraîchissement du cache HTML peut également être géré page par page, en ajoutant un tout petit peu de code dans les templates. ### ESI fragment-based Output cache ################################# Dans cette section vous trouverez les informations pour configurer votre serveur ESI. Tous les détails sont disponibles dans le fichier howto_esi.html dans votre répertoire /tomcat/webapps/jahia/html/startup/ ### JMS Cache Settings ############### org.jahia.cache.jmscacheactivated = false [...] org.jahia.cache.jmscachecontextproviderurl = rmi\://localhost\:1099/ [...] org.jahia.cache.jmscachetopicname = jahiacache org.jahia.cache.jmsserverlookupsleeptime = Si vous souhaitez connecter Jahia à un serveur de messagerie JMS (comme OpenJMS), vous devez activer l option en définissant à true la valeur du paramètre jmscacheactivated. Vous devrez alors également spécifier l adresse et le port de vers serveur JMS via le paramètre jmscachecontextproviderurl. Le paramètre jmscachetopicname doit refléter le topic déclaré sur votre serveur JMS et le paramètre jmsserverlookupsleeptime définira la fréquence (en millisecondes) de connexion de Jahia vers le serveur JMS.

84 I p84/102 Plus de détails sur ce sujet peuvent être trouvés dans le Clustering Guide de Jahia. ### Template set ######################## default_templates_set = corporate_portal_templates Valueur par défaut du set de template utilisé uniquement dans le module d installation. ### Filemanager ##################### jahiafilerepositorydiskpath = $context/web-inf/var/content/filemanager/ useflatfilemanager = false Configuration du gestionnaire de fichier qui utilise Slide ### Templates Observer ########### jahiatemplatesautodeploy = 1 templates.observer.interval = 5000 templates.observer.checkmode = ALL Cette section configure le service qui vérifie le déploiement de nouvelles templates. ### WebApps Observer ########### jahiawebappsautodeploy = 1 JahiaWebAppsDeployerService = org.jahia.services.webapps_deployer.jahiatomcatwebappsdeployerbaseservice Cette section configure le service qui vérifie le déploiement de nouvelles applications web. ### WebApps Dispatcher ####### webapps.dispatcher.inheritjahiasessionattributes = false Si vous définissez cette variable à vrai, les applications portlets seront capables d accéder aux attributs de sessions initialiser dans les templates. ### Audit log ################# jahiamaxlogs = 500 Valeur par défaut pour le volume de log avant d être effacés. ## Multilingual support ########### org.jahia.multilang.default_language_code = en Ce réglage défini quel code de langue doit être utilisé par défaut lors du déploiement d un nouveau site virtuel. Vous devez définir le code ISO contenant la langue et la région (par exemple fr_ch pour le Français en Suisse) ### ACLs ########################### org.jahia.acl.preload_count = 10000

85 I p85/102 Ce paramètre indique le nombre d objets ACL qui sont chargés au démarrage de Jahia. Plus ce nombre est élevé plus long sera le démarrage, mais plus Jahia sera rapide après, puisqu il sera moins nécessaire d aller chercher les objets ACL sur l instant. ### Workflows states ############# org.jahia.workflow.preload_count = 3 Ce paramètre spécifie le nombre de niveau de hiérarchie de page à pré charger lors du démarrage de Jahia. ### Page properties ################## org.jahia.pages.properties.preload_count = 2000 Ce paramètre indique le nombre d entrées concernant les propriétés des pages que Jahia chargera au démarrage. ### Tidy Configuration file ################### # this file must be located in <jahia>/web-inf/etc/config dir. tidyconfig = tidy.properties Cette section définie l emplacement ou Jahia trouve le fichier de propriétés tidy et s il doit convertir les noms de fichiers chargés dans Jahia (via l interface Jahia ou via l interface client WebDav) et les noms des dossiers créés via le gestionnaire de fichier. Cette fonction sert à éviter d éventuels problèmes avec des noms de répertoires ou de fichiers contenant des caractères non conventionnels (accents, espaces, ponctuation ) particulièrement lorsqu on utilise un client WebDav tel que l explorateur Windows, qui est susceptible de mal comprendre ou mal encoder ces caractères non conventionnels. Par exemple, avec le réglage par défaut, un fichier nommé études élémentaires.doc ne sera pas converti, mais un répertoire nommé études élémentaires sera renommé en etudes_elementaires. Si vous avez des problèmes pour accéder aux fichiers dans le gestionnaire de fichiers Jahia, essayez de mettre les deux paramètres à true. Reportez vous à la page : pour savoir si votre version de la DLL MS WebDAV est bien exempte de bug. ### Jetspeed Portal ############ jetspeedconfig = WEB-INF/etc/jetspeed/conf/jetspeed.properties jetspeeddeploymentdirectory = $context/web-inf/etc/jetspeed/deploy Configuration pour Jetspeed JSR-168 ### Authentification pipeline ########## authpipelinefilename = /WEB-INF/etc/config/auth-pipeline.xml authpipelineclassname = org.jahia.pipelines.impl.genericpipeline Jahia utilise maintenant un mécanisme pour l authentification qui permet aux développeurs d étendre le système pour se connecter à des systèmes d authentifications personnalisées. ### Process pipeline ################ processpipelinefilename = /WEB-INF/etc/config/process-pipeline.xml processpipelineclassname = org.jahia.pipelines.impl.genericpipeline

86 I p86/102 Jahia utilise maintenant un mécanisme pour traiter les requêtes qui permet aux développeurs d étendre le système pour traiter des traitements spécifiques. ### Cookie authentification valve config ######## [...] cookieauthidlength = 40 [...] cookieauthmaxageinseconds = [...] cookieauthrenewalactivated = true Jahia supporte l authentification par cookie. Lorsque vous vous authentifiez sous Jahia vous pouvez cocher la case «se souvenir de moi» et un cookie est alors stocké sur votre ordinateur. La longueur du cookie dépend de la valeur du paramètre cookieauthidlength, qui est définie par défaut à 40 caractères. Jusqu à expiration du cookie, vous serez automatiquement authentifié lorsque vous accédez à votre site géré par Jahia. Cependant, si vous vous authentifiez sous le même compte depuis un autre ordinateur ou avec un autre navigateur et que vous cochiez également la case «se souvenir de moi», le premier cookie sera invalidé. La durée d expiration du cookie est définie par le paramètre cookieauthmaxageinseconds. Le réglage par défaut est fixé à seconds soit un délai d expiration de 14 jours. Chaque fois que vous accédez au site géré par Jahia, un nouveau cookie sera envoyé et le temps d expiration remis à zéro à partir de cette visite. Si vous ne vous connectez pas pendant plus de 14 jours par contre, vous devrez vous authentifier à nouveau par saisie de votre nom d utilisateur et de votre mot de passe. Si vous ne souhaitez pas que le délai d expiration soit systématiquement remis à zéro à chaque connexion sur le site géré avec Jahia, vous pouvez passer le paramètre cookieauthrenewalactivated à false. Toutefois cela signifie que vos visiteurs vont devoir s authentifier manuellement en saisissant leurs informations d authentification tous les 14 jours, ou toute autre durée que vous aurez spécifiée pour le paramètre cookie-authmaxageinseconds. ## Logoff Redirect ################## #logoutredirecturl = Dé commenter ce champ pour passer outre la façon standard de se déconnecter dans Jahia et rediriger l utilisateur vers l URL de votre choix ### Scheduler config #### schedulerconfigfile = $context/web-inf/etc/config/quartz.properties ramschedulerconfigfile = $context/web-inf/etc/config/quartz-ram.properties Chemin pour la programmation de la configuration. La programmation est souvent utilisée, notamment pour traiter les travaux en fond de tache comme les imports XML ou le processus de validation, etc ### Default site ####### defautsite = mysite Ce paramètre permet de définir quel site virtuel sera affiché par défaut. ### Site servername testing config #######

87 I p87/102 siteservernametesturlexpr = ${request.scheme}\://${siteservername}\:${request.serverport}${request.contextpath}/jsp /isjahia.jsp siteservernametestconnecttimeout = 500 siteurlportoverride = 0 ### Cluster settings ######## Dans cette section vous trouverez les informations pour configurer votre application en cluster. Tous les détails sont disponibles dans le fichier howto_esi.html dans votre répertoire /tomcat/webapps/jahia/html/startup/ ### Chat settings ############### chatserver.activated = false chatserverip = Si vous utilisez une configuration en cluster, vous devez définir le paramètre chatserver.activated à vrai. Dans ce cas la, le paramètre chatserverip doit être défini avec l IP local. ### Workflow settings ################ workflowmaxnotification s = 20 workflownotifyadminonmaxnotificationreached = true workflowmaxnotificationreachedtemplate = workflow_maxnotif.groovy Ces paramètres définissent le nombre maximum d alertes s à envoyer en cas de problèmes durant le processus de validation. Cela permet de limiter le spam, cependant le paramètre workflownotifyadminonmaxnotificationreached permet de définir si l administrateur doit être averti après la limite atteinte. ### Statistics settings ##### statisticsenabled = true Ce paramètre permet d activer la fonctionnalité de statistiques disponible dans l interface administration de Jahia. ## Time-based publishing ###### showtimebasedpublishingicons = true Ce paramètre permet d activer l affichage des actions concernant la publication planifié. ### Development Mode ######## developmentmode = false Ce paramètre peut être utilisé pour activer le mode développement qui efface le cache html à chaque fois que vous changer le mode d affichage (de l onglet En Ligne à l onglet Editer) ### AES settings ###### timebased_display = false workflow_display = true chat_display = true process_display = true

88 I p88/102 Tous ces paramètres peuvent être définis via l interface d administration de Jahia dans la section Réglages Edition. ### custom errordocument site property ########## #site.error.enabled = true Ce paramètre permet de définir une page d erreur spécifique pour chaque site. Si vous l utilisez vous devrez créer un répertoire d erreur qui contiendra votre page d erreur errordocument.jsp. ### Connection Timeout For Production Job ####### connectiontimeoutforproductionjob = Ce paramètre vous permet de spécifier le délai d expiration pour connecter votre instance de Jahia à une instance distante. Le temps est en millisecondes.

89 I p89/102 CHAPITRE 5 : MAINTENANCE DE JAHIA Dans ce chapitre sont présentées les notions clés de la maintenance et de la mise à jour d un serveur Jahia. 1. COPIES DE SECOURS / MIGRATION DE L ENVIRONNEMENT DE DÉVELOPPEMENT À L ENVIRONNEMENT DE PRODUCTION Pour prévenir ou minimiser tout risque de perte de données stockées dans Jahia, des procédures régulières de sauvegarde peuvent (doivent) être mises en place. Les mêmes procédures peuvent être utilisées pour migrer d un serveur de développement à un serveur de production. Si vous souhaitez procéder à des sauvegardes régulières (disons une sauvegarde quotidienne durant la nuit, par exemple), vous pouvez copier les fichiers et la base de données avec des outils externes à Jahia. Vous n avez pas besoin de sauvegarder la totalité de l installation Jahia mais uniquement les données, afin de minimiser le temps de sauvegarde. Voici la liste des éléments qui doivent être sauvegardés : 1.1 BASE DE DONNÉES Quasiment tous les SGBD proposent leurs propres outils pour effectuer des sauvegardes de contenu sans avoir à interrompre leur exécution. Les bases de données comme MS SQL Server ou Oracle proposent des outils de la sorte avec en plus des options de planification. Pour d autres bases de données comme Postgres ou MySQL, des programmes sont disponibles qui permettent de réaliser des dump de sauvegarde dans des fichiers texte. Ces programmes, en coordination avec les fonctions de planifications de tâches de votre système d exploitation vous donnent la possibilité de mettre en place un système de sauvegarde régulière automatisée. Par exemple, si vous voulez réaliser un dump du contenu Jahia stocké dans une base MySQL, vous pouvez utiliser la syntaxe suivante : mysqldump database_name > filename ou, plus concrètement : mysqldump jahia > jahia.sql Il est possible que vous deviez ajouter des informations telles que le nom d utilisateur et un mot de passe pour effectuer ce type d opérations avec cette base de données. 1.2 FICHIERS DE DONNÉES JAHIA Certains contenus sont stockés par Jahia dans des fichiers sur disque, comme le contenu des champs BigText, ou les fichiers externes (pdf, word, excel ) chargés dans Jahia. Voici le dossier que vous devez sauvegarder : TOMCAT_HOME/webapps/jahia/WEB-INF/var/content/

90 I p90/102 Ce répertoire contient notamment le répertoire slide qui contient lui-même tous les fichiers envoyés dans Jahia, et le répertoire bigtext. 1.3 MODELES DE PAGES JAHIA (TEMPLATES) Les templates Jahia ne changent pas, théoriquement, très souvent sur un serveur en production, c est pourquoi il n est pas obligatoire de les sauvegarder quotidiennement. Ils sont situés à l emplacement suivant : TOMCAT_HOME/webapps/jahia/jsp/jahia/templates/ Ce répertoire contient tous les templates utilisés par tous les sites virtuels, de même que les images utilisées directement dans les templates. 1.4 WEB APPLICATIONS / PORTLETS Si vous n utilisez aucune portlet sur votre serveur Jahia, vous pouvez passer ce passage. Toutes les webapps de Jahia sont placées par défaut à cet emplacement : TOMCAT_HOME/webapps/ Le nom du répertoire de chaque webapp contient le nom de l application. Elles sont accessibles à travers n importe quel site virtuel. Vous pouvez sauvegarder toutes les webapps, ou seulement celles que vous utilisez. Si vous avez installé d autres webapps que celles fournies par défaut avec Jahia, assurez vous de l emplacement ou elles sont déployées et ou leur contenu est stocké afin de pouvoir convenablement sauvegarder celui-ci. 1.5 FICHIERS DE CONFIGURATION Il existe certains fichiers de configuration que vous pouvez souhaiter sauvegarder également. Le répertoire contenant toutes les configurations de Jahia est le suivant : TOMCAT_HOME/webapps/jahia/WEB-INF/etc/ Le répertoire dans lequel les configurations de Tomcat sont stockées est le suivant : TOMCAT_HOME/conf/ 2. SUPERVISION Comme Jahia est un système complexe utilisant de multiples briques, il peut être souhaitable de mettre en place des outils de supervision pour vérifier le fonctionnement du serveur d application, du serveur http, de la base de données, de la place disponible sur disque, de la mémoire vive disponible... Des outils open source et gratuits sont disponibles tel Nagios ( pour vérifier la disponibilité et/ou l état de ces différents services. Des alertes peuvent être transmises par , pager ou d autres méthodes définies par l utilisateur.

91 I p91/102 CHAPITRE 6 : OPTIMISATION DE JAHIA Améliorer les performances d'un serveur Jahia 1. AMÉLIORER LES PERFORMANCES DE JAHIA Jahia est fortement dépendant des couches technologiques sous-jacentes sur lesquelles il repose pour fournir des performances optimales. Certaines de ces couches sous-jacentes peuvent être remplacées ou optimisées pour obtenir de meilleurs résultats. 1.1 JAVA JDK :Différentes versions de la Machine Virtuelle Java sont disponibles. Vous pouvez vous reporter au rapport Volano ( pour obtenir plus de détails et des indicateurs de performances sur les différentes JVM. SUN: C'est la JVM par défaut, sur laquelle Jahia est testé. Elle est disponible pour la plupart des plateformes. La dernière version en date et testée est la 1.5 et peut être téléchargée sur : IBM: La JVM développée par IBM procure des améliorations significatives sur celle de SUN jusque dans sa version 1.3.1, mais cela n'est pas aussi évident pour les versions plus récentes. La dernière version de la JVM IBM est la La machine virtuelle Java développée par IBM apporte des améliorations significatives par rapport à celle de Sun, tout au moins jusqu à la version 1.3.1, mais cela n est plus aussi net pour les versions plus récentes. La version la plus récente est la mais elle n est disponible ni pour Solaris, ni pour Windows, uniquement pour linux. BEA: JRockit 8.1 est un JVM optimisée pour les processeurs Intel de moyen /haut de gamme (2 processeurs et plus) qui apporte des améliorations de performances significatives par rapport à la JVM de SUN. JRockit 8.1 est certifiée compatible OPTIMISATION DE LA BASE DE DONNÉES Jahia est fortement dépendant des performances de la base de données sur lequel il repose. Des optimisations peuvent être réalisées sur celle-ci pour améliorer les performances globales. Installer la base de données sur un serveur séparé En installant Jahia et la base de données sur deux serveurs séparés (ou sur un serveur bi- processeur) la charge est mieux répartie en cas de gros trafic. Il est cependant important que les deux serveurs soient installés sur le même réseau local ou reliés par une connexion rapide afin de ne pas impacter négativement les performances. Utiliser des index sur les bases de données Jahia supportant de multiples bases de données, aucune optimisation n a été prévue par défaut dans les fichiers de création des modèles de base de Jahia. Il est ainsi possible d obtenir des améliorations de performances très significatives en plaçant des index sur votre base de données, particulièrement dans le cas de sites comportant un grand nombre de pages et de nombreux objets.

92 I p92/102 Jahia SQL Profiler D autres index peuvent être utiles, en fonction du type d objets stockés dans votre base de données et la façon dont vos templates et vos sites sont structurés. Pour définir quels index seraient les plus utiles sur votre serveur Jahia, vous pouvez utiliser l outil SQL Profiler développé pour cela. Celui-ci identifie quels index amélioreront le plus les performances de Jahia (ou n importe quelle application utilisant une base de données, par ailleurs) et génèrera le script SQL adéquat pour créer les index en question. Vous pouvez télécharger l outil à l adresse suivante : Lisez le prochain paragraphe pour connaître en détail le maniement du SQL Profiler. Qu'est ce que Jahia SQL Profiler? Jahia SQL Profiler est un outil générique pour établir des statistiques sur des requêtes de type SELECT qui permet de déterminer où des gains de performances peuvent être obtenus en indexant certaines données. Ce petit outil, mis à disposition sous une licence de type Apache, se connecte au P6Spy JDBC logger Et affiche en temps réel les requêtes envoyées à la base de données. Il utilise un parseur SQL intégré pour produire des statistiques sur les tables et les colonnes les plus utilisées. Il peut en outre créer un fichier contenant les requêtes d'indexation SQL adéquates. D'autres informations sont également recueillies et affichées, comme le temps d'exécution d'une requête pour une requête donnée, pour une classe de requêtes ou pour toutes les requêtes. Des tris peuvent être réalisés sur ces données pour déterminer les éventuels problèmes de performance de la base de données. Cet outil peut être très utile quand vous avez un grand nombre de requêtes à analyser, non pas une à une mais plutôt par groupes de requêtes, par exemple les requêtes adressées à une même table et les mêmes colonnes mais avec des valeurs différentes. Le parseur SQL intégré (construit avec ANTLR) est utilisé pour analyser les requêtes entrantes de type SELECT. Pré requis Afin d utiliser cet outil de façon efficace, vous devez configurer votre application JDBC pour l utilisation du «P6Spy pass-thru driver». La distribution de l outil inclus un exemple de fichier de configuration «spy.properties» contenant les paramètres par défaut de connexion vers le SQL Profiler socket. Packages binaires Le logiciel est disponible sous une forme de binaire pré compilé. Utilisez le lien suivant: Lancer SQL Profiler avec P6Spy Vous devez tout d abord installer P6Spy sur le système que vous souhaité optimiser. P6Spy est un très bon «pass-thru JDBC driver» permettant d identifier toutes les requêtes passant par une connexion JDBC et est compatible avec un grand nombre de système. De même, par extension, pour SQL Profiler. Vous devez télécharger P6Spy sur ou sur la page concernant SQL Profiler. Récupérez le fichier p6spy.jar à partir de l archive et copiez le dans le répertoire suivant :

93 I p93/102 TOMCAT_HOME/webapps/jahia/WEB-INF/lib Afin de vous aider pour le paramétrage, un exemple de fichier de configuration «spy.properties» est disponible avec le SQL Profiler. Utilisez ce fichier en remplacement du fichier fourni avec P6Spy et copiez le dans le répertoire suivant : TOMCAT_HOME/webapps/jahia/WEB-INF/classes Modifiez le fichier et regarder la section «REALDRIVER». Ceci vous permet de configurer le connecteur de base de données utilise par Jahia. Des paramètres sont fournis pour plusieurs bases de données ((PostgreSQL, MySQL, Oracle,...) mais, par défaut, le connecteur utilisé est celui de MySQL comme l indique la ligne suivante : # the mysql open source driver realdriver=org.gjt.mm.mysql.driver Si vous souhaitez utiliser un autre connecteur, mettez en commentaire cette ligne et dé commentez celle mentionnant le connecteur de base de données que vous souhaitez utiliser. Dans le cas où le connecteur n est pas mentionné, vous pouvez ajouter une nouvelle ligne «REALDRIVER» mentionnant le connecteur à utiliser. Par exemple, si vous utilisez hypersonicsql, vous devez trouver cette ligne dans le fichier «jahia.properties» : db_driver = org.hsqldb.jdbcdriver Copiez ce connecteur dans le fichier «spy.properties» de la façon suivante: #HypersonicSQL database driver realdriver=org.hsqldb.jdbcdriver et placez en commentaire tous les autres connecteurs. Ensuite, remplacer la valeur «db_driver» dans le fichier «the jahia.properties» par le connecteur P6Spy : db_driver = com.p6spy.engine.spy.p6spydriver La configuration est maintenant terminée. Vous pouvez maintenant lancer le SQL Profiler et démarré votre serveur Jahia. Vous devez lancer SQL Profiler AVANT de lancer Jahia. Afin de lancer l interface graphique, lancez la ligne de commande suivante : java -jar sqlprofiler.jar Utiliser l interface L interface démarre automatiquement en mode «display», signifiant que dès la connexion établie avec la source P6Spy, l interface sera actualisée toute les secondes, présentant l ensemble des nouvelles requêtes envoyées à la base de données. Le bouton «Play» est désactivé lors du démarrage car nous sommes déjà en mode «Play». Si vous cliquez sur Pause, le SQL Profiler vous présentera l ensemble des statistiques concernant les requêtes accumulée depuis le lancement de l interface ou le dernier redémarrage. Dans la zone inférieure, vous verrez les statistiques de toutes les requêtes présentées dans la zone supérieure. En cas de pause, l interface n est plus mise à jour but les requêtes sont toujours prises en compte en tâche de fond. En sélectionnant le bouton Play, vous pouvez relancer la mise à jour de l interface afin de voir à nouveau

94 I p94/102 les requêtes mises à jour toutes les secondes. Notez que lorsque vous revenez au mode «Play», le panneau présente les derniers résultats issus de la pause afin de les garder présent et voir les statistiques plus longtemps. Le bouton «reset» (le 2 ème en partant de la gauche) effectue une purge de l ensemble des requêtes en mémoire. Il est en effet assez pertinent de purger le buffer et analyser une séquence de requêtes spécifiques en base de données. Dans le cas d une application web, vous pouvez effectuer les actions suivantes : 1. Démarrer l interface 2. Démarrer Jahia 3. Actionner le bouton «reset» 4. Effectuez une requête sur Jahia 5. Actionnez le bouton «pause» après la fin de l exécution de la requête. En effectuant cette opération, vous pourrez voir les statistiques accumulées Durant cette requête. Il n est pas nécessaire d être trop précis sur les actions effectuées sur les boutons Play / Pause car le temps total est calculé sur le temps total des requêtes JDBC et non sur le temps total actuel. En conséquence, vous obtenez des statistiques sur le pourcentage de requête les plus faible plutôt que sur le temps total de fonctionnement de l application. Le dernier bouton, l un des plus importants, est celui sur la gauche, permettant de créer des fichiers d index automatiquement basés sur les statistiques présentés dans la fenêtre de profil. Afin de créer ce fichier, une action de «Pause» aura du être préalablement effectuée. Dans le cas contraire, le fichier généré sera vide. Si nous continuons l exemple précédant, nous pouvons ajouter l étape suivante : 6. Activez le bouton «Save Indexes As», indiquer un nom de fichier tel que «indexes.sql», et enregistrez-le. En ouvrant le fichier dans un éditeur de texte vous pourrez voir des lignes similaires à : CREATE INDEX jahia_pages_def_index ON jahia_pages_def ( id_jahia_pages_def); CREATE INDEX jahia_pages_def_index2 ON jahia_pages_def ( name_jahia_pages_def); Vous pouvez utiliser le contenu de ce fichier au sein de votre base de données afin d éventuellement modifier un index existant auparavant.

95 I p95/102 CHAPITRE 7 : QUESTIONS FRÉQUEMMENT POSEES Toutes les questions que vous avez toujours voulu poser à propos de Jahia (et que d'autres ont déjà posé) sans que vous ayez à les poser. QUE FAIRE EN CAS DE PROBLÈME AVEC MON INSTALLATION JAHIA? 1) ACTIVER LE SYSTÈME DE LOGS JAHIA Fichiers de logs internes de Jahia Veuillez vous reporter au paragraphe «Logs» dans le chapitre 4 du présent document.. 2) L ASSISTANCE TECHNIQUE GRATUITE ET COMMERCIALE DE JAHIA Les listes de diffusion gratuites En premier lieu, recherchez dans les archives des listes de diffusion Jahia. De nombreuses réponses aux problèmes courants d installation, d administration ou de développement ont déjà été apportées dans celles-ci. Si vous ne trouvez par de réponse à votre problème, vous pouvez envoyer une nouvelle demande sur la liste adéquate. S il vous plait ne faites pas d envoi multiples sur plusieurs listes à la fois, sélectionnez bien la mailing list que correspond à votre problème). Essayez de donner le maximum d informations en accompagnement de votre question sur : - votre configuration système (OS, JDK utilisé, SGBD utilisé, version de votre application serveur ) - La version de Jahia que vous utilisez (build). Allez dans l interface Administration > A propos de Jahia pour connaître précisément la version de votre Jahia. - Le code d erreur (error stack trace) complet apparu dans la console si il s agît d un bug et qu un code d erreur apparaît. Assurez vous, si le cas de le permet, d avoir activé le plus haut niveau de traçage des erreurs avant de reproduire le bug, afin de fournir l explication la plus détaillée. Attention : ces listes de diffusion sont gratuites. Respectez s il vous plait la communauté des utilisateurs et acceptez le fait que potentiellement personne n ai de réponse à donner à votre question. Ces listes ne constituent en aucun cas un centre de support professionnel avec garantie de résolution des problèmes. FAQ Techniques Vous pouvez également regarder si des réponses aux questions fréquemment posées n ont pas été apportées sur la page de FAQ technique du site jahia.org. Cette page est accessible à l adresse suivante : QUELS SONT LES NAVIGATEURS WEB COMPATIBLES AVEC JAHIA? Les navigateurs suivants sont recommandés pour effectuer de la gestion de contenu sous Jahia : Windows - Internet Explorer 6.0 ou supérieur - Firefox 1.0 ou supérieur Mac Firefox 1.0 ou supérieur Safari

96 I p96/102 Veuillez noter que l utilisation d applets Java pour éditer du contenu requiert par votre navigateur le support LiveConnect, ce que seul Safari 1.2 semble offrir de façon correcte. Notez également qu Internet Explorer 5.2 pour Macintosh peut être utilisé pour naviguer sur un site Jahia, mais n est clairement pas recommandé pour gérer du contenu et réaliser des opérations d édition. Linux Firefox QUELLE EST LA DURÉE D UNE SESSION, ET COMMENT LA CHANGER? Par défaut, Tomcat est configuré pour terminer les sessions automatiquement après 30 minutes d'inactivité serveur. Cela signifie que si un utilisateur est entrain d'éditer un contenu texte (par exemple) pendant une durée supérieure à 30 minutes sans effectuer aucune autre action faisant appel au serveur (cliquer sur le bouton "Appliquer" par exemple, ou sur n'importe quel onglet de la fenêtre d'édition), il perdra sa session et ne pourra enregistrer les changements qu'il a opéré dans sa fenêtre d'édition de texte. Vous pouvez changer la durée de session dans le fichier suivant : TOMCAT_HOME/conf/web.xml Ligne 324, dans la section Default session configuration, changez la valeur inscrite dans <session-timeout>30</session-timeout> pour la valeur que vous désirez utiliser (en minutes). COMMENT INSTALLER DEUX INSTANCES DE JAHIA SUR LA MEME MACHINE? Si vous souhaitez installer deux instances (ou plus) de Jahia/Tomcat sur un même ordinateur, vous devez opérer quelques modifications de paramètres. En premier lieu, vous devez modifier le port sur lequel Tomcat répond aux requêtes. Ce paramètre est spécifié dans le fichier server.xml situé dans le répertoire : TOMCAT_HOME/conf/ Modifiez le paramètre "port" de la balise "Connector" située juste après le commentaire suivant : "Define a non-ssl Coyote HTTP/1.1 Connector on port 8080". Changez le port en mettant 7070 ou tout autre port que vous souhaitez et qui n est pas encore utilisé par votre système. Dans le même fichier, vous devez modifier le port d arrêt de Tomcat. Ce paramètre est défini au début du fichier server.xml : server debug="0" port="8005" shutdown="shutdown" Remplacez le port par défaut 8005 par n importe quelle valeur qui vous convient, 8006 par exemple. En dernier lieu, vous devez désactiver le serveur JMX ou changer son port, qui est défini dans le fichier jahia.properties. Recherchez la chaîne de caractères "JMX Settings" et passez les 3 lignes suivantes à "false": org.jahia.jmx.httpadaptoractivated = false org.jahia.jmx.xslprocessoractivated = false org.jahia.jmx.rmiadaptoractivated = false ou changez le port du serveur JMX (8082 par défaut) en modifiant la ligne suivante :

97 I p97/102 org.jahia.jmx.httpport = 8082 COMMENT PUIS-JE ACTIVER LA NOTIFICATION DU PROCESSUS DE WORKFLOW? Jahia intègre par défaut un processus de workflow relativement simple. Quand un rédacteur a terminé de saisir du contenu, il peut notifier aux éditeurs les pages qui sont prêtes. Ce processus est automatisé lorsque l'on passe par l'interface de workflow. Toutefois, pour que cette notification fonctionne, il est nécessaire que vous ayez renseigné les informations concernant le serveur de mail sortant lors du processus d'installation de Jahia ou ultérieurement via l'interface d'administration "configuration serveur" de Jahia. Si vous n'avez pas saisi d'adresse de serveur mail et de nom d'émetteur valide (reconnu par ce serveur) les notifications ne pourront pas fonctionner. Notez que Jahia ne support pas encore l'authentification SMTP, il est donc essentiel de vous assurer que votre le serveur sur lequel tourne Jahia est autorisé à utiliser votre serveur SMTP. Actuellement, il n'est pas possible de choisir à quel(s) éditeur(s) une notification est envoyée. L' de notification est envoyé à tous les éditeurs (personnes ayant des droits de validation) sur la page dont on demande une validation. COMMENT PROCEDER POUR MODIFIER LES PAGES D INTERFACE D ADMINISTRATION JSP DE JAHIA (FENETRES POP-UP)? Les pages JSP contenant le code des interfaces d'administration sont placées dans le répertoire : TOMCAT_HOME/webapps/jahia/jsp/jahia/engines/ Par exemple, la page JSP correspondant à la fenêtre d'authentification est située ici : TOMCAT_HOME/webapps/jahia/jsp/jahia/engines/login/ Cependant, pour des soucis de performances, Jahia est livré avec des JSPs pré compilés qui sont inclus dans le Jahia.jar. Pour pouvoir voir les modifications effectuées dans les JSPs, vous devez modifier le fichier web.xml qui se trouve dans le répertoire suivant : TOMCAT_HOME/webapps/jahia/WEB-INF/ Si vous voulez modifier par exemple la page d authentification (login.jsp), vous devrez supprimer ou commenter les lignes suivantes: <servlet-mapping> <servlet-name>jsp.jahia.administration.login_jsp</servlet-name> <url-pattern>/jsp/jahia/administration/login.jsp</url-pattern> </servlet-mapping> Si vous ne souhaitez pas utiliser le code JSP pré compilé pour les interfaces d'administration, dé commentez tout ce qui se trouve entre et <!-- Automatically created by Tomcat JspC. Place this fragment in the web.xml before all icon, display-name, description, distributable, and context-param elements. --> <!--

98 I p98/102 All session-config, mime-mapping, welcome-file-list, error-page, taglib, resource-ref, security-constraint, login-config, security-role, env-entry, and ejb-ref elements should follow this fragment. --> COMMENT TRADUIRE JAHIA DANS D AUTRES LANGUES? Tous les textes apparaissant dans les interfaces Jahia sont stockés dans des fichiers textes basiques appelés ResourceBundle. Les fichiers de ResourceBundle contiennent des correspondances entre des mots clés utilisés dans le code applicatif et les textes à afficher dans l'interface utilisateur. Par exemple, la clé pour le texte "Sélectionner une page à lier" est : "org.jahia.engines.shared.page_field.selectpagetolink.label". Si vous souhaitez traduire Jahia dans d'autres langues, commencez par dupliquer les 3 fichiers de RessourceBundle suivants : JahiaAdministrationResources.properties JahiaEnginesResources.properties JahiaMessageResources.properties Ils sont placés dans le répertoire : TOMCAT_HOME/webapps/jahia/WEB-INF/classes/ Puis renommez-les en ajoutant un tiret bas (_) à la fin du nom suivi du code de la langue dans laquelle vous allez traduire. Par exemple, pour traduire en allemand, vous devrez renommer le fichier : en JahiaAdministrationResources.properties JahiaAdministrationResources_de.properties Puis, modifiez le contenu de chaque fichier en traduisant le texte correspondant à chaque clé. Par exemple dans le fichier JahiaEnginesResources_de.properties, la ligne org.jahia.engines.shared.page_field.selectpagetolink.label = Select page to link peut être changée en org.jahia.engines.shared.page_field.selectpagetolink.label = Wählen Sie die Seite vor, um zu verbinden

99 I p99/102 COMMENT CRÉER UN SET DE NOUVEAUX TEMPLATES ET LE DÉPLOYER DANS JAHIA? Pour créer un package de templates en.jar une fois que vous avez réalisé un certain nombre de templates, vous devez créer un fichier templates.xml respectant le format suivant (issu du package corporate portal templates) : <?xml version="1.0" encoding="iso "?> <tpml> <parameter name="package-name">corporate Portal</parameter> <parameter name="root-folder">corporate_portal_templates</parameter> <parameter name="classes-file">corporate_templates.jar</parameter> <parameter name="provider"> <parameter name="thumbnail">corporate_portal_templates.gif</parameter> <template browsable="1" visible="1" homepage="1"> <parameter name="name">home</parameter> <parameter name="filename">home.jsp</parameter> <parameter name="display-name">home</parameter> </template> <template browsable="1" visible="1"> <parameter name="name">simple</parameter> <parameter name="filename">simple.jsp</parameter> <parameter name="display-name">simple</parameter> </template> </tpml> Les paramètres utilisables sont : - package-name : Nom du package tel qu'il apparaîtra dans Jahia. - root-folder : Nom du répertoire tel qu il se crée dans jsp/jahia/templates/your_site/ au déploiement des templates. - classs-files : Nom du fichier jar contenant les resources bundles de langues (comme Corporate_portal_templates_en.properties) qui sera inclus dans le fichier jar global du package de templates. - provider : Nom du fournisseur du set de templates - thumbnail : un aperçu (image) du rendu des templates peut être ajouté. Il sera affiché au moment de la sélection du set de template à déployer lors de la création d'un nouveau site virtuel. Les attributs de la balise <template> sont : - browsable : Mettre à 1 si le template doit apparaître dans la liste des templates disponibles au moment de la création d une nouvelle page. - visible : Mettre à 1 si le template doit apparaître dans la liste des templates disponibles au moment de la création d une nouvelle page. Mettre à 0 si le template ne doit pas être visible. - homepage : Si le template doit être utilisé comme page d'accueil du site virtuel, ajouté la valeur homepage= 1". Les paramètres pour chaque template sont : - name : Nom du template - filename : Nom du fichier jsp définissant le template - display-name : Nom du template tel qu'il sera affiché dans l'interface graphique de Jahia, notamment au moment du choix d'un template à appliquer pour la création d'une nouvelle page. Vous pouvez vous inspirer du fichier corporate_portal_templates.jar pour voir comment celui-ci est construit. Il est situé dans le répertoire : TOMCAT_HOME/webapps/jahia/WEB-INF/var/shared_templates/

100 I p100/102 Une fois votre package créé, vous pouvez le copier dans le repertoire : TOMCAT_HOME/webapps/jahia/WEB-INF/var/shared_templates/ Lorsque de nouveaux sites virtuels seront créés votre nouveau set de template apparaîtra dans la liste des sets de templates disponibles. Si vous voulez déployer ces templates dans un site virtuel existant, copiez le package dans le répertoire suivant : TOMCAT_HOME/webapps/jahia/WEB-INF/var/new_templates/site_visé/ Après quelques secondes, les templates sont déployés et disponibles dans Jahia.

101 I p101/102 LISTE DES ILLUSTRATIONS FIGURE 1-1 : VARIABLES D'ENVIRONNEMENT... 9 FIGURE 2-1 : PREMIER LANCEMENT DE JAHIA FIGURE 2-2 : LICENCE JAHIA FIGURE 2-3 : CONDITIONS D UTILISATION FIGURE 2-4 : SUPER ADMINISTRATEUR DEFINITION FIGURE 2-5 : PARAMETRAGE DU SERVEUR FIGURE 2-6 : PROPRIETES DE LA BASE DE DONNEES FIGURE 2-7 : PROPRIETES DU SERVEUR MAIL FIGURE 2-8 : PROPRIETES DU SITE VIRTUEL FIGURE 2-9 : CHOIX DE L ENSEMBLE DE TEMPLATES FIGURE 2-10 : RESUME FIGURE 2-11 : SUCCES DE L'INSTALLATION FIGURE 2-12 : PAGE D'ACCUEIL DU SITE VIRTUEL PAR DEFAUT FIGURE 3-1 : ADMINISTRATION DE SITE VIRTUEL FIGURE 3-2 : PROPRIETES DES PAGES FIGURE 3-3 : LISTE DES UTILISATEURS FIGURE 3-4 : DEFINIR LES PAGES D ACCUEIL FIGURE 3-5 : INTERFACE DE GESTION DES GROUPES FIGURE 3-6 : AJOUTER DE NOUVEAUX UTILISATEURS DANS UN GROUPE FIGURE 3-7 : GESTION DES TEMPLATES FIGURE 3-8 : DEPLOIEMENT MANUEL D UN TEMPLATE FIGURE 3-9: EDITION DE TEMPLATE FIGURE 3-10 : GESTION DES DROITS SUR LES TEMPLATES FIGURE 3-11 : INDEXATION VIA LE MOTEUR DE RECHERCHE FIGURE 3-12 : INDEXATION REUSSIE FIGURE 3-13 : DEFINIR LES PAGES D ACCUEIL FIGURE 3-14 : AJOUTER UNE NOUVELLE PAGE D ACCUEIL FIGURE 3-15 : MENU DE GESTION DES LANGUES FIGURE 3-16 : MAPPING DES LANGUES FIGURE 3-17 : PARAMETRES POUR LA MISE EN PRODUCTION A DISTANCE FIGURE 3-18 : GENERATEUR DE PORTLET HTML DEFINITION DES PARAMETRES FIGURE 3-19 : GENERATEUR DE PORTLET HTML NJOUTER UN «CLIPPER» FIGURE 3-20 : GENERATEUR DE PORTLET HTML NREATION D UN CLIPPER FIGURE 3-21 : GENERATEUR DE PORTLET HTML NNREGISTREMENT FIGURE 3-22 : GENERATEUR DE PORTLET HTML NDITION DES PARAMETRES FIGURE 3-23 : GENERATEUR DE PORTLET HTML NELECTION FIGURE 3-24 : GENERATEUR DE PORTLET HTML NEST FIGURE 3-25 : GENERATEUR DE PORTLET HTML NREVISUALISATION FIGURE 3-26 : GENERATEUR DE PORTLET SQL FIGURE 3-27 : DROITS SUR LE SITE FIGURE 3-28 : PURGE DES FICHIERS NON UTLIISES FIGURE 3-29 : PURGE DES FICHIERS NON UTLIISES MODE MANUEL FIGURE 3-30: PANNEAU D'ADMINISTRATION DU SERVEUR JAHIA FIGURE 3-31 : GESTION DES SITES VIRTUELS FIGURE 3-32 : PROPRIETES D'UN NOUVEAU SITE VIRTUEL FIGURE 3-33 : CHOIX DU PACKAGE DE TEMPLATES... 55

102 I p102/102 FIGURE 3-34 : LISTE DES CATEGORIES DEJA CREEES FIGURE 3-35 : AJOUT D'UNE NOUVELLE CATEGORIE FIGURE 3-36 : PROPRIETES DU SERVEUR FIGURE 3-37 : GESTION DES PORTLETS FIGURE 3-38: GESTION DES LOGS D'ADMINISTRATION FIGURE 3-39 : AFFICHER LES LOGS D'ADMINISTRATION FIGURE 3-40 : PROPRIETES DU SUPER ADMINISTRATEUR (ROOT) FIGURE 3-41 : LISTE DES EDITEURS HTML FIGURE 3-42 : LISTE DES BALISES A FILTRER FIGURE 3-43: CONFIGURATION DES SITES VIRTUELS FIGURE 3-44: STATUT DU SERVEUR ET DES CACHES FIGURE 3-45: A PROPOS DE JAHIA FIGURE 3-46 : DROITS SUR LE SERVEUR FIGURE 3-47: STATISTIQUES... 68