Installare la prima sonda

Obiettivo

Installare una sonda Scout singola su una rete, dalla creazione in RECON fino a vederla Online e pronta per la prima scansione interna. Nel video la sonda si chiama magazzino-chiari e analizza la rete del magazzino di Meccanica Adda.

3.42:17

Capitoli del video

Prerequisiti

• Una macchina Linux con systemd, a 64 bit (x86_64 oppure ARM64), dedicata alla sonda e collegata alla rete da analizzare.
• L'accesso root o sudo sulla macchina.
• L'uscita HTTPS sulla porta 443 verso recon.orizon.one.
• Un account RECON con accesso alle scansioni interne.
• Un password manager dove salvare la chiave API della sonda.

Procedura

1. Apri la procedura di installazione

   Nel menu laterale apri Sonde Interne e fai clic su Aggiungi sonda. Lascia selezionata la scheda Installa nuova sonda.

2. Scegli l'azienda

   Al passaggio Azienda seleziona Meccanica Adda tra le aziende salvate, oppure cerca una nuova azienda. Al passaggio Dati azienda i dati sono già compilati: fai clic su Continua.

3. Dai un nome alla sonda e scegli la piattaforma

   Al passaggio Sonda scrivi un nome che dica dove si trova, per esempio magazzino-chiari: lettere minuscole, cifre e trattini, da 3 a 48 caratteri. Se lo lasci vuoto, RECON lo ricava dal nome dell'azienda. In Piattaforma scegli Linux x86_64 (amd64) oppure Linux ARM64, poi fai clic su Crea sonda e genera chiave.

4. Salva la chiave API

   Al passaggio Chiave API RECON mostra la chiave una sola volta. Salvala nel tuo password manager, seleziona Ho salvato questa chiave API in modo sicuro e fai clic su Continua.

5. Copia il comando di installazione

   Al passaggio Installa fai clic su Copia comando. Il comando contiene le credenziali di questa sonda e un token di installazione monouso, valido 24 ore: copialo sempre, non riscriverlo a mano.

6. Esegui il comando sulla macchina

   Sulla macchina Linux, incolla il comando ed eseguilo come root o con sudo. Quando l'installer te lo chiede, scegli Italiano come lingua. L'installer verifica la macchina, scarica il programma della sonda, registra la sonda su RECON e la installa come servizio systemd che parte all'avvio.

7. Conferma in RECON

   Torna in RECON e fai clic su Ho eseguito il comando di installazione. La procedura mostra "In attesa del check-in della sonda...": una volta avviata, la sonda invia il primo heartbeat entro 30 secondi.

8. Completa reti, Active Directory e Fatto

   Dopo il primo heartbeat, al passaggio Reti scegli le reti da analizzare e fai clic su Salva configurazione. Il passaggio Credenziali AD è facoltativo: puoi saltarlo con Salta questo passaggio. Al passaggio Fatto la sonda è pronta e puoi fare clic su Avvia la prima scansione.

Risultato

In Sonde Interne la nuova sonda risulta Online. Se l'hai installata da sola, è una sonda singola, fuori da qualsiasi gruppo.

Sulla macchina puoi controllare lo stato del servizio e il collegamento con RECON:

sudo scout dashboard

Per un controllo rapido senza interfaccia usa invece sudo scout status.

Risoluzione dei problemi

• L'installer dice che il token di installazione è scaduto o già utilizzato. Il token vale 24 ore e si usa una sola volta. In Sonde Interne apri il menu della sonda, scegli Rigenera comando di installazione ed esegui il nuovo comando.
• La procedura resta in attesa del primo heartbeat. Dopo 5 minuti di attesa RECON mostra "Non si è ancora connessa?" con i comandi da eseguire sulla macchina: sudo systemctl status scout e journalctl -u scout -n 50. Controlla anche che la macchina raggiunga recon.orizon.one in HTTPS.
• Hai perso la chiave API. La chiave viene mostrata una sola volta: se la perdi devi ruotarla. Dal menu della sonda scegli Ruota chiave API.
• L'installer non parte. Servono Linux, systemd e root: vedi la guida sulla preparazione della macchina.

Articoli correlati