====== Installation et configuration de la ferme de DokuWiki ======
===== Installation du système d'exploitation Debian =====
==== Obtenir Debian ====
Téléchargement du fichier [[http://cdimage.debian.org/debian-cd/6.0.6/amd64/iso-cd/debian-6.0.6-amd64-netinst.iso|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 **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 :
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
* 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.
==== Installation de base de DokuWiki====
* Téléchargement de l'archive [[http://www.splitbrain.org/_media/projects/dokuwiki/dokuwiki-2012-10-13.tgz|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
==== 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
// 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.
==== Création de la ferme de Wiki=====
=== Présentation ===
* 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
=== Démarche ===
* 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 [[https://www.dokuwiki.org/_media/dokuwiki_farm_animal.zip|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 :
ServerAdmin charles.techer@ac-limoges.fr
ServerName docs.btssio.ac-limoges.fr
DocumentRoot repertoire_d_installation_de_base_du_wiki
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).