Aggiornare ArcGIS Notebook Server su Windows Server 2019 (contenitori Linux)

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.2, è necessario aggiornare anche ArcGIS Notebook Server.

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

Durante il processo di aggiornamento, è necessario riautorizzare il software ArcGIS Notebook Server per 11.2se si è effettuato l'aggiornamento dalla 10.8.1 o da una versione precedente.

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

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 diventeranno obsoleti dopo il ciclo di vita di ArcGIS Enterprise. I notebook non devono utilizzare runtime obsoleti 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 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 11.2.

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

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 11.2.
• 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 Desktop per Windows alla versione 4.19.0 o successive.
• 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. AggiornareArcGIS Data Store (aggiornare innanzitutto la principale, quindi la stand-by).
  6. Aggiornare qualsiasi altro server, tra cui ArcGIS Notebook Server.
  7. Installare ArcGIS Notebook Server Dati Campione
• 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 nessun punto durante il processo di aggiornamento. Ciò ha un impatto negativo sui notebook esistenti ospitati dal portale.
• Puoi aggiornare ArcGIS Notebook Server usando l'installazione o il programma di installazione da 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.
• L'account di servizio Windows per il sito ArcGIS Notebook Server site (è un account Esegui come) deve rimanere invariato durante l'aggiornamento.

Backup della distribuzione

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

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.

   Al termine dell'operazione di esportazione, la directory fornisce un link alla posizione del file di backup sul server.

5. Scaricare il file, che presenterà un'estensione file .agssite, il prima possibile.

Aggiornare mediante il programma di installazione

Nota:

Utilizzare il file di configurazione per aggiornareArcGIS Notebook Server alla versione 11.2. 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.

1. Per avviare l'aggiornamento, eseguire./Setup dalla posizione da cuiArcGIS Notebook Server è stato estratto 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 disinstallerà la versione precedente diArcGIS Notebook Server e installerà la versione aggiornata di ArcGIS Notebook Server.

2. Dopo che l'utilità di aggiornamento è stata completata, è necessario riautorizzare il software ArcGIS Notebook Server per 11.2. Utilizzare la procedura guidata di autorizzazione software per completare l'autorizzazione.
3. Aprire la procedura guidata di configurazione utilizzando l'URL elencato alla fine dell'aggiornamento dell'installazione, e seguire le istruzioni a video per aggiornare il sito.
4. 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:

1. Per avviare l'aggiornamento, eseguire il comando di installazione di ArcGIS Notebook Server con l'argomento illustrato nell'esempio che segue. Assicurarsi di utilizzare lo stesso accountArcGIS Notebook Server utilizzato dall'installazione esistente.

   Questa operazione disinstalla la versione precedente di ArcGIS Notebook Server e installa la versione aggiornata di ArcGIS Notebook Server.

   setup.exe /qn USER_NAME=<ArcGIS Notebook Server account username> PASSWORD=<password> ACCEPTEULA=yes

2. Utilizzare l'utilitàupgradesite e completare l'aggiornamento eseguendo il seguente comando. Per impostazione predefinita, l'utilitàupgradesite si trova in C:\Program Files\ArcGIS\NotebookServer\tools\upgradesiteutility\upgradesite.bat.

   upgradesite.bat -s

   L'utilità visualizza i report di avanzamento e si interrompe al termine dell'aggiornamento. L'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.

3. Se si dispone di un sito con più computer, ripetere i passaggi 1 e 2 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.2.

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\ArcGIS\NotebookServer\framework\bin /S /Ver <version number> /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:

   <ArcGIS Notebook Server install directory>\tools\SoftwareAuthorization\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 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 [e-mail]. Esriinvierà il file di autorizzazione .ecp in un'e-mail.
3. Una volta ricevuto il file di autorizzazione .ecpcon uno dei metodi sopra indicati, eseguire nuovamente lo script authorizeSoftware 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.

Eseguire l'utilità di post-installazione

Per eseguire l'utilità di post-installazione, procedi nel modo seguente:

