Skip to main content

[Beta] Installation de l'agent linux

Info

Toutes les commandes sont lancer en tant que super-utilisateur

Test effectuer sous Debian 11 le 21 Mars 2022 avec la version 2.0.0 de l'agent (beta pour linux).

Avant tout, assurez-vous d'avoir installer Go: https://go.dev/doc/install

Installation de l'agent Mesh

Pour que tout fonctionne, il faut installer l'agent Mesh.

Pour cela, aller sur l'interface web de mesh avec mesh.mydomain.com et connecter vous. Faite "ajouter un agent", choisissez "Executable d'installation Linux/BSD/macOS" avec le type de système et d'installation vous correspondant.

Copier la ligne de commande qui ressemble à wget -O meshagent "https://mesh.mydomain.com/meshagents?id=XXXX&installflags=2&meshinstall=6

Coller et lancer la commande sur l'hôte.

Vous avez maintenant un binaire "meshagent"

Pour l'installer: 

chmod +x meshagent
mkdir /opt/tacticalmesh
./meshagent -install --installPath="/opt/tacticalmesh"

Compilation de l'agent

Télécharger le repo GitHub de l'agent: 

git clone https://github.com/amidaware/rmmagent.git

ou

wget https://github.com/amidaware/rmmagent/archive/refs/tags/v2.0.0.zip
unzip v2.0.0.zip

Ensuite dans le dossier de l'agent, lancer la compilation en remplaçant par l'architecture qui vous correspond avec:

env CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -ldflags "-s -w"

Vous avez créer le binaire "rmmagent", il faut le copier dans son emplacement définitif:

cp rmmagent /usr/local/bin/

Installation de l'agent RMM

Il faut initialiser l'agent pour l'ajouter au tableau de bord et enregistrer sa configuration. Pour cela, remplacer l'url de l'API par celle qui vous correspond et modifier les autres informations (ID de site et de client et type d'agent).

La clé d'authentification se trouve dans le tableau de bord RMM en allant dans "Agents" > "Install Agent" et sélectionner "Manuel" comme méthode. Dans la ligne de commande utiliser la clé après "--auth"

./rmmagent -m install -api https://api.mydomain.com -client-id 1 -site-id 1 -agent-type server -auth XXXX

A ce moment, l'hôte apparait dans le dashboard de RMM.

Création du service

Pour que l'agent continue de rester en ligne, il faut qu'il soit lancer en permanence. Pour cela, on va utiliser systemd.

nano /etc/systemd/system/tacticalagent.service

[Unit]
Description=Tactical RMM Linux Agent

[Service]
Type=simple
ExecStart=/usr/local/bin/rmmagent -m svc
User=root
Group=root
Restart=always
RestartSec=5s
LimitNOFILE=1000000
KillMode=process

[Install]
WantedBy=multi-user.target

Maintenance on active le service

systemctl daemon-reload
systemctl enable --now tacticalagent

A cette étape, l'agent doit apparaitre UP dans le dashboard et tout fonctionne !