DokuWiki – Installation du serveur

DokuWiki est un moteur de wiki Open Source sous licence GPLv2 né en 2004 et développé en PHP par Andreas Gohr . Sa version actuelle est la 2017-02-19b “Frusterick Manners”.
Alternatives Open Source à DokuWiki :

 

Objectif

 

L’objectif de cet article est l’installation et la configuration d’un serveur LAMP7 (Linux Apache MariaDB PHP7) auto-hébergé DokuWiki en version 2017-02-19b “Frusterick Manners” sur une distribution Linux Debian Jessie 8.7 32bits.

 

Schéma logique

 

 

Pré-requis

 

1. Pré-requis avant réalisation

  • Un serveur Debian Jessie 8.7 32 bits fonctionnel (installation basique avec utilitaires usuels du système et service SSH)
  • Packages de base supplémentaires : sudo, resolvconf, tree, imagemagick
  • Domaine utilisé : opensharing.priv

 

2. Configuration réseau initiale

Serveur DokuWiki
FQDN dokuwiki-test.opensharing.priv
Adresse IP 192.168.1.28
Réseau 192.168.1.0/24
Passerelle 192.168.1.1
dns-nameservers 192.168.1.11 192.168.1.12
dns-search opensharing.priv

 

Contenu initial du fichier /etc/network/interfaces :

auto lo
iface lo inet loopback

allow-hotplug eth0
iface eth0 inet static
	address 192.168.1.28
	netmask 255.255.255.0
	network 192.168.1.0
	broadcast 192.168.1.255
	gateway 192.168.1.1
	dns-search opensharing.priv
	dns-nameservers 192.168.1.11 192.168.1.12

 
Contenu initial du fichier /etc/hosts :

127.0.0.1	localhost.localdomain              localhost
192.168.1.28	dokuwiki-test.opensharing.priv        dokuwiki-test
192.168.1.28	dokuwiki.opensharing.priv             dokuwiki

Rmq : L’adresse 127.0.1.1 doit être retirée sur un serveur à IP fixe et remplacée par cette dernière, tel que l’exemple ci-dessus.
 
Contenu initial du fichier /etc/host.conf :

order hosts, bind
multi on

 
Contenu initial du fichier /etc/resolv.conf :

# Dynamic resolv.conf(5) file for glibc resolver(3) generated by resolvconf(8)
#     DO NOT EDIT THIS FILE BY HAND -- YOUR CHANGES WILL BE OVERWRITTEN
nameserver 192.168.1.11
nameserver 192.168.1.12
search opensharing.priv

Rmq :
Le fichier /etc/resolv.conf ne doit pas être édité dès lors que le paquet resolvconf a été installé.

Pour prendre en compte les modifications des fichiers de configuration relatifs au réseau, redémarrage du service réseau :

# /etc/init.d/networking restart
# /etc/init.d/networking reload

 

Réalisation

 

1. Installation de Apache

# apt install apache2 apache2-doc

Installe les paquets suivants par dépendances :

apache2 apache2-data apache2-doc apache2-utils

 

2. Installation de MariaDB

# apt install mariadb-server mariadb-client

Installe les paquets suivants par dépendances :

libaio1 libdbd-mysql-perl libdbi-perl libhtml-template-perl
libmysqlclient18 libreadline5 libterm-readkey-perl mariadb-client
mariadb-client-10.0 mariadb-client-core-10.0 mariadb-common mariadb-server
mariadb-server-10.0 mariadb-server-core-10.0 mysql-common

 
Choisir le mot de passe pour le compte d’administration de MariaDB (“root“) et le confirmer.


 

3. Installation de PHP7

Déclaration du dépôt DotDeb :

# echo "deb http://packages.dotdeb.org jessie all" > /etc/apt/sources.list.d/dotdeb.list
# wget -O- https://www.dotdeb.org/dotdeb.gpg | apt-key add -
# apt update

Installation de PHP7 proprement dite :

# apt install libapache2-mod-php7.0 php7.0 php7.0-apcu php7.0-bz2 php7.0-fpm php7.0-mysql php7.0-curl php7.0-json php7.0-gd php7.0-mcrypt php7.0-msgpack php7.0-memcached php7.0-intl php7.0-sqlite3 php7.0-gmp php7.0-geoip php7.0-mbstring php7.0-pgsql php7.0-xml php7.0-zip

Installe les paquets suivants par dépendances :

libapache2-mod-php7.0 libapparmor1 libcurl3 libmcrypt4
libmemcached11 libmemcachedutil2 libpq5 libzip2
php-common php7.0 php7.0-apcu php7.0-bz2
php7.0-cli php7.0-common php7.0-curl php7.0-phpdbg
php7.0-fpm php7.0-gd php7.0-geoip php7.0-gmp
php7.0-igbinary php7.0-intl php7.0-json php7.0-mbstring
php7.0-mcrypt php7.0-memcached php7.0-msgpack php7.0-mysql
php7.0-opcache php7.0-pgsql php7.0-readline php7.0-sqlite3
php7.0-xml php7.0-zip

