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

• 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

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.

• 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

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