Configurare Insights in ArcGIS Enterprise

Insights in ArcGIS Enterprise

In qualità di amministratore di Insights in ArcGIS Enterprise, è possibile aggiungere un file di configurazione dell'applicazione per specificare diverse opzioni. Il file di configurazione deve essere denominato insights.json e inserito nel seguente percorso su ArcGIS Server: ArcGIS Server install directory\framework\etc\insights.json. Le opzioni disponibili sono descritte di seguito.

Impostazioni amministrative

Le seguenti proprietà sono utilizzate per definire opzioni.

ProprietàDescrizione

max_feature_copy_limit

Controlla la dimensione massima di un feature layer remoto che può essere copiato nel Data Store relazionale o in un database. Se il numero di record nel dataset supera questo valore, le operazioni che richiedono dati da copiare restituiscono un errore. I valori accettabili sono interi; l'impostazione predefinita è 250.000. Questo è un valore della proprietà Intero e non richiede virgolette.

Nota:

Questo limite si applica ai feature layer remoti a cui si accede attraverso un proxy, ai layer a cui si accede da un'installazione ArcGIS Enterprise che non ha installato Insights, e ai layer il cui portale di hosting non può essere determinato.

Se viene superato il limite, verrà visualizzato il seguente messaggio di errore: Il dataset contiene un numero eccessivo di record. Provare a ridurre le dimensioni del dataset. È possibile ridurre le dimensioni del dataset utilizzando un filtro attributo o un filtro spaziale.

Esempio: "max_feature_copy_limit": 250000

database_timeout

Gestisce la durata del tempo in secondi che passeranno prima che un'operazione che utilizza dati da una connessione di database vada in timeout. Se la durata del tempo per eseguire un'operazione supera questo valore, l'operazione restituirà un errore. I valori accettabili sono interi; l'impostazione predefinita è 120 secondi. Questo è un valore della proprietà Intero e non richiede virgolette.

Esempio: "database_timeout": 120

Nota:

Le operazioni eseguite con database SAP HANA non hanno limiti di timeout. La proprietà database_timeout non verrà applicata a SAP HANA.

task_timeout_secs

Gestisce la durata del tempo per l'esecuzione di un'attività programmata in secondi prima del timeout. Se la durata del tempo per eseguire l'aggiornamento programmato supera questo valore, l'operazione restituirà un errore. I valori accettabili sono interi; l'impostazione predefinita è 1800 secondi (30 minuti). Questo è un valore della proprietà Intero e non richiede virgolette.

Esempio: "task_timeout_secs": 1800

allow_running_tasks_without_sandboxing

Nota:

Questa impostazione è esclusivamente per le installazioni Linux.

Controlla se le attività programmate vengono eseguite con sandbox. I valori accettabili sono true o false; il valore predefinito è false. Questa è una proprietà booleana e non richiede le virgolette.

Esempio: "allow_running_tasks_without_sandboxing": false

max_concurrent_task_runners

Controlla il numero di attività programmate che possono essere eseguite contemporaneamente. Se il numero di attività programmate per l'esecuzione supera il massimo, le attività verranno messe in coda fino al completamento di un'altra attività. I valori accettabili sono interi; l'impostazione predefinita è 4. Questo è un valore della proprietà Intero e non richiede virgolette.

Esempio: "max_concurrent_task_runners": 4

enforce_database_connection_sharing_permission

Controlla se una connessione a un database deve essere condivisa quando un report che fa riferimento a dei dati dalla connessione è condiviso. Valori accettabili sono true o false; il valore predefinito è true. Questa è una proprietà booleana e non richiede le virgolette.

Se la proprietà è impostata su true, sarà richiesto di condividere la connessione al database allo stesso livello dei report che usano i suoi dati (per esempio, se il report è condiviso con il pubblico, il database deve anche essere condiviso con il pubblico). Se la proprietà è impostata su false, allora la connessione a database non necessiterà di essere condivisa. Comunque, gli utenti con acceso al report avranno accesso anche alle tabelle viste sulla pagina.

Esempio: "enforce_database_connection_sharing_permission":true

Modificare le impostazioni

Completare i passaggi seguenti per configurare le impostazioni per Insights in ArcGIS Enterprise:

  1. Creare un file denominato insights.json.
  2. Aggiungere le impostazioni che si desidera configurare a un singolo oggetto nel file .json.
  3. Copiare il file insights.json in \framework\etc\.
  4. Riavviare ArcGIS Server.
  5. Se l'implementazione di Insights in ArcGIS Enterprise include più ArcGIS Server, ripetere i passi 3 e 4 per ciascun ArcGIS Server nel sito.

    Le impostazioni devono essere identiche su tutti i server.

