Répertoires de serveur

Un répertoire de serveur permet à un site ArcGIS Server de stocker et de consigner certains types d’informations. Il existe quatre types de répertoire de serveur : cache, tâches, sortie et système.

Les répertoires de cache stockent les caches des tuiles pré-rendues que les services de carte peuvent utiliser pour optimiser la vitesse d’affichage. Une fois le service publié, vous pouvez utiliser les outils système inclus avec ArcGIS Server pour créer le cache. Les services mis en cache exigent souvent de grands espaces de stockage. Assurez-vous que vos répertoires de cache sont de taille suffisante pour traiter les tuiles créées durant le processus de mise en cache.
Les répertoires de tâches stockent les fichiers utilisés par les services de géotraitement. Les services de géotraitement nécessitent en général une certaine quantité d'espace pour enregistrer des fichiers temporaires et stocker des informations sur les tâches et résultats de tâches en cours. Ces éléments sont stockés dans le répertoire des tâches.
Les répertoires en sortie sont réservés aux fichiers temporaires requis par le serveur. Les répertoires en sortie sont requis pour les services de géotraitement, recommandés pour les services de géocodage, et facultatifs pour les services de carte et d’imagerie. Lorsque vous publiez un service ou modifiez ses propriétés dans ArcGIS Server Manager, vous pouvez choisir le répertoire de serveur en sortie qu’il utilisera.
Le répertoire système est utilisé pour gérer les informations nécessaires à la conservation des services, des sites ArcGIS Server et des connexions aux bases de données, ainsi que pour stocker les fichiers chargés sur le site ArcGIS Server. Vous ne devez pas modifier ni supprimer les fichiers de ce répertoire. Il ne peut exister qu’une seule instance de ce répertoire sur le site ArcGIS Server.

Options de stockage

Lorsque vous déployez un site ArcGIS Server, vous devez choisir un emplacement adapté pour stocker les répertoires système du site, notamment le configuration store et les répertoires de serveur.

Lorsque vous déployez des environnements sur site, stockez les répertoires système dans un partage de fichiers ou sur un appareil de stockage.
Lorsque le déploiement s’effectue dans un environnement Cloud, vous pouvez utiliser un service Cloud pour stocker les répertoires système. Cette approche est particulièrement utile lorsque vous prévoyez une mise à l’échelle au-delà d’une seule machine ou de créer un site haute disponibilité.

Autorisations et visibilité des répertoires de serveur

Lorsque vous créez un site ArcGIS Server dans ArcGIS Server Manager, les répertoires de serveur sont créés sur votre machine ArcGIS Server et le compte exécutant ArcGIS Server bénéficie d’un accès en lecture et en écriture à ces répertoires. Par défaut, les répertoires de serveur sont installés dans <ArcGIS Server installation directory>/arcgis/server/usr/directories. Vous pouvez gérer vos répertoires de serveur dans ArcGIS Server Manager en cliquant sur Site > Server Configuration (Configuration du serveur) > Directories (Répertoires).

Lorsque vous créez un site ArcGIS Server dans ArcGIS Server Manager, les répertoires de serveur sont créés sur votre machine ArcGIS Server et le compte ArcGIS Server bénéficie d’un accès en lecture et en écriture à ces répertoires. Par défaut, les répertoires de serveur sont installés dans <ArcGIS Server installation drive>\arcgisserver\directories. Vous pouvez gérer vos répertoires de serveur dans ArcGIS Server Manager en cliquant sur Site > Server Configuration (Configuration du serveur) > Directories (Répertoires).

Lors de la configuration d’un site comprenant plusieurs machines

Si vous configurez un site à plusieurs machines dans un environnement sur site, vous devez configurer les répertoires de serveur de sorte qu’ils utilisent un partage réseau avant d’ajouter des machines ArcGIS Server à votre site. Vous devez accorder au moins 700 autorisations d’accès aux dossiers.

Même si les répertoires se trouvent sur la machine que vous utiliserez pour créer le site, vous devez néanmoins les créer manuellement et les partager, puis y faire référence via un chemin d'accès au réseau.

Si vous configurez un site à plusieurs machines dans un environnement sur site, vous devez configurer les répertoires de serveur de sorte qu’ils utilisent des chemins UNC avant d’ajouter des machines ArcGIS Server à votre site.

Assurez-vous que le compte ArcGIS Server dispose d’autorisations en lecture et en écriture sur le dossier partagé.

Sous Windows, ces autorisations doivent être définies sur les onglets Share (Partage) et Security (Sécurité) de la boîte de dialogue des propriétés du dossier.

Bien qu’il soit possible de partager les emplacements existants pour le répertoire de configuration et les répertoires de serveur, il est conseillé de les déplacer vers un serveur de fichiers tolérant aux pannes. Cela est particulièrement important dans le cadre des déploiements dans le cloud où les mécanismes de mise à l’échelle automatique risquent d’ajouter et de supprimer des machines de votre site sans aucune information permettant d’identifier celle faisant office d’emplacement de la configuration.

Bien qu’il soit possible de partager les emplacements avec lettre d’unité existants pour le répertoire de configuration et les répertoires de serveur, il est conseillé de les déplacer vers un serveur de fichiers tolérant aux pannes. Cela est particulièrement important dans le cadre des déploiements dans le cloud où les mécanismes de mise à l’échelle automatique risquent d’ajouter et de supprimer des machines de votre site sans aucune information permettant d’identifier celle faisant office d’emplacement de la configuration.

Remarque :

ArcGIS Server ne prend pas en charge les répertoires partagés sur le réseau qui sont masqués ou qui utilisent des caractères spéciaux (comme $).

