De serveragent installeren, stap voor stap

Installeer de InfraNest-agent op een server om gegevens over geheugen, schijfruimte en belasting te krijgen. Dit is voor iedereen die monitoring instelt op een server die ze beheren, en duurt ongeveer twee minuten per server.

NoteWil je eerst weten waarom je hem zou installeren en wat er wordt verzameld? Lees Krijg geheugen, schijfruimte en belasting met de agent — dit artikel gaat ervan uit dat je al hebt besloten om door te gaan.

Overzicht

• De agent is een klein programma dat je eenmalig op de server zelf installeert, met behulp van een eenmalig token van InfraNest.
• Hij verstuurt alleen gegevens naar buiten via port 443 op het internet — er hoeft niets naar de server geopend te worden, en er hoeft geen firewallregel te veranderen.
• Zodra hij draait, verschijnen de cijfers voor geheugen, schijfruimte en belasting van de server in InfraNest, en worden waarschuwingsregels die de agent nodig hadden beschikbaar.

Voordat je begint

Je hebt drie dingen nodig:

• Een server in InfraNest. Als deze er nog niet is, voeg je hem toe onder Infrastructuur → Servers.
• Beheerderstoegang tot die server — sudo op Linux, een PowerShell als Administrator op Windows. Je hebt dit eenmalig nodig, om te installeren. De agent zelf draait daarna niet als beheerder.
• De server moet het internet kunnen bereiken via port 443. Alleen uitgaand.

Je hoeft geen poort te openen, geen pakketbeheer-repository te installeren, of InfraNest verder toegang tot de machine te geven.

De installatieopdracht ophalen

1. Kies Install the agent — je vindt dit bij de rij van de server in Monitoring → Servers, in het actiemenu van de server, of naast een waarschuwingsregel die grijs is omdat de agent nodig is. Alle drie openen hetzelfde venster.
2. Er wordt niets gevraagd: het token wordt direct aangemaakt. In de tokenlijst daarna wordt elk token geïdentificeerd door wie het heeft toegevoegd, wanneer, en wanneer het voor het laatst is gebruikt.
3. Het token wordt eenmalig getoond. Daaronder staat een kant-en-klare installatieopdracht met het token al ingevuld.
4. Kies het tabblad voor je systeem en kopieer de opdracht.

WarningGebruik het token voor slechts één server. Het identificeert welke server rapporteert. Als twee machines een token delen, schrijven ze naar dezelfde set grafieken en niets detecteert dit — de cijfers vermengen zich, en de melding "server is stil geworden" kan nooit afgaan, omdat welke machine ook nog actief is, voor beide blijft inchecken.

De installatieopdracht uitvoeren

Ubuntu en Debian

Plak de opdracht in een terminal op die server. Het ziet er zo uit:

curl -fsSL https://github.com/InfraNest-Infrastructure-Organized/infranest-agent/releases/latest/download/install.sh \
  | sudo sh -s -- --token sat_YOUR_TOKEN

Getest op Ubuntu 20.04, 22.04 en 24.04, en Debian 11 en 12.

RHEL, Rocky, AlmaLinux, CentOS Stream, Fedora

Exact dezelfde opdracht. Het installatieprogramma downloadt één binaire file en schrijft een systemd-service; er wordt geen pakketbeheerder gebruikt, dus de distributie maakt niet uit zolang deze systemd gebruikt.

Als curl ontbreekt, installeer het eerst met sudo dnf install curl.

Windows Server

Open PowerShell als Administrator en voer uit:

irm https://github.com/InfraNest-Infrastructure-Organized/infranest-agent/releases/latest/download/install.ps1 -OutFile install.ps1
.\install.ps1 -Token sat_YOUR_TOKEN

Getest op Windows Server 2019 en 2022. Hij installeert naar C:\Program Files\InfraNest en draait als een geplande taak met de naam InfraNest agent.

Een server zonder systemd

Alpine, een container, of iets dat OpenRC of runit gebruikt: het installatieprogramma plaatst de binary en het configuratiebestand, en laat je vervolgens weten dat het geen service kon instellen. Voer infranest-agent run uit onder de supervisor die dat systeem gebruikt. De agent verwacht continu te blijven draaien; het is geen eenmalige taak.

Controleren of het werkte

1. In InfraNest: wacht ongeveer een minuut en herlaad de pagina van de server. Geheugen, schijfruimte en gemiddelde belasting beginnen te verschijnen, de dekkingsbadge verandert naar Agent, en eerder grijs weergegeven waarschuwingsregels worden beschikbaar.
2. Op de server, als je liever lokaal controleert, voer je uit:

sudo infranest-agent status

& "C:\Program Files\InfraNest\infranest-agent.exe" status

Het vertelt je of metingen worden aangeleverd en, zo niet, waarom niet. Het antwoordt alleen op basis van wat op de machine staat en neemt geen contact op met iets anders.

Notesudo is nodig omdat het configuratiebestand een credential bevat en alleen leesbaar is voor de gebruiker van de agent zelf. Zonder sudo krijg je een foutmelding over een ontbrekend token in plaats van over rechten.

Lees het script voordat je het uitvoert

Als je het script liever eerst bekijkt, biedt het installatiepaneel dit pad met dezelfde nadruk als de eenregelige opdracht:

curl -fsSLO https://github.com/InfraNest-Infrastructure-Organized/infranest-agent/releases/latest/download/install.sh
sha256sum install.sh        # vergelijk met de checksum die InfraNest toont
less install.sh             # ongeveer 200 regels
sudo sh install.sh --token sat_YOUR_TOKEN

De checksum die naast de opdracht in InfraNest wordt getoond, is degene die bij de release is gepubliceerd, dus het vergelijken ervan is een echte controle. Het script zelf is niet de agent — het downloadt een gebonden binary en verifieert deze tegen de eigen gepubliceerde checksum voordat het deze installeert.

Houd het token buiten je shellgeschiedenis

Een opdrachtregel komt terecht in je shellgeschiedenis en is zichtbaar terwijl deze wordt uitgevoerd. Gebruik op een gedeelde machine in plaats daarvan een tokenbestand:

printf '%s' 'sat_YOUR_TOKEN' | sudo tee /root/token >/dev/null
sudo sh install.sh --token-file /root/token && sudo shred -u /root/token

De agent bijwerken

1. Voer dezelfde installatieopdracht opnieuw uit. Deze vervangt de binary en behoudt je configuratie en token.

InfraNest laat je weten wanneer er een update beschikbaar is: de kaart System van de server toont de agentversie, en de vlootoverzichtstabel markeert servers die een oudere versie draaien.

De agent verwijderen

1. Voer de deïnstallatieopdracht uit voor je systeem:

sudo sh install.sh --uninstall

.\install.ps1 -Uninstall

Dit verwijdert de service, de gebruiker, de binary, de configuratie en de opgeslagen metingen.

WarningHet verwijderen van het token in InfraNest deïnstalleert niets — het zorgt er alleen voor dat metingen niet meer worden geaccepteerd. De agent blijft draaien en het opnieuw proberen op de machine totdat je hem daar verwijdert.

Problemen oplossen

Als niets hiervan past, voer dan uit:

sudo infranest-agent flare

Dit print alles wat nodig is voor een supportgesprek — versie, configuratie, status, wat niet kon worden gelezen — met het token verwijderd. Plak dat in een supportticket in plaats van je configuratiebestand.