Configurer Insights in ArcGIS Enterprise

Insights in ArcGIS Enterprise

En tant qu’administrateur Insights in ArcGIS Enterprise, vous pouvez ajouter un fichier de configuration de l’application pour préciser diverses options. Le fichier de configuration doit être nommé insights.json et placé à l’emplacement suivant dans ArcGIS Server : ArcGIS Server install directory\framework\etc\insights.json. Les options disponibles sont décrites ci-dessous.

Paramètres d'administration

Les propriétés suivantes sont utilisées pour définir les options.

PropriétéDescription

max_feature_copy_limit

Contrôle la taille maximale d’une couche d’entités distantes pouvant être copiée dans le stockage de données relationnelles ou une base de données. Si le nombre d’enregistrements dans le jeu de données dépasse cette valeur, les opérations nécessitant la copie de données renvoient une erreur. Les valeurs acceptables sont des entiers, la valeur par défaut est 250 000. Il s'agit d'une valeur de propriété d’entier qui ne requiert pas de guillemets.

Remarque :

Cette limite s’applique aux couches d’entités distantes accessibles via un proxy, aux couches accessibles à partir d’un déploiement ArcGIS Enterprise pour lequel Insights n’est pas installé, et aux couches dont le portail d’hébergement ne peut pas être déterminé.

Si la limite est dépassée, le message d’erreur suivant s’affiche : The dataset contains too many records. Try reducing the size of your dataset. (Le jeu de données contient trop d’enregistrements. Essayez de réduire la taille de votre jeu de données). Vous pouvez réduire la taille de votre jeu de données à l’aide d’un filtre attributaire ou d’un filtre spatial.

Exemple : "max_feature_copy_limit": 250000

database_timeout

Contrôle la durée en secondes pendant laquelle s’effectue une opération utilisant les données d’une connexion à une base de données avant d’expirer. Si la durée d’exécution d’une opération dépasse cette valeur, l’opération renvoie une erreur. Les valeurs acceptables sont des entiers ; la valeur par défaut est 120 secondes. Il s'agit d'une valeur de propriété d’entier qui ne requiert pas de guillemets.

Exemple : "database_timeout": 120

Remarque :

Les opérations réalisées avec les bases de données SAP HANA n’ont pas de délai d’expiration. La propriété database_timeout n’est pas appliquée à SAP HANA.

task_timeout_secs

Gère la durée en secondes pendant laquelle s’effectue une opération planifiée avant d’expirer. Si la durée d’exécution de la mise à jour planifiée dépasse cette valeur, l’opération renvoie une erreur. Les valeurs admises sont des entiers ; la valeur par défaut est 1 800 secondes (30 minutes). Il s'agit d'une valeur de propriété d’entier qui ne requiert pas de guillemets.

Exemple : "task_timeout_secs": 1800

allow_running_tasks_without_sandboxing

Remarque :

Ce paramètre concerne uniquement les déploiements Linux.

Indique si les tâches de planification s’exécutent en mode sandbox. Les valeurs acceptables sont true ou false ; la valeur par défaut est false. Il s’agit d’une propriété booléenne qui ne nécessite pas de guillemets.

Exemple : "allow_running_tasks_without_sandboxing": false

max_concurrent_task_runners

Gère le nombre de tâches planifiées susceptibles d’être effectuées en même temps. Si le nombre de tâches planifiées dépasse le seuil maximum, elles sont mises en file d’attente jusqu’à ce qu’elles puissent être traitées. Les valeurs acceptables sont des entiers, la valeur par défaut est 4. Il s'agit d'une valeur de propriété d’entier qui ne requiert pas de guillemets.

Exemple : "max_concurrent_task_runners": 4

enforce_database_connection_sharing_permission

Détermine si une connexion à une base de données doit être partagée lorsqu’un rapport référençant des données de la connexion est partagé. Les valeurs admises sont true ou false ; la valeur par défaut est true. Il s’agit d’une propriété booléenne qui ne nécessite pas de guillemets.

