Aggiornare ArcGIS Notebook Server

L'aggiornamento di ArcGIS Notebook Server offre all'organizzazione le funzionalità e i miglioramenti più recenti del software, preservando al contempo ArcGIS Notebooks esistenti degli utenti. Se si sta aggiornando la propria distribuzione di ArcGIS Enterprise a 10.8.1, è necessario aggiornare anche ArcGIS Notebook Server.

Il pacchetto di installazione di ArcGIS Notebook Server 10.8.1 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 10.8.1.

Durante il processo di aggiornamento, è necessario riautorizzare il software ArcGIS Notebook Server per la versione 10.8.1 se si è effettuato l'aggiornamento dalla 10.7.1 o da una versione precedente. Non è necessario riautorizzare il software se si sta eseguendo l'aggiornamento dalla 10.8 a 10.8.1.

È inoltre necessario installare nuove immagini del contenitore di Esri, fornendo agli utenti i runtime notebook della 10.8.1. I runtime 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 10.8.1, devono aggiornare il runtime dei loro notebook. I runtime dei notebook corrispondenti alla 10.8.1 sono alla versione 4.0 (ArcGIS Notebook Server Standard 4.0 e ArcGIS Notebook Server Avanzato 4.0).

Con l'aggiornamento del portale ArcGIS Enterprise si aggiorneranno anche i notebook campione disponibili nella galleria del sito.

I siti ArcGIS Notebook Server con più computer sono supportati nella versione 10.7.1 e successive. Se si dispone di un sito con una solo computer e si desidera espandere il sito ArcGIS Notebook Server a più computer dopo l'aggiornamento, attenersi alla procedura per aggiungere altri computer al sito dopo aver terminato l'aggiornamento a 10.8.1.

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 10.8.1.

Prepararsi all'aggiornamento

Prima di effettuare l'aggiornamento, leggere con attenzione le informazioni seguenti.

• È possibile accedere a tutti i file necessari in My Esri prima dell'aggiornamento, comprese le immagini del contenitore di 10.8.1.
• Affinché ArcGIS Notebook Server funzioni correttamente, la sua versione deve corrispondere alla versione del portale con cui è federato.
• Per aggiornare la distribuzione ArcGIS Enterprise, eseguire le seguenti operazioni:
  1. Aggiornare Portal for ArcGIS.
  2. Aggiornare ArcGIS Web Adaptor (for Portal).
  3. Aggiornare il sito ArcGIS Server che funge da server di hosting del portale.
  4. Aggiornare ArcGIS Web Adaptor (for Server).
  5. Aggiornare ArcGIS Data Store (aggiornare innanzitutto la principale, quindi la stand-by).
  6. Aggiornare qualsiasi altro server, tra cui ArcGIS Notebook Server.
• Non disinstallare l'esistente ArcGIS Notebook Server. Il setup ArcGIS Notebook Server e gli installatori della linea 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 nessun punto durante il processo di aggiornamento. Ciò ha un impatto negativo su ArcGIS Notebooks esistenti ospitati dal portale.
• Puoi aggiornare ArcGIS Notebook Server usando il programma di installazione di Setup o della linea di comando. Scegli uno dei metodi di aggiornamento.
• Prima di eseguire l'aggiornamento, cancellare le cache di tutti i browser Web utilizzati sul computer ArcGIS Notebook Server.
• L'account di servizio di Windows per il sito di ArcGIS Notebook Server (il suo account Run As) deve rimanere invariato quando si effettua l'aggiornamento.

Backup della distribuzione

Prima di effettuare l'aggiornamento, si consiglia di effettuare il backup della distribuzione.

Legacy:

Nella versione 10.7, è necessario eseguire manualmente il backup dell'archivio di configurazione del sito e delle directory del server.

I notebook saranno inclusi nei backup del portale utilizzando l'utilità webgisdr.

È possibile utilizzare l'operazione exportSite nell'Administrator Directory di ArcGIS Notebook Server per eseguire il backup dell'archivio di configurazione di un sito, come descritto di seguito. Oltre a questo backup della configurazione del sito, considerare la possibilità di effettuare backup manuali del file system.

Attenersi alla seguente procedura per eseguire manualmente l'operazione di backup:

