Passer au contenu principal

Installation Linux

Install the Level agent on Linux devices using a one-line command or architecture-specific installer.

Introduction

L'agent Level est un service d'arrière-plan léger qui se connecte à votre compte et rend la surveillance à distance, l'automatisation et la gestion disponibles pour un appareil Linux. L'installation s'effectue avec une seule commande exécutée en tant que root ou avec sudo.


⚙️ PRÉREQUIS

  • Un compte Level avec l'autorisation d'ajouter des appareils

  • Accès root ou sudo sur l'appareil cible

  • Une distribution Linux compatible exécutant systemd

  • Paquets requis : curl, bash, ca-certificates, sudo, dbus (ou un UUID dans /etc/machine-id)


🎬 VIDÉO


Installation Linux

Cliquez sur Ajouter un nouvel appareil dans le coin supérieur droit de la Liste des appareils page. Dans le sélecteur de système d'exploitation, choisissez Linux.

Linux Install

Sélection d'un groupe d'appareils (facultatif)

Sélectionnez un groupe d'appareils avant de copier votre commande d'installation. La clé d'installation se met à jour pour inclure l'identifiant du groupe, de sorte que l'appareil rejoigne le bon groupe dès la première connexion.

Si vous ignorez cette étape, l'appareil se retrouve dans Non groupé. Vous pouvez le déplacer par la suite.


La clé d'installation

Chaque méthode d'installation Linux utilise une clé d'installation, un court jeton visible dans la fenêtre modale qui relie les nouveaux appareils à votre compte Level. Sa portée est étroite : si elle est exposée, elle ne peut pas accéder à votre compte, aux appareils existants ou à l'API Level. Le seul risque est que quelqu'un puisse l'utiliser pour ajouter des appareils à votre compte.

Si vous pensez que votre clé d'installation a été compromise, contactez le support Level pour la faire pivoter.

ℹ️ REMARQUE : La clé d'installation reflète votre sélection de groupe en temps réel. Sans groupe sélectionné, elle contient uniquement l'identifiant de votre compte. Sélectionnez un groupe et l'identifiant du groupe est ajouté.


Méthodes d'installation

La fenêtre modale comporte deux onglets pour Linux.

Commande en une ligne

Une commande bash en une ligne qui télécharge et installe l'agent. Il s'agit de la méthode standard pour la plupart des déploiements Linux et gère automatiquement la détection de l'architecture.

  1. Dans la fenêtre modale, sélectionnez l'onglet Commande en une ligne onglet.

  2. Sélectionnez éventuellement un groupe d'appareils.

  3. Copiez la commande générée.

  4. Sur l'appareil cible, ouvrez un terminal.

  5. Exécutez la commande. Si vous n'êtes pas déjà root, la commande inclut sudo: votre mot de passe vous sera demandé.

Linux One Line Installer

L'appareil apparaît dans votre Liste des appareils dans les 5 à 10 secondes suivant la fin de l'installation.

Programme d'installation

Télécharge un binaire spécifique à l'architecture et l'installe via la ligne de commande. Utilisez cette méthode lorsque vous devez spécifier l'architecture explicitement ou si vous préférez un processus d'installation manuel.

  1. Dans la fenêtre modale, sélectionnez l'onglet Programme d'installation onglet.

  2. Sélectionnez votre architecture dans le menu déroulant : x64 ou ARM.

  3. Sélectionnez éventuellement un groupe d'appareils.

  4. Cliquez sur Télécharger le programme d'installation pour télécharger le binaire.

  5. Copiez la commande d'installation affichée dans la fenêtre modale.

  6. Sur l'appareil cible, exécutez la commande copiée avec des permissions élevées.

Linux Installer

La commande rend le binaire exécutable et lance l'installation, enregistrant l'appareil dans votre compte à l'aide de la clé d'installation intégrée.


Répertoire d'installation personnalisé

