Obsolens kennisbank Naar het portaal
Kennisbank › De collector plaatsen

Installeren op Linux

Zo installeer je de collector op Linux met één regel uit het portaal. Ook lees je hoe je controleert je dat hij draait.

Met één regel in een terminal download je de collector, koppel je hem aan de locatie en installeer je hem als systemd-dienst. Binnen een minuut staat hij als online in het portaal.

Wat je nodig hebt

  • Een Linux-computer met systemd op x86_64 of ARM64, bijvoorbeeld Ubuntu Server 24.04 LTS, Debian, RHEL of Raspberry Pi OS (64-bits).
  • Een gebruiker met sudo-rechten.
  • curl of wget en sha256sum (pakket coreutils). Op de meeste distributies zijn die er al.
  • Uitgaand HTTPS naar het portaal.

Installeren

  1. Open in het portaal de klant en ga naar de locatie. Kies Collector toevoegen (of de knop Collector als er al een collector staat).

  2. Kies het tabblad Linux. Het portaal toont een regel met het serveradres en een eenmalige koppelcode.

  3. Kies Kopiëren en plak de regel in een terminal op de computer. Hij ziet er zo uit:

    curl -fsSL https://portal.obsolens.com/downloads/install-collector.sh | sudo sh -s -- https://portal.obsolens.com eole_...

  4. Vul je sudo-wachtwoord in.

  5. Wacht tot het script Klaar meldt. In het portaal verschijnt Gekoppeld; het installatievenster kijkt zelf mee.

De koppelcode werkt 24 uur en maar één keer. Is hij verlopen of al gebruikt, kies dan Nieuwe code maken.

Wat het script doet

Het script toont elke stap met ==>:

  1. Collector downloaden: het kiest het programma voor de processor (x86_64 of arm64), downloadt het van het portaal en controleert het met SHA256SUMS. Je ziet gecontroleerd met SHA256SUMS.
  2. Koppelen aan de locatie: de collector meldt zich met de koppelcode aan en bewaart zijn eigen sleutel in /etc/obsolens/collector.json. Die map is alleen voor root.
  3. Installeren als service: het programma komt in /usr/local/bin/obsolens-collector en de dienst obsolens-collector wordt aangezet en gestart. Een collector die al draaide, wordt eerst gestopt.
  4. Controle: het script draait diagnose, die de verbinding met het platform stap voor stap test.

Gaat een stap mis, dan stopt het script met [FOUT] en een uitleg. Zie Installeren of koppelen mislukt.

Achter een proxy

Zet de proxy als derde argument achter de koppelcode:

curl -fsSL https://portal.obsolens.com/downloads/install-collector.sh | sudo sh -s -- https://portal.obsolens.com eole_... http://proxy.klant.local:3128

De collector gebruikt die proxy voor alle verbindingen met het platform. Meer over proxy's en SSL-inspectie lees je in Uitgaande verbinding, proxy en SSL-inspectie.

Controleren

systemctl status obsolens-collector
journalctl -u obsolens-collector -f
sudo /usr/local/bin/obsolens-collector diagnose

In het logboek zie je bij de start collector service started en daarna een regel per scan. In het portaal staat de collector bij de locatie met zijn hostnaam, versie en IP-adres.

Opnieuw installeren

Draai je de regel opnieuw met een nieuwe code, dan vervangt hij de vorige installatie op die computer. De collector krijgt dan een nieuwe koppeling; de oude blijft als offline in het portaal staan. Wil je alleen bijwerken, gebruik dan de opdracht met upgrade uit Collector bijwerken.

Zie ook