Documentazione

NadiaOS

Distribuisci Nadia come macchina virtuale pronta su VMware, Proxmox o Hyper-V, apri il suo schermo da un browser e aggiornala.

NadiaOS è una macchina virtuale pronta, con Nadia già installata. Nadia è dove lavorano gli agenti della tua azienda: rispondono ai clienti e svolgono i lavori programmati. Invece di installarla su un computer che resta in azienda, chi si occupa delle macchine dell'azienda distribuisce NadiaOS su VMware, Proxmox o Hyper-V, e Nadia si avvia da sola. Quella macchina è poi l'installazione dell'azienda, dove lavorano Nadia e i suoi agenti.

Che cos'è NadiaOS

  • Un solo file, uguale per ogni azienda: Debian 13 con Nadia installata, senza niente da installare dopo l'avvio.
  • La stessa macchina in tre formati: .ova per VMware ESXi e vSphere, .qcow2 per Proxmox e KVM, .vhdx per Hyper-V.
  • Le sue impostazioni, date una volta sola quando la distribuisci: il nome della macchina, la sua rete, la chiave SSH o la password dell'amministratore e la password dello schermo.
  • Lo schermo di Nadia: la macchina mostra la finestra di Nadia sulla propria console. Se dai una password dello schermo, chi la conosce vede e usa quello stesso schermo da un browser.

Scegli NadiaOS

Scegli NadiaOS per far funzionare Nadia su una macchina virtuale nell'infrastruttura della tua azienda. Le immagini funzionano su:

  • VMware ESXi 6.5 o successivo, come macchina con 4 vCPU e 6 GB di memoria.
  • Proxmox VE o KVM.
  • Hyper-V, come macchina di generazione 1.

Al primo avvio la macchina crea le proprie chiavi host SSH e il proprio certificato, e al suo primo avvio Nadia crea la propria installazione. Dalla rete la macchina accetta solo SSH e HTTPS.

Scarica NadiaOS

  1. Nel Portale, apri Scarica le app.
  2. Nella sezione di Nadia, sotto NadiaOS, scegli VMware per il file .ova, Proxmox per il file .qcow2, che va bene anche per KVM, o Hyper-V per il file .vhdx.

Distribuisci su VMware

Su ESXi e vSphere, la procedura guidata di distribuzione chiede le impostazioni della macchina. Le loro voci sono in inglese.

  1. Scegli Deploy OVF Template, poi il file .ova.
  2. Compila le impostazioni:
    • Machine name: il nome della macchina in rete, nadia se non lo cambi.
    • IP address: un indirizzo fisso con il suo prefisso, come 192.168.1.20/24. Lascialo vuoto per prendere un indirizzo con DHCP.
    • Gateway e DNS servers: per un indirizzo fisso. Lasciali vuoti con DHCP.
    • Administrator SSH key: una chiave pubblica OpenSSH per l'amministratore, nadiaos. Con una chiave, SSH accetta solo la chiave.
    • Administrator password: la password di nadiaos per SSH quando non dai una chiave SSH. Lasciala vuota quando dai una chiave.
    • Screen password: la password che apre lo schermo di Nadia nel browser.
  3. Concludi la procedura e avvia la macchina.

Dai all'amministratore una chiave SSH o una password. Una password deve avere almeno 8 caratteri. vSphere conserva queste risposte nelle impostazioni della macchina, dove i suoi amministratori possono leggerle.

Distribuisci su Proxmox o Hyper-V

Su Proxmox, KVM e Hyper-V, la macchina prende le impostazioni da un CD al primo avvio.

  1. Prepara un'immagine ISO che abbia nella radice ovf-env.xml: un ambiente OVF con ogni impostazione sotto la sua chiave, le stesse impostazioni che chiede la procedura di VMware:
    • Machine name: nadiaos.hostname
    • IP address, Gateway e DNS servers: nadiaos.address, nadiaos.gateway e nadiaos.dns
    • Administrator password: nadiaos.admin_password
    • Administrator SSH key: nadiaos.admin_ssh_key
    • Screen password: nadiaos.screen_password
  2. Crea la macchina:
    • Su Proxmox o KVM, importa il file .qcow2 come disco di una macchina con SeaBIOS, un controller virtio-scsi e una scheda di rete virtio.
    • Su Hyper-V, crea una macchina di generazione 1 con il file .vhdx come disco.
  3. Collega l'immagine ISO come CD della macchina, poi avvia la macchina.

Senza una password dello schermo, lo schermo di Nadia non si apre nel browser. Una macchina avviata senza impostazioni prende un indirizzo con DHCP, mantiene il nome nadia e non offre accesso remoto: la sua console mostra Nadia, e cerca di nuovo le impostazioni al riavvio successivo.

Apri lo schermo di Nadia

  1. In un browser, apri https:// seguito dall'indirizzo della macchina.
  2. Il browser avvisa del certificato, perché la macchina se l'è creato da sé. Prosegui verso la pagina.
  3. Scrivi la password dello schermo. Il browser chiede anche un nome utente, che non viene controllato.
  4. Compare la finestra di Nadia. Al suo primo avvio, fai clic su Accedi: il Portale si apre sullo stesso schermo. Lì accedi come spiega Avvio e accesso.

Aggiorna Nadia

Gli aggiornamenti di sicurezza di Debian si installano da soli. Le nuove versioni di Nadia arrivano con gli aggiornamenti di sistema della macchina, che installa l'amministratore.

  1. Collegati alla macchina con SSH come nadiaos.
  2. Esegui sudo apt update && sudo apt upgrade.
  3. Esci da Nadia dalla sua finestra. Si riavvia con la nuova versione dopo pochi secondi.