Rmq : Tous les modules installés ici ne seront pas forcément nécessaires, à commencer par ceux relatifs à PostgreSQL et SQLite.
 

Définir PHP7 par défaut :

# a2enmod proxy_fcgi setenvif
# a2enconf php7.0-fpm

 

Configuration du moteur de cache Opcache permettant le stockage en mémoire des scripts PHP précompilés pour un gain de performance :

# nano /etc/php/7.0/mods-available/opcache.ini

Ajouter les lignes suivantes en fin de fichier :

opcache.memory_consumption=512
opcache.revalidate_freq=60
opcache.validate_timestamps=1
opcache.max_accelerated_files=5000

 

4. Installation de DokuWiki

# wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz
# tar -xzvf dokuwiki-stable.tgz -C /var/www/
# mv /var/www/dokuwiki-2017-02-19b/ /var/www/dokuwiki/
# chown www-data:www-data -R /var/www/dokuwiki/

 

5. Configuration de MariaDB

# mysql_secure_installation

NOTE: RUNNING ALL PARTS OF THIS SCRIPT IS RECOMMENDED FOR ALL MariaDB SERVERS IN PRODUCTION USE!  PLEASE READ EACH STEP CAREFULLY!

In order to log into MariaDB to secure it, we'll need the current password for the root user.  If you've just installed MariaDB, and you haven't set the root password yet, the password will be blank, so you should just press enter here.

Enter current password for root (enter for none): 
OK, successfully used password, moving on...

Setting the root password ensures that nobody can log into the MariaDB root user without the proper authorisation.

You already have a root password set, so you can safely answer 'n'.

Change the root password? [Y/n] n
 ... skipping.

By default, a MariaDB installation has an anonymous user, allowing anyone to log into MariaDB without having to have a user account created for them.  This is intended only for testing, and to make the installation go a bit smoother.  You should remove them before moving into a production environment.

Remove anonymous users? [Y/n] Y
 ... Success!

Normally, root should only be allowed to connect from 'localhost'.  This ensures that someone cannot guess at the root password from the network.

Disallow root login remotely? [Y/n] Y
 ... Success!

By default, MariaDB comes with a database named 'test' that anyone can access.  This is also intended only for testing, and should be removed before moving into a production environment.

Remove test database and access to it? [Y/n] Y
 - Dropping test database...
 ... Success!
 - Removing privileges on test database...
 ... Success!

Reloading the privilege tables will ensure that all changes made so far will take effect immediately.

Reload privilege tables now? [Y/n] Y
 ... Success!

Cleaning up...

All done!  If you've completed all of the above steps, your MariaDB installation should now be secure.

Thanks for using MariaDB!
# mysql -u root -p
Enter password: 
Welcome to the MariaDB monitor.  Commands end with ; or \g.
Your MariaDB connection id is 48
Server version: 10.0.30-MariaDB-0+deb8u1 (Debian)

Copyright (c) 2000, 2016, Oracle, MariaDB Corporation Ab and others.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

MariaDB [(none)]> CREATE DATABASE IF NOT EXISTS dokuwikidb;
Query OK, 1 row affected (0.00 sec)

MariaDB [(none)]> CREATE USER dokuwikiadmin@localhost IDENTIFIED BY "dokuwikiadminpw";
Query OK, 0 rows affected (0.00 sec)

MariaDB [(none)]> GRANT ALL PRIVILEGES ON dokuwikidb.* TO dokuwikiadmin@localhost;
Query OK, 0 rows affected (0.00 sec)

MariaDB [(none)]> FLUSH PRIVILEGES;
Query OK, 0 rows affected (0.00 sec)

MariaDB [(none)]> SHOW DATABASES;
+--------------------+
| Database           |
+--------------------+
| dokuwikidb         |
| information_schema |
| mysql              |
| performance_schema |
+--------------------+
4 rows in set (0.00 sec)

MariaDB [(none)]> quit;
Bye

 

6. Configuration de Apache

# nano /etc/apache2/sites-available/dokuwiki.conf
<VirtualHost *:80>
   DocumentRoot /var/www/dokuwiki/
   ServerName dokuwiki.opensharing.priv
   Redirect permanent / https://dokuwiki.opensharing.priv/
</VirtualHost>

<VirtualHost *:443>

   DocumentRoot /var/www/dokuwiki/
   ServerName dokuwiki.opensharing.priv

   <Directory /var/www/dokuwiki/>
      Options +FollowSymlinks
      AllowOverride All
   </Directory>

   SetEnv HOME /var/www/dokuwiki
   SetEnv HTTP_HOME /var/www/dokuwiki
   
   ErrorLog /var/log/apache2/dokuwiki.error.log
   CustomLog /var/log/apache2/access.log combined

   SSLEngine On
   SSLOptions +FakeBasicAuth +ExportCertData +StrictRequire
   SSLCertificateFile /etc/ssl/certs/dokuwikiperso.crt
   SSLCertificateKeyFile /etc/ssl/private/dokuwikiperso.key

