====== Installer Archifiltre sous Debian ======
Sources :
  * [[https://github.com/SocialGouv/archifiltre-docs/wiki/Wiki-Archifiltre|Documentation d'Archifiltre]] (fr)
  * [[https://superuser.com/questions/1094597/enable-user-namespaces-in-debian-kernel|Enable user namespaces in Debian kernel]] (en) (superuser.com)
===== Archifiltre ? =====
[[https://archifiltre.fabrique.social.gouv.fr/|Archifiltre]] est une application qui permet d'analyser le contenu d'une arborescence, d'enrichir les méta-données gérées par le système de fichiers((Et restituées par l'OS.)), d'identifier les fichiers redondants et de produire un audit du contenu de l'arborescence.
<note>Archifiltre ne modifie pas l'arborescence ni les informations gérées par le système de fichiers((La documentation devrait fournir cette information capitale dès son introduction, mais omet de l'indiquer.)).</note>
===== Téléchargement =====
La version proposée au téléchargement sur la page d'accueil étant la version Window$, récupérer la version Linux sur la [[https://archifiltre.fabrique.social.gouv.fr/|page dédiée téléchargement]].

La même version convient pour toutes les distribution Linux pour peu qu'il s'agisse d'une version 64 bits. On obtient un fichier unique avec portant l'extension ".Appimage".
===== Installation =====
<note>//Archifiltre// pour Linux est fourni sous la forme d'une application autonome. Cela signifie que :
elle contient toutes les dépendances dont elle a besoin((C'est pourquoi on peut l'installer sans passer   * Liste à pucepar l'utilitaire de gestion des paquetages et des dépendances. Par exemple, //apt//, sous Debian.)),
* le fichier de l'application peut être placé où bon nous semble.</note>

Placer le fichier dans votre espace personnel, à un endroit qui vous semblera logique((Si vous avez un répertoire "Applications", à la racine de votre espace personnel, c'est un bon candidat.)).

Puisqu'on veut exécuter l'application contenue dans ce fichier, il faut le rendre exécutable. Faites comme vous avez l'habitude pour changer les droit des fichiers et répertoires. Par exemple, en ouvrant un terminal et le pointant sur le répertoire contenant le fichier :
<code>$ chmod o+x archifiltre-3.2.2.AppImage</code>
Dans cet exemple, on choisit de rendre le fichier exécutable par soi-même uniquement (recommandé).
===== Adaptation de l'environnement d'exécution =====
Pas de panique ! C'est simple à faire…
==== Pourquoi ? ====
Sous de nombreuses versions de Debian, une telle application ne pourra s'exécuter. Voixi le type de messages d'erreur que vous aurez si vous lancez l'application depuis un terminal :
<code>$ ./archifiltre-3.2.2.AppImage
[19137:0205/201653.334382:FATAL:setuid_sandbox_host.cc(158)] The SUID sandbox helper binary was found, but is not configured correctly. Rather than run without sandboxing I'm aborting now[…]</code>
<note warning>Il est très vivement conseillé de faire ce test afin de vérifier si la version de Debian que l'on utilise génère de type de message d'erreur, signifiant qu'une adaptation est nécessaire.</note>
La raison de l'échec dans l'exécution tient est que la configuration par défaut de Debian n'autorise pas les utilisatrices ordinaires à lancer des applications packagées de la même manière qu'Archifiltre. Seule "root" peut le faire :(.
==== Adaptation ====
=== Temporaire ===
Il faut avoir le droit de requérir les droits de super-utilisatrice((Si on est l'utilisatrice principale (ou unique) du système on dispose généralement de ce droit.)) ou être root. L'adaptation tient en une seule ligne de commande :
<code>$ sudo sysctl -w kernel.unprivileged_userns_clone=1</code>
C'est tout ! Vous pouvez désormais exécuter l'application depuis son fichier :)
<note important>Cependant, la modification apportée disparaîtra au prochain redémarrage de votre ordi.</note>
=== Permanente ===
Si l'on souhaite que l'adaptation soit permanente((Ce sera probablement le cas si on n'a pas simplement installé Archifiltre pour le tester.)), il faut modifier un fichier de configuration [du noyau] de Debian. Là encore,une seule ligne de commande suffit :
<code># echo 'kernel.unprivileged_userns_clone=1' > /etc/sysctl.d/00-local-userns.conf
service procps restart</code>
===== Un peu de confort =====
Pour un lancement facilité d'Archifiltre, on souhaitera probablement créer un //lanceur//, facilement accessible depuis son espace de travail graphique. Mais la manière de faire dépend de votre environnement de bureau et sort du cadre de cette fiche…