Collegare computer aggiuntivi a un sito ArcGIS Notebook Server

ArcGIS Notebook Server supporta site con più computer a partire dalla versione 10.7.1 e versioni successive. In un sito con più computer, ogni computer è configurato allo stesso modo, con configurazioni identiche per Docker e tutti possono eseguire ArcGIS Notebooks.

Legacy:

Nella versione 10.7 erano supportati solo i siti con un solo computer.

I siti ArcGIS Notebook Server con più computer consentono di supportare più utenti di appunti simultanei. Se si hanno molti utenti attivi o se le risorse del computer singolo sono inadeguate per le esigenze degli utenti, potrebbe essere vantaggiosa l'espansione a un sito a più computer.

Nota:

Se si hanno pochi utenti di appunti che richiedono maggiori risorse del computer, si potrebbe valutare la modifica dei limiti delle risorse del sito come alternativa limitata all'aggiunta di computer.

Tutti i computer in un sito ArcGIS Notebook Server hanno lo stesso software installato, con la stessa versione e lo stesso file di licenza. Sul primo computer configurato, sarà necessario creare il sito ArcGIS Notebook Server. È possibile quindi collegare computer ArcGIS Notebook Server aggiuntivi al sito.

Nota:

A differenza di altri ruoli ArcGIS Server, ArcGIS Notebook Server non supporta l'aggiunta di computer aggiuntivi a un sito dal primo computer. È necessario accedere a ogni computer a turno e unirli al sito, usando la configurazione guidata ArcGIS Notebook Server o l'utilità joinsite.

Prima di eseguire l'installazione

Quando si crea un sito, si decide dove archiviare l'archivio di configurazione, una directory che ospita i file importanti e le informazioni di configurazione del sito. Il sito presenta anche directory server system e workspace.

Quando si crea per la prima volta un sito ArcGIS Notebook Server, si specificano le posizioni per l'archivio di configurazione e per le directory server. In un sito su più computer è necessario condividere l'archivio di configurazione e le directory di server in modo che siano accessibili ad altri computer. A ogni computer che si collega al sito si devono garantire autorizzazioni in lettura e scrittura a questi percorsi condivisi.

Installare e configurare un sito a più computer

Quando si intende configurare un sito ArcGIS Notebook Server a più computer, ci sono alcuni passaggi aggiuntivi da seguire in questa Guida all'installazione.

1. Revisionare i requisiti di sistema per ArcGIS Notebook Server per verificare che tutti i computer siano idonei. Su ciascun computer, regolare i firewall per aprire la porta 11443 per la comunicazione da ciascun computer nella distribuzione ArcGIS Enterprise.

   Verificare che l'installazione sia effettuata con lo stesso sistema operativo su entrambi i computer. L'account utente utilizzato per installare ArcGIS Notebook Server sarà quello utilizzato per eseguire il software. Gli utenti del gruppo e tutti gli altri utenti devono disporre almeno delle autorizzazioni di esecuzione per la directory di installazione di ArcGIS Notebook Server. Si ricorda che l'installazione di ArcGIS Notebook Server con l'account radice non è supportata. L'account utente utilizzato per installare su due computer diversi, ad esempio, potrebbe essere il seguente:

   1. Installare ArcGIS Notebook Server sul primo computer in /data/ags come utente ags, con ID utente 58103.
   2. Installare ArcGIS Notebook Server su un secondo computer in /data/ags con lo stesso nome utente e ID (ags, ID utente 58103).
2. Verificare di aver già eseguito quanto segue durante il processo di installazione a questo punto:
   1. Installare Docker su ogni computer. Su ciascun computer, scaricare le immagini Docker fornite da Esri e salvarle in una posizione accessibile dal sistema.
   2. Installare e autorizzare ArcGIS Notebook Server su ciascun computer. È anche possibile installare il software in modo silenzioso.
   3. Eseguire l'utilità PostInstaller da riga di comando (posizionata in <ArcGIS Notebook Server installation directory>/tools/postInstallUtility) per caricare le immagini Docker nel repository locale su ciascun computer.
   4. Seguire i passaggi per configurare ArcGIS Notebook Server dopo l'installazione.
3. Creare e condividere due directory nella rete, specificando l'utente di installazione come proprietario. Una deve essere destinata all'archivio di configurazione e l'altra alle directory del server. Alle cartelle è necessario concedere come minimo permessi pari a 700.

   Nota:

   Le directory di rete condivise che sono nascoste o utilizzano caratteri speciali, ad esempio $, non sono supportate da ArcGIS Notebook Server.

   Ad esempio:
   1. Creare una directory dal nome config-store. Specificare il proprietario come ags, con ID utente 58103. Concedere alla directory come minimo permessi pari a 700.
   2. Condividere la cartella config-store in modo che entrambi i computer possano accedere alla directory con lo stesso percorso, ad esempio /net/myserver/config-store.
   3. Creare una directory dal nome arcgisnotebookserver. Specificare il proprietario come ags, con ID utente 58103. Concedere alla directory come minimo permessi pari a 700.
   4. Condividere la cartella arcgisnotebookserver in modo che entrambi i computer possano accedere alla directory con lo stesso percorso, ad esempio /net/myserver/arcgisnotebookserver.

      Anche se le directory si trovano sul computer utilizzato durante la creazione del sito, è necessario creare e condividere manualmente le directory e fare riferimento ad esse mediante un percorso di rete.

