Server Administration

Transcription

1 DIGITAL FACTORY 7.0 Server Administration Rooted in Open Source CMS, Jahia s Digital Industrialization paradigm is about streamlining Enterprise digital projects across channels to truly control time-to-market and TCO, project after project. Jahia Solutions Group SA 9 route des Jeunes, CH-1227 Les acacias Geneva, Switzerland

2 Summary DIGITAL FACTORY Server Administration... 1 Introduction Gestion des Projets Web Création d un Projet Web Créer un nouveau Projet web Utiliser un Projet Web préconfiguré : Importer un Projet Web préalablement exporté Supprimer un Projet Web Exporter un Projet Web Modifier les informations d un site Autres réglages propres aux sites Gérer les utilisateurs Créer un utilisateur Modifier un utilisateur Supprimer un utilisateur Suspendre un utilisateur Création de multiples utilisateurs par importation Configuration des notifications s Gérer les portlets Editer les propriétés du Super Administrateur Statut du serveur et des caches Page 2 / 76

3 5.1.1 Cache Management Mémoire et Thread Dumps Informations système Gestion de la politique des mots de passe Gestion des rôles Créer un nouveau rôle Libellés Types de noeuds Permissions Permissions sur le nœud courant Permissions sur le site courant Permissions sur tout le serveur Sous-rôles Editer un rôle existant Supprimer un rôle Rôles, utilisateurs et groupes Rôles serveur Gestion des modules Private App Stores Qu est-ce qu un Private App Store? Ajouter un nouveau Private App Store Gérer les Private App Stores Page 3 / 76

4 9 Système de suivi des incidents Documentation A propos de Digital Factory Page 4 / 76

5 Introduction Jahia dispose d un module de back office pour répondre aux besoins des administrateurs des sites et de la plateforme dans son ensemble. Cette interface module est appelée l Administration ou le Mode Administration. Le fait d avoir les droits d administration vous donne accès à l Administration - en saisissant directement l adresse de votre serveur Jahia dans un navigateur, suivi de /administration - à partir de votre page personnelle, dans les liens situés en haut à gauche de la page - à partir des barres de menu présentes dans certains Modes. Via l Edit mode : Via le studio : Par défaut, après installation et création d un site, Jahia est livré avec : Un utilisateur «root» : C est utilisateur est le «super utilisateur» du système, il a tous les droits sur la totalité du système. Il peut accéder à toutes les fonctionnalités de la plateforme pour tous les sites hébergés. C est un utilisateur système à qui les droits ne peuvent être modifiés, même s il n apparaît pas directement dans les interfaces de gestion des Page 5 / 76

6 permissions des différents objets de contenu. L utilisateur «root», naturellement, n est pas contraint aux permissions du système, il a tous les droits et ils sont irrévocables. Un groupe «Administrateurs de site» (site-administrators) qui représente les personnes qui auront en charge l administration du site et qui auront les «pleins pouvoirs» sur celuici, écriture, participation aux workflows Ainsi qu un groupe d utilisateurs privilégiés (siteprivileged), qui représente les personnes ayant besoin d un accès au workspace default, utilisé notamment en mode Edit et Contribute. Ceci permet de sécuriser les accès. A noter que si vous attribuer à un utilisateur un rôle qui nécessite d avoir accès au workspace default (rôle éditeur par exemple), celui-ci sera automatiquement ajouté à ce groupe. Pour finir, les administrateurs de sites ou du server ont la possibilité de déléguer des tâches à d autres utilisateurs du système. Par exemple, l administrateur du site pourra donner l accès de la gestion des utilisateurs et groupes à d autres utilisateurs. Bien entendu ces utilisateurs n auront accès qu aux fonctionnalités définies par l administrateur du site et à celle-ci uniquement. L onglet Paramètres du serveur est normalement réservé au seul Super Administrateur du fait que les actions et opérations effectuées vont impacter l ensemble des sites mutualisés au sein du même serveur (ou cluster) Jahia. C est donc à partir de cet onglet que l on va pouvoir créer de nouveaux utilisateurs, ajouter de nouveaux portlets ou modifier les rôles disponibles sur la plateforme. C est également depuis cet onglet que l on va pouvoir lister, administrer, créer ou effacer des instances de sites virtuels / projets web. De manière similaire à l onglet Paramètres du site, le Super Administrator peut parfaitement déléguer l accès à un ou plusieurs modules disponibles dans cette section à d autres utilisateurs. Cette option de délégation est disponible au sein du menu «Gérer les rôles». Page 6 / 76

7 Page 7 / 76

8 1 Gestion des Projets Web Vous pouvez créer de multiples sites virtuels au sein du même serveur Jahia. Chaque site virtuel possèdera ainsi son propre jeu de pages, de contenu, de fichiers, La notion de «site virtuel» dans Jahia n est cependant pas une mutualisation entière de la plateforme mais signifie plutôt la capacité de créer des «espaces virtuels» distincts. Ainsi chaque site peut disposer de : Son propre domaine (par exemple vous pouvez décider de gérer un premier site sur le domaine: et un second site qui sera disponible sur le domaine les deux tournant en définitive sur le même serveur Jahia). Son propre plan de site avec sa propre arborescence Ses groupes propres (par exemple vous pouvez parfaitement disposer de deux groupes Auteurs distincts dont la composition des membres différents selon le site A ou le site B) Ses propres paramétrages (voir les fonctionnalités décrites dans le chapitre précédant) Cependant chaque site partage avec les autres sites : La même base de données sous-jacente et la même API : Il est ainsi possible d accéder aux objets de contenu disponibles dans les autres sites virtuels. Ceci permet ainsi de facilement réutiliser du contenu identique entre plusieurs sites (ex : des nouvelles qui sont identiques pour chaque département disposant chacun de leur propre site), mais cela peut poser évidemment des problèmes de sécurité en cas de mutualisation complète de la plateforme (ex : deux sociétés distinctes sont hébergées sur le même serveur). Les mêmes sets de templates (du moins pour les sites qui partagent le même jeu de modèles). Les mêmes modules Le même arbre de catégorie Page 8 / 76