Si la propriété est définie sur true, vous devrez partager la connexion à la base de données au même niveau que les rapports utilisant ses données (par exemple, si le rapport est partagé avec le public, la base de données doit également l'être). Si la propriété a pour valeur false, il n’est pas nécessaire de partager la connexion à la base de données. Toutefois, les utilisateurs ayant accès au rapport ont également accès aux tables vues sur la page.

Exemple : "enforce_database_connection_sharing_permission":true

Modifier les paramètres

Procédez comme suit pour configurer les paramètres de Insights in ArcGIS Enterprise :

  1. Créez un fichier nommé insights.json.
  2. Ajoutez les paramètres à configurer à un objet unique dans le fichier .json.
  3. Copiez le fichier insights.json vers \framework\etc\.
  4. Redémarrez ArcGIS Server.
  5. Si votre implémentation Insights in ArcGIS Enterprise comprend plusieurs instances ArcGIS Server, répétez les étapes 3 et 4 pour chaque instance ArcGIS Server de votre site.

    Les paramètres doivent être identiques sur tous les serveurs.

Remarque :

Vérifiez que le fichier insights.json contient du code JSON valide. Les paramètres ne prendront pas effet si le fichier n’est pas au bon format.

Si vous souhaitez restaurer les paramètres administratifs par défaut, vous pouvez le faire en supprimant insights.json et en redémarrant ArcGIS Server. Répétez ces actions pour chaque instance ArcGIS Server de votre site.

Exemple

Contenu du fichier insights.json lors de la configuration d’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 
}

Utiliser le mode sandbox

Remarque :

Les paramètres sandbox sont utilisés dans les déploiements Linux uniquement.

Les mises à jour planifiées pour les rapports publiés nécessitent l’exécution d’un code JavaScript, dans une version spéciale du navigateur Chromium. Chromium est doté d’une fonctionnalité de sécurité appelée sandbox qui offre une garantie de sécurité supplémentaire au cas où le code exécuté par le navigateur pourrait contourner l’une de ses propres restrictions de sécurité. Elle opère en isolant le traitement du reste du système via le sandbox namespace ou le sandbox setuid.

Le sandbox namespace impose de demander au noyau d’effectuer un clone de l’espace de noms utilisateur non privilégié. Si l’indicateur de noyau est pris en charge sur votre système, demandez à votre administrateur sont avis quant à l’activation de cette fonctionnalité à l’aide du code suivant :

sudo sysctl -w kernel.unprivileged_userns_clone=1

Si le sandbox namespace n’est pas prise en charge, vous pouvez configurer le sandbox setuid à la place.

Les actions effectuées par le standbox setuid nécessitent des privilèges racine. Par conséquent, il doit être configuré de façon éviter qu’il soit utilisé en tant que racine (« root »).

  1. Localisez le fichier chrome-sandbox de votre installation ArcGIS Server à l’aide du chemin suivant : framework/runtime/insights/linux/
  2. Attribuez au propriétaire la valeur root à l’aide de la commande suivante : sudo chown root chrome-sandbox.
  3. Autorisez quiconque à exécuter chrome-sandbox en tant que propriétaire (root) à l’aide de la commande suivante : sudo chmod 4755 chrome-sandbox.

En dernier recours, si vos mises à jour planifiées échouent du fait de l’absence d’un sandbox actif, cette fonctionnalité de sécurité peut être désactivée à l’aide du paramètre Insights allow_running_tasks_without_sandboxing. Ce paramètre est ignoré si un sandbox est en cours de fonctionnement. Dans le cas contraire, les tâches s’exécuteront sans sandbox de niveau système.

Esri Programme d’amélioration de l’expérience utilisateur

Le programme d’amélioration de l’expérience des utilisateurs Esri collecte des informations sur la manière dont les utilisateurs emploient le logiciel en vue de l’améliorer.

Les administrateurs peuvent désactiver le programme au cours du processus d’installation. Si le processus d’installation de Insights in ArcGIS Enterprise est terminé, vous pouvez configurer les paramètres de manière à interrompre la participation au programme.

Configurer les paramètres pour Windows

Si vous installez Insights in ArcGIS Enterprise sous Windows, vous pouvez désélectionner l’option Click here to participate in the Esri User Experience Improvement program (Cliquez ici pour participer au programme d’amélioration de l’expérience des utilisateurs Esri) dans l’assistant d’installation pour ne plus participer au programme.

Vous pouvez configurer les paramètres du programme d’amélioration de l’expérience des utilisateurs Esri à l’aide du fichier de paramètres (<portal_install_dir>/apps/insights/settings.json). Pour désactiver le programme, définissez le paramètre eueiEnabled: "true" sur eueiEnabled: "false".

Configurer les paramètres pour Linux

Si vous installez Insights in ArcGIS Enterprise sous Linux, vous pouvez exécuter la commande d’installation ./Insights-Setup.sh -e No pour désactiver le programme d’amélioration de l’expérience des utilisateurs Esri.

Vous pouvez configurer les paramètres du programme d’amélioration de l’expérience des utilisateurs Esri à l’aide du fichier de paramètres (<portal_install_dir>/apps/insights/settings.json). Pour désactiver le programme, définissez le paramètre eueiEnabled: "true" sur eueiEnabled: "false".