Skip To Content

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

Accesso ai notebook

Appunti

Installazione

La directory amministrativa di ArcGIS Notebook Server su Windows non risponde dopo l'installazione o dopo un riavvio della macchina server del notebook.

Questo problema si può verificare se il servizio ArcGIS Notebook Server Windows e il servizio Docker non vengono avviati nell'ordine corretto dopo l'installazione o il riavvio del computer.

Per risolvere questo problema, impostare il servizio ArcGIS Notebook Server Windows per l'avvio automatico con un ritardo. In tal modo si consente l'inizializzazione completa del servizio Docker Windows prima dell'avvio del servizio ArcGIS Notebook Server Windows.

Per configurare il servizio ArcGIS Notebook Server Windows per l'avvio automatico con un ritardo, procedere nel modo seguente:

  1. Aprire l'applicazione Servizi sul computer ArcGIS Notebook Server Windows.
  2. Fare clic con il pulsante destro del mouse sul servizio ArcGIS Notebook Server e selezionare Proprietà.
  3. Fare clic su Generale.
  4. In Startup type, selezionare Automatico (Avvio ritardato).
  5. Fare clic su Applica.
  6. Riavviare il computer per applicare le modifiche.
  7. Se più computer fanno parte del sito ArcGIS Notebook Server, ripetere questi passi su ogni computer.

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.

Come rimuovere le immagini contenitore precedenti dal computer?

Su Windows Server con Mirantis Container Runtime, le immagini contenitore si trovano nella cartella C:\ProgramData\docker\windowsfilter. Per rimuovere tutte le immagini contenitore precedenti sul computer e liberare spazio su disco, eseguire il seguente comando nella PowerShell con privilegi di amministratore.

docker system prune -af

Se non tutti i layer immagine vengono rimossi da C:\ProgramData\docker\windowsfilter, riavviare il computer ed eseguire i seguenti comandi nella PowerShell con privilegi di amministratore.

Nota:

Eseguire le seguenti operazioni prima di caricare l'immagine contenitore ArcGIS Notebook Server Windows, in quanto il processo rimuoverà tutte le immagini contenitore nel computer.

  • $FolderPath = "C:\ProgramData\docker\windowsfilter"
  • Get-ChildItem -Path $FolderPath -Directory | % {Rename-Item $_.FullName "$($_.FullName)-removing" -ErrorAction:SilentlyContinue}
  • while ((Get-ChildItem -Path $FolderPath -Force | Measure-Object).Count -gt 0)
    {
    Restart-Service 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.

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:

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 computer ArcGIS Notebook Server, fare clic su Start > Impostazioni > Sistema > Informazioni > Impostazioni di sistema avanzate.
  2. Nella scheda Avanzate della finestra di dialogo Proprietà di sistema, fare clic su Impostazioni nella sezione Prestazioni.
  3. Nella finestra di dialogo Opzioni prestazioni, fare clic sulla scheda Avanzate.
  4. Fare clic su Modifica nella sezione Memoria virtuale.
  5. Nella finestra di dialogo Memoria virtuale, deselezionare Gestisci automaticamente dimensione file di impaginazione per tutte le unità.
  6. Selezionare Dimensione personalizzata.
  7. Inserire i valori per Initial size (MB) e Maximum size (MB).
  8. Fare clic su OK e riavviare il computer.

Una volta riavviato il computer, 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 fare 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. Chiudere Gestione ArcGIS Notebook Server.

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. Chiudere Gestione ArcGIS Notebook Server.

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 si esegue la prima cella predefinita del notebook (compresa la stringa gis = GIS("home")), appare il seguente messaggio di errore: ConnectionError: Si è verificato un errore di connessione: HTTPSConnectionPool(host=,porta=443): Numero max di tentativi superato con l'url: /portal/sharing/rest/info=fjson (causato da NewConnectionError ('oggetto urllib3.connection.HTTPSConnectisu 0x7f672e592b0>: Impossibile stabilire la connessione: [N. errore -3] Errore temporaneo nella risoluzione del nome')).

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. Fare clic su Sistema > Proprietà > Aggiorna Proprietà.
  3. Nella finestra di dialogo Aggiorna proprietà di sistema, inserire una stringa JSON di nomi host e indirizzi IP nel seguente formato:
    { "dockerExtraHosts": [ { "hostname" : "portal.domain.com", "ip" : "12.34.56.78" } ] }