9 Les mêmes utilisateurs (LDAP ou Jahia : il n est ainsi pas possible d avoir deux utilisateurs distinct (ex : John) avec le même identifiant entre deux sites. Les groupes LDAP sont pour leur part, à l instar des utilisateurs LDAP, également commun à tous les sites. Créer un nouveau site virtuel est donc utile lorsque la même société doit gérer plusieurs initiatives web différentes (ex : un site web public, un ou plusieurs extranets et un ou plusieurs intranets départementaux). La notion de sites virtuels permet ainsi de mieux déléguer les rôles, de disposer de vues (sitemap, thèmes, résultats de recherche ) ou d url/domaine différenciés par site tout en conservant des capacités de partage de contenu, d utilisateurs ou de mashups. Vous pouvez accéder à la liste de tous les sites virtuels existants depuis cette interface. Le site par défaut est celui qui est indiqué par une étoile bleue. Les opérations nécessaires à la création, modification ou suppression d un site Page 9 / 76

10 1.1 Création d un Projet Web Si aucun site n a encore été créé sur la plateforme (ce qui est peu probable sur un serveur de production, les équipes de développement remettant généralement un environnement prêt à l emploi) Jahia propose par défaut un écran pour créer un nouveau Projet Web. Si des Projets Web existent déjà sur la plateforme, une interface légèrement différente par sa disposition, mais proposant les mêmes options est affichée. Page 10 / 76

11 Trois possibilités sont offertes à l utilisateur qui souhaite créer un site. Nous n aborderons ici que la première dans le détail, la seconde étant plutôt utilisée lorsque l on souhaite se former et la troisième lors d une restauration d un site sauvegardé ou pour le transfert d un site d un serveur vers un autre serveur. Page 11 / 76

12 1.1.1 Créer un nouveau Projet web Etape 1 Titre du Projet Web : champ purement informatif, c est ce titre qui apparaitra dans diverses interfaces de Jahia pour identifier le site. Cette valeur peut être modifiée ultérieurement. Nom du serveur du site : nom de domaine sur lequel ce site sera accessible. Si le site que vous créez n est pas destiné à de la production immédiate mais doit servir de site de développement ou de test, laissez la valeur localhost dans le champ, cette valeur sera convenablement configurée sur le serveur de production. En cas de doute laissez toujours la valeur localhost et demandez à un administrateur ou un responsable d hébergement. Cette valeur peut être modifiée ultérieurement. Clé du site : nom du nœud racine du site. Ce nom apparaitra dans les urls par défaut, puisque toutes les pages et les contenus du site seront stockés en dessous de celui-ci, aussi est-il Page 12 / 76

13 recommandé de choisir un titre court et descriptif. Cette valeur ne peut pas être modifiée ultérieurement, aussi est-il important de bien réfléchir avant de définir celle-ci. Description du site : champ purement informatif permettant de décrire un peu plus en détail le site. Cette valeur peut être modifiée ultérieurement. Utiliser comme Projet Web par défaut : si cette case est cochée et que la plateforme comporte plusieurs sites, c est vers ce site que seront dirigés les utilisateurs qui appellent le serveur sans préciser le site désiré. Cette valeur peut être modifiée ultérieurement. Ne pas créer d administrateur : aucun compte administrateur pour le site ne sera créé, les utilisateurs disposant de suffisamment de droits (dont le compte ROOT bien sûr) pourront administrer le site. Sur une plateforme multi sites gérée par un webmestre unique, ou plusieurs webmestres intervenant sur tous les sites, cette option est préférable. Créer un nouvel utilisateur : créer un nouveau compte utilisateur disposant de tous les droits sur le site en cours de création. Cette option est utile si le site doit avoir un webmestre spécifique. Si le webmestre dispose utilise le compte ROOT, ou que le compte utilisateur qui va assumer le rôle de webmestre existe déjà (dans Jahia ou dans un annuaire d entreprise) il n est pas utile de créer un nouveau compte. Une fois ces champs d information remplis, cliquez sur «Etape suivante» Etape 2 Page 13 / 76

14 Cette étape permet de sélectionner le jeu de modèles (templates), des modules optionnels à déployer sur le site et la langue par défaut du site. Jeux de modèles : liste déroulante permettant de sélectionner le jeu de modèles souhaité ; Si le set de templates dispose d une image de prévisualisation, celle-ci sera affichée en dessous de la liste déroulante pour faciliter son identification. Modules : par défaut tout site bénéficie d une série de composants / fonctionnalités qui font partie du cœur du logiciel (module default). Les modules listés ici sont ceux disponibles sur la plateforme (dont les fichiers war ont été déployés dans Jahia) et qui peuvent être activés sur le site en cours de création. Ces modules permettent d ajouter de nouveaux types de contenus ou de nouvelles fonctionnalités. Page 14 / 76

15 Note : Lors de la création d un nouveau site, les équipes de développement ou les responsables fonctionnels du projet sont supposés vous avoir informé des modules à déployer. Si ce n est pas le cas, les modules peuvent être déployés ultérieurement à partir du Studio (version communautaire, Enterprise Jahia en mode développement) ou à partir du panneau Gestion des Modules dans les Paramètres du serveur de l interface d Administration (Enterprise Jahia mode développement et mode production). Langue par défaut : liste déroulante de choix de la langue et des variantes locales. Pour un site multilingue sélectionnez la langue considérée comme la plus importante, celle vers laquelle les utilisateurs seront redirigés s ils tentent d accéder au site sans préciser la langue souhaitée. La langue par défaut peut être modifiée ultérieurement dans les paramètres de site. Cliquer sur «Etape suivante» Etape 3 L écran final récapitule toutes les informations saisies précédemment pour permettre une dernière vérification avant création du site. En cas d erreur, il est possible de revenir au début du processus de création pour modifier ces valeurs. Les informations précédemment rentrées sont mémorisées tant que la session utilisateur est active, ce qui évite d avoir à retaper toutes les informations. Page 15 / 76

16 Si les informations sont correctes cliquez sur «Suivant». Une petite fenêtre flottante apparait pour montrer que des opérations sont en cours et disparaît une fois que la création du site est terminée. COMPRENDRE : Pourquoi la création d un Projet Web prend-elle un peu de temps? La création d un Projet Web, même si celui-ci semble presque vide lors de sa création, est un processus qui implique plus que la création d un simple nœud racine contenant les informations saisies dans les écrans de paramétrage. L essentiel du temps est en fait consacré à copier le jeu de modèles sélectionné sous le nœud racine et à associer toutes les permissions nécessaires. Page 16 / 76

17 Une fois la création du site terminée, vous êtes redirigé sur l écran de liste des sites, dans laquelle le site nouvellement créé doit apparaître. Pour accéder directement au site nouvellement créé, cliquez sur le bouton «Mode Edition» correspondant à votre site. Vous êtes alors redirigé sur la première page du site, plus ou moins vide selon le jeu de modèles utilisé, mais prête à être remplie, comme cela est expliqué dans le Guide de l Editeur Utiliser un Projet Web préconfiguré : Cette option crée un nouveau Projet Web contenant déjà des pages et du contenu (généralement des exemples fournis par Jahia à titre de démonstration) : sélectionner dans la liste déroulante le Projet Web d exemple voulu, cliquer sur «Poursuivre». Page 17 / 76

18 Sur l écran suivant donner un titre au Projet Web, le nom de domaine et l identifiant unique du site qui apparaitra dans les URLs par défaut puis cliquer sur «Suivant». Page 18 / 76

19 1.1.3 Importer un Projet Web préalablement exporté Cette option permet de sélectionner sur un disque dur un fichier au format zip résultant d un export préalable. L export aura été réalisé via les interfaces d exportation de Jahia (voir plus loin). Un nouveau site sera créé reprenant fidèlement les réglages et le contenu de celui-ci au moment de son export. 1.2 Supprimer un Projet Web Pour supprimer un Projet Web unique, cliquez sur l icône rouge en face de son nom. Attention cette action est irréversible, il est fortement conseillé d exporter le site au préalable, par sécurité. Pour supprimer plusieurs sites, utilisez les cases à cocher pour sélectionner ceux désirés puis cliquez sur le bouton «Supprimer» dans la barre d actions en haut de la page. Page 19 / 76

20 1.3 Exporter un Projet Web L export de site peut répondre à divers besoins : - Sauvegarde : il est possible de réimporter un site exporté tel qu il était. Cependant, cette solution demande une intervention manuelle d un webmaster ou d un administrateur et ne peut en aucun cas être considérée comme une méthode de backup fiable. - Transfert vers un autre serveur : qu il s agisse d effectuer une copie à l identique à un instant T pour travailler sur un autre serveur, faire des tests, servir de base de départ d un nouveau projet. - Transfert d un serveur de développement vers un serveur de production : dans le cas d un projet qui a été réalisé et pré-rempli avec du contenu sur un environnement de développement, il peut être pratique de réaliser un export et une réimportation vers le serveur qui servira à la production. Pour exporter un site unique, cliquer sur l icône la plus à droite en face de son nom Page 20 / 76

21 Pour exporter plusieurs sites, utilisez les cases à cocher pour sélectionner ceux désirés puis cliquez sur «Exporter». Vous avez le choix entre exporter la version de travail (contenu en édition, workspace default) en utilisant le bouton «Exporter (Contenu en édition)» ou à la fois la version de travail et la version publiée (workspace live) en utilisant le bouton «Exporter». Le site système peut également être exporté (mais ni supprimé, renommé ou modifié). Cette option peut-être utile, en particulier si du contenu partagé a été stocké dans ce site pour être réutilisé par tous les sites. Page 21 / 76

22 1.4 Modifier les informations d un site Pour modifier les informations concernant un site, cliquez sur son titre. L écran suivant permet d éditer les champs - Titre - Nom du serveur - Description 1.5 Autres réglages propres aux sites D autres réglages sont disponible directement en mode édition, dans le Sélecteur, vous pouvez utiliser le menu contextuel (clic-droit) pour éditer le nœud représentant un site Web, afin d accéder à des informations et réglages complémentaires. Plus d informations sont disponibles dans le guide du Webmestre. Page 22 / 76

23 Page 23 / 76

24 2 Gérer les utilisateurs Contrairement aux groupes, les utilisateurs sont communs à l ensemble de la plateforme afin de garantir leur unicité et sont donc gérés au niveau des paramètres du serveur. 2.1 Créer un utilisateur Rendez-vous dans la rubrique Gérer les utilisateurs, et cliquez sur «Créer un nouvel utilisateur». Vous arrivez alors sur l écran de création où vous pouvez saisir les différentes propriétés du nouvel utilisateur : Page 24 / 76

25 2.2 Modifier un utilisateur Pour modifier un utilisateur, sélectionnez simplement son nom dans la liste et cliquez sur le bouton «Editer/Afficher les propriétés de l utilisateur», vous serez alors redirigé vers un écran similaire à celui de la création d un utilisateur et vous pourrez modifier toutes ses propriétés à l exception bien sûr de son nom d utilisateur. Page 25 / 76

26 Cliquez sur Mettre à jour pour enregistrer vos changements. 2.3 Supprimer un utilisateur Sélectionner dans la liste l utilisateur à supprimer en cliquant dessus puis cliquez sur le bouton «Supprimer l utilisateur sélectionné». Page 26 / 76

27 Un écran de confirmation vous est présenté. Attention, la suppression d un utilisateur est définitive. Page 27 / 76

28 2.4 Suspendre un utilisateur Il est possible de suspendre un utilisateur c'est-à-dire de rendre son compte inactif, l empêchant ainsi de s authentifier. L avantage de la suspension de compte est de bloquer l utilisateur sans pour autant détruire celuici c'est-à-dire sans pour autant supprimer l ensemble des informations, documents ou contenus stockés dans son répertoire personnel. Pour suspendre un utilisateur vous devez vous rendre dans la fiche détaillée de l utilisateur en double cliquant sur son nom dans la liste (ou en le sélectionnant et en cliquant sur le bouton «Editer / Afficher les propriétés de l utilisateur sélectionné»). Une fois dans sa fiche, vous devez cliquer sur la case «compte bloqué», puis «OK». Le blocage d un compte à deux effets : 1) La session de l utilisateur est immédiatement interrompue, il est déconnecté d office. 2) Il ne peut plus se reconnecter au système en utilisant ce compte Page 28 / 76