Sur les systèmes Linux exécutant systemd, vous pouvez choisir un répertoire dédié pour le binaire de l'agent, la configuration et les données d'application au lieu des emplacements standard. Choisissez le répertoire lors de l'installation. Cette option ne déplace pas une installation existante vers un nouveau chemin.

Exigences relatives au répertoire

  • Utilisez un chemin absolu réservé à Level, tel que /srv/level. Pour une nouvelle installation, utilisez un répertoire vide. Vous pouvez également réutiliser un répertoire contenant une installation Level existante au même chemin.

  • Le système de fichiers doit autoriser l'écriture et l'exécution. Un système de fichiers en lecture seule ou noexec le système de fichiers ne peut pas être utilisé.

  • Le répertoire doit appartenir à root, ne doit pas autoriser l'accès en écriture au groupe ou aux autres utilisateurs, et doit permettre aux autres utilisateurs de le traverser. Ses répertoires parents doivent également être contrôlés par root et traversables par les autres utilisateurs. Mode 755 convient pour un répertoire Level dédié appartenant à root.

  • Les espaces sont autorisés si vous mettez le chemin entre guillemets dans votre commande. N'utilisez pas de caractères de contrôle, de guillemets simples ou doubles, de signes de pourcentage, de signes dollar, de barres obliques inverses ou d'accents graves dans le chemin. N'utilisez pas un répertoire système partagé tel que /, /mnt, /opt, /tmp, ou /var/lib comme racine d'installation.

Commande en une ligne avec un répertoire personnalisé

  1. Copiez votre commande Linux en une ligne depuis Ajouter un nouvel appareil, y compris la clé d'installation et toute sélection de groupe d'appareils.

  2. Ajoutez LEVEL_INSTALL_DIR="/srv/level" avant LEVEL_API_KEY=..., en remplaçant le chemin d'exemple par le répertoire de votre choix. Le répertoire parent doit déjà exister. Le script crée le répertoire Level final s'il est manquant.

  3. Exécutez la commande modifiée. Par exemple, avec votre clé d'installation substituée à YOUR_INSTALL_KEY:

LEVEL_INSTALL_DIR="/srv/level" LEVEL_API_KEY="YOUR_INSTALL_KEY" bash -c "$(curl -L https://downloads.level.io/install_linux.sh)"

Le script prépare son téléchargement dans un répertoire temporaire privé à l'intérieur du répertoire d'installation sélectionné et transmet ce répertoire au programme d'installation de l'agent. Utilisez la variable d'environnement pour le script shell ; utilisez --install-dir lors de l'exécution directe du binaire de l'agent téléchargé.

Programme d'installation téléchargé avec un répertoire personnalisé

Créez d'abord le répertoire dédié et assurez-vous qu'il répond aux exigences ci-dessus. Ajoutez --install-dir "/srv/level" à la commande d'installation générée. Pour un programme d'installation x64, la commande est :

chmod +x ./level-linux-amd64 && sudo ./level-linux-amd64 -k YOUR_INSTALL_KEY -a install --install-dir "/srv/level"

Remplacez YOUR_INSTALL_KEY et le chemin avant d'exécuter la commande, et utilisez le binaire correspondant à l'architecture de votre appareil. Le binaire téléchargé doit se trouver sur un système de fichiers exécutable. Si un service Level existant pointe vers un autre répertoire d'installation, le programme d'installation rejette la modification, y compris lors d'une installation forcée. Contactez le support Level avant de modifier l'emplacement d'une installation existante.

Stockage TrueNAS et persistance au redémarrage

