Installation et configuration de la ferme de DokuWiki

Installation du système d'exploitation Debian

Obtenir Debian

Téléchargement du fichier debian-6.0.6-amd64.iso sur le site de Debian.

Installer le système de base

Mise à jour du serveur

# apt-get update
# apt-get upgrade

Installation du serveur Web Apache

# apt-get install apache2

Installation de PHP 5

# apt-get install php5

Relancer Apache

# /etc/init.d/apache2 reload

Accès à distance au serveur avec ssh

# apt-get install openssh-server

Installation de la ferme de Wiki

Configuration des hôtes virtuels pour les Wiki

Il y a 3 Wiki dans la ferme, cours, ppe et docs. Chacun de ces Wiki sera accessible avec un nom DNS différent, cours.btssio.ac-limoges.fr, ppe.btssio.ac-limoges.fr et docs.btssio.lac-limoges.fr. Pour cela, le serveur Apache va héberger 3 hôtes virtuels, un pour chaque Wiki.

Création des enregistrements DNS

Création des alias cours.btssio.ac-limoges.fr, ppe.btssio.ac-limoges.r et docs.btssio.ac-limoges.fr par la DSI du Rectorat correspondant à l'enregistrement ce serveur de Dokuwiki hébergé sur le DATACENTER.

Création des hôtes virtuels

Les fichiers de base du Dokuwiki seront enregistrés dans le dossier repertoiredinstallationdebaseduwiki.

Voici le détail de la création d'un hôte virtuel pour le DokuWiki docs.btssio.ac-limoges.fr. La procédure est identique pour tout nouvel animal en adaptant les informations spécifiques à chaque nouveau Wiki :

Création dans le répertoire /etc/apache2/sites-available, du fichier docs.btssio.ac-limoges.fr avec le contenu suivant : <code> <VirtualHost *:80> ServerAdmin charles.techer@ac-limoges.fr
ServerName docs.btssio.ac-limoges.fr DocumentRoot repertoiredinstallationdebaseduwiki

ErrorLog ${APACHELOGDIR}/error.log

# Possible values include: debug, info, notice, warn, error, crit, # alert, emerg. LogLevel warn

CustomLog ${APACHELOGDIR}/docs.btssio.ac-limoges.fr.access.log combined </VirtualHost> </code>

Activer le site pour avoir le lien du fichier nouvellement créé dans le dossier /etc/apache2/sites-enabled. <code> # a2ensite docs.btssio.ac-limoges.fr </code>

Recharger la configuration d'Apache : <code> # /etc/init.d/apache2 reload </code>

Le Dokuwiki sera ensuite accessible à l'adresse http://cours.btssio.ac-limoges.fr.

Installation de base de DokuWiki

Téléchargement de l'archive dokuwiki-2012-10-13.tgz “Adora Belle”

Pour le détail de l'installation, voici le lien vers les informations d'installation https://www.dokuwiki.org/install

Décompresser l'archive pour mettre les fichiers dans repertoiredinstallationdebaseduwiki.

Modifier les permissions en écriture pour le processus Web en le faisant devenir propriétaire du dossier : <code> # chown -R www-data repertoiredinstallationdebaseduwiki </code>

créer un alias provisoire vers le site en créant le fichier /etc/apache2/conf.d/dokuwiki.conf avec le contenu suivant <code> Alias /dokuwiki repertoiredinstallationdebaseduwiki </code>

Relancer Apache <code> # /etc/init.d/apache2 reload </code>

Ouvrir le fichier install.php à partir du navigateur à l'adresse http://nom_du_serveur/dokuwiki/install.php , compléter la page de configuration puis enregistrer les modifications (Nom du Wiki, nom et mot de passe provisoire de l'administrateur, définir le site comme Site public)

Supprimer le fichier install.php

Supprimer le fichier /etc/apache2/conf.d/dokuwiki.conf

Recharger la configuration d'Apache

Configurer une authenfication Active Directory

Cette configuration est non active actuellement.

Installer extension PHP LDAP

# apt-get install php5-ldap