29 2.5 Création de multiples utilisateurs par importation Des lots d utilisateurs peuvent être chargés en bloc dans Jahia Digital Factory par l intermédiaire d un fichier CSV. Celui-ci doit contenir au minimum un nom d utilisateur et mot de passe, mais peut contenir l ensemble des propriétés de l utilisateur. Il est impératif de spécifier les champs référencés dans le CSV en spécifiant un header, comme ceci : j:nodename,j:password,j:firstname,j:lastname steven,steven1234,steven,acme robert, robert1234, Robert, ABME Page 29 / 76

30 Enfin, pensez bien à spécifier le séparateur au moment de l import, ici «,». Page 30 / 76

31 3 Configuration des notifications s Depuis ce module vous pouvez modifier les paramètres du serveur qui servira de relai pour l envoi des notifications par . Ces paramètres ont normalement été saisis au préalable lors de l installation du serveur Jahia. Afin de paramétrer correctement votre serveur mail, entrer tout d abord l adresse de votre serveur SMTP. Vous pourrez ensuite saisir le mail de l administrateur système. Ce dernier recevra les s de notifications en cas d erreurs système. Vous pouvez également déterminer l adresse qui servira de source lors de l envoi des notifications automatiques par le système. Cette adresse doit bien sûr être reconnue et acceptée par le serveur SMTP. Vous pourrez trouver des compléments d informations de paramétrage ci-dessous : 1. "Serveur de messagerie": ce champ contient l adresse SMTP du serveur . Ce champ peut contenir certaines propriétés avancées telles que : - le numéro de port : si ce dernier diffère du port SMTP standard (25) Page 31 / 76