Pour les déploiements TrueNAS basés sur Linux, utilisez les exigences de stockage et de démarrage ci-dessous. Contactez le support Level pour confirmer la compatibilité avec votre édition et version exactes de TrueNAS avant l'installation.

  1. Choisissez un répertoire ou un jeu de données Level dédié sur un pool de stockage ZFS sous /mnt/, par exemple /mnt/tank/level. Remplacez tank avec le nom de votre pool. Ne sélectionnez pas le pool de démarrage ni la racine du pool de stockage elle-même.

  2. Importez le pool, déverrouillez tout jeu de données chiffré et montez le jeu de données d'installation avant l'installation. Le jeu de données doit être accessible en écriture et autoriser l'exécution, et le chemin doit respecter les exigences de propriété et de permissions du répertoire personnalisé ci-dessus.

  3. Utilisez la commande en une ligne avec répertoire personnalisé ci-dessus avec votre chemin TrueNAS dans LEVEL_INSTALL_DIR. Le programme d'installation vérifie le jeu de données ZFS monté avant de continuer.

  4. Après l'installation, vérifiez TrueNAS Scripts d'initialisation/arrêt pour le Service de démarrage de l'agent Level tâche. Il s'agit d'une tâche Commande tâche définie sur Post Init. Gardez cette tâche activée et conservez le répertoire d'installation et ses fichiers de démarrage. Vous n'avez pas besoin de créer manuellement une deuxième tâche de démarrage.

Le programme d'installation enregistre Level.service, 10-truenas.conf, et start-level.sh dans le répertoire d'installation. Au démarrage, la commande Post Init attend que le script de démarrage enregistré soit lisible, en vérifiant toutes les 60 secondes. Le script restaure l'unité d'exécution dans /run/systemd/system/Level.service et son fichier drop-in d'exigence de montage dans /run/systemd/system/Level.service.d/10-truenas.conf, puis démarre le service.

Le jeu de données d'installation doit être disponible pour que l'agent puisse s'exécuter. S'il reste chiffré et verrouillé après le démarrage, déverrouillez-le et montez-le via votre flux de travail de stockage TrueNAS habituel. La tâche de démarrage ne déverrouille pas le jeu de données pour vous.


Installation forcée (avancé)

Si une installation Level précédente a laissé des fichiers obsolètes, utilisez le forceInstall paramètre URL pour forcer un remplacement complet.

Accédez à :

https://app.level.io/devices?forceInstall=true

Cela ajoute LEVEL_FORCE_INSTALL=true à la commande en une ligne générée.

⚠️ AVERTISSEMENT : L'installation forcée écrase toute configuration d'agent Level existante sur l'appareil. N'utilisez cette option que lorsqu'une installation standard échoue ou que le support Level vous y invite.


Configuration système requise

Distributions compatibles

Distribution

Version minimale

AlmaLinux

Version stable actuelle

Arch Linux

Version stable actuelle

CentOS

8

Debian

10

Fedora

36

Fedora Silverblue / COSMIC Atomic (rpm-ostree)

Version stable actuelle

Linux Mint

20

Photon OS (VMware)

Version stable actuelle

Raspbian (Raspberry Pi OS)

Version stable actuelle

Red Hat Enterprise Linux (RHEL)

8

Rocky Linux

8

Sangoma Linux

Version stable actuelle

Ubuntu

20.04 LTS

🖥️ NOTE DE PLATEFORME : Les systèmes rpm-ostree tels que Fedora Silverblue et COSMIC Atomic sont pris en charge. L'agent écrit son délai de redémarrage systemd via un fichier drop-in et stocke les entrées de bureau dans /usr/local/share, donc il n'écrit pas dans les chemins système en lecture seule. Les déploiements rpm-ostree en attente sont détectés pour les vérifications de redémarrage.

ℹ️ REMARQUE : D'autres distributions peuvent fonctionner mais ne sont pas officiellement prises en charge. Si vous rencontrez des problèmes avec une distribution non répertoriée, contactez le support Level.

Dépendances requises

Les packages suivants doivent être présents sur le système cible avant l'installation :

  • sudo

  • systemd (pour la gestion des services)

  • dbus ou un UUID dans /etc/machine-id

  • curl

  • ca-certificates

  • bash

La plupart des distributions prises en charge les incluent par défaut. Sur les installations minimales, vérifiez-les avant d'exécuter la commande d'installation Level.


Emplacements de stockage

Les chemins ci-dessous sont les emplacements standard du binaire et des données. Le fichier de configuration standard est /etc/level/config.yaml.

Chemin

Objectif

