Problemi comuni e relative soluzioni

È possibile trovare di seguito domande o problemi che si possono verificare durante l'utilizzo di ArcGIS Notebook Server e le relative soluzioni. Se il problema riscontrato non è presente nell'elenco, è possibile cercare la soluzione negli articoli del sito Web Support Center Esri.

Installazione

• Quando si caricano le immagini di runtime del notebook, viene visualizzato l'errore spazio insufficiente sul dispositivo, anche se è presente spazio libero sull'unità in cui sono installati ArcGIS Notebook Server e Docker.

Accesso ai notebook

• Nel tentativo di aprire un notebook, appare il seguente messaggio di errore: Connessione non riuscita. Non è stato possibile stabilire una connessione al Notebook Server. Il notebook continuerà a cercare di riconnettersi. Controllare la connessione di rete o la configurazione del Notebook Server.
• Nel tentativo di aprire un notebook, appare il seguente messaggio di errore: Impossibile caricare.
• Nel tentativo di aprire un notebook, appare il seguente messaggio di errore: Errore durante l'apertura del notebook. Impossibile connettersi all'ambiente Docker sul Notebook Server. Assicurarsi che i prerequisiti del Notebook Server per l'esecuzione di Docker siano stati soddisfatti.
• Nel tentativo di aprire un notebook, appare un messaggio di errore indicante che il contenitore non è in esecuzione.

Appunti

• Con ArcGIS Notebook Server che utilizza contenitori Windows, quando si eseguono due o più notebook nell'editor di notebook che importano la libreria Torch o librerie Python con dipendenza Torch, le istruzioni di importazione non riescono tranne che nel primo notebook eseguito con [WinError 1455] The paging file is too small for this operation to complete. Error loading "C:\ArcGIS_Server\Server\framework\runtime\ArcGIS\bin\Python\envs\arcgispro-py3\lib\site-packages\torch\lib\caffe2_detectron_ops_gpu.dll" or one of its dependencies.
• Con ArcGIS Notebook Server che utilizza contenitori Windows, quando si esegue un notebook che importa la libreria mljar-supervised, l'istruzione di importazione impiega molto tempo o causa un errore Kernel died.
• Quando si esegue una cella di notebook con codice Python code che utilizza un elemento del portale ArcGIS Enterprise, la richiesta scade. Questo succede ogni volta che eseguo una cella che contiene un URL remoto.

• Quando eseguo la prima cella predefinita del notebook (compresa la stringa gis = GIS("home")), appare il seguente messaggio di errore URL: Errore temporaneo nella risoluzione del nome.
• Quando eseguo la prima cella predefinita del notebook (compresa la stringa gis = GIS("home")), appare il seguente messaggio: ConnectionError: A connection error has occurred: HTTPSConnectionPool(host=,port=443): Max retires exceeded with url: /portal/sharing/rest/info=fjson (caused by NewConnectionError ('urllib3.connection.HTTPSConnection object at 0x7f672e592b0>: Failed to establish a new connection: [Errno -3] Temporary failure in name resolution'))

Installazione

Quando si caricano le immagini di runtime del notebook, viene visualizzato l'errore spazio insufficiente sul dispositivo, anche se è presente spazio libero sull'unità in cui sono installati ArcGIS Notebook Server e Docker.

Controllare le impostazioni del desktop Docker per l'allocazione avanzata delle risorse e verifica che ci sia una dimensione sufficiente dell'immagine del disco allocata per la posizione dell'immagine del disco. Aumentare lo spazio di disco allocato e riprova a caricare le immagini di runtime del notebook.

Accesso ai notebook

Nel tentativo di aprire un notebook, appare il seguente messaggio di errore: Connessione non riuscita. Non è stato possibile stabilire una connessione al Notebook Server. Il notebook continuerà a cercare di riconnettersi. Controllare la connessione di rete o la configurazione del Notebook Server.

Se ArcGIS Web Adaptor viene eseguito su un server Web IIS, questo errore si verifica quando il protocollo WebSocket è disabilitato su quel computer. A partire dalla 10.8, ArcGIS Web Adaptor abilita automaticamente il protocollo WebSocket sui server Web IIS; non è necessario disabilitare il protocollo.

