Paramètres de GeoAnalytics Server

Attention :

Dans la version 10.7, les paramètres de GeoAnalytics Server ont été modifiés par rapport aux versions antérieures, de sorte qu’il suffit désormais d’appliquer un seul paramètre pour procéder à l’analyse des ressources. Dans la version 10.6.1 et les versions antérieures, il était nécessaire de définir les paramètres de la boîte d’outils GeoAnalytics. Dans la version 10.7 et les versions ultérieures, ces paramètres ne sont plus d’actualité et ne sont donc plus appliqués à des fins d’analyse.

Vous pouvez configurer plusieurs propriétés pour modifier les paramètres de GeoAnalytics Server dans votre déploiement. La configuration de ces paramètres pour votre organisation est importante en vue d’optimiser les performances du GeoAnalytics Server. Lorsque vous configurez ces paramètres, vous devez prendre en compte les ressources disponibles.

Les Outils GeoAnalytics sont optimisés par les tâches du service système GeoAnalyticsTools sur votre site ArcGIS Server. Les propriétés système ci-dessous sont définies sur le site GeoAnalytics Server. Avant de modifier des paramètres, lisez toutes les options de configuration afin de planifier votre configuration GeoAnalytics. Veillez à toujours vérifier et définir les paramètres suivants lors de la configuration d’un site GeoAnalytics Server :

• System properties (Propriétés système) : définit le pourcentage maximal de mémoire RAM et de cœurs exploitables par GeoAnalytics Server.
• Timeout of the GeoAnalyticsTools service (Expiration du service GeoAnalyticsTools) : permet de définir la durée d’exécution d’une tâche GeoAnalytics Server avant expiration.
• GeoAnalytics Server temporary file location (Emplacement de fichier temporaire) : paramètre facultatif permettant de modifier l’espace de stockage temporaire des résultats d’analyse.

L’exemple proposé dans cette rubrique fait référence à trois machines (nœuds), chacune dotée de 16 Go de RAM et de 4 cœurs de processeur. Au total, chaque site GeoAnalytics Server illustré dans cet exemple comprend 48 Go de RAM et 12 cœurs.

Propriétés système

Deux propriétés système peuvent être configurées par un administrateur de site pour allouer des ressources de mémoire et des cœurs de processeur au processus de travail de la plateforme de calcul sur chaque machine du site ArcGIS Server. Par défaut, les paramètres sont fixés à 80 % et possèdent une valeur maximale de 90 %. Voici les propriétés système configurables par un administrateur de site :

• percentageMaxAllowedComputeCores : représente le nombre maximal de cœurs de processeur (sous forme de pourcentage du total disponible sur une machine) qui sera utilisé par le processus de travail de la plateforme de calcul sur un seul nœud. Si la valeur spécifiée est inférieure à un cœur de processeur, un cœur de processeur est utilisé pour le processus de travail de la plateforme de calcul.
• percentageMaxAllowedComputeMemory : représente la mémoire maximale (sous forme de pourcentage de la mémoire totale disponible sur une machine) qui sera utilisée par le processus de travail de la plateforme de calcul sur un seul nœud.

Pour mettre à jour les propriétés système, procédez comme suit :

1. Connectez-vous au répertoire administrateur ArcGIS Server en tant qu'utilisateur doté de privilèges d'administrateur. L’URL est au format https://gisserver.domain.com:6443/arcgis/admin/.
2. Accédez à Système > Propriétés.
3. Cliquez sur Mettre à jour.
4. Par défaut, les valeurs sont fixées à 80 % et sont vides. Pour les modifier, ajoutez les propriétés au format JSON suivant : {"percentageMaxAllowedComputeCores": <value>, "percentageMaxAllowedComputeMemory": <value>} (par exemple : {"percentageMaxAllowedComputeCores": 90, "percentageMaxAllowedComputeMemory": 90}).
5. Une fois les modifications enregistrées, arrêtez et démarrez le service de la plateforme de calcul pour Spark. Accédez à system (Système) > platformservices (Services de plateforme) > Spark (Compute Platform) (Spark [Plateforme de calcul]) > Stop (Arrêter). Redémarrez la plateforme. Accédez à system (Système) > platformservices (Services de plateforme) > Spark (Compute Platform) (Spark [Plateforme de calcul]) > Start (Démarrer).
6. Réinitialisez Zookeeper et accédez à system (Système) > platformservices (Services de plateforme) > Zookeeper (Synchronization Service) (Zookeeper [Service de synchronisation]) > Reset (Réinitialiser).

