Di seguito, vengono riportate le procedure consigliate e alcuni promemoria per gli amministratori di ArcGIS Notebook Server.
Gestire la propria installazione
Questa sezione tratterà le procedure consigliate per gestire l'installazione di ArcGIS Notebook Server.
Risorse del computer
Quando una serie di appunti è in esecuzione, il contenitore in cui viene eseguita consuma risorse del sito ArcGIS Notebook Server. Il runtime Standard richiede 1 core CPU e 4 GB di memoria, mentre il runtime Advanced richiede 2 core CPU e 6 GB di memoria. Verificare che il sito del server disponga della capacità adeguata sul relativo computer per supportare tutti gli utenti del portale che dispongono dei privilegi degli appunti.
Federazione
ArcGIS Notebook Server deve essere federato a un portale per funzionare. Non è possibile avere un sito ArcGIS Notebook Server autonomo.
Non annullare la federazione del sito ArcGIS Notebook Server se non assolutamente necessario. L'annullamento della federazione di un sito ArcGIS Notebook Server ha conseguenze gravi e irreversibili per il contenuto del server e degli appunti.
Porte
Aprire e proteggere la porta 11443 sul computer ArcGIS Notebook Server in uso. Web Adaptor deve comunicare con questa porta e tutto il traffico deve passare attraverso Web Adaptor.
ArcGIS Notebook Server deve poter accedere alla porta 7443 sul computer che ospita il portale ArcGIS Enterprise con cui è federato. Non è necessario che la porta 7443 sia aperta sul computer ArcGIS Notebook Server.
Sulle porte da 30001 a 31000 vengono creati per impostazione predefinita contenitori Docker. Queste porte non sono esposte all'esterno del computer di ArcGIS Notebook Server e soltanto ArcGIS Notebook Server deve poter comunicare con esse.
Connessione di rete
Il componente Docker Engine, nel sito di ArcGIS Notebook Server, fornisce la rete affinché il codice negli appunti di ArcGIS Notebook possa accedere alla rete. Se ci sono problemi di connettività in una serie di appunti in esecuzione, controllare la rete Docker usando lo strumento di comando docker network come indicato di seguito:
- Utilizzare il comando docker network create per ricreare la rete, se necessario.
- Se si ricrea la rete, riassegnarla ai contenitori del sito utilizzando il comando docker network connect.
Per visualizzare un elenco di tutti i contenitori in esecuzione nel sito, utilizzare il comando docker ps -a.
Log
Si possono utilizzare i log ArcGIS Notebook Server per individuare e risolvere i problemi relativi all'esecuzione di ArcGIS Notebooks. Interrogare i log utilizzando l'Administrator Directory di ArcGIS Notebook Server. Esistono vari livelli di registrazione configurabili per visualizzare diversi tipi di informazioni.
Utenti Linux
Eseguire il controllo diagnostico prima di completare l'installazione.
Non eseguire ArcGIS Notebook Server come root.
Accesso ai controlli
Questa sezione spiega come controllare l'accesso ai componenti di installazione di ArcGIS Notebook Server.
Accesso al portale
Controllare chi ha i privilegi relativi agli appunti nel portale ArcGIS Enterprise. Ciascun membro che crea i suoi primi appunti, lancia il proprio contenitore Docker per appunti. Questa azione usa le risorse e la memoria del computer del server.
Per impostazione predefinita, soltanto gli amministratori del portale dispongono dei privilegi per creare e modificare gli appunti; gli editori non hanno tali privilegi. Creare uno o più ruoli personalizzati nel portale per assegnare i privilegi relativi agli appunti agli utenti che non hanno il ruolo di amministratore e valutare bene a chi assegnare un ruolo che comprende questi privilegi.
Accesso al sistema
La cartella arcgisworkspace creata durante l'installazione deve essere soggetta a un rigoroso controllo dell'accesso. Inizialmente solo l'utente che ha installato ArcGIS Notebook Server e gli amministratori di sistema possono accedervi. Questa cartella contiene i workspace privati degli utenti, che memorizzano dati che devono essere inaccessibili agli altri. In questo percorso vengono anche memorizzate le informazioni dei token del portale a cui i contenitori Docker possono accedere.
Per impostazione predefinita, questa directory si trova in <ArcGIS Notebook Server install directory>/usr/directories/arcgisworkspace.
Appunti condivisi
Quando si aprono degli appunti condivisi come amministratore, si dispone dei privilegi di amministratore sugli appunti, compresa la possibilità di eseguire tutte le celle. Aprire solo gli appunti provenienti da fonti attendibili ed eseguire ogni cella solo dopo averne esaminato il contenuto.
Personalizzare la propria installazione
ArcGIS Notebook Server consente di creare un sostituto per il modello di appunti predefinito per la propria organizzazione.
Cambiare il modello di appunti predefinito
ArcGIS Notebook Server include un modello di appunti predefinito, che viene visualizzato quando si aprono nuovi appunti. L'amministratore può sovrascrivere questo modello predefinito con un file di appunti personalizzato per la propria organizzazione.
Per farlo, creare il file di appunti da usare come modello predefinito per l'organizzazione e salvarlo per sovrascrivere il modello esistente, che si trova in <ArcGIS Notebook Server install directory>/framework/etc/ipynb_defaults/default_new.ipynb. Per poter essere utilizzato come modello predefinito di ArcGIS Notebook Server, il file degli appunti deve essere denominato default_new.ipynb.