configuredatastore

Cet utilitaire est utilisé pour tous les types ArcGIS Data Store.

Une fois que vous avez installé ArcGIS Data Store, vous pouvez exécuter l’utilitaire configuredatastore plutôt que l’application de configuration Data Store pour créer un data store et l’inscrire sur un site GIS Server. Vous pouvez créer les types suivants de data store à l’aide de cet utilitaire :

Vous pouvez également utilisez l’utilitaire configuredatastore dans les cas suivants :

Pour mettre à niveau un data store après avoir mis à jour le logiciel ArcGIS Data Store sur toutes les machines du data store.
Pour désigner le rôle d’une machine dans un Spatiotemporal Big Data Store.
Changez le mode de déploiement d’un graph store ou d’un object store existant en mode une seule instance.

Syntaxe

configuredatastore <ArcGIS Server host name> <ArcGIS Server administrator> <ArcGIS Server administrator password> <data store content directory> [--stores {relational | spatiotemporal | graph | object}] [--mode {singleInstance | cluster}] [--roles {coord | data}]


Option	Description
`<ArcGIS Server host name>`	Site GIS Server qui est utilisé ou sera utilisé comme serveur d’hébergement ArcGIS Enterprise. Fournissez l’un des éléments suivants : Le nom de domaine complet de l’une des machines présentes sur le site du serveur d’hébergement, au format `gisserver.example.com` L’URL du site du serveur d’hébergement au format `https://gisserver.example.com:6443` Remarque : Même si le site GIS Server utilise un adaptateur Web ou un équilibreur de charge, vous devez spécifier l’URL au format indiqué ci-dessus. L’adresse IP de l’une des machines présentes sur le site du serveur d’hébergement
`<ArcGIS Server administrator>`	Indiquez le nom d’utilisateur d’un utilisateur intégré (et non propre à l’organisation) disposant des privilèges d’administrateur sur le site GIS Server d’hébergement.
`<ArcGIS Server administrator password>`	Indiquez le mot de passe du compte utilisé ci-dessus.
`<data store content directory>`	Le répertoire de contenu du data store est l’emplacement sur la machine locale où les fichiers du data store seront créés. Remarque : Cette option est requise la première fois que vous exécutez l’utilitaire configuredatastore sur une machine pour créer un data store. Une fois que le répertoire de contenu du data store est désigné, cette option est ignorée si vous exécutez l’utilitaire configuredatastore sur la même machine pour créer des types de data stores supplémentaires ou en mettre à niveau.
`--stores`	Cette option indique le type ArcGIS Data Store à configurer. Les valeurs valides sont les suivantes : `relational` `spatiotemporal` `graph` `object` Si vous ne spécifiez pas l’option `--stores`, la valeur `relational` est utilisée par défaut.
`--mode`	Cette option facultative s’applique au graph store et à l’object store lorsque vous créez le data store. Vous pouvez également l’utiliser pour changer le mode d’un graph store ou d’un object store existant. Les valeurs valides sont `singleInstance` et `cluster`. Si vous ne spécifiez aucun mode, l’object store et le graph store sont créés par défaut en mode Une seule instance.
`--roles`	Cette option facultative s’applique uniquement aux Spatiotemporal Big Data Stores à plusieurs machines. Les valeurs prises en charge sont `coord`, `data` et `coord,data`. Il est possible de créer les machines de Spatiotemporal Big Data Store avec l’un des deux rôles ou avec les deux rôles. Pour déployer une machine avec les deux rôles, séparez ceux-ci par une virgule. Par exemple, spécifiez `--roles coord,data` lorsque vous exécutez l’utilitaire configuredatastore pour créer un spatiotemporal Big Data store sur une machine. Pour avoir une description de chaque rôle (coordinator et data), reportez-vous à la rubrique Ajouter des machines à un data store. Vous pouvez également exécuter l’utilitaire configuredatastore avec l’option `--roles` pour modifier le rôle d’une machine existante de spatiotemporal Big Data store. Remarque : N’incluez pas l’option `--roles` lorsque vous exécutez l’utilitaire configuredatastore pour réaliser la mise à niveau d’un spatiotemporal Big Data store. L’option `--roles` s’applique par machine, tandis que les mises à niveau affectent l’intégralité du spatiotemporal Big Data store.