4. Da uno dei computer, creare sito ArcGIS Notebook Server. Accertarsi di usare i percorsi per le directory server e per l'archivio di configurazione configurati in precedenza.
5. Una volta completata la procedura precedente, è possibile collegare ciascun computer aggiuntivo al sito creato usando una configurazione guidata. Se si preferisce collegare il sito dalla riga di comando, consultare il passaggio 6.
   1. Dal primo computer aggiuntivo, aprire la configurazione guidata di ArcGIS Notebook Server.
   2. Esaminare e attenersi alle istruzioni fornite nella procedura guidata, quindi fare clic su Continua.
   3. Fare clic su Collegarsi a un sito esistente.
   4. Immettere l'URL del sito e le credenziali per il sito ArcGIS Notebook Server in base alla creazione eseguita al passaggio 4.
   5. Ripetere i passaggi dalla a alla d per ciascun computer aggiuntivo che si desidera collegare al sito.
6. In alternativa all'utilizzo della configurazione guidata, è possibile collegare il computer al sito usando un'utilità da riga di comando come segue.
   1. Accertarsi di aver effettuato l'accesso al computer con l'account ArcGIS Notebook Server.
   2. Aprire un prompt dei comandi ed eseguire l'utilità, che si trova in <ArcGIS Notebook Server install directory>/tools/JoinSiteUtility/joinsite.sh. Di seguito sono descritti i parametri della riga di comando per l'utilità:

      Parametro	Descrizione
      -u o --username	Il nome utente dell'amministratore principale del sito. Il nome utente non può contenere i seguenti caratteri: \/:*?|<>
      -p o --password	La password dell'amministratore principale del sito. La password non può contenere i seguenti caratteri: \/:*?|<>
      -f o --file	File di connessione dell'archivio di configurazione per l'utilità joinsite.
      -s o --siteUrl	L'URL del sito ArcGIS Notebook Server esistente da collegare, nel formato https://notebookserver.domain.com:11443.
      -h o --help	Consente di visualizzare la guida della riga di comando e di uscire.

      Un esempio di comando per l'utilità:

      <ArcGIS Notebook Server install directory>/tools/JoinSiteUtility/joinsite.sh -u notebookPSA -p my.Password3 -s https://notebookserver.domain.com:11443/arcgis/admin

      Se si inseriscono correttamente le credenziali dell'account e l'URL del sito, l'utilità collegherà il computer al sito ArcGIS Notebook Server. Ripetere questo passaggio per ciascun computer aggiuntivo.

Una volta che tutti i computer sono collegati al sito, il resto del processo di configurazione è lo stesso di quello usato per i siti a computer singolo. Procedere a installare e configurare ArcGIS Web Adaptor con il sito. Quindi, si configurerà il sito con il portale ArcGIS Enterprise.

Aggiungere un site dalla riga di comando

È inoltre possibile usare l'utilità della riga di comando di joinSite per aggiungere il computer a un site ArcGIS Notebook Server. Questa utilità richiede che l'utente specifichi il percorso dell'archivio di configurazione del site esistente, piuttosto che il relativo URL. Per questo motivo, l'utilità presenta molti vantaggi in alcuni casi in cui l'utilizzo dell'URL potrebbe intasare la coda delle richieste di rete per il site. Considerare l'utilizzo di questa utilità se i computer nel site ArcGIS Notebook Server sono già sovraccarichi di richieste di rete o se si desidera aggiungere un numero elevato di computer al proprio site contemporaneamente.

L'utilità di join-site è installata in \tools\JoinSiteUtility nella directory di installazione di ArcGIS Notebook Server. Eseguire l'utilità di join-site dal computer ArcGIS Notebook Server che si desidera aggiungere a un sito esistente, utilizzando l'account Run As per l'ArcGIS Notebook Server.

1. Consentire l'accesso in lettura e scrittura nella cartella dell'archivio di configurazione del site esistente all'account di rete utilizzato per eseguire il servizio ArcGIS Notebook Server sui computer da aggiungere al site.
2. Creare un file JavaScript Object Notation (JSON) denominato connection.json.
3. Aggiungere la seguente riga al file, sostituendo <path to the configuration store> con la posizione dell'archivio di configurazione del site ArcGIS Server esistente:

   {"configPersistenceType": "FILESYSTEM", "connectionString": "<path to the configuration store>"}

   In questo esempio, il percorso all'archivio di configurazione del site esistente è /net/mymachine/data/arcgisnotebookserver/usr/config-store:

   {"connectionString": "/net/mymachine/data/arcgisnotebookserver/usr/config-store", " configPersistenceType": "FILESYSTEM" }

4. Salvare e chiudere il file connection.json.
5. Collocare il file connection.json sul computer che si aggiungerà al site o su una directory condivisa accessibile dal computer che si aggiungerà al site.
6. Aprire un prompt dei comandi ed eseguire join-site.
La sintassi è la seguente:
joinSite -f <The file path to the configuration store JSON file>
In questo esempio, si presuppone che il file JSON dell'archivio di configurazione (connection.json) si trovi all'interno della stessa directory dello strumento join-site (\tools\JoinSiteUtility).
joinsite.bat -f connection.json

Il computer è stato aggiunto al site ArcGIS Notebook Server.