{{tag>software webadmin dokuwiki}}

====== Installation de dokuwiki ======

Une fois les fichiers décompressés dans le **root_web**, lancer le navigateur pour accéder à la page de configuration http://mon_serveur/install.php.


===== Activer la réécriture d'URL =====

Vérifier que le module mod_rewrite est activé
<code bash>
yoann@hermes:~$ apache2ctl -t -D DUMP_MODULES | grep -i rewrite
Syntax OK
 rewrite_module (shared)
yoann@hermes:~$
</code>

Si ce n'est pas le cas la commande suivante permet d'activer le module:
<code bash>
yoann@hermes:~$ sudo a2enmod rewrite
</code>

Dans le root_web de l'application éditer le fichier .htaccess \\
Décommenter les directives Options, RewriteEngine et les règles de redirection
<file txt .htaccess>
## Enable this to restrict editing to logged in users only

## You should disable Indexes and MultiViews either here or in the
## global config. Symlinks maybe needed for URL rewriting.
Options -Indexes -MultiViews +FollowSymLinks

## make sure nobody gets the htaccess, README, COPYING or VERSION files
<Files ~ "^([\._]ht|README$|VERSION$|COPYING$)">
    Order allow,deny
    Deny from all
    Satisfy All
</Files>

## Uncomment these rules if you want to have nice URLs using
## $conf['userewrite'] = 1 - not needed for rewrite mode 2
RewriteEngine on
#
## Not all installations will require the following line.  If you do, 
## change "/dokuwiki" to the path to your dokuwiki directory relative
## to your document root.
#RewriteBase /dokuwiki
#
## If you enable DokuWikis XML-RPC interface, you should consider to
## restrict access to it over HTTPS only! Uncomment the following two
## rules if your server setup allows HTTPS.
#RewriteCond %{HTTPS} !=on
#RewriteRule ^lib/exe/xmlrpc.php$      https://%{SERVER_NAME}%{REQUEST_URI} [L,R=301]
#
RewriteRule ^_media/(.*)              lib/exe/fetch.php?media=$1  [QSA,L]
RewriteRule ^_detail/(.*)             lib/exe/detail.php?media=$1  [QSA,L]
RewriteRule ^_export/([^/]+)/(.*)     doku.php?do=export_$1&id=$2  [QSA,L]
RewriteRule ^$                        doku.php  [L]
RewriteCond %{REQUEST_FILENAME}       !-f
RewriteCond %{REQUEST_FILENAME}       !-d
RewriteRule (.*)                      doku.php?id=$1  [QSA,L]
RewriteRule ^index.php$               doku.php
</file>

Sur le wiki, modifier les [[http://hermes.home/wiki:syntax?do=admin&page=config| Paramètres de configuration]]. Dans la **section Paramètres avancés**, option **URL esthétiques** sélectionner **Fichier .htacces** dans la boite de liste.

===== Sécurité =====

Attention avec les fichiers de configuration des hôtes virtuel Apache notamment sous Ubuntu. La valeur de la directive **AllowOverride** est à **None** par défaut ce qui inhibe les redéfinitions de configuration via les fichiers **.htaccess** et rend l'application dokuwiki vulnérable car elle expose tous les fichiers de configuration et les ressources.

  * passer la valeur de **AllowOverride** à **All**
  * redémarrer/recharger les fichiers de configuration APache.

Pour vérifier que les fichiers de configurations .htaccess sont bien pris en compte et que les dossiers de configuration de dokuwiki sont correctment protégés essayer d'afficher la ressource:
  * http://monserveur/data/pages/wiki/dokuwiki.txt

Si 'application est correctement paramétrée, on obtient une **erreur 403**.

Lancer également l'outil de vérification de l'installation via l'URL:
http://monserveur.exemple.com/?do=check

===== Sauvegardes =====

L'application Dokuwiki n'utilise pas de base de données, il suffit de sauvegarder le root applicatif qui contiendra toutes les données.

On peut toutefois exclure les répertoires suivants:
  * ./data/cache
  * ./data/index
  * ./data/locks
  * ./data/tmp
  

===== Références =====

  * https://www.dokuwiki.org/faq:backup