Skip to main content

Opérations de l’administrateur ArcGIS Data Pipelines Server

Les sections suivantes décrivent les outils et les propriétés disponibles pour les administrateurs ArcGIS Data Pipelines Server. Chaque outil ou propriété est décrit, ainsi que son chemin. Les outils disponibles dans le répertoire d’installation se trouvent dans l’emplacement <ArcGIS Data Pipelines Server install directory>\tools, et les opérations situées sur le site d’administration d’ArcGIS Data Pipelines Server sont accessibles via l’URL https://machine.domain.com:14443/arcgis/admin.

Mettre à jour les propriétés du système

Les administrateurs peuvent mettre à jour les propriétés d’ArcGIS Data Pipelines Server en fonction des besoins de leur organisation. Les valeurs des propriétés personnalisées peuvent être définies à l’emplacement https://machine.domain.com:14443/arcgis/admin/system/properties/update. Les propriétés suivantes sont disponibles pour la configuration :

  • maxWorkersPerMachine : utilisez cette propriété pour augmenter ou diminuer le nombre de workers pouvant être actifs simultanément. Les workers sont les ressources de calcul allouées pour alimenter l’éditeur Data Pipelines, les exécutions de tâches planifiées et les exécutions de pipeline de données autonomes.

  • maxMemoryPerWorkerInMiB : utilisez cette propriété pour augmenter ou diminuer la quantité de mémoire que chaque worker peut utiliser. Par exemple, si vous traitez de grandes quantités de données, vous devrez peut-être augmenter cette valeur pour que les exécutions aboutissent.

  • reservedInteractiveWorkersPerMachine : utilisez cette propriété pour augmenter ou diminuer le nombre de workers réservés à la création interactive dans l’éditeur Data Pipelines. Par exemple, si vous disposez d’un site ArcGIS Data Pipelines Server à une seule machine et que la propriété maxWorkersPerMachine est définie sur 6, deux de ces workers seront réservés par défaut spécifiquement pour l’utilisation de l’éditeur de Data Pipelines, et quatre seront disponibles pour les exécutions de tâches planifiées et les exécutions de pipelines de données autonomes.

  • allowedHosts : utilisez cette propriété pour spécifier les hôtes qui peuvent être utilisés pour lire les données lors de l’utilisation de l’entrée URL. La valeur par défaut est Aucun (""). Il est recommandé de spécifier une liste d’hôtes pour lesquels l’accès en lecture est autorisé. Indiquez, par exemple, les hôtes dans une liste, comme suit :

"allowedHosts": "exampleHost.com, mydata.org, www.test.ca"

Pour autoriser les utilisateurs à lire les données de tous les hôtes, spécifiez la valeur générique `(.*)`. Utilisez les caractères génériques (`*`) avec prudence, car ils permettent aux utilisateurs de lire les données de n’importe quel hôte. Par exemple, pour autoriser la lecture depuis tous les hôtes, spécifiez les éléments suivants :

`"allowedHosts": "(.*)"`

Si une URL redirige vers un autre hôte, les deux hôtes doivent être spécifiés dans la liste des hôtes autorisés.

  • allowedFileSharePaths : cette propriété permet de spécifier les chemins de partage de fichiers accessibles via l’entrée File share (Partage de fichiers). Par défaut, tous les partages de fichiers accessibles via le compte ArcGIS Data Pipelines Server peuvent être utilisés dans l’entrée File share (Partage de fichiers). Certains répertoires sont toujours restreints, notamment les répertoires d’installation et les répertoires gérés par le système ou protégés par le système d’exploitation.

    Par exemple, pour autoriser l’accès à deux partages réseau différents, spécifiez la propriété suivante :

    "allowedFileSharePaths": [ "\\\\network_path\\my_data", "\\\\other_network_path\\my_other_data"]

    "allowedFileSharePaths": [ "/net/my_network/my_data", "/other_network_path/my_other_data"]

    Pour bloquer l’accès à tous les partages de fichiers, spécifiez une liste vide ([]), comme suit :

    "allowedFileSharePaths": []

    Remarque :

    Pour les sites ArcGIS Data Pipelines Server à une seule machine, les disques locaux, tels que c:\, sont pris en charge. Pour les sites à plusieurs machines, les disques locaux ne sont pas pris en charge. Vous devez utiliser des chemins réseau partagés accessibles par toutes les machines du site.

Importer un certificat de serveur existant

Pour importer un certificat de serveur existant, cliquez sur Home (Accueil) > Machines > MachineName > sslCertificates > importExistingServerCertificate.

Cette opération importe un certificat de serveur existant dans le fichier KeyStore. Si le certificat est un certificat signé par une autorité de certification, vous devez d’abord importer le certificat racine de l’autorité de certification ou un certificat intermédiaire à l’aide de l’opération importRootOrIntermediate.

Importer un certificat racine

Pour importer un certificat racine, cliquez sur Home (Accueil) > Machines > MachineName > sslCertificates > importRootOrIntermediate.

Cette opération importe le certificat racine et le certificat intermédiaire d’une autorité de certification dans le fichier KeyStore. Pour créer un certificat signé par une autorité de certification de qualité production, ajoutez les certificats de l’autorité de certification au fichier KeyStore qui active le mécanisme SSL pour approuver l’autorité de certification (et les certificats qu’elle a signés). Même si la plupart des certificats des autorités de certification connues sont déjà disponibles dans le fichier KeyStore, vous pouvez utiliser cette opération si vous disposez de certificats d’une autorité de certification personnalisée ou de certificats intermédiaires spécifiques.

Mettre à jour la configuration de sécurité

Pour mettre à jour la configuration de sécurité, cliquez sur Home (Accueil) > Security (Sécurité) > SecurityConfig > UpdateSecurityConfig.