Spécifier les emplacements des répertoires de serveur dans ArcGIS Server Manager

Vous pouvez changer l’emplacement des répertoires de serveur dans ArcGIS Server Manager en procédant comme indiqué ci-après. Note que l'exécution de ces étapes entraînera une période d'indisponibilité du serveur.

Ouvrez ArcGIS Server Manager et connectez-vous.
Cliquez sur Site > Server Configuration (Configuration du serveur) > Directories (Répertoires).
Cliquez sur le bouton Edit (Modifier) de chaque répertoire et saisissez le nouveau chemin partagé du répertoire.

Lorsque vous modifiez le chemin d'accès à un répertoire, le contenu de ce répertoire est copié au nouvel emplacement, s'il ne s'agit pas d'un répertoire de cache. Si vous déplacez un répertoire de cache, vous devez copier manuellement le cache au nouvel emplacement.

Nettoyage d’un répertoire de serveur

ArcGIS Server supprime (ou nettoie) régulièrement les fichiers inutiles et anciens des répertoires des tâches, en sortie et système afin d’éviter qu’ils n’occupent trop d’espace disque. Les répertoires de cache ne sont pas nettoyés, car leur contenu doit toujours être disponible.

Comment le nettoyage des répertoires est-il effectué par le serveur ?

Lorsque ArcGIS Server tente de supprimer un fichier d’un répertoire de serveur, il vérifie si le temps écoulé depuis la dernière fois où le fichier a été modifié est supérieur à l’âge maximal du fichier. Si c'est le cas, le fichier est supprimé et le serveur passe au fichier suivant dans le répertoire. Dans le cas contraire, le fichier est conservé dans le répertoire.

Par défaut, les répertoires de tâches, en sortie et système du serveur sont nettoyés selon les critères suivants :


Répertoire	Mode de nettoyage	Age maximal de fichier
tâches	Durée depuis la dernière modification	360 minutes (6 heures)
sortie	Durée depuis la dernière modification	10 minutes
système	Durée depuis la dernière modification	1 440 minutes (24 heures)

Par exemple, si un fichier dans le répertoire en sortie n’a pas été modifié dans les 10 minutes suivant sa création, il est supprimé durant le processus de nettoyage, car il a dépassé l’âge de fichier maximal permis. Vous pouvez configurer le mode de nettoyage et l’âge de fichier maximal selon les besoins de votre site.

Outre le mode de nettoyage et l’âge maximal d’un fichier, les répertoires de tâches, en sortie et système ont leur propre ensemble de règles de nettoyage, par exemple :

Lors du nettoyage d’un répertoire de tâches, ArcGIS Server supprime une tâche seulement si elle est terminée, si elle a été annulée, ou si elle a échoué.
Lors du nettoyage d’un répertoire en sortie, ArcGIS Server supprime des fichiers et des dossiers seulement si leur nom commence par _ags.
Lors du nettoyage du répertoire système, ArcGIS Server ne supprime des éléments que s’ils ont été entièrement téléchargés sur le serveur.

Régler ou désactiver le nettoyage des répertoires

Vous pouvez régler ou désactiver le nettoyage des répertoires de serveur pour les répertoires de tâches, en sortie et système à l’aide d’ArcGIS Server Manager. Pour en savoir plus, reportez-vous à la rubrique Mettre à jour un répertoire de serveur dans Manager ArcGIS Server Manager.

Accéder aux répertoires de serveur avec une URL

ArcGIS Server vous permet d’accéder à des éléments des répertoires de serveur à l’aide de chemins virtuels ou d’URL.

L’URL du répertoire prend la forme https://gisserver.example.com:6443/arcgis/rest/directories/<directory name>.

Par exemple, s’il existe une image en sortie dans opt/arcgis/server/usr/directories/arcgisoutput/<YourServiceName>/_ags_map00c6dac961024efeb14067f990a38d5f.png, elle est accessible via l’URL suivante :

Par exemple, s’il existe une image en sortie dans c:\arcgisserver\directories\arcgisoutput\<YourServiceName>_ags_map00c6dac961024efeb14067f990a38d5f.png, elle est accessible via l’URL suivante :

https://gisserver.example.com:6443/arcgis/rest/directories/arcgisoutput/<YourServiceName>/_ags_map00c6dac961024efeb14067f990a38d5f.png

Vous pouvez cliquer sur l’onglet Directories (Répertoires) dans ArcGIS Server Manager pour obtenir des informations supplémentaires sur l’URL de chacun de vos répertoires de serveur.

Conseil :

ArcGIS Web Adaptor vous permet de personnaliser l’URL ci-dessus pour ne plus avoir à utiliser le port 6443 ou arcgis.

Définir la sécurité de l’accès à l’URL du répertoire

Le répertoire administrateur d’ArcGIS Server vous permet de définir la sécurité du contenu accessible dans vos répertoires de serveur via une URL (par exemple, arcgisoutput et arcgisjobs) :

Pour exiger une authentification sur votre site ArcGIS Server lors de l’accès aux URL des répertoires de serveur des services sécurisés, ouvrez l’opération Update Security Configuration (Mettre à jour la configuration de sécurité) et définissez le paramètre virtualDirsSecurityEnabled sur true.
Pour exiger l’authentification lors de l’accès à des points de terminaison d’URL des répertoires de serveur pour un service sécurisé particulier, à partir de la version 10.8.1, vous pouvez mettre à jour le service et ajouter le paramètre virtualDirsSecurityEnabled afin de le définir sur true. Cela n’affecte en rien les paramètres de sécurité du contenu du répertoire des autres services.