</VirtualHost>

 
Génération de la clef privée :

# openssl genrsa -out /etc/ssl/private/dokuwikiperso.key 1024
Generating RSA private key, 1024 bit long modulus
...............++++++
.........................++++++
e is 65537 (0x10001)

Demande de certificat à partir de la clef :

# openssl req -new -key /etc/ssl/private/dokuwikiperso.key -out /etc/ssl/certs/dokuwikiperso.csr
You are about to be asked to enter information that will be incorporated into your certificate request.
What you are about to enter is what is called a Distinguished Name or a DN.
There are quite a few fields but you can leave some blank.
For some fields there will be a default value, if you enter '.', the field will be left blank.
-----
Country Name (2 letter code) [AU]:FR
State or Province Name (full name) [Some-State]:Ile-de-France
Locality Name (eg, city) []:Paris
Organization Name (eg, company) [Internet Widgits Pty Ltd]:OpenSharing
Organizational Unit Name (eg, section) []:Service Informatique
Common Name (e.g. server FQDN or YOUR name) []:dokuwiki.opensharing.priv
Email Address []:admin@opensharing.priv

Please enter the following 'extra' attributes
to be sent with your certificate request
A challenge password []:dokuwikicertificate
An optional company name []:OpenSharing

Construction du certificat :

# openssl x509 -req -days 365 -in /etc/ssl/certs/dokuwikiperso.csr -signkey /etc/ssl/private/dokuwikiperso.key -out /etc/ssl/certs/dokuwikiperso.crt
Signature ok
subject=/C=FR/ST=Ile-de-France/L=Paris/O=OpenSharing/OU=Service Informatique/CN=dokuwiki.opensharing.priv/emailAddress=admin@opensharing.priv
Getting Private key

 

Activation du site et des modules et vérification de la syntaxe du VirtuaHost :

# a2ensite dokuwiki
# a2enmod rewrite
# a2enmod ssl
# apachectl configtest
Syntax OK

 

7. Redémarrage des services

# service apache2 restart
# service mysql restart
# service php7.0-fpm restart

 

8. Configuration de DokuWiki par le navigateur Web

Saisir, dans la barre d’adresses, l’adresse suivante :

http://dokuwiki.opensharing.priv/install.php

redirigeant automatiquement vers :
https://dokuwiki.opensharing.priv/install.php
 
Le répondeur OCSP nous signifie que le certificat n’émane pas d’une autorité de certification reconnue, un message d’avertissement est donc émis.

Cliquer sur Avancé puis Ajouter une exception…

Il suffit ensuite de Confirmer l’exception de sécurité.

La première étape consiste à personnaliser le nom du site et créer un compte administrateur. Puis Enregistrer.


L’installation est déjà terminée. Toutefois, avant de continuer, il faut supprimer le fichier d’installation. Puis Continuer avec votre nouveau DokuWiki.

# rm /var/www/dokuwiki/install.php

La page d’accueil d’informations relatives au nouveau wiki s’affiche.

En cliquant sur s’identifier, nous pouvons nous loguer en tant qu’administrateur.

Et accéder ainsi aux outils de configuration du site.

On peut enfin créer notre première page.

 

# find /var/www/dokuwiki/ -type f -print0 | xargs -0 chmod 0640
# find /var/www/dokuwiki/ -type d -print0 | xargs -0 chmod 0750
# chown root:www-data -R /var/www/dokuwiki/
# chown www-data:www-data -R /var/www/dokuwiki/data/
# chown www-data:www-data -R /var/www/dokuwiki/conf/
# chown www-data:www-data -R /var/www/dokuwiki/lib/plugins/
# chown www-data:www-data -R /var/www/dokuwiki/lib/tpl/
# chmod 755 /var/www/dokuwiki/lib/
# service apache2 restart
# service mysql restart
# service php7.0-fpm restart

 

 

Pour aller plus loin

 

1. Effectuer une sauvegarde manuelle complète

# mkdir -p /home/adminsys/backup/v20170219/
# cd /home/adminsys/backup/v20170219/
# tar -czvf backup-dokuwiki-20170425.tar.gz -C /var/www/ dokuwiki/
# mysqldump --user=dokuwikiadmin --password=dokuwikiadminpw --databases dokuwikidb > dokuwiki-20170425.sql

 

2. Effectuer une restauration manuelle complète

# cd /home/adminsys/backup/v20170225/
# tar -xzvf backup-dokuwiki-20170425.tar.gz -C /var/www/
# mysql --user=dokuwikiadmin --password=dokuwikiadminpw dokuwikidb < dokuwiki-20170425.sql

 

Références

 

Fermer le menu
%d blogueurs aiment cette page :