Le sessioni di Notebook consumano risorse sui PC in funzione presso il sito ArcGIS Notebook Server. Poiché queste risorse sono limitate, ArcGIS Notebook Server prevede delle impostazioni amministrative per limitarne l'utilizzo.
ArcGIS Notebook Server utilizza dei contenitori (sistemi operativi virtualizzati) per isolare l'ambiente di ciascun autore di appunti. I contenitori consentono a ciascun autore di utilizzare un sottoinsieme delle risorse del server senza che il suo lavoro o il suo utilizzo di risorse interferiscano con gli altri utenti. Questi contenitori vengono allocati e gestiti dal componente Docker in esecuzione sul proprio computer.
A ciascun autore di appunti viene assegnato un contenitore che viene aperto all'apertura dei primi appunti. Ogni autore di appunti può lavorare solo sul proprio contenitore e le risorse del computer che usa in tale contenitore sono isolate dagli altri contenitori.
Quando si apre il contenitore, il suo sistema operativo virtuale e le sue impostazioni vengono configurati tramite un'immagine del contenitore. Si tratta di una delle due immagini dei contenitori ricevute da Esri.
A questa immagine del contenitore è allegato un runtime degli appunti, che consiste in una raccolta di moduli e dipendenze di Python. Il contenuto del runtime è disponibile in tutti gli appunti eseguiti nel contenitore.
L'immagine del contenitore usata dipende dai privilegi dell'autore degli appunti nel portale, come segue:
- Per gli autori a cui è stato concesso solo il privilegio Crea e modifica notebook il contenitore viene caricato con l'immagine del contenitore Standard. Il runtime Standard per i loro appunti includerà ArcGIS API for Python e diverse centinaia di librerie Python di terzi.
- Per gli autori a cui è stato concesso anche il privilegio Notebook avanzato il contenitore viene caricato con l'immagine del contenitore Avanzato. Il runtime predefinito per gli appunti è il runtime Avanzato, che contiene tutti i moduli del runtime Standard insieme ad ArcPy e alle relative librerie. Potranno specificare il runtime di un singolo set di appunti e utilizzare il runtime Standard o Avanzato nei loro appunti.
Per impostazione predefinita, a ogni contenitore viene assegnata una certa quantità di RAM e un certo numero di condivisioni del core della CPU. Questi limiti di risorse predefiniti sono determinati dal runtime eseguito dal contenitore come segue:
- Il runtime Standard assegna 1 core della CPU e 4 GB di RAM a ogni contenitore.
- Il runtime Avanzato assegna 2 core della CPU e 6 GB di RAM a ogni contenitore.
Come amministratore ArcGIS Notebook Server, è possibile controllare il numero di autori di notebook che lavorano nel proprio sito e il runtime utilizzato da ciascuno. In base a questi fattori potrebbe essere necessario o preferibile modificare i limiti di risorse impostati per ArcGIS Notebook Server.
Configurare i limiti di risorse per il proprio sito ArcGIS Notebook Server
Nelle installazioni di Windows di ArcGIS Notebook Server, i container di notebook sono ospitati sul computer all'interno di un computer virtuale Linux (MobyLinuxVM) in esecuzione nel server di visualizzazione Microsoft Hyper-V. Questo computer virtuale Linux governa i limiti di risorse disponibili per l'uso da parte dei contenitori.
È quindi possibile utilizzare il riquadro delle impostazioni di Docker Desktop per limitare le risorse disponibili per ArcGIS Notebook Server e i contenitori in esecuzione nel sito del server.
- Fare clic con il pulsante destro sul pulsante Docker nella barra delle applicazioni Windows e cliccare Impostazioni. Dal menu impostazioni, cliccare Risorse > Avanzate.
- Si visualzzeranno le opzioni che potete usare per cambiare le seguenti impostazioni:
- CPU: il numero di core della CPU disponibili per i contenitori sul computer. Per impostazione predefinita, questo è impostato su due core. È possibile aggiornare questo valore a seconda delle risorse disponibili sulla macchina e dei limiti di CPU impostati per i runtime del notebook.
- Memoria: la quantità di memoria disponibile per i contenitori sul computer. Per impostazione predefinita questo è impostato su 2 GB. Aumentare questo a un minimo di 6 GB. È possibile volerlo aumentare, a seconda delle risorse disponibili sulla macchina e dei limiti di memoria impostati per i runtime del notebook.
- Swap: la quantità di spazio su disco che i contenitori possono utilizzare per la memoria se viene raggiunto il limite impostato.
- Dimensione immagine disco: la dimensione dell'immagine di disco. Esaminare e aggiornare questo valore se necessario se si installano Docker immagini di contenitori Notebooks per i risultati all'esterno e all'interno di un errore di spazio su disco.
- Posizione immagine su disco: la directory dove i container e le immagini sono archiviate.
Nota:
Rivedere questo passo ogni volta che si fanno aggiornamenti alla CPU o alle risorse di memoria configurate per i runtime del notebook. - Una volta impostati i limiti desiderati per le risorse, fare clic su Applica.
Aggiornare le risorse utilizzate da ogni runtime
L'amministratore può aggiornare i valori massimi di CPU e memoria disponibili per ogni contenitore modificando le risorse utilizzate da ogni runtime degli appunti per impostazione predefinita. Se più utenti creano appunti contemporaneamente, è possibile monitorare l'utilizzo del sito e regolare le impostazioni come necessario utilizzando ArcGIS Notebook Server Manager.
- Effettuare l'accesso al portale ArcGIS Enterprise come amministratore e aprire ArcGIS Notebook Server Manager.
- Aprire la pagina Impostazioni e fare clic su Runtime.
- Selezionare il runtime con i limiti delle risorse da aggiornare e fare clic sull'icona Modifica.
- Aggiornare i valori di Max CPU (in core) e/o Memoria massima (in GB) per il runtime.
- Fare clic su Salva per confermare l'aggiornamento.
Monitorare i contenitori in esecuzione
È bene monitorare regolarmente i contenitori attivi nel sito e il loro livello di attività, in quanto ogni contenitore nel sito di ArcGIS Notebook Server utilizza risorse di calcolo durante l'esecuzione. È possibile usare le risorse nell'Administrator Directory di ArcGIS Notebook Server per visualizzare le informazioni sui contenitori e sugli appunti in esecuzione nel sito.
Suggerimento:
Per una visualizzazione rapida di ciascun contenitore, è anche possibile usare ArcGIS Notebook Server Manager.
Nota:
È noto un errore quando si accede alle statistiche dei contenitori tramite la ArcGIS Notebook Server Directory o il Manager dell'amministratore. È possibile utilizzare il comando docker stats da una finestra della riga di comando sul computer Notebook Server per ottenere Docker le statistiche del contenitore. . Per maggiori informazioni, consultare la documentazione di Docker.
Se un contenitore in esecuzione non è stato utilizzato di recente, o se si sa che il proprietario ha completato il proprio lavoro con gli appunti, è possibile utilizzare la directory per terminare il contenitore. In questo modo, gli elementi del portale degli appunti non vengono cancellati e non si impedisce al membro del portale di aprire un nuovo contenitore. Il contenitore terminato smetterà di consumare memoria o CPU.
- Accedere all'Administrator Directory di ArcGIS Notebook Server. Il formato dell'URL è https://notebookserver.domain.com:11443/arcgis/admin.
- Andare su sistema > contenitori.
La pagina delle risorse del contenitore elenca ciascun contenitore in esecuzione, insieme al nome utente del membro del portale che possiede il contenitore mostrato tra parentesi.
- Fare clic sul collegamento a un contenitore per aprire la relativa pagina delle risorse.
Nella pagina delle risorse di un contenitore è possibile visualizzare le informazioni sul contenitore.
- Fare clic su Sessioni del contenitore per visualizzare un elenco degli appunti in esecuzione nel contenitore.
Tutti gli appunti hanno un kernel, che funge da motore di calcolo per tutte le operazioni. Osservare il valore fornito per ciascun last_activity del kernel; questo timestamp indica quanto recentemente gli appunti sono stati aperti, eseguiti o modificati.
- Se si individua un contenitore in esecuzione ma che non viene usato, valutare l'ipotesi di terminarlo. Dalla pagina delle risorse del contenitore, è possibile fare clic su Termina contenitore e confermare l'operazione.
In questo modo, si arresta e si distrugge il contenitore in esecuzione; l'operazione è irreversibile. La prossima volta che il membro del portale aprirà ArcGIS Notebook, verrà aperto un nuovo contenitore.