32 - l utilisateur et son mot de passe : dans le cas où le serveur SMTP requiert une authentification - des propriétés additionnelles : par exemple afin d activer le TLS Le format pour ce champ est le suivant : <utilisateur>:<mot de passe>@<smtp-host>:<smtpport>[paramètre1=valeur1,paramètre2=valeur2,...] Tous les arguments à l exception de <smtp-host> sont optionnelles. Merci de consulter les exemples d utilisation ci-dessous pour plus de détails. 2. Le champ " à l administrateur" contient une ou plusieurs adresses s séparées par des virgules. Chacun de ces utilisateurs recevra les notifications systèmes (si ces dernières sont activées). 3. Finalement le champ " de" déterminera le nom par défaut utilisé par Jahia pour envoyer les s de notifications. Afin d illustrer différentes configurations possibles, veuillez trouver différents exemples d utilisation ci-dessous : 1. Le serveur SMTP ne requiert aucune authentification et utilise le port standard 25 : smtp.acme.com 2. Le serveur SMTP requiert une authentification et utilise le port non standard : utilisateur : mot-de-passe-secret@smtp.acme.com: Exemple pour un compte GMail : Le serveur SMTP requiert une authentification et le TLS est activé : acme@gmail.com: 4. Si nécessaire activation des options de debuging avancées afin de voir le détail de la communication avec le serveur SMTP : smtp.acme.com:25[mail.debug=true] Finalement l option concernant le niveau de notification est uniquement utilisée afin d envoyer des s de notification concernant certaines erreurs systèmes. Normalement seuls les Page 32 / 76

33 administrateurs système de la plateforme sont concernés par cette option (voir ci-dessus pour la liste des récepteurs). La configuration du serveur concerne pour sa part l envoi de tous les s de notification de Jahia (y compris les notifications des workflows par exemple) et ne s arrêtent pas uniquement aux messages d alerte système. Page 33 / 76

