Outils pour utilisateurs

Outils du site


nethserver_201_cahier_03_mediawiki

Table des matières

NethServer-201, Cahier-03: MediaWiki








Description générale

Description générale

Ce document décrit l'installation et la configuration de MediaWiki de même que les extensions Semantic MediaWiki (SMW) et CharInsert sur un Serveur NethServer-7.6.1810:

Ce document utilise le Serveur NethServer du Cahier-03: Création d'un Serveur NethServer virtuel du “Cours NethServer-101”.

But de ce cahier


MediaWiki

Référence: https://fr.wikipedia.org/wiki/MediaWiki.

MediaWiki est un moteur de wiki pour le Web. Il est utilisé par l’ensemble des projets de la Wikimedia Foundation, ainsi que par l’ensemble des wikis hébergés chez Wikia et par de nombreux autres wikis. Conçu pour répondre aux besoins de Wikipédia, ce moteur est en 2008 également utilisé par des entreprises comme solution de gestion des connaissances et comme système de gestion de contenu. Des associations, comme Wikitravel, Mozilla ou Ékopedia, l'ont adopté.

MediaWiki est écrit en PHP et peut aussi bien fonctionner avec le système de gestion de base de données MariaDB, MySQL ou PostgreSQL. C'est un logiciel LIBRE distribué selon les termes de la GPL.

Document de référence

Working with MediaWiki par Yaron Koren ©2012 by Yaron Koren. http://workingwithmediawiki.com/book/

Cours NethServer-101

Le Cours NethServer-101, se voulant une base solide pour la création d'un site de Commerce en ligne, comprend plusieurs cahiers:

  • Cahier-01: → Les bases de Linux.
  • Cahier-02: → Installation et configuration des logiciels prérequis sur le poste de travail.
  • Cahier-03: → Création d'un Serveur NethServer virtuel.
  • Cahier-04: → Serveur NethServer LOCAL & Let's Encrypt.
  • Cahier-05: → FAI, modem VDSL, domaine FQDN1) et Serveur NethServer physique.
  • Cahier-06: → Installation de WordPress.
  • Cahier-07: → Installation de l'extension de sécurité Wordfence.
  • Cahier-08: → WooCommerce, comptes chez Stripe et PayPal pour les paiements en ligne.
  • Cahier-09: → Sauvegarde/restauration ou migration d'un site avec l'extension Duplicator.
  • Cahier-10: → Serveur mandataire inversé.
  • Cahier-11: → Sauvegarde/restauration avec BackupPC.

Cours NethServer-201

Le Cours NethServer-201 décrit l'installation et la configuration d'applications sur un serveur NethServer.

Logiciels

Tous les logiciels nécessaires sont du domaine public ou LIBRE sous licence GPL; ils ne coûtent pas un sou. Le seul achat nécessaire est l'obtention d'un nom de domaine au prix initial de $15 CAD et son renouvellement annuel d'environ $30 CAD.

But final

Après avoir suivi le Cours NethServer-101, vous posséderez un site de Commerce en ligne fiable et hautement sécuritaire. De plus, vous pourrez utiliser un clone de votre site, sur un Serveur NethServer virtuel roulant sur votre poste de travail, pour tester de nouvelles extensions et applications sans compromettre la sécurité ou l'intégrité de votre site en ligne.

Particularités de ce document

Notes au lecteur

* Les captures d'écrans ne sont que des références.
** Les informations écrites ont préséance sur celles retrouvées dans les captures d'écrans. Veillez vous référer aux différents tableaux lorsque ceux-ci sont présents.
*** Une capture d'écran avec une accentuation en magenta indique qu'il faut remplacer cette distinction par vos propres paramètres ou implique un choix laissé à votre appréciation.

Conventions

Manipulation, truc ou ruse pour se tirer d'embarras.
Une recommandation ou astuce.
Une note.
Une étape, note ou procédure à surveiller.
Paragraphe non complété ou non vérifié.
Danger pour la sécurité du système.

Toutes les commandes à la console ou à travers PuTTY sont précédées d'une invite qui est toujours présente.

[[email protected] ~]# ping 10.10.10.75 -c1

PING 10.10.10.75 (10.10.10.75) 56(84) bytes of data.
64 bytes from 10.10.10.75: icmp_seq=1 ttl=64 time=1.63 ms

--- 10.10.10.75 ping statistics ---
1 packets transmitted, 1 received, 0% packet loss, time 0ms
rtt min/avg/max/mdev = 1.639/1.639/1.639/0.000 ms
[[email protected] ~]#
Commande à exécuter si ce n'est déjà fait.
Commande indiquée à titre d'information seulement.


À savoir

Diagramme réseau


Serveur NethServer-7.6.1810

Le Serveur NethServer-7.6.1810 est un dérivé de la distribution Linux CentOS et est équivalent à CentOS-7.6.1810.

dorgee.micronator.org

Serveur passerelle pour les connexions à l'Internet.
Serveur DHCP pour tout le réseau LOCAL.

tchana.micronator-dev.org

Serveur virtuel LOCAL sous VirtualBox Version 6.0.4 r128413 (Qt5.6.2).

Répertoire d'installation

Nous installerons MediaWiki dans le répertoire /var/lib/nethserver/vhost/mediawiki.

Poste de travail

Windows-8.1, on utilisera ce poste de travail pour tous ce document.

Éditeur de texte

Ne modifiez pas les fichiers avec des éditeurs de documents tels Notepad, TextEdit ou autres qui ajoutent une marque d'ordre d'octets (byte order marks) aux fichiers et qui casse le programme PHP. Utilisez plutôt un éditeur de code tel vi, vim, Notepad++, ou Atom. Ces éditeurs gèrent l'encodage des fichiers de manière appropriée; ils peuvent aussi être utilisés pour réparer les fichiers précédemment cassés par les autres éditeurs de documents.

Notepad++

Voir le Cahier-02: Installations & configurations des logiciels prérequis du “Cours NethServer-1010” pour l'installation et la configuration de cet éditeur.

Description

Référence: https://notepad-plus-plus.org/fr/.
Notepad++ est un éditeur de code source qui prend en charge plusieurs langages. Ce logiciel, codé en C++ avec STL et win32 api, a pour vocation de fournir un éditeur de code source de taille réduite mais très performant. En optimisant de nombreuses fonctions, tout en conservant une facilité d’utilisation et une certaine convivialité, Notepad++ contribue à la limitation des émissions de dioxyde de carbone dans le monde; en effet, en réduisant l’utilisation du CPU, la consommation d’énergie des ordinateurs chute considérablement, en conséquence de quoi, la terre est plus verte.

Site de téléchargement: https://notepad-plus-plus.org/fr/.

Documentation

Connexion sécuritaire

Ce document décrit aussi la marche à suivre pour une connexion sécuritaire (https) vers MediaWiki.

HTTPS (Hyper Text Transfer Protocol Secure) apparaît dans l'URL lorsqu'un site Web est sécurisé par un certificat SSL/TLS. Les détails du certificat, y compris l'autorité émettrice et la dénomination sociale du propriétaire du site Web, peuvent être consultés en cliquant sur l'icône du cadenas sur la barre du navigateur.

Préparation de l'environnement de travail

Configuration du poste de travail

Voir la section À savoir du Cahier-03 : Création d'un Serveur NethServer virtuel du “Cours NethServer-101”.

Vérification

Centre Réseau et partage → Modifier les paramètres de la carte → clac (clic droit) sur la carte Éthernet → Statut → Détails.

● Nos deux adresses IP et nos deux passerelles son présentes.

Fermer toutes les fenêtre.

C:\Windows\System32\drivers\etc\hosts.

Les CNAME de notre Serveur NethServer virtuel LOCAL sont présents.

Installation d'un Serveur NethServer

Voir le Cahier-03: Création d'un Serveur NethServer virtuel du “Cours NethServer-101”.

Pour un serveur virtuel de test, prendre un minimum de 8 Go dynamiquement alloué pour le disque principal.

Mise à jour du Serveur

Avant de commencer quoi que ce soit, il est toujours préférable de mettre à jour le Serveur NethServer.

Fail2ban & ClamAV

Il est fortement recommandé d'installer Fail2ban et ClamAV pour mieux sécuriser notre futur site Odoo. L'installation de ces logiciels est décrite dans le Cahier-03: Création d'un Serveur NethServer virtuel du “Cours NethServer-101”..

interface Web NethServer

Il faut activer Javascript et les témoins (cookies).
Depuis le poste de travail, sur le réseau LOCAL 10.10.10.0/24, on accède à l'interface Web Nethserver http://10.10.10.75:980.

Login

Lorsque vous parvenez à l'URL, vous serez invité à entrer votre nom d’utilisateur (qui est obligatoirement root et son mot de passe). Entrez ce justificatif et cliquez sur Login afin d’être amené à l'interface Web Nethserver. L’écran du gestionnaire s’affiche.

Le cadenas n'est pas vert, car si nous utilisons un nouveau Serveur NethServer, nous n'avons pas encore de certificat émis par une autorité de certification reconnue. Plus loin, nous réglerons cet inconvénient

Si vous avez de la difficulté à vous connecter, vidanger le cache DNS du poste de travail et celui du navigateur Firefox.

- Sur le poste de travail, ouvrir un écran de commandes.
- ifconfig /flushdns.

Historique → Supprimer l'historique ré­cent… → tout → Effacer maintenant.


Fournisseur des comptes

Configuration → Fournisseur des comptes.

LDAP local est notre fournisseur de comptes.


FQDN du serveur

Configuration → DNS onglet Hôtes.

Le FQDN du serveur: micronator-dev.org est bien ce qu'il devrait être.
L'entrée micronator-101.ddns.net provient du Cahier-03: Création d'un Serveur NethServer virtuel du “Cours NethServer-101”, on peut le supprimer pour ce document.

Nom du serveur

Configuration → Nom du serveur.


Paramètres d'accès à distance

Sécurité → SSH.


FTP

Configuration → FTP onglet Configurer.

Mediawiki utilise son propre logiciel FTP, il n'est donc pas nécessaire d'activer le service FTP sur le serveur.
Nous ne recommandons pas d'activer ce service, car il n'est pas sécuritaire. Pour le transfert de fichiers, il est préférable d'employer des utilitaires sécurisés tels que WinSCP ou FileZilla.

Serveurs DNS

Configuration → Réseau → onglet Serveur DNS.

Le serveur DNS secondaire peut être 8.8.8.8 ou 1.1.1.1; le dernier étant plus rapide.


Ouverture d'une session PuTTY

Les paramètres du serveur sont définis correctement et on peut utiliser PuTTY pour s'y loguer.

Voir PuTTY dans le Cahier-02 : Installations & configurations des logiciels prérequis du “Cours NethServer-101”.

On se logue en tant que l'utilisateur root.

login as: root
[email protected]'s password: mot-de-passe-de-root
Last login: Thu May 16 09:58:33 2019 from 10.10.10.81

************ Welcome to NethServer ************

This is a NethServer installation.

Before editing configuration files, be aware
of the automatic events and templates system.


          http://docs.nethserver.org

***********************************************
[[email protected] ~]#

Adresse IP

On vérifie les adresses IP du serveur.

[[email protected] ~]# ifconfig

enp0s3: flags=4163<UP,BROADCAST,RUNNING,MULTICAST>  mtu 1500
        inet 10.10.10.75  netmask 255.255.255.0  broadcast 10.10.10.255
        inet6 fe80::a00:27ff:fedd:6373  prefixlen 64  scopeid 0x20<link>
        ether 08:00:27:dd:63:73  txqueuelen 1000  (Ethernet)
        RX packets 680  bytes 63712 (62.2 KiB)
        RX errors 0  dropped 0  overruns 0  frame 0
        TX packets 634  bytes 260579 (254.4 KiB)
        TX errors 0  dropped 0 overruns 0  carrier 0  collisions 0

enp0s8: flags=4163<UP,BROADCAST,RUNNING,MULTICAST>  mtu 1500
        inet 192.168.1.75  netmask 255.255.255.0  broadcast 192.168.1.255
        inet6 fe80::a00:27ff:feda:1348  prefixlen 64  scopeid 0x20<link>
        ether 08:00:27:da:13:48  txqueuelen 1000  (Ethernet)
        RX packets 27919  bytes 26181152 (24.9 MiB)
        RX errors 0  dropped 0  overruns 0  frame 0
        TX packets 20591  bytes 5112156 (4.8 MiB)
        TX errors 0  dropped 0 overruns 0  carrier 0  collisions 0

lo: flags=73<UP,LOOPBACK,RUNNING>  mtu 65536
        inet 127.0.0.1  netmask 255.0.0.0
        inet6 ::1  prefixlen 128  scopeid 0x10<host>
        loop  txqueuelen 1000  (Local Loopback)
        RX packets 2534  bytes 309622 (302.3 KiB)
        RX errors 0  dropped 0  overruns 0  frame 0
        TX packets 2534  bytes 309622 (302.3 KiB)
        TX errors 0  dropped 0 overruns 0  carrier 0  collisions 0

[[email protected] ~]#

Fail2ban

On vérifie que le pare-feu Fail2ban est installé.

[[email protected] ~]# rpm -qa | grep -i fail2ban

fail2ban-firewalld-0.9.7-1.el7.noarch
fail2ban-server-0.9.7-1.el7.noarch
fail2ban-0.9.7-1.el7.noarch
fail2ban-sendmail-0.9.7-1.el7.noarch
nethserver-fail2ban-1.1.6-1.ns7.noarch
fail2ban-shorewall-0.9.7-1.el7.noarch
[[email protected] ~]#

On vérifie que Fail2ban roule sur le serveur.

[[email protected] ~]# ps aux | grep -i fail2ban

root      4586  1.2  0.5 1746708 22656 ?       Sl   12:05   0:28 /usr/bin/python2 -s /usr/bin/fail2ban-server -s /var/run/fail2ban/fail2ban.sock -p /var/run/fail2ban/fail2ban.pid -x -b
root      7161  0.0  0.0 112728   984 pts/0    S+   12:44   0:00 grep --color=auto -i fail2ban
[[email protected] ~]#

ClamAV

Par défaut ClamAV est installé, mais partiellement, et s'occupe seulement du balayage des courriels.

Dans le Cahier-03 : Création d'un Serveur NethServer virtuel du “Cours NethServer-101”, nous avons installé ClamAV qui s'occupe aussi du balayage du système de fichiers.

On vérifie que l'antivirus ClamAV pour le système de fichiers est installé.

[[email protected] ~]# rpm -qa | grep -i clamav

clamav-scanner-systemd-0.101.2-1.el7.x86_64
clamav-lib-0.101.2-1.el7.x86_64
clamav-server-systemd-0.101.2-1.el7.x86_64
clamav-unofficial-sigs-5.6.2-7.el7.noarch
clamav-update-0.101.2-1.el7.x86_64
clamav-0.101.2-1.el7.x86_64
clamav-filesystem-0.101.2-1.el7.noarch
[[email protected] ~]#

Configuration → Scanner Antivirus → onglet Clamscan.

ClamAV lancera un balayage complet du système à 01h00.


Utilisateurs

Utilisateur michelandre

Gestion → Utilisateurs et groupes → onglet Utilisateurs.

L'utilisateur michelandre a été créé dans le Cahier-03 : Création d'un Serveur NethServer virtuel du “Cours NethServer-101”.

Fichier hosts du poste de travail

Nous sommes sur un réseau LOCAL et vu que nous n'avons pas de serveur DNS pour ce réseau, on ajoute des entrées mediawiki dans le fichier:

C:\Windows\System32\drivers\etc\hosts

du poste de travail afin qu'il puisse trouver l'adresse IP de notre serveur MediaWiki.
Pour un serveur directement branché à l'Internet, cette procédure de modification du fichier hosts du poste de travail n'est pas nécessaire s'il existe des CNAME mediawiki chez le régistraire du domaine.


Prérequis

Collection PHP

Version PHP actuelle pour notre Serveur NethServer-7.6-1810.

[[email protected] ~]# php --version

PHP 5.4.16 (cli) (built: Oct 30 2018 19:30:51)
Copyright (c) 1997-2013 The PHP Group
Zend Engine v2.4.0, Copyright (c) 1998-2013 Zend Technologies
[[email protected] ~]#

Comme on le voit, notre version 5.4.16 de PHP est légèrement vieillotte.

Nous allons installer la Collection PHP qui fournit une version plus récente tout en gardant installée la version originale.

Collections de logiciels

Les développeurs de RedHat ont pensé qu'un inconvénient, avec entre autres la version 5 de PHP, allait survenir tôt ou tard et ont écrit les paquetages des Collections.

Tous les RPM des Collections sont installés dans le répertoire /opt; ce qui empêche toutes interférences ou conflits avec les installations par défaut.

But de la Collection PHP

Le but de la Collection PHP est d'installer PHP-5.6, PHP-7.0, PHP-7.1, PHP-7.2 et PHP-7.3 parallèlement à la version installée par défaut avec NethServer-7.6.1810, sans devoir supprimer ou modifier cette dernière. Cette Collection utilise les RPM du référentiel remi qui sont en fait, les mêmes que ceux sur le site Web officiel, mais ils ont l'avantage de fournir plus de choix. Cette Collection nécessite d'installer le référentiel stephdl.

Prérequis pour l'installation de la Collection PHP

Référence: https://wiki.nethserver.org/doku.php?id=php-scl.
Il faut installer les référentiels stephdl et remi pour pouvoir installer la Collection PHP.

Référentiel stephdl

Référence: https://wiki.nethserver.org/doku.php?id=stephdl_repository.

On vérifie si le référentiel stephdl est déjà installé.

[[email protected] ~]# rpm -qa | grep nethserver-stephdl

nethserver-stephdl-1.0.7-1.ns7.sdl.noarch
[[email protected] ~]#

Si ce n'est déjà fait, on installe ce référentiel.

[[email protected] ~]# yum install -y  http://mirror.de-labrusse.fr/NethServer/7/x86_64/nethserver-stephdl-1.0.7-1.ns7.sdl.noarch.rpm

...
Transaction Summary
============================================================================================
Install  1 Package