modification du fichier conf/local.protected.php pour préciser les paramètres Active Directory <code> Options generales de DokuWiki $conf['title'] = 'Dokuwiki BTSSIO'; $conf['lang'] = 'fr'; $conf['license'] = 'publicdomain'; $conf['useacl'] = 1; $conf['disableactions'] = 'register'; configuration pour utiliser l'Active Directory du BTSSIO $conf['authtype'] = 'ad'; $conf['auth']['ad']['accountsuffix']= '@btssio.local'; $conf['auth']['ad']['basedn']= 'DC=btssio,DC=local'; $conf['auth']['ad']['domain_controllers']= 'dc-btssio.btssio.local';

permettre les souscriptions par email $conf['auth']['ad']['adusername']= ''; $conf['auth']['ad']['ad_password']= ''; $conf['auth']['ad']['sso']= 0; $conf['auth']['ad']['realprimarygroup']= 1; $conf['auth']['ad']['debug']= 1; donner les droits superutilisateur $conf['manager']= '@GDokuWiki'; $conf['superuser']= '@GDokuWiki'; </code>

le groupe global G_DokuWiki du domaine BTSSIO.LOCAL doit contenir les comptes qui doivent être administrateurs sur le Wiki.

Création de la ferme de Wiki

Présentation

le dossier repertoiredinstallationdebaseduwiki est le dossier d'installation de base du Dokuwiki et contient donc le moteur de DokuWiki. C'est le Dokuwiki qui a été installé et qui est opérationnel et accessible depuis un navigateur

le dossier repertoiredinstallationdela fermedewikis va contenir la ferme de DokuWiki et contiendra tous les animaux.

le sous-dossier repertoiredinstallationdela fermedewikis/cours.btssio.ac-limoges.fr pour les cours du BTSSIO

le sous-dossier repertoiredinstallationdela fermedewikis/docs.btssio.ac-limoges.fr pour la documentation du BTSSIO

le sous-dossier repertoiredinstallationdela fermedewikis/ppe.btssio.ac-limoges.fr pour les PPE du BTSSIO

Démarche

Création d'un dossier vide repertoiredinstallationdela fermedewikis accessible en écriture pour www-data

Activer la ferme en copiant dans repertoiredinstallationdebaseduwiki/inc/preload.php.dist sous le nom repertoiredinstallationdebaseduwiki/inc/preload.php

Ouvrir ce fichier et décommenter les deux instruction PHP en adaptant le bon chemin de fichier vers la ferme de wiki, c'est à dire repertoiredinstallationdela fermedewikis :

// set this to your farm directory
if(!defined('DOKU_FARMDIR')) define('DOKU_FARMDIR', 'repertoire_d_installation_de_la ferme_de_wikis');
// include this after DOKU_FARMDIR if you want to use farms
include(fullpath(dirname(__FILE__)).'/farm.php');

Ajouter un animal en téléchargeant un template d'animal template d'animal à extraire et à copier dans un sous-dossier du dossier repertoiredinstallationdela fermedewikis au nom de ce Wiki avec son nom de domaine.

Ce template inclut un dossier data vide et une dossier conf préconfiguré. Pour ce premier animal ce sous-dossier est appelé docs.btssio.ac-limoges.fr. Il faut rendre www-data propriétaire du dossier docs.btssio.ac-limoges.fr.

Créer un hôte virtuel sous Apache Création dans le répertoire /etc/apache2/sites-available du fichier docs.btssio.ac-limoges.fr avec le contenu suivant : <code> <VirtualHost *:80> ServerAdmin charles.techer@ac-limoges.fr
ServerName docs.btssio.ac-limoges.fr DocumentRoot repertoiredinstallationdebaseduwiki </VirtualHost> </code> Attention le dossier de publication doit toujours être le dossier d'origine de la ferme.

Demander la création d'un enregistrement DNS (un alias) pour docs.btssio.ac-limoges.fr à la DSI Rectorat.

Changer le mot de passe admin Dans le dossier repertoiredinstallationdela fermedewikis/docs.btssio.ac-limoges.fr/conf, il y les fichiers local.php et local.protected.php. En choisissant d'utiliser local.php, le compte administrateur est admin avec comme mot de passe par défaut admin. C'est la solution par défaut et c'est celle qui est utilisée en attendant d'avoir une gestion de l'authentification par Active Directory.

Pour configurer une authentification basée sur Active Directory du domaine BTSSIO, le fichier local.protected.php est à modifier en conséquence (voir plus haut).