34 4 Gérer les portlets L application Jahia supporte nativement la norme JSR168 (Portlet 1.0) et JSR286 (Portlet 2.0). Des portlets génériques peuvent donc être facilement déployés et réutilisés au sein du système Jahia qui peut se substituer à un serveur de portail additionnel. Un portlet est généralement une micro-application web qui peut gérer plusieurs instances. Par exemple un administrateur peut déployer une portlet générique de type «Portlet RSS» servant à lire et afficher un flux RSS. Cette portlet générique peut ainsi être utilisée au sein de plusieurs pages, voire plusieurs sites afin d afficher des flux RSS totalement différents. Chaque flux sera donc traité par Jahia comme une instance de ce portlet. Chaque instance est sauvée et est considérée comme un «mashup» disponible au sein de l application. Ainsi la portlet générique est déployée et gérée directement au sein du centre d administration à partir de ce module. Le Super Administrateur peut ensuite déterminer quels seront les utilisateurs qui auront le droit de créer des nouvelles instances à partir de ce portlet (par ex : des nouveaux flux RSS). Ensuite chacune de ces instances pourra elle-même recevoir des droits d utilisation distincts par utilisateur. Ce mécanisme permet à l administrateur de déterminer qui peut ajouter des nouveaux flux et qui peut les positionner au sein d une page dans un site précis. Ce système ne fait évidement de sens que si l administrateur souhaite contrôler les «instances de mashups» qui auront été générées. Si tel n est pas le souhait, il suffit de rajouter le groupe «utilisateurs» (tous les utilisateurs identifiés) à chacune des portlets et chaque utilisateur sera alors libre de créer le nombre d instances de ce portlet qu il souhaite. Merci de vous référez à la documentation en ligne disponible sur le site afin d apprendre comment développer de nouvelles portlets ou comment déployer un portlet existant au sein de votre environnement de travail Jahia. Page 34 / 76

35 De manière similaire au menu concernant la gestion des sites virtuels, vous trouverez dans le menu des portlets une liste de tous les portlets déjà déployés dans la partie supérieure de l interface principale. Vous pouvez cliquer sur les opérations et actions disponibles à côté de chaque portlet afin d obtenir des détails, de modifier leurs permissions d accès ou d accéder à la liste de leur utilisation. Afin de déployer un portlet dans le serveur d application Tomcat livré par défaut avec Jahia, un développeur aura besoin de réaliser une légère modification dans un fichier de configuration fourni avec le portlet. Cette manipulation est décrite dans l écran affiché après avoir cliqué sur le bouton d aide. Cette modification peut également être automatiquement réalisée en cliquant sur «Préparer» ou «Préparer et Déployer la portlet». Page 35 / 76

36 Si vous utilisez un autre serveur d application que Tomcat, vous devez effectuer de manière manuelle cette opération et déployer vos portlets tels que précisés dans la documentation de votre serveur d application. Page 36 / 76

37 5 Editer les propriétés du Super Administrateur En tant que Super Administrateur vous pouvez bien entendu modifier à n importe quel moment vos propriétés personnelles (nom, mot de passe, , ). Mettez simplement à jour les informations nécessaires et cliquez sur le bouton OK. 5.1 Statut du serveur et des caches Ce module permet de renseigner le Super Administrateur sur les différents paramètres du système. En plus de fournir des informations, cette interface permet d intervenir sur les caches et de récupérer des informations détaillées en vue d analyse en cas de comportement anormal à fournir aux équipes de support. Page 37 / 76

38 5.1.1 Cache Management Ce panneau permet de visualiser l état de chacun des caches de Jahia, front-end et back-end et de vérifier leur niveau d efficacité. Les boutons situés en haut du panneau permettent de purger les caches : - Frontaux (purger tous les caches HTML) c est à dire les fragments de cache générés au format HTML pour chaque élément de contenu. - Les deux en même temps (Purger tous les caches) Pour des purges plus sélectives sur les caches back-end le panneau liste un à un chacun d entre eux. Attention, une purge de caches est une action dont les conséquences sont importantes en termes de cohérence des données, de stabilité et de performances. Le flush des caches HTML, par exemple, induira une surcharge de travail conséquente sur la plateforme pour recalculer les différents fragments. Une telle purge ne doit jamais être réalisée sous forte charge, sous peine de provoquer une indisponibilité de la plateforme. De manière générale, des purges de caches ne devraient être réalisées qu à la demande du support techniques Jahia ou si vous maîtrisez bien le fonctionnement du logiciel et les conséquences de ces purges. Page 38 / 76

39 Il est possible d activer les statistiques EHCache ou Hibernate (couche d abstraction entre Jahia et la DB) si nécessaire en cliquant sur le bouton «Activer les statistiques». La liste sera mise à jour avec les données souhaitées. Si les statistiques sont activées, le panneau est étendu. Page 39 / 76

40 Ces informations statistiques peuvent s avérer utiles ponctuellement pour auditer le système en cas de problème ou de travail d optimisation des performances. En situation normale de production, ces statistiques n ont pas besoin (et ne devraient pas) être activées Mémoire et Thread Dumps Mémoire Page 40 / 76

41 Ce panneau délivre des informations sur la mémoire allouée, la mémoire effectivement utilisée et la mémoire libre à l instant T. Il est possible, depuis cet onglet de déclencher le garbage collector pour purger la mémoire utilisée (attention, les conséquences d une purge de mémoire forcée sur un site en production ne sont pas anodins en terme de performances, seuls des administrateurs maitrisant bien les principes de fonctionnement des serveurs d application et des JVM devraient utiliser cette option) Thread Dump Cliquez sur le lien «Thread dump» pour afficher les options. Page 41 / 76

42 Ce panneau permet en premier lieu d effectuer des threads dumps pour analyser les processus en cours d exécution et de récupérer les données selon différentes modalités - Dans une fenêtre du navigateur - Dans un fichier téléchargeable sur l instant - Dans la console java - Dans un fichier stocké sur le disque du serveur : [répertoire d installation de jahia]/temp/jahia-threads/ - Plusieurs dumps effectués à intervalle régulier dans un fichier stocké sur le disque du serveur. Il est ensuite possible de désactiver les fonctions Thread Monitor et Error File Dumper intégrées à Jahia et qui ont pour effet de stocker automatiquement sur disque un grand nombre d informations lorsque surviennent des erreurs sur la plateforme. Bien que ces fonctions soient très utiles pour le support, il est conseillé de désactiver ces deux outils sur des plateformes de production soumises à de fortes charges, dans la mesure où de telles opérations sont elle-mêmes fortement Page 42 / 76