Total size: 40 k
Installed size: 40 k
...
Installed:
  nethserver-stephdl.noarch 0:1.0.7-1.ns7.sdl

Complete!
[[email protected] ~]#

Vérification.

[[email protected] ~]# rpm -qa | grep stephdl

nethserver-stephdl-1.0.7-1.ns7.sdl.noarch
[[email protected] ~]#

Référentiel remi

On vérifie si le référentiel remi est déjà installé.

[[email protected] ~]# rpm -qa | grep remi

remi-release-7.6-2.el7.remi.noarch
[[email protected] ~]#

Si ce n'est déjà fait, on installe ce référentiel.

[[email protected] ~]# yum install -y http://rpms.famillecollet.com/enterprise/remi-release-7.rpm

...
Transaction Summary
============================================================================================
Install  1 Package

Total size: 19 k
Installed size: 19 k
...
Installed:
  remi-release.noarch 0:7.6-2.el7.remi

Complete!
[[email protected] ~]#

On vérifie.

[[email protected] ~]# rpm -qa | grep remi

remi-release-7.6-2.el7.remi.noarch
[[email protected] ~]#

Installation de la Collection PHP

[[email protected] ~]# yum install -y nethserver-php-scl --enablerepo=stephdl

...
Résumé de la transaction
============================================================================================
Installation   1 Paquet (+127 Paquets en dépendance)

Taille totale des téléchargements : 47 M
Taille d'installation : 134 M
...
  Installation : scl-utils-20130529-19.el7.x86_64                                     1/128
...
  Installation : nethserver-php-scl-1.2.4-1.ns7.sdl.x86_64                          128/128
  Vérification : 1:enchant-1.6.0-8.el7.x86_64                                         1/128
...
  Vérification : php72-php-tidy-7.2.18-1.el7.remi.x86_64                            128/128

Installé :
  nethserver-php-scl.x86_64 0:1.2.4-1.ns7.sdl

Dépendances installées :
  enchant.x86_64 1:1.6.0-8.el7
...
  tcl.x86_64 1:8.5.13-8.el7

Terminé !
[[email protected] ~]#

Usage

Normalement, l'interface Web devrait être complète et vous ne devriez pas devoir utiliser la ligne de commande. Si vous pensez que Stéphane de Labrusse pourrait améliorer les paramètres PHP en apportant plus d'options, veuillez le lui demander: stephd arobas de-labrusse point fr.

Les réglages sont répartis à deux endroits.

  • À la page Gestion → Hôtes virtuels.
    Là, après avoir créé un hôte virtuel, vous pouvez choisir la version que vous utiliserez pour l'Ibay/virtualhost (par défaut, la version PHP d’Apache).
    - Vu que NethServer utilise un script CGI pour gérer la version de PHP, vous ne pourrez pas ajuster les paramètres PHP avec le module nethserver-phpsettings; vous devez régler les paramètres à l'aide du fichier php.ini correspondant. Stéphane de Labrusse voulait coder quelque chose de “cool” afin que tous les paramètres ne soient pas basés uniquement sur des commandes de BD… Il a alors crée une page de configuration.
  • À la page Configuration → Paramètres PHP.
    Là, vous pouvez choisir la version PHP que vous souhaitez utiliser pour l’ensemble du serveur.
    - Lorsqu'Apache est le gestionnaire de PHP, vous pouvez alors définir les paramètres PHP avec le module nethserver-phpsettings. En d'autres termes, si vous souhaitez utiliser le module nethserver-phpsettings et que vous avez besoin d'une version spécifique de PHP, vous devez utiliser cette version pour tout le serveur. Bien sûr, vous pouvez revenir à la version par défaut en cas de problème avec une ancienne application Web. Dans d’autres parties de cette page, vous pouvez ajuster les paramètres PHP pour toutes les versions de PHP.

Répertoire d'installation

Toutes les versions PHP de la Collection proviennent du référentiel remi-safe et sont installées dans le répertoire /opt/remi.

[[email protected] ~]# yum repolist | grep remi

* remi-safe: mirror.team-cymru.com
remi-safe                   Safe Remi's RPM repository for Enterprise Lin  3 191
[[email protected] ~]#

On vérifie le répertoire /opt.

[[email protected] ~]# ls -ls /opt

total 0
0 drwxr-xr-x. 7 root root 81 Jan  4 09:16 puppetlabs
0 drwxr-xr-x  7 root root 71 May 10 17:06 remi
0 drwxr-xr-x  2 root root  6 Oct 30  2018 rh
[[email protected] ~]#

On affiche le répertoire /opt/remi.

[[email protected] ~]# ls -ls /opt/remi

total 0
0 dr-xr-xr-x 3 root root 32 16 mai   13:03 php56
0 dr-xr-xr-x 3 root root 32 16 mai   13:03 php70
0 dr-xr-xr-x 3 root root 32 16 mai   13:03 php71
0 dr-xr-xr-x 3 root root 32 16 mai   13:03 php72
0 dr-xr-xr-x 3 root root 32 16 mai   13:03 php73
[[email protected] ~]#

PHP72 par défaut après une connexion à la ligne de commande

Référence: http://appdev.oit.umn.edu/2015/02/11/scl/

On crée le fichier d'activation qui sera lu lors d'une connexion à la console du Serveur NethServer.

Prendre tout le contenu de l'encadré pour la commande.

