Guide d`Administration Silverpeas
Transcription
Guide d`Administration Silverpeas
Exploitation et Administration de Silverpeas Guide de l’administrateur Silverpeas Version 5 ___________________________________ Version : 5 Auteurs : David Lesimple Approbation : Date modification : 30/04/2015 Silverpeas Diffusion : Clients Silverpeas Guide Administration Silverpeas v5.odt Page 1 SUIVI DE VERSION Pages des modifications Description des modifications Toutes Refonte et mise à jour des informations suivant contexte Silverpeas V5. Page 43 Ajout schéma des outils Silverpeas Page 39 Ajout mise à jour version mineure. Page 41 Ajout procédure installation/mise spécifiques clients via Maven. Page 46 Ajout fichiers de log de Jboss Chapitre 6.4 Nouveau paragraphe : Nouvelle installation avec reprise des données et du paramétrage d'une installation existante Page 45 Ajout réparation JCR après restauration de base. toutes pages Modification synchronisation LDAP Fichier de configuration config.xml (<5.9) remplacé par config.properties (>= 5.9) toutes pages Ajout chemin properties 5.11 Page 61 Suppression ancien n° de support toutes pages Le terme évolutive remplace le terme mineur (pour une version). Corrections diverses. (chemins, explications) Page 19 Page 28 Ajout de la règle DS_Domain Ajout paramètre DelUsersOnThreadedSynchro Silverpeas à jour des Guide Administration Silverpeas v5.odt Page 2 Silverpeas Guide Administration Silverpeas v5.odt Page 3 Sommaire 1À PROPOS DE CE GUIDE....................................................................................6 1.1PUBLIC CONCERNÉ..............................................................................................6 1.2CONNAISSANCES PRÉALABLES................................................................................6 1.3DOCUMENTS DE RÉFÉRENCE...................................................................................6 1.4CONVENTIONS....................................................................................................6 1.5APERÇU............................................................................................................6 1.6AVERTISSEMENT.................................................................................................7 1.7ASSISTANCE TECHNIQUE......................................................................................7 2STRUCTURE SILVERPEAS...................................................................................8 2.1ARCHITECTURE FONCTIONNELLE.............................................................................8 2.2ARCHITECTURE TECHNIQUE.................................................................................10 2.3DISTRIBUTIONS PRODUIT...................................................................................14 2.4FICHIERS SILVERPEAS.......................................................................................14 3LA GESTION DES UTILISATEURS.....................................................................16 3.1QU’EST-CE QU’UN DOMAINE ?.............................................................................16 3.2LES TROIS TYPES DE DOMAINES POSSIBLES............................................................17 3.3LES GROUPES...................................................................................................19 3.4LES UTILISATEURS............................................................................................21 3.5AUTHENTIFICATION...........................................................................................22 4SYNCHRONISATION LDAP...............................................................................23 4.1LES DIFFÉRENTES STRUCTURES LDAP...................................................................23 4.2LA SYNCHRONISATION.......................................................................................26 4.3LES OPÉRATIONS POSSIBLES AVEC UN DOMAINE LDAP SYNCHRONISÉ.........................27 5LES DONNÉES SILVERPEAS.............................................................................36 5.1DÉFINITIONS...................................................................................................36 5.2DONNÉES EN BASE............................................................................................36 5.3RÉPERTOIRE DATA............................................................................................36 6INSTALLATION ET MISE À JOUR......................................................................38 6.1OBJECTIF........................................................................................................38 6.2NOUVELLE INSTALLATION DE SILVERPEAS..............................................................38 6.3PATCH OU MISE À JOUR D'UNE INSTALLATION EXISTANTE..........................................39 6.4NOUVELLE INSTALLATION AVEC REPRISE DES DONNÉES ET DU PARAMÉTRAGE D'UNE INSTALLATION EXISTANTE.......................................................................................45 7EXPLOITATION................................................................................................48 Silverpeas Guide Administration Silverpeas v5.odt Page 4 7.1FONCTIONNEMENT SILVERPEAS...........................................................................48 7.2ARRÊT/ REDÉMARRAGE DE SILVERPEAS................................................................48 7.3MODIFICATION DE PARAMÈTRES..........................................................................49 7.4PARAMÈTRES CLIENT.........................................................................................49 7.5RECONSTRUCTION DE L’APPLICATION (APPLICATIONBUILDER SCRIPT APPBUILDER)...49 7.6EXAMEN DES LOGS............................................................................................50 7.7IDENTIFICATION DE LA CONFIGURATION ET VERSION INSTALLÉE.................................50 7.8SAUVEGARDE/RESTAURATION.............................................................................50 8PROBLEMES POSSIBLES..................................................................................51 8.1CONSULTATION DES LOGS...................................................................................51 8.2PROBLÈMES IDENTIFIÉS.....................................................................................51 9PARAMETRES SILVERPEAS..............................................................................54 9.1PARAMÈTRES 9.2PARAMÈTRES D’INSTALLATION (<5.9 : CONFIG.XML - >=5.9 : CONFIG.PROPERTIES). . .54 SILVERPEAS........................................................56 PERSONNALISÉS DE 10RESSOURCES.................................................................................................57 10.1RESSOURCES..................................................................................................57 11CONCLUSION.................................................................................................61 Silverpeas Guide Administration Silverpeas v5.odt Page 5 1 À PROPOS DE CE GUIDE 1.1 Public concerné Ce guide s’adresse aux professionnels de l’informatique qui doivent déployer, migrer, administrer et exploiter Silverpeas. 1.2 Connaissances préalables Ce guide requiert les connaissances préalables suivantes : Administration Windows Server Administration Linux (Debian, Red Hat, Ubuntu, Fedora, etc…) Administration et exploitation SQL Server, Oracle ou PostgreSQL Recommandé : technologies des serveurs d’applications J2EE (Jboss) 1.3 Documents de référence Ce guide est complété par la documentation suivante : Aide utilisateur en ligne : permettant la compréhension des différents modules et fonctionnalités de Silverpeas, Les release-notes qui accompagnent chaque version évolutive de Silverpeas (voir en annexe) Les ressources accessibles depuis l'extranet clients 1.4 Conventions Les commandes à saisir sont indiquées en minuscule, gras et italique, Courier Les chemins et noms de fichiers sont indiqués en minuscule, Courier Les informations variables liées à l’environnement sont indiquées en MAJUSCULE GRAS 1.5 Aperçu Le guide se compose des chapitres suivants : « A propos de ce guide » est une introduction à lire attentivement avant toute lecture approfondie du guide, Le chapitre 2, « Structure Silverpeas » présente l’architecture technique et fonctionnelle de l’application, ses modes de distribution, des éléments de configuration technique, ainsi que la structure de fichiers apportée par une installation Silverpeas. Le chapitre 3, « La gestion des utilisateurs » explicite les mécanismes d’import, et d’authentification des utilisateurs du référentiel Silverpeas, Le chapitre 4, « La synchronisation LDAP » explicite le fonctionnement de la synchronisation à un annuaire LDAP, et fournit les modes opératoires. Le chapitre 5, « Les données Silverpeas » explicite la structure, l’emplacement et le traitement des données associées à un environnement Silverpeas, Le chapitre 6, « Installation » fournit les éléments et procédures en vue d’un déploiement Silverpeas, Silverpeas Guide Administration Silverpeas v5.odt Page 6 Le chapitre 7, « Corrections et évolutions » fournit les procédures en vue de mises à jour d’un environnement Silverpeas, Le chapitre 8, « Exploitation » apporte des éléments et procédures dans le cadre de l’exploitation au quotidien d’un environnement Silverpeas (sauvegardes, restaurations,…), Le chapitre 9, « Problèmes » apporte les informations et modes opératoires dans le cadre de dysfonctionnements en vue de diagnostiquer puis résoudre le problème. Le chapitre 10, « Paramètres Silverpeas », récapitule les différents paramètres de fonctionnement de Silverpeas. 1.6 Avertissement Certains modes opératoires sont susceptibles de subir des modifications du fait des apports associés aux correctifs et mises à jour en version 5.0. Il convient à chaque nouvelle distribution de lire attentivement la release note associée dans laquelle seront décrites les éventuelles modifications. 1.7 Assistance technique Tous les efforts ont été faits pour assurer l’exactitude du contenu de ce guide. Pour toute information complémentaire ou problème rencontré, vous pouvez contacter le service de support Silverpeas à l’adresse mail : [email protected]. Vous pouvez également vous connecter sur l’extranet Silverpeas : http://extranet.silverpeas.com Vous devez obligatoirement possédez un compte pour vous connecter à l’extranet. Si tel n’est pas le cas, vous pouvez demander sa création en contactant : [email protected] Silverpeas Guide Administration Silverpeas v5.odt Page 7 2 STRUCTURE SILVERPEAS 2.1 Architecture fonctionnelle L’application Silverpeas se découpe en trois parties fonctionnelles : 2.1.1 Silverpeas Core (Bus) Silverpeas Core constitue le moteur applicatif de Silverpeas. A ce titre, il anime les flux d’information associés aux applications et fournit un certain nombre de fonctions générales utilisables par ces mêmes applications. Constituant la partie « Corporate » du portail Silverpeas il intègre : Un moteur de notification, Un moteur de recherche, Un moteur de catégorisation (Plan de Classement), Un moteur de personnalisation, Un moteur de workflow, La gestion de l’interface graphique, Les mécanismes d’authentification et de gestion des droits. Il offre, en outre, un certain nombre de fonctionnalités de base : Outils (aide, plan du site, Editeur de Workflow, Editeur de formulaires…), Fonctionnalités d’espace personnel (agenda, gestionnaire de tâches, boîte de notification, centres d’intérêt, requêtes favorites). 2.1.2 Administration Le module d'administration est constitué de 3 volets de services : Outils : Moteur d'importation (à partir d'un descripteur xml) Editeur de formulaires Editeur de workflows Déploiement de portlets tierces Console SilverTrace de debug A propos Statistiques : La visualisation des utilisateurs connectés, La visualisation des statistiques de connexion, La visualisation des statistiques d’accès aux différentes applications, La visualisation des statistiques concernant le volume et nombre des publications La visualisation des statistiques sur les axes du Plan de Classement Plan de Classement : La gestion du plan des axes transversal de Silverpeas La gestion du thésaurus (synonymes) associé Administration : Utilisateurs & groupes La consultation des profils utilisateurs et droits afférents La gestion de la structure du portail (espaces, applications, gestion des droits). Silverpeas Guide Administration Silverpeas v5.odt Page 8 2.1.3 Les Applications Les applications (ou Peas) constituent les composants fonctionnels de Silverpeas. Chaque application offre un ensemble de fonctionnalités permettant de réaliser une mission dans le cadre de la gestion documentaire, la gestion collaborative ou la gestion de contenu. Voir l’aide en ligne pour plus d’informations sur chacune des applications. Certaines applications constituent des composants techniques visant à interfacer une application tierce (Hyperlink) ou offrant des fonctionnalités pouvant servir à d’autres applications (création de formulaires par ex.). Silverpeas Guide Administration Silverpeas v5.odt Page 9 2.2 Architecture technique Silverpeas repose sur la technologie J2EE. 2.2.1 Structure technique interne Le schéma ci-dessous décrit l’articulation des différents éléments techniques constituant une installation Silverpeas : Silverpeas Guide Administration Silverpeas v5.odt Page 10 2.2.2 Implémentation Pour mettre en œuvre ces éléments techniques, l’architecture technique est constituée des systèmes suivants : Serveurs : Serveur d’applications à la norme J2EE : indispensable pour le fonctionnement de l’application Silverpeas qui utilise des EJB. Il est par défaut utilisé également en tant que frontal Web de Silverpeas, et comme moteur de servlets (traitement jsp). Base de données : L’essentiel des données Silverpeas est stocké dans un SGBDR. Référentiel utilisateurs dans le cas d’une synchronisation à un référentiel externe. Serveur SMTP : Silverpeas utilise un serveur SMTP pour l’envoi des mails de notification. Serveur de fichiers (optionnel) : serveur sur lequel sont installées les données Silverpeas sous forme de fichiers. Clients : Navigateur Web Silverpeas Guide Administration Silverpeas v5.odt Page 11 2.2.3 Pré-requis, configuration En v5 les pré-requis concernant une installation Silverpeas sont les suivants : 2.2.3.1 Serveur applicatif Silverpeas C’est la machine sur laquelle vous allez installer votre serveur d’applications J2EE (Jboss par exemple), Silverpeas, ainsi que les différents modules techniques ou fonctionnels. Les pré-requis de cette machine sont les suivants : les pré-requis de Silverpeas : Processeur 2,5 Ghz recommandé, double coeur 4 Go de RAM minimum, 8 Go recommandé Disque dur en RAID recommandé en production Les logiciels suivants doivent par ailleurs obligatoirement être installés, configurés et opérationnels sur cette machine, conformément aux instructions remises par leurs éditeurs respectifs : Microsoft Windows 200X Server (64 bits de préférence) Linux Debian, RedHat, Ubuntu, Fedora, etc.. (64 bits de préférence) 2.2.3.2 Serveur de données Silverpeas C’est la machine sur laquelle vous allez installer le système de gestion de base de données que vous avez choisi. Les pré-requis de cette machine sont les suivants : Les pré-requis du serveur de données (Microsoft SQL Server, Oracle, Postgresql) que vous avez choisi pour l’exploitation de Silverpeas : reportez-vous à la notice éditeur de votre serveur de données pour toute information ; Les logiciels suivants doivent par ailleurs obligatoirement être installés, configurés et opérationnels sur cette machine, conformément aux instructions remises par leurs éditeurs respectifs : (au choix parmi la liste suivante :) o Microsoft SQLServer 2003 à 2012 o Oracle 8i à 11g o PostgreSQL 8.2 à 9.3 2.2.3.3 Serveur d’authentification Windows L’authentification silencieuse Windows de Silverpeas est basée sur Kerberos SPNEGO. Pour plus d'informations à ce sujet, contactez Silverpeas. 2.2.3.4 Plate-forme matérielle et logicielle côté clients Les postes clients, quant à eux, accèdent au portail Silverpeas dans un mode de connexion web, requérant la configuration suivante : Silverpeas Guide Administration Silverpeas v5.odt Page 12 Silverpeas OS: Linux, Windows Microsoft Internet Explorer 7+ Mozilla Firefox 2.0+ Chrome Opéra Safari Guide Administration Silverpeas v5.odt Page 13 2.3 Distributions produit 2.3.1 Projets spécifiques Distributions regroupant des développements spécifiques, hors licence produit Silverpeas, dont vous avez pu passer commande auprès de Silverpeas. Ils sont remis soit par le biais d’une distribution séparée (cédérom(s), envoi e-mail, ou autre), soit téléchargés automatiquement par Maven. 2.3.2 Correctifs Des correctifs sont régulièrement mis à disposition afin d’apporter une solution à des anomalies identifiées sur les versions initiales. Ces correctifs font l’objet de releases appelées versions correctives, mises à disposition via l'outil Maven et visibles sur http://www.silverpeas.org/ 2.4 Fichiers Silverpeas Une fois installé, Silverpeas met en place une arborescence de fichiers qui est décrite ci-après. %SILVERPEAS_HOME% est une variable correspondant au chemin indiqué lors de l’installation. Exemple : D:\Silverpeas(Windows) Remarque Les arborescences sont similaires, quel que soit le système d’exploitation utilisé (Windows ou Linux). Dossiers Description bin data (*) %SILVERPEAS_HOME% Silverpeas Contient les scripts et outils requis par Silverpeas (arrêt, démarrage, build…) et fichier pom.xml utilisé par Maven. Contient une partie des données de contenu de Silverpeas: images, fichiers joints, fichiers d’index, fichiers html, repository JCR. Ce répertoire peut être déporté sur un serveur de fichiers ou à un autre niveau d’arborescence. Le choix est fait lors de l’installation ou après. Guide Administration Silverpeas v5.odt Page 14 dbRepository Contient les différents éléments (scripts et fichiers de contribution) utilisés par l’application dbBuilder pour la gestion de la base de données Silverpeas (création, upgrade) initialize Contient différents éléments requis au démarrage de l’application. Contient les fichiers générés par Application builder (reconstruction de l’application) et qui contiennent la totalité de l’application: c'est le répertoire silverpeas.ear Contient les fichiers de log générés par Silverpeas. 1 fichier essentiel en exploitation : traces.txt Contient tous les fichiers de paramétrage de bas niveau de l’application (core et applications) Contient toutes les données source de l’application, utilisées pour la construction de l’application. Comporte un certain nombre de fichiers descripteurs utilisés par certaines applications (dont workflow) ainsi que les StringTemplates par défaut. Contient les éléments de paramétrage standard ou indiqués lors de l’installation, servant à l’activation de la configuration. Fichiers de propriétés utilisés par chacun des modules de Silverpeas pour l’enregistrement de logs dans traces.txt. Répertoire temporaire utilisé notamment lors de la generation de fichiers pdf au sein de certains composants. Contient les fichiers descripteurs de chacune des applications déployables (xml). jar log properties repository resources setup silvertrace temp xmlcomponents Important Silverpeas Guide Administration Silverpeas v5.odt Page 15 Pour le bon fonctionnement de Silverpeas, et pour obtenir une garantie de support, il est essentiel que cette arborescence ne soit pas modifiée, ainsi que les fichiers présents (sauf paramétrage spécifié ultérieurement) 3 LA GESTION DES UTILISATEURS 3.1 Qu’est-ce qu’un domaine ? Un domaine (au sens Silverpeas du terme) est un ensemble d’utilisateurs ainsi qu’une arborescence de groupes dans lesquels ils se trouvent classés. Un utilisateur peut se trouver dans 0, 1 ou plusieurs groupes. Le système des groupes doit être vu comme une arborescence de répertoires windows (un groupe n’a qu’un seul père au maximum) avec en plus une contrainte supplémentaire : deux groupes d’un même domaine ne peuvent avoir le même nom. A l’exception du domaine mixte, un domaine ne peut pas contenir des utilisateurs d’un autre domaine. 3.1.1 Informations principales disponibles id : l’id du domaine (deux ids sont réservés : -1 pour le domaine mixte et 0 pour le domaine Silverpeas. Ces deux domaines ne peuvent pas être supprimés) name : le nom du domaine. C’est ce nom qui est affiché dans la combo de la page de login. Les domaines sont ordonnés dans cette combo par ordre alphabétique. description : une description succincte du domaine à usage des Administrateurs propFileName : chemin d’accès complet vers le fichier de propriétés qui décrit le domaine (en général : « com.stratelia.silverpeas.domains.domain… ») className : nom de la classe Silverpeas qui gère le domaine. Cette classe doit descendre de AbstractDomainDriver authenticationServer : nom du serveur d’authentification qui gère l’authentification des utilisateurs de ce domaine. Il s’agit en fait du nom (court) du fichier de propriétés qui énumère les services d’authentifications utilisés (il se trouve dans « com.stratelia.silverpeas.authentication ») silverpeasserverurl: url par laquelle les utilisateurs de ce domaine accèderont à Silverpeas (important car cette url qui apparaitra dans les notifications) 3.1.2 Tables concernées Nom de la table : ST_Domain Silverpeas Guide Administration Silverpeas v5.odt Page 16 3.2 Les trois types de domaines possibles Il existe trois types de domaines possibles : les domaine SQL, le domaine Mixte et le domaine synchronisé à une base LDAP. Seul les domaines LDAP et SQL peuvent être crées en plusieurs exemplaires ; le domaine mixte et le domaine SQL silverpeas existe déjà à l’installation et ne peuvent donc pas être supprimés. 3.2.1 Le domaine Silverpeas But : Ce domaine par défaut permet de créer des utilisateurs et des groupes internes à Silverpeas. L’authentification de ces utilisateurs peut se faire soit par un mot de passe crypté en MD5 stocké dans la base, soit par un moyen externe (authentification LDAP, NTRIS, …). Actions possibles : - RECHERCHER UN UTILISATEUR OU UN GROUPE - EDITER LE DOMAINE - IMPORTER DES UTILISATEURS VIA UN FICHIER .CSV - AJOUT/SUPPRESSION/MODIFICATION/LECTURE DES - AJOUT/SUPPRESSION/MODIFICATION/LECTURE DES - Pas de synchronisation. UTILISATEURS GROUPES Tables spécifiques : Silverpeas Guide Administration Silverpeas v5.odt Page 17 3.2.2 Les domaines synchronisés à une base LDAP But : Ce domaine permet d’utiliser dans Silverpeas une base d’utilisateurs et de groupes créée dans et gérée par un annuaire au standard LDAP. Cela peut être un annuaire Novell Directory, Microsft ActiveDirectory ou OpenLDAP. Actions possibles : - IMPORT/SYNCHRONISATION/DÉSYNCHRONISATION/LECTURE DES UTILISATEURS ET DES GROUPES - Synchronisation. Tables spécifiques : Aucune 3.2.3 Le domaine Mixte But : Ce domaine permet de créer des groupes internes à Silverpeas pouvant contenir des utilisateurs venant de plusieurs autres domaines. Ce domaine en lui-même ne contient pas d’utilisateur propre à lui. Il ne peut être supprimé. Actions possibles : - AJOUT/SUPPRESSION/MODIFICATION/LECTURE DES GROUPES (LES GROUPES PEUVENT CONTENIR DES UTILISATEURS DE TOUS LES AUTRES DOMAINES). - PAS D’UTILISATEURS DANS Pas de synchronisation CE DOMAINE Tables concernées : Nom de la table : ST_Group Cette table centralise tous les groupes de tous les domaines. Pour les groupes du domaine mixte (domainId = -1) cette table est la table principale. Pour les autres domaines, c’est la table qui cache les infos sur les groupes. Noms de tables : ST_Group_User_Rel Même remarque que pour ST_Group. Silverpeas Guide Administration Silverpeas v5.odt Page 18 3.3 Les groupes Ils permettent d’organiser les utilisateurs par fonction. Ils se présentent sous forme arborescente. Il existe 2 types de groupes : Les groupes standards dont le contenu est rempli manuellement Ils obéissent aux règles suivantes : o Un groupe peut avoir 1 ou 0 père (les groupes ayant 0 père sont appelés groupes racine) o Un groupe peut contenir 0 à n utilisateurs du même domaine (seule exception : les groupes du domaine Mixte qui contiennent des utilisateurs de tous les autres domaines). o Un groupe peut contenir 0 à n sous-groupes qui appartiennent obligatoirement au même domaine que leur père (et là, pas d’exception…) Le nom des groupes est unique au sein d’un même domaine o Un utilisateur peut être contenu dans plusieurs groupes ( retirer un utilisateur d’un groupe ne supprime pas l’utilisateur) Les groupes dynamiques dont le contenu est rempli selon une règle de synchronisation o Cette règle de synchronisation peut porter sur le profil de l'utilisateur ou sur ou tout autre attribut dans le cadre d'un attribut LDAP ou SQL. Il est également possible de spécifier la règle DS_domain = utilisateurs> pour récupérer tous les utilisateurs d'un domaine. <id du domaine 3.3.1 Informations disponibles id : l’id unique (pour tous les domaines) du groupe domainId : l’id du domaine dans lequel se trouve le groupe specificId : l’id du groupe dans le contexte du domaine (cet id n’est pas forcément un chiffre et n’est unique que pour un domaine donné). superGroupId : l’id unique du groupe parent (null si groupe racine) name : le nom du groupe description : un court descriptif du groupe synchrorule : règle de synchronisation Silverpeas Guide Administration Silverpeas v5.odt Page 19 3.3.2 Tables concernées Nom de la table : ST_Group Silverpeas Guide Administration Silverpeas v5.odt Page 20 3.4 Les utilisateurs Ils contiennent trois types d’informations : les informations ‘standards’ qui sont le plus fréquemment utilisées mais qui ne changent que très rarement : noms, email, login. les informations ‘spécifiques Silverpeas’ qui permettent de savoir de quel domaine vient l’utilisateur et quels sont ses droits. les informations ‘générales’ qui dépendent de chaque domaine et sont décrites dans le fichier de propriété descriptif du domaine. Les informations ‘standards’ et ‘spécifiques Silverpeas’ sont stockées en base SQL. Les informations ‘générales’, elles sont récupérées directement dans la base du domaine et ne sont pas mises en cache. 3.4.1 Informations disponibles Les informations mises en cache dans la table ST_User (rafraîchies lors des synchronisations) : firstName : le prénom de l’utilisateur lastName : le nom de l’utilisateur email : l’adresse email principale de l’utilisateur login : le login de l’utilisateur Les informations spécifiques à Silverpeas dans la table ST_User : id : l’id unique (pour tous les domaines) de l’utilisateur loginMail : n’est plus utilisé accessLevel : ‘U’ pour un utilisateur, ‘A’ pour un administrateur, 'K' pour gestionnaire du Plan de classement, 'R' pour utilisateur supprimé, 'D' pour un gestionnaire de domaine domainId : l’id du domaine dans lequel se trouve l’utilisateur specificId : l’id de l’utilisateur dans le contexte du domaine (cet id n’est pas forcément un chiffre et n’est unique que pour un domaine donné). Les informations obtenues dynamiquement à chaque demande : Ces informations dépendent des properties du domaine. Elles ont un label (multilangue), un type (STRING ou USER_ID) et une valeur (qui peut être null). Elles ne sont pas stockées dans la table ST_USER mais sont directement lues dans la base du domaine de l’utilisateur. 3.4.2 Tables concernées Nom de la table : ST_User Silverpeas Guide Administration Silverpeas v5.odt Page 21 3.5 Authentification Silverpeas permet différentes authentifications : Authentification interne Silverpeas : un mot de passe est saisi pour l’utilisateur à sa création, ce mot de passe étant stocké crypté en base de données Silverpeas. La base est alors interrogée à chaque authentification. Valable uniquement pour des utilisateurs du domaine Silverpeas. Authentification LDAP : associée à un domaine de synchronisation LDAP. Lorsque l'utilisateur saisi son login et mot de passe, ce service interroge le serveur LDAP pour vérifier que ces informations sont correctes. Il peut alors accéder à Silverpeas. OPTION: Authentification silencieuse Kerberos SPNEGO: le login et le mot de passe ne sont pas renseignés par l’utilisateur. Lors de la demande de connexion d’un utilisateur, l’authentification sur le domaine est effectuée par le service SPNEGO (en option avec Silverpeas). Ce service interroge le serveur de domaine pour vérifier que le login/mot de passe de la session Windows en cours correspond bien à un utilisateur Silverpeas. Si c'est le cas, il peut alors accéder à Silverpeas. Silverpeas Guide Administration Silverpeas v5.odt Page 22 4 SYNCHRONISATION LDAP 4.1 Les différentes structures LDAP 4.1.1 Introduction Il y a plusieurs façons de stocker et organiser les utilisateurs sous LDAP. Chaque stratégie a ses avantages et ses inconvénients. Le choix de l’une ou l’autre dépend de beaucoup de paramètres spécifiques à chaque entreprise. Le driver de domaine LDAP peut accéder à un maximum d’organisations tout en restant relativement facile à configurer. Dans ce chapitre, nous allons présenter les principaux types d’organisation des répertoires LDAP. 4.1.2 Le modèle Flat Tree (recommandation LDAP) root dc=stratelia,dc=com People User1 Places dc=XYZ, dc=com Groups Applications Group 1 Group 2 User1 User4 ... User2 User4 ... User2... Tous les utilisateurs se trouvent dans une seule branche : People. Tous les groupes se trouvent dans la branche Groups et sont tous définis par un seul objet qui contient une référence (DN) vers chaque utilisateur du groupe. Ce modèle a l’avantage d’être simple à concevoir, utiliser et maintenir. Par contre, il est difficile d’y configurer des droits d’accès ou des réplications partielles. Il convient parfaitement pour des petites sociétés ou pour des sociétés qui changent souvent d’organisation. Il est accessible avec le driver LDAP grâce a la gestion de groupes nommée ‘UniqueDescriptor’. Silverpeas Guide Administration Silverpeas v5.odt Page 23 4.1.3 Le modèle Deep Tree (recommandation X500) root c=US East Coast Finance Central IT Vendors User 1 (Vendor A) c=UK West Coast Manufacturing Other HR Management User 2 (Vendor B) Group 1 : Room 123 Group 2 : Room 64 User1 User3 ... User2 ... User 3 (Vendor C) Consultants User 4 (Consultant A) User 5 (Consultant B) Les utilisateurs et les groupes se trouvent dispatchés dans différentes branches de l’arbre. L’architecture de l’arbre peut être basée sur des principes différents (organisationnels, géographiques, fonctionnels, administratifs, …). Elle peut aussi être une combinaison de plusieurs de ces principes. Silverpeas Guide Administration Silverpeas v5.odt Page 24 La notion même de groupe peut avoir plusieurs représentations : 1) Comme dans le cas de Flat Tree, il est possible d’avoir une (ou des) branche(s) qui contient les objets descripteurs de groupes (cf « Group 1 » et « Group 2 »). 2) Il est aussi possible de considérer que tous les fils d’un nœud sont des éléments appartenant à un même groupe (cf « Consultants » et « Vendors »). 3) La notion 2 peut être affinée en ne prenant que les fils d’un certain type (p.ex. « organizationalPerson ») ou ayant un champ égal à une certaine valeur (p.ex. « memberOf »). 4) Enfin, il est possible d’avoir un nœud contenant des éléments établissant une relation 1-1 entre un utilisateur et un groupe. Cette notion, très utilisée dans le cas des bases de données relationnelles n’est cependant pas la plus courante pour ce qui est des représentations LDAP. Ce modèle a l’avantage d’être complet et d’être facilement lisible car il est en général calqué sur l’organisation de l’entreprise familière aux utilisateurs. Il permet aussi très facilement de gérer les droits de chaque groupe d’utilisateurs. Par contre, il est difficile d’y faire des requêtes de recherches et d’y faire des modifications. Par exemple, si un utilisateur change de service, il faudra le déplacer vers un autre répertoire ; ce qui implique un changement de son DN. Ce changement peut poser certains problèmes si d’autres applications se basent sur ce DN pour identifier de façon unique un utilisateur (ce qui est d’ailleurs la raison d’être de ce champ…). Une entreprise choisissant ce mode d’arborescence doit donc être consciente que toute modification de structure ou changement de poste représente une tache de mise à jour de la base qui est loin d’être négligeable. Les types de groupes 1) sont accessibles avec le driver LDAP grâce a la gestion de groupes nommée ‘UniqueDescriptor’. Les types de groupes 2) et 3) sont accessibles avec le driver LDAP grâce a la gestion de groupes nommée ‘SubTree’. Les types de groupes 4) ne sont pas accessibles avec le driver LDAP. Enfin, il n’est pas possible d’accéder a la fois à des groupes de type 1) et à des groupes de type 2) ou 3). Silverpeas Guide Administration Silverpeas v5.odt Page 25 4.2 La synchronisation 4.2.1 Les trois types de synchronisation 4.2.1.1 La synchronisation complète Cette opération n’est faisable que par l’administrateur via l'administration. Cette synchronisation effectue un match complet entre le cache Silverpeas des utilisateurs du domaine et la base LDAP de ce domaine. Les utilisateurs qui n’existent plus sont supprimés, les nouveaux utilisateurs sont ajoutés et les utilisateurs dont les informations cachées (nom, prénom, email) ont changées sont mis à jour. Les groupes qui n’existent plus sont supprimés, les nouveaux groupes sont ajoutés et les groupes dont la description a changé sont mis à jour. Cette synchronisation est à faire une fois lors de l’installation de l’application. 4.2.1.2 La synchronisation unitaire manuelle Cette opération n’est faisable que par l’administrateur via l'administration. Elle permet d’importer, synchroniser ou désynchroniser un seul utilisateur ou un seul groupe à la fois. Voir les paragraphes 4.2.2 et 4.2.3 pour savoir ce qui est synchronisé dans chaque cas. Lorsqu’un groupe ou un utilisateur est « désynchronisé », il est retiré de la base Silverpeas mais il n’est pas stocké dans une blacklist. Du coup, il sera de nouveau ajouté si on fait une synchronisation complète ou si l’utilisateur se connecte à nouveau et que la synchronisation automatique est activée. 4.2.1.3 La synchronisation « threadée » La synchronisation « threadée » et la synchronisation complète sont identiques en terme de comportement. Elle se fait en tâche de fond pour garantir une adéquation des droits entre l’annuaire LDAP et Silverpeas. Elle est activable grâce à une propriété du fichier de properties qui décrit le domaine (voir chapitre 4.3.1). Celle-ci peut être planifiée à tout moment grâce à un cron. Remarque : Si on souhaite ne jamais supprimer d'utilisateurs lors d'une synchronisation planifiée, le paramètre DelUsersOnThreadedSynchro doit être positionné à false (par défaut true). Silverpeas Guide Administration Silverpeas v5.odt Page 26 4.2.2 La synchronisation des informations relatives a un utilisateur 4.2.2.1 Les différents éléments touchés par cette synchronisation La synchronisation d’un utilisateur (ou l’import d’un utilisateur) modifie d’autres éléments en dehors des informations relatives à cet utilisateur. Liste des éléments synchronisés : Tous les groupes (Gi) auxquels appartient cet utilisateur. Pour chacun de ces groupes (Gi), tous les utilisateurs(Uij) et tous les sousgroupes (Gij) qui appartiennent au groupe. Cependant, pour les utilisateurs Uij, seules les informations relatives à ces utilisateurs sont synchronisées. Les groupes auxquels ils appartiennent ne sont pas récursivement synchronisés. 4.2.2.2 Les informations synchronisées Les informations suivantes sont mises a jour lors de la synchronisation d’un utilisateur : firstName : le prénom de l’utilisateur lastName : le nom de l’utilisateur email : l’adresse email principale de l’utilisateur Cas particulier du Login : le login sert de clé unique pour un même domaine. Un utilisateur ne peut donc pas changer de login. Un changement de login revient à une suppression de l’utilisateur avec l’ancien login et à la création d’un utilisateur avec le nouveau login. Toutes les autres informations relatives à l’utilisateur sont directement lues dans l’annuaire. La synchronisation n’a donc pas d’impacte dessus. 4.2.3 La synchronisation des informations relatives a un groupe 4.2.3.1 Les différents éléments touchés par cette synchronisation La synchronisation d’un groupe (ou l’import d’un groupe) modifie d’autres éléments en dehors des informations relatives à ce groupe. Liste des éléments synchronisés : Tous les sous-groupes (Gi) qui ont ce groupe comme ancêtre. Tous les utilisateurs (Ui) qui appartiennent à ce groupe ou à un de ses descendants. Cependant, pour les utilisateurs Ui, seules les informations relatives à ces utilisateurs sont synchronisées (y compris leur appartenance ou non aux groupes). Les groupes auxquels ils appartiennent ne sont cependant pas récursivement synchronisés. 4.2.3.2 Les informations synchronisées Les informations suivantes sont mises a jour lors de la synchronisation d’un groupe : description : un court descriptif du groupe Cas particulier du superGroupId et du name : ces informations ne changent pas. Si un groupe n’est plus fils du père qui lui avait été fixé lors de son import, il est considéré comme supprimé. Un nouveau groupe est alors importé et est rattaché à son nouveau père. Toute le sous-arborescence de ce groupe subit le même traitement. 4.3 Les opérations possibles avec un domaine LDAP synchronisé 4.3.1 Paramétrage du domaine Il se fait grâce à un fichier properties en 4 parties. Ce fichier est d’ordinaire stocké dans le répertoire « properties\com\stratelia\silverpeas\domains ». Silverpeas Guide Administration Silverpeas v5.odt Page 27 4.3.1.1 Partie 1 : Accès à l’annuaire Tous ces paramètres permettent de configurer l’endroit ou se trouve l’annuaire ainsi que les options choisies lors de l’établissement de la connexion. database.LDAPHost= database.LDAPImpl=openldap database.LDAPPort=389 database.LDAPProtocolVer=3 database.LDAPAccessLoginDN=CN=Night Bird,CN=Users,DC=TSTEXCHANGE database.LDAPAccessPasswd=nb database.LDAPUserBaseDN=OU=MegaUsers,DC=TSTEXCHANGE # Client Time in MS database.LDAPMaxMsClientTimeLimit=0 # Server Time in Seconds database.LDAPMaxSecServerTimeLimit=0 database.LDAPMaxNbEntryReturned=5000 database.LDAPMaxNbReferrals=0 database.LDAPBatchSize=5000 database.LDAPSearchRecurs=true database.LDAPOpAttributesUsed=true Remarques : En dehors des paramètres LDAPAccessLoginDN, LDAPAccessPasswd et LDAPUserBaseDN, les autres valeurs ne doivent pas être modifiées à la légère. Le paramètre LDAPImpl est égal à openldap si l’annuaire connecté est au standard openldap, vide sinon (MSAD par exemple). Les paramètres LDAPMaxNbEntryReturned et LDAPBatchSize doivent être à la même valeur Si on désire enchaîner plusieurs sites LDAP, il suffit de séparer les noms des serveurs par un espace (ex. « LDAPHost = FIRSTSITE SECONDSITE »). Si on désire affecter des ports d’accès différents a chacun de ces sites, il faut ajouter « : » et le N° de port (ex. « LDAPHost = FIRSTSITE:389 SECONDSITE:844 »). Si l’on désire synchroniser plusieurs branches de l’annuaire il faut séparer les branches par deux points virgules : - LDAPUserBaseDN=ou=users1,ou=company;;ou=users2,ou=company LDAPOpAttributesUsed=true permet d’utiliser les attributs opérationnels qui ne sont normalement pas accessibles vie une requête LDAP standard. # Synchro parameters # -----------------# modifyTimeStamp or uSNChanged or whenChanged (20041104131450.0Z) synchro.timeStampVar= modifyTimeStamp synchro.Threaded=false Remarque : Si le paramètre « synchro.Threaded » est à « true », une synchronisation sera lancée périodiquement selon le paramètre DomainSynchroCron du fichier admin.properties. (syntaxe de type crontab) Le paramètre « synchro.timeStampVar » permet de définir la variable LDAP utilisée pour détecter les éléments de l’annuaire ayant été ajoutés, modifiés ou supprimés depuis la dernière synchronisation. Silverpeas Guide Administration Silverpeas v5.odt Page 28 4.3.1.2 Partie 2 : Accès aux utilisateurs # Users' settings # --------------users.ClassName=user users.Filter=(mail=*) users.IdField=sAMAccountName users.LoginField=sAMAccountName users.FirstNameField=givenName users.LastNameField=sn users.EmailField=mail Remarques : Le ClassName par défaut n’est forcément le bon (user ou people suivant les annuaires) Le filtre ne doit pas être vide. Il est au format standard de requête LDAP IdField pointe sur la clé primaire qui permet de différencier de façon unique chaque utilisateur. Il est fortement recommandé de choisir un identifiant ne changeant pas, comme clé. Tous ces paramètres seront stockés en cache dans la base Silverpeas. 4.3.1.3 Partie 3 : Description des informations disponibles par utilisateur # USERS Specific Properties # ------------------------# Property number : from 1 to N # Available Types : STRING, USERID # MapParameter : Name of the LDAP corresponding field property.Number = 4 property.ResourceFile com.stratelia.silverpeas.domains.multilang.domainLDAPBundle = property_1.Name = title property_1.Type = STRING property_1.MapParameter = title property_1.UpdateAllowedTo = U property_2.Name = company property_2.Type = STRING property_2.MapParameter = company property_3.Name = position property_3.Type = STRING property_3.MapParameter = department property_4.Name = boss property_4.Type = USERID property_4.MapParameter = manager Remarques : On peut définir autant de properties que l’on veut Les fichiers de ressource « property.ResourceFile » contiennent les textes associés aux propriétés dans les différentes langues (ex : « title = Poste ») L'attribut UpdateAllowedTo permet de spécifier si la propriété est en écriture (valeurs : U=par l'utilisateur, A=par les administrateurs, D=Par les Gestionnaires du domaine) Silverpeas Guide Administration Silverpeas v5.odt Page 29 4.3.1.4 Partie 4 : Accès aux groupes # Groups' settings # ---------------groups.ClassName=group groups.Filter=(member=*) # Set the id Field to the 'cn' insteed of the DN to allow groups to move in the LDAP # database groups.IdField=cn # Use com.stratelia.silverpeas.domains.ldapdriver.LDAPGroupSubTree to access groups # that are just node with users and sub-groups as sons # Use com.stratelia.silverpeas.domains.ldapdriver.LDAPGroupUniqueDescriptor to access # groups that contains an attribute containing DN of all there sons groups.Type=com.stratelia.silverpeas.domains.ldapdriver.LDAPGroupUniqueDesc riptor Remarque : Suivant le type de driver de groupe, certaines propriétés supplémentaires sont paramétrables. Cas com.stratelia.silverpeas.domains.ldapdriver.LDAPGroupUniqueDescriptor : # For LDAPGroupUniqueDescriptor only : # -----------------------------------# The field that contains the child's DNs groups.MemberField=member # If groups.SpecificGroupsBaseDN is not set, database.LDAPUserBaseDN is used as root # for searchs groups.SpecificGroupsBaseDN=OU=MegaGroups,DC=TSTEXCHANGE Remarque : La propriété « groups.SpecificGroupsBaseDN » permet de fixer une racine de recherche différente de celle précisée par « database.LDAPUserBaseDN ». Les groupes vides ne sont pas importés Cas com.stratelia.silverpeas.domains.ldapdriver.LDAPGroupSubTree : # For LDAPGroupSubTree only : # --------------------------groups.IncludeEmptyGroups=true groups.NameField=name groups.DescriptionField=description Silverpeas Guide Administration Silverpeas v5.odt Page 30 4.3.2 Exemple d’ajout d’un domaine En administration, dans l’onglet Utilisateurs & groupes : 1) Choisir ‘Ajouter un domaine :’ 2) Entrer les informations relatives à ce domaine : Saisir notamment le nom des fichiers de properties de paramétrage (pour la synchronisation) et son équivalent pour l’authentification que vous avez crée plus haut. Remarques : Le nom du domaine est celui qui apparaît dans la page de login : Silverpeas Guide Administration Silverpeas v5.odt Page 31 Ils apparaissent par ordre alphabétique (celui qui est par défaut est celui qui est le plus proche du ‘a’). Le « Properties de paramétrage » est le fichier de configuration qui permet d’accéder à l’annuaire (cf. 4.3.1). Le « PropertiesAuthentification » est le nom court (sans le chemin) du fichier properties qui gère l’authentification des utilisateurs de ce domaine. Il faut noter que ce fichier est complètement dissocié du fichier de paramétrage, car bien que lié dans 99% des cas, il n’est en effet pas obligatoire d’authentifier les utilisateurs d’un domaine synchronisé à une base LDAP auprès de cette base ; ils peuvent être authentifiés auprès d’un serveur tiers. 3) Valider 4) Créer sur le serveur Silverpeas les fichiers de properties nécessaires : Pour l’authentification : properties/org/silverpeas/authentication/autMyLDAP.properties Pour la synchronisation: properties/org/silverpeas/domains/domainMyLDAP.properties Eventuellement créer le ou les fichiers de multilang associés (un par langue) : properties/org/silverpeas/domains/multilang/domainMyLDAPBundle_fr.properties Silverpeas Guide Administration Silverpeas v5.odt Page 32 4.3.3 Synchronisation complète Pour synchroniser complètement un domaine, il suffit d’aller dans l’administration, dans le volet ‘Utilisateurs & Groupes’ et de sélectionner le domaine à synchroniser et de choisir l’option ‘synchroniser le domaine’ dans le menu déroulant La fenêtre de confirmation suivante apparaît alors : Ce n’est qu’après avoir validé que la synchronisation complète démarrera. ATTENTION : suivant le nombre de groupes et d’utilisateurs, la synchronisation complète peut prendre jusqu’à plusieurs heures ! Une fois la synchronisation effectuée, un rapport s’affiche : Silverpeas Guide Administration Silverpeas v5.odt Page 33 Une fois cette synchronisation effectuée, il n’est pas nécessaire de redémarrer le serveur d’application. Silverpeas Guide Administration Silverpeas v5.odt Page 34 4.3.4 Changement de DNs Une société peut être amenée à changer sa structure LDAP. Dans certains cas, Silverpeas pourra tout de même conserver les utilisateurs et les groupes synchronisés ; ceci moyennant une adaptation des paramètres de synchronisation. Voici la procédure à appliquer pour limiter les risques de perte d’utilisateurs ou de groupes : 1) AVANT de faire les modifications de structure de la base LDAP 2) Faire une sauvegarde de la base SQL Silverpeas 3) Créer un nouveau fichier de paramétrage (ex : « domainNouveau.properties ») à partir de l’ancien fichier (ex : « domainAncien.properties »). 4) Modifier le fichier « domainNouveau.properties » de façon à ce qu’il satisfasse a la nouvelle structure qui sera mise en place. 5) Se loguer AVEC LE LOGIN INITIAL D’ADMINISTRATEUR SILVERPEAS 6) Aller dans l’administration, sélectionner le domaine à modifier 7) Choisir l’option modifier le domaine 8) Faire pointer le fichier de paramétrage vers « domainNouveau.properties » 9) Arrêter le serveur Silverpeas 10) Faire les modifications de structure de la base LDAP 11)Redémarrer le serveur Silverpeas 12)Se loguer AVEC LE LOGIN INITIAL D’ADMINISTRATEUR SILVERPEAS 13)Aller dans l’administration, sélectionner le domaine à vérifier 14.a) Pour tester l’accès aux utilisateurs, sélectionner un utilisateur puis le synchroniser. Si une erreur survient, c’est que le fichier de paramétrage est mal configuré. Le modifier, redémarrer le serveur d’application et re-tester… 14.b) Pour tester l’accès aux groupes, sélectionner un groupe puis le synchroniser. Si une erreur survient, c’est que le fichier de paramétrage est mal configuré. Le modifier, redémarrer le serveur d’application et re-tester… Remarques : Il n’est pas nécessaire de refaire une synchronisation complète de tout le domaine. En cas de problèmes graves, revenir à la sauvegarde Pendant toute l’opération mettre le serveur en maintenance (pas d’accès possible de l’extérieur) Silverpeas Guide Administration Silverpeas v5.odt Page 35 5 LES DONNÉES SILVERPEAS 5.1 Définitions On appelle données Silverpeas, toutes les informations qui seront apportées en phase de production au sein de Silverpeas, que ce soit par les administrateurs ou utilisateurs. Ces données comprennent : Les utilisateurs et les groupes, la structure définie au sein de l’administration de Silverpeas : organisation des utilisateurs, espaces, applications, droits, etc… Les différentes publications effectuées au sein des applications et de la plateforme Silverpeas, Les éléments d’indexation, Les fichiers externes (fichiers joints, images,...) L’emplacement des données est parfaitement identifié au sein d’une installation Silverpeas ce qui permet des restaurations, sauvegardes et transferts de serveur à serveur aisés. Ces données sont situées d’une part dans la base SQL, d’autre part dans un répertoire de l’installation. Remarque Les données n’intègrent pas les informations de paramétrage. Dans le cadre d’une sauvegarde complète, il conviendra de sauvegarder les informations de paramétrage en vue de reconstruire un serveur à l’identique (voir Chapitre Exploitation). 5.2 Données en base La base de données utilisée par Silverpeas est constituée de différentes tables contenant l’essentiel des données : les utilisateurs et les groupes, la structure définie au sein de l’administration Silverpeas : organisation des utilisateurs, espaces, applications, droits, Les différentes publications effectuées au sein des applications et de la plateforme Silverpeas, Exemple : table st_user qui contient la liste des utilisateurs. 5.3 Répertoire data Le répertoire %SILVERPEAS_DATA_HOME%\data contient le reste des données : Les éléments d’indexation, index Les fichiers externes (fichiers joints, images,...) workspaces Fichiers html produits par certaines modules Modèles de workflow workflowRepository Formulaires XML templateRepository La gestion de la JCR jackrabbit Le paramétrage et le stockage des informations liés aux portlets (configuration des utilisateurs) portlets Personnalisation des notifications et autres écrans StringTemplates Silverpeas Guide Administration Silverpeas v5.odt Page 36 Les applications Web en relation avec Silverpeas web.war (weblib, websites ) Silverpeas Guide Administration Silverpeas v5.odt Page 37 6 INSTALLATION ET MISE À JOUR 6.1 Objectif L’objectif de ce chapitre est de vous permettre d’installer ou de mettre à jour un Silverpeas. Trois modes opératoires sont indiqués, le premier concernant une première installation de Silverpeas, le second concerne la mise à jour d’une version Silverpeas antérieure et le troisième l'installation d'un Silverpeas sur un autre serveur avec reprise des données d'un autre Silverpeas. 6.2 Nouvelle installation de Silverpeas 6.2.1 Liste des éléments à installer Une installation Silverpeas comporte pour fonctionner au minimum les éléments suivants : Les pré-requis hardware Les pré-requis logiciels : Silverpeas V5 Le serveur d’applications J2EE Jboss6 obligatoire à partir de Silverpeas 5.7 Apache Maven 3 Sun Oracle JDK 6 Spécifiques éventuels (looks, applications) Pour cela, vous devez aller sur http://www.silverpeas.org/installation et récupérer les 3 urls nécessaires à l’installation (Silverpeas, Jboss, Maven). La procédure complète d’installation est décrite sur http://www.silverpeas.org/installation Silverpeas Guide Administration Silverpeas v5.odt Page 38 6.3 Patch ou mise à jour d'une installation existante 6.3.1 Version majeure, évolutive et corrective La nomenclature de Silverpeas distingue 3 types de versions : Majeure (5) Evolutive (5.x) Corrective (5.x.x) Nota : Comme leur nom l’indique, les versions correctives ne contiennent pas d’évolutions du produit mais seulement des correctifs. Consultez la roadmap Silverpeas sur https://tracker.silverpeas.org/projects/silverpeas/roadmap pour en savoir plus et connaître les dates de sortie des différentes versions. 6.3.2 Mise à jour évolutive Reportez vous à la release-note de la version correspondante sur http://www.silverpeas.org/docs/core/releasenotes.html car il vous faudra reprendre la dernière version à jour de l’archive Silverpeas. Cette archive comprend 2 répertoires : bin et setup De manière générale, nous conseillons de procéder comme suit : • Sauvegarder votre fichier $SILVERPEAS_HOME/bin/pom.xml • Extraire l'archive dans $SILVERPEAS_HOME • Remplacer le pom.xml extrait par celui sauvegardé en mettant à jour la version de Silverpeas dans ce dernier: <?xml version="1.0" encoding="UTF-8"?> <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"> <modelVersion>4.0.0</modelVersion> <parent> <groupId>com.silverpeas</groupId> <artifactId>assembly-silverpeas</artifactId> <version>5.14.1</version> </parent> <packaging>pom</packaging> <groupId>com.silverpeas</groupId> <artifactId>assembly-sdk</artifactId> <version>5.0</version> <name>Assembly SDK</name> Silverpeas Guide Administration Silverpeas v5.odt Page 39 6.3.3 Mise à jour corrective Sauf indication contraire indiquant qu'il faut procéder comme pour une mise à jour évolutive, elle s’effectue grâce à l’outil Maven qui va ramener la mise à jour depuis les serveurs distants de Silverpeas : Modifier le fichier pom.xml du répertoire $SILVERPEAS_HOME/bin Les lignes en rouge sont à modifier lors de versions correctives. Extrait d’un pom.xml significatif : <?xml version="1.0" encoding="UTF-8"?> <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"> <modelVersion>4.0.0</modelVersion> <parent> <groupId>com.silverpeas</groupId> <artifactId>assembly-silverpeas</artifactId> <version>5.14.1</version> </parent> <packaging>pom</packaging> <groupId>com.silverpeas</groupId> <artifactId>assembly-sdk</artifactId> <version>5.0</version> <name>Assembly SDK</name> Modifiez la installer. valeur en rouge en fonction de la version corrective que vous voulez Vous procéderez de la même manière pour mettre à jour un look client ou une application spécifique : exemple : <dependencies> <dependency> <groupId>com.silverpeas.customers.client.look</groupId> <artifactId>look-war</artifactId> <type>war</type> <version>1.2</version> </dependency> <dependency> <groupId>com.silverpeas.customers.mgi.look</groupId> <artifactId>look-config</artifactId> <version>1.2</version> … <classifier>configuration</classifier> </dependency> Cependant, depuis 2011, les spécifiques clients sont maintenant automatiquement installables via Maven. Pour cela reportez-vous à la partie Installation des spécifiques clients. Silverpeas Guide Administration Silverpeas v5.odt Page 40 Puis exécutez la procédure habituelle : Arrêter Silverpeas. En ligne de commande depuis le répertoire $SILVERPEAS_HOME\bin, tapez : o mvn clean install o appBuilder o SilverpeasSettings o Dbbuilder Démarrez Silverpeas. 6.3.4 Installation des spécifiques clients On entend par spécifiques clients toute application ou développement ne faisant pas partie de Silverpeas Open Source.(exemple: look client). Plusieurs éléments de votre configuration sont à vérifier pour que Maven prenne en charge l'installation de vos spécifiques. Vérification de $SILVERPEAS_HOME/bin/pom.xml Rappel: c'est ce fichier qui est lu par Maven pour déterminer ce qu'il doit installer. <repositories> <repository> <id>Silverpeas</id> <layout>default</layout> <name>Silverpeas Repository</name> <url>http://www.silverpeas.org/nexus/content/groups/silverpeaspro</url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>true</enabled> </snapshots> </repository> </repositories> Vous ne devez avoir qu'un bloc <repository> et vérifiez les éléments suivants : id: Silverpeas url: http://www.silverpeas.org/nexus/content/groups/silverpeas-pro Configuration pour Maven Pour récupérer les spécifiques clients, Maven a besoin de deux fichiers: setting-security.xml et settings.xml Ces 2 fichiers sont situés dans le répertoire local de l'utilisateur qui lance Maven. Silverpeas Guide Administration Silverpeas v5.odt Page 41 En général dans : /home/<user>/.m2/ sur Linux/Unix. ou c:\Documents And Settings\<user>\.m2 sur Windows. S'ils n'existent pas, créez les. o Contenu du fichier settings-security.xml : <settingsSecurity> <master>{OI1E45PMwZcHqg+y+7nSri90rr5dpVMTvxwde6KJFNk=}</master> </settingsSecurity> o Contenu du fichier settings.xml : Ce fichier existe peut-être déjà si vous utilisez un proxy pour sortir sur Internet. En voici un exemple, seule la partie en gras est obligatoire : <settings> <proxies> <proxy> <active>true</active> <protocol>http</protocol> <host>proxy </host> <port>80</port> <username>proxyuser</username> <password>mdp</password> <nonProxyHosts></nonProxyHosts> </proxy> </proxies> <offline>false</offline> <servers> <server> <id>Silverpeas</id> <username>silverpeas</username> <password>{VSVUl/LoVd4Hmnw8f4sZLKG4WbAfkPIvgeKMIEIRa7c=}</password> </server> </servers> </settings> Vous pouvez maintenant exécuter les outils habituels pour mettre à jour votre plateforme Silverpeas, Maven installera ou mettra à jour automatiquement vos spécifiques en plus de l'applicatif Silverpeas. Silverpeas Guide Administration Silverpeas v5.odt Page 42 6.3.5 Applications web dépendantes de Silverpeas (Sites web avec taglibs) Avant la version 5.9 et lors d'une mise à jour, il fallait reporter dans le fichier $SILVERPEAS_HOME/jar/silverpeas.ear/META-INF/application.xml les différentes applications web (comme par exemple un site Web) dépendantes de Silverpeas. Dorénavant, cette opération est automatiquement réalisée à l'aide d'un script Groovy. Celui-ci peut-etre copié n'importe où, par exemple dans le répertoire scripts : $SILVERPEAS_HOME/bin/scripts/ En voici un exemple avec 2 sites web (webapp1 et webapp2) : /** * Script launched by CustomerSettings.xml to update the application.xml file with * the declaration of the web sites silverpeasmobile and oevo. */ import groovy.xml.* println "\nUpdate application.xml with the web modules..." String applicationXmlPath = SILVERPEAS_HOME + "/jar/silverpeas.ear/METAINF/application.xml" def slurper = new XmlSlurper() slurper.setKeepWhitespace(true) def applicationXml = slurper.parse(new File(applicationXmlPath)) def webModules = applicationXml.'**'.grep { ['webapp1.war', 'webapp2.war'].contains(it.'web-uri') } if (webModules.isEmpty()) { println "update application.xml" applicationXml.appendNode { module { web { 'web-uri'('webapp1.war') 'context-root'('webapp1') } } module { web { 'web-uri'('webapp2.war') 'context-root'('webapp2') } } } XmlUtil.serialize(applicationXml, new File(applicationXmlPath).newWriter()) } else { println "The web modules are already declared in application.xml" } Silverpeas Guide Administration Silverpeas v5.odt Page 43 println "application.xml update done"/** Pour une autre application Web, il suffit d'ajouter un paragraphe module. Enfin, il faut indiquer à SilverpeasSettings qu'il doit lire ce script. Pour cela, ajouter la ligne suivante dans votre CustomerSettings.xml (ou <Client>Settings.xml) <script name="${SILVEREPEAS_HOME}/bin/scripts/updateApplicationXml.groovy"/> 6.3.6 Fonction et chronologie des outils Silverpeas 6.3.7 Spécificités Certaines mises à jour de version évolutive peuvent comporter des interventions spécifiques : correction des données en fichiers,… . Ces interventions spécifiques sont décrites dans la release-note associée. Il est donc très important de suivre précisément ces instructions. Important Prenez connaissance de la release note préalablement à toute mise à jour évolutive ou corrective. Silverpeas Guide Administration Silverpeas v5.odt Page 44 6.4 Nouvelle installation avec reprise des paramétrage d'une installation existante données et du Suivre les 4 opérations ci-dessous : 6.4.1 Installer un Silverpeas vierge de manière habituelle (voir Nouvelle installation de Silverpeas) 6.4.2 Restaurer les données utilisateurs de l'autre installation Cela comprend : • • La base de données (dump de la base existante puis restauration sous le même nom ou sous un autre nom) Les données utilisateurs contenues dans data. • Si la nouvelle installation est dans la même version que la précédente, il suffira de copier l'intégralité du dossier $SILVERPEAS_DATA_HOME. • Si la nouvelle installation est une version plus récente, il suffira de copier les répertoires (à minima, voir Autres répertoires et paramétrages à récupérer pour les autres données) : ◦ SILVERPEAS_DATA_HOME/workspaces ◦ SILVERPEAS_DATA_HOME/jackrabbit Attention : Si vous aviez Jboss4 (pour Silverpeas <= 5.6) et que vous souhaitez passer sous Jboss6 (pour Silverpeas >= 5.6), avant de procéder aux opérations ci-dessous, reportez-vous à la release-notes correspondante. 6.4.3 Autres répertoires et paramétrages à récupérer Si nécessaire, reprendre les répertoires suivants : 6.4.3.1 Dans $SILVERPEAS_DATA_HOME Les formulaires XML de contenu : • $SILVERPEAS_DATA_HOME/templateRepository Les icônes des formulaires XML de contenu : • $SILVERPEAS_DATA_HOME/weblib.war/xmlForms Les portlets utilisateurs : • $SILVERPEAS_DATA_HOME/portlets/data/templateRepository Les templates de notifications ou de résultat de recherche : • $SILVERPEAS_DATA_HOME/StringTemplates Silverpeas Guide Administration Silverpeas v5.odt Page 45 Les procédures de Workflow : • $SILVERPEAS_DATA_HOME/workflowRepository Les sites Web, liens et pages Web réalisés avec les applications WebPage, WebSite Designer et Bookmarks: • $SILVERPEAS_DATA_HOME/web/website.war Le répertoire $SILVERPEAS_DATA_HOME/weblib contient plusieurs sous-répertoires susceptibles d'être récupérés si vous y avez apporté des modifications : La configuration de l'éditeur wysiwyg : • $SILVERPEAS_DATA_HOME/web/weblib.war/customWysiwyg Le ticker (message défilant dans le bandeau) : • $SILVERPEAS_DATA_HOME/web/weblib.war/ticker Look spécifique : Si vous avez un look spécifique, il est possible que le contenu de votre look soit présent dans le sous-répertoire look : • $SILVERPEAS_DATA_HOME/web/weblib.war/look/<votre_look> Si il existe, ne reprenez que ce répertoire. 6.4.3.2 Dans $SILVERPEAS_HOME Pom.xml : Réintégrez dans le pom.xml de la nouvelle installation les parties spécifiques du pom.xml de l'installation existante (looks, applications spécifiques) Voir Installation des spécifiques clients Le paramétrage Silverpeas global IMPORTANT !! : • • $SILVERPEAS_HOME/setup/settings/config.xml (<5.9) $SILVERPEAS_HOME/setup/settings/config.properties (>=5.9) Le paramétrage client global : • $SILVERPEAS_HOME/setup/settings/CustomerSettings.xml ou <CLIENT>Settings.xml suivant les cas. Les descripteurs d'applications spécifiques ou de Workflow : Silverpeas Guide Administration Silverpeas v5.odt Page 46 • $SILVERPEAS_HOME/xmlComponents/workflows Attention, ne copier dans la nouvelle installation que ce que vous avez besoin. La synchronisation LDAP et/ou SQL : • • • $SILVERPEAS_HOME/properties/com/stratelia/silverpeas/domains (<5.11) ou $SILVERPEAS_HOME/properties/org/silverpeas/domains (>=5.11) Reprenez le fichier de votre domaine, souvent domain<CLIENT>.properties ainsi qu'eventuellement les fichiers multilang associés : domains/multilang/domain<CLIENT>Bundle*.properties L'authentification LDAP : • • • $SILVERPEAS_HOME/properties/com/stratelia/silverpeas/authentication (<5.11) ou $SILVERPEAS_HOME/properties/org/silverpeas/authentication (>=5.11) Reprenez le fichier de votre domaine, souvent autDomain<CLIENT>.properties Lorsque toutes ces opérations sont faites, passer les commandes habituelles de déploiement et de configuration : o o o o appBuilder SilverpeasSettings Dbbuilder Démarrage Silverpeas Les index du moteur de recherche : Si vous n'avez pas copié le contenu du répertoire $SILVERPEAS_DATA_HOME/index il est nécessaire de procéder à la ré-indexation complète des contenus. Pour cela, une fois Silverpeas démarré, connectez-vous avec un profil administrateur et faites une ré-indexation globale des contenus. L'outil de ré-indexation est accessible depuis la console d'administration (Outils). Attention, cette ré-indexation peut durer quelques heures si le volume de données fait plusieurs dizaines de Go. Si la ré-indexation remonte des erreurs Too Many Open Files, allez sur la FAQ de Silverpeas. Note : Si le déploiement de silverpeas dans Jboss (au lancement, voir boot.log et server.log) génère des erreurs du style Error Indexing worspaces, il est possible que la JCR (Java Content Repository) soit désynchronisée (entre le répertoire jackrabbit et les tables JCR_ et VERSION_). Pour corriger cela, voir la FAQ de Silverpeas. Silverpeas Guide Administration Silverpeas v5.odt Page 47 7 EXPLOITATION 7.1 Fonctionnement Silverpeas Le démarrage de Silverpeas, en v5, initie le démarrage du serveur d’applications J2EE, qui remplit, rappelons-le 3 missions : Serveur Web frontal (mais vous pouvez également installer un Apache en frontal, paramétré en reverse proxy) Moteur de servlets Conteneur d’ejb Les éléments nécessaires à la mise en production Silverpeas sont donc les suivants : Service SQL Server, PostgreSQL ou base Oracle démarrés sur le serveur de données. Remarque Il est conseillé de paramétrer les services Silverpeas, et base de données en démarrage automatique lorsque le serveur redémarre. 7.2 Arrêt/ Redémarrage de Silverpeas Sous Linux, o Démarrage : $SILVERPAS_HOME/bin/silverpeas_start_jboss.sh o Arrêt : $SILVERPAS_HOME/bin/silverpeas_stop_jboss.sh o Si vous avez installé le script de démarrage automatique fourni, les commandes d’arrêt/relance sont : /etc/init.d/silverpeas start ou stop Sous Windows, o Démarrage : %SILVERPAS_HOME%/bin/silverpeas_start_jboss.cmd o Arrêt : %SILVERPAS_HOME%/bin/silverpeas_stop_jboss.cmd Nous conseillons d’utiliser un utilitaire comme FireDaemon qui permet de mettre Silverpeas en service Windows automatique. Silverpeas Guide Administration Silverpeas v5.odt Page 48 7.3 Modification de paramètres Une fois Silverpeas installé, un certain nombre de paramètres peuvent être modifiés et mis en œuvre. Ces paramètres sont ceux renseignés à l’installation (voir setup/settings/config.properties) Exemple : Paramètre RAM_MAX Description Exemple Taille mémoire allouée à la JVM pour 2048 l’application Silverpeas. (Mo) JBOSS_LISTEN_PORT Port d’écoute http (par défaut 8000) 8080 La démarche pour modifier un paramètre est la suivante : Arrêter Silverpeas. Editer le fichier config.properties SilverpeasSettings Redémarrer Silverpeas. Remarque SilverpeasSettings modifie automatiquement les fichiers de paramétrage Silverpeas (%SILVERPEAS_HOME%\properties), ainsi que les fichiers de configuration du serveur d’applications. Important : Tous les fichiers suffixés en .xml de ce répertoire seront pris en compte par le script SilverpeasSettings. Exemple : myconfig.old.xml sera pris en compte alors que myconfig.xml.old ne le sera pas. 7.4 Paramètres client Pour le paramètrage propre au client (CustomerSettings.xml ou <Client>Settings.xml), reportez-vous à la documentation Centralisation des Paramètres sur notre Extranet : http://extranet.silverpeas.com/silverpeas/Publication/748 7.5 Reconstruction de l’application (ApplicationBuilder script appBuilder) La reconstruction de l’application est nécessaire chaque fois que le code source (%SILVERPEAS_HOME%\repository) est modifié, soit dans les cas suivants : Installation Mise à jour (évolutive ou corrective) Migration La reconstruction basée sur Application Builder permet de reconstruire les fichiers dans jar/silverpeas.ear, utilisés par le serveur d’applications pour faire fonctionner Silverpeas. Silverpeas Guide Administration Silverpeas v5.odt Page 49 Remarque : Le lancement d’ApplicationBuilder n’effectue pas le paramétrage de l’application. Les modifications de code ne sont effectives qu’après activation de la configuration. 7.6 Examen des logs Dans le cadre de l’exploitation Silverpeas, plusieurs fichiers de traces sont présents et doivent être consultés en cas de dysfonctionnement : %SILVERPEAS_HOME%\log\traces.txt : fichier principal des traces de fonctionnement. %SILVERPEAS_HOME%\log\appBuilder.log:traces liées au lancement d’ApplicationBuilder %SILVERPEAS_HOME%\log\SilverpeasSettings.log : traces liées au lancement de l’activation de configuration. %SILVERPEAS_HOME%\log\dbBuilder.log : traces liées au lancement de dbBuilder (création ou mise à jour de la base de données). Un certain nombre d’autres fichiers résultent de traces lors d’actions spécifique (chat,…): Le serveur d’applications peut fournir ses propres traces : Jboss: %JBOSS_HOME%\serveur\default\log\boot.log (log de démarrage) Jboss: %JBOSS_HOME%\serveur\default\log\server.log (log de fonctionnement) 7.7 Identification de la configuration et version installée Avant toute installation, migration, mise à jour ou installation corrective, il est important de pouvoir connaître la configuration et le niveau de version d’une installation Silverpeas existante. Pour cela, aller dans la partie Administration de Silverpeas, volet ‘Outils’, onglet ‘A propos ‘ 7.8 Sauvegarde/restauration La sauvegarde des données de Silverpeas est un point extrêmement important dans le cadre de l’exploitation de Silverpeas. Elle peut être réalisée manuellement et/ou automatisée grâce à des scripts. Rappel : les données Silverpeas sont représentées par la base de données Silverpeas d’une part, et le répertoire %SILVERPEAS_HOME%\data d’autre part (voir le chapitre Les données Silverpeas). Il faut donc sauvegarder les répertoires suivants : $SILVERPEAS_HOME $SILVERPEAS_DATA_HOME $JBOSS_HOME Et faire un dump régulier de la base de données. Silverpeas Guide Administration Silverpeas v5.odt Page 50 8 PROBLEMES POSSIBLES Ce chapitre a pour objectif de vous aider à diagnostiquer et résoudre les incidents les plus fréquents constatés lors d’une exploitation Silverpeas. Pour tout problème non référencé, il convient de s’adresser au support Silverpeas (voir Assistance technique, premier chapitre). 8.1 Consultation des logs Rappel : Les logs Silverpeas sont situés dans le répertoire $SILVERPEAS_HOME/silverpeas/log : traces.txt : fichier principal des traces de fonctionnement. appBuilder.log: traces liées au lancement d’ApplicationBuilder settings.log : traces liées au lancement de l’activation de configuration. dbBuilder.log : traces liées au lancement de dbBuilder (creation ou mise à jour de la base de données). Les logs Jboss sont situés dans le répertoire $JBOSS_HOME/server/default/log : boot.log : log de démarrage de Jboss server.log : log d'exécution de Jboss 8.2 Problèmes identifiés Problème La mise à jour par mvn clean install lance une erreur Erreur lors de Application Builder (phase Settings) ou lors de l’activation de la configuration. Silverpeas ne démarre pas Silverpeas Vérifications Vérifier que la syntaxe du pom.xml est correcte. Vérifier que le serveur Silverpeas a bien accès à Internet Vérifier les différents paramètres de la configuration. Vérifier la syntaxe des fichiers .xml du répertoire setup/settings Vérifier les log de Jboss Vérifier le fichier traces.txt Actions Si vous utilisez un proxy pour accéder à Internet, il vous faut configurer Maven pour qu’il utilise celui-ci. http://www.silverpeas.org/docs/core/installation.html Editer les fichiers setup/settings/*.xml $JBOSS_HOME/server/default/log/boot.log silverpeas.log ou server.log suivant les cas $SILVERPEAS_HOME/log/traces.txt Guide Administration Silverpeas v5.odt Page 51 et Après une installation, l’administrateur ne peut se connecter Après un transfert de données, l’administrateur ne peut se connecter Les paramètres Editer la configuration d’accès à la base ($SILVERPEAS_HOME/setup/settings/config.properties sont peut-être faux ). Vérifier les paramètres : nom du serveur de données, login et mot de passe de connexion à la base. Le service de Sur le serveur de données, vérifier que le service de base de données base de données est démarré. est-il démarré La base Vérifier sur le serveur de données que la base Silverpeas n’existe Silverpeas existe bien. A l’installation, la base Silverpeas n’a pas été créée. pas Créer la base conformément au mode opératoire d’installation. Le login/mot de Editer la configuration passe de ($SILVERPEAS_HOME/setup/settings/config.properties ). Vérifier que vous vous connectez bien avec le l’administrateur login/mot de passe administrateur renseigné lors de l’installation. Si ce n'est pas le 1er démarrage, celui-ci a peut-être été changé depuis la partie Administration de Silverpeas. Le serveur de Depuis le serveur applicatif, vérifier que le serveur de données est-il données est accessible via le réseau (explorateur accessible via le windows). réseau pour le serveur de données ? Le login / mot de Vérifiez que vous vous connectez avec le login/mot de passe de passe Administrateur correspondant aux données restaurées (qui peuvent être différents des données l’administrateur initiales) Silverpeas est-il Vérifier que Silverpeas n’a pas eu une erreur lors du démarrage ou qu’il a fini de démarrer (démarrage bien démarré ? parfois long). Vérifier le port Vérifiez que vous vous connectez bien sur le port qui a été renseigné dans les paramètres (8000 par défaut). d’écoute. Silverpeas n’est Si ce port (paramètre JBOSS_LISTEN_PORT) est pas accessible : différent de 80, connectez-vous avec l’url impossible de http://serveur:port/ trouver la page. En phase d’exploitation. Aucun utilisateur ne peut plus accéder à Silverpeas : retour à la Silverpeas Le serveur applicatif est-il accessible via le réseau. Le service de base de données est-il démarré Vérifier si seuls les utilisateurs ayant une authentification LDAP ont ce problème. Vérifier que le serveur est accessible pour le poste client via le réseau. Sur le serveur de données, vérifier que le service de base de données est démarré (panneau de configuration, services). Il y a alors un problème de connexion à l’annuaire LDAP. Guide Administration Silverpeas v5.odt Page 52 page de login Le serveur de systématique données est-il accessible via le réseau pour le serveur de données ? Silverpeas est L’application a-tdémarré, mais elle bien été l’ajout d’un reconstruite après module ou l’installation du patch ne module ou du semble pas patch ? avoir été pris en compte. Silverpeas Depuis le serveur applicatif, vérifier que le serveur de données est accessible via le réseau (explorateur windows). Arrêter Silverpeas. Lancer Application SilverpeasSettings. Démarrer Silverpeas. Builder Guide Administration Silverpeas v5.odt Page 53 et 9 PARAMETRES SILVERPEAS 9.1 Paramètres d’installation config.properties) (<5.9 : config.xml - >=5.9 : Ce chapitre récapitule les différents paramètres modifiables dans Silverpeas au travers de l’édition de la configuration. Ces paramètres sont définis lors de l’installation ou renseignés par défaut. Silverpeas Guide Administration Silverpeas v5.odt Page 54 Paramètre Description JBOSS_LISTEN_PORT DB_SERVERTYPE Port d’écoute http permettant de se connecter à Silverpeas par un navigateur internet Mémoire maximal en Mo alloué à Java pour le fonctionnement de Silverpeas Type de SGBDR: MSSQL, ORACLE ou POSTGRES PERMSIZE_MAX Taille du permsize (mémoire permanente) Java JAVA_OPTS Paramètres Java optionnels DB_SERVER Nom ou IP du serveur de base de données DB_NAME Nom ou SID (Oracle) de la base de données DB_USER Login de connexion à la base de données DB_PASSWD Mot de passe de connexion à la base de données MIN_POOL_SIZE Valeur minimale de connexions BD ouvertes MAX_POOL_SIZE Valeur maximale de connexion BD ouvertes ADMIN_LOGIN Login de l’administrateur créé lors de la 1ère installation. ADMIN_PASSWD Mot de passe Administrateur créé lors de la 1ère installation. ADMIN_EMAIL Adresse mail de l’administrateur. URL_SERVER URL du serveur (http://nom_du_serveur:port). Utilisé lors de l’envoi des notifications. EXPED_NAME Nom de provenance par défaut des mails de notification ou alerte. EXPED_EMAIL Adresse mail de réponse par défaut aux mails de notification ou alerte. SMTP_SERVER SMTP_AUTHENTICATION Nom ou adresse IP du serveur SMTP utilise pour l’acheminement des mails de notification. Indique si le serveur SMTP nécessite une authentification (true/false) SMTP_DEBUG Indique si le serveur SMTP est en mode debug (true/false) SMTP_PORT Port du serveur SMTP SMTP_USER Login du compte habilité à envoyer des mails (si SMTP_AUTHENTICATION activé) Mot de passe du compte habilité à envoyer des mails (si SMTP_AUTHENTICATION activé) Indique si le serveur SMTP est en mode sécurisé SMTPS (true/false) RAM_MAX SMTP_PWD SMTP_SECURE Silverpeas Guide Administration Silverpeas v5.odt Page 55 9.2 Paramètres personnalisés de Silverpeas Beaucoup d’éléments ou de fonctionnalités peuvent être personnalisés, paramétrés, activés ou désactivés. Pour cela, consultez la FAQ de Silverpeas ou adressez-vous au support Silverpeas. Silverpeas Guide Administration Silverpeas v5.odt Page 56 10 RESSOURCES 10.1 Ressources 10.1.1 Installation et paramétrage http://www.silverpeas.org/installation Silverpeas Guide Administration Silverpeas v5.odt Page 57 10.1.2 Release notes http://www.silverpeas.org/docs/core/releasenotes.html Silverpeas Guide Administration Silverpeas v5.odt Page 58 10.1.3 Informations et Roadmap produit : REDMINE https://tracker.silverpeas.org/projects/silverpeas/roadmap 10.1.4 Silverpeas Suivi d’anomalies et d’évolutions : REDMINE Guide Administration Silverpeas v5.odt Page 59 10.1.5 Autres documentations techniques : Extranet Silverpeas Tout savoir sur : Optimisation de votre installation Silverpeas Sécurisation ssl (https) Le moteur de Workflow Les formulaires XML L’éditeur wysiwyg Le moteur d’import/export http://extranet.silverpeas.com/silverpeas/Topic/344?ComponentId=toolbox69 Silverpeas Guide Administration Silverpeas v5.odt Page 60 11 CONCLUSION Pour aller plus loin avec Silverpeas, nous proposons toute une gamme de formations adaptés au sujet qui vous intéresse : Module Module Module Module Module Module Module Module Module Module Module Module #1 : Présentation générale - 1 jour #2 : Administration fonctionnelle - 2 jours #3 : Plan de classement - 1 jour #4 : Perfectionnement - 1 jour #5 : SDK Silverpeas v5 - 5 jours #6 : Workflow - 2 jours #7 : Administration technique – 1 à 2 jours #8 : Formulaires - 1 jour #9 : Publieur Web - 2 jours #10: Accessibilité - 1 jour #11 : Taglibs Web - 3 jours #12 : Personnalisation du look - 1 jour Les durées sont données à titre indicatif car dépendant du contexte client. A ce titre, la formation Module #7 permet de rentrer plus en détail dans l'administration technique de Silverpeas. Pour toute question fonctionnelle ou technique concernant Silverpeas, et si vous êtes détenteur d’un contrat de maintenance, contactez nous : [email protected] Support: 04 76 09 31 61 Silverpeas Guide Administration Silverpeas v5.odt Page 61