L'aggiornamento di ArcGIS Notebook Server offre all'organizzazione le funzionalità e i miglioramenti più recenti del software, preservando al contempo i notebook esistenti degli utenti. Se si sta aggiornando la propria distribuzione di ArcGIS Enterprise a 11.5, è necessario aggiornare anche ArcGIS Notebook Server.
Il pacchetto di installazione di ArcGIS Notebook Server 11.5 rileva se si dispone di un'installazione esistente di una versione precedente di ArcGIS Notebook Server sul computer. In tal caso, può aggiornare il software a 11.5.
Durante il processo di aggiornamento è necessario riautorizzare il ArcGIS Notebook Server software per 11.5 se l'aggiornamento è effettuato dalla versione 10.8.1 o precedente.
È inoltre necessario installare nuove immagini contenitore di Esri, fornendo agli utenti i runtime notebook 11.5. I runtime di notebook della versione precedente rimarranno nel sito; gli utenti potranno comunque eseguire i notebook utilizzando tali runtime. Tuttavia, se gli utenti desiderano utilizzare funzionalità nuove della 11.5, devono aggiornare il runtime dei loro notebook. I runtime dei notebook corrispondenti a 11.5 sono alla versione 11.1 (opzioni ArcGIS Notebook Server Standard 11.1 e ArcGIS Notebook Server Advanced 11.1).
Nota:
Se alcuni notebook utilizzavano runtime personalizzati, è necessario creare e registrare nuovamente i runtime personalizzati nel notebook Windows e aggiornare le impostazioni del runtime per gli elementi notebook associati.
Nota:
I runtime dei notebook verranno ritirati in base al ciclo di vita di ArcGIS Enterprise . Un runtime di notebook verrà ritirato contemporaneamente al ritiro della versione di ArcGIS Enterprise associata. I notebook non devono utilizzare i runtime ritirati e devono essere aggiornati a un runtime supportato.
Con l'aggiornamento del portale ArcGIS Enterprise si aggiorneranno anche i notebook campione disponibili nella galleria del sito.
I siti ArcGIS Notebook Server a più computer sono supportati. Se si dispone di un sito con un singolo computer e si desidera espandere il sito di ArcGIS Notebook Server a più computer dopo l'aggiornamento, attenersi alla procedura per aggiungere altri computer al sito dopo aver terminato l'aggiornamento a 11.5.
Il processo di aggiornamento per ArcGIS Notebook Server è un aggiornamento sul posto, che non richiede la disinstallazione e la reinstallazione del software. Il sito sarà inattivo durante il processo di aggiornamento e gli utenti non potranno accedere o eseguire i notebook fino al completamento dell'aggiornamento.
Seguire i seguenti passi per l'aggiornamento di ArcGIS Notebook Server alla 11.5.
Prepararsi all'aggiornamento
Prima di effettuare l'aggiornamento, leggere le informazioni che seguono.
- È possibile accedere a tutti i file necessari in My Esri prima dell'aggiornamento, comprese le immagini del contenitore 11.5.
- Affinché ArcGIS Notebook Server funzioni correttamente, la sua versione deve corrispondere alla versione del portale con cui è federato.
- Se il notebook server attualmente è in modalità di sola lettura, disattivare la modalità prima di iniziare la procedura di aggiornamento.
- Aggiornare Docker alla versione 28.0.1 o successiva.
- Per aggiornare la distribuzione ArcGIS Enterprise, eseguire le seguenti operazioni:
- Aggiornare Portal for ArcGIS.
- Aggiornare ArcGIS Web Adaptor (per portale).
- Aggiornare il sito di ArcGIS Server che funge da server di hosting del portale.
- Aggiornare ArcGIS Web Adaptor (per server).
- AggiornareArcGIS Data Store (aggiornare innanzitutto la principale, quindi la stand-by).
- Aggiornare qualsiasi altro server, tra cui ArcGIS Notebook Server.
- Non disinstallare il tuo ArcGIS Notebook Server esistente . Il setup ArcGIS Notebook Server e gli installatori a riga di comando sono progettati per rilevare e aggiornare un'installazione esistente di componenti ArcGIS Notebook Server.
- Non annullare la federazione del sito di ArcGIS Notebook Server dal portale e non rimuovere la sua designazione come notebook server del portale in nessuna fase durante il processo di aggiornamento. Ciò ha un impatto negativo sui notebook esistenti ospitati dal portale.
- Per aggiornare ArcGIS Notebook Server utilizza il programma di installazione del setup o della linea di comando. Scegli uno di questi metodi per aggiornare.
- Prima di eseguire l'aggiornamento, cancellare le cache di tutti i browser Web utilizzati sul computer ArcGIS Notebook Server.
Spostare la directory del workspace
Questo procedimento è richiesto per le installazioni di ArcGIS Notebook Server su computer singolo su Linux che hanno la directory del workspace nella directory d'installazione del notebook server.
Nota:
Non è necessario effettuare questo passaggio se la directory del workspace si trova già al di fuori della directory d'installazione di Notebook Server.
- Effettuare l'accesso al portale ArcGIS Enterprise come amministratore e aprire ArcGIS Notebook Server Manager.
- Fare clic sulla scheda Impostazioni.
- Fare clic su Directory.
- Stabilire se il percorso attuale alla directory arcgisworkspace si trova nella directory d'installazione di ArcGIS Notebook Server.
<installdir>/arcgis/notebook/directories/arcgisworkspace
Se la directory arcgisworkspace si trova nella directory d'installazione di ArcGIS Notebook Server, è necessario spostare la directory del workspace a una posizione esterna rispetto alla directory d'installazione prima di poter effettuare l'aggiornamento.
Se la directory arcgisworkspace non si trova nella directory d'installazione di ArcGIS Notebook Server, non è necessario eseguire i passaggi rimanenti di questa sezione.
- Fare clic su Modifica per la directory arcgisworkspace.
- Sostituire il valore del percorso esistente della directory con il nuovo percorso per la directory arcgisworkspace che si trova all'esterno della directory d'installazione.
<installdir>/arcgis/arcgisnotebookserver/directories/arcgisworkspace
- Fare clic su Salva.
- Copiare manualmente tutti i contenuti all'interno della directory arcgisworkspace precedente nella nuova directory arcgisworkspace.
Aggiornare la posizione dell'archivio di configurazione
Questa procedura è richiesta per le installazioni di ArcGIS Notebook Server Linux che hanno una directory del workspace nella directory d'installazione diNotebook Server. Vedere Specificare la posizione dell'archivio di configurazione per ulteriori informazioni.
Nota:
Non è necessario effettuare questo passaggio se il sito utilizza un archivio di configurazione basato sul cloud o se l'archivio di configurazione si trova già al di fuori della directory d'installazione di Notebook Server.
- Effettuare l'accesso al portale ArcGIS Enterprise come amministratore e aprire ArcGIS Notebook Server Manager.
- Fare clic sulla scheda Impostazioni.
- Fare clic su Archivio configurazione.
- Controllare se l'archivio configurazione si trova nella directory d'installazione del Notebook Server.
Directory d'esempio: /installation_directory/arcgis/notebookserver/usr/config-store.
- Se l'archivio configurazione si trova nella directory d'installazione di Notebook Server, spostare la configurazione su una posiziona esterna svolgendo i seguenti passaggi:
- Aggiornare il percorso nella nuova posizione.
Directory d'esempio: /installation_directory/arcgisnotebookserver/usr/config-store.
- Fare clic su Sì per spostare la configurazione corrente.
- Fare clic su Salva.
- Aggiornare il percorso nella nuova posizione.
Aggiornare le directory server
Questo processo è richiesto per le installazione di ArcGIS Notebook Server Linux che hanno le directory server nella directory d'installazione di Notebook Server.
Nota:
Non è necessario effettuare questo passaggio se la directory server si trova già al di fuori della directory d'installazione di Notebook Server.
- Effettuare l'accesso al portale ArcGIS Enterprise come amministratore e aprire ArcGIS Notebook Server Manager.
- Fare clic sulla scheda Impostazioni.
- Fare clic su Directory.
- Controllare se le directory arcgisoutput, arcgisjobs e arcgissystem si trovano nella directory d'installazione.
/installation_directory/arcgis/notebookserver/usr/directories
- Se si trovano nella directory d'installazione, eseguire i passaggi seguenti per ciascuna directory.
- Fare clic su Modifica.
- Aggiornare il percorso nella nuova posizione.
Directory d'esempio: /installation_directory/arcgisnotebookserver/usr/directories/<server directory>.
- Fare clic su Salva.
Aggiornare la directory di log
Questo processo è richiesto per le installazioni di ArcGIS Notebook ServerLinux che hanno la directory log nella directory d'installazione di Notebook Server.
Nota:
Non è necessario effettuare questo passaggio se la directory log si trova già al di fuori della directory d'installazione di Notebook Server.
- Effettuare l'accesso al portale ArcGIS Enterprise come amministratore e aprire ArcGIS Notebook Server Manager.
- Fare clic sulla scheda Impostazioni.
- Fare clic su Log.
- Controllare se la directory Log si trova nella directory d'installazione.
/installation_directory/arcgis/notebookserver/usr/directories
- Se si trova nella directory d'installazione eseguire i passaggi seguenti per spostarla in una posizione esterna.
- Aggiornare il percorso nella nuova posizione.
Directory d'esempio: /installation_directory/arcgisnotebookserver/logs.
- Fare clic su Salva.
- Copiare manualmente tutti i contenuti dalla precedente directory Log nella nuova posizione.
- Aggiornare il percorso nella nuova posizione.
Backup dell'installazione
Prima di effettuare l'aggiornamento, si consiglia di effettuare il backup dell'installazione.
Vedere Back up e ripristino ArcGIS Notebook Server per ulteriori informazioni.
Aggiornare l'engine container
Aggiornare l'engine contenitore in una versione supportata.
Nota:
In un sito Notebook Server multi-computer, eseguire questo passaggio su ciascun computer .
Aggiornare mediante il programma di installazione
Nota:
Utilizzare il file di configurazione per aggiornareArcGIS Notebook Server alla versione 11.5. Dopo l'aggiornamento della configurazione, è necessario aggiornare il sitoArcGIS Notebook Server mediante la configurazione guidata o l'utility di aggiornamento del sito.
Se si dispone di un sito con più computer, seguire i passaggi da 1 a 3 per un computer, e ripetere questi passaggi per ogni computer del sito.
ArcGIS Notebook Server è progettato per rilevare e aggiornare un'installazione esistente di componenti di ArcGIS Notebook Server.
Per aggiornare utilizzando il programma d'installazione completare i passaggi che seguono:
- Eseguire ./Setup dalla posizione da cui è stato estratto ArcGIS Notebook Server e seguire i prompt per completare l'aggiornamento.
L'installazione deve essere eseguita come l'account utente che ha installato l'attuale ArcGIS Notebook Server. Durante l'installazione, il programma di configurazione identifica l'installazione attuale e viene richiesto di confermare l'aggiornamento. Immettere la sceltay per procedere con l'installazione.
Questa operazione disinstalla la versione precedente di ArcGIS Notebook Server e installa la versione aggiornata di ArcGIS Notebook Server.
- Dopo che l'utilità di aggiornamento è stata completata, è necessario riautorizzare il software ArcGIS Notebook Server per 11.5. Utilizzare l'autorizzazione guidata software per completare l'autorizzazione.
- Aprire la procedura guidata di configurazione utilizzando l'URL elencato alla fine dell'installazione dell'aggiornamento e seguire le istruzioni sullo schermo per aggiornare il sito.
- Se si dispone di un sito con più computer, seguire i passaggi da 1 a 3 per ogni computer del sito.
Aggiornamento dalla riga di comando
Per aggiornare dalla riga di comando, procedi nel modo seguente:
- Per avviare l'aggiornamento, eseguire ./Setup dalla posizione da cui ArcGIS Notebook Server è stato estratto, con l'argomento illustrato nell'esempio che segue e seguire i prompt per completare l'aggiornamento.
Questa operazione disinstalla la versione precedente di ArcGIS Notebook Server e installa la versione aggiornata di ArcGIS Notebook Server.
<untar directory>/Setup -l yes -m silent - Dopo che l'utilità di aggiornamento è stata completata, è necessario riautorizzare il software ArcGIS Notebook Server per 11.5. Eseguire l'autorizzazione del software con la seguente sintassi per autorizzare ArcGIS Notebook Server in modalità silenziosa:
<ArcGIS Notebook Server install directory>/tools/authorizeSoftwareEseguire il seguente comando per visualizzare tutte le opzioni di autorizzazione:
<ArcGIS Notebook Server install directory>/tools/authorizeSoftware --helpNota:
Consultare la sezione Autorizzare in un ambiente disconnesso per informazioni su come autorizzare le installazioni di ArcGIS Notebook Server in un ambiente disconnesso. - Aggiornare il sito tramite l'utilità da riga di comando upgradesite.
Questa utilità ha due parametri:
- -s - Quando è inclusa nel comando, richiede all'utilità di eseguire l'aggiornamento. L'aggiornamento non funzionerà senza -s. In questo modo si vuole garantire che l'aggiornamento venga eseguito solo quando si è pronti.
- -h - Visualizza la guida relativa allo strumento. Quando il comando viene eseguito senza -s, viene visualizzata anche la guida.
Per impostazione predefinita l'utilità upgradesite si trova in ${HOME}/arcgis/notebookserver/tools/upgradesiteutility/upgradesite.sh.
Prima di aggiornare, rivedere le informazioni di preparazione all'inizio di questo argomento. Quando si è pronti per l'aggiornamento, aprire un terminale di comando sul computer che si sta aggiornando. Sfogliare la directory dove si trova l'utilità ed eseguire il seguente comando:
> ./upgradesite.sh -sL'utilità visualizza i report di avanzamento e si fermerà al termine dell'aggiornamento.
- Se si dispone di un sito con più computer, seguire i passaggi da 1 a 3 per ogni computer del sito, quindi continuare i passaggi nella sezione successiva.
Autorizzare in modalità silenziosa
Dopo che l'utilità di aggiornamento è stata completata, è necessario riautorizzare il software ArcGIS Notebook Server per la versione 11.5.
Eseguire l'autorizzazione del software con la seguente sintassi per autorizzareArcGIS Notebook Server in modalità silenziosa:<ArcGIS Notebook Server install directory>/tools/authorizeSoftware<ArcGIS Notebook Server install directory>/tools/authorizeSoftware --help
Autorizzare in un ambiente disconnesso
È possibile autorizzareArcGIS Notebook Server in un ambiente disconnesso utilizzando un file di provisioning (.prvc). Durante il processo, viene generato un file da inviare a Esri per completare il processo.
- Al prompt, eseguire il comando fornito di seguito al termine dell'aggiornamento di ArcGIS Notebook Server:
<ArcGIS Notebook Server installation directory>/tools/authorizeSoftware -f <full path to the .prvc file> -o <full path to authorization file output> - Una volta creato il file di informazioni di output, eseguire una delle seguenti operazioni:
- Passare al sito self service Esri. Attenersi alle istruzioni visualizzate per caricare il file delle informazioni di autorizzazione e scaricare il file di autorizzazione .ecp.
- Inviare il file di informazioni di autorizzazione via e-mail a authorize@esri.com. Esriinvierà il file di autorizzazione .ecp in un'e-mail.
- Quando si riceve il file di autorizzazione .ecp con uno dei metodi sopra indicati, eseguire nuovamente lo script authorizeSoftware per elaborarlo e completare il processo di autorizzazione del server:
<ArcGIS Notebook Server installation directory>/tools/authorizeSoftware -f <full path to the .ecp file>
Ripetere questo flusso di lavoro per ogni computer con ArcGIS Notebook Server in funzione.
Procedura dopo l'aggiornamento
Prima di poter utilizzare il sito di ArcGIS Notebook Server aggiornato e riautorizzato, è necessario eseguire l'utilità di post-installazione per aggiungere le nuove immagini del contenitore di Docker al sito. È inoltre necessario sostituire le istanze di ArcGIS Web Adaptor registrate sul proprio sito per farle corrispondere alla nuova versione.
Eseguire l'utilità di post-installazione
Per eseguire l'utilità di post-installazione, procedi nel modo seguente:
- Aprire un terminale utilizzando l'account di installazione di ArcGIS Notebook Server.
- Cambiare le directory nella cartella degli strumenti di ArcGIS Notebook Server. Per impostazione predefinita, questo percorso è ${HOME}/arcgis/notebookserver/tools/postInstallUtility.
- n alternativa, si può fare riferimento alla guida dell'utilità eseguendo il seguente comando: ./PostInstallUtility.sh -h
- ArcGIS Notebook Server richiede l'installazione di Docker Engine sul computer. Determinare se Docker è attivo sul proprio computer eseguendo il seguente comando: ./PostInstallUtility.sh -d
- Se i requisiti di installazione di Docker non sono soddisfatti, installarlo ora.
- Installare l'immagine Notebooks specificando il suo percorso file. L'immagine dovrebbe essere compressa nel formato .tar.gz. Se di dispone di una licenza Avanzata e Docker Desktop, eseguire il comando due volte per installare le immagini dei contenitori Standard e Avanzato scaricate da My Esri.
Nota:
Verificare che sul computer siano disponibili almeno 75 GB di spazio libero.
Eseguire il seguente comando per confermare: ./PostInstallUtility.sh -l <path of .tar.gz Docker image>
Nota:
Assicurarsi di installare entrambe le immagini del contenitore. Anche se si dispone della licenza Avanzata, gli utenti potrebbero avere comunque bisogno di utilizzare il runtime Standard.
Nota:
Le immagini più vecchie non sono rimosse automaticamente. È necessario aggiornare manualmente i runtime associati con ciascun notebook alla versione più recente prima di eliminare le immagini del runtime precedente.
Sostituire le istanze ArcGIS Web Adaptor
Per sostituire le istanze di ArcGIS Web Adaptor, procedi nel modo seguente:
- Annullare la registrazione dell'istanza precedente di ArcGIS Web Adaptor dal sito e disinstallarla.
- Effettuare l'accesso adArcGIS Notebook Server Administrator Directory.
- Andare a Sistema > Adattatori Web > computer registrato.
- Fare clic su Annulla registrazione Web Adaptor.
- Installare una nuova istanza di ArcGIS Web Adaptor11.5 e configurarla con ArcGIS Notebook Server.
- Se si esegue l'aggiornamento dalla 10.8 o versione precedente, per abilitare la programmazione dei notebook nel portale, eseguire le seguenti operazioni:
- Facoltativamente, aggiornare i ruoli personalizzati che includono i privilegi dei notebook per aggiungere il nuovo privilegio Pianifica notebook.
- Informare gli autori dei notebook che è necessario aggiornare il runtime di ciascuno dei loro notebook se desiderano utilizzare la funzionalità di programmazione.
Solo i notebook che utilizzano il runtime 10.8.1 (versione 4.0) o versione precedente possono essere programmati.
Il sito ArcGIS Notebook Server 11.5 è ora pronto per ospitare ArcGIS Notebooks.
Aggiornare i runtime dei notebook e degli strumenti Web esistenti
Questa procedura deve essere svolta da ciascun autore di appunti per aggiornare i propri appunti e gli strumenti Web dei notebook per usare i runtime notebook più recenti.
- Applicare i passaggi in Cambiare un runtime notebook per aggiornare il runtime di ciascun elemento notebook al runtime notebook più recente.
- Se un notebook è pubblicato come uno strumento Web, sovrascrivere lo strumento Web dopo l'aggiornamento del runtime notebook.
- Se alcuni notebook eseguivano runtime personalizzati, aggiornare il runtime personalizzato e aggiornare le impostazioni del runtime per gli elementi notebook associati.
Eliminare i precedenti runtime notebook
In alternativa, è possibile rimuovere le versioni precedente dell'immagine runtime ArcGIS Notebook Server per liberare spazio su disco.
Attenzione:
Assicurarsi che tutti i notebook esistenti siano stati aggiornati per utilizzare la versione più recente dell'immagine runtime di ArcGIS Notebook Server prima di rimuovere le versioni precedenti.
- Apri un prompt dei comandi come amministratore.
- Immettere il seguente comando per vedere l'elenco delle immagini correnti e annotare l'IMAGE ID della versione precedente che si desidera rimuovere.
docker images -a - Immettere il seguente comando per rimuovere la versione runtime precedente.
docker image rm <IMAGE ID>