> ## Documentation Index > Fetch the complete documentation index at: https://docs.devin.ai/llms.txt > Use this file to discover all available pages before exploring further. # Aggiornare Devin Desktop e CLI in ambienti air-gapped > Come le nuove versioni air-gapped di Devin Desktop e CLI vengono pubblicate nella pagina dei download del portale e come verificare, installare e convalidare un aggiornamento in assenza di aggiornamento automatico. > [!NOTE] > > Questa documentazione riguarda le distribuzioni di Devin per il governo federale. [Torna alla documentazione di Devin](/it/get-started/devin-intro) Le versioni air-gapped di Desktop e CLI non si aggiornano mai in autonomia: l'aggiornamento automatico è disabilitato nella build di Desktop e `devin update` è disabilitato nella CLI. Ogni aggiornamento è un nuovo bundle da scaricare dal portale, verificare e installare su ciascuna workstation, seguendo la stessa procedura della prima [installazione](/it/federal/air-gapped/install). Questa pagina illustra cosa cambia rispetto alla prima volta. *** ## Come appare una nuova versione La pagina **Install → Air-gapped downloads** del portale ([`windsurf.fedstart.com/install/airgap`](https://windsurf.fedstart.com/install/airgap)) rende disponibile un solo rilascio alla volta. La versione è indicata nell'intestazione **Downloads** (ad esempio `version 1.66.101 (0123abcdef)`), mentre il checksum SHA-256 di ciascun file si può visualizzare tramite il controllo **Show checksum** accanto al file. Quando Cognition pubblica una nuova build air-gapped sul tuo portale, la pagina inizia a distribuire la nuova versione e i relativi checksum al posto dei precedenti; non è previsto alcun selettore di versione né viene inviata alcuna notifica. Per monitorare i rilasci, verifica l'etichetta della versione nella pagina dei download nell'ambito del tuo normale ciclo di manutenzione. ## Passaggio 1: Verifica la versione in esecuzione Su una workstation, confronta la versione della CLI installata con quella riportata nella pagina dei download: ```sh theme={null} devin --version ``` ```text theme={null} devin-federal +airgap. ``` `devin --version` mostra la versione del rilascio e l'hash breve del commit della build. Desktop e la CLI inclusa vengono compilati a partire dallo stesso commit, quindi questa versione vale per entrambi. ## Passaggio 2: Scarica e verifica il nuovo bundle Segui il [Passaggio 1](/it/federal/air-gapped/install#step-1-download-the-bundle-from-the-portal) e il [Passaggio 2](/it/federal/air-gapped/install#step-2-verify-the-checksum) della guida all'installazione per la nuova versione: scarica il package per ogni piattaforma presente nella tua infrastruttura, annota il checksum riportato nella pagina del portale, trasferisci i file attraverso l'air gap e verifica che lo SHA-256 corrisponda prima di procedere con l'installazione. I checksum cambiano a ogni rilascio. Al momento del download, annota il nuovo valore riportato nella pagina del portale; non riutilizzare il checksum di una versione precedente. ## Passaggio 3: Installare sopra la versione esistente Prima di tutto, chiudi Desktop e interrompi tutte le sessioni `devin` in esecuzione sulla workstation. La configurazione, la cronologia delle sessioni, il registro di audit e gli accessi SSO sono archiviati all'esterno dell'applicazione (vedi [Formati su disco](/it/federal/air-gapped/on-disk-formats)) e vengono mantenuti durante l'aggiornamento. **macOS** Apri il nuovo `.dmg` e trascina **Devin - Airgap** in `/Applications`, sostituendo l'applicazione esistente quando richiesto. Verifica quindi la firma come descritto nel [Passaggio 3 della guida all'installazione](/it/federal/air-gapped/install#step-3-install): ```sh theme={null} spctl --assess --type execute --verbose "/Applications/Devin - Airgap.app" ``` ```text theme={null} /Applications/Devin - Airgap.app: accepted source=Notarized Developer ID ``` **Linux (.deb / .rpm)** ```sh theme={null} sudo dpkg -i Devin-linux-x64-.deb # Debian/Ubuntu sudo rpm -U Devin-linux-x64-.rpm # RHEL/Fedora ``` `dpkg -i` aggiorna direttamente un package già installato; usa `rpm -U` (non `rpm -i`) affinché `rpm` sostituisca la versione installata anziché rifiutare l'installazione. Per le build air-gapped non è disponibile alcun repository apt o yum. **Linux (.tar.gz)** Sposta altrove la cartella estratta in precedenza, quindi estrai il nuovo archivio nella stessa posizione, così che il percorso del launcher (`/opt/Devin-linux-x64/bin/devin-airgap`) ed eventuali voci `PATH` per il binario `devin` incluso restino validi: ```sh theme={null} sudo mv /opt/Devin-linux-x64 /opt/Devin-linux-x64.previous sudo tar -xzf Devin-linux-x64-.tar.gz -C /opt ``` Rimuovi `/opt/Devin-linux-x64.previous` dopo aver convalidato la nuova versione. **Windows (installer)** Verifica la firma Authenticode del nuovo programma di installazione come descritto nel [Passaggio 3 della guida all'installazione](/it/federal/air-gapped/install#step-3-install), quindi eseguilo come amministratore: ```powershell theme={null} Get-AuthenticodeSignature .\DevinSetup-x64-.exe | Format-List Status, SignerCertificate ``` La build air-gapped non dispone di un URL di aggiornamento: l'unico modo per aggiornare una copia installata è usare un nuovo programma di installazione. **Windows (.zip)** Decomprimi `Devin-win32-x64-.zip` in una cartella dedicata, verifica la firma degli eseguibili estratti come descritto nel [Passaggio 3 della guida all'installazione](/it/federal/air-gapped/install#step-3-install) ed esegui Desktop dalla nuova cartella. Rimuovi la cartella precedente dopo aver convalidato la nuova versione e aggiorna eventuali voci `PATH` relative al `devin.exe` incluso. Il file di licenza, il file dei modelli e il file di autenticazione in `/etc/devin/` (`C:\ProgramData\Devin\` su Windows) non fanno parte del package e non vengono modificati dall'aggiornamento. ## Passaggio 4: Verificare l'aggiornamento Su ciascuna workstation aggiornata, esegui come utente standard: ```sh theme={null} devin --version devin airgap doctor ``` ```text theme={null} devin-federal +airgap. pass license seat alice@example.gov (account acme), expires 2027-03-01 ... 10 check(s): 10 passed, 0 warning(s), 0 failure(s) ``` Quindi avvia Desktop una volta e verifica che apra una sessione sul tuo endpoint del modello. Due errori tipici dell'aggiornamento a cui prestare attenzione: | Sintomo | Causa | Azione | | - | - | - | | `LIC004` subito dopo l'aggiornamento | La nuova build incorpora un set rinnovato di chiavi pubbliche e la tua licenza è stata firmata con una chiave che la build non considera più attendibile. | Emetti una nuova licenza dal portale e sostituisci il file come descritto in [Rinnovare o sostituire una licenza](/it/federal/air-gapped/license#renew-or-replace-a-license). Esegui la [verifica del `kid`](/it/federal/air-gapped/license#check-the-key-id) per conferma. | | Un codice `MDL` su un file dei modelli che in precedenza superava la convalida | Il nuovo rilascio ha modificato la convalida del file dei modelli. | Esegui `devin models validate`: la diagnostica indica il campo e il codice. Consulta [File dei modelli](/it/federal/air-gapped/models-file). | Ogni record di audit `session_start` include il campo `cli_version`, così il tuo SIEM può confermare il rollout: le sessioni provenienti da una workstation aggiornata riportano la nuova versione. ## Rollback Conserva il package e il checksum della versione precedente finché la nuova versione non è stata convalidata su tutto il parco macchine. Il rollback segue la stessa procedura dell'installazione: verifica il checksum del package precedente e installalo sopra quello più recente. Sui sistemi RPM aggiungi `--oldpackage`, perché altrimenti `rpm -U` si rifiuta di sostituire una versione più recente con una precedente: ```sh theme={null} sudo rpm -U --oldpackage Devin-linux-x64-.rpm ``` ## Note di rilascio Le note di rilascio per le build air-gapped vengono pubblicate insieme alle altre note di rilascio di Devin in [Aggiornamenti recenti](/it/release-notes/overview). Prima di distribuire una nuova versione, leggi la voce corrispondente e verifica in particolare eventuali modifiche ai formati su disco o allo schema dei log di audit (il valore `schema_version`), codici di errore nuovi o modificati ed eventuali rotazioni della chiave di licenza che richiedano la riemissione delle licenze. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.