43 consommatrices de ressources. Sur une plateforme qui connaitrait déjà des erreurs ou des ralentissements liés à une trop forte charge, ces fonctions auraient pour effet d aggraver la situation. La dernière ligne permet de lancer un outil d analyse de thread dumps. Dans tous les cas, au moment de la demande de génération des thread-dumps, les crédentiels administrateur de votre serveur d application (et non de Jahia) vous seront demandés pour pouvoir effectuer ces opérations bas niveau Informations système Le dernier panneau rassemble les informations relatives au système (OS), à l environnement dans lequel évolue Jahia (JVM / Path d installation / Base de données / ) et à certaines configurations de Jahia. Page 43 / 76

44 5.2 Gestion de la politique des mots de passe Le module de gestion de politique de mot de passe a pour objectif de fixer les règles servant à sécuriser les identifiants des utilisateurs. Des paramètres tels la taille minimale pour les mots de passe, l intégration de certains caractères spéciaux, l obligation de changer de mots de passe après un certain délai, etc peuvent être ajustés depuis ce menu. Il est important de mentionner que cette politique de sécurisation des mots de passe ne concerne que les utilisateurs Jahia et non pas les utilisateurs LDAP ou Active Directory qui sont directement gérés et soumis aux règles édictés par ces serveurs distants. Page 44 / 76

45 6 Gestion des rôles Le système de gestion des habilitations (accès à certaines pages, droit d écriture, possibilité d utiliser certains outils, etc.) repose sur des permissions groupées entre elles pour former un rôle. En standard, Jahia fournit des permissions relatives aux «repository», c'est-à-dire à la lecture / écriture dans les workspace live ou default (edit), des permissions permettant de restreindre l accès aux managers ou encore des permissions pour gérer l accès aux différents modes Contribute / Edit / Studio. Néanmoins, chaque module déployé dans Jahia peut venir ajouter ses propres permissions, pour effectuer ses propres contrôles d accès. C est par exemple le cas du blog ou des commentaires, qui définissent des permissions permettant de créer des commentaires ou des entrées de blog directement en live. Enfin, certaines opérations dans Jahia vont venir générer automatiquement des permissions, tel que le déploiement de portlet, ou le déploiement de modèles, ce qui va permette de gérer l utilisation de ces éléments au sein du système. Page 45 / 76

46 Le couplage de plusieurs permissions va permettre de définir un rôle. Par exemple un rôle de traducteur, devra avoir la permission d accès à l édit mode, la permission de modifier du contenu en mode edit dans une langue donnée, mais pas celle d en créer! Un rôle de publicateur, qui doit valider le contenu, aura lui la permission «Publish», et la permission lecture du Mode Edition, mais pas écriture car il n est là que pour valider! ect Libre à vous de créer vos propres rôles pour répondre à vos besoins. Par exemple un rôle «blogueur». Ces rôles pourront ensuite être associés à des groupes d utilisateurs ou à des utilisateurs pour tout ou partie d un site directement via le Mode Edition. Types de rôles Les rôles sont répartis en quatre types : «Rôles Live», «Rôles d Edition», «Rôles de Site» et «Rôles Serveur». Lorsqu un rôle définit des permissions sur le workspace live seulement, le type «Rôle Live» est recommandé. Si le rôle définit des permissions mixtes (workspaces live et default) ou uniquement des permissions d édition (workspace default), il est recommandé de choisir le type «Rôle d Edition». Par défaut, les auteurs voient une interface d édition simple (Mode Live), qui leur permet d avoir le contrôle sur le contenu publié en ligne. Veuillez consulter la rubrique «Permissions» de ce document pour voir les permissions spécifiques à chaque type de rôle. 6.1 Créer un nouveau rôle Sélectionnez le type de rôle (Live, Edition, Site ou Serveur) dans la liste déroulante, saisissez le nom système du rôle et cliquez sur le bouton «Ajouter rôle» pour créer un nouveau rôle. Le nom entré ici est le nom système ou nom technique du rôle. Il s agit du nom qui s affichera par défaut si aucun libellé spécifique n est créé. Aussi, il est conseillé de choisir un nom système descriptif, pertinent et court, car vous ne pourrez pas changer cette valeur ultérieurement. Page 46 / 76

47 Sur la page suivante, vous pouvez éditer les propriétés du nouveau rôle. Page 47 / 76

48 6.1.1 Libellés Un rôle est défini par son nom système, mais il peut également avoir un ou plusieurs libellés (ou «Labels») destinés à faciliter la compréhension du rôle dans un environnement multilingue. Ces libellés seront utilisés en priorité pour l affichage, à la place du nom système. Il est également possible d ajouter une description du rôle dans les différentes langues. Pour définir un titre internationalisé, cliquez sur l onglet «Labels», choisissez la langue puis cliquez sur «+». Vous pouvez maintenant définir comment le rôle sera affiché pour cette langue. Les libellés et les descriptions peuvent être modifiés. Page 48 / 76

49 Cliquez «Sauvegarder» pour enregistrer vos modifications. Page 49 / 76

50 6.1.2 Types de noeuds Il est possible de définir les types de nœuds (types de contenus) sur lesquels le rôle peut être appliqué. Par défaut, un rôle peut être conféré à un utilisateur ou un groupe sur n importe quel type de contenu. En sélectionnant des types de contenus particuliers, le rôle en question n apparaitra dans les interfaces de gestion des droits que pour ces types de contenu et ne sera pas disponible pour les autres. Cette faculté permet de maintenir des interfaces de gestion des droits non surchargées et de perturber les utilisateurs en leur mettant à disposition des rôles qui n auraient strictement aucun effet sur l objet sur lesquels ils essaient de l appliquer. Par exemple, vous pouvez avoir envie de créer un rôle spécifique «article-editor» qui n aura des permissions que sur les contenus de type «article». Page 50 / 76