Nota:

Accertarsi che il file insights.json contenga codice JSON valido. Le impostazioni non saranno effettive se il file non è formattato correttamente.

Se si desidera ripristinare le impostazioni amministrative predefinite, è possibile farlo eliminando insights.json e riavviando ArcGIS Server. Accertarsi di ripetere queste azioni su ciascun ArcGIS Server nel sito.

Esempio

Contenuti del file insights.json durante la configurazione di enrich_max_features, locate_geocode_max_features, buffer_network_max_features, max_feature_copy_limit:

{  
"enrich_max_features": 10000,  
"locate_geocode_max_features": 10000,  
"buffer_network_max_features": 1000,
"max_feature_copy_limit": 500000 
}

Utilizzare sandbox

Nota:

Le impostazioni della sandbox vengono utilizzate solo nelle installazioni di Linux.

Gli aggiornamenti programmati per i report pubblicati richiedono l'esecuzione del codice JavaScript, che viene eseguito con una speciale build del browser Chromium. Chromium dispone di una funzione di sicurezza chiamata sandbox, che agisce come sicurezza aggiuntiva nel caso in cui il codice che il browser sta eseguendo sia in grado di bypassare qualsiasi delle proprie restrizioni di sicurezza. Funziona isolando il processo dal resto del sistema tramite la namespace sandbox o la setuid sandbox.

La namespace sandbox richiede di chiedere al kernel di eseguire un clone di namespace utente non privilegiato. Se il flag del kernel è supportato sul sistema, verificare con l'amministratore l'abilitazione di questa feature attraverso la seguente procedura:

sudo sysctl -w kernel.unprivileged_userns_clone=1

Se la namespace sandbox non è supportata, è possibile impostare invece la setuid sandbox.

Le azioni eseguite dalla setuid sandbox richiedono privilegi radice. Pertanto, deve essere configurato in modo che chiunque possa eseguirlo come radice.

  1. Posizionare il file della chrome-sandbox nella propria installazione ArcGIS Server sul percorso seguente: framework/runtime/insights/linux/
  2. Cambia il proprietario in radice utilizzando il seguente comando: sudo chown root chrome-sandbox.
  3. Consentire a chiunque di eseguire chrome-sandbox come proprietario (radice) usando il seguente comando: sudo chmod 4755 chrome-sandbox.

Come ultima risorsa, se gli aggiornamenti programmati non vengono eseguiti perché non esiste una sandbox funzionante, questa feature di sicurezza può essere disabilitata con l'impostazione Insights allow_running_tasks_without_sandboxing. Se una sandbox funziona, questa impostazione viene ignorata. In caso contrario, le attività verranno eseguite senza una sandbox a livello di sistema.

Programma per il miglioramento dell'esperienza utente di Esri

Il programma per il miglioramento dell'esperienza utente Esri raccoglie informazioni sull'uso dei dati al fine di apportare miglioramenti al software.

Gli amministratori possono revocare l'adesione al programma durante la procedura di installazione. Una volta completata la procedura di installazione di Insights in ArcGIS Enterprise, è possibile modificare le impostazioni per interrompere la partecipazione al programma.

Configura le impostazioni per Windows

Se si sta eseguendo l'installazione di Insights in ArcGIS Enterprise su Windows, è possibile deselezionare la casella Clicca qui per partecipare al Programma per il miglioramento dell'esperienza utente Esri durante la procedura guidata.

Le impostazioni relative al programma per il Miglioramento dell'Esperienza Utente Esri possono essere configurate utilizzando il file delle impostazioni (<portal_install_dir>/apps/insights/settings.json). Per revocare l'adesione al programma, modificare l'impostazione da eueiEnabled: "true" a eueiEnabled: "false".

Configura le impostazioni per Linux

Se si sta eseguendo l'installazione di Insights in ArcGIS Enterprise su Linux, è possibile eseguire il comando di installazione ./Insights-Setup.sh -e No per revocare il programma di Miglioramento dell'Esperienza Utente Esri.

Le impostazioni relative al programma per il Miglioramento dell'Esperienza Utente Esri possono essere configurate utilizzando il file delle impostazioni (<portal_install_dir>/apps/insights/settings.json). Per revocare l'adesione al programma, modificare l'impostazione da eueiEnabled: "true" a eueiEnabled: "false".