Exploiter l'agent Navin

Cette page donne les commandes courantes de l'agent Navin sur un hôte. Elles nécessitent root.

Commandes

Tâche	Commande	Résultat attendu
État de l'enregistrement	sudo nm-agent status	Registered: host <id>, cluster <cluster>, les adresses, le pilote, les composants (code de sortie 1 si l'hôte n'est pas enregistré)
Faits de l'hôte	sudo nm-agent facts	JSON : os, kernel, arch, cpu_count, memory_mb, disks, network, python, podman, platform et les autres
Démarrer	sudo systemctl start navin-manager-agent ou sudo navinctl start agent	unité active
Arrêter	sudo systemctl stop navin-manager-agent ou sudo navinctl stop agent	unité inactive ; les services gérés continuent de tourner
Redémarrer	sudo navinctl restart agent	navinctl: restart navin-manager-agent.service
Journaux de l'agent	sudo navinctl logs agent 500 ou sudo tail -f /var/log/navin-manager-agent/agent.log	dernières lignes du journal ou du fichier
Journaux de l'enrôlement	sudo navinctl logs enroll	pourquoi un enregistrement depuis enroll.env a été refusé
Unités et versions	sudo navinctl status	unités de l'hôte avec leur état, puis les versions des paquets
Version	nm-agent --version	nm-agent <version>

Modifier la configuration

1. Modifier le fichier. Changez les clés de /etc/navin-manager-agent/agent.json listées dans la référence de configuration. Gardez un JSON valide.

2. Redémarrer l'agent.

   sudo systemctl restart navin-manager-agent

   Résultat attendu : l'unité est active. Si le fichier est invalide, le journal affiche Invalid configuration file /etc/navin-manager-agent/agent.json: ... et l'agent sort avec le code 2.

Le Manager peut aussi mettre le fichier à jour avec la tâche agent.config.

Mettre à niveau

Mettez le paquet à niveau (dnf upgrade, apt install --only-upgrade, pacman -Syu) : il redémarre un agent en cours d'exécution et conserve l'enregistrement. Voir Mettre à niveau le Navin Manager.

Retirer du service

1. Retirer les composants de l'hôte. Dans Services, retirez chaque composant de l'hôte ; Retirer du service est refusé tant qu'il reste des composants.
2. Retirer l'hôte. Hôtes > hôte > Retirer du service. L'opération host.decommission exécute agent.decommission : l'agent supprime ses identifiants et cesse d'interroger le Manager (Host decommissioned: credentials deleted, the agent stopped polling.), puis le Manager enregistre l'hôte comme retiré.
3. Retirer le paquet. Voir Désinstaller.

Déplacer un hôte vers un autre Manager

Retirez l'hôte, supprimez /var/lib/navin-manager-agent/credentials.json, puis enregistrez-le avec un jeton du nouveau Manager.