Installation et configuration de la ferme de DokuWiki

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

# apt-get update
# apt-get upgrade

# apt-get install apache2

# apt-get install php5

# /etc/init.d/apache2 reload

# apt-get install openssh-server

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

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

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 :

<VirtualHost *:80>
	ServerAdmin charles.techer@ac-limoges.fr        
	ServerName docs.btssio.ac-limoges.fr

	DocumentRoot repertoire_d_installation_de_base_du_wiki
	
	ErrorLog ${APACHE_LOG_DIR}/error.log
	
	# Possible values include: debug, info, notice, warn, error, crit,
	# alert, emerg.
	LogLevel warn

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

• Activer le site pour avoir le lien du fichier nouvellement créé dans le dossier /etc/apache2/sites-enabled.

# a2ensite docs.btssio.ac-limoges.fr

• Recharger la configuration d'Apache :

# /etc/init.d/apache2 reload

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

• 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 repertoire_d_installation_de_base_du_wiki.
• Modifier les permissions en écriture pour le processus Web en le faisant devenir propriétaire du dossier :

# chown -R www-data repertoire_d_installation_de_base_du_wiki

• créer un alias provisoire vers le site en créant le fichier /etc/apache2/conf.d/dokuwiki.conf avec le contenu suivant

Alias /dokuwiki repertoire_d_installation_de_base_du_wiki

• Relancer Apache

# /etc/init.d/apache2 reload

• 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

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

// 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']['account_suffix']= '@btssio.local';
$conf['auth']['ad']['base_dn']= 'DC=btssio,DC=local';
$conf['auth']['ad']['domain_controllers']= 'dc-btssio.btssio.local';

// permettre les souscriptions par email
$conf['auth']['ad']['ad_username']= '*************';
$conf['auth']['ad']['ad_password']= '*************';

$conf['auth']['ad']['sso']= 0;
$conf['auth']['ad']['real_primarygroup']= 1;
$conf['auth']['ad']['debug']= 1;

// donner les droits superutilisateur
$conf['manager']= '@G_DokuWiki';
$conf['superuser']= '@G_DokuWiki';

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

• le dossier repertoire_d_installation_de_base_du_wiki 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 repertoire_d_installation_de_la ferme_de_wikis va contenir la ferme de DokuWiki et contiendra tous les animaux.
  • le sous-dossier repertoire_d_installation_de_la ferme_de_wikis/cours.btssio.ac-limoges.fr pour les cours du BTSSIO
  • le sous-dossier repertoire_d_installation_de_la ferme_de_wikis/docs.btssio.ac-limoges.fr pour la documentation du BTSSIO
  • le sous-dossier repertoire_d_installation_de_la ferme_de_wikis/ppe.btssio.ac-limoges.fr pour les PPE du BTSSIO

• Création d'un dossier vide repertoire_d_installation_de_la ferme_de_wikis accessible en écriture pour www-data
• Activer la ferme en copiant dans repertoire_d_installation_de_base_du_wiki/inc/preload.php.dist sous le nom repertoire_d_installation_de_base_du_wiki/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 repertoire_d_installation_de_la ferme_de_wikis :

// 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 repertoire_d_installation_de_la ferme_de_wikis 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 :

<VirtualHost *:80>
	ServerAdmin charles.techer@ac-limoges.fr        
	ServerName docs.btssio.ac-limoges.fr

	DocumentRoot repertoire_d_installation_de_base_du_wiki
</VirtualHost>

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 repertoire_d_installation_de_la ferme_de_wikis/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).