Configuration d’un type spécifique de data store

L’option --stores permet de spécifier le type de data store à créer, comme indiqué ci-dessus. Cliquez sur les liens suivants pour accéder à une description de chaque type de data store :

Pour configurer plusieurs types de data store sur la même machine, séparez chaque type par une virgule (sans espace). Par exemple, pour configurer un relational data store et un graph store sur la même machine, spécifiez --stores relational,graph.

Attention :

Les data stores configurés sur la même machine entrent en concurrence en ce qui concerne l’utilisation de la mémoire et d’autres ressources, ce qui risque de dégrader les performances et éventuellement d’empêcher le fonctionnement des data stores. Cela est particulièrement vrai pour les data stores de Big Data spatio-temporels, les graph stores et les object stores ; ne configurez pas ces types de data store sur la même machine qu’un autre data store ou composant ArcGIS.

Si vous écrivez un script sur la création de plusieurs machines dans un spatiotemporal big data store, graph store ou object store, la première machine doit être configurée manuellement avec le site GIS Server pour que vous puissiez écrire le script sur la création de machines supplémentaires dans le cluster. Incluez des temps d’attente dans votre script pour faire en sorte que les machines supplémentaires ne soient pas ajoutées en même temps.

Chaque type de data store possède un mode par défaut dans lequel il est créé. Vous pouvez spécifier un mode différent lorsque vous créez un graph store ou un object store.

Pour connaître les instructions, reportez-vous à la rubrique Créer un data store.

Configuration de data stores après la mise à jour d’installations d’ArcGIS Data Store

Dans le cadre de la mise à niveau d’ArcGIS Data Store, vous devez reconfigurer les machines de stockage de données existantes. Une fois que vous avez installé sur chaque machine de data store une nouvelle version d’ArcGIS Data Store au-dessus de la version existante, vous pouvez exécuter l’utilitaire configuredatastore pour finaliser la mise à niveau de ce type de data store particulier. L’emplacement et la fréquence d’exécution de l’utilitaire configuredatastore pour la mise à niveau dépend du type de data store.

La configuration ne peut pas être effectuée tant que vous n’avez pas installé la nouvelle version d’ArcGIS Data Store sur toutes les machines du déploiement ArcGIS Enterprise.

Voir Mettre à jour ArcGIS Data Store pour plus d’informations et d’instructions.

Modification du mode d’object store

Pour faire passer l’object store du mode une seule instance au mode cluster, exécutez l’utilitaire configuredatastore pour ajouter au moins deux machines à l’object store et définissez l’option --mode sur cluster lors de l’ajout. Cela réinitialisera le mode de l’ensemble de l’object store au mode cluster.

Remarque :

Un emplacement de sauvegarde par défaut doit être configuré pour l’object store pour que vous puissiez affecter à ce dernier le mode cluster au lieu du mode une seule instance. Les machines que vous ajoutez à l’object store doivent avoir accès à cet emplacement.
Vous ne pouvez pas faire passer l’object store du mode cluster au mode une seule instance.

Modification du mode du graph store

Si le graph store contient une seule machine, il est exécuté en mode une seule instance. S’il en contient trois, il est exécuté en mode cluster.

Pour faire passer le graph store du mode une seule instance au mode cluster, exécutez l’utilitaire configuredatastore avec l’option --mode définie sur cluster.

Remarque :

Vous pouvez utiliser l’option --mode pour spécifier le mode du graph store lorsque vous le créez ou lorsque vous mettez à niveau un graph store en mode une seule instance. Vous pouvez également exécuter l’utilitaire configuredatastore pour faire passer un graph store existant du mode une seule instance au mode cluster.
Un emplacement de sauvegarde par défaut doit être configuré pour le graph store pour que vous puissiez affecter à ce dernier le mode cluster au lieu du mode une seule instance. Les machines que vous ajoutez au graph store doivent avoir accès à cet emplacement.
Vous ne pouvez pas faire passer le graph store du mode cluster au mode une seule instance.

