Table des matières

, ,

XWiki

XWiki est un Wiki Open-Source écrit en Java. Il offre tout à la fois les fonctions principales d’un wiki (édition collaborative, suivi d’information, gestion de l’accès des membres) et des possibilités de développement avancées (avec l’aide de langages de programmation utilisables directement au sein du wiki). Il a comme objectif de fournir un système wiki permettant de répondre aux besoins d'entreprises et d'associations comme intranet ou encore base de documentation.

Dans sa version de base, XWiki offre un premier contact agréable. L’installateur Windows est pratique et le design des items soigné (fiche utilisateur, calendrier, tables…). L’application permettant de choisir le positionnement et le contenu des panneaux latéraux permet de contrôler complètement l’aspect général du wiki, d’une façon générale ou au niveau d’un espace. L’éditeur de texte en mode WYSIWYG est intuitif et permet l’ajout de macros évoluées de façon simple.

XWiki offre également la possibilité d’une gestion fine des droits d’utilisateurs, permettant de voir / éditer / commenter / administrer, ce au niveau du wiki, d’un espace ou même d’une page. Cette flexibilité offre la possibilité de nombreuses configurations : public ou privé, librement éditable ou non ou un mélange des deux.

Plus d'informations sur Framalibre - XWiki

Installation

Il existe plusieurs façon d'installer XWiki, nous couvrirons ici deux méthodes. La première est la plus simple, et utilise la version standalone. Il s'agit d'une version déjà packagée avec une base de donnée, un java container (jetty) et bien sûr la webapp qui constitue le coeur d'XWiki.

Installation de la standalone

http://localhost:8080/xwiki/

Cette méthode n'est pas indiquée pour un environnement de production, et ne devrait être utilisée que pour de la demo ou du développement. Voir ci-après pour l'installation en mode production

Installation de production automatique

Depuis la version 3.3, il est possible d'installer XWiki via un dépot APT. XWiki n'est pas disponible sur les dépôts officiels Debian à cause de la politique d'intégration trop rigide pour être faisable.

Voici la procédure a suivre:

wget -q "http://maven.xwiki.org/public.gpg" -O- | sudo apt-key add -
sudo wget "http://maven.xwiki.org/stable/xwiki-stable.list" -P /etc/apt/sources.list.d/
apt-get update
apt-get install xwiki-enterprise-tomcat7-mysql

Qui installera le packet xwiki-enterprise-tomcat7-mysql. Vous pouvez tout autrement choisir d'installer xwiki seul (paquet xwiki-enterprise-common) ou en utilisant une base PostgreSQL à la place de MySQL (paquet xwiki-enterprise-tomcat7-pgsql) ou choisir une autre version de Tomcat (5, 6 ou 7).

Installation de production manuelle

Une installation complète nécessite plusieurs éléments pour fonctionner. Une machine java, un java container, une base de données ainsi qu'éventuellement un serveur web frontal, qui reste optionnel. Dans notre cas, nous utiliserons Tomcat comme Java Container, et MySQL comme base de données.

Installer Java

Installer Tomcat

Installer XWiki

Installer MySQL

Vérification de l'installation et première page

Tous les éléments indispensables ont été installés, vous pouvez utiliser le script fourni avec tomcat pour démarrer le daemon correspondant. (tomcat/bin/startup.sh) Une fois le wiki démarré, vous pouvez y accéder par le biais de l'url http://localhost:8080/xwiki. Le nom 'xwiki' est celui donné au dossier présent dans la webapps de tomcat. La première requête est toujours un peu longue. Vous devriez arriver sur une page du Wiki. Par défaut, vous aurez un wiki vide, il faut aller dans l'administration du wiki (en haut à gauche de la page) et importer le fichier conseillé (au format .xar) pour ainsi disposer du set de pages par défaut. Cela créé un utilisateur Admin/admin, dont il sera bon de modifier le mot de passe pour éviter toute bétise ;-)

Serveur Web et autre fonctionnalités

Pour un environnement de production, il sera utile d'installer un serveur Apache. Celui-ci sera alors utilisé comme reverse proxy pour afficher le contenu à la place du back-end (Tomcat). Voici les lignes de configuration importante à utiliser en cas de fonctionnement en ce sens :

Vous aurez besoin d'activer le mod proxy ("a2enmod http_proxy") et de recharger la configuration de votre serveur ("apache2ctl reload"). Enfin, vous pouvez accéder à votre wiki en passant par tomcat, sans avoir à rajouter le port 8080 dans l'URL.

Il est aussi possible d'utiliser un serveur OpenOffice pour activer l'import de documents sur le wiki. Après installation du serveur, il est nécessaire de modifier le fichier xwiki.properties.

L'entreprise développant la majorité des éléments du logiciel (XWiki SAS) fournit des prestations d'hébergement avec tarifs réduits destinés aux associations

Liens

—- Contributeurs principaux : Guillaume Fenollar, et bientôt vous? ————