Nel tentativo di aprire un notebook, appare il seguente messaggio di errore: Impossibile caricare.

Il certificato SSL configurato con il Web Adaptor del sito ArcGIS Notebook Server non è considerato attendibile dal browser Web. Assicurarsi di disporre di un certificato firmato da un'autorità di certificazione che sia configurato e che l'HTTPS sia abilitato sul sito.

Se si utilizza un certificato autofirmato in un ambiente di sviluppo o di staging, aprire l'URL dell'Administrator Directory di ArcGIS Notebook Server e aggiungere un'eccezione nel browser Web per considerare attendibile il certificato autofirmato.

Nel tentativo di aprire un notebook, appare il seguente messaggio di errore: Errore durante l'apertura del notebook. Impossibile connettersi all'ambiente Docker sul Notebook Server. Assicurarsi che i prerequisiti del Notebook Server per l'esecuzione di Docker siano stati soddisfatti.

Non sono state configurate una o più impostazioni prerequisite che consentono il funzionamento del componente Docker Engine con ArcGIS Notebook Server. Per ulteriori informazioni, consultare i seguenti argomenti nella guida all'installazione:

• InstallareDocker per ArcGIS Notebook Server
• Configurare ArcGIS Notebook Server dopo l'installazione

Una volta verificata la configurazione di tutte le impostazioni necessarie, eseguire quanto segue in un prompt di comandi per confermare che Docker sia in esecuzione sul computer di ArcGIS Notebook Server:

docker version
docker run hello-world

Nel tentativo di aprire un notebook, appare un messaggio di errore indicante che il contenitore non è in esecuzione.

Se appare questo messaggio di errore, il contenitore è disponibile ma non è in stato di funzionamento o utilizzabile. Per renderlo accessibile, è necessario terminare il contenitore tramite Administrator Directory. Assicurarsi di terminare il contenitore specificato nel messaggio di errore. Una volta terminato, chiedere al proprietario del notebook di riaprire il notebook, che avvierà nuovamente il contenitore.

Appunti

Con ArcGIS Notebook Server che utilizza contenitori Windows, quando si eseguono due o più notebook nell'editor di notebook che importano la libreria Torch o librerie Python con dipendenza Torch, le istruzioni di importazione non riescono tranne che nel primo notebook eseguito con [WinError 1455] The paging file is too small for this operation to complete. Error loading "C:\ArcGIS_Server\Server\framework\runtime\ArcGIS\bin\Python\envs\arcgispro-py3\lib\site-packages\torch\lib\caffe2_detectron_ops_gpu.dll" or one of its dependencies.

Questo comportamento è dovuto alla dimensione del file di paginazione massima configurata per la memoria virtuale sulle macchine Notebook Server. Attenersi alla seguente procedura per aumentare la dimensione del file di paginazione predefinita nonché CPU e memoria massime assegnate a un notebook:

Nota:

Per la dimensione del file di paginazione appropriata, consultare un amministratore di sistema prima di apportare le modifiche.

1. Su ogni macchina ArcGIS Notebook Server, fare clic su Start > Impostazioni > Sistema > Informazioni > Imposrtazioni di sistema avanzate
2. Nella scheda Avanzate della finestra di dialogo Proprietà di sistema, fare clic su Impostazioni nella sezioone Prestazioni.
3. Nella finestra di dialogo Opzioni prestazioni fare clic sulla scheda Avanzate.
4. Fare clic su Modifica nella sezione della memoria virtuale.
5. Nella finestra di dialogo Memoria virtuale, deselezionare Gestisci automaticamente la dimensione del file di paginazione per tutte le unità.
6. Selezionare Dimensione personalizzata.
7. Inserire Initial size (MB) e Maximum size (MB).
8. Fare clic su Ok e riavviare la macchina.

Una volta riavviata la macchina, eseguire questi passaggi in ArcGIS Notebook Server Manager.

