De serveragent stap voor stap installeren

Installeer de InfraNest-agent op een server om geheugen, schijfruimte en belastingsgemiddelde te gaan verzamelen, en om waarschuwingsregels te ontgrendelen die de agent vereisen. Dit artikel is bedoeld voor iedereen die een server inricht die al aan InfraNest is toegevoegd.

Overzicht

• Duurt ongeveer twee minuten per server.
• Je hebt eenmalig beheerderstoegang tot de server nodig, alleen om te installeren — de agent draait daarna niet als beheerder.
• De server heeft alleen uitgaande toegang op poort 443 nodig. Er hoeft niets naar de server toe geopend te worden en geen enkele firewallregel hoeft te veranderen.

Als je eerst wilt begrijpen wat de agent verzamelt en waarom, voordat je hem installeert, lees dan eerst Geheugen, schijfruimte en belasting ophalen met de agent. Dit artikel gaat ervan uit dat je klaar bent om te beginnen.

Voordat je begint

Je hebt drie dingen nodig:

1. Een server in InfraNest. Staat deze er nog niet, voeg hem dan toe onder Infrastructuur → Servers.
2. Beheerderstoegang tot die server — sudo op Linux, een PowerShell als Administrator op Windows.
3. De server moet het internet kunnen bereiken op poort 443, alleen uitgaand.

Je hoeft geen poort te openen, geen pakketbeheerder-repository te installeren, en InfraNest geen toegang tot de machine te geven.

De installatieopdracht ophalen

1. Kies Install the agent — je vindt dit bij de rij van de server onder Monitoring → Servers, in het menu Acties van de server, of naast een waarschuwingsregel die grijs is weergegeven omdat deze de agent vereist. Alle drie openen hetzelfde venster.
2. Er wordt niets gevraagd: het token wordt meteen aangemaakt. Daarna toont de tokenlijst wie elk token 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 jouw systeem en kopieer de opdracht.

WarningGebruik elk token voor slechts één server. Het token identificeert welke server rapporteert. Als twee machines hetzelfde token delen, versmelten hun metingen tot één set grafieken en merkt niets dit op — de melding “server rapporteert niet meer” kan dan nooit afgaan, omdat de machine die nog actief is, voor beide blijft inchecken.

De installatieopdracht uitvoeren

Ubuntu en Debian

Plak de opdracht in een terminal op de server:

curl -fsSL https://get.infranest.io/agent.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 binary en zet er een service voor op, dus de distributie maakt niet uit. Ontbreekt curl, installeer het dan eerst met sudo dnf install curl.

Windows Server

Open PowerShell als Administrator en voer uit:

irm https://get.infranest.io/agent.ps1 -OutFile install.ps1
.\install.ps1 -Token sat_YOUR_TOKEN

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

Een server zonder systemd

Alpine, Gentoo en Artix (OpenRC) en Void (runit) worden automatisch ingericht met agentversie 0.14 of nieuwer — het installatieprogramma voegt de agent toe als service die bij het opstarten start en herstart als deze stopt. Op Alpine staat het logbestand in /var/log/infranest-agent.log.

Voor al het overige — een container, of een systeem dat s6 gebruikt — plaatst het installatieprogramma de binary en het configuratiebestand, en meldt vervolgens dat er geen service kon worden opgezet. Voer infranest-agent run uit als de gebruiker infranest-agent onder welke supervisor dat systeem dan ook gebruikt.

Controleren of het gelukt is

1. Wacht in InfraNest ongeveer een minuut en herlaad de serverpagina. Geheugen, schijfruimte en belastingsgemiddelde beginnen zich te vullen, de dekkingsbadge verandert in Agent, en de grijs weergegeven waarschuwingsregels worden beschikbaar.
2. Wil je liever lokaal controleren, voer dan op de server het volgende uit:

sudo infranest-agent status

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

Dit laat zien of er metingen worden aangeleverd en, zo niet, waarom. Het leest alleen gegevens van de machine en neemt met niets anders contact op.

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

Liever eerst het script lezen voordat je het uitvoert?