51 6.1.3 Permissions Une fois la partie contenu correctement configurée, définissons maintenant les permissions associées à ce nouveau rôle, via la rubrique «Permissions» de la page. Un résumé des permissions actives pour ce rôle est affiché en premier. La liste déroulante sous le résumé vous permet de choisir les jeux de permissions que vous souhaitez éditer, en fonction de leur périmètre (Permissions sur le nœud courant, permissions sur le site courant, permissions sur tout le serveur). Page 51 / 76

52 Pour chaque jeu de permissions, un onglet affiche les différentes catégories de permissions disponibles. Cliquez sur le signe «+» pour afficher les sous-permissions d une permission donnée. Il est à noter que cocher la case en face d une permission coche automatiquement les sous-permissions. Vous pouvez décocher celles-ci individuellement Permissions sur le nœud courant Permissions de base Ces permissions incluent les droits Lecture, Ecriture et Contrôle d accès (spécifique au nœud) sur le workspace default, qui est utilisé essentiellement dans les Modes Edition et Contribution Tâches de workflow Page 52 / 76

53 Ces permissions permettent de définir quelles étapes du workflow seront disponibles pour le rôle ou de court-circuiter le workflow pour les rôles disposant de certains privilèges Permissions sur les modules Avec cet onglet, vous pouvez donner des permissions sur des modules spécifiques (Blog, Forum, Wiki ) et leurs fonctionnalités. Page 53 / 76

54 6.1.5 Permissions sur le site courant Interface Utilisateur Ces permissions gèrent l accès aux différents aspects de l interface d édition (Mode Contribution, Engine d édition, Gestionnaires divers etc.) Page 54 / 76

55 Modèles et Composants Ces permissions permettent de créer du contenu en utilisant certains types de contenu (simple, social, multimédia ) et de créer des pages en utilisant des modèles de mise en page spécifiques. Page 55 / 76

56 Administration du site (Rôles de Site uniquement) Cet onglet n est visible que pour les rôles qui ont été créés comme Rôles de Site. Avec ces permissions, vous pouvez donner l accès aux panneaux d administration du menu «Paramètres du Site» (Groupes, Langues, Paramètres HTML, etc.) Pour plus d informations sur la options du menu «Paramètres du Site», veuillez-vous référer au document intitulé «Administration des Sites» disponible sur Permissions sur tout le serveur Permissions de base. Permissions simples de Lecture, Ecriture et d Accès sur le workspace default Administration du Serveur Accès aux différents panneaux de l interface d Administration du Serveur. Page 56 / 76

57 Lorsque vous avez terminé, cliquez sur «Sauvegarder» pour enregistrer vos modifications Sous-rôles Avec Jahia Digital Factory, vous avez la possibilité de créer des sous-rôles, dérivés d un rôle et de son jeu de permissions. Un sous-rôle ne peut qu avoir des droits supplémentaires par rapport au rôle parent dont il est dérivé. Les permissions du rôle parents sont copiées et héritées automatiquement, y compris lorsque vous changez les permissions du rôle parent ultérieurement. Pour ajouter un sous-rôle, cliquez l onglet «Sous-rôles» et entrez un nom système pour le nouveau sous-rôle. Page 57 / 76

58 Une fois le sous-rôle créé, vous êtes redirigé vers sa page de propriétés. Les permissions héritées du rôle parent apparaissent en grisé et ne peuvent pas être modifiées. Page 58 / 76

59 Le nouveau sous-rôle est visible dans la liste des rôles sur la page principale «Rôles et Permissions». Vous pouvez alors éditer ses propriétés en cliquant sur son nom Editer un rôle existant Pour modifier les propriétés ou les permissions d un rôle existant, cliquez sur le nom du rôle dans la liste des rôles. L écran suivant est le même que celui qui apparaît après la création d un nouveau rôle. Voir «Créer un nouveau rôle» pour plus de détails. Cliquez sur «Sauvegardez» pour enregistrer vos modifications. Page 59 / 76

60 6.2 Supprimer un rôle Sélectionnez un ou plusieurs rôles en cochant les cases correspondantes, puis cliquez sur le bouton «Supprimer rôle(s)». Page 60 / 76

61 L écran suivant vous demande de confirmer. La suppression d un rôle est une opération définitive ; veuillez procéder avec prudence. Page 61 / 76

62 6.3 Rôles, utilisateurs et groupes Lorsque vous éditez un nœud (page, contenu, etc ) au moyen de l engine d édition, vous pouvez attribuer des Rôles d édition à des utilisateurs ou à des groupes d utilisateurs. Les permissions associées au rôle sont transférées aux utilisateurs ou aux membres des groupes désignés. Utilisez le menu contextuel pour éditer le nœud souhaité puis cliquez sur l onglet «Rôles d édition» pour gérer les Rôles d édition sur ce nœud. <<image>> Si vous disposez des droits d édition, vous pouvez également attribuer des Rôles Live à des utilisateurs et à des groupes via l onglet «Rôles live». 6.4 Rôles serveur Les Rôles Serveur sont un type particulier de rôles qui disposent de permissions sur le serveur luimême, y compris l interface d Administration du serveur. Par défaut, seul le Super Administrateur «root» bénéficie des privilèges d Administration du serveur. Page 62 / 76