cat > /etc/profile.d/activer-php72.sh <<'EOT'
#!/bin/bash
source /opt/remi/php72/enable
if [[ "$X_SCLS" != *php72* ]]; then
src="`scl enable php72 'echo $X_SCLS'`"
pkgs=(${src// / })
uniq=($(printf "%s\n" "${pkgs[@]}" | sort -u));
export X_SCLS="${uniq[@]}"
fi
EOT

On rend le fichier exécutable.

[[email protected] ~]# chmod +x /etc/profile.d/activer-php72.sh

[[email protected] ~]#

On vérifie.

[[email protected] ~]# ls -als /etc/profile.d/activer-php72.sh

4 -rwxr-xr-x 1 root root 215 16 mai   13:11 /etc/profile.d/activer-php72.sh
[[email protected] ~]#
Vérification si PHP72 est le défaut

On ferme la connexion PuTTY et on en ouvre une nouvelle.
On vérifie l'installation de la Collection.

[[email protected] ~]# rpm -qa | grep scl-

centos-release-scl-rh-2-3.el7.centos.noarch
centos-release-scl-2-3.el7.centos.noarch
nethserver-php-scl-1.2.4-1.ns7.sdl.x86_64
scl-utils-20130529-19.el7.x86_64
[[email protected] ~]#

Collections installées.

[[email protected] ~]# scl -l

php56
php70
php71
php72
php73
[[email protected] ~]#

Quel est le PHP par défaut?

[[email protected] ~]# which php

/opt/remi/php72/root/usr/bin/php
[[email protected] ~]#

Quelle est sa version?

[[email protected] ~]# php --version

PHP 7.2.18 (cli) (built: Apr 30 2019 14:41:03) ( NTS )
Copyright (c) 1997-2018 The PHP Group
Zend Engine v3.2.0, Copyright (c) 1998-2018 Zend Technologies
[[email protected] ~]#

Notre fichier activer-php72.sh fonctionne correctement.

Sauvegarde du fichier d'activation

On vérifie si le nom du fichier /etc/profile.d/activer-php72.sh est déjà présent dans le fichier d'inclusion de la sauvegarde des données: /etc/backup-data.d/custom.include, sinon on l'insère.

Prendre tout le contenu de l'encadré pour la commande.

NouvelleInclusion="/etc/profile.d/activer-php72.sh"
if grep -Fxq "$NouvelleInclusion" /etc/backup-data.d/custom.include
then
    # L'entrée a été trouvée dans custom.include
    echo -e "\nLe fichier custom.include contient déjà l'entrée:\n$NouvelleInclusion \n"
else
    # L'entrée n'a pas été trouvée dans custom.include
    echo -e "$NouvelleInclusion" >> /etc/backup-data.d/custom.include
    echo -e "\nL'entrée: $NouvelleInclusion a été ajoutée\n"
fi

On vérifie.

[[email protected] ~]# cat /etc/backup-data.d/custom.include | grep /etc/profile.d/activer-php72.sh

/etc/profile.d/activer-php72.sh
[[email protected] ~]#

Ci-dessus, il n'y a pas de ligne vide avant /etc/profile.d/activer-php72.sh. Nous en avons inséré une afin de faciliter la copie de la commande.

Mise à jour de la Collection

NethServer-7.6.1810 utilise intrinsèquement le référentiel remi-safe. Ce qui signifie qu'il est activé par défaut. Lancez simplement la commande suivante pour mettre à jour la Collection PHP:

[[email protected] ~]# yum update -y nethserver-php-scl --enablerepo=stephdl

Loaded plugins: changelog, fastestmirror, nethserver_events
Loading mirror speeds from cached hostfile
 * ce-base: it.centos.contactlab.it
 * ce-extras: it.centos.contactlab.it
 * ce-updates: it.centos.contactlab.it
 * epel: epel.mirror.constant.com
 * nethforge: mirror.nethserver.org
 * nethserver-base: mirror.nethserver.org
 * nethserver-updates: mirror.nethserver.org
 * remi-safe: rpms.remirepo.net
No packages marked for update
[[email protected] ~]#

S'il y avait une mise à jour, elle serait installée avec cette commande.
La mise à jour du Serveur NethServer s'occupe aussi de celle de la Collection PHP.

Ajustement des paramètres PHP

Les valeurs de certains paramètres de PHP ne sont pas suffisants pour certains ajouts. Ces paramètres sont: MemoryLimit, PostMaxSize et UploadMaxFilesize. Il faut les ajuster.

Affichage des paramètres par défaut.

[[email protected] ~]# config show php72

php72=configuration
    AllowUrlFopen=On
    ExposePhp=0
    MaxExecutionTime=30
    MaxFileUpload=20
    MaxInputTime=60
    MemoryLimit=128
    PostMaxSize=20
    UploadMaxFilesize=10
[[email protected] ~]#

Il faut obligatoirement que le paramètre PostMaxSize soit plus grand que celui de UploadMaxFilesize. Si on modifie l'un, il faut vérifier l'autre pour que la correspondance des grandeurs soit respectée.

Nous allons ajuster: MemoryLimit (250M) > PostMaxSize (100M) > UploadMaxFilesize (75M).

MemoryLimit

Chaque fois qu'un client fait une requête au serveur Web, PHP génère un processus PHP. Le travail de ce processus est de générer du code HTML qu'il envoie au client. Le processus fournit un temps d'exécution à un script qui crée la réponse à la requête. La limite de mémoire MemoryLimit est la quantité maximale de mémoire que ce processus peut utiliser. Si la limite est atteinte ou dépassée, le processus échoue et Apache signale une erreur HTTP 500.

PostMaxSize

Le paramètre PostMaxSize définit la taille maximale autorisée pour les données d'un post. Ce paramètre affecte également le téléchargement de fichiers. Pour télécharger des fichiers volumineux, cette valeur doit absolument être toujours supérieure à UploadMaxFilesize.

UploadMaxFilesize

Pour certaines extensions telles que WooCommerce, WordPress doit autoriser le téléversement de fichiers et la grandeur de ceux-ci ne peut dépasser la limite définie par le paramètre UploadMaxFilesize de PHP.
La limite ci-contre, est celle de WordPress.


Version PHP par défaut

On définit la version PHP par défaut pour Apache.

Configuration → Paramètres PHP → onglet Version PHP Apache → cliquer Php72 SCL Version → SOUMETTRE.


Ajustements des paramètres de la version PHP-7.2

Onglet Php V7.2 SCL
Ajuster tel que ci-contre (250M - 100M - 75M)
→ SOUMETTRE.

Allow PHP access to remote files est un bris de sécurité.


Onglet Version par défaut de PHP
Ajuster tel que ci-contre (250M - 75M - 75M)
→ SOUMETTRE.

Autoriser l'accès PHP aux fichiers distants est un bris de sécurité.

Vérifications à la ligne de commande

MemoryLimit

[[email protected] ~]# cat /etc/opt/remi/php72/php.ini | grep -i Memory_Limit

memory_limit                           = 250M
[[email protected] ~]#

PostMaxSize

[[email protected] ~]# cat /etc/opt/remi/php72/php.ini | grep -i post_max_size

post_max_size                          = 100M
[[email protected] ~]#

UploadMaxFilesize

[[email protected] ~]# cat /etc/opt/remi/php72/php.ini | grep -i upload_max_filesize

upload_max_filesize                    = 75M

Comme on le voit ci-dessus, les grandeurs maximales pour PHP-7.2 sont maintenant de: MemoryLimit (250M) > PostMaxSize (100M) > UploadMaxFilesize (75M).

Instantané VirtualBox

À ce stade-ci, on peut prendre un instantané de la machine virtuelle afin de pouvoir y revenir en cas d'une future erreur de manipulation.

Les prérequis pour le Serveur NethServer sont tous remplis.


Collection MariaDB 10.2

Référence: https://wiki.nethserver.org/doku.php?id=mariadb102.
La Collection rh-mariadb102 est une récente version stable de MariaDB 10.2. Cette Collection de logiciels offre aux utilisateurs de CentOS et RHEL une alternative à MySQL. Compatible binairement avec MySQL et pouvant remplacé ce dernier. Cette version fournit plusieurs nouvelles fonctionnalités et améliorations.

Fin de vie

Référence: https://mariadb.org/about/maintenance-policy/.
La Foundation MariaDB peut décider de maintenir les versions sélectionnées au-delà de la période normale de 5 ans (fin de vie)2) si leur utilisation est exceptionnellement répandue. Vu que la version MariaDB 5.5, incluse dans plusieurs distributions Linux importantes, jouissait d'une durée de vie jusqu'en 2017 (date d'émission + 5ans), la Fondation s’est engagée à la maintenir jusqu’en 2020.

[[email protected] ~]# rpm -qa | grep mariadb

mariadb-server-5.5.60-1.el7_5.x86_64
mariadb-5.5.60-1.el7_5.x86_64
mariadb-libs-5.5.60-1.el7_5.x86_64
[[email protected] ~]#

Vu que la version MariaDB 10.2 est assurée d'une durée de vie jusqu'en 2022, nous avons décidé d'utiliser la Collection MariaDB 10.2 au lieu de la version fournie par NethServer.

Prérequis

L'installation de MariaDB 10.2 requière le référentiel stephdl que nous avons déjà installé. Voir le paragraphe Référentiel stephdl.

Installation de la Collection MariaDB 10.2

[[email protected] ~]# yum install -y --enablerepo=stephdl nethserver-rh-mariadb102

...
Résumé de la transaction
============================================================================================
Installation   1 Paquet (+8 Paquets en dépendance)

Taille totale des téléchargements : 27 M
Taille d'installation : 135 M
...
Installé :
  nethserver-rh-mariadb102.noarch 0:0.0.5-1.ns7.sdl

Dépendances installées :
  rh-mariadb102.x86_64 0:3.0-5.el7
  rh-mariadb102-mariadb.x86_64 1:10.2.8-5.el7
  rh-mariadb102-mariadb-common.x86_64 1:10.2.8-5.el7
  rh-mariadb102-mariadb-config.x86_64 1:10.2.8-5.el7
  rh-mariadb102-mariadb-errmsg.x86_64 1:10.2.8-5.el7
  rh-mariadb102-mariadb-server.x86_64 1:10.2.8-5.el7
  rh-mariadb102-mariadb-server-utils.x86_64 1:10.2.8-5.el7
  rh-mariadb102-runtime.x86_64 0:3.0-5.el7

Terminé !
[[email protected] ~]#
Vérification
[[email protected] ~]# scl -l

php56
php70
php71
php72
php73
rh-mariadb102
[[email protected] ~]#

La Collection a été installée dans le répertoire /opt/rh.

[[email protected] ~]# ls -als /opt/rh

total 0
0 drwxr-xr-x  3 root root 27  8 févr. 19:07 .
0 drwxr-xr-x. 5 root root 46  8 févr. 17:44 ..
0 dr-xr-xr-x  3 root root 59  8 févr. 19:08 rh-mariadb102
[[email protected] ~]#

On affiche les propriétés de la Collection.

[[email protected] ~]# config show rh-mariadb102-mariadb

rh-mariadb102-mariadb=configuration
    LocalNetworkingOnly=no
    MaxAllowedPacket=16M
    TCPPort=3312
    access=private
    status=enabled
[[email protected] ~]#

Le port 3312 est à retenir, car nous l'utiliserons dans le fichier de configuration LocalSettings.php de MediaWiki.

On vérifie que le démon soit activé.

[[email protected] ~]# systemctl list-unit-files | grep mariadb

mariadb.service                               disabled
rh-mariadb102-mariadb.service                 enabled
[email protected]                disabled
[[email protected] ~]#

On vérifie que le démon soit en exécution.

[[email protected] ~]# ps aux | grep mariadb102

mysql     3653  0.2  2.3 1764152 92156 ?       Ssl  19:38   0:01 /opt/rh/rh-mariadb102/root/usr/libexec/mysqld --basedir=/opt/rh/rh-mariadb102/root/usr
root      5716  0.0  0.0 112736   980 pts/0    S+   19:53   0:00 grep --color=auto mariadb102
[[email protected] ~]#

Journal de la Collection

Le journal pour cette Collection est situé dans le fichier /var/log/rh-mariadb102/mariadb.log.

[[email protected] ~]# ls -ls /var/log/rh-mariadb102/mariadb.log

12 -rw-rw---- 1 mysql mysql 7404  8 févr. 19:38 /var/log/rh-mariadb102/mariadb.log
[[email protected] ~]#

Usage

Il n'existe pas de page dédiée à cette Collection dans l'interface Web. Si vous en avez besoin d'une, installez nethserver-phpmyadmin puis, lancez signal-event nethserver-phpmyadmin-save.

Stéphane a créé plusieurs raccourcis pour faciliter l'utilisation de cette Collection depuis votre terminal.

mysql102
mysqladmin102
mysqlbinlog102
mysqlcheck102
mysql_config_editor102
mysqld_multi102
mysqldump102
mysqlimport102
mysql_plugin102
mysqlshow102
mysqlslap102

Si vous voulez lancer MariaDb 10.2 depuis votre terminal, utilisez la commande suivante.

mysql102

Mise à jour de la Collection

Le Serveur NethServer utilise le référentiel remi-safe et ce dernier est activé par défaut. Lancez simplement la commande suivante pour mettre à jour la Collection MariaDB 10.2:

[[email protected] ~]# yum update -y rh-mariadb102-mariadb --enablerepo=stephdl

Modules complémentaires chargés : changelog, fastestmirror, nethserver_events
Loading mirror speeds from cached hostfile
 * ce-base: mirror.rackspace.com
 * ce-extras: mirror.rackspace.com
 * ce-updates: mirror.rackspace.com
 * epel: mirror.texas3006.com
 * nethforge: mirror.nethserver.org
 * nethserver-base: mirror.nethserver.org
 * nethserver-updates: mirror.nethserver.org
 * remi-safe: mirror.bebout.net
No packages marked for update
[[email protected] ~]#

S'il y avait une mise à jour, elle serait installée avec cette commande.

Création de la base de données pour MediaWiki

On crée la base de données (dans notre exemple, on la nomme MediaWikiBD).

[[email protected] ~]# mysqladmin102 CREATE MediaWikiBD

[[email protected] ~]#

On entre dans la console MariaDB 10.2.

[[email protected] ~]# mysql102

Welcome to the MariaDB monitor.  Commands end with ; or \g.
Your MariaDB connection id is 9
Server version: 10.2.8-MariaDB MariaDB Server

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

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

MariaDB [(none)]>

On vérifie que la base de données ait bien été créée.

MariaDB [(none)]> show databases;

+--------------------+
| Database           |
+--------------------+
| MediaWikiBD        |
| information_schema |
| mysql              |
| performance_schema |
| phpmyadmin         |
+--------------------+
5 rows in set (0.01 sec)

MariaDB [(none)]>

Grant

Pour l'usager de la BD de MediaWiki, il faut choisir un mot de passe robuste: au moins 7 caractères, minuscules, majuscules, chiffres et signes non-alphanumériques. Il ne faut pas prendre notre exemple de mot de passe.

On crée un usager pour notre base de données et on lui donne (grant) les permissions nécessaires.

MariaDB [(none)]> grant all on MediaWikiBD.* to [email protected] identified by 'mdp_MediaWikiBD';

Query OK, 0 rows affected (0.01 sec)

MariaDB [(none)]>
Paramètres de la BD pour MediaWiki

Notez le nom de la base de données: MediaWikiBD, le nom de l'usager: usager_MWBD et son mot de passe: mdp_MediaWikiBD; ils serviront plus tard dans le fichier de configuration de MediaWiki.

Il ne faut pas prendre nos paramètres, ils ne sont pas assez robustes.

Vous devez exécuter la commande FLUSH PRIVILEGES ou la commande en ligne mysqladmin102 flushprivileges pour indiquer à MariaDB 10.2 qu'il doit recharger les droits.

MariaDB [(none)]> FLUSH PRIVILEGES;

Query OK, 0 rows affected (0.00 sec)

MariaDB [(none)]>

On vérifie les droits de l'usager .

MariaDB [(none)]> show grants for [email protected];

+--------------------------------------------------------------------------------------------------------------------+
| Grants for [email protected]                                                                                   |
+--------------------------------------------------------------------------------------------------------------------+
| GRANT USAGE ON *.* TO 'usager_MWBD'@'localhost' IDENTIFIED BY PASSWORD '*BEB075ED0A4C05AB21866C4BAA23F5284D8CF90A' |
| GRANT ALL PRIVILEGES ON `MediaWikiBD`.* TO 'usager_MWBD'@'localhost'                                               |
+--------------------------------------------------------------------------------------------------------------------+
2 rows in set (0,00 sec)

MariaDB [(none)]>

On quitte la console de MariaDB 10.2.

MariaDB [(none)]> exit;

Bye
[[email protected] ~]#


Installation de git

On installe git qui nous aidera pour les mises à jour de notre version MediaWiki.

[[email protected] ~]# yum install -y git

...
Installation de     2 paquet(s)

Taille totale des téléchargements : 4.6 M
Taille d'installation : 15 M
...
Installé:
  git.x86_64 0:1.7.1-9.el6_9

Dépendance(s) installée(s) :
  perl-Git.noarch 0:1.7.1-9.el6_9

Terminé !
[[email protected] ~]#


Création de l'hôte virtuel mediawiki

Gestion → Hôtes virtuels → CRÉER NOUVEAU → onglet Général.

Nom
On peut utiliser n'importe quel mot pour Nom, mais il est préférable d'utiliser mediawiki, car un nouveau répertoire sera créé pour le nouvel hôte virtuel et il portera ce nom.

C'est dans ce répertoire qu'on installera MediaWiki.

On entre les informations demandées.

→ SOUMETTRE.




- Onglet Bibliothèque d'applications PHP.
- On ajuste tel que ci-dessous.
- SOUMETTRE.

- Onglet Paramètres PHP.
- On ajuste tel que ci-dessous.
- Autoriser l'accès PHP aux fichiers distants est une faille de sécurité.
- SOUMETTRE.

On vérifie le résultat.


Vérification du répertoire mediawiki

La création de l'hôte virtuel a produit un nouveau répertoire: /var/lib/nethserver/vhost/mediawiki. Ce répertoire prend le Nom utilisé à la section Création de l'hôte virtuel mediawiki.

[[email protected] ~]# ls -alsd /var/lib/nethserver/vhost/mediawiki

0 drwxr-sr-x 2 ftp apache 6 May 25 18:12 /var/lib/nethserver/vhost/mediawiki
[[email protected] ~]#

On voit que le propriétaire est ftp au cas où on utiliserait le service FTP pour la manipulation des fichiers du site. MediaWiki a son propre processus de téléchargement et il n'a pas besoin d'un service FTP externe. De plus, avoir ftp comme propriétaire interfère avec certains logiciels tel WordPress. C'est pour cette raison qu'on n'active jamais FTP sur nos serveurs NethServer.

On change le propriétaire.

[[email protected] ~]# chown apache /var/lib/nethserver/vhost/mediawiki

[[email protected] ~]#

On vérifie.

[[email protected] ~]# ls -alsd  /var/lib/nethserver/vhost/mediawiki

0 drwxr-sr-x 2 apache apache 6 May 25 18:12 /var/lib/nethserver/vhost/mediawiki
[[email protected] ~]#


Création d'une entrée DNS pour l'hôte mediawiki

Configuration → DNS onglet Hôtes → CRÉER NOUVEAU.


On coche wildcard dns record et ainsi on pourra accéder à l'hôte virtuel en utilisant tous ses CNAME dont un des plus importants est mail pour accéder à la messagerie électronique.

Le Nom d'hôte est le FQDN qu'on utilisera pour accéder à notre MediaWiki.

L'Adresse IP est celle de l'interface du réseau LOCAL du Serveur NethServer.

→ SOUMETTRE.


On vérifie le résultat.


Configuration de la messagerie électronique

Si on veut que MediaWiki puisse envoyer et recevoir des courriels, il faut configurer le domaine de l'hôte virtuel en tant que serveur de messagerie électronique.

Configuration → Courrier (Email) → onglet Domaines → CRÉER NOUVEAU.

- On entre les informations demandées.
- SOUMETTRE.


On vérifie le résultat.


Création d'un alias pour l'utilisateur michelandre

Il nous faut créer un alias de messagerie pour l'utilisateur michelandre qui sera l'administrateur du site MediaWiki. Ainsi, il pourra recevoir des courriels en provenance de MediaWiki.



Gestion → Adresse mail → onglet Alias de messagerie → CRÉER NOUVEAU.

- On entre les informations demandées.
- Destination, on entre michelandre, on clique A­jou­ter et on choisit [email protected].
- SOUMETTRE.


On vérifie le résultat.


L'utilisateur michelandre pourra voir ses courriels en se connectant à:

Redirection par le module Proxy inverse

Référence: http://docs.nethserver.org/en/v7/ui/ProxyPass.html.

On installe le module Proxy Inverse qui s'occupera de rediriger les accès à MediaWiki vers le bon endroit.

Installation

Administration → Gestionnaire des logiciels → onglet Disponible → cocher Proxy inverse → AJOUTER.



APPLIQUER LES CHAN­GE­MENTS.


Recharger la page.

Le nouveau menu Proxy inverse est disponible.

Configuration du mandataire inversé

Passerelle → Proxy inverse → onglet Hôtes virtuels → CRÉER NOUVEAU.

On configure le Serveur NethServer en tant que mandataire inversé pour:

www.mediawiki.micronator-dev.org.

- On entre les informations demandées.

- SOUMETTRE.

On vérifie le résultat.

Vérification de la connexion redirigée et sécurisée

On vidange l'historique de notre navigateur et le cache DNS du poste de travail, puis on s'assure que java script et les témoins soient activés.

On se rend à l'URL https://www.mediawiki.micronator-dev.org.

Si on utilisait seulement le protocole http, il serait transformé en https, car lors de la configuration à l'onglet Hôtes virtuels, nous avons coché: ☑ Nécessite une connexion SSL chiffrée.

C'est la page Web par défaut de NethServer qui s'affiche. C'est le comportement normal, car nous n'avons encore aucun fichier dans le répertoire de MediaWiki.

Même si le protocole affiché est https, la connexion n'est pas sécurisée, car le cer­ti­fi­cat ne contient pas le CNAME mediawiki. La prochaine section règlera ce problème.

Instantané VirtualBox

À ce stade-ci, on peut prendre un instantané de la machine virtuelle afin de pouvoir y revenir en cas d'une future erreur de manipulation.

Certificat Let's Encrypt

CNAME

On installe un certificat Let's Encrypt selon la section Certificat pour un domaine LOCAL du Cahier-03: Création d'un Serveur NethServer virtuel du “Cours NethServer-101”.

Il faut ajouter les CNAME mediawiki chez https://www.cloudflare.com/.

On clique micronator-dev.org.

DNS.


On ajoute les CNAME:

mediawiki



www.mediawiki



mail.mediawiki


On rafraîchit la page, on vérifie et on quitte cloudflare.com.


Demande d'un certificat de test

On force –force la demande d'un certificat de TEST –test pour notre domaine micronator-dev.org et six de ses CNAME.

Le certificat sera “émis pour” le premier domaine -d de la liste, c.-à-d. micronator-dev.org.

[[email protected] ~]# /root/.acme.sh/acme.sh                                             \
                      --issue                                                       \
                      --dns dns_cf                                                  \
                      -d micronator-dev.org                                         \
                      -d www.micronator-dev.org                                     \
                      -d mail.micronator-dev.org                                    \
                      -d wpad.micronator-dev.org                                    \
                      -d mediawiki.micronator-dev.org                               \
                      -d www.mediawiki.micronator-dev.org                           \
                      -d mail.mediawiki.micronator-dev.org                          \
                      --cert-file /etc/pki/tls/certs/cert.pem                       \
                      --ca-file /etc/pki/tls/certs/chain.pem                        \
                      --key-file /etc/pki/tls/private/privkey.pem                   \
                      --reloadcmd "/sbin/e-smith/signal-event certificate-update"   \
                      --force                                                       \
                      --test

...
[lun. juin  3 15:01:15 EDT 2019] Installing cert to:/etc/pki/tls/certs/cert.pem
[lun. juin  3 15:01:15 EDT 2019] Installing CA to:/etc/pki/tls/certs/chain.pem
[lun. juin  3 15:01:15 EDT 2019] Installing key to:/etc/pki/tls/private/privkey.pem
[lun. juin  3 15:01:15 EDT 2019] Run reload cmd: /sbin/e-smith/signal-event certificate-update
[lun. juin  3 15:01:18 EDT 2019] Reload success
[[email protected] ~]#

La demande d'un certificat de test a été couronné de succès.

Demande d'un certificat officiel

On force le renouvellement pour l'obtention d'un certificat officiel.

[[email protected] ~]# /root/.acme.sh/acme.sh                                             \
                      --issue                                                       \
                      --dns dns_cf                                                  \
                      -d micronator-dev.org                                         \
                      -d www.micronator-dev.org                                     \
                      -d mail.micronator-dev.org                                    \
                      -d wpad.micronator-dev.org                                    \
                      -d mediawiki.micronator-dev.org                               \
                      -d www.mediawiki.micronator-dev.org                           \
                      -d mail.mediawiki.micronator-dev.org                          \
                      --cert-file /etc/pki/tls/certs/cert.pem                       \
                      --ca-file /etc/pki/tls/certs/chain.pem                        \
                      --key-file /etc/pki/tls/private/privkey.pem                   \
                      --reloadcmd "/sbin/e-smith/signal-event certificate-update"   \
                      --force

...
[lun. juin  3 15:03:02 EDT 2019] Installing cert to:/etc/pki/tls/certs/cert.pem
[lun. juin  3 15:03:02 EDT 2019] Installing CA to:/etc/pki/tls/certs/chain.pem
[lun. juin  3 15:03:02 EDT 2019] Installing key to:/etc/pki/tls/private/privkey.pem
[lun. juin  3 15:03:02 EDT 2019] Run reload cmd: /sbin/e-smith/signal-event certificate-update
[lun. juin  3 15:03:04 EDT 2019] Reload success
[[email protected] ~]#

La demande d'un certificat officiel a été couronné de succès.

Vérification de la connexion sécurisée

Le cadenas est vert, car le certificat a été émis par Let's Encrypt qui est une autorité de certification reconnue et la connexion est sécurisée par un chiffrement TLS/SSL.

C'est la page Web par défaut de NethServer qui s'affiche. C'est le comportement normal, car nous n'avons encore aucun fichier dans le répertoire de MediaWiki.

Si nous avions un site WordPress dans le répertoire web par défaut, c'est la page WordPress du site qui s'afficherait.

Si vous avez de la difficulté à vous connecter, vidanger le cache DNS du poste de travail et celui du navigateur Firefox.

- Sur le poste de travail, ouvrir un écran de commandes.
- ifconfig /flushdns.



Instantané VirtualBox

À ce stade-ci, on peut prendre un instantané de la machine virtuelle afin de pouvoir y revenir en cas d'une future erreur de manipulation.

Historique → Supprimer l'historique ré­cent… → tout → Effacer maintenant.


Installation de MediaWiki

Choix de la version

Avec un fureteur sur la station de travail, on se rend au site de téléchargement de MediaWiki:

https://www.mediawiki.org/wiki/Download/fr.

À la date d'aujourd'hui, c'est la version 1.31.1 qui est la dernière version LTS3) (Long Term Support).

On se rend dans le répertoire mediawiki.

[[email protected] ~]# cd /var/lib/nethserver/vhost/mediawiki/

[[email protected] mediawiki]#

On vérifie.

[[email protected] mediawiki]# pwd

/var/lib/nethserver/vhost/mediawiki
[[email protected] mediawiki]#

On vérifie le contenu du répertoire.

[[email protected] mediawiki]# ls -als

total 0
0 drwxr-sr-x 2 apache apache  6 25 mai   18:12 .
0 drwxr-xr-x 3 root   root   23 25 mai   18:12 ..
[[email protected] mediawiki]#

Téléchargement

Référence: https://www.mediawiki.org/wiki/Download_from_Git/fr.
La première étape consiste à faire un clone du répertoire de MediaWiki. Cette opération prend un moment.
Si vous voulez réduire le nombre de révisions qui sont clonées, ajoutez –depth=1 à la commande ci-dessous.
À la console du serveur, on entre la commande ci-dessous pour que git fasse le téléchargement. Ne pas oublier le “.” à la fin de la commande. Ce “.” indique le répertoire courant.

[[email protected] mediawiki]# git clone https://gerrit.wikimedia.org/r/p/mediawiki/core.git --branch REL1_31 --depth=1 .

Cloning into '.'...
remote: Counting objects: 7317, done
remote: Finding sources: 100% (7317/7317)
remote: Getting sizes: 100% (6239/6239)
remote: Compressing objects:  99% (91737/91738)
remote: Total 7317 (delta 1648), reused 3191 (delta 1077)
Receiving objects: 100% (7317/7317), 27.13 MiB | 1.73 MiB/s, done.
Resolving deltas: 100% (1648/1648), done.
[[email protected] mediawiki]#

Mise à jour des modules

Les branches de publication contiennent un tas de sous-modules Git, pour les extensions et les skins couramment utilisés (la branche master ne les possède pas).

On met à jour les sous-modules.

[[email protected] mediawiki]# git submodule update --init

Submodule 'extensions/CategoryTree' (https://gerrit.wikimedia.org/r/mediawiki/extensions/CategoryTree) registered for path 'extensions/CategoryTree'
...

...
Submodule path 'skins/Vector': checked out 'f0327dc5558395186eddd3911508817482cd4bc4'
Cloning into 'vendor'...
remote: Counting objects: 5, done
remote: Total 25438 (delta 0), reused 25438 (delta 0)
Receiving objects: 100% (25438/25438), 22.01 MiB | 1.78 MiB/s, done.
Resolving deltas: 100% (17591/17591), done.
Submodule path 'vendor': checked out '1521f359a06aed626e860285769ed78a7152cdec'
[[email protected] mediawiki]#

Ajustement du propriétaire et du groupe

[[email protected] mediawiki]# chown -R apache:apache *  ; chown -R apache:apache .*

[[email protected] mediawiki]#

Ajustement des droits

On renforce la sécurité de l’accès aux fichiers f en supprimant les droits à “other”.

[[email protected] mediawiki]# find . -type f -exec chmod 640 {} \;

[[email protected] mediawiki]#

On répète l'opération pour les répertoires d.

[[email protected] mediawiki]# find . -type d -exec chmod 2750 {} \;

[[email protected] mediawiki]#

On vérifie.

[[email protected] mediawiki]# ls -als

total 1296
  4 drwxr-s--- 16 apache apache   4096  3 juin  15:20 .
  0 drwxr-xr-x  3 root   root       23 25 mai   18:12 ..
  8 -rw-r-S---  1 apache apache   4697  3 juin  15:20 api.php
136 -rw-r-S---  1 apache apache 136895  3 juin  15:20 autoload.php
  0 drwxr-s---  2 apache apache     23  3 juin  15:20 cache
  4 -rw-r-S---  1 apache apache    116  3 juin  15:20 CODE_OF_CONDUCT.md
  4 -rw-r-S---  1 apache apache   3571  3 juin  15:20 composer.json
  4 -rw-r-S---  1 apache apache    102  3 juin  15:20 composer.local.json-sample
 20 -rw-r-S---  1 apache apache  19421  3 juin  15:20 COPYING
 12 -rw-r-S---  1 apache apache  11526  3 juin  15:20 CREDITS
  4 drwxr-s---  8 apache apache   4096  3 juin  15:20 docs
  4 -rw-r-S---  1 apache apache    207  3 juin  15:20 .eslintrc.json
  4 drwxr-s--- 24 apache apache   4096  3 juin  15:20 extensions
  4 -rw-r-S---  1 apache apache     95  3 juin  15:20 FAQ
  0 drwxr-s---  9 apache apache    193  3 juin  15:21 .git
  4 -rw-r-S---  1 apache apache    258  3 juin  15:20 .gitattributes
  4 -rw-r-S---  1 apache apache   1041  3 juin  15:20 .gitignore
  4 -rw-r-S---  1 apache apache   3962  3 juin  15:20 .gitmodules
  4 -rw-r-S---  1 apache apache     97  3 juin  15:20 .gitreview
  4 -rw-r-S---  1 apache apache   3499  3 juin  15:20 Gruntfile.js
872 -rw-r-S---  1 apache apache 888845  3 juin  15:20 HISTORY
  0 drwxr-s---  2 apache apache     37  3 juin  15:20 images
  8 -rw-r-S---  1 apache apache   7705  3 juin  15:20 img_auth.php
 12 drwxr-s--- 71 apache apache   8192  3 juin  15:20 includes
  4 -rw-r-S---  1 apache apache   1579  3 juin  15:20 index.php
  4 -rw-r-S---  1 apache apache   3681  3 juin  15:20 INSTALL
  4 -rw-r-S---  1 apache apache   2042  3 juin  15:20 jsduck.json
  0 drwxr-s---  6 apache apache    229  3 juin  15:20 languages
  4 -rw-r-S---  1 apache apache   1950  3 juin  15:20 load.php
 24 -rw-r-S---  1 apache apache  23988  3 juin  15:20 .mailmap
 12 drwxr-s--- 17 apache apache   8192  3 juin  15:20 maintenance
  0 drwxr-s---  4 apache apache    110  3 juin  15:20 mw-config
  4 -rw-r-S---  1 apache apache   4059  3 juin  15:20 opensearch_desc.php
  4 -rw-r-S---  1 apache apache   1149  3 juin  15:20 package.json
  8 -rw-r-S---  1 apache apache   4428  3 juin  15:20 .phpcs.xml
 12 -rw-r-S---  1 apache apache  12026  3 juin  15:20 profileinfo.php
  4 -rw-r-S---  1 apache apache   1529  3 juin  15:20 README
  0 lrwxrwxrwx  1 apache apache      6  3 juin  15:20 README.mediawiki -> README
 36 -rw-r-S---  1 apache apache  33239  3 juin  15:20 RELEASE-NOTES-1.31
  0 drwxr-s---  5 apache apache     63  3 juin  15:20 resources
  4 -rw-r-S---  1 apache apache    199  3 juin  15:20 SECURITY
  0 drwxr-s---  2 apache apache    162  3 juin  15:20 serialized
  0 drwxr-s---  5 apache apache     84  3 juin  15:20 skins
  4 -rw-r-S---  1 apache apache   1703  3 juin  15:20 StartProfiler.sample
  4 -rw-r-S---  1 apache apache    125  3 juin  15:20 .stylelintrc.json
  0 drwxr-s---  9 apache apache    126  3 juin  15:20 tests
  4 -rw-r-S---  1 apache apache   1087  3 juin  15:20 thumb_handler.php
 24 -rw-r-S---  1 apache apache  22633  3 juin  15:20 thumb.php
  4 -rw-r-S---  1 apache apache   2487  3 juin  15:20 .travis.yml
 12 -rw-r-S---  1 apache apache  12247  3 juin  15:20 UPGRADE
  0 drwxr-s--- 10 apache apache    264  3 juin  15:22 vendor
[[email protected] mediawiki]#


Installation de MediaWiki

On se rend sur notre site: https://mediawiki.FQDN, c.-à-d. https://www.mediawiki.micronator-dev.org.

On clique set up the wiki.

On choisit la langue du wiki → Continuer.


On peut ignorer le message à propos de PECL.

L’environnement a été vérifié. Vous pouvez installer MediaWiki. → Continuer.


On peut utiliser un préfixe pour les tables, mais ce n'est pas nécessaire si on n'installe qu'un seul site MediaWiki sur notre serveur.

- On prend le défaut pour le type de base de donnée.
- Nom d’hôte de la base de données :
On indique obligatoirement 127.0.0.1:3312.
(Le port 3312 étant celui utilisé par MariaDB-102.)

- On entre les paramètres décrits au paragraphe Paramètres de la BD pour MediaWiki.
MediaWikiBD
usager_MWBD
mdp_MediaWikiBD
- Continuer.






On prend les défauts → Continuer.






On entre le nom désiré pour notre wiki.

- On entre le nom de l'administrateur de notre wiki et son mot de passe qu'on confirme.
- On entre l'adresse courriel de l'administrateur.



- Pour faciliter la configuration, on demande plus de question.
- Continuer.

Si vous n'avez pas de certificat SSH d'une Autorité de Certification (CA) reconnue, il vaut mieux utiliser une Adresse de courriel autre que celle du serveur, car vous ne pourrez accéder à Webmail; ce dernier n'autorise que les connexions sécurisées.

  • Pour l'installation d'un certificat Let's Encrypt sur un serveur LOCAL, voir le Cahier-04: NethServer LOCAL & Certificat Let's Encrypt du “Cours NethServer-101”.
  • Pour un serveur directement branché à l'Internet, voir le Cahier05: VDSL, FQDN, Internet et NethServer du “Cours NethServer-101”.




On choisit le profil des droits d'utilisateurs.




On choisit notre licence.

- On choisit [email protected] pour les retours de courriels.
- Au choix, on active les notifications.

Ci-dessus, à droite, si on choisit une autre Adresse de courriel de retour, il faudra créer l'usager dans l'interface Web NethServer et aussi créer un alias de messagerie pour ce nouvel utilisateur.




On choisit les habillages.




On choisit les extensions désirées.

- On coche Activer le téléchargement de fichiers.
- Pour l'instant, le logo par défaut sera utilisé.


- On choisit de ne pas utiliser de mise en cache.
- Continuer.



Continuer.



Continuer.


On sauvegarde le fichier de configuration sur le poste de travail → OK.


Téléversement du fichier de configuration

On téléverse le fichier de configuration, qu'on vient de sauvegarder sur le poste de travail, à la racine de notre site.
Pour ce faire, on peut utiliser WinSCP ou Filezilla.


Ajustement des droits

Si nous n'y sommes pas déjà, on se rend à la racine de notre site pour ajuster le propriétaire et les droits de notre site.

[[email protected] ~]# cd /var/lib/nethserver/vhost/mediawiki/

[[email protected] mediawiki]#

On vérifie.

[[email protected] mediawiki]# pwd

/var/lib/nethserver/vhost/mediawiki
[[email protected] mediawiki]#

Ajustement du propriétaire et du groupe

[[email protected] mediawiki]# chown -R apache:apache *  ; chown -R apache:apache .*

[[email protected] mediawiki]#

Ajustement des droits

On renforce la sécurité de l’accès aux fichiers f en supprimant les droits à “other”.

[[email protected] mediawiki]# find . -type f -exec chmod 640 {} \;

[[email protected] mediawiki]#

On répète l'opération pour les répertoires d.

[[email protected] mediawiki]# find . -type d -exec chmod 2750 {} \;

[[email protected] mediawiki]#

On vérifie pour les fichiers, les répertoires et les fichiers cachés et de plus, “other” n'a aucun droits.

[[email protected] mediawiki]# ls -als

total 1304
  4 drwxr-s--- 16 apache apache   4096  3 juin  16:39 .
  0 drwxr-xr-x  3 root   root       23 25 mai   18:12 ..
  8 -rw-r-S---  1 apache apache   4697  3 juin  15:20 api.php
...
  4 -rw-r-S---  1 apache apache    207  3 juin  15:20 .eslintrc.json
...
  0 drwxr-s---  2 apache apache     37  3 juin  16:23 images
...
  8 -rw-r-S---  1 apache apache   5652  3 juin  16:38 LocalSettings.php
...
  0 drwxr-s--- 10 apache apache    264  3 juin  15:22 vendor
[[email protected] mediawiki]#


Accès et login à MediaWiki

On retourne à l'écran d'installation et on clique accéder à votre wiki.


Se connecter.

On se connecte.


Victoire totale, notre site MediaWiki est fonctionnel.

Instantané VirtualBox

À ce stade-ci, on peut prendre un instantané de la machine virtuelle afin de pouvoir y revenir en cas d'une future erreur de manipulation.


Configuration

Préparation

Si nous avons installé MediaWiki plus d'une fois à cause d'une erreur, si nous avons changé d'adresse IP du serveur ou du poste de travail ou pour quelque raison que ce soit, il faudrait mieux être prudent et vidanger le cache DNS du poste de travail et celui du navigateur Firefox.

- Sur le poste de travail, ouvrir un écran de commandes.
- ifconfig /flushdns.

Historique → Supprimer l'historique ré­cent… → tout → Effacer maintenant.

Login

Si ce n'est déjà fait, on se logue à notre MediaWiki.

On donne l'adresse à notre fireteur et on se connecte.

On se logue.

Confirmation de l'adresse courriel

L'adresse courriel est facultative, mais elle est nécessaire pour réinitialiser votre mot de passe si vous veniez à l'oublier.

Vous pourriez aussi choisir de laisser les autres vous contacter sur votre page de discussion utilisateur, sans qu'il ne soit nécessaire de révéler votre identité.

Préférences.

Onglet Informations personnelles → cadre Options des courriels → cliquez Confirmez votre adresse de courriel.



Envoyer un code de confirmation.


MediaWiki affiche que le courriel de confirmation a été envoyé.




Dans le courriel qu'on reçoit, on clique le lien de confirmation.




MediaWiki affiche que notre adresse courriel a été confirmée.

Dans Préférences → onglet Informations personnelles → cadre Options des courriels → une ligne indique que notre adresse de courriel a été confirmée.


Importation de fichiers

Sur la page d'accueil, on clique Importer un fichier.


Parcourir → sélectionner l'image → Ouvrir → entrer une description décocher Suivre ce fichier → Importer le fichier.

Remarquez les Formats de fichiers autorisés : png, gif, jpg, jpeg et webp. Nous réglerons ce détail dans une prochaine section.

- Le fichier a été importé.
- Afficher les informations détaillées.

Les métadonnées sont affichées.

Répertoires d'importation

Après quelques importations d'images, MediaWiki aura créé plusieurs sous-répertoires pour les y emmagasiner et il en aura fait de même pour leurs miniatures (thumb).

[[email protected] ~]# ls -als /var/lib/nethserver/vhost/mediawiki/images/

total 12
0 drwxr-s---  6 apache apache   89  3 juin  20:35 .
4 drwxr-s--- 16 apache apache 4096  3 juin  16:39 ..
0 drwxr-sr-x  3 apache apache   16  3 juin  20:35 9
0 drwxr-sr-x  3 apache apache   15  3 juin  20:35 archive
4 -rw-r-S---  1 apache apache  252  3 juin  15:20 .htaccess
0 drwxr-sr-x  2 apache apache    6  3 juin  20:35 lockdir
4 -rw-r-S---  1 apache apache   84  3 juin  15:20 README
0 drwxr-sr-x  3 apache apache   15  3 juin  20:35 thumb
[[email protected] ~]#

On affiche le contenu des sous-répertoires.

[[email protected] ~]# ls -alsR /var/lib/nethserver/vhost/mediawiki/images/9

/var/lib/nethserver/vhost/mediawiki/images/9:
total 0
0 drwxr-sr-x 3 apache apache 16  3 juin  20:35 .
0 drwxr-s--- 6 apache apache 89  3 juin  20:35 ..
0 drwxr-sr-x 2 apache apache 42  3 juin  20:35 90

/var/lib/nethserver/vhost/mediawiki/images/9/90:
total 180
  0 drwxr-sr-x 2 apache apache     42  3 juin  20:35 .
  0 drwxr-sr-x 3 apache apache     16  3 juin  20:35 ..
180 -rw-r--r-- 1 apache apache 183095  3 juin  20:35 But_du_cahier-201.03_APT.png
[[email protected] ~]#
[[email protected] ~]# ls -alsR /var/lib/nethserver/vhost/mediawiki/images/thumb/

/var/lib/nethserver/vhost/mediawiki/images/thumb/:
total 0
0 drwxr-sr-x 3 apache apache 15  3 juin  20:35 .
0 drwxr-s--- 6 apache apache 89  3 juin  20:35 ..
0 drwxr-sr-x 3 apache apache 16  3 juin  20:35 9

/var/lib/nethserver/vhost/mediawiki/images/thumb/9:
total 0
0 drwxr-sr-x 3 apache apache 16  3 juin  20:35 .
0 drwxr-sr-x 3 apache apache 15  3 juin  20:35 ..
0 drwxr-sr-x 3 apache apache 42  3 juin  20:35 90

/var/lib/nethserver/vhost/mediawiki/images/thumb/9/90:
total 0
0 drwxr-sr-x 3 apache apache  42  3 juin  20:35 .
0 drwxr-sr-x 3 apache apache  16  3 juin  20:35 ..
0 drwxr-sr-x 2 apache apache 132  3 juin  20:35 But_du_cahier-201.03_APT.png

/var/lib/nethserver/vhost/mediawiki/images/thumb/9/90/But_du_cahier-201.03_APT.png:
total 288
  0 drwxr-sr-x 2 apache apache    132  3 juin  20:35 .
  0 drwxr-sr-x 3 apache apache     42  3 juin  20:35 ..
 12 -rw-r--r-- 1 apache apache  10663  3 juin  20:35 120px-But_du_cahier-201.03_APT.png
 52 -rw-r--r-- 1 apache apache  51071  3 juin  20:35 320px-But_du_cahier-201.03_APT.png
224 -rw-r--r-- 1 apache apache 226306  3 juin  20:35 800px-But_du_cahier-201.03_APT.png
[[email protected] ~]#

Formats de fichiers autorisés

Par défaut, les seuls formats de fichiers autorisés sont: png, gif, jpg, jpeg et webp.

Pour remédier à cette situation, il faut éditer le fichier LocalSettings.php.


On ajoute, à la fin du fichier LocalSettings.php, des lignes de paramètres avec celles de leur commentaire.

Afin de faciliter la maintenance, on ajoute à la fin du fichier les paramétrages spécifiques (pour bien différencier l'installation par défaut des réglages et extensions spécifiques).

Prendre tout le contenu de l'encadré pour la commande.

cat >> /var/lib/nethserver/vhost/mediawiki/LocalSettings.php <<'EOT'

#####  ***********************
# 2018-05-19_22h48 HNE //  Michel-André
# On ajoute à la fin du fichier les paramétrages spécifiques (pour bien différencier
# l'installation par défaut des réglages et extensions spécifiques) afin de faciliter
# la maintenance.

# Limite de taille de fichier, ici 50MB
$wgMaxUploadSize = 1024*1024*50;

# Doit-on vérifier l'extension du nom de fichier à l'upload? oui
$wgCheckFileExtensions = true;

# Les extensions autorisées
$wgFileExtensions = array( 'png', 'gif', 'jpg', 'jpeg', 'ppt', 'pdf', 'psd', 'mp3', 'xls', 'xlsx', 'swf', 'doc','docx', 'odt', 'odc', 'odp', 'odg', 'mpp', 'webp');

# Les extensions spécifiquement interdites
# HTML may contain cookie-stealing JavaScript and web bugs
# PHP scripts may execute arbitrary code on the server
# Other types that may be interpreted by some servers
# May contain harmful executables for Windows victims
$wgFileBlacklist = array( 'html', 'htm', 'js', 'jsb', 'mhtml', 'mht', 'xhtml', 'xht', 'php', 'phtml', 'php3', 'php4', 'php5', 'phps', 'shtml', 'jhtml', 'pl', 'py', 'cgi', 'exe', 'scr', 'dll', 'msi', 'vbs', 'bat', 'com', 'pif', 'cmd', 'vxd', 'cpl' );

EOT

Porter une attention particulière aux fichiers qui peuvent contenir des macros.

Ici, la limite est de 50Mo.

...
# Limite de taille de fichier, ici 50MB
$wgMaxUploadSize = 1024*1024*50;
...

On peut spécifier un nombre plus grand dans le fichier LocalSettings.php mais, la véritable limite maximale qu'on peut définir est celle spécifiée par UploadMaxFilesize au paragraphe UploadMaxFilesize.

On vérifie notre ajout au fichier LocalSettings.php.

[[email protected] ~]# tail -23 /var/lib/nethserver/vhost/mediawiki/LocalSettings.php

#####  ***********************
# 2018-05-19_22h48 HNE //  Michel-André
# On ajoute à la fin du fichier les paramétrages spécifiques (pour bien différencier
# l'installation par défaut des réglages et extensions spécifiques) afin de faciliter
# la maintenance.

# Limite de taille de fichier, ici 50MB
$wgMaxUploadSize = 1024*1024*50;

# Doit-on vérifier l'extension du nom de fichier à l'upload? oui
$wgCheckFileExtensions = true;

# Les extensions autorisées
$wgFileExtensions = array( 'png', 'gif', 'jpg', 'jpeg', 'ppt', 'pdf', 'psd', 'mp3', 'xls', 'xlsx', 'swf', 'doc','docx', 'odt', 'odc', 'odp', 'odg', 'mpp', 'webp');

# Les extensions spécifiquement interdites
# HTML may contain cookie-stealing JavaScript and web bugs
# PHP scripts may execute arbitrary code on the server
# Other types that may be interpreted by some servers
# May contain harmful executables for Windows victims
$wgFileBlacklist = array( 'html', 'htm', 'js', 'jsb', 'mhtml', 'mht', 'xhtml', 'xht', 'php', 'phtml', 'php3', 'php4', 'php5', 'phps', 'shtml', 'jhtml', 'pl', 'py', 'cgi', 'exe', 'scr', 'dll', 'msi', 'vbs', 'bat', 'com', 'pif', 'cmd', 'vxd', 'cpl' );

[[email protected] ~]#

On vérifie dans l'interface MediaWiki.

Accueil → Importer un fichier.

Logo du wiki

La taille maximale pour un logo avec l'habillage Vector est de 160x160px. Les formats pour Standard et Classic est de 135x135px. Dans les habillages Vector et MonoBook, un logo trop grand sera coupé tandis que pour Standard et Classic, il s'étendra légèrement à l'intérieur du périmètre du contenu.

Il ne faut tout simplement pas écraser le fichier wiki.png par notre logo, car à la prochaine mise à jour, celle-ci va écraser ce fichier.

Importer un fichier.

Parcourir.

On peut remarquer la Taille maximale du fichier : 50 Mio qu'on a configurée à la section Formats de fichiers autorisés.


- On se rend dans le répertoire contenant le fichier de notre logo sur notre poste de travail, on le sélectionne → Ouvrir.
- Notre logo apparaît dans MediaWiki.

- On ajoute une description.
- On décoche Suivre ce fichier.
- Importer le fichier.


On claque sur le nom du fichier → Copier l'adresse du lien.

On voit où se trouve le fichier de notre logo.

https://www.mediawiki.micronator-dev.org/images/b/bb/LogoMicronatorMediawiki_135_APT.png

Le répertoire racine de notre site est: https://www.mediawiki.micronator-dev.org/.

Le chemin relatif du fichier est donc: /images/b/bb/LogoMicronatorMediawiki135APT.png.

● On spécifie notre logo à la fin du fichier de configuration LocalSettings.php.

Prendre tout le contenu de l'encadré pour la commande.

cat >> /var/lib/nethserver/vhost/mediawiki/LocalSettings.php <<'EOT'

#####  ***********************
# Le logo de Micronator
$wgLogo = "{$wgScriptPath}/images/b/bb/LogoMicronatorMediawiki_135_APT.png";

EOT

On vérifie.

[[email protected] ~]# tail -5 /var/lib/nethserver/vhost/mediawiki/LocalSettings.php

#####  ***********************
# Le logo de Micronator
$wgLogo = "{$wgScriptPath}/images/b/bb/LogoMicronatorMediawiki_135_APT.png";

[[email protected] ~]#


On se rend à la page d'Accueil.

Notre logo apparaît.


Instantané VirtualBox

À ce stade-ci, on peut prendre un instantané de la machine virtuelle afin de pouvoir y revenir en cas d'une future erreur de manipulation.

Notre site MediaWiki est toujours fonctionnel.


Semantic MediaWiki (SMW)

Référence: http://semantic-mediawiki.org/wiki/Help:Pr%C3%A9sentation_de_Semantic_MediaWiki
Semantic MediaWiki (SMW) est une extension de MediaWiki – l'application wiki bien connue sur laquelle repose Wikipédia – qui permet de rechercher, organiser, baliser, naviguer, évaluer et partager le contenu d'un wiki. Alors que les wikis traditionnels ne peuvent contenir que du texte ne pouvant être ni compris, ni évalué par les ordinateurs, SMW ajoute des annotations sémantiques permettant à un wiki de fonctionner comme une base de données collaborative. Semantic MediaWiki, qui a été diffusé pour la première fois en 2005, évolue aujourd'hui grâce à plus de dix développeurs et est utilisé sur des centaines de sites. De plus, un grand nombre d'extensions liées ont été créées permettant d'étendre la capacité de modifier, afficher et naviguer à travers des données stockées par SMW: le terme “Semantic MediaWiki” est quelquefois utilisé pour désigner la famille complète des extensions.

Là où SMW est utile

Semantic MediaWiki introduit certaines balises supplémentaires dans le texte wiki qui permettent aux utilisateurs d'ajouter des “annotations sémantiques” au wiki. Bien qu'à première vue, ceci tend à rendre les choses plus complexes, cela peut considérablement simplifier la structure du wiki, aider les utilisateurs à trouver un maximum d'informations en un minimum de temps ainsi qu'augmenter la qualité générale et la cohérence du wiki.

LocalSettings.php

Paramètre $wgShellLocale

Il nous faut changer le paramètre $wgShellLocale dans le fichier LocalSettings.php de MediaWiki.

Référence: https://www.semantic-mediawiki.org/wiki/Help:Installation/General_notes.
Si vous utilisez MediaWiki 1.30.x et supérieur, il est recommandé de changer le paramètre de configuration $wgShellLocale (MediaWiki.org) en C.UTF-8, tel que recommandé par les principaux développeurs de MediaWiki.

On se rend dans le répertoire racine de notre MediaWiki.

[[email protected] ~]# cd /var/lib/nethserver/vhost/mediawiki

[[email protected] mediawiki]#

On vérifie.

[[email protected] mediawiki]# pwd

/var/lib/nethserver/vhost/mediawiki
[[email protected] mediawiki]#

On fait une sauvegarde du fichier.

[[email protected] mediawiki]# cp LocalSettings.php  LocalSettings.php_avant-Semantic

[[email protected] mediawiki]#

On vérifie.

[[email protected] mediawiki]# ls -als LocalSettings.php*

8 -rw-r-S--- 1 apache apache 7092  3 juin  21:24 LocalSettings.php
8 -rw-r----- 1 root   apache 7092  3 juin  22:08 LocalSettings.php_avant-Semantic
[[email protected] mediawiki]#

On affiche le paramètre.

[[email protected] mediawiki]# cat LocalSettings.php | grep wgShellLocale

$wgShellLocale = "en_US.utf8";
[[email protected] mediawiki]#

On change la valeur du paramètre de: en_US.utf8 à: C.UTF-8.

[[email protected] mediawiki]# sed -i 's/en_US.utf8/C.UTF-8/' LocalSettings.php

[[email protected] mediawiki]#

On vérifie.

[[email protected] mediawiki]# cat LocalSettings.php | grep wgShellLocale

$wgShellLocale = "C.UTF-8";
[[email protected] mediawiki]#

Composer

Référence: https://www.semantic-mediawiki.org/wiki/Help:Installation/fr.
La méthode recommandée pour installer Semantic MediaWiki est d'utiliser Composer.

Allow php access to remote files

L'installeur de Composer va avoir besoin d'exécuter un fichier php externe.

Il nous faut modifier tempo­rai­re­ment l'accès PHP aux fichiers distants.

Configuration → Paramètres PHP → onglet Php V7.2 SCL.

On coche Allow php access to remote files → SOUMETTRE.

mbstring

L'extension mbstring permet l'utilisation de fonctions PHP multi-octets.

On s'assure que l'extension mbstring est présente dans PHP-7.2.

[[email protected] mediawiki]# php --re mbstring | head -n 1

Extension [ <persistent> extension #31 mbstring version 7.2.19 ] {
[[email protected] mediawiki]#

On s'assure qu'on est bien dans le répertoire racine de notre wiki.

[[email protected] mediawiki]# pwd

/var/lib/nethserver/vhost/mediawiki
[[email protected] mediawiki]

On télécharge l'installeur de Composer.

[[email protected] mediawiki]# wget http://getcomposer.org/installer

--2019-06-03 22:59:06--  http://getcomposer.org/installer
Résolution de getcomposer.org (getcomposer.org)... 142.44.245.229, 2607:5300:201:2100::4:d105
Connexion vers getcomposer.org (getcomposer.org)|142.44.245.229|:80...connecté.
requête HTTP transmise, en attente de la réponse...200 OK
Longueur: 263790 (258K) [application/octet-stream]
Sauvegarde en : «installer»

100%[==================================================>] 263 790     1,58MB/s   ds 0,2s

2019-06-03 22:59:06 (1,58 MB/s) - «installer» sauvegardé [263790/263790]

[[email protected] mediawiki]#

On vérifie.

[[email protected] mediawiki]# ls -als installer

260 -rw-r--r-- 1 root apache 263790 29 janv. 09:19 installer
[[email protected] mediawiki]#

On installe Composer.

[[email protected] mediawiki]# php installer

All settings correct for using Composer
Downloading...

Composer (version 1.8.5) successfully installed to: /var/lib/nethserver/vhost/mediawiki/composer.phar
Use it: php composer.phar

[[email protected] mediawiki]#

On vérifie l'installation.

[[email protected] mediawiki]# ls -als composer.phar

1872 -rwxr-xr-x 1 root apache 1914314  3 juin  22:59 composer.phar
[[email protected] mediawiki]#

On supprime le fichier installeur.

[[email protected] mediawiki]# rm installer

rm : supprimer fichier « installer » ? o
[[email protected] mediawiki]#

On vérifie.

[[email protected] mediawiki]# ls -als insta*

ls: impossible d'accéder à insta*: Aucun fichier ou dossier de ce type
[[email protected] mediawiki]#

Installation de Semantic MediaWiki avec Composer

Préparation

On peut ignorer l'avertissement car nous utilisons les options: –no-plugins et –no-scripts. Pour plus de détails, voir: https://getcomposer.org/root.

[[email protected] mediawiki]# php composer.phar install --no-plugins --no-scripts

Do not run Composer as root/super user! See https://getcomposer.org/root for details
Loading composer repositories with package information
Updating dependencies (including require-dev)
Package operations: 49 installs, 3 updates, 0 removals
  - Updating pear/console_getopt (v1.4.1 => v1.4.2): As there is no 'unzip' command installed zip files are being unpacked using the PHP zip extension.
This may cause invalid reports of corrupted archives. Besides, any UNIX permissions (e.g. executable) defined in the archives will be lost.
Installing 'unzip' may remediate them.
Downloading (100%)
  - Updating pear/pear-core-minimal (v1.10.3 => v1.10.9): Downloading (100%)
...
  - Installing wmde/hamcrest-html-matchers (v0.1.1): Downloading (100%)
monolog/monolog suggests installing graylog2/gelf-php (Allow sending log messages to a GrayLog2 server)
...
monolog/monolog suggests installing php-console/php-console (Allow sending log messages to Google Chrome)
symfony/var-dumper suggests installing ext-intl (To show region name in time zone dump)
...
symfony/console suggests installing symfony/process
psy/psysh suggests installing ext-pdo-sqlite (The doc command requires SQLite to work.)
psy/psysh suggests installing hoa/console (A pure PHP readline implementation. You'll want this if your PHP install doesn't already support readline or libedit.)
wikimedia/avro suggests installing ext-gmp (Large integer support for 32-bit platforms.)
sebastian/global-state suggests installing ext-uopz (*)
phpunit/php-code-coverage suggests installing ext-xdebug (^2.5.5)
phpunit/phpunit suggests installing phpunit/php-invoker (^1.1)
phpunit/phpunit suggests installing ext-xdebug (*)
Package phpunit/phpunit-mock-objects is abandoned, you should avoid using it. No replacement was suggested.
Writing lock file
Generating optimized autoload files
[[email protected] mediawiki]#

Installation de la version 3.0 de SMW

[[email protected] mediawiki]# php composer.phar require mediawiki/semantic-media-wiki "~3.0"

Do not run Composer as root/super user! See https://getcomposer.org/root for details
./composer.json has been updated
> ComposerHookHandler::onPreUpdate
Loading composer repositories with package information
Updating dependencies (including require-dev)
Package operations: 23 installs, 1 update, 0 removals
  - Installing composer/installers (v1.6.0): Downloading (100%)
...
  - Installing mediawiki/semantic-media-wiki (3.0.0): Downloading (100%)
mediawiki/semantic-media-wiki suggests installing mediawiki/semantic-result-formats (Provides additional result formats for queries of structured data)
Writing lock file
Generating optimized autoload files
> ComposerVendorHtaccessCreator::onEvent
[[email protected] mediawiki]#

Activation de SMW

Prendre tout le contenu de l'encadré pour la commande.

cat >> LocalSettings.php <<'EOT'

#####  ***********************
# EXTENSION:SemanticMediaWiki
# Semantic MediaWiki introduit certaines balises supplémentaires dans le texte wiki qui
# permettent aux utilisateurs d'ajouter des "annotations sémantiques" au wiki.
require_once "$IP/extensions/SemanticMediaWiki/SemanticMediaWiki.php";
enableSemantics( '10.10.10.75' );

EOT

On vérifie.

[[email protected] mediawiki]# tail -7 LocalSettings.php

#####  ***********************
# EXTENSION:SemanticMediaWiki
# Semantic MediaWiki introduit certaines balises supplémentaires dans le texte wiki qui
# permettent aux utilisateurs d'ajouter des "annotations sémantiques" au wiki.
require_once "$IP/extensions/SemanticMediaWiki/SemanticMediaWiki.php";
enableSemantics( '10.10.10.75' );

[[email protected] mediawiki]#

setupStore.php

Configuration du système de stockage SMW actuellement sélectionné dans LocalSettings.php.

[[email protected] mediawiki]# cd extensions/SemanticMediaWiki/maintenance

[[email protected] maintenance]#

On vérifie.

[[email protected] maintenance]# pwd

/var/lib/nethserver/vhost/mediawiki/extensions/SemanticMediaWiki/maintenance
[[email protected] maintenance]#
Installation et mise à niveau de la base de données

Veiller noter que cette commande nécessite d'avoir la permission de modifier/créer des tables de base de données.

[[email protected] maintenance]# php setupStore.php

Selected storage engine: "SMWSQLStore3" (or an extension thereof)

Setting up standard database configuration for SMW ...

Checking table smw_object_ids ...
   Table not found, now creating...
   ... done.
Checking index structures for table smw_object_ids ...
...
Database initialized completed.

Running table optimization (this may take a moment) ...

Checking table smw_object_ids ...
   ... analyze, optimize done.
...
Optimization completed.

Adding property statistics rebuild job ...
   ... done.

Adding entity disposer job ...
   ... done.

Setting upgrade key ...
   ... done.

Import of default.json ...
   ... creating MediaWiki:Smw import skos contents ...
   ... creating MediaWiki:Smw import foaf contents ...
   ... creating MediaWiki:Smw import owl contents ...
   ... creating Attribut:Foaf:knows contents ...
   ... creating Attribut:Foaf:name contents ...
   ... creating Attribut:Foaf:homepage contents ...
   ... creating Attribut:Owl:differentFrom contents ...
   ... done.

Import processing completed.
[[email protected] maintenance]#

Ajustement des droits, propriétaire et groupe

On renforce la sécurité de l’accès aux fichiers f en supprimant les droits à “other”.

[[email protected] maintenance]# find  /var/lib/nethserver/vhost/mediawiki/ -type f -exec chmod 640 {} \;

[[email protected] maintenance]#

On répète l'opération pour les répertoires d.

[[email protected] maintenance]# find /var/lib/nethserver/vhost/mediawiki/ -type d -exec chmod 2750 {} \;

[[email protected] maintenance]#

On ajuste Récursivement le propriétaire:groupe.

[[email protected] maintenance]# chown -R apache:apache /var/lib/nethserver/vhost/mediawiki/

[[email protected] maintenance]#

Fichiers cachés.

[[email protected] maintenance]# chown -R apache:apache /var/lib/nethserver/vhost/mediawiki/.*

[[email protected] maintenance]#

Fonctions administrateur et base de données

Deux étapes sont nécessaires:

  • Installation et mise à niveau de la base de données.
  • Réparation et mise à niveau des données.

Installation et mise à niveau de la base de données

Cette étape a été complétée à la section précédente setupStore.php par le lancement de la commande php setupStore.php.

On peut relancer la mise à niveau de la base de données sans causer de dégâts.

On recherche la page Special:SemanticMediaWiki.


On clique le lien Spécial:SemanticMediaWiki.


À l'onglet Maintenance, on clique Initialiser ou mettre à niveau les tables.


Tout s'est bien passé.


Réparation et mise à niveau des données

On recherche la page Special:SemanticMediaWiki.


On clique le lien Spécial:SemanticMediaWiki.


À l'onglet Maintenance, on clique Commencer la mise à jour des données.

Cette requête prend un certain temps (plus de 20-30 minutes ou beaucoup plus).

On peut accélérer la mise à jour des données - voir plus bas…

SMW peut être utilisé avant la fin de cette étape, mais on n'aura pas encore accès à toutes les données (par exemple les pages catégorie).


Après quelques minutes, on rafraîchit la page pour voir la progression.

Accélération de la mise à jour des données

On peut accéler la mise à jour des données en lançant la commande ci-dessous.

[[email protected] maintenance]#  php /var/lib/nethserver/vhost/mediawiki/maintenance/runJobs.php --maxjobs 10000

Au retour de l'invite, on rafraîchit la page MediaWiki Sémantique ci-dessus.

Une fois l'opération terminée, l'écran ci-contre apparaît.

Allow php access to remote files

L'installation de Semantic MediaWiki est installé. Il nous faut enlever l'accès PHP aux fichiers distants, car c'est une faille de sécurité.

Configuration → Paramètres PHP → onglet Php V7.2 SCL.

On décoche Allow php access to remote files → SOUMETTRE.

Vérification de l'installation

Si on n'est pas certain du bon déroulement des opérations, on peut vérifier avec:
Accueil → Pages spéciales → Données et outils → Version → cadre Extensions installées.

Création d'une page classique

Nous allons créer une page classique que nous appellerons TestSMW.

☑ On recherche cette page. Comme elle n'existe pas, Mediawiki nous offre de la créer → TestSMW.

☑ On entre le texte ci-dessous pour vérifier que Semantic Mediawiki affichera la propriété Dummypage lorsqu'on cherchera les propriétés de cette page:

Property test: [[testproperty::Dummypage]]

☑ On donne une description sous Résumé et on clique Prévisualiser.


☑ Si on est satisfait de la page, on clique Enregistrer.


☑ Notre page apparaît et Semantic MediaWiki af­fiche les propriétés de la page.


☑ Après avoir enregistré la page, on peut aussi cliquer sur le lien Chercher les pro­pri­é­tés dans la barre d'ou­tils à gauche.
Cette vue af­fi­che Testproperty avec la valeur Dummypage.

Semantic Mediawiki (SMW) fonctionne correctement.


CharInsert

Introduction

CharInsert est une extension qui crée des liens JavaScript qui, lorsque cliqués, insèrent du texte prédéfini dans la boîte d'édition. Ces liens sont surtout utilisés par MediaWiki:Edittools.

Ci-contre, les boutons que nous voulons ultimement obtenir pour faciliter la création de pages.

Téléchargement

Adresse de téléchargement:
https://www.mediawiki.org/wiki/Special:ExtensionDistributor/CharInsert.
https://www.mediawiki.org/wiki/Extension:CharInsert

On télécharge le fichier de l'extension dans un répertoire sur le poste de travail.


On téléverse le fichier tar.gz sur le serveur, dans le répertoire des extensions:

/var/lib/nethserver/vhost/mediawiki/extensions.


Si ce n'est déjà fait, on ouvre une session PuTTY vers le serveur et on se rend dans le répertoire des extensions.

[[email protected] maintenance]# cd /var/lib/nethserver/vhost/mediawiki/extensions/

[[email protected] extensions]#

On vérifie.

[[email protected] extensions]# pwd

/var/lib/nethserver/vhost/mediawiki/extensions
[[email protected] extensions]#

On vérifie que l'extension ait bien été téléversée dans ce répertoire.

[[email protected] extensions]# ls -asl CharInsert-REL1_31*

24 -rw-r--r-- 1 root apache 22356  4 juin  00:39 CharInsert-REL1_31-b5f34be.tar.gz
[[email protected] extensions]#

Extraction du fichier tar.gz

On extraie.

[[email protected] extensions]# tar -zxvf CharInsert-REL1_31-b5f34be.tar.gz

CharInsert/
CharInsert/modules/
CharInsert/modules/ext.charinsert.css
...
CharInsert/CODE_OF_CONDUCT.md
CharInsert/.jshintrc
CharInsert/CharInsert.php
[[email protected] extensions]#

On vérifie.

[[email protected] extensions]# ls -lsd CharInsert/

4 drwxr-xr-x 6 sssd polkitd 4096 17 avril  2018 CharInsert/
[[email protected] extensions]#

On supprime le fichier tar.gz.

[[email protected] extensions]# rm CharInsert-REL1_31-b5f34be.tar.gz

rm : supprimer fichier « CharInsert-REL1_31-b5f34be.tar.gz » ? o
[[email protected] extensions]#

Ajustement des droits, propriétaire et groupe

On renforce la sécurité de l’accès aux fichiers f en supprimant les droits à “other”.

[[email protected] extensions]# find CharInsert/ -type f -exec chmod 640 {} \;

[[email protected] extensions]#

On répète l'opération pour les répertoires d.

[[email protected] extensions]# find CharInsert/ -type d -exec chmod 2750 {} \;

[[email protected] extensions]#

On ajuste Récursivement le propriétaire:groupe.

[[email protected] extensions]# chown -R apache:apache CharInsert/

[[email protected] extensions]#

Les fichiers cachés.

[[email protected] extensions]# chown -R apache:apache CharInsert/.*

[[email protected] extensions]#

On vérifie,

[[email protected] extensions]# ls -alsd CharInsert

4 drwxr-s--- 6 apache apache 4096 17 avril  2018 CharInsert
[[email protected] extensions]#

LocalSettings.php

Il faut maintenant modifier le fichier LocalSettings.php pour indiquer à MediaWiki qu'une nouvelle extension est disponible.

On se rend dans le répertoire racine du wiki.

[[email protected] extensions]# cd /var/lib/nethserver/vhost/mediawiki

[[email protected] mediawiki]#

On fait une sauvegarde du fichier qu'on s'apprête à modifier.

[[email protected] mediawiki]# cp LocalSettings.php  LocalSettings.php_avant_CharInsert

[[email protected] mediawiki]#

On vérifie.

[[email protected] mediawiki]# ls -ls LocalSettings.php_avant_CharInsert

8 -rw-r----- 1 root apache 7426  4 juin  00:52 LocalSettings.php_avant_CharInsert
[[email protected] mediawiki]#

Prendre tout le contenu de l'encadré pour la commande.

cat >> /var/lib/nethserver/vhost/mediawiki/LocalSettings.php <<'EOT'

#####  ***********************
# EXTENSION:CHARINSERT
# CharInsert is an extension that creates JavaScript links that when clicked, insert
# predefined text into the text box.
require_once( "$IP/extensions/CharInsert/CharInsert.php" );

EOT

On vérifie.

[[email protected] mediawiki]# tail -7 LocalSettings.php

#####  ***********************
# EXTENSION:CHARINSERT
# CharInsert is an extension that creates JavaScript links that when clicked, insert
# predefined text into the text box.
require_once( "$IP/extensions/CharInsert/CharInsert.php" );

[[email protected] mediawiki]#

Vérification sur le site

Acceuil → Pages spéciales → Données et outils → Version → Extensions installées → Greffons de l'analyseur syntaxique.


En bas de la page, sous Balises étendues de l'analyseur syntaxique, on voit aussi <charinsert>.

Édition des pages nécessaires à CharInsert

Il nous faut maintenant éditer toutes les pages nécessaires à la définition de notre greffon.

Page MediaWiki:Edittools

Sur la même page, nous cliquons insertion de caractères absents des claviers usuels.


La page s'affiche; c'est l'installation de l'extension CharInsert qui l'a créée. Elle est vide.

Modifier pour éditer cette page.


On est prêt à entrer le texte de cette page…

Nous allons copier le contenu de la page originale du site de mediawiki.org et le coller sur notre page.

On ouvre un nouvel onglet dans le navigateur, on se rend au site http://www.mediawiki.org et on lance la recherche de la page Mediawiki:Edittools.

On clique View source.

On sélectionne tout le texte [Ctl + A], on le copie [CTL + C]

  • … et on le colle [CTL + V], dans la page MediaWiki:Edittools de notre site.
  • On entre un commentaire:
Copié de: https://www.mediawiki.org/w/index.php?title=MediaWiki:Edittools&action=edit

On clique Enregistrer.


Ce qui nous donne la page ci-contre.


N'ayez crainte, plus loin lorsque nous aurons terminé, la page apparaîtra telle que ci-contre.

Page MediaWiki:Gadgets-definition

La liste des gadgets disponibles est définie par la page MediaWiki:Gadgets-definition. C'est l'installation de l'extension CharInsert qui a aussi créé cette page.

Nous allons éditer notre page MediaWiki:Gadgets-definition qui ne contiendra qu'une seule ligne et qui définira le gadget Edittools.

Exemple de cette future page. (Voir plus loin pour le texte à copier/coller.)

Syntaxe

Format de la ligne de cette page.

* nom_du_gadget [options (peut être omis)] | nom-page1-utilisée | nom-page2-utilisée...

Une ligne de définition commence par un ou plusieurs * (le caractère astérisque).

Premier champ:
(Nom du gadget)
Le premier champ “nom_du_gadget” est le nom interne du gadget.
Forme générale: nom_du_gadget.
Exemple: Edittools.

Deuxième champ:
(Options)
Forme générale: [option-1 | option-2 | … option-N].
Exemple: [ResourceLoader|Default].

NomParamètresDescriptionDepuis
ResourceLoaderAucunMarque les scripts du gadget comme étant compatible avec ResourceLoader.?
dependenciesNoms des modules ResourceLoader séparés par une virguleVoir la liste des modules disponibles par défaut. Notez que cette option n'a pas d'effet si le gadget en question n'a pas de ressource compatible ResourceLoader (i.e. pas de style ni de script marqué comme compatible).?
rightsNoms des privilèges séparés par une virguleRend le gadget visible dans les préférences uniquement aux utilisateurs qui ont les privilèges.?
defaultAucunRend le gadget actif par défaut pour tout le monde (même les IPs!). Les utilisateurs enregistrés peuvent toujours le désactiver dans leurs préférences.1.18

Troisième champ:
(Pages JavaScript ou CSS)
Le troisième champ fait référence aux pages de codes JavaScript ou CSS qui construisent le gadget. Les noms de ces pages doivent respectivement se terminer par .js ou .css. Un gadget peut utiliser n'importe quelle quantité de pages de code. Du code commun peut être inséré dans une page de code utilisée par plusieurs gadgets.
Forme générale: nom-page1-utilisée | nom-page2-utilisée…
Exemple: Edittools.js.

Voici un extrait de la page MediaWiki:Gadgets-definition du site https://www.mediawiki.org/; vous pouvez la consulter en cherchant MediaWiki:Gadgets-definition puis cliquez View source.

...
* DotsSyntaxHighlighter[ResourceLoader]|DotsSyntaxHighlighter.js
* Edittools[ResourceLoader|default]|Edittools.js
* HotCat[ResourceLoader]|HotCat.js
...
Édition de la page MediaWiki:Gadgets-definition

Sur notre site, on cherche la page: MediaWiki:Gadgets-definition. C'est l'installation de l'extension CharInsert qui l'a aussi créée.

Cliquer Modifier.

On entre le texte et la description ci-dessous, puis on enregistre.

* Edittools[ResourceLoader|default]|Edittools.js
Le premier greffon

Enregistrer.


Voilà, la page a été modifiée.


Vérification sur le site

Préférences → Gadgets.

Le gadget est bien là et il est coché, car on a spécifié l'option default sur la ligne qu'on a insérée pour la page MediaWiki:Gadgets-definition. Cette option rend le gadget actif par défaut, pour tout le monde.

L'onglet Gadgets n'apparaîtra dans la page Spécial:Préférences qu'après avoir édité la page MediaWiki:Gadgets-definition et il faut que cette dernière contienne au moins une ligne pour définir un gadget valide.
Sur la page Spécial:Préférence, un utilisateur pourra sélectionner les gadgets qu'il désire utiliser.

Page MediaWiki:Gadget-Edittools

Le premier champ, “nom_du_gadget”, d'une ligne de la page MediaWiki:Gadgets-definition est le nom interne du gadget. Ce champ réfère à une page qui explique en quelques mots ce que fait ce gadget.

Le nom de cette page prend la forme suivante: MediaWiki:Gadget-nom_du_gadget.

L'espace de noms MediaWiki: est implicite et il n'est pas écrit dans le premier champ de la ligne, mais il faut l'utiliser pour éditer la page.
Le nom interne du gadget doit commencer par une lettre ([A-Za-z]) suivi par n'importe quelle suite de lettres, chiffres ([0-9]), traits d’union (“-”), tirets bas (“_”), deux-points (“:”) et points (“.”).

Pour notre gadget, le nom de la page sera: MediaWiki:Gadget-Edittools. On utilise la syntaxe MediaWiki pour la description du gadget.

Sur notre site, on cherche la page: MediaWiki:Gadget-Edittools.


La page n'existe pas; on clique Créer.

On entre la ligne suivante.

'''''EditTools''''' est un gadget qui enrichit l'édition de texte en regroupant les sections sous un menu déroulant et en convertissant les balises de la syntaxe en boutons cliquables.


On donne une description.

Le premier greffon

→ Enregistrer


Vérification sur le site

On se rend à la page Préférences → Gadgets.

Le gadget est toujours là et maintenant, la nouvelle description s'affiche.


Page MediaWiki:Gadget-Edittools.js

Sur notre site, on cherche la page: MediaWiki:Gadget-Edittools.js → Créer.

Comme précédemment, nous allons copier la page originale du site http://www.mediawiki.org et la coller dans notre nouvelle page MediaWiki:Gadget-Edittools.js.

On se rend sur le site http://www.mediawiki.org

On cherche MediaWiki:Gadget-Edittools.js → View source.
On sélectionne tout le texte [Ctl + A] et on le copie [Ctl + C].


On revient sur notre site, on colle le texte [Ctl + V] sur notre page MediaWiki:Gadget-Edittools.js, on entre une description.

Pour le greffon Edittools

Puis, on clique Enregistrer.

Vérification finale

Sur notre site, à la page d'Acceuil, on clique Modifier.

Les boutons cliquables des balises sont là et ils sont bien définis.

Si les boutons n'apparaissent pas, on rafraîchit la page du navigateur.

Le menu déroulant Standard est là, lui aussi.

Avec les extensions CharInsert et WikiEditor, nous avons maintenant plus de choix pour le formatage de nos pages.

Instantané VirtualBox

À ce stade-ci, on peut prendre un instantané de la machine virtuelle afin de pouvoir y revenir en cas d'une future erreur de manipulation.

Masquer une révision (RevisionDelete)

Introduction

Référence: https://www.mediawiki.org/wiki/Help:RevisionDelete
Référence: https://www.mediawiki.org/wiki/Manual:RevisionDelete
Référence: https://www.mediawiki.org/wiki/Manual:RevisionDelete/fr

Cacher une version de l'historique d'une page est possible grâce à la fonctionnalité de RevisionDelete, ajoutée au code de base de MediaWiki au milieu de l'année 2009. Cette fonctionnalité est disponible aux administrateurs et, peut être donnée aux usagers d'un groupe auquel a été attribué la permission deleterevision. Cette permission n'est offerte à aucun usager dans la configuration par défaut de MediaWiki.

Cette fonctionnalité a la faculté de masquer/afficher: la révision elle-même, le nom de l'usager qui a fait l'édition de la page, l'édition du résumé ou toute combinaison de ces trois paramètres.

Lorsque masqué, le contenu de la révision ne peut être vu par aucun usager si celui-ci ne possède pas le droit deleterevision. Essayer de comparer cette révision avec une autre ou tenter d'y accéder avec &oldid=page donnera une erreur disant que la révision a été enlevée des archives publiques. Il en sera de même pour la recherche par l'individu impliqué, d'une entrée masquée dans le journal et ne retournera aucun résultat.

Le masquage d'une révision demeure appliqué à une page, même si cette dernière a été supprimée.

Si la page est restaurée après une suppression, les révisions qui ont été masquées auparavant avec RevisionDelete, resteront masquées.

La révision courante ne peut être supprimée. Il faut en faire une nouvelle révision, puis supprimer la précédente page courante.

Propriétés de RevisionDelete

Voici les changements qu'on peut apporter à la visibilité d'une révision de page; on peut masquer:

  • le texte de la révision,
  • l'édition du résumé,
  • le nom/adresse IP de l'usager.

Les révisions masquées vont quand même apparaître dans l'historique de la page mais, les parties masquées et leurs contenus vont être inaccessibles au public. Un groupe d'usagers peut être créé et lui accorder le pouvoir de rendre ces parties inaccessibles même aux administrateurs.

Pour la partie technique de ces fonctionnalités, voir: https://www.mediawiki.org/wiki/Bitfields_for_rev_deleted.

Activation

Les exemples de cette section sont ceux de la version 0.2.0 / 2018-07-11 de ce document.

Pour l'activation de RevisionDelete, on doit insérer quelque(s) paramètre(s) dans le fichier LocalSettings.php.

Masquer une révision par un usager

L'octroi de ce privilège aux usagers n'est pas recommandé.

$wgGroupPermissions['user']['deleterevision'] = true;
Masquer une révision aux usagers
$wgGroupPermissions['sysop']['deleterevision'] = true;

LocalSettings.php

Si ce n'est déjà fait, on se rend dans le répertoire racine de notre MediaWiki.

[[email protected] ~]# cd /var/lib/nethserver/vhost/mediawiki

[[email protected] mediawiki]#

On fait une sauvegarde du fichier qu'on s'apprête à modifier.

[[email protected] mediawiki]# cp LocalSettings.php LocalSettings.php_avant_deleterevision

[[email protected] mediawiki]#

On vérifie.

[[email protected] mediawiki]# ls -ls LocalSettings.php_avant_deleterevision

8 -rw-r----- 1 root apache 7664  4 juin  14:06 LocalSettings.php_avant_deleterevision
[[email protected] mediawiki]#

Ce paramètre va donner le droit RevisionDelete à tous les administrateurs (sysop).
Prendre tout le contenu de l'encadré pour la commande.

cat >> /home/e-smith/files/ibays/wiki/html/LocalSettings.php <<'EOT'

#####  ***********************
# RevisionDelete
#
# Ce paramètre va donner le droit RevisionDelete à tous les administrateurs. Si on ajoute
# cette ligne dans LocalSettings.php, tout administrateur qui est logué va voir une case à
# cocher sur chaque ligne des révisions de même qu'un bouton au-dessus et en dessous des
# révisions qui affichera "Masquer/afficher les versions sélectionnées".
# Les versions et événements supprimés seront encore présents dans l'historique de la page
# et dans les journaux, mais leur contenu textuel sera inaccessible au public. Les autres
# administrateurs du Wiki de Micronator pourront toujours accéder au contenu caché et le
# restaurer à travers cette même interface, à moins que des restrictions supplémentaires ne
# soient mises en place. Contrairement à ce qu'indique le nom de cette page, les nformations
# ne sont pas effacées mais simplement cachées à la vue des usagers.
$wgGroupPermissions['sysop']['deleterevision'] = true;

EOT

On vérifie.

[[email protected] mediawiki]# tail -16 LocalSettings.php

#####  ***********************
# RevisionDelete
#
# Ce paramètre va donner le droit RevisionDelete à tous les administrateurs. Si on ajoute
# cette ligne dans LocalSettings.php, tout administrateur qui est logué va voir une case à
# cocher sur chaque ligne des révisions de même qu'un bouton au-dessus et en dessous des
# révisions qui affichera "Masquer/afficher les versions sélectionnées".
# Les versions et événements supprimés seront encore présents dans l'historique de la page
# et dans les journaux, mais leur contenu textuel sera inaccessible au public. Les autres
# administrateurs du Wiki de Micronator pourront toujours accéder au contenu caché et le
# restaurer à travers cette même interface, à moins que des restrictions supplémentaires ne
# soient mises en place. Contrairement à ce qu'indique le nom de cette page, les nformations
# ne sont pas effacées mais simplement cachées à la vue des usagers.
$wgGroupPermissions['sysop']['deleterevision'] = true;

[[email protected] mediawiki]#

Masquer une révision de la page "Test"

Après avoir ajouté ces lignes dans LocalSettings.php, tout administrateur qui est logué va voir une case à cocher sur chaque ligne des révisions de même qu'un bouton au-dessus et en dessous des révisions qui affichera “Masquer/afficher les versions sélectionnées”.

On crée la page Test et on la modifie à quelques reprises puis, on la recherche.


On clique Afficher l'historique.


On peut sélectionner une version et la masquer en cliquant Afficher/masquer les versions sélectionnées.


On sélectionne une version et on clique Afficher/masquer les versions sélectionnées.


Cocher les restrictions de visibilité qu'on veut masquer, donner une raison et Appliquer à la révision sélectionnée.


On confirme en cliquant Appliquer à la révision sélectionné.

Contrairement à ce qui est indiqué sur cette page, les informations ne sont pas supprimées mais, simplement cachées à la vue des usagers.
Les versions et les événements supprimés seront encore présents dans l'historique de la page et dans les journaux mais, leurs contenus textuels seront inaccessibles au public. Les administrateurs du Wiki de Micronator pourront toujours accéder au contenu caché et le restaurer à travers cette même interface, à moins que des restrictions supplémentaires ne soient mises en place.

Losqu'une révision est masquée dans son intégralité, celle-ci est affichée, comme ci-dessous, avec une ligne barrée et grisée pour tous ses éléments.

Entrée dans le journal

Acceuil → Pages spéciales → cadre Outils pour les pages → Voir les pages supprimées → journal des suppressions.


Le journal affiche qu'on a modifié la visibilité d'une révision sur la page Test:
- contenu masqué
- résumé de modification masqué
- nom d'utilisateur masqué.

Il donne aussi la raison donnée pour le masquage:
- (Pour un test).

Masquer plusieurs révisions

Si on sélectionne plus d'une révisions…

… une page un peu plus complexe s'affiche.

Droits des groupes d'utilisateurs

Acceuil → Pages spéciales→ Utilisateurs et droits rattachés → Droits des groupes d'utilisateurs → Administrateurs.

Une nouvelle ligne a été ajoutée.

Instantané VirtualBox

À ce stade-ci, on peut prendre un instantané de la machine virtuelle afin de pouvoir y revenir en cas d'une future erreur de manipulation.

Ajouts au menu principal

Introduction

On veut ajouter une nouvelle ligne au menu principal.

  • Nom de la nouvelle page: AideDeRF232
  • Titre de la nouvelle ligne du menu: Aide pour RF-232

Ici, nous utilisons une orthographe différente pour faire une distinction arbitraire entre le Nom et le Titre pour accentuer leur différence lors de l'ajout du lien de cette page au menu principal. Voir Ajout d'une nouvelle ligne au menu.

Création de la page

Les exemples de ce chapitre sont ceux de la version 0.2.0 / 2018-07-11 de ce document.

On crée une nouvelle page contenant des liens d'aide qu'on nomme: AideDeRF232 et on y ajoute des liens vers des pages d'aide.

Rechercher AideDeRF232.

Cliquer AideDeRF232 pour créer la page.

Faire une liste à puces * de liens d'aide.
Si on ne fait pas une liste à puces, l'interligne devient trop grand. (On peut aussi utiliser <nowiki> qui est moins esthétique.)

Prendre tout le contenu de l'encadré et le coller dans la nouvelle page → Enregistrer.

* [http://www.mediawiki.org/wiki/Sysadmin_hub/fr Inst MAJ config]
* [http://meta.wikimedia.org/wiki/Help:Editor/fr Manuel de l'éditeur]
* [http://www.mediawiki.org/wiki/Manual:LocalSettings.php/fr LocalSettings.php]
* [http://meta.wikimedia.org/wiki/Help:Wikitext_examples/fr Syntaxe wiki]
* [http://meta.wikimedia.org/wiki/Help:Table/fr Les tableaux]
* [http://meta.wikimedia.org/wiki/Help:Link/fr Les liens]
* [http://www.mediawiki.org/wiki/Manual:Security Security]
* [http://dev.mysql.com/doc/refman/5.5/en/grant.html GRANT Syntax]
* [http://www.mediawiki.org/wiki/Manual:Configuring_file_uploads Téléchargements]
* [http://www.mediawiki.org/wiki/Manual:LocalSettings.php#Security Upload location]
* [http://www.mediawiki.org/wiki/Extension:Configure Extension:Configure]
* [http://www.mediawiki.org/wiki/Help:Assigning_permissions permissions]
* [http://www.mediawiki.org/wiki/Help:User_rights User rights]
* [https://commons.wikimedia.org/wiki/File%3ACheatsheet-en.svg CheatSheet]
* [https://www.mediawiki.org/wiki/Extension:Interwiki#Download Extension:Interwiki]

Ce qui donnera la page ci-contre.
On clique quelques liens pour vérifier qu'ils fonctionnent correctement.

Ajout d'une nouvelle ligne au menu

Pour éditer le menu, il faut recher­cher la page en incluant son espace de noms: MediaWiki:Sidebar.

La page MediaWiki:Sidebar apparaît; pour l'éditer, on clique Modifier.
Dans le format: Nom-de-la-page|Titre du menu, on ajoute la nouvelle ligne ** AideDeRF232|Aide pour RF-232. (Ne pas oublier “ |”.)






* navigation
** mainpage|mainpage-description
** recentchanges-url|recentchanges
** randompage-url|randompage
** helppage|help-mediawiki
** AideDeRF232|Aide pour RF-232
* SEARCH
* TOOLBOX
* LANGUAGES

Prévisualiser → Enregistrer.

La nouvelle ligne est ajoutée au menu principal.

Aide pour RF-232, la page des liens d'aide apparaît.


Ajout d'un nouveau bloc au menu

Au lieu d'ajouter une ligne, on aurait pu ajouter un nouveau bloc * NethServer au menu principal. On recherche la page MediaWiki:Sidebar et on la modifie tel que ci-dessous.

* navigation
** mainpage|mainpage-description
** recentchanges-url|recentchanges
** randompage-url|randompage
** helppage|help-mediawiki
* NethServer
** AideDeRF232|Aide pour RF-232
* SEARCH
* TOOLBOX
* LANGUAGES


Ouverture dans une nouvelle fenêtre: "_blank"

Référence: http://www.mediawiki.org/wiki/Manual:Opening_external_links_in_a_new_window

  • Assigner une nouvelle cible par défaut aux liens externes (faire ouvrir les liens dans une nouvelle fenêtre).
  • Ajouter l'entrée suivante au fichier LocalSettings.php.

Prendre tout le contenu de l'encadré pour la commande.

cat >> /var/lib/nethserver/vhost/mediawiki/LocalSettings.php <<'EOT'

#####  ***********************
# Pour faire ouvrir les liens dans une nouvelle fenêtre.
#
$wgExternalLinkTarget = '_blank';

EOT

Si la valeur est mise à false alors, aucun attribut n'est utilisé avec les liens externes. (Ce comportement devient le même que celui de _self.)

Ne s'applique pas au Menu Principal.

Lorsque la valeur est changée, les affichages doivent être rafraîchis pour rendre l'assignation effective.

Consulter aussi les liens: Manual:Hooks/LinkerMakeExternalLink et Manual:$wgNoFollowLinks.

Instantané VirtualBox

À ce stade-ci, on peut prendre un instantané de la machine virtuelle afin de pouvoir y revenir en cas d'une future erreur de manipulation.

Mise à jour de Mediawiki

Restez à jour

Ici, mise à jour ne signifie pas de passer à une version supérieure de MediaWiki, mais seulement une mise à jour des fichiers de la branche actuelle.

Mise à jour

On se rend dans le répertoire racine de notre MediaWiki.

[[email protected] ~]# cd /var/lib/nethserver/vhost/mediawiki/

[[email protected] mediawiki]#

On vérifie.

[[email protected] mediawiki]# pwd

/var/lib/nethserver/vhost/mediawiki
[[email protected] mediawiki]#

On met à jour. Toutes les dernières modifications concernant la branche que nous utilisons seront appliquées.

[[email protected] mediawiki]# git pull

remote: Counting objects: 5, done
remote: Finding sources: 100% (3/3)
remote: Total 3 (delta 2), reused 3 (delta 2)
Unpacking objects: 100% (3/3), done.
From https://gerrit.wikimedia.org/r/p/mediawiki/core
   63a9098..c698e1b  REL1_31    -> origin/REL1_31
Updating 63a9098..c698e1b
Fast-forward
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
[[email protected] mediawiki]#

On met à jour les sous-modules.

[[email protected] mediawiki]# git submodule update --init

[[email protected] mediawiki]#

Rien n'est retourné, il n'existe aucune mise à jour pour les sous-modules.

Ajustement des droits, propriétaire et groupe

Ci-dessus, il y a eu 1 insertion(+). On n'est jamais trop prudent… On renforce la sécurité de l’accès aux fichiers f en supprimant les droits à “other”.

[[email protected] mediawiki]# find . -type f -exec chmod 640 {} \;

[[email protected] mediawiki]#

On répète l'opération pour les répertoires d.

[[email protected] mediawiki]# find . -type d -exec chmod 2750 {} \;

[[email protected] mediawiki]#

On ajuste Récursivement le propriétaire:groupe.

[[email protected] mediawiki]# chown -R apache:apache *

[[email protected] mediawiki]#

Fichiers cachés.

[[email protected] mediawiki]# chown -R apache:apache .*

[[email protected] mediawiki]#

On vérifie.

[[email protected] mediawiki]# ls -als

total 3404
   4 drwxr-s--- 16 apache apache    4096  4 juin  16:14 .
   0 drwxr-xr-x  3 root   root        23 25 mai   18:12 ..
   8 -rw-r-S---  1 apache apache    4697  3 juin  15:20 api.php
...
   4 -rw-r-S---  1 apache apache     207  3 juin  15:20 .eslintrc.json
...
   8 -rw-r-S---  1 apache apache    7791  4 juin  16:09 LocalSettings.php
...
   4 drwxr-s--- 40 apache apache    4096  4 juin  12:29 vendor
[[email protected] mediawiki]#

Instantané VirtualBox

À ce stade-ci, on peut prendre un instantané de la machine virtuelle afin de pouvoir y revenir en cas d'une future erreur de manipulation.

Mise à jour des Collections

Présentement, nous avons deux Collections d'installées: PHP et MariaDB 10.2. Elles peuvent être mises à jour à la console du serveur.

Mises à jour

On lance les mises à jour des deux Collections.

[[email protected] ~]# yum update -y nethserver-php-scl nethserver-rh-mariadb102

Modules complémentaires chargés : changelog, fastestmirror, nethserver_events
...
 * ce-base: mirror.atlanticmetro.net
...
Résolution des dépendances
--> Lancement de la transaction de test
---> Le paquet nethserver-php-scl.x86_64 0:1.2.4-1.ns7.sdl sera mis à jour
...
Dépendances résolues
...
Résumé de la transaction
============================================================================================
Installation            ( 3 Paquets en dépendance)
Mettre à jour  1 Paquet

Taille totale des téléchargements : 754 k
...
  Installation : php72-php-opcache-7.2.19-2.el7.remi.x86_64                             1/5
...
  Vérification : nethserver-php-scl-1.2.4-1.ns7.sdl.x86_64                              5/5

Dépendances installées :
  php71-php-opcache.x86_64 0:7.1.30-1.el7.remi php72-php-opcache.x86_64 0:7.2.19-2.el7.remi
  php73-php-opcache.x86_64 0:7.3.6-1.el7.remi

Mis à jour :
  nethserver-php-scl.x86_64 0:1.2.5-1.ns7.sdl

Terminé !
[[email protected] ~]#

Les mises à jour disponibles ont été installées.
Dans la commande ci-dessus, on peut omettre l'option -y et yum demandera si on veut mette a jour. Il suffit de répondre y ou n pour oui ou non.

Instantané VirtualBox

À ce stade-ci, on peut prendre un instantané de la machine virtuelle afin de pouvoir y revenir en cas d'une future erreur de manipulation.

Mises à jour de NethServer

Serveur NethServer

De temps à autre, il faut mettre à jour le Serveur NethServer pour diverses raisons: suite à des mises à jour des logiciels qui composent NethServer, failles de sécurité découvertes par des utilisateurs ou des développeurs, etc.

- Administration → Gestionnaire des logiciels → onglet Mises à jour.
- TÉLÉCHARGER ET INSTALLER.



À la fin de la mise à jour, Recharger la page.

Instantané VirtualBox

À ce stade-ci, on peut prendre un instantané de la machine virtuelle afin de pouvoir y revenir en cas d'une future erreur de manipulation.

Appendices

Écran conventionnel de démarrage

Si nous voulons voir l'écran conventionnel de démarrage tel que ci-contre, il suffit de supprimer un seul paramètre dans le fichier de configuration de grub:

/etc/default/grub

Suppression du paramètre rhgb

Ligne originale dans le fichier /etc/default/grub.

GRUB_CMDLINE_LINUX="crashkernel=auto rd.lvm.lv=VolGroup/lv_root rd.lvm.lv=VolGroup/lv_swap nodmraid rhgb quiet"

Après avoir enlevé le paramètre rhgb.

GRUB_CMDLINE_LINUX="crashkernel=auto rd.lvm.lv=VolGroup/lv_root rd.lvm.lv=VolGroup/lv_swap nodmraid quiet"

On signale le changement en régénérant le fichier de configuration.

[[email protected] ~]# grub2-mkconfig -o /boot/grub2/grub.cfg

Generating grub configuration file ...
Found linux image: /boot/vmlinuz-3.10.0-957.5.1.el7.x86_64
Found initrd image: /boot/initramfs-3.10.0-957.5.1.el7.x86_64.img
Found linux image: /boot/vmlinuz-3.10.0-957.el7.x86_64
Found initrd image: /boot/initramfs-3.10.0-957.el7.x86_64.img
Found linux image: /boot/vmlinuz-0-rescue-8ee070fd1a7a4e8daf17a7dae9f85ac1
Found initrd image: /boot/initramfs-0-rescue-8ee070fd1a7a4e8daf17a7dae9f85ac1.img
done
[[email protected] ~]#

Au prochain réamorçage, le nouveau fichier grub sera effectif.

Table de mappe de clavier

On affiche les différentes mappes de clavier4) “ca” disponibles.

[[email protected] ~]# localectl list-keymaps | grep ca

ca
ca-eng
ca-fr-dvorak
ca-fr-legacy
ca-multi
ca-multix
dvorak-ca-fr
es-cat
ph-capewell-dvorak
ph-capewell-qwerf2k6
[[email protected] ~]#

On active le clavier ca-multi.

[[email protected] ~]# localectl set-keymap ca-multi

[[email protected] ~]#

On vérifie.

[[email protected] ~]# localectl

   System Locale: LANG=fr_FR.UTF-8
       VC Keymap: ca-multi
      X11 Layout: us
[[email protected] ~]#


Fermeture automatique de session (session timeout)

Référence: http://docs.nethserver.org/en/v7/access.html#session-timeouts.
Par défaut (à partir de NethServer 7.5.1804), une session de gestion du serveur se termine après 60 minutes d'inactivité (délai d'inactivité) et expire 8 heures après la connexion (durée de vie de la session).

La commande ci-dessous définit 2 heures de délai d'inactivité et 16 heures de durée de vie de session maximale. Le temps est exprimé en secondes.

[[email protected] ~]# config setprop httpd-admin MaxSessionIdleTime 7200 MaxSessionLifeTime 57600

[[email protected] ~]#

Désactivation des délais.

[[email protected] ~]# config setprop httpd-admin MaxSessionIdleTime '' MaxSessionLifeTime ''

[[email protected] ~]#

Les nouvelles valeurs de délais affecteront les nouvelles sessions. Ils ne changent aucune session active.

Fuseau horaire

Pour le fuseau horaire, il existe un fichier pour Montréal.

[[email protected] ~]# ls -ls /usr/share/zoneinfo/America/ -> grep Montreal

 4 -rw-r--r--  3 root root 3477  1 avril 08:27 Montreal
[[email protected] ~]#

Changement du fuseau horaire

On affiche le fuseau horaire actuel.

[[email protected] ~]# ls -l /etc/localtime

lrwxrwxrwx 1 root root 37 19 mai   23:48 /etc/localtime -> ../usr/share/zoneinfo/America/Toronto
[[email protected] ~]#

On change le fuseau horaire pour celui de Montréal.

[[email protected] ~]# timedatectl set-timezone America/Montreal

[[email protected] ~]#

On vérifie.

[[email protected] ~]# ls -l /etc/localtime

lrwxrwxrwx 1 root root 38 22 mai   14:02 /etc/localtime -> ../usr/share/zoneinfo/America/Montreal
[[email protected] ~]#

Voilà! Le fuseau horaire Montréal est récupéré…

Certificat Let's Encrypt

Description

Un certificat émis par l'autorité de certification Let's Encrypt vous permettra de chiffrer les connexions de votre serveur avec une clé TLS/SSL reconnue mondialement. Les utilisateurs pourront utiliser https.

Référence: https://fr.wikipedia.org/wiki/Let's_Encrypt.
Let's Encrypt est une autorité de certification (CA) lancée le 3 décembre 2015 (Bêta Version Publique). Cette autorité fournit des certificats gratuits X.509 pour le protocole cryptographique TLS au moyen d'un mécanisme automatisé destiné à se passer du processus complexe actuel impliquant la création manuelle, la validation, la signature, l'installation et le renouvellement des certificats pour la sécurisation des sites Internet.

Examen du certificat

On examine le certificat émis par Let's Encrypt pour notre serveur dorgee.micronator-101.org qui est directement branché à l'Internet.

Si la demande de certificat a fonctionnée sans erreur, essayez de vous connecter à la page de l'interface Web du Serveur NethServer. Le certificat devrait incorporer tous les noms d'hôtes que vous avez inclus et être valide pour les quatre-vingt-dix prochains jours.

On se connecte à l'interface Web: https://www.micronator-101.org:980.

- Le cadenas est vert.
- On se logue.

- On clique le cadenas.
- On clique l'icône “>”.


Plus d'informations.



- Onglet Sécurité.
- Afficher le certificat.

- Onglet Détails.
- Émis pour micronator-101.org
- Émis par Let's Encrypt Authority X3
- On voit la date de début et de fin.




- Validité → Pas après.
- Le certificat est valide pour 90 jours.

- Nom alternatif du sujet du certificat.
- Tous nos CNAME choisis lors de la demande du certificat sont affichés.
- Fermer toutes les fenêtres du certificat.

Vérification par Qualsys SSLLabs

Seulement pour un serveur directement branché à l'Internet.

Une fois que vous avez obtenu votre certificat, testez-le en vous rendant chez Qualsys SSLLabs, https://www.ssllabs.com/ssltest/.
Soumettez le nom FQDN de votre domaine pour vérifier que le certificat fonctionne correctement.


Hostname: micronator-101.org → Submit.

- Overall Rating → A.
- Certificate → 100%.

Répertoire well-known

Référence: https://dev-notes.eu/2017/01/apache-directives-in-config-vs-htaccess/
Référence: http://httpd.apache.org/docs/current/howto/htaccess.html#page-header.
Pour un serveur branché directement à l'Internet, lors d'une demande d'un certificat à Let's Encrypt, ce dernier doit pouvoir accéder au répertoire .well-known et à son sous-répertoire acme-challenge.

On peut faire la demande de certificat à la page de l'interface Web:
Configuration → Certificat du serveur → on déroule le menu et on choisit Requête de certificat Let's Encrypt.

Pour plus de détails, voir le Cahier-05: VDSL, FQDN, Internet et NethServer.

Pour un serveur branché directement à l'Internet, nous devons créer un fichier /etc/httpd/conf.d/z_well-known.conf pour indiquer à Apache de rendre accessibles le répertoire .well-known et son sous-répertoire acme-challenge.

Création du fichier z_well-known.conf

Prendre tout le contenu de l'encadré pour la commande.

cat > /etc/httpd/conf.d/z_well-known.conf <<'EOT'
Alias "/.well-known/acme-challenge/" "/var/www/html/.well-known/acme-challenge/"
<Directory "/var/www/html/.well-known/acme-challenge/">
   Require all granted
   Options -Indexes +FollowSymLinks
   AllowOverride All
</Directory>

EOT

On vérifie.

[[email protected] ~]# ls -als /etc/httpd/conf.d/z_well-known.conf

4 -rw-r--r-- 1 root root 231 10 juin  11:03 /etc/httpd/conf.d/z_well-known.conf
[[email protected] ~]#

On affiche le contenu du fichier.

[[email protected] ~]# cat /etc/httpd/conf.d/z_well-known.conf

Alias "/.well-known/acme-challenge/" "/var/www/html/.well-known/acme-challenge/"
<Directory "/var/www/html/.well-known/acme-challenge/">
   Require all granted
   Options -Indexes +FollowSymLinks
   AllowOverride All
</Directory>

[[email protected] ~]#

Il n'y a pas de ligne vide au dessus de Alias… Ci-dessus, Nous en avons inséré une afin de faciliter la copie de la commande.

Sauvegarde du fichier

On vérifie si le nom du fichier /etc/httpd/conf/z_well-known.conf est déjà présent dans le fichier d'inclusion de la sauvegarde des données: /etc/backup-data.d/custom.include, sinon on l'insère.

Prendre tout le contenu de l'encadré pour la commande.

NouvelleInclusion="/etc/httpd/conf/z_well-known.conf"
if grep -Fxq "$NouvelleInclusion" /etc/backup-data.d/custom.include
then
    # L'entrée a été trouvée dans custom.include
    echo -e "\nLe fichier custom.include contient déjà l'entrée:\n$NouvelleInclusion \n"
else
    # L'entrée n'a pas été trouvée dans custom.include
    echo -e "$NouvelleInclusion" >> /etc/backup-data.d/custom.include
    echo -e "\nL'entrée: $NouvelleInclusion a été ajoutée\n"
fi

On vérifie.

[[email protected] ~]# cat /etc/backup-data.d/custom.include | grep z_well-known.conf

/etc/httpd/conf/z_well-known.conf
[[email protected] ~]#

Ci-dessus, il n'y a pas de ligne vide avant “/etc/httpd/conf/z_well-known.conf”. Nous en avons inséré une afin de faciliter la copie de la commande.

Redémarrage du démon httpd

On redémarre le démon Apache afin qu'il relise ses fichiers de configuration.

[[email protected] ~]# systemctl restart httpd

[[email protected] ~]#


Changement du mot de passe de root

Référence: https://www.rootusers.com/how-to-reset-root-user-password-in-centos-rhel-7/.
Réinitialiser le mot de passe de root est normalement une tâche simple si vous êtes déjà connecté avec les privilèges de root. Toutefois, si vous oubliez le mot de passe et devez le changer, les choses deviennent un peu plus difficiles.
Le processus a changé de la version 6 de CentOS/RHEL (Red Hat Enterprise Linux) à la version 7. Auparavant, vous démarriez en mode mono-utilisateur, puis changiez le mot de passe en tant qu'utilisateur root. À partir de la version 7, les modes équivalents sont: mode de secours et mode d’urgence. Cependant, ces modes d'opération nécessitent le mot de passe de root avant de pouvoir faire quoi que ce soit. Cette section va vous guider dans le nouveau processus pour changer le mot de passe perdu de root. Cette procédure sera exécutée à la console du système Linux, assurez-vous donc que vous y avez accès avant de commencer.

Comme pour toutes les tâches de maintenance du système, assurez-vous de disposer d'une sauvegarde/instantané du système avant de poursuivre.

Si votre système Linux est en cours d'exécution, redémarrez-le. S'il ne roule pas, démarrez-le.

Pour CentOS 7, le menu de démarrage vous laissera 5 secondes pour sélectionner le noyau du système d’exploitation à démarrer. Ces 5 secondes sont importantes, car elles permettent aux administrateurs de sélectionner différents noyaux ou d’éditer les paramètres du noyau existant avant le démarrage.

Dans le menu de démarrage, appuyez sur “e” pour modifier le noyau existant tel qu'indiqué ci-dessous.


Dans les options de grub, recherchez la ligne qui commence par linux16 et allez à la fin. Entrez rd.break à la fin de cette ligne tel qu'indiqué ci-dessous.

rd.break


Appuyez sur [Ctrl] + [x] pour démarrer avec ces options qui vous amèneront à l'invite initramfs avec un shell root.


À ce stade, le système de fichiers racine est monté en mode lecture seule (ro) dans le répertoire /sysroot et doit être remonté avec les autorisations de lecture/écriture (rw) pour que nous puissions réellement apporter certaines modifications. Ceci est réalisé avec la commande mount -o remount,rw /sysroot.

switch_root:/# mount -o  remount,rw  /sysroot

switch_root:/#


Une fois le système de fichiers remonté, changez-le en une prison chroot afin que le répertoire /sysroot soit utilisé comme racine du système de fichiers. Ceci est nécessaire pour que toutes les commandes que nous exécuterons se rapportent à /sysroot. La commande à lancer est chroot /sysroot.

switch_root:/# chroot /sysroot

sh-4.2#


À partir d'ici, le mot de passe de root peut être réinitialisé à l’aide de la commande passwd.

sh-4.2# passwd

Changing password for user root.
New password: Nouveau-mot-de-passe-de-root
Retype new passwd: Nouveau-mot-de-passe-de-root
passwd: all authentification tokens updated successfully.
sh-4.2#


Si vous n'utilisiez pas SELinux, vous pourriez redémarrer à ce stade et tout irait bien. Cependant, par défaut, CentOS/RHEL-7 active SELinux. Nous devons donc corriger le contexte du fichier /etc/shadow. En effet, lorsque la commande passwd est exécutée, elle crée un nouveau fichier /etc/shadow. SELinux n'étant pas en cours d'exécution dans ce mode, le fichier est créé sans aucun contexte SELinux, ce qui peut entraîner des problèmes lors du redémarrage.

On crée le fichier /.autorelabel à l’aide de touch.

sh-4.2# touch  /.autorelabel

sh-4.2#

La création de ce fichier effectuera automatiquement un ré-étiquetage de tous les fichiers au prochain démarrage. Notez que cela peut prendre un certain temps en fonction de la quantité de fichiers que vous avez. Peut prendre environ 2 minutes pour un serveur CentOS-7 ordinaire.

On quitte l'environnement chroot.

sh-4.2# exit

exit
sh-4.2#


On quitte le shell racine initramfs (peut prendre un certain temps, être patient…). Le serveur s'amorce.

sh-4.2# exit

logout
...

Vérification

À la console du serveur, vous devriez pouvoir vous connecter et utiliser le système avec le nouveau mot de passe que vous avez créé.

ERROR Failed to send host log message

Cette erreur s'affiche seulement lors de l'amorçage d'un serveur roulant sous VirtualBox.


- On arrête le Serveur NethServer.
- À l'écran VirtualBox, on sélectionne la machine → État actuel → Configuration.


Au retour, on amorce le Serveur NethServer et le message ne s'affichera plus.


Affichage → onglet Écran → Contrôleur graphique → on change pour VboxVGA → OK.


Martian source

Si dans le fichier journal /var/log/messages, vous voyez plusieurs lignes telles que ci-dessous, c'est que l'IP de la passerelle du réseau vert de la carte enp0s3 ou les Serveurs DNS ne sont corrects.

...IPv4: martian source 192.168.1.1...
...IPv4: martian source 192.168.1.1...
...IPv4: martian source 192.168.1.1...

Passerelle du réseau de la carte enp0s3

On trouve notre passerelle en lançant un traceroute vers google.com

[[email protected] ~]# traceroute google.com

traceroute to google.com (172.217.165.14), 30 hops max, 60 byte packets
 1  lo0-0-lns03-tor.teksavvy.com (206.248.155.139)  10.367 ms  11.449 ms  11.487 ms
 2  ae0-2150-bdr01-tor.teksavvy.com (69.196.136.172)  11.523 ms  11.793 ms  11.826 ms
 3  72.14.212.134 (72.14.212.134)  11.868 ms  12.430 ms  12.306 ms
 4  74.125.244.161 (74.125.244.161)  12.736 ms 74.125.244.145 (74.125.244.145)  14.002 ms 74.125.244.161 (74.125.244.161)  13.174 ms
 5  216.239.40.255 (216.239.40.255)  13.577 ms  13.923 ms 216.239.41.175 (216.239.41.175)  13.923 ms
 6  yyz12s06-in-f14.1e100.net (172.217.165.14)  13.020 ms  12.009 ms  11.291 ms
[[email protected] ~]#

L'adresse IP de la ligne #1 est 206.248.155.139 et elle est donc la passerelle utilisée par notre connexion.

Configuration → Réseau → Périphérique enp0s3 → Éditer.

On change l'IP de la passerelle pour l'IP de l'interface vert / enp0s3 → 206.248.155.139.

SOUMETTRE.

Serveurs DNS

Référence: https://korben.info/1-1-1-1-ou-9-9-9-9-ou-8-8-8-8-quel-dns-choisir.html.
… Le DNS de Cloudflare est un bon DNS, car il est le plus rapide, mais aussi parce qu'ils ont pris les devants et s'engagent à ne pas revendre les données, et ne conservent pas les logs au-delà de 24h…
Le principal avantage bien sûr, c'est que contrairement au DNS de Google qui permet de mieux vous profiler pour vous balancer de la pub, on sait que Cloudflare ne trempe pas là dedans. Cela reste une boîte américaine, donc c'est évidemment à prendre avec toutes les précautions d'usage…

Référence: pour 8.8.8.8 - https://www.dnsperf.com/dns-resolver/google.

Autre référence: comparaison mondiale des performances de différents DNS:
https://medium.com/@nykolas.z/dns-resolvers-performance-compared-cloudflare-x-google-x-quad9-x-opendns-149e803734e5.

Référence: pour ci-dessous 1.1.1.1 - https://www.dnsperf.com/#!dns-resolvers.


Configuration → Réseau → Serveurs DNS.

On ajuste le DNS Primaire et Secondaire.

Le serveur DNS primaire 1.1.1.1 est le plus rapide et le plus utilisée de tout l'Internet.

Le serveur DNS secondaire 206.248.182.3 est le défaut de notre FAI.

Soumettre.

Si votre FAI filtre l'adresse 1.1.1.1, prendre 8.8.8.8 ou une de celles citées dans la référence ci-dessous:
https://medium.com/@nykolas.z/dns-resolvers-performance-compared-cloudflare-x-google-x-quad9-x-opendns-149e803734e5.

Serveur de production

Une fois que vous maîtrisez tous les aspects de: MediaWiki, Let's Encrypt, Fail2ban, ClamAV et de BackupPC, vous pouvez créer un réseau de Production incluant un serveur MediaWiki, un serveur de sauvegardes et un serveur de développement; ce qui est le but ultime que nous vous souhaitons.



Victoire totale, hissons la bannière de la victoire.


Crédits

© 2016-2018-2019 RF-232
Auteur: Michel-André
Remerciement: Tous les contributeurs GNU/GPL
Intégré par: Michel-André Robillard CLP
Contact: michelandre at micronator.org

Répertoire de ce document: E:\000_DocPourRF232_general\RF-232_NethServer-201\RF-232_Cours_NethServer-201-03_MediaWiki_2019-08-15_15h37.odt.

Historique des modifications:

VersionDateCommentaireAuteur
0.0.12016-05-04Début.Michel-André
0.0.22016-05-16Correction index.htm pour index.html. Vérifié que tous les wiki sont de couleur Magenta. Enlevé le chapitre sur “Privilèges sur la base de données WikiDB”. Ajout de la commande find pour le répertoire images.Michel-André
0.1.02018-05-19Mise à jour pour SME-9.2 et MediaWiki-1.30.0Michel-André
0.1.12018-07-03- Ajustements pour les référentiels remi-safe, smecontribs et epel.
- Ajout de l'Extension:WikiEditor.
- Mise à jour de certaines explications.
Michel-André
0.1.22018-07-05Ajout pour la sauvegarde/récupération de la BD de MySQL55.Michel-André
0.2.02018-07-11- Mise à jour pour smeserver-mysql57.
- Changements pour l'installation de Mediawiki-1.31 à l'aide de git, pour le téléchargement et la mise à jour de MediaWiki, au lieu d'utiliser un fichier tar.gz.
- Ré-écriture des chapitres: Répertoires spéciaux à sauvegarder et Sau­vegarde/restauration MySQL57.
Michel-André
0.3.02018-11-24Mise à jour pour vers la version MediaWiki-1.31.1/LTS.Michel-André
4.0.02019-05-25Adaptation pour NethServer-7.6.1810.Michel-André
4.0.12019-05-25Correction pour le ©.Michel-André
4.1.02019-08-14Ajustements pour DokuWiki.Michel-André
4.1.12019-08-19Suppression du “sticky bit” pour les fichiersMichel-André
12345678901 12345678901


AVIS DE NON-RESPONSABILITÉ

Ce document est uniquement destiné à informer. Les informations, ainsi que les contenus et fonctionnalités de ce do­cument sont fournis sans engagement et peuvent être modifiés à tout moment. RF‑232 n'offre aucune garantie quant à l'actualité, la conformité, l'exhaustivité, la qualité et la durabilité des informations, contenus et fonctionnalités de ce document. L'accès et l'utilisation de ce document se font sous la seule responsabilité du lecteur ou de l'utilisateur.

RF‑232 ne peut être tenu pour responsable de dommages de quelque nature que ce soit, y compris des dommages di­rects ou indirects, ainsi que des dommages consécutifs résultant de l'accès ou de l'utilisation de ce document ou de son contenu.

Chaque internaute doit prendre toutes les mesures appropriées (mettre à jour régulièrement son logiciel antivirus, ne pas ouvrir des documents suspects de source douteuse ou non connue) de façon à protéger le contenu de son ordina­teur de la contamination d'éventuels virus circulant sur la Toile.

Toute reproduction interdite Vous reconnaissez et acceptez que tout le contenu de ce document, incluant mais sans s’y limiter, le texte et les images, sont protégés par le droit d’auteur, les marques de commerce, les marques de service, les brevets, les secrets industriels et les autres droits de propriété intellectuelle. Sauf autorisation expresse de RF-232, vous acceptez de ne pas vendre, délivrer une licence, louer, modifier, distribuer, copier, reproduire, transmettre, afficher publiquement, exécuter en public, publier, adapter, éditer ou créer d’oeuvres dérivées de ce document et de son contenu.

Avertissement

Bien que nous utilisions ici un vocabulaire issu des techniques informatiques, nous ne prétendons nullement à la précision technique de tous nos propos dans ce domaine.

1)
FQDN: Dans le DNS, un Fully Qualified Domain Name (FQDN, ou nom de domaine complètement qualifié) est un nom de domaine qui révèle la position absolue d'un nœud dans l'arborescence DNS en indiquant tous les domaines de niveau supérieur jusqu'à la racine. On parle également de domaine absolu, par opposition aux domaines relatifs. Par convention, le FQDN est ponctué par un point final. Référence: https://fr.wikipedia.org/wiki/Fully_qualified_domain_name.
2)
Fin de vie(Eol - End of life): Sedit en informatique d'un logiciel ou d'un produit en fin de vie que l'éditeur ou le constructeur ne fait plus évoluer.
Référence: https://fr.wikipedia.org/wiki/Fin_de_vie_(produit).
3)
LTS: Une version à support long (LTS) sera créée tous les deux ans. Il y aura un recouvrement d’un an entre les périodes de maintenance des LTS. Par exemple, la version 1.23 était maintenue jusqu’à mai 2017 ; la version 1.27 a été publiée un an avant afin d’avoir un an pour faire la transition d’une version LTS à l’autre. Référence: https://www.mediawiki.org/wiki/Version_lifecycle/fr.
4)
Table de mappe de clavier: n.f. Disposition des touches d'un clavier. Référence: http://www.granddictionnaire.com/ficheOqlf.aspx?Id_Fiche=18050861#eng.
nethserver_201_cahier_03_mediawiki.txt · Dernière modification: 2019-08-19 15:32 par michelandre