Cette opération met à jour la configuration de sécurité, notamment les protocoles TLS et les suites de chiffrement, pour votre site ArcGIS Data Pipelines Server. Cette opération entraîne le redéploiement des extrémités des services REST sur chaque machine serveur du site. Si vous avez mis à jour le protocole de communication dans le cadre de cette opération, une minute est nécessaire à ArcGIS Web Adaptor pour reconnaître les modifications apportées au protocole de communication de votre site.

Annuler l’inscription d’une machine sur un site

Avant de retirer une machine ArcGIS Data Pipelines Server d’un site, tenez compte des points suivants :

  • Si des ressources de calcul actives sont exécutées sur la machine que vous retirez, elles sont arrêtées et la progression de tout pipeline de données en cours est perdue. Il est recommandé d’attendre que tous les processus soient arrêtés ou de les arrêter activement avant de retirer une machine du site. Pour arrêter activement les ressources de calcul dans l’application Data Pipelines, tous les utilisateurs doivent se déconnecter de l’éditeur et les exécutions de tâche actives.

    Pour arrêter activement les ressources de calcul à l’aide de l’API REST, accédez à https://machine.domain.com:14443/arcgis/rest/services/datapipelines/computeresources/<compute resource id> et cliquez sur terminate. Pour les ressources de calcul dont la valeur MODE est INTERACTIVE, l’arrêt déconnecte tous les éditeurs connectés associés à la ressource de calcul. Pour les ressources de calcul dont la valeur MODE est JOB, l’arrêt annule l’exécution associée.

  • Une fois que vous avez retiré une machine du site, il est recommandé d’arrêter le service ArcGIS Data Pipelines Server et d’éteindre ou de redémarrer la machine. De la sorte, plus aucun processus ArcGIS Data Pipelines Server ne fonctionne encore.

  • Si une instance ArcGIS Web Adaptor est inscrite auprès d'un site, elle peut mettre du temps à détecter qu'une machine a été supprimée. Par défaut, l'adaptateur Web vérifie toutes les minutes si des machines ont été ajoutées ou supprimées du site. Par exemple, selon le moment où vous avez supprimé une machine, l'adaptateur Web ne détectera pas la machine supprimée avant sa prochaine vérification du site. Pendant cet intervalle, les demandes seront toujours transmises à la machine supprimée. Ceci peut entraîner l'échec des demandes et l'écriture d'événements sur les journaux du serveur.

    Pour éviter ce problème potentiel, vous pouvez forcer l'adaptateur Web à détecter la machine supprimée en le reconfigurant. Pour des instructions, reportez-vous à la rubrique Installer et configurer ArcGIS Web Adaptor pour ArcGIS Data Pipelines Server.

  • Si vous n’avez qu’une seule machine ArcGIS Data Pipelines sur le site et que vous la supprimez, le site est également supprimé. Vous êtes redirigé vers une page dans laquelle il vous est demandé si vous souhaitez créer un site ou rejoindre un site existant. N’oubliez pas que vos services et paramètres existants sont conservés dans le stockage de la configuration. Si vous souhaitez recréer le site sur une autre machine, référencez le stockage de la configuration existant lors de la création du site.

Pour annuler l’inscription d’une machine sur un site, cliquez sur Home (Accueil) > Machines > Machine name (Nom de la machine) > Unregister (Désinscrire).

Supprimer un site

Pour supprimer un site, cliquez sur Home (Accueil) > Delete Site (Supprimer un site).

Cette opération supprime la configuration du site et libère toutes les ressources serveur. Indiquée pour les serveurs de développement ou de test qui ont besoin d’être nettoyés régulièrement, elle peut également être exécutée avant une désinstallation. Utilisez cette option avec prudence, car elle supprime tous les paramètres et autres configurations et elle est irréversible.

Cette opération effectue les tâches suivantes :

  • Toutes les machines serveur actives sur le site sont arrêtées.

  • Toutes les machines serveur sont désinscrites du site.

  • Le répertoire de configuration est supprimé.

Configurer ArcGIS Web Adaptor

Pour configurer ArcGIS Web Adaptor, cliquez sur Home (Accueil) > System (Système) > Web Adaptors > Configuration.

La configuration d’ArcGIS Web Adaptor est une ressource pour tous les paramètres de configuration partagés par les adaptateurs Web du site. Cette ressource identifie la clé partagée par tous les Web Adaptors pour chiffrer les bits de données de clé dans les demandes entrantes du serveur.

Sauvegarder le site

Il est recommandé d’exporter fréquemment les paramètres de votre site au moyen de l’API d’administration. Pour ce faire, accédez à Home (Accueil) > Export Site (Exporter un site). Au moment de définir une propriété destination pour le site exporté, il est recommandé de choisir un lecteur réseau ou un autre emplacement que la machine exécutant ArcGIS Data Pipelines Server. La destination doit être un emplacement accessible à la machine ArcGIS Data Pipelines Server. En cas de défaillance du site, il est possible de le récupérer en créant un nouveau site de serveur puis en accédant à Home (Accueil) > Import Site (Importer un site).

Remarque :

Si votre site ArcGIS Data Pipelines Server est constitué de plusieurs machines, il suffit d’importer le site une seule fois comme indiqué ci-dessus et de joindre normalement d’autres machines ArcGIS Data Pipelines Server au site.

Mettre à jour les paramètres des journaux

Pour mettre à jour les paramètres des journaux, cliquez sur Home (Accueil) > Logs (Journaux) > Settings (Paramètres) > Edit (Mettre à jour).

Cette procédure met à jour les paramètres des journaux pour l’ensemble du site Server, comme la localisation en sortie, le niveau et le format des journaux ainsi que l’ancienneté des fichiers journaux.