63 La création des Rôles Serveur et la définition de leurs permissions s effectue, comme pour les autres types de rôles, au niveau de l élément «Rôles et Permissions» du menu d administration. L élément «Rôles Serveur» du menu d administration vous permet en revanche d ajouter ou de supprimer des membres dans les Rôles Serveur existants. Pour éditer les membres (ajouter, supprimer) pour un Rôle Serveur déjà créé (par exemple le rôle Server Administrator), cliquez sur le bouton «Membres» associé à ce rôle, sélectionnez ou désélectionnez les utilisateurs (ou les groupes) souhaités, puis cliquez sur «Sauvegarder». Page 63 / 76

64 La liste des membres mis à jour apparaît sur la page des Rôles Serveur. Page 64 / 76

65 7 Gestion des modules La gestion des modules et leur mise à disposition (déploiement) sur différents sites de la plateforme peut être réalisée via le Studio lorsque Jahia est en mode développement. En mode production, les réglages de la plateforme sont optimisés et pour des raisons de sécurité des processus de mise à jour, le Studio n est pas accessible. Cet écran permet donc d effectuer les tâches de déploiement (ajout / mise à jour) des modules qui sont disponibles sur la plateforme. Pour afficher les détails relatifs à un module donné, cliquez sur le bouton «Détails». Page 65 / 76

66 La première partie de la page contient des informations sur le type de module, la version et le statut et vous permet de démarrer ou d arrêter le module. Il y a 4 types principaux de modules : o Jahiapp : module complexe pouvant être assimilé à une application web à part entière o Module : module standard o My Space : modules liés à l espace utilisateur o Jeux de modèles : templates de mise en page Utilisation dans les sites : Liste des sites sur lesquels ce module est déjà déployé. Lorsqu un module sélectionné dans la première partie est déjà déployé sur un ou plusieurs sites, ceux-ci sont affichés et un bouton permet d effectuer d un seul clic la mise à jour sur tous les sites. Page 66 / 76

67 Il est possible d activer ou de désactiver le module sélectionné sur un ou plusieurs sites spécifiques. Il est possible de supprimer le module de tous les sites en cliquant sur le bouton «Supprimer de tous les sites». Types déclarés: liste de tous les types de nœud (nodetypes) déclarés dans le module sélectionné. Dépendances : liste des modules dont dépend le module sélectionné. Modules dépendant de celui-ci : liste des modules qui dépendent du module sélectionné. Page 67 / 76

68 Page 68 / 76

69 8 Private App Stores 8.1 Qu est-ce qu un Private App Store? Avec Jahia Digital Factory 7, vous avez désormais la possibilité de réutiliser et de distribuer des modules et des applications métier que vous avez développés et qui ont fait leurs preuves, grâce à votre propre Private App Store. Vous pouvez aindi capitaliser sur vos investissements applicatifs d un projet à l autre, au sein de votre organisation ou les partager avec vos partenaires ou intégrateurs. Lorsque vous ajoutez une référence vers un Private App Store sur votre serveur, les modules qui s y trouvent deviennent accessibles au travers du panneau d Administration «Modules» du serveur et peuvent ainsi être facilement déployés sur vos Projets Web. Nota : La création et la configuration du Private App Store lui-même ne sont pas couverts dans le présent Guide d Administration. Un document dédié sera bientôt disponible sur Page 69 / 76

70 8.2 Ajouter un nouveau Private App Store Cliquez sur «Private App Store» dans le menu de gauche pour gérer les Private App Stores. Pour créer une nouvelle référence vers un Private App Store, entrez l URL et, si nécessaire, le nom d utilisateur et le mot de passe requis pour l accès. 8.3 Gérer les Private App Stores A l aide des boutons d action à droite, vous pouvez éditer les propriétés d un Private App Store ou supprimer sa référence sur le serveur. Page 70 / 76

71 Un serveur Jahia peut être client de plusieurs Private App Stores. Page 71 / 76

72 9 Système de suivi des incidents Ce raccourci vous redirige directement vers le système de gestion des tickets des incidents disponible en ligne. Une connexion internet est donc nécessaire. Deux systèmes de gestion des incidents coexistent : Le système gratuit mis à disposition de la communauté Jahia. Le système commercial uniquement à disposition des clients avec un contrat de support valide Le système communautaire a également pour objectif d enregistrer et de suivre les différentes propositions d amélioration. Donc n hésitez pas à suggérer des propositions ou des idées afin d améliorer l application. Comme ces tickets sont disponibles publiquement, merci de ne pas faire mention de vos paramètres propres à votre environnement ou d autres données confidentielles. Le système de suivi des tickets commercial est uniquement disponible pour les clients. Chaque client dispose de son environnement distinct et sécurisé uniquement disponible via une accréditation spécifique. Tous les tickets de bugs traités par ce système le sont par des employés de Jahia Solutions Group sous le couvert des règles classiques de confidentialité. Les tickets ne sont donc pas partagés entre les clients et chaque client dispose d un temps minium ainsi que d une obligation de réponse de la part de l éditeur. Page 72 / 76

73 Page 73 / 76

74 10 Documentation De manière similaire au système de gestion des incidents, la documentation Jahia est séparée en deux parties : la documentation gratuite et communautaire disponible sur le site jahia.org. la documentation commerciale uniquement disponible pour les clients des versions payantes qui est disponible dans l espace Extranet client. Page 74 / 76

75 11 A propos de Digital Factory Finalement le module: A Propos de Digital Factory résume l ensemble des fonctionnalités disponibles dans le cadre de votre clé de licence actuelle (nombre d utilisateurs, contraintes sur certains modules, expiration des versions d essais, ). Dans cette section vous trouverez également le numéro de version de l applicatif. Ce numéro apparaît normalement également en bas de chaque écran d édition. Ce numéro doit être mentionné dans chaque report d incident afin de simplifier la résolution de ce dernier par l équipe de support. Page 75 / 76

76 Jahia Solutions Group SA 9 route des Jeunes, CH-1227 Les acacias Geneva, Switzerland