Table des matières
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-101-01: → Les bases de Linux.
- Cahier-101-02: → Installation et configuration des logiciels prérequis sur le poste de travail.
- Cahier-101-03: → Création d'un Serveur NethServer virtuel.
- Cahier-101-04: → Serveur NethServer LOCAL & Let's Encrypt.
- Cahier-101-05: → FAI, modem VDSL, domaine FQDN1) et Serveur NethServer physique.
- Cahier-101-06: → Installation de WordPress.
- Cahier-101-07: → Installation de l'extension de sécurité Wordfence.
- Cahier-101-08: → WooCommerce, comptes chez Stripe et PayPal pour les paiements en ligne.
- Cahier-101-09: → Sauvegarde/restauration ou migration d'un site avec l'extension Duplicator.
- Cahier-101-10: → Serveur mandataire inversé.
- Cahier-101-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.
- Cahier-201-01: → Dolibarr.
- Cahier-201-02: → Odoo-12.
- Cahier-201-03: → MediaWiki.
- Cahier-201-04: → DokuWiki.
- Cahier-201-05: → Moodle.
- Cahier-201-06: → Proxmox.
- Cahier-201-07: → Flectra.
- Cahier-201-08: → Self Service Password.
Cours NethServer-301
Le Cours NethServer-301 décrit l'annuaire Active Directory roulant sur un Serveur NethServer.
- Cahier-301-01: → RSAT (Remote Server Administration Tools).
- Cahier-301-02: → NethServer et migration de LDAP vers Active Directory.
- Cahier-301-03: → Active Directory & Self Service Password.
- Cahier-301-04: → Active Directory & jonction de stations.
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.
[root@dorgee ~]# 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 [root@dorgee ~]#
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.
Espace de noms
Référence: http://fr.wikipedia.org/wiki/Aide:Espace_de_noms.
Un espace de noms est un ensemble de pages ayant le même préfixe dans leur titre. Par exemple, la page Aide:Espace de noms appartient à l’espace de noms Aide:. L’espace de noms par défaut est l’espace principal. Il rassemble les articles et forme l’encyclopédie proprement dite. Une définition plus large est présentée dans l'article Espace de noms.
É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
Guide pratique (1er août 2013): http://nliautaud.developpez.com/tutoriels/web/notepadplusplus-guide-pratique/.
Aide-mémoire des principales commande: https://drive.google.com/file/d/0B86nuTd5nMTKaENHcmliUC1kdnc/edit.
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.
Fournisseur des 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
Paramètres d'accès à distance
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 root@10.10.10.75'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 *********************************************** [root@tchana ~]#
Adresse IP
On vérifie les adresses IP du serveur.
[root@tchana ~]# 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 [root@tchana ~]#
Fail2ban
On vérifie que le pare-feu Fail2ban est installé.
[root@tchana ~]# 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 [root@tchana ~]#
On vérifie que Fail2ban roule sur le serveur.
[root@tchana ~]# 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 [root@tchana ~]#
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é.
[root@tchana ~]# 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 [root@tchana ~]#
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.
[root@tchana ~]# 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 [root@tchana ~]#
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é.
[root@tchana ~]# rpm -qa | grep nethserver-stephdl nethserver-stephdl-1.0.7-1.ns7.sdl.noarch [root@tchana ~]#
Si ce n'est déjà fait, on installe ce référentiel.
[root@tchana ~]# 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! [root@tchana ~]#
Vérification.
[root@tchana ~]# rpm -qa | grep stephdl nethserver-stephdl-1.0.7-1.ns7.sdl.noarch [root@tchana ~]#
Référentiel remi
On vérifie si le référentiel remi est déjà installé.
[root@tchana ~]# rpm -qa | grep remi remi-release-7.6-2.el7.remi.noarch [root@tchana ~]#
Si ce n'est déjà fait, on installe ce référentiel.
[root@tchana ~]# 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! [root@tchana ~]#
On vérifie.
[root@tchana ~]# rpm -qa | grep remi remi-release-7.6-2.el7.remi.noarch [root@tchana ~]#
Installation de la Collection PHP
[root@tchana ~]# 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é ! [root@tchana ~]#
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
.
[root@tchana ~]# yum repolist | grep remi * remi-safe: mirror.team-cymru.com remi-safe Safe Remi's RPM repository for Enterprise Lin 3 191 [root@tchana ~]#
On vérifie le répertoire /opt
.
[root@tchana ~]# 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 [root@tchana ~]#
On affiche le répertoire /opt/remi
.
[root@tchana ~]# 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 [root@tchana ~]#
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.
[root@tchana ~]# chmod +x /etc/profile.d/activer-php72.sh [root@tchana ~]#
On vérifie.
[root@tchana ~]# 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 [root@tchana ~]#
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.
[root@tchana ~]# 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 [root@tchana ~]#
Collections installées.
[root@tchana ~]# scl -l php56 php70 php71 php72 php73 [root@tchana ~]#
Quel est le PHP par défaut?
[root@tchana ~]# which php /opt/remi/php72/root/usr/bin/php [root@tchana ~]#
Quelle est sa version?
[root@tchana ~]# 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 [root@tchana ~]#
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.
[root@tchana ~]# cat /etc/backup-data.d/custom.include | grep /etc/profile.d/activer-php72.sh /etc/profile.d/activer-php72.sh [root@tchana ~]#
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:
[root@tchana ~]# 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 [root@tchana ~]#
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.
[root@tchana ~]# config show php72 php72=configuration AllowUrlFopen=On ExposePhp=0 MaxExecutionTime=30 MaxFileUpload=20 MaxInputTime=60 MemoryLimit=128 PostMaxSize=20 UploadMaxFilesize=10 [root@tchana ~]#
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.
Vérifications à la ligne de commande
MemoryLimit
[root@tchana ~]# cat /etc/opt/remi/php72/php.ini | grep -i Memory_Limit memory_limit = 250M [root@tchana ~]#
PostMaxSize
[root@tchana ~]# cat /etc/opt/remi/php72/php.ini | grep -i post_max_size post_max_size = 100M [root@tchana ~]#
UploadMaxFilesize
[root@tchana ~]# 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.
[root@tchana ~]# 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 [root@tchana ~]#
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
[root@tchana ~]# 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é ! [root@tchana ~]#
Vérification
[root@tchana ~]# scl -l php56 php70 php71 php72 php73 rh-mariadb102 [root@tchana ~]#
La Collection a été installée dans le répertoire /opt/rh
.
[root@tchana ~]# 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 [root@tchana ~]#
On affiche les propriétés de la Collection.
[root@tchana ~]# config show rh-mariadb102-mariadb rh-mariadb102-mariadb=configuration LocalNetworkingOnly=no MaxAllowedPacket=16M TCPPort=3312 access=private status=enabled [root@tchana ~]#
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é.
[root@tchana ~]# systemctl list-unit-files | grep mariadb mariadb.service disabled rh-mariadb102-mariadb.service enabled rh-mariadb102-mariadb@.service disabled [root@tchana ~]#
On vérifie que le démon soit en exécution.
[root@tchana ~]# 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 [root@tchana ~]#
Journal de la Collection
Le journal pour cette Collection est situé dans le fichier /var/log/rh-mariadb102/mariadb.log
.
[root@tchana ~]# 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 [root@tchana ~]#
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:
[root@tchana ~]# 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 [root@tchana ~]#
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).
[root@tchana ~]# mysqladmin102 CREATE MediaWikiBD [root@tchana ~]#
On entre dans la console MariaDB 10.2.
[root@tchana ~]# 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 usager_MWBD@localhost 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 usager_MWBD@localhost; +--------------------------------------------------------------------------------------------------------------------+ | Grants for usager_MWBD@localhost | +--------------------------------------------------------------------------------------------------------------------+ | 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 [root@tchana ~]#
Installation de git
On installe git
qui nous aidera pour les mises à jour de notre version MediaWiki.
[root@tchana ~]# 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é ! [root@tchana ~]#
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 Paramètres PHP.
- On ajuste tel que ci-dessous.
- Autoriser l'accès PHP aux fichiers distants est une faille de sécurité.
- SOUMETTRE.
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.
[root@tchana ~]# ls -alsd /var/lib/nethserver/vhost/mediawiki 0 drwxr-sr-x 2 ftp apache 6 May 25 18:12 /var/lib/nethserver/vhost/mediawiki [root@tchana ~]#
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.
[root@tchana ~]# chown apache /var/lib/nethserver/vhost/mediawiki [root@tchana ~]#
On vérifie.
[root@tchana ~]# ls -alsd /var/lib/nethserver/vhost/mediawiki 0 drwxr-sr-x 2 apache apache 6 May 25 18:12 /var/lib/nethserver/vhost/mediawiki [root@tchana ~]#
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.
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.
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.
- On entre les informations demandées.
- Destination, on entre michelandre, on clique Ajouter et on choisit michelandre@micronator-dev.org.
- SOUMETTRE.
L'utilisateur michelandre pourra voir ses courriels en se connectant à:
- https://www.micronator-dev.org/webmail, ou
- https://www.mail.mediawiki.micronator-dev.org/webmail.
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
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:
- 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 certificat 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 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.
[root@tchana ~]# /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 [root@tchana ~]#
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.
[root@tchana ~]# /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 [root@tchana ~]#
La demande d'un certificat officiel a été couronné de succès.
Vérification de la connexion sécurisée
- On se rend à: https://www.mediawiki.micronator-dev.org.
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.
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
.
[root@tchana ~]# cd /var/lib/nethserver/vhost/mediawiki/ [root@tchana mediawiki]#
On vérifie.
[root@tchana mediawiki]# pwd /var/lib/nethserver/vhost/mediawiki [root@tchana mediawiki]#
On vérifie le contenu du répertoire.
[root@tchana 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 .. [root@tchana 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.
[root@tchana 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. [root@tchana 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.
[root@tchana 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' [root@tchana mediawiki]#
Ajustement du propriétaire et du groupe
[root@tchana mediawiki]# chown -R apache:apache * ; chown -R apache:apache .* [root@tchana mediawiki]#
Ajustement des droits
On renforce la sécurité de l’accès aux fichiers f en supprimant les droits à “other”.
[root@tchana mediawiki]# find . -type f -exec chmod 640 {} \; [root@tchana mediawiki]#
On répète l'opération pour les répertoires d.
[root@tchana mediawiki]# find . -type d -exec chmod 2750 {} \; [root@tchana mediawiki]#
On vérifie.
[root@tchana 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 [root@tchana mediawiki]#
Installation de MediaWiki
On se rend sur notre site: https://mediawiki.FQDN, c.-à-d. https://www.mediawiki.micronator-dev.org.
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 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.
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 michelandre@mediawiki.micronator-dev.org 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 coche Activer le téléchargement de fichiers.
- Pour l'instant, le logo par défaut sera utilisé.
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.
[root@tchana ~]# cd /var/lib/nethserver/vhost/mediawiki/ [root@tchana mediawiki]#
On vérifie.
[root@tchana mediawiki]# pwd /var/lib/nethserver/vhost/mediawiki [root@tchana mediawiki]#
Ajustement du propriétaire et du groupe
[root@tchana mediawiki]# chown -R apache:apache * ; chown -R apache:apache .* [root@tchana mediawiki]#
Ajustement des droits
On renforce la sécurité de l’accès aux fichiers f en supprimant les droits à “other”.
[root@tchana mediawiki]# find . -type f -exec chmod 640 {} \; [root@tchana mediawiki]#
On répète l'opération pour les répertoires d.
[root@tchana mediawiki]# find . -type d -exec chmod 2750 {} \; [root@tchana mediawiki]#
On vérifie pour les fichiers, les répertoires et les fichiers cachés et de plus, “other” n'a aucun droits.
[root@tchana 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 [root@tchana mediawiki]#
Accès et login à MediaWiki
On retourne à l'écran d'installation et on clique accéder à votre wiki.
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.
Login
Si ce n'est déjà fait, on se logue à notre MediaWiki.
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.
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.
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).
[root@tchana ~]# 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 [root@tchana ~]#
On affiche le contenu des sous-répertoires.
[root@tchana ~]# 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 [root@tchana ~]#
[root@tchana ~]# 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 [root@tchana ~]#
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.
... # 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
.
[root@tchana ~]# 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' ); [root@tchana ~]#
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.
Importation du fichier de notre logo
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 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/LogoMicronatorMediawiki_135_APT.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.
[root@tchana ~]# tail -5 /var/lib/nethserver/vhost/mediawiki/LocalSettings.php ##### *********************** # Le logo de Micronator $wgLogo = "{$wgScriptPath}/images/b/bb/LogoMicronatorMediawiki_135_APT.png"; [root@tchana ~]#
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.
[root@tchana ~]# cd /var/lib/nethserver/vhost/mediawiki [root@tchana mediawiki]#
On vérifie.
[root@tchana mediawiki]# pwd /var/lib/nethserver/vhost/mediawiki [root@tchana mediawiki]#
On fait une sauvegarde du fichier.
[root@tchana mediawiki]# cp LocalSettings.php LocalSettings.php_avant-Semantic [root@tchana mediawiki]#
On vérifie.
[root@tchana 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 [root@tchana mediawiki]#
On affiche le paramètre.
[root@tchana mediawiki]# cat LocalSettings.php | grep wgShellLocale $wgShellLocale = "en_US.utf8"; [root@tchana mediawiki]#
On change la valeur du paramètre de: en_US.utf8 à: C.UTF-8.
[root@tchana mediawiki]# sed -i 's/en_US.utf8/C.UTF-8/' LocalSettings.php [root@tchana mediawiki]#
On vérifie.
[root@tchana mediawiki]# cat LocalSettings.php | grep wgShellLocale $wgShellLocale = "C.UTF-8"; [root@tchana 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 temporairement 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.
[root@tchana mediawiki]# php --re mbstring | head -n 1 Extension [ <persistent> extension #31 mbstring version 7.2.19 ] { [root@tchana mediawiki]#
On s'assure qu'on est bien dans le répertoire racine de notre wiki.
[root@tchana mediawiki]# pwd /var/lib/nethserver/vhost/mediawiki [root@tchana mediawiki]
On télécharge l'installeur de Composer.
[root@tchana 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] [root@tchana mediawiki]#
On vérifie.
[root@tchana mediawiki]# ls -als installer 260 -rw-r--r-- 1 root apache 263790 29 janv. 09:19 installer [root@tchana mediawiki]#
On installe Composer.
[root@tchana 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 [root@tchana mediawiki]#
On vérifie l'installation.
[root@tchana mediawiki]# ls -als composer.phar 1872 -rwxr-xr-x 1 root apache 1914314 3 juin 22:59 composer.phar [root@tchana mediawiki]#
On supprime le fichier installeur.
[root@tchana mediawiki]# rm installer rm : supprimer fichier « installer » ? o [root@tchana mediawiki]#
On vérifie.
[root@tchana mediawiki]# ls -als insta* ls: impossible d'accéder à insta*: Aucun fichier ou dossier de ce type [root@tchana 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.
[root@tchana 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 [root@tchana mediawiki]#
Installation de la version 3.0 de SMW
[root@tchana 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 [root@tchana 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.
[root@tchana 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' ); [root@tchana mediawiki]#
setupStore.php
Configuration du système de stockage SMW actuellement sélectionné dans LocalSettings.php
.
[root@tchana mediawiki]# cd extensions/SemanticMediaWiki/maintenance [root@tchana maintenance]#
On vérifie.
[root@tchana maintenance]# pwd /var/lib/nethserver/vhost/mediawiki/extensions/SemanticMediaWiki/maintenance [root@tchana 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.
[root@tchana 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. [root@tchana 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”.
[root@tchana maintenance]# find /var/lib/nethserver/vhost/mediawiki/ -type f -exec chmod 640 {} \; [root@tchana maintenance]#
On répète l'opération pour les répertoires d.
[root@tchana maintenance]# find /var/lib/nethserver/vhost/mediawiki/ -type d -exec chmod 2750 {} \; [root@tchana maintenance]#
On ajuste Récursivement le propriétaire:groupe.
[root@tchana maintenance]# chown -R apache:apache /var/lib/nethserver/vhost/mediawiki/ [root@tchana maintenance]#
Fichiers cachés.
[root@tchana maintenance]# chown -R apache:apache /var/lib/nethserver/vhost/mediawiki/.* [root@tchana 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.
[root@tchana 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
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 affiche les propriétés de la page.
☑ Après avoir enregistré la page, on peut aussi cliquer sur le lien Chercher les propriétés dans la barre d'outils à gauche.
Cette vue affiche 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.
[root@tchana maintenance]# cd /var/lib/nethserver/vhost/mediawiki/extensions/ [root@tchana extensions]#
On vérifie.
[root@tchana extensions]# pwd /var/lib/nethserver/vhost/mediawiki/extensions [root@tchana extensions]#
On vérifie que l'extension ait bien été téléversée dans ce répertoire.
[root@tchana extensions]# ls -asl CharInsert-REL1_31* 24 -rw-r--r-- 1 root apache 22356 4 juin 00:39 CharInsert-REL1_31-b5f34be.tar.gz [root@tchana extensions]#
Extraction du fichier tar.gz
On extraie.
[root@tchana 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 [root@tchana extensions]#
On vérifie.
[root@tchana extensions]# ls -lsd CharInsert/ 4 drwxr-xr-x 6 sssd polkitd 4096 17 avril 2018 CharInsert/ [root@tchana extensions]#
On supprime le fichier tar.gz
.
[root@tchana extensions]# rm CharInsert-REL1_31-b5f34be.tar.gz rm : supprimer fichier « CharInsert-REL1_31-b5f34be.tar.gz » ? o [root@tchana 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”.
[root@tchana extensions]# find CharInsert/ -type f -exec chmod 640 {} \; [root@tchana extensions]#
On répète l'opération pour les répertoires d.
[root@tchana extensions]# find CharInsert/ -type d -exec chmod 2750 {} \; [root@tchana extensions]#
On ajuste Récursivement le propriétaire:groupe.
[root@tchana extensions]# chown -R apache:apache CharInsert/ [root@tchana extensions]#
Les fichiers cachés.
[root@tchana extensions]# chown -R apache:apache CharInsert/.* [root@tchana extensions]#
On vérifie,
[root@tchana extensions]# ls -alsd CharInsert 4 drwxr-s--- 6 apache apache 4096 17 avril 2018 CharInsert [root@tchana 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.
[root@tchana extensions]# cd /var/lib/nethserver/vhost/mediawiki [root@tchana mediawiki]#
On fait une sauvegarde du fichier qu'on s'apprête à modifier.
[root@tchana mediawiki]# cp LocalSettings.php LocalSettings.php_avant_CharInsert [root@tchana mediawiki]#
On vérifie.
[root@tchana mediawiki]# ls -ls LocalSettings.php_avant_CharInsert 8 -rw-r----- 1 root apache 7426 4 juin 00:52 LocalSettings.php_avant_CharInsert [root@tchana 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.
[root@tchana 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" ); [root@tchana 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.
- … 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.
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].
Nom | Paramètres | Description | Depuis |
---|---|---|---|
ResourceLoader | Aucun | Marque les scripts du gadget comme étant compatible avec ResourceLoader. | ? |
dependencies | Noms des modules ResourceLoader séparés par une virgule | Voir 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). | ? |
rights | Noms des privilèges séparés par une virgule | Rend le gadget visible dans les préférences uniquement aux utilisateurs qui ont les privilèges. | ? |
default | Aucun | Rend 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.
[root@tchana ~]# cd /var/lib/nethserver/vhost/mediawiki [root@tchana mediawiki]#
On fait une sauvegarde du fichier qu'on s'apprête à modifier.
[root@tchana mediawiki]# cp LocalSettings.php LocalSettings.php_avant_deleterevision [root@tchana mediawiki]#
On vérifie.
[root@tchana mediawiki]# ls -ls LocalSettings.php_avant_deleterevision 8 -rw-r----- 1 root apache 7664 4 juin 14:06 LocalSettings.php_avant_deleterevision [root@tchana 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.
[root@tchana 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; [root@tchana 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 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
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.
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]
Ajout d'une nouvelle ligne au menu
Pour éditer le menu, il faut rechercher 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.
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.
[root@tchana ~]# cd /var/lib/nethserver/vhost/mediawiki/ [root@tchana mediawiki]#
On vérifie.
[root@tchana mediawiki]# pwd /var/lib/nethserver/vhost/mediawiki [root@tchana mediawiki]#
On met à jour. Toutes les dernières modifications concernant la branche que nous utilisons seront appliquées.
[root@tchana 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(-) [root@tchana mediawiki]#
On met à jour les sous-modules.
[root@tchana mediawiki]# git submodule update --init [root@tchana 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”.
[root@tchana mediawiki]# find . -type f -exec chmod 640 {} \; [root@tchana mediawiki]#
On répète l'opération pour les répertoires d.
[root@tchana mediawiki]# find . -type d -exec chmod 2750 {} \; [root@tchana mediawiki]#
On ajuste Récursivement le propriétaire:groupe.
[root@tchana mediawiki]# chown -R apache:apache * [root@tchana mediawiki]#
Fichiers cachés.
[root@tchana mediawiki]# chown -R apache:apache .* [root@tchana mediawiki]#
On vérifie.
[root@tchana 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 [root@tchana 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.
[root@tchana ~]# 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é ! [root@tchana ~]#
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.
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.
[root@tchana ~]# 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 [root@tchana ~]#
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.
[root@tchana ~]# 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 [root@tchana ~]#
On active le clavier ca-multi.
[root@tchana ~]# localectl set-keymap ca-multi [root@tchana ~]#
On vérifie.
[root@tchana ~]# localectl System Locale: LANG=fr_FR.UTF-8 VC Keymap: ca-multi X11 Layout: us [root@tchana ~]#
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.
[root@tchana ~]# config setprop httpd-admin MaxSessionIdleTime 7200 MaxSessionLifeTime 57600 [root@tchana ~]#
Désactivation des délais.
[root@tchana ~]# config setprop httpd-admin MaxSessionIdleTime '' MaxSessionLifeTime '' [root@tchana ~]#
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.
[root@tchana ~]# ls -ls /usr/share/zoneinfo/America/ -> grep Montreal 4 -rw-r--r-- 3 root root 3477 1 avril 08:27 Montreal [root@tchana ~]#
Changement du fuseau horaire
On affiche le fuseau horaire actuel.
[root@tchana ~]# ls -l /etc/localtime lrwxrwxrwx 1 root root 37 19 mai 23:48 /etc/localtime -> ../usr/share/zoneinfo/America/Toronto [root@tchana ~]#
On change le fuseau horaire pour celui de Montréal.
[root@tchana ~]# timedatectl set-timezone America/Montreal [root@tchana ~]#
On vérifie.
[root@tchana ~]# ls -l /etc/localtime lrwxrwxrwx 1 root root 38 22 mai 14:02 /etc/localtime -> ../usr/share/zoneinfo/America/Montreal [root@tchana ~]#
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.
- 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.
- 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.
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.
[root@tchana ~]# 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 [root@tchana ~]#
On affiche le contenu du fichier.
[root@tchana ~]# 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> [root@tchana ~]#
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.
[root@tchana ~]# cat /etc/backup-data.d/custom.include | grep z_well-known.conf /etc/httpd/conf/z_well-known.conf [root@tchana ~]#
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.
[root@tchana ~]# systemctl restart httpd [root@tchana ~]#
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/shado
w. 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.
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
[root@dorgee ~]# 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 [root@dorgee ~]#
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:
Version | Date | Commentaire | Auteur |
---|---|---|---|
0.0.1 | 2016-05-04 | Début. | Michel-André |
0.0.2 | 2016-05-16 | Correction 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.0 | 2018-05-19 | Mise à jour pour SME-9.2 et MediaWiki-1.30.0 | Michel-André |
0.1.1 | 2018-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.2 | 2018-07-05 | Ajout pour la sauvegarde/récupération de la BD de MySQL55. | Michel-André |
0.2.0 | 2018-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 Sauvegarde/restauration MySQL57. | Michel-André |
0.3.0 | 2018-11-24 | Mise à jour pour vers la version MediaWiki-1.31.1/LTS. | Michel-André |
4.0.0 | 2019-05-25 | Adaptation pour NethServer-7.6.1810. | Michel-André |
4.0.1 | 2019-05-25 | Correction pour le ©. | Michel-André |
4.1.0 | 2019-08-14 | Ajustements pour DokuWiki. | Michel-André |
4.1.1 | 2019-08-19 | Suppression du “sticky bit” pour les fichiers | Michel-André |
12345678901 | 12345678901 |
<html><hr style=“width:50%; margin: 0 auto;”></html>
AVIS DE NON-RESPONSABILITÉ
Ce document est uniquement destiné à informer. Les informations, ainsi que les contenus et fonctionnalités de ce document 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 directs 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 ordinateur 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.
Référence: https://fr.wikipedia.org/wiki/Fully_qualified_domain_name.
Référence: https://fr.wikipedia.org/wiki/Fin_de_vie_(produit).
Référence: https://www.mediawiki.org/wiki/Version_lifecycle/fr.
Référence: http://www.granddictionnaire.com/ficheOqlf.aspx?Id_Fiche=18050861#eng.