Le script d'installation install.php vous assiste dans votre configuration initiale de DokuWiki. Il contrôle la présence des fonctions PHP nécessaires à son fonctionnement, ainsi que les permissions d'accès des fichiers et répertoires. Il crée également un compte administrateur et une première politique de contrôle d'accès (ACL). Pour lancer le script d'installation, ouvrez la page http://[votre DokuWiki]/install.php dans votre navigateur. (Pour des raisons ce sécurité, ce script ne fonctionne qu'avec un nouveau DokuWiki non modifié). Il est fortement recommandé pour des raisons de sécurité de supprimer ou de déplacer le fichier install.php à la fin du processus d'installation.

Ci-dessous, la description des différents champs à renseigner et des explications sur les erreurs et solutions possibles.

Voici ce que vous devez configurer lors de l'installation, et le sens de ces configurations.

• Nom du wiki
  Configure le titre du wiki, qui sera affiché en haut à gauche en utilisant le thème de base.
• Activer le contrôle d'accès
  Si cette case est coché, la suite devient active. Dokuwiki ne requiert pas de politique de contrôle d'accès (ACL), mais il est vivement recommandé de l'activer pour disposer d'une interface d'administration.
• Super-utilisateur
  C'est le nom d'utilisateur de l'administrateur du site. Il doit être composé de minuscules en ASCII. Les espaces ne sont pas autorisés.
• Nom
  Le véritable nom (= nom et prénom) du super-utilisateur.
• Adresse de courriel
  Le mail du super-utilisateur. Il n'y a pas de vérification très avancée ici, seulement la présence du caractère @. Vous devriez toutefois donner un courriel valide.
• Mot de passe
  Le mot de passe du super-utilisateur.
• Répétez le mot de passe
  La confirmation du mot de passe, pour éviter les erreurs de frappe.
• Politique de contrôle d'accès initiale
  Le script d'installation vous propose une première politique d'accès générale. Votre choix dépendra de l'utilisation principale de votre wiki. Ce n'est qu'une première configuration, que vous pourrez corriger et affiner ensuite grâce aux ACL.
• Permettre aux utilisateurs de s'enregistrer eux-mêmes
  Si vous garder cette case non cochée, les futurs utilisateurs ne pourront s'inscrire eux-mêmes. Voir l'option de configuration disableactions

Le script d'installation contrôle un certain nombre de paramètres pour s'assurer que DokuWiki soit installable et utilisable sur votre serveur. Les messages suivants peuvent apparaître.

xxx n'est pas accessible en écriture pour DokuWiki. Vous devez corriger les autorisations de ce répertoire !
C'est probablement l'erreur la plus courante. Vous devez indiquer à votre serveur qu'il est permis d'écrire dans ce répertoire. Consultez Setting up file permissions (en anglais pour le moment).

Un autre cause probable de soucis est que vous avez déplacé des répertoires comme data ou conf. Vous pouvez le faire, mais seulement après le processus d'installation. Consultez la page Sécurité.

Réglage SELinux

Si cela ne fonctionne toujours pas, cela peut venir d'un paramètre selinux qui n'autorise pas les services web d'écrire dans ces répertoires. Pour confirmer ce cas de figure, vous pouvez momentanément désactiver selinux et réessayer d’exécuter le service web php (sudo setenforce 0).

Si cette démarche règle le problème, ré-activer selinux (sudo setenforce 1) et lancer les commandes suivantes dans un terminal :

# grep httpd /var/log/audit/audit.log | audit2allow -M mypol

# semodule -i mypol.pp

La fonction PHP xxx n'est pas disponible. Il se peut que votre hébergeur l'a désactivée ?
Cela signifie qu'une fonction normalement fournie par PHP n'est pas disponible. Peut-être que votre version de PHP est trop ancienne (DokuWiki nécessite PHP en version 5.3.3 ou plus récente), peut-être qu'il vous manque une extension PHP ou que votre hébergeur l'a désactivée pour une quelconque raison.

Vous devez résoudre ce problème, sinon DokuWiki ne fonctionnera simplement pas. En principe, mettez votre installation PHP à jour ou demandez à votre hébergeur de contrôler les paramètres PHP.

xxx - valeur interdite ou vide
Signifie simplement que la valeur entrée n'est pas conforme à ce qui est souhaité à cet endroit ou est vide alors qu'une valeur est requise. La liste des champs à remplir ci-dessus doit vous aider!