1. Fare clic su Impostazioni > Runtime.
2. Selezionare il runtime utilizzato per eseguire i notebook che importano Torch e faere clic su Modifica.
3. Aggiornare CPU massima a 4 core e Memoria massima a 12 GB.
4. Fare clic su Salva per confermare l'aggiornamento.
5. Uscire da ArcGIS Notebook Server Manager.

Con ArcGIS Notebook Server che utilizza contenitori Windows, quando si esegue un notebook che importa la libreria mljar-supervised, l'istruzione di importazione impiega molto tempo o causa un errore Kernel died.

Questo comportamento potrebbe dipendere dall'elevato numero di dipendenza della libreria mljar-supervised. Seguire questi passaggi per aumentare la CPU massima assegnata a un notebook in ArcGIS Notebook Server Manager.

1. Fare clic su Impostazioni > Runtime.
2. Selezionare il runtime utilizzato per eseguire i notebook che importano mljar-supervised e fare clic su Modifica.
3. Aggiornare Max CPU a 4 core.
4. Fare clic su Salva per confermare l'aggiornamento.
5. Uscire da ArcGIS Notebook Server Manager.

Quando si esegue una cella di notebook con codice Python code che utilizza un elemento del portale ArcGIS Enterprise, la richiesta scade. Questo succede ogni volta che eseguo una cella che contiene un URL remoto.

La rete utilizzata dai contenitori Docker in esecuzione nel sito è on conflitto con la rete ArcGIS Enterprise, che impedisce al codice Python di collegarsi alla rete. Fare riferimento alla documentazione di Docker sulla configurazione della rete. Una volta configurata la rete per Docker, eseguire di nuovo i notebook.

Quando eseguo la prima cella predefinita del notebook (compresa la stringa gis = GIS("home")), appare il seguente messaggio di errore URL: Errore temporaneo nella risoluzione del nome.

Questo errore può verificarsi quando ArcGIS Notebook Server e i suoi componenti Docker sono installati sullo stesso computer come gli altri componenti ArcGIS Enterprise. Si verifica perché la proprietà privatePortalUrl predefinita memorizzata in ArcGIS Notebook Server è una versione abbreviata del nome di dominio completo. Ciò causa un errore quando si tenta di contattare il portale.

La soluzione è modificare la proprietà privatePortalUrl per essere il nome di dominio completo del sito ArcGIS Notebook Server:

1. Effettuare l'accesso alla directory di Portal for ArcGIS con il ruolo di Amministratore predefinito del portale. Il formato dell'URL è https://portal.domain.com:7443/arcgis/portaladmin.
2. Fare clic su Sistema > Proprietà > Aggiorna Proprietà.
3. Nella finestra di dialogo Aggiorna proprietà di sistema, inserire una stringa JSON con il nome di dominio completo del portale, nel seguente formato:
   { "privatePortalUrl": "https://portal.domain.com:7443/arcgis" }

Quando eseguo la prima cella predefinita del notebook (compresa la stringa gis = GIS("home")), appare il seguente messaggio: ConnectionError: A connection error has occurred: HTTPSConnectionPool(host=,port=443): Max retires exceeded with url: /portal/sharing/rest/info=fjson (caused by NewConnectionError ('urllib3.connection.HTTPSConnection object at 0x7f672e592b0>: Failed to establish a new connection: [Errno -3] Temporary failure in name resolution'))

Durante la distribuzione dei contenitori Docker, i server de nomi vengono copiati dal fileresolv.conf della macchina host. Questa operazione potrebbe causare errori nelle configurazioni che utilizzano i server DNS pubblici per le macchine perché i contenitori Docker devono poter risolvere i nomi DNS interni.

La soluzione consiste nel configurare dockerExtraHosts nelle proprietà di sistema di ArcGIS Notebook Server:

1. Apri l'URL di ArcGIS Notebook Server Administrator Directory.
2. Fai clic su Sistema > Proprietà > Aggiorna proprietà
3. Nella finestra di dialogo Aggiorna proprietà di sistema, inserisci una stringa JSON di nomi host e indirizzi IP nel seguente formato:
   { "dockerExtraHosts": [ { "hostname" : "<host name>", "ip" : "12.34.56.78" } ] }