Modification du rôle d’une machine de spatiotemporal Big Data store

Chaque cluster de Spatiotemporal Big Data Stores doit comporter une machine dotée du rôle coordinator qui agit comme le coordinateur actuel de toutes les autres machines du cluster. La première machine que vous créez dans un Spatiotemporal Big Data Store doit inclure le rôle coordinator. Cette première machine est le coordinateur actif actuel. Pour continuer à fonctionner même si la machine qui joue le rôle de coordinateur actuel tombe en panne, le cluster doit comporter au moins deux autres machines auxquelles le rôle coordinator est attribué.

Un cluster de Spatiotemporal Big Data Stores doit également comporter au moins une machine avec le rôle data role.

Les rôles sont attribués aux machines lorsque vous les ajoutez au cluster, comme décrit dans la rubrique Ajouter des machines à un data store. Les machines éligibles au rôle coordinator peuvent être modifiées pour ne stocker que des données. Il est possible d’ajouter le rôle coordinator aux machines actuellement dotées du seul rôle data.

Les modifications de rôle suivantes sont prises en charge :

Spécifiez --roles data pour modifier une machine coordinator en machine data. C’est possible si le cluster comporte des machines éligibles au rôle coordinator. Vous pouvez modifier une machine coordinator vers un rôle data si le cluster comporte au moins trois autres machines éligibles au rôle coordinator.
Spécifiez --roles data pour supprimer le rôle coordinator d’une machine déployée avec les deux rôles. La machine conserve alors le rôle data. Vous pouvez supprimer le rôle coordinator de la machine si le cluster comporte au moins trois autres machines éligibles au rôle coordinator.
Spécifiez --roles coord,data pour ajouter le rôle coordinator à une machine initialement déployée avec le seul rôle data. Le rôle coordinator ne peut être spécifié que pour 5 machines au maximum. Si le cluster comporte déjà 5 machines coordinator, vous ne pouvez pas ajouter le rôle coordinator à une machine data du cluster.

Conseil :

Avant de modifier le rôle d’une machine, exécutez l’utilitaire describedatastore sur l’une des machines pour identifier le rôle attribué à chaque machine dans le cluster de spatiotemporal Big Data stores.

Exemples

Dans cet exemple, un data store pour les données de couches d’entités hébergées (relational data store) est créé. Le nom de l’une des machines du site GIS Server qui utilise le data store est gisserver.example.com:6443, les nom d’utilisateur et mot de passe de l’administrateur du site sont admin et Iph33l$ik, respectivement, et le répertoire de contenu du data store est /dstore/data.

./configuredatastore.sh gisserver.example.com admin Iph33l$ik /dstore/data --stores relational --prompt no

Dans cet exemple, un data store pour les données de couches d’entités hébergées (relational data store) est créé. Le nom de l’une des machines du site GIS Server qui utilise le data store est gisserver.example.com, les nom d’utilisateur et mot de passe de l’administrateur du site sont admin et Iph33l$ik, respectivement, et le répertoire de contenu du data store est C:\datastore\data\.

configuredatastore gisserver.example.com admin Iph33l$ik c:\datastore\data\ --stores relational --prompt no

Dans l’exemple suivant, une machine est ajoutée à un object store existant (une seule instance) :

./configuredatastore.sh gisserver.example.com admin Iph33l$ik dsstore/cache3 --stores object --mode cluster --prompt no

configuredatastore gisserver.example.com admin Iph33l$ik c:\datastore\cache3\ --stores object --mode cluster --prompt no

Dans l’exemple suivant, le rôle coordinator est ajouté à l’une des machines uniquement dotées du rôle data dans un cluster de Spatiotemporal Big Data Stores, ce qui lui permet de jouer le rôle de coordinateur en cas de défaillance de la machine coordinatrice actuelle.

./configuredatastore.sh gisserver.example.com admin Iph33l$ik dsstore/cache3 --stores spatiotemporal --roles coord,data --prompt no

configuredatastore gisserver.example.com admin Iph33l$ik c:\datastore\cache3\ --stores spatiotemporal --roles coord,data --prompt no