Nombre minimum et maximum d'instances du service GeoAnalyticsTools

Les nombres minimum et maximum d’instances indiquent le nombre de tâches susceptibles d’être exécutées simultanément. N’augmentez pas le nombre d’instances par tâche. Pour optimiser les performances et la fiabilité, n’exécutez qu’une seule tâche à la fois.

Le nombre minimum et maximum par défaut d'instances du service GeoAnalyticsTools est défini sur une par machine ArcGIS Server sur le site. Selon le nombre de machines (n) que le site GeoAnalytics Server comprend, (n) nombre d'instances seront disponibles pour accepter les tâches GeoAnalytics. Selon le nombre d'instances et la quantité de mémoire et de cœurs de processeur alloués par tâche dans les propriétés du service, une ou plusieurs requêtes simultanées peuvent être traitées. Les requêtes supplémentaires adressées aux Outils GeoAnalytics sont mises en file d'attente jusqu'à ce que l'instance ou les ressources mémoire et du processeur deviennent disponibles. Si aucune ressource ne se libère au bout de 10 minutes, la tâche est annulée.

Expiration du service GeoAnalyticsTools

Par défaut, les tâches de longue durée traitées par le service GeoAnalyticsTools expirent au bout de 24 heures. Vous pouvez mettre à jour cette propriété afin que les outils expirent après une exécution plus ou moins longue. Vous pouvez mettre à jour la propriété relative au délai d’expiration du service GeoAnalyticsTools dans ArcGIS Server Manager en procédant comme suit.

1. Connectez-vous à ArcGIS Server Manager. L’URL est au format https://gisserver.domain.com:6443/arcgis/manager.
2. Sous l'onglet Services, sélectionnez le dossier Système.
3. Dans la liste des services disponibles, localisez le service GeoAnalyticsTools et modifiez-le.
4. Utilisez l'onglet Groupage pour définir la propriété d'expiration du service sous la section Spécifier les délais d'expiration du service. Dans Durée maximale pendant laquelle un client peut utiliser un service, utilisez la durée en secondes que vous voulez attribuer à la nouvelle propriété d'expiration.
5. Cliquez sur Enregistrer et redémarrer pour mettre à jour le service.

Emplacement de fichier temporaire GeoAnalytics Server

Lorsqu’une tâche est exécutée dans GeoAnalytics Server, des fichiers temporaires sont écrits par défaut dans le dossier \<ArcGIS Server installation directory>\server\framework\runtime\spark\work>. Les administrateurs peuvent sélectionner un autre emplacement pour les fichiers temporaires en spécifiant la propriété geoAnalyticsTempFolder comme indiqué ci-après.

Remarque :

geoAnalyticsTempFolder doit se trouver dans un répertoire local sur chaque machine du site GeoAnalytics Server et ce répertoire doit comporter un espace disque disponible considérable pour autoriser l’exécution de tâches GeoAnalytics sur des jeux de données volumineux.

1. Connectez-vous au répertoire administrateur ArcGIS Server sur le site GeoAnalytics Server en tant qu’utilisateur doté de privilèges d’administrateur. L’URL est au format http://gisserver.domain.com:6080/arcgis/admin/.
2. Accédez à Système > Propriétés.
3. Cliquez sur Mettre à jour.
4. Ajoutez la propriété au format JSON suivant : {"geoanalyticsTempFolder": "<value>"} (par exemple : {"geoanalyticsTempFolder": "/data/temp"}) Jusqu’à une minute sera nécessaire pour que le changement soit reflété sur la page des propriétés système.