1. Aprire la finestra del prompt di comando come un amministratore.
2. Cambiare le directory nella cartella degli strumenti di ArcGIS Notebook Server. Per impostazione predefinita, questo percorso è C:\Program Files\ArcGIS\NotebookServer\tools\postInstallUtility.
3. In alternativa, si può fare riferimento alla guida dell'utilità eseguendo il seguente comando: IPostInstallUtility.bat -h
4. ArcGIS Notebook Server richiede l'installazione di Docker Engine Community Edition sul computer. Determinare se Docker è attivo sul proprio computer eseguendo il seguente comando: PostInstallUtility.bat -d
5. Se Docker Desktop non è installato, installarlo adesso.

   ArcGIS Notebook Server utilizza i contenitori Linux in Docker Desktop. Quando installi Docker Desktop, assicurati di specificare i contenitori Linux e non fare clic sull'opzione Passa ai contenitori Windows.

6. Quando si usa Docker Desktop, modificare ciascuna delle seguenti impostazioni:
   1. Fare clic con il tasto destro del mouse sul pulsante Docker nella barra delle applicazioni e fare clic su Impostazioni. In Generale, selezionare Esponi daemon su tcp://localhost:2375 senza TLS.

      In tal modo si utilizzerà l'API remota di Docker, che richiede l'uso della porta 2375.

   2. Fare clic con il tasto destro del mouse sul pulsante Docker nella barra delle applicazioni e fare clic su Impostazioni. Nel menu Impostazioni, clicca su Risorse > Condivisione file e aggiungi la directory dell'unità che sarà usata per il tuo archivio di configurazione ArcGIS Notebook Server.

      Nota:

      Docker per Windows supporta solo le directory su Windows che sono state condivise con i container Linux.

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

Installare e configurare i dati campione ArcGIS Notebook Server

Quando si configura un sito ArcGIS Notebook Server di più computer, è necessario installare e configurare i dati campione solo sul primo computer dove è stato installato Notebook Server e creato il sito.

Per installare e configurare i dati campione, seguire queste operazioni:

1. Eseguire l'installazione guidata dei dati campione ArcGIS Notebook Server che è stata scaricata da My Esri

   I dati campione verranno installati nella directory dove è installato ArcGIS Notebook Server.

2. Aprire la finestra del prompt di comando come un amministratore.
3. Cambiare le directory nella cartella degli strumenti di ArcGIS Notebook Server.

   Per impostazione predefinita, questo percorso è C:\Program Files\ArcGIS\NotebookServer\tools\postInstallUtility.

4. In alternativa, si può fare riferimento alla guida dell'utilità eseguendo il seguente comando:

    > PostInstallUtility.bat -h

5. Eseguire la utility di post installazione per estrarre i dati campione alla directory arcgisworkspace del sito server di notebook.

    PostInstallUtility.bat -x

Sostituire le istanze ArcGIS Web Adaptor

Per sostituire le istanze di ArcGIS Web Adaptor, procedi nel modo seguente:

1. Annullare la registrazione dell'istanza precedente di ArcGIS Web Adaptor dal sito e disinstallarla.
   1. Effettuare l'accesso adArcGIS Notebook Server Administrator Directory.
   2. Andare a Sistema > Adattori Web > macchina registrata.
   3. Fare clic su Annulla registrazione Web Adaptor.
2. Installare una nuova istanza di ArcGIS Web Adaptor11.2 e configurarla con ArcGIS Notebook Server.
Una volta completato l'aggiornamento della distribuzione, è possibile sfruttare le funzionalità di 11.2.
3. Se si esegue l'aggiornamento dalla 10.8 o versione precedente, per abilitare la programmazione dei notebook nel portale, eseguire le seguenti operazioni:
   1. Facoltativamente, aggiornare i ruoli personalizzati che includono i privilegi dei notebook per aggiungere il nuovo privilegio Pianifica notebook.
   2. 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 e 11.2 è ora pronto per ospitare ArcGIS Notebooks.