1. Aprire l'Administrator Directory di ArcGIS Notebook Server ed effettuare l'accesso come utente con privilegi amministrativi. L'URL è in genere https://notebookserver.domain.com:11443/arcgis/admin.
2. Navigare al sito > Export Site.
3. Immettere il percorso completo della posizione sul computer sul quale si desidera esportare il file. Il sito deve disporre dell'accesso a questa directory.
4. Fare clic su Esporta.
5. Al termine dell'operazione di esportazione, la directory fornirà un link alla posizione del file di backup sul server. Scaricare il file, che presenterà un'estensione file .agssite, il prima possibile.

Aggiornare mediante il programma di installazione

Nota:

Si consiglia di utilizzare il file di configurazione per aggiornare ArcGIS Notebook Server alla versione 10.8.1. Se i vincoli organizzativi impediscono di utilizzare il file di configurazione, è possibile richiamare l'operazione di Aggiornamento del sito dall'Administrator Directory di ArcGIS Notebook Server utilizzando uno script.

Se si dispone di un sito con più computer, seguire i passaggi da 1 a 5 per un computer, dopodiché ripetere questi passaggi per ogni computer del sito.

1. Durante l'installazione, leggere il contratto principale e accettarlo o uscire se non si accettano le condizioni.

   Il programma di configurazione mostra la funzionalità che verrà installata e lo spazio libero su disco che richiede sul disco rigido.

2. Nella finestra di dialogo successiva, specificare le credenziali di accesso all'account o fornire un file di configurazione.

   L'account ArcGIS Notebook Server utilizzato dall'installazione esistente è già inserito nella casella di ArcGIS Server Account. Fornire la password per l'account ArcGIS Notebook Server. Si tratta in genere della password definita durante l'installazione del software.

   Se la password non viene convalidata, viene visualizzato un messaggio di errore che indica che la password non è valida. Se non si è certi della password da utilizzare per l'account ArcGIS Notebook Server, rivolgersi all'amministratore di sistema o reimpostare la password utilizzando l'Administrator Directory di ArcGIS Notebook Server.

   Se si fornisce un file di configurazione, le credenziali nel file di configurazione del server devono essere le stesse credenziali utilizzate dal sito di ArcGIS Notebook Server esistente.

3. Se è stato selezionato Specificare il nome utente e la password dell'account e sono stati immessi manualmente i dati dell'account ArcGIS Notebook Server, è possibile esportare un file di configurazione del server sulla finestra di dialogo che viene visualizzata. Se non si desidera esportare un file di configurazione, fare clic su Avanti, quindi accettare l'opzione predefinita Non esportare il file di configurazione. Se si desidera esportare un file di configurazione del server per future installazioni, fare clic su Esporta file di configurazione, navigare in una cartella sicura e fornire un nome per il file di configurazione.

   Nota:

   È possibile esportare un file di configurazione del server se è necessario eseguire una delle seguenti operazioni:

   • Creare lo stesso account ArcGIS Notebook Server quando si effettua l'installazione su più computer.
   • Memorizzare l'account per utilizzarlo durante l'aggiornamento ad una nuova versione.
   • Effettuare un'installazione in modalità silenziosa in cui nome utente e password sono crittografati.

   Attenzione:

   Quando si esporta un file di configurazione del server in una condivisione di rete, l'account di sistema locale nel computer in cui si installa ArcGIS Notebook Server deve disporre di autorizzazioni di scrittura per tale condivisione di rete. Se non si impostano le autorizzazioni, è possibile che il file di configurazione server non venga esportato correttamente. Se non si è certi di come impostare correttamente le autorizzazioni per la condivisione di rete, rivolgersi all'amministratore di sistema oppure esportare in locale il file di configurazione server e quindi copiarlo nella condivisione di rete.

4. Per completare l'installazione, attenersi alle istruzioni visualizzate sullo schermo.
5. Al termine dell'installazione si apre la configurazione guidata in un browser. Seguire le istruzioni fornite nella procedura guidata di configurazione per completare il processo di aggiornamento.
6. Se si dispone di un sito con più computer, procedere ai punti da 1 a 5 per gli altri computer del sito. Se si dispone di un sito con un solo computer e si prevede di passare a un sito con più computer, è ora possibile aggiungere i computer aggiuntivi al sito. È inoltre necessario modificare i percorsi delle directory del server e dell'archivio di configurazione per utilizzare le postazioni condivise accessibili a ogni computer. Le eccezioni sono la directory dello spazio di lavoro e qualsiasi directory di dati personalizzata, che deve rimanere locale su ogni computer e replicata utilizzando un sistema come DFS.

