Article mis à jour le 3 juillet 2022.
Sommaire
Introduction
Mon onduleur est un Eaton Ellipse Pro 1600 qui est branché à mon PC par un port USB 2.
Installations
Vous avez besoin des deux logiciels suivant NUT (Network UPS Tools ) et KNutClient (qui est un client KDE visuel pour les onduleurs utilisant le logiciel NUT).
On va commencer par le logiciel NUT, là, c’est facile : ouvrez votre gestionnaire de logiciels préféré. Faites une recherche de logiciel portant le nom de « nut » et installez-le.
Pour KNutClient, c’est un vieux logiciel, la dernière version est la 1.1.1. Il n’est plus disponible dans votre gestionnaire de logiciels (et ça sur n’importe laquelle des distributions GNU/Linux), et n’est disponible qu’en fichiers sources. Je l’ai compilé et j’en ai créé une archive zip. Vous pouvez la télécharger ici : knutclient.zip (1,4 Mo). Pour l’installer, ce n’est pas très compliqué. Dans votre navigateur de fichiers, vous dézippez l’archive (là suivant votre navigateur de fichiers, vous pourrez ou non dézipper avec un clic droit et choisir « Extraire ici »). Vous vous retrouvez avec un beau répertoire knutclient.
Faite un clic droit sur le répertoire et choisissez « Ouvrir un terminal ici » ou quelque chose du genre. Vous voilà dans le terminal. tapez la commande suivante avec une ArchLinux ou une Manjaro Linux :
./install-archlinux.shTapez la commande suivante avec une Debian, Ubuntu ou Mint :
./install-deb.shTapez la commande suivante avec une distribution basé sur RPM.
./install-rpm.shLe script va faire appel à votre gestionnaire de paquet en ligne de commandes pour installer les dépendances (pacman pour ArchLinux et Manjaro Linux), (apt-get pour les paquets deb) (et yum pour les paquets RPM). Comme vous le voyez, ça a tout copié dans le répertoire /usr/local/ pour bien différencier le logiciel installé à la main de ceux installés avec un gestionnaire de logiciel.
Faites un « Alt+ F2 » et tapez knutclient.
Voilà, c’est fini pour cette partie installations.
Configuration
On va commencer par le début. On va configurer Nut (Network UPS Tools).
Configuration de Network UPS Tools
Pour commencer, on va dire à NUT quel pilote il doit utiliser. Pour savoir quel pilote utiliser, faites une recherche sur Google :
le nom de votre onduleur Network UPS Tools
Vous trouverez vite la réponse, mais le pilote générique connaît déjà beaucoup d’onduleurs, c’est donc lui qu’on va configurer aujourd’hui, mais c’est le même principe qu’avec celui-là.
Toute la configuration se fait sur des fichiers appartenant au compte ROOT donc prudence, on lance l’éditeur de texte (je n’ai pas dit traitement de texte) depuis une console avec sudo devant le nom de l’éditeur. Je vous montre une première fois avec l’éditeur Leafpad.
Éditez le fichier /etc/nut/ups.conf
sudo leafpad /etc/nut/ups.confeaton, c’est l’identifiant que j’ai donné à mon onduleur. usbhid-ups, c’est le nom du pilote de l’onduleur. Le port = auto, c’est le port utilisé par l’onduleur, ici, comme c’est comme c’est de l’USB, on laisse en auto et on ajoute desc = "Eaton Protection Station 800", c’est la marque et le modèle de mon onduleur donc mettez celle et celui de votre onduleur.
Pour le choix du pilote de l’onduleur, voilà la liste des onduleurs supportés par NUT avec le nom des pilotes à utiliser.
Ajoutez ceci à la fin du fichier.
[eaton]
driver = usbhid-ups
port = auto
desc = "Eaton Ellipse PRO 1600"
Avant de démarrer le service, on a un autre fichier à configurer, car le démon qui pilote a besoin de l’adresse IP du PC qui peut communiquer avec l’onduleur donc on va dire à UPSD quelles adresses il doit écouter pour le commander et donc pouvoir passer le pilote au démon. Pour passer les les adresses IP à UUPSD il faut donc les trouver, pour ça on va donc ouvrir un fichier en lecture seule (donc pas besoin de terminal ni de sudo) on ouvre le fichier /etc/hosts ce qui pour moi me donne ça :
⋕ Host addresses
127.0.0.1 localhost
127.0.1.1 ignace-pc
::1 localhost ip6-localhost ip6-loopback
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters
Donc :
Éditez le fichier /etc/nut/upsd.conf
On ajoute à la fin du fichier ces trois éléments qui composent une ligne, et on peut ajouter autant de ligne que nécessaire. Attention tout de même, on ne s’occupe pas des adresses en IPv6.
LISTEN : ÉCOUTEZ en anglais qui dit à UPSD d’écouter.
X.X.X.X : l’adresse IP qui doit être écoutée par UPSD.
YYYY : le port TCP/IP utilisé par UPSD pour écouter, 3493, est le port par défaut.
Ce qui donne ça pour mon fichier personnel :
LISTEN 127.0.0.1 3493
LISTEN 127.0.1.1
LISTEN localhost
LISTEN ignace-pc
Pour bien faire, on ajoute notre utilisateur au groupe nut, ne pas oublier -a sinon ça nous ajoute au groupe nut mais ça enlèverait tous les autres. username, c’est ton nom d’utilisateur.
sudo usermod -a -G nut usernameVoilà, il ne reste plus qu’à vous déconnecter et vous reconnecter et c’est bon.
Donc la configuration de NUT est faite, on active le service NUT par la commande suivante dans un terminal:
sudo systemctl enable nut-server.serviceOn peut donc maintenant lancer le service NUT toujours dans un terminal :
sudo systemctl start nut-server.servicePour vérifier que ça fonctionne, j’utilise le terminal, mais sans sudo avec le programme upsc espace puis vient l’identifiant de votre onduleur suivi d’un sans espace @ et toujours sans espace ce que vous avez déclaré dans le fichier /etc/nut/upsd.conf, mais sans le port, la commande qui fonctionne chez mois est la suivante, commencez par la première ligne et si ça ne fonctionne pas, essayez la seconde ligne et ainsi de suite jusqu’à que vous trouviez le bon nom d’hôte ou la bonne adresse IP :
upsc eaton@localhostLà, vous n’avez pas eu le temps de voir, mais il y est passé toutes les données collectées sur votre onduleur, je vous encourage à les regarder, c’est intéressant. On peut donc passer à la suite.
Configuration de KNutClient
Lancez KNutClient par la combinaison des touches Alt+F2, dans la fenêtre qui s’ouvre, tapez knutclient et cliquez sur Lancer.
La fenêtre de KNutClient s’ouvre, c’est bien gris tout ça, comme vous avez, avec la commande upsc, trouvé tout ce qu’il vous faut pour bien configurer KNutClient.
On y va, allez dans le menu « Configuration » et vous choisissez « … ». Vous arrivez à cette fenêtre :
À gauche, vous avez le menu avec six icônes nommées sur le premier « Paramètres », vous ne devriez rien avoir à changer.
Passons au suivant :
Là, ça devient intéressant, ici on peut ajouter, enlever ou modifier un onduleur. Ici, j’ai déjà le mien qui a déjà été ajouté. Cliquez sur « Ajouter », vous avez la fenêtre de configuration des paramètres de l’onduleur :
Il reste plus qu’à configurer l’onduleur, vous lui donnez un nom.L’adresse, c’est le nom d’hôte ou l’IP de l’onduleur que vous avez trouvé avec la commande upsc, le délai en ms, on y touche pas, le port, c’est bon aussi. Pour les variables, vous sélectionnez vos variables disponibles et les ajoutez une variable à la fois, vous en sélectionnez une et vous cliquez sur la flèche vers la droite pour la passer dans la colonne de droite. Dans les valeurs sélectionnées, vous pouvez faire varier l’ordre de chaque valeur avec les boutons vers le haut et vers le bas et l’on fait « ok » quand c’est fini. Voilà ce que donne ma configuration avec mon onduleur :
Maintenant, voyons les paramètres du panneau (sur l’interface principale, c’est le panneau à gauche), c’est explicite, vous cochez, vous cliquez sur « Appliquer » puis sur « OK » pour finir.
Le menu « Polices » donne la possibilité d’utiliser des polices de caractères personnalisées. Le menu « Analogique » donne la possibilité de modifier les couleurs des cadrans analogiques de l’interface. Maintenant, vous allez configurer le dock (c’est l’icône dans la zone d’état) :
Voilà l’interface principale de KNutClient une fois NUT et KNutClient configurées :
Voilà, ce tutoriel est terminé. Voici les liens des sites officiels pour des deux logiciels :
Network UPS Toolstools et KNutClient.