Dat is een redelijke aanpak, en het installatievenster biedt deze optie even prominent als de ene regel-opdracht.

curl -fsSL -o install.sh https://get.infranest.io/agent.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 InfraNest naast de opdracht toont, is dezelfde als die bij de release is gepubliceerd, dus het vergelijken ervan is een echte controle. Het script zelf is niet de agent — het downloadt een binary met versienummer en verifieert deze tegen de eigen gepubliceerde checksum voordat het wordt geïnstalleerd.

Controleren wie het gebouwd heeft

Een checksum bewijst dat de download ongeschonden is aangekomen, niet dat deze van InfraNest afkomstig is. Elke release bevat ook een ondertekend bewijs van welke build hem heeft geproduceerd. Heeft de server al de GitHub CLI (gh) of cosign geïnstalleerd, dan controleert het installatieprogramma dit bewijs automatisch — het toont built by …/release.yml als het klopt, en weigert alles te installeren wat niet overeenkomt. Is geen van beide tools geïnstalleerd, dan meldt het dit en gaat gewoon verder.

Om een gedownloade binary handmatig te controleren, zonder dat een GitHub-account nodig is:

V=$(curl -fsSL https://get.infranest.io/releases/latest)
curl -fsSLO https://get.infranest.io/releases/download/$V/infranest-agent_linux_amd64
curl -fsSLO https://get.infranest.io/releases/download/$V/infranest-agent.sigstore.json
gh attestation verify infranest-agent_linux_amd64 \
  --repo InfraNest-Infrastructure-Organized/infranest-agent \
  --signer-workflow InfraNest-Infrastructure-Organized/infranest-agent/.github/workflows/release.yml \
  --bundle infranest-agent.sigstore.json

Pas linux_amd64 aan naar jouw server (linux_arm64 voor ARM). Releases van vóór de invoering hiervan bevatten geen ondertekend bewijsbestand.

Het token buiten je shellgeschiedenis houden

Een opdrachtregel komt terecht in ~/.bash_history en is zichtbaar terwijl deze draait. Gebruik op een gedeelde machine liever een bestand:

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

InfraNest laat je weten wanneer er een update beschikbaar is: de kaart System van de server toont de agentversie, en in het serveroverzicht krijgen servers met een oudere versie een badge update. Klik op een van beide en InfraNest toont de opdracht die je moet uitvoeren, klaar om te kopiëren.

Op Linux:

curl -fsSL https://get.infranest.io/agent.sh | sudo sh -s -- --upgrade

Op Windows, in een PowerShell als Administrator:

irm https://get.infranest.io/agent.ps1 -OutFile install.ps1
.\install.ps1 -Upgrade

Dit downloadt de nieuwe versie, controleert deze en herstart de agent. Er is geen token voor nodig, en je instellingen blijven precies zoals ze waren — had je procesrapportage ingeschakeld, dan blijft dat zo.

Een badge met security in plaats van update betekent dat de versie op die server ouder is dan de oudste nog ondersteunde versie. De opdracht is dezelfde; doe dit snel.

WarningWerk niet bij door je oorspronkelijke installatieopdracht opnieuw uit te voeren. Dat is een nieuwe installatie: er is dan een token voor nodig, en de instellingen van de agent worden teruggezet naar de standaardwaarden.

De agent verwijderen

sudo sh install.sh --uninstall

.\install.ps1 -Uninstall

Dit verwijdert de service, de gebruiker, de binary, de configuratie en de opgeslagen metingen. Het verwijderen van het token in InfraNest deïnstalleert niets — het zorgt er alleen voor dat metingen niet meer worden geaccepteerd, en de agent blijft draaien en het blijven proberen totdat deze van de machine wordt verwijderd.

Problemen oplossen

Past niets hiervan? Voer dan uit:

sudo infranest-agent flare

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

Werkte de agent eerst wel en rapporteert deze sindsdien niet meer, zie dan Een server rapporteert niet meer.

Tips

TipVoer sudo infranest-agent status uit op elk moment dat je twijfelt of de agent rapporteert — dit geeft lokaal antwoord en neemt met niets contact op.