Aggiornamento dalla riga di comando

È anche possibile effettuare l'aggiornamento di ArcGIS Notebook Server dalla riga di comando utilizzando l'utilità upgradesite a partire dalla versione 10.8.

Questa utilità ha solo 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 C:\Program Files\ArcGIS\NotebookServer\tools\upgradesiteutility\upgradesite.bat.

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.bat -s

L'utilità visualizzerà i report di avanzamento e si fermerà al termine dell'aggiornamento. Se si dispone di più computer nel proprio sito, ripetere questo comando su ogni computer, dopodiché continuare con la procedura della sezione successiva.

Autorizzare in modalità silenziosa

Dopo che l'utilità di aggiornamento è stata completata, è necessario riautorizzare il software ArcGIS Notebook Server per la versione 10.8.1 se si è effettuato l'aggiornamento dalla 10.7.1 o da una versione precedente. Non è necessario riautorizzare il software se si sta eseguendo l'aggiornamento dalla 10.8 a 10.8.1.

EseguireSoftwareAuthorization.exe con la seguente sintassi per autorizzareArcGIS Notebook Server in modalità silenziosa. È necessario disporre di tutte le informazioni dell'utente complete nel file di autorizzazione o di provisioning prima di eseguire il file.

Se si dispone di un file di autorizzazione e il computer è connesso a Internet, eseguire:

<System disk drive>\Program Files\Common Files\ArcGIS\bin\SoftwareAuthorization.exe /S /Ver 10.7 /LIF <full path and name of authorization file>

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.

1. Al prompt, eseguire il comando fornito di seguito al termine dell'aggiornamento di ArcGIS Notebook Server:

   <System disk drive>\Program Files\Common Files\ArcGIS\bin\SoftwareAuthorization.exe /F <full path to the .prvc file> /O <full path to authorization file output>

2. Una volta creato il file di informazioni di output, eseguire una delle seguenti operazioni:
   • Passare al sito Web del servizio clienti Esri https://service.esri.com/drm. 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 [e-mail]. Esri rinvierà il file di autorizzazione.ecp in un'e-mail.
3. Una volta ricevuto il file di autorizzazione.ecp con uno dei metodi sopra indicati, eseguire nuovamente lo scriptauthorizeSoftware per elaborarlo e completare il processo di autorizzazione del server:

   <System disk drive>\Program Files\Common Files\ArcGIS\bin\SoftwareAuthorization.exe /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 Docker al sito. È inoltre necessario sostituire le istanze di ArcGIS Web Adaptor registrate sul proprio sito per farle corrispondere alla nuova versione.

1. Aprire la finestra del prompt dei comandi utilizzando l'account Run As di ArcGIS Notebook Server.
2. Installare l'immagine Docker specificandone il percorso del file. L'immagine dovrebbe essere compressa nel formato .tar.gz. Se si dispone di una licenza Avanzata, eseguire il comando due volte per installare sia le immagini dei contenitori Standard sia Avanzate scaricate da My Esri. > PostInstallUtility.bat -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.

3. Annullare la registrazione dell'istanza precedente di ArcGIS Web Adaptor dal sito e disinstallarla.
   1. Accedere all'Administrator Directory di ArcGIS Notebook Server.
   2. Navigare su Sistema > Web Adaptor > computer registrato.
   3. Fare clic su Annulla registrazione Web Adaptor.
4. Installare una nuova istanza di ArcGIS Web Adaptor 10.8.1 e registrarla con ArcGIS Notebook Server.
5. Una volta completato l'aggiornamento della distribuzione, è possibile sfruttare le funzionalità di 10.8.1. Per abilitare la programmazione dei notebook nel portale, eseguire le seguenti operazioni:

   • Aggiornare i ruoli personalizzati che includono i privilegi dei notebook per aggiungere il nuovo privilegio di Pianifica Notebook, se lo si desidera.
   • 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) possono essere programmati.

Adesso il sito di ArcGIS Notebook Server 10.8.1 è pronto per ospitare ArcGIS Notebooks.