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)

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.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.