/usr/local/bin/level

Binaire de l'agent

/var/lib/level

Données de l'agent

Stockage dans un répertoire personnalisé

Avec /srv/level sélectionné comme répertoire d'installation personnalisé, Level utilise :

  • /srv/level/bin/level pour le binaire de l'agent.

  • /srv/level/config.yaml pour la configuration.

  • /srv/level pour les données d'application, y compris les journaux et la base de données locale.

Le service systemd conserve le répertoire sélectionné dans son --install-dir argument. Pour TrueNAS, remplacez votre /mnt/... chemin d'installation ; les fichiers de démarrage enregistrés décrits ci-dessus restent également dans ce répertoire.


Après l'installation

L'appareil apparaît dans votre Liste des appareils dans les 5 à 10 secondes et commence à alimenter l'inventaire matériel en quelques minutes.

Si l'appareil n'apparaît pas, consultez Dépannage hors ligne pour les prochaines étapes.


FAQ

  • La clé d'installation est-elle identique à une clé API ? Non. La clé d'installation (depuis Ajouter un nouvel appareil) enregistre uniquement les appareils dans votre compte. Les clés API (depuis Paramètres → Clés API) authentifient les outils externes auprès de l'API de Level. Vous ne pouvez pas installer l'agent avec une clé API. Utilisez la clé d'installation depuis la fenêtre modale d'installation. Consultez Paramètres des clés API.

  • Dois-je exécuter la commande d'installation en tant que root ? Oui, l'agent nécessite des permissions élevées pour s'installer. La commande en une ligne inclut sudo automatiquement. Pour le programme d'installation manuel, exécutez la commande avec sudo ou directement en tant que root.

  • Quelle architecture choisir dans l'onglet Programme d'installation ? Sélectionnez x64 pour les systèmes Intel/AMD 64 bits standard et ARM pour les appareils basés sur ARM (y compris Raspberry Pi). La méthode de commande en une ligne gère automatiquement la détection de l'architecture.

  • Puis-je installer Level sur Fedora Silverblue ou COSMIC Atomic ? Oui. Ces systèmes rpm-ostree figurent dans le tableau des systèmes pris en charge. Utilisez le programme d'installation natif. L'agent n'écrit pas dans les chemins système en lecture seule. D'autres distributions immuables peuvent fonctionner si elles satisfont aux exigences de dépendances, mais elles ne sont pas officiellement testées.

  • Ma distribution Linux n'est pas sur la liste des distributions prises en charge, Level fonctionnera-t-il quand même ? Peut-être. Level prend en charge la plupart des distributions modernes exécutant systemd. Si votre distribution satisfait aux exigences de dépendances, elle devrait fonctionner correctement. Contactez le support Level si vous rencontrez des problèmes.

  • L'appareil est installé mais n'apparaît pas dans Level, qu'est-ce qui ne va pas ? Attendez 10 à 15 secondes et actualisez. Si l'appareil n'apparaît toujours pas, vérifiez que systemd est en cours d'exécution et que toutes les dépendances requises (curl, dbus, etc.) étaient présentes lors de l'installation. Consultez Dépannage hors ligne pour les étapes suivantes.

  • Que faire si ma clé d'installation est compromise ? La clé d'installation ne peut pas accéder à votre compte, aux appareils existants ou à l'API Level. Le seul risque est que quelqu'un ajoute des appareils à votre compte. Contactez le support Level pour faire pivoter la clé si nécessaire.

  • Puis-je déployer l'agent sur de nombreux appareils Linux à la fois ? Oui. Utilisez la commande en une ligne avec vos outils existants (Ansible, Puppet, Chef, bash via SSH, etc.).

  • Qui peut ajouter des appareils à Level ? Tout technicien ayant la permission de gérer le groupe d'appareils cible, ou tout technicien s'il déploie dans Non groupé. Vérifiez Espace de travail → Permissions si vous ne voyez pas le Ajouter un nouvel appareil bouton.

Avez-vous trouvé la réponse à votre question ?