Les utilitaires installés avec ArcGIS Data Store offrent à l’administrateur de data store les outils nécessaires pour gérer les data stores. Cette page décrit les utilitaires ainsi que leur syntaxe et fournit des exemples pour chacun d’entre eux.
Tous les utilitaires doivent être exécutés sur la machine ArcGIS Data Store. Vous trouverez ces utilitaires dans le répertoire <ArcGIS Data Store installation directory>/datastore/tools.
Saisissez le nom de l’utilitaire suivi de --help pour obtenir de l’aide sur la syntaxe.
allowconnection
Cet utilitaire sert dans le cadre des data stores relationnels.
Pour des raisons de sécurité, toutes les connexions au stockage des données se font via le site GIS Server par défaut. Si vous voulez ouvrir un data store relationnel à des fins de connexion à une machine supplémentaire, vous pouvez utiliser l’utilitaire allowconnection.
Vous pouvez exécuter l’utilitaire allowconnection sur la machine principale du data store relationnel.
Syntaxe
allowconnection <host name> <username> [<database>]
Indiquez le nom de l’ordinateur que vous souhaitez autoriser à se connecter au data store relationnel (nom d’hôte) et l’un des comptes de base de données utilisés par le data store (nom d’utilisateur) : administrateur du stockage des données, propriétaire du réplica, administrateur de géodatabase ou utilisateur géré (utilisateur qui publie les données des couches d’entités), que vous pouvez obtenir à l’aide de l’utilitaire listadminusers ou listmanageduser. Vous pouvez également indiquer le nom de la base de données du stockage des données relationnelles principale, mais étant donné qu’il n’en existe qu’une, cette valeur est facultative.
Exemple
Dans cet exemple, les connexions sont autorisées depuis l’ordinateur workcom vers le stockage des données relationnelles avec l’utilisateur géré hqo.n_1E7.
./allowconnection.sh workcom hqo.n_1E7
backupdatastore
Cet utilitaire est utilisé pour tous les types de data store.
Cet utilitaire permet de créer une sauvegarde complète d’un data store entre les heures de sauvegarde planifiées. Vous pouvez, par exemple, créer une sauvegarde de chaque data store avant de mettre à niveau ArcGIS Data Store ou avant d’apporter de nombreuses modifications à un data store.
L’utilitaire backupdatastore peut être exécuté pour un seul type de data store à la fois.
Le tableau suivant indique où exécuter l’utilitaire backupdatastore et ce qu’il fait pour chaque type de data store :
| Type de stockage des données | Machine | Comportement |
|---|---|---|
Data store relationnel | Exécutez l’utilitaire backupdatastore sur la machine principale du data store relationnel. | L’utilitaire backupdatastore crée toujours une sauvegarde complète du data store relationnel. |
Data store de cache tuilé | L’utilitaire backupdatastore peut être exécuté sur n’importe quelle machine du data store de cache tuilé. | Lorsque vous exécutez pour la première fois l’utilitaire backupdatastore pour un répertoire de données du cache de tuiles après avoir défini un emplacement de sauvegarde, des copies de sauvegarde sont effectuées pour toutes les bases de données existantes du répertoire de données du cache de tuiles. L’utilisation suivante de l’utilitaire backupdatastore génère des copies de sauvegarde des bases de données de stockages des données du cache de tuiles créées depuis la dernière exécution de l’utilitaire. |
Spatiotemporal Big Data Store | L’utilitaire backupdatastore peut être exécuté sur n’importe quelle machine du cluster. | Lorsque vous exécutez pour la première fois l’utilitaire backupdatastore pour un Spatiotemporal Big Data Store après avoir défini un emplacement de sauvegarde, une sauvegarde complète est créée. L’utilisation suivante de l’utilitaire backupdatastore entraîne la création d’un fichier de sauvegarde contenant uniquement les modifications apportées depuis la sauvegarde complète initiale. |
stockage d’objets | L’utilitaire backupdatastore peut être exécuté sur n’importe quelle machine du cluster. | L’utilitaire backupdatastore crée toujours une sauvegarde complète de l’object store pour les données de service vidéo. Les caches de requêtes des couches d’entités ne sont pas inclus dans le fichier de sauvegarde. |
Base de graphiques | L’utilitaire backupdatastore peut être exécuté sur n’importe quelle machine du graph store. | L’utilitaire backupdatastore crée toujours une sauvegarde complète du graph store. |
Avant d’exécuter l’utilitaire backupdatastore, vérifiez que l’emplacement de sauvegarde du data store est suffisamment important pour accueillir les sauvegardes. Pour modifier l’emplacement de sauvegarde des stockages des données, recourez à l’utilitaire configurebackuplocation.
Pour plus d’informations sur les sauvegardes ArcGIS Data Store, consultez la rubrique Gérer les sauvegardes ArcGIS Data Store.
Syntaxe
backupdatastore [<backup file name>] [--store {relational | tileCache | spatiotemporal | graph | object}] [--location <backup_arguments>] [--prompt {yes | no}]
Vous devez indiquer un nom pour le fichier de sauvegarde.
Si vous ne spécifiez pas l’option --store, la valeur relational est utilisée par défaut.
Si vous ne spécifiez pas l’option --location, les fichiers de sauvegarde sont écrits dans l’emplacement de sauvegarde par défaut du data store.
Pour indiquer d’autres emplacements de sauvegarde inscrits à la place, utilisez l’option --location. Vous pouvez indiquer soit le nom de la sauvegarde, soit le type et l’emplacement de la sauvegarde. Lorsque vous utilisez les arguments type= et location=, séparez-les par un point-virgule (;).
Les arguments pris en charge pour l’option --location sont les suivants :
| Argument | Description |
|---|---|
name= | Vous pouvez utiliser le nom d’un emplacement de sauvegarde pour indiquer l’emplacement de sauvegarde inscrit. Si vous spécifiez un nom, il n’est pas nécessaire d’utiliser les arguments type= et location=. |
type= | Si vous ne spécifiez pas de nom d’emplacement de sauvegarde, vous devez spécifier le type d’emplacement de sauvegarde ainsi que l’emplacement physique. Les valeurs de type et leurs descriptions sont les suivantes :
|
location= | Utilisez l’argument location= pour indiquer l’emplacement physique de l’emplacement de sauvegarde inscrit. Cet argument doit être utilisé avec l’argument type=. Pour les partages de fichiers, fournissez le chemin de fichier. Pour les paquets S3, fournissez le nom du paquet. Pour les conteneurs de stockage blob Azure, fournissez le nom du conteneur. |
Exemples
Dans cet exemple, l’utilitaire backupdatastore crée un fichier de sauvegarde complète nommé project1bu dans l’emplacement de sauvegarde par défaut du data store relationnel. Si --prompt no est indiqué, l’utilitaire ne propose pas d’invite de confirmation.
./backupdatastore.sh project1bu --prompt no
Dans cet exemple, un fichier de sauvegarde nommé localbu5 est créé pour le stockage de Big Data spatio-temporelles dans un emplacement de partage de fichiers, que vous avez nommé gadbu au moment de la configuration de l’emplacement de sauvegarde.
./backupdatastore.sh localbu5 --store spatiotemporal --location 'name=gadbu' You are going to back up the data store. This could take some time, depending on the size of your data store. Please do not interrupt the process once it has started. Do you want to continue (Yes or No)?Yes
Dans cet exemple, une sauvegarde d’un stockage de Big Data spatio-temporelles est créé dans un conteneur de stockage blob Azure nommé blob4backups et le fichier de sauvegarde créé se nomme spds311016 :
./backupdatastore.sh spds311016 --store spatiotemporal --location 'type=azure;location=blob4backups' You are going to back up the data store. This could take some time, depending on the size of your data store. Please do not interrupt the process once it has started. Do you want to continue (Yes or No)?Yes
changedatastoremode
Cet utilitaire est utilisé avec des data stores relationnels et des data stores de Big Data spatio-temporelles.
L’utilitaire changedatastoremode vous permet de placer un stockage des données relationnelles en mode de lecture seule lorsque vous exécutez des tâches de maintenance sur le stockage des données. Si, par exemple, vous devez accomplir une tâche de maintenance entraînant le redémarrage du data store (changer le lecteur accueillant le dossier de sauvegarde ou modifier les propriétés de la base de données, par exemple), vous pouvez mettre le data store relationnel en mode de lecture seule afin qu’aucun utilisateur ne soit en train de publier ou de mettre à jour les données au redémarrage du data store.
L’utilitaire changedatastoremode permet également de replacer le stockage des données relationnelles en mode de lecture-écriture une fois la maintenance terminée ou après avoir ajouté suffisamment d’espace disque sur la machine de stockage des données principale pour permettre au stockage des données de fonctionner correctement en mode de lecture-écriture.
Vous devez exécuter l’utilitaire changedatastoremode sur la machine principale du répertoire de données relationnelles, pas sur la machine de secours.
Si votre stockage de Big Data spatio-temporelles est sur le point de manquer d’espace disque, ArcGIS Data Store le place en mode lecture seule pour éviter toute corruption de données. Vous pouvez utiliser l’utilitaire changedatastoremode pour repasser un stockage de Big Data spatio-temporelles en mode de lecture-écriture une fois que vous avez ajouté assez d’espace disque aux machines de stockage de Big Data spatio-temporelles.
Remarque :
Si ArcGIS Data Store place le data store en mode de lecture seule en raison d’un espace disque insuffisant, les sauvegardes automatiques sont également désactivées pour éviter d’encombrer davantage le disque. Par conséquent, vous devez réinitialiser le calendrier de sauvegarde automatique à l’aide de l’utilitaire updatebackupschedule après avoir remis le data store en mode de lecture-écriture.
Syntaxe
changedatastoremode {readonly | readwrite} [--prompt {yes | no}] --store {relational | spatiotemporal}
Exemples
Dans cet exemple, le data store relationnel est placé en mode de lecture-écriture, ce qui signifie que les clients ne peuvent pas effectuer certaines activités, telles que la publication de couches d’entités hébergées sur ArcGIS Enterprise ou la modification des données via une couche d’entités hébergée. L’option --prompt permet de supprimer l’invite de confirmation.
./changedatastoremode.sh readonly --store relational --prompt no
Pour placer un Spatiotemporal Big Data Store en mode de lecture-écriture après avoir ajouté de l’espace disque aux machines, spécifiez l’option readwrite et indiquez spatiotemporal avec l’option --store, comme illustré dans l’exemple suivant :
./changedatastoremode.sh readwrite --prompt no --store spatiotemporal
changedbproperties
Cet utilitaire est utilisé avec des data stores relationnels, des data stores de cache tuilé et des data stores de Big Data spatio-temporelles.
L’utilitaire changedbproperties vous permet de modifier diverses propriétés, selon le type de data store sur lequel vous l’exécutez.
Syntaxe
changedbproperties --store {relational | tileCache | spatiotemporal} [configuration options]
Vous devez indiquer l’option --store et au moins une option de configuration Vous trouverez ci-dessous les options de configuration prises en charge et leur description, ainsi que le type de data store avec lequel chaque option peut être utilisée :
| Option de configuration | Description | Type de data store pris en charge |
|---|---|---|
--disk-threshold-readonly | Cette option contrôle le moment où le data store relationnel est placé en mode de lecture seule pour éviter toute perte des données provoquée par un espace disque insuffisant. Indiquez les tailles en Mo. L’espace disque par défaut est de 1 024 Mo. | Data store relationnel uniquement |
--max-connections | utilisez ce paramètre pour indiquer le nombre maximum de connexions autorisées vers un stockage des données relationnelles. Par défaut, le stockage des données relationnelles accepte jusqu’à 150 connexions. Utilisez la propriété --max-connections pour modifier le nombre de connexions autorisées. Tenez compte du fait que les processus internes de ArcGIS Data Store peuvent utiliser jusqu’à 5 connexions. Tenez également compte du nombre de connexions simultanées que la machine ArcGIS Data Store peut accepter sans compromis sur les performances. Si la machine exécutant ArcGIS Data Store ne dispose pas d’une mémoire importante, vous pouvez être amené à réduire le nombre de connexions autorisées. Le nombre spécifié ne peut pas être inférieur à 10. Lorsque vous changez le nombre maximum de connexions autorisées, ce nombre change à la fois sur la machine de stockage des données principale et sur celle de secours. | Data store relationnel uniquement |
--pitr | Cette option indique si ArcGIS Data Store crée des sauvegardes incrémentielles du data store relationnel, ce qui permet de restaurer le data store relationnel dans l’état où il se trouvait à un moment donné dans le temps. Les arguments possibles pour cette option sont enable ou disable. | Data store relationnel uniquement Le paramètre par défaut est --pitr disable. Remarque :Vous devez définir l’option --pitr sur enablesi vous souhaitez utiliser l’utilitaire webgisdr, installé avec Portal for ArcGIS, pour créer des sauvegardes incrémentielles du déploiement ArcGIS Enterprise. |
--enablessl | Cette option contrôle l’utilisation du protocole TLS (Transport Layer Security) lorsque le data store de cache tuilé est renseigné et lors des communications entre le data store relationnel et le serveur d’hébergement. Les arguments pris en charge pour le paramètre --enablessl sont les suivants :
| Data stores de cache tuilé et relationnel |
--heap-size | utilisez ce paramètre pour modifier la quantité de mémoire du segment (en Mo) utilisée par un stockage de Big Data spatio-temporelles. Par défaut, ce type de data store utilise au démarrage la moitié de la RAM de la machine (jusqu’à 70 % de la RAM libre). Vous pouvez redéfinir la taille de segment entre 512 et 32 000 Mo, mais assurez-vous que la taille spécifiée ne dépasse pas la quantité de RAM disponible sur la machine. | Spatiotemporal Big Data Store |
--rebalance | Par défaut, cette option est définie sur true, ce qui signifie que le Spatiotemporal Big Data Store distribue les données à d’autres machines, en cas d’indisponibilité d’une des machines. Si vous devez effectuer une opération de maintenance sur une machine de Spatiotemporal Big Data Store, pour la mettre à niveau par exemple, vous pouvez temporairement désactiver le rééquilibrage en spécifiant --rebalance false. L’option de rééquilibrage est interrompue pendant le nombre de minutes défini pour le paramètre --max-rebalance-off. | Spatiotemporal Big Data Store |
--max-rebalance-off | Combinée avec l’option --rebalance, cette option indique la durée de l’interruption du rééquilibrage. Par défaut, --max-rebalance-off est défini sur 60 minutes. Cela signifie que si vous désactivez temporairement le rééquilibrage, il redémarre au bout de 60 minutes. Si vous avez besoin de plus ou moins de temps que cela pour réaliser la tâche de maintenance pour laquelle vous avez interrompu le rééquilibrage, modifiez le paramètre --max-rebalance-off. | stockage de Big Data spatio-temporelles |
--prompt | vous exécutez cet utilitaire, vous êtes invité à confirmer l’action spécifiée. Si vous automatisez l’utilisation de cet utilitaire, spécifiez --prompt no. Sinon, le script ne continue que si vous répondez à l’invite. | Data stores relationnel et de cache tuilé, et Spatiotemporal Big Data Store |
Exemples
Les sections suivantes comprennent des exemples d’utilisation des options disponibles avec l’utilitaire changedbproperties.
Changer le seuil de lecture seule pour le data store relationnel
Par défaut, le data store relationnel est placé en mode lecture seule lorsque l’espace disque libre passe en dessous de 1 024 Mo. Dans l’exemple suivant, puisque d’autres applications écrivent des données sur la machine, l’administrateur configure le data store relationnel de sorte qu’il soit placé plus tôt en mode lecture seule : lorsque l’espace disque libre sur la machine passe en dessous de 4 000 Mo.
./changedbproperties.sh --store relational --disk-threshold-readonly 4000
You are changing the following database properties:
...disk space threshold to change relational data store into READONLY mode to 4000MB)
Changing database configurations could cause the database to restart. Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)?YesChanger le nombre de connexions au data store relationnel autorisées
Dans cet exemple, le nombre maximum de connexions autorisées dans un stockage des données relationnelles est défini sur 100 :
./changedbproperties.sh --store relational --max-connections 100
You are changing the following database properties:
...max number of connections to 100 (on all relational data store machines)
Changing database configurations could cause the database to restart. Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)?YesActiver la récupération ponctuelle pour le data store relationnel
Par défaut, la récupération ponctuelle est désactivée. Dans cet exemple, la récupération ponctuelle est activée pour le data store relationnel :
./changedbproperties.sh --store relational --pitr enable
You are changing the following database properties:
...enable point-in-time recovery for relational store
Changing database configurations could cause the database to restart. Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)?YesDésactiver SSL
Par défaut, le data store relationnel communique avec le serveur d’hébergement via HTTPS. Dans cet exemple, le paramètre --enablessl est utilisé pour configurer le data store relationnel de sorte qu’il communique avec le serveur d’hébergement via HTTPS.
./changedbproperties.sh --store relational --enablessl false
You are changing the following database properties:
...disable ssl for relational store
Changing database configurations could cause the database to restart. Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)?YesChanger la taille de segment du data store de Big Data spatio-temporel
Par défaut, le data store de Big Data spatio-temporel utilise au démarrage la moitié de la RAM de la machine (et 70 % de RAM libre).
Attention :
Diminuer la taille de segment pourrait empêcher le data store de démarrer. Si vous augmentez la taille de segment, ne spécifiez pas de chiffre dépassant la quantité de RAM disponible sur la machine.
Dans cet exemple, la taille de segment est définie sur 1 600 Mo.
./changedbproperties.sh --store spatiotemporal --heap-size 1600
You are changing the following database properties:
...heap size for spatiotemporal store to 1600MB (on current machine)
Changing database configurations could cause the database to restart. Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)?YesMettre en pause le rééquilibrage du data store de Big Data spatio-temporel
Dans cet exemple, l’administrateur doit effectuer une procédure de maintenance brève sur une machine du data store de Big Data spatio-temporel et ne souhaite pas que le data store soit rééquilibré. À cette fin, les options --rebalance et --max-rebalance-off sont utilisées pour suspendre le rééquilibrage pendant 30 minutes. Au bout de 30 minutes, le data store de Big Data spatio-temporel redéfinit automatiquement rebalance sur true.
Cette opération devant être effectuée régulièrement, l’administrateur conserve l’instruction suivante dans un script et définit l’option d’invite sur la valeur No (Non).
./changedbproperties.sh --store spatiotemporal --rebalance false --prompt no
./changedbproperties.sh --store spatiotemporal --max-rebalance-off 30 --prompt no
changeloglocation
Cet utilitaire est utilisé pour tous les types de data store.
L’emplacement par défaut du fichier journal des erreurs pour ArcGIS Data Store est <ArcGIS Data Store directory>\arcgisdatastore\logs. Pour utiliser un autre répertoire, exécutez l’utilitaire changeloglocation et spécifiez le nouveau chemin d’accès à ce répertoire.
Le compte ArcGIS Data Store doit disposer des privilèges d’écriture sur le répertoire que vous spécifiez.
Syntaxe
changeloglocation <directory path>
Exemple
Dans cet exemple, les fichiers journaux sont créés dans le répertoire local, ../datastorefiles/logs.
./changeloglocation.sh '../datastorefiles/logs'
changenosqldslocation
Cet utilitaire est utilisé pour les data stores de cache tuilé.
Le stockage des données du cache de tuiles peut devenir volumineux si vous stockez de nombreuses tuiles haute résolution à l’intérieur. Dans ce cas, vous pouvez décider de déplacer les données vers un autre lecteur sur le même serveur ou vers un emplacement partagé sur un autre serveur.
Si vous déplacez les données vers un répertoire partagé, vous devez accorder les autorisations de lecture et d’écriture sur ce répertoire au compte ArcGIS Data Store.
Syntaxe
changenosqldslocation <path> [--prompt {yes | no}]
Exemple
Dans cet exemple, les bases de données qui stockent des caches de couches de scènes sont créées dans un répertoire partagé intitulé dstorecache sur la machine server2.
./changenosqldslocation.sh /net/server2/dstorecache --prompt no
changepassword
Cet utilitaire sert dans le cadre des data stores relationnels.
ArcGIS Data Store génère au hasard des noms d’utilisateur et des mots de passe pour les comptes de base de données utilisés pour les data stores relationnels. Si vous devez définir vos propres mots de passe sur le site, procurez-vous les mots de passe des comptes de data store relationnel et exécutez changepassword pour les réinitialiser.
Faites appel à l’utilitaire listadminusers pour obtenir les noms d’utilisateur et les mots de passe des administrateurs et à l’utilitaire listmanageduser pour obtenir le nom d’utilisateur et le mot de passe du propriétaire des données d’entité.
L’utilitaire changepassword doit être exécuté sur la machine principale du data store relationnel. Pour identifier la machine principale, exécutez l’utilitaire describedatastore.
Syntaxe
changepassword <username> <new password> [--prompt {yes | no}]
Exemple
Dans cet exemple, le mot de passe est changé pour l’utilisateur gwi_n2Te0 et devient Phfl4mp!.
./changepassword.sh gwi_n2Te0 Phfl4mp
You are going to change the password for user gwi_n2Te0. Do you want to continue (Yes or No)?Yes
Pour rédiger un script de modification de mot de passe, incluez un drapeau pour supprimer l’invite de confirmation, comme l’indique l’exemple suivant :
./changepassword.sh gwi_n2Te0 Phfl4mp --prompt no
changestaginglocation
Cet utilitaire peut être utilisé avec un data store relationnel, un data store de cache tuilé ou un graph store.
Lorsque vous restaurez le data store relationnel ou de cache tuilé, ArcGIS Data Store extrait les fichiers de sauvegarde compressés dans un emplacement intermédiaire. Cela signifie que vous devez disposer d’un emplacement intermédiaire pouvant accueillir ces données décompressées. Par défaut, cet emplacement correspond au répertoire de données de ArcGIS Data Store. Si le data store relationnel ou de cache tuilé comporte beaucoup de données, configurez un emplacement intermédiaire distinct et spécifiez-le pour la récupération.
De même, si vous définissez un compartiment S3 ou un conteneur de stockage Blob Azure pour les fichiers de sauvegarde d’un data store relationnel, d’un data store de cache tuilé ou d’un graph store, l’emplacement intermédiaire permet d’empaqueter les fichiers de sauvegarde avant de les copier dans l’emplacement de stockage Cloud.
Syntaxe
changestaginglocation <directory path>
Exemple
Dans cet exemple, le dossier intermédiaire désigné est /net/sanmarcos/rbustage.
./changestaginglocation.sh /net/sanmarcos/rbustage
configurebackuplocation
Cet utilitaire est utilisé pour tous les types de data store.
L’utilitaire configurebackuplocation permet de spécifier l’emplacement dans lequel ArcGIS Data Store écrit les fichiers de sauvegarde des sauvegardes planifiées et des sauvegardes créées à l’aide de l’utilitaire backupdatastore. L’utilitaire configurebackuplocation permet également de modifier les propriétés d’un emplacement de sauvegarde et de supprimer un emplacement de sauvegarde.
Les répertoires de données relationnelles sont créés avec un emplacement de sauvegarde local par défaut. Pour éviter la perte de données, configurez un emplacement de sauvegarde par défaut en inscrivant un partage de fichiers sécurisé au moyen de l’option change.
Les stockages de données de cache de tuiles créés en mode machine principale/de secours possèdent un emplacement de sauvegarde par défaut ; les stockages de données de cache de tuiles créés en mode grappe n’en possèdent pas. Dans un cas comme dans l’autre, utilisez l’utilitaire configurebackuplocation avec l’option register pour spécifier un emplacement réseau partagé, un paquet Amazon Simple Storage Service (S3) ou un conteneur de stockage blob Microsoft Azure pour stocker les sauvegardes de stockages de données de cache de tuiles de manière sécurisée. Vous ne pouvez pas utiliser un disque local pour les fichiers de sauvegarde des répertoires de données du cache de tuiles si le répertoire de données fonctionne en mode d’agrégat.
Les data stores de Big Data spatio-temporelles, les graph stores et les object stores ne sont pas créés avec un emplacement de sauvegarde par défaut. Avant de commencer à créer des sauvegardes, vous devez exécuter l’utilitaire configurebackuplocation avec l’option register pour spécifier un emplacement de partage de fichiers, un paquet Amazon Simple Storage Service (S3) ou un conteneur de stockage blob Microsoft Azure pour ces sauvegardes.
Remarque :
Vous ne pouvez pas utiliser de disque local pour les fichiers de sauvegarde de stockage de Big Data spatio-temporelles.
Vous pouvez inscrire un second emplacement de sauvegarde pour le stockage des sauvegardes créées avec l’utilitaire backupdatastore. Vous pouvez utiliser un répertoire de fichiers partagé, un paquet S3 ou un conteneur de stockage blob Azure pour les emplacements de sauvegarde secondaires.
Pour plus d’informations sur les sauvegardes ArcGIS Data Store, consultez la rubrique Gérer les sauvegardes ArcGIS Data Store.
Syntaxe
configurebackuplocation --store {relational | tileCache | spatiotemporal | graph | object} --operation {change | register | unregister | list | setdefault} [--location "<backup_location_arguments>"] [additional options]
Options requises
Vous devez indiquer les options suivantes lorsque vous exécutez l’utilitaire configurebackuplocation :
- --store {relational | tileCache | spatiotemporal | graph | object}
Spécifiez le type de ArcGIS Data Store pour lequel vous configurez ou interrogez des emplacements de sauvegarde. La valeur par défaut est relational.
- --operation {change | register | unregister | list | setdefault}
L’option --operation spécifie l’action que l’utilitaire configurebackuplocaton va effectuer. La valeur par défaut est change.
Voici une explication de chaque argument pouvant être utilisé avec l’option --operation :
| Option | Description |
|---|---|
change | Cet argument permet d’apporter les modifications suivantes :
|
register | Cet argument permet d’inscrire un emplacement de sauvegarde. Si vous utilisez l’argument register, vous devez indiquer l’option --location. Le premier emplacement de sauvegarde que vous définissez pour un spatiotemporal big data store, un graph store ou un data store de cache tuilé est considéré comme l’emplacement par défaut. Lorsque vous inscrivez un autre emplacement de sauvegarde pour un data store de cache tuilé (mode principal-secours ou agrégat), un data store de Big Data spatio-temporelles ou un graph store, un emplacement de sauvegarde secondaire est inscrit. Pour le data store relationnel, l’argument register inscrit toujours un emplacement de sauvegarde secondaire. L’emplacement de sauvegarde secondaire permet de stocker des sauvegardes manuelles générées avec l’utilitaire backupdatastore. |
unregister | Cet argument permet de supprimer un emplacement de sauvegarde secondaire d’un data store. Si un seul emplacement de sauvegarde est inscrit, l’argument unregister supprime entièrement l’emplacement de sauvegarde d’un data store de cache tuilé, d’un Spatiotemporal Big Data Store ou d’un graph store. |
list | Répertorie tous les emplacements de sauvegarde inscrits pour le data store spécifié avec l’option --store. La liste indique l’emplacement de sauvegarde physique, le nom de l’emplacement de sauvegarde et celui qui est inscrit comme emplacement de sauvegarde par défaut. |
setdefault | Si vous avez configuré plusieurs emplacements de sauvegarde pour un graph store, un data store de cache tuilé ou un Spatiotemporal Big Data Store, utilisez l’argument setdefault pour en désigner un comme emplacement par défaut. Cet emplacement contient les sauvegardes planifiées. Il s’agit de l’emplacement par défaut utilisé si vous exécutez l’utilitaire backupdatastore, listbackups ou restoredatastore sans spécifier d’emplacement de sauvegarde. |
Option location
L’option --location est requise dans les cas suivants :
- Spécifiez l’emplacement de sauvegarde lorsque vous inscrivez un emplacement de sauvegarde ou que vous modifiez l’emplacement de sauvegarde par défaut du data store relationnel.
- Pour modifier le nom d’un emplacement de sauvegarde existant, indiquez l’argument name et la valeur du nouveau nom.
Vous pouvez utiliser l’option --location lorsque vous définissez un emplacement de sauvegarde par défaut ou que vous supprimez un emplacement de sauvegarde. Vous pouvez également utiliser le nom de la sauvegarde.
Pour les data stores de cache tuilé ou les Spatiotemporal Big Data Stores, ou afin d’inscrire un emplacement de sauvegarde secondaire pour un data store relationnel, indiquez les arguments suivants séparés par un point-virgule (;) avec l’option --location et placez la totalité de la chaîne d’arguments entre guillemets droits doubles ('') :
--location "type=fs|s3|azure;location=<backup_location>;[name=<backup_location_name>];[username=<AWS_access_key_ID_or_Azure_account>];[password=<AWS_secret_access_key_or_Azure_account_key>];[endpointsuffix=<Azure_cloud_location> | region=<AWS_region>]".
Chacun des arguments pris en charge avec l’option --location est décrit ci-dessous :
| Argument | Description |
|---|---|
type= | Cet argument est requis. Indiquez le type d’emplacement à utiliser pour les sauvegardes. Spécifiez fs pour stocker les sauvegardes dans un partage de fichiers. Dans le cas de data stores relationnels, l’emplacement de sauvegarde par défaut doit être un partage de fichiers. Spécifiez s3 pour stocker les sauvegardes dans un compartiment Amazon S3. Spécifiez azure pour stocker les sauvegardes dans un conteneur de stockage Blob Azure. |
location= | Cet argument est requis. Pour les partages de fichiers, spécifiez le chemin du fichier. Pour les compartiments Amazon S3, spécifiez le nom et le chemin d’accès du compartiment. Pour les conteneurs de stockage Blob, spécifiez le nom et le chemin d’accès du conteneur. |
name= | Vous pouvez attribuer un nom à l’emplacement de sauvegarde. Par exemple, si l’emplacement de sauvegarde est un chemin d’accès à un fichier, tel que \\sharedserver_sharedfolders_datastorebackups, vous pouvez lui attribuer un nom, par exemple, dsbackupsfolder. Lorsque vous exécutez l’utilitaire backupdatastore, listbackups ou restoredatastore, indiquez ce nom plutôt que le chemin de l’emplacement. Si vous ne fournissez pas de nom lorsque vous configurez l’emplacement de sauvegarde du stockage de données, ArcGIS Data Store en attribue un par défaut. |
username= | Cet argument est requis si vous définissez l’argument type= sur azure ou sur s3. Pour les paquets S3, fournissez l’ID de la clé d’accès de votre compte Amazon Web Services (AWS). Pour les conteneurs de stockage blob Azure, fournissez le nom du compte de stockage Microsoft Azure pouvant accéder au conteneur de stockage blob. |
password= | Cet argument est requis si vous définissez l’argument type= sur azure ou sur s3. Pour les paquets S3, fournissez la clé secrète de votre compte AWS. Pour les conteneurs de stockage blob Azure, fournissez la clé du compte Azure que vous avez spécifiez avec l’argument username. |
endpointsuffix= | Si vous définissez l’argument type= sur azure, vous pouvez utiliser l’argument endpointsuffix pour indiquer l’emplacement du conteneur de stockage Blob Azure. Par défaut, le paramètre endpointsuffix est censé être core.windows.net Si votre conteneur se trouve dans l’environnement Cloud Microsoft Azure Government, définissez endpointsuffix=core.usgovcloudapi.net. Si le conteneur se trouve dans un Cloud privé, définissez endpointsuffix sur le suffixe du point de terminaison du Cloud privé Azure. |
region= | Cet argument est requis si vous définissez l’argument type= sur s3. Vous devez indiquer le code de région. Par exemple, définissez la région sur ap-southeast-2 si le compartiment est déployé dans la région Asie-Pacifique (Sydney). Consultez la documentation AWS pour en savoir plus sur les codes de région. |
Options supplémentaires
Voici les options supplémentaires que vous pouvez fournir avec l’utilitaire configurebackuplocation :
| Option | Description |
|---|---|
--force | Utilisée uniquement avec les data stores relationnels, cette option permet de modifier l’emplacement de sauvegarde par défaut, même si ce dernier n’est pas disponible. Les valeurs valides sont true et false. Lorsque vous modifiez l’emplacement de sauvegarde par défaut d’un stockage de données relationnelles, ArcGIS Data Store copie les fichiers de sauvegarde existants de l’ancien emplacement vers le nouveau. Si ArcGIS Data Store ne parvient pas à accéder à l’ancien emplacement, il ne peut pas copier les fichiers. Dans les versions antérieures, cela entraînait l’échec de l’utilitaire configurebackuplocation. Si vous souhaitez tout de même modifier l’emplacement de sauvegarde par défaut sans copier les fichiers de sauvegarde existants, spécifiez --force true. La valeur par défaut de cette option est false, ce qui signifie que vous ne pouvez pas modifier l’emplacement de sauvegarde si ArcGIS Data Store ne parvient pas à accéder à l’emplacement par défaut existant. |
--prompt | Les valeurs valides sont yes et no. vous exécutez cet utilitaire, vous êtes invité à confirmer l’action spécifiée. Si vous automatisez l’utilisation de cet utilitaire, définissez l’option --prompt sur no. Sinon, le script ne continue que si vous répondez à l’invite. |
Exemples
Les sections suivantes présentent des exemples de changement, de définition ou de création de listes d’emplacements de sauvegarde pour les data stores.
Changer l’emplacement de sauvegarde par défaut du data store relationnel
Dans le premier exemple, l’emplacement de sauvegarde d’un stockage des données relationnelles est défini sur un répertoire nommé fsdata_bu sur une machine nommée myshare.
./configurebackuplocation.sh --operation change --store relational --location "type=fs;location=/net/myshare/fsdata_bu" You are going to change the backup location of the data store. Existing backups will be copied to the new location and it could take a few moments. Please do not interrupt the process once it has started. Do you want to continue (Yes or No)? Yes
Ajouter un emplacement de sauvegarde par défaut pour le data store relationnel
Dans cet exemple, un deuxième emplacement de sauvegarde sur Azure est inscrit pour le même stockage de données relationnelles.
./configurebackuplocation.sh --operation register --store relational --location "type=azure;location=mybackups;name=secondrelloc;username=myazureaccountlogin;password=zpw4myazureaccount"
You are going to change the backup location of the data store. Existing backups will be copied to the new location and it could take a few moments. Please do not interrupt the process once it has started. Do you want to continue (Yes or No)? Yes
Définir un emplacement de sauvegarde pour un graph store
Dans cet exemple, un emplacement de sauvegarde sur un partage réseau est inscrit pour un graph store. Un nom, fshare, est attribué à l’emplacement de sauvegarde.
./configurebackuplocation.sh --operation register --store graph --location "type=fs;location=/net/sharedmachine/g_bu;name=fshare" --prompt no
Ajouter des emplacements de sauvegarde et définir un emplacement par défaut
Dans cet exemple, un deuxième emplacement de sauvegarde est spécifié pour le data store de Big Data spatio-temporel. L’emplacement de sauvegarde supplémentaire se trouve dans le stockage Azure.
./configurebackuplocation.sh --operation register --store spatiotemporal --location "type=azure;location=myblobs;name=mazloc;username=myazureaccountlogin;password=zpw4myazureaccount" --prompt no
Dans cet exemple, un deuxième emplacement de sauvegarde dans la région Europe (Espagne) sur AWS est spécifié pour le même data store de Big Data spatio-temporelles. Un nom, awsloc, est attribué à l’emplacement de sauvegarde.
./configurebackuplocation.sh --operation register --store spatiotemporal --location "type=s3;location=mybucket;name=awsloc;username=abcdefg1234567;password=z9y8x7w6v5u4t3s2r1q0;region=eu-south-2" --prompt no
Dans cet exemple, le paquet S3 est défini comme emplacement de sauvegarde par défaut pour le data store de Big Data spatio-temporel à l’aide du nom de l’emplacement de sauvegarde (awsloc).
./configurebackuplocation.sh --operation setdefault --store spatiotemporal --location "name=awsloc" --prompt no
Obtenir une liste de tous les emplacements de sauvegarde pour un data store
Dans cet exemple, tous les emplacements de sauvegarde pour le stockage de Big Data spatio-temporelles sont répertoriés..
./configurebackuplocation.sh --operation list --store spatiotemporal
Backup locations for spatiotemporal big data store: ================================================================ Name Type Location isDefault ================================================================ fsshare fs /net/sharedmachine/ge_bu false awsloc s3 mybucket true mazloc azure myblobs false
configuredatastore
Cet utilitaire est utilisé pour tous les types de data store.
Une fois que vous avez installé ArcGIS Data Store, vous pouvez exécuter l’utilitaire configuredatastore plutôt que l’assistant Data Store configuration (Configuration de data store) pour créer un data store et l’inscrire auprès d’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.
Syntaxe
configuredatastore <ArcGIS Server admin URL> <ArcGIS Server administrator> <ArcGIS Server administrator password> <data directory> [--stores {relational | tileCache | spatiotemporal | graph | object}] [--mode {singleInstance | primaryStandby | cluster}] [--roles {coord | data}]
| Option | Description |
|---|---|
<ArcGIS Server admin URL> | Site GIS Server qui est utilisé ou sera utilisé comme serveur d’hébergement ArcGIS Enterprise. L’URL d’administration de ArcGIS Server est au format https://gisserver.domain.com:6443. Remarque :Même si le site GIS Server utilise un Web Adaptor ou un équilibreur de charge, vous devez spécifier l’URL au format indiqué ci-dessus. |
<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 directory> | Le répertoire de données est l’emplacement sur la machine locale où les fichiers du data store seront créés. |
--stores | Cette option indique le type de ArcGIS Data Store à configurer. Les valeurs valides sont les suivantes :
Si vous ne spécifiez pas l’option --stores, la valeur relational est utilisée par défaut. |
--mode | Cette option facultative ne s’applique qu’aux data stores de cache tuilés et aux object stores. Les valeurs valides sont singleInstance, primaryStandby et cluster. Si vous ne spécifiez pas de mode, les data stores de cache tuilé sont créés en mode primaryStandby et les object stores sont créés en mode singleInstance. Les data stores de cache tuilé créés en mode primaryStandby peuvent contenir deux machines. Si vous devez mettre à l’échelle le data store de cache tuilé pour y inclure deux ou trois machines, créez un data store de cache tuilé en mode cluster. Vous pouvez utiliser l’option --mode pour redéfinir le data store de cache tuilé du mode primaryStandby vers le mode cluster. Les object stores créées en mode singleInstance ne peuvent contenir qu’une seule machine. Si vous avez besoin de haute disponibilité, déployez l’object store en mode cluster. Utilisé en mode grappe, l’object store doit inclure au moins trois machines. Le mode primaryStandby ne s’applique plus aux object stores. Vous ne pouvez pas changer de mode pour un object store. Pour en savoir plus, reportez-vous à la rubrique Ajouter des machines à un data store. |
--roles | Cette option facultative s’applique uniquement aux Spatiotemporal Big Data Stores à plusieurs machines. Les valeurs prises en charge sont coord, data ou 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 les deux rôles par une virgule. Par exemple, spécifiez --role 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. |
Configurer un type spécifique de stockage des données
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 :
- Stockage des données relationnelles
- Stockage des données du cache de tuiles
- Stockage de Big Data spatio-temporelles
- Base de graphiques
- stockage d’objets
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 stockage des données relationnelles et du cache de tuiles sur la même machine, spécifiez --stores relational,tileCache.
Remarque :
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 de stockage de Big Data spatio-temporelles, une machine de stockage de Big Data spatio-temporelles doit être configurée manuellement avec le site GIS Server pour que vous puissiez écrire un script sur la création de machines de stockage de Big Data spatio-temporelles supplémentaires. Incluez les temps d’attente dans votre script pour faire en sorte que les machines de Spatiotemporal Big Data Stores 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 data store de cache tuilé ou un object store.
Pour connaître les instructions, reportez-vous à la rubrique Créer un data store.
Configurer les stockages de données après la mise à jour d’installations ArcGIS Data Store
Dans le cadre de la mise à niveau de ArcGIS Data Store, vous devez reconfigurer les machines de stockage de données existantes. Après l’installation sur chaque machine de data store d’une nouvelle version de ArcGIS Data Store au-dessus de la version existante de ArcGIS Data Store, connectez-vous à n’importe quelle machine dans un data store et exécutez l’utilitaire configuredatastore pour finaliser la mise à niveau de ce type de data store particulier. Vous pouvez ainsi exécuter configuredatastore sur la machine principale du data store relationnel. La machine de secours est également mise à niveau.
Si une machine contient à la fois un stockage de données relationnelles et du cache de tuiles, spécifiez --stores relational,tileCache lorsque vous exécutez l’utilitaire configuredatastore ; toutes les machines des deux stockages de données sont alors mises à jour.
Pour reconfigurer les machines du stockage de Big Data spatio-temporelles mises à jour, connectez-vous à l’une d’entre elles et exécutez l’utilitaire configuredatastore. Ceci met à jour toutes les machines du stockage de Big Data spatio-temporelles.
La configuration ne peut pas être effectuée tant que vous n’avez pas installé la nouvelle version de ArcGIS Data Store sur toutes les machines du déploiement ArcGIS Enterprise.
Pour plus d’informations, reportez-vous à la rubrique Mettre à niveau ArcGIS Data Store.
Modification du mode du data store de cache tuilé
Pour déterminer le mode actuel défini pour le data store de cache tuilé, exécutez l’utilitaire describedatastore sur la machine de ce data store de cache tuilé.
Si vous devez faire passer le mode du data store de cache tuilé de primaryStandby au mode agrégat, exécutez l’utilitaire configuredatastore en indiquant --mode comme option cluster.
Remarque :
Vous pouvez utiliser l’option --mode pour spécifier le mode du data store de cache tuilé ou de l’object store lors de la création du data store ou pour redéfinir le mode primaryStandby du data store de cache tuilé sur le mode cluster, mais vous ne pouvez pas modifier le mode si vous mettez à niveau un data store de cache tuilé, vous ne pouvez pas redéfinir le mode cluster du data store de cache tuilé sur le mode primaryStandby, et vous ne pouvez pas changer le mode d’un autre type de data store.
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 stockage des données pour les données de couches d’entités hébergées (stockage des données relationnelles) est créé. L’URL du site GIS Server allant utiliser le data store est https://gisserver.domain.com:6443, le nom d’utilisateur et le mot de passe de l’administrateur du site sont, respectivement, admin et Iph33l$ik, et le répertoire des données du data store est /dstore/data.
./configuredatastore.sh https://gisserver.domain.com:6443 admin Iph33l$ik /dstore/data --stores relational --prompt no
Dans l’exemple suivant, un data store de cache de tuiles existant (principal-de secours) passe au mode grappe :
./configuredatastore.sh https://gisserver.mydomain.com:6443 admin Iph33l$ik dsstore/scenedata --stores tileCache --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 https://gisserver.mydomain.com:6443 admin Iph33l$ik dsstore/scenedata --stores spatiotemporal --roles coord,data --prompt no
deletebackup
Cet utilitaire sert dans le cadre des data stores relationnels et des object stores.
L’utilitaire deletebackup vous permet de supprimer les fichiers de sauvegarde que vous avez créés pour les data stores relationnels ou les object stores. Exécutez d’abord l’utilitaire configurebackuplocation avec l’option --operation définie sur list pour obtenir la liste de tous les emplacements de sauvegarde configurés pour le data store. Exécutez ensuite l’utilitaire listbackups avec l’un des emplacements pour afficher les noms et heures de création des sauvegardes dans cet emplacement. Répétez cette étape pour chaque emplacement de sauvegarde. Vous pouvez ensuite exécuter l’utilitaire deletebackup pour supprimer les fichiers de sauvegarde dont vous n’avez plus besoin. Vous devez exécuter deletebackup séparément pour chaque emplacement dont vous voulez supprimer les fichiers de sauvegarde.
Remarque :
Vous pouvez uniquement supprimer les sauvegardes non requises pour récupérer votre data store. Ainsi, vous ne pouvez pas supprimer la sauvegarde complète la plus récente du stockage des données relationnelles.
Syntaxe
deletebackup <backup name> [--store {relational | object}] [--location "<backup-location>"] [--prompt {yes | no}]
Exemple
Dans l’exemple suivant, la sauvegarde du data store relationnel nommée featuresMarchbu est supprimée de l’emplacement de sauvegarde par défaut.
./deletebackup.sh featuresMarchbu --store relational
You are attempting to delete backup 'featuresMarchbu'. This operation is irreversible. Do you wish to continue (Yes or No)?yes Operation completed successfully
Dans cet exemple, l’élément june-videobu de l’object store est supprimé de l’emplacement de sauvegarde nommé videobucket.
./deletebackup.sh june-videobu --store object --location "videobucket"
You are attempting to delete backup 'june-videobu'. This operation is irreversible. Do you wish to continue (Yes or No)?yes Operation completed successfully
describedatastore
Cet utilitaire est utilisé pour tous les types de data store.
L’utilitaire describedatastore fournit des informations sur une installation de ArcGIS Data Store : Il indique les types de data store installés sur la machine sur laquelle vous l’exécutez et fournit des informations sur chaque type de data store de la machine.
Remarque :
Si un data store est installé sur la machine mais n’est pas configuré, il s’affiche en tant que ArcGIS Data Store disponible, mais aucune information supplémentaire n’est renvoyée pour ce type de data store.
Certaines informations sont communes à tous les types de data store et d’autres sont propres à un type de data store. Les tableaux suivants répertorient et expliquent les propriétés renvoyées par l’utilitaire describedatastore :
Propriétés générales
Les valeurs de ces propriétés sont identiques pour tous les types de data store installés sur la machine.
| Propriété | Description |
|---|---|
ArcGIS Data Store release (Version d’ArcGIS Data Store) | Numéro de version du logiciel pour l’installation de ArcGIS Data Store. |
Staging location (Emplacement intermédiaire) | Dans le cas des data stores relationnels et de cache tuilé, l’emplacement intermédiaire correspond à l’emplacement dans lequel ArcGIS Data Store extrait les fichiers de sauvegarde compressés avant de restaurer le data store. Si un data store dispose d’un emplacement de stockage Cloud configuré pour les sauvegardes, les fichiers de sauvegarde sont d’abord placés dans l’emplacement intermédiaire avant d’être copiés vers l’emplacement de stockage Cloud. Pour modifier l’emplacement intermédiaire, utilisez l’utilitaire changestaginglocation. |
Log location (Emplacement des fichiers journaux) | Répertoire dans lequel ArcGIS Data Store écrit les fichiers journaux. Pour modifier l’emplacement des fichiers journaux, utilisez l’utilitaire changeloglocation. |
Free disk space (Espace disque disponible) | Quantité d’espace disque disponible sur la machine sur laquelle ArcGIS Data Store est installé. |
Propriétés communes
Ces propriétés apparaissent pour chaque type de data store, mais leurs valeurs sont propres au data store pour lequel elles sont indiquées.
| Propriété | Description |
|---|---|
Backup location (Emplacement de sauvegarde) | Emplacement de sauvegarde par défaut utilisé par chaque type de data store. |
Backup schedule (Calendrier de sauvegarde) | Pour les sauvegardes automatisées, fréquence de création d’une sauvegarde pour chaque type de data store. |
Data store status (Statut du data store) | Indique si le data store est en cours d’exécution. |
Owning system URL (URL du système propriétaire) | Site GIS Server d’hébergement auprès duquel le data store est inscrit. Il s’agit généralement du même serveur d’hébergement pour tous les data stores de la machine. Il est cependant possible que des data stores de la même machine soient utilisés avec des déploiements différents de ArcGIS Enterprise. |
URL de Portal for ArcGIS | Il s’agit généralement de la même URL Portal for ArcGIS pour tous les data stores de la machine. Il est cependant possible que des data stores de la même machine soient utilisés avec des déploiements différents de ArcGIS Enterprise. |
Registered machines (Machines inscrites) | Liste de toutes les machines dans le type de data store spécifique. Cette propriété répertorie toutes les machines, quel que soit leur statut. |
Relational data store properties (Propriétés du data store relationnel)
Ces propriétés sont spécifiques d’un déploiement de data store relationnel.
| Propriété | Description |
|---|---|
Days backup retained (Conservation des sauvegardes (jours)) | Nombre de jours de conservation des fichiers de sauvegarde du data store relationnel avant leur suppression par ArcGIS Data Store. |
Is point-in-time-recovery enabled (Récupération ponctuelle activée ?) | Indique si le data store relationnel est configuré pour créer des sauvegardes incrémentielles, ce qui permet de le restaurer à un point précis dans le temps. Ce paramètre est configuré à l’aide de l’utilitaire changedbproperties. |
SSL enabled (SSL activé) | Indique si la communication SSL est activée. |
Threshold for READONLY mode (Seuil pour le mode de lecture seule) | Seuil d’espace disque disponible auquel le data store relationnel est placé en mode de lecture seule. Vous pouvez modifier cette valeur pour le data store relationnel à l’aide de l’utilitaire changedbproperties. |
Maximum connections (Nombre maximal de connexions) | Indique le nombre maximal de connexions autorisées vers le data store relationnel. |
Number of connections (Nombre de connexions) | Nombre de connexions actuelles de couches d’entités au data store relationnel. |
Data store mode (Mode du data store) | Indique si le data store est en mode de lecture-écriture ou en mode de lecture seule. |
Last failover (Dernier basculement) | Cette propriété indique la date et l’heure de la défaillance la plus récente de la machine principale, ayant entraîné la promotion de la machine de secours au rôle de machine principale. Cette propriété n’est pas indiquée si le data store n’a connu aucun basculement. |
Propriétés de data store de cache tuilé
Ces propriétés sont spécifiques d’un déploiement de data store de cache tuilé.
| Propriété | Description |
|---|---|
Member machines (Machines membres) | Si le data store de cache tuilé est déployé en mode Cluster, cette propriété fournit une liste des machines actives et disponibles dans le cluster. |
Last failover (Dernier basculement) | Pour les data stores de cache tuilé exécutés en mode Principal-secours, cette propriété indique la date et l’heure de la défaillance la plus récente de la machine principale, ayant entraîné la promotion de la machine de secours au rôle de machine principale. Cette propriété n’est pas indiquée si le data store n’a connu aucun basculement. |
Mode de déploiement | Indique si le data store de cache tuilé est exécuté en mode Principal-secours ou en mode Cluster. |
SSL enabled (SSL activé) | Indique si la communication SSL est activée. |
Propriétés de Spatiotemporal Big Data Store
Ces propriétés sont spécifiques d’un déploiement de Spatiotemporal Big Data Store.
| Propriété | Description |
|---|---|
Is cluster finalized (Cluster finalisé ?) | Indique si le cluster contient le nombre minimal requis de machines dotées des rôles coordinator et data. |
Automatic rebalance (Rééquilibrage automatique) | Si la valeur de cette propriété est définie sur on (activé), le Spatiotemporal Big Data Store distribue les données à d’autres machines, en cas d’indisponibilité d’une des machines. Si la valeur de cette propriété est définie sur off (désactivé), les données ne sont pas redistribuées en cas d’indisponibilité d’une machine. Il est possible de modifier ce paramètre à l’aide de l’utilitaire changedbproperties. |
Max rebalance off time (Interruption maximale du rééquilibrage) | Lorsque vous désactivez le rééquilibrage (auquel cas la propriété Automatic rebalance (Rééquilibrage automatique) prend la valeur off (désactivé)), la désactivation n’est effective que pendant la durée (en minutes) indiquée par cette propriété. À la fin de cette période, la propriété Automatic rebalance (Rééquilibrage automatique) reprend la valeur on (activé). Il est possible de modifier ce paramètre à l’aide de l’utilitaire changedbproperties. |
Threshold for READONLY mode (Seuil pour le mode de lecture seule) | Seuil d’espace disque disponible auquel le Spatiotemporal Big Data Store est placé en mode de lecture seule. |
Member machines (Machines membres) | Liste des machines actives et disponibles dans le cluster de Spatiotemporal Big Data Stores. |
Data store mode (Mode du data store) | Indique si le data store est en mode de lecture-écriture ou en mode de lecture seule. |
Current coordinator machine in cluster (Coordinateur actuel dans le cluster) | Machine du Spatiotemporal Big Data Store qui joue actuellement le rôle de coordinateur de toutes les machines du cluster. |
Coordinator candidate machines in spatiotemporal cluster (Machines candidates à la coordination dans le cluster spatio-temporel) | Machines du Spatiotemporal Big Data Store auxquelles le rôle coordinator a été attribué et qui peuvent donc devenir le coordinateur actuel. |
Data machines in spatiotemporal cluster (Machines data dans le cluster spatio-temporel) | Machines du Spatiotemporal Big Data Store auxquelles le rôle data a été attribué. |
Propriétés de graph store
Ces propriétés sont spécifiques d’un déploiement de graph store.
| Propriété | Description |
|---|---|
Mode de déploiement | Indique si le data store a été déployé dans une seule instance ou en mode Cluster. |
Last failover (Dernier basculement) | Cette propriété indique la date et l’heure de la défaillance la plus récente de la machine principale, ayant entraîné la promotion de la machine de secours au rôle de machine principale. Cette propriété n’est pas indiquée si le data store n’a connu aucun basculement. |
Propriétés d’object store
Ces propriétés sont spécifiques d’un déploiement d’object store.
| Propriété | Description |
|---|---|
Mode de déploiement | Indique si le data store a été déployé dans une seule instance ou en mode Cluster. Les object stores créés avec une version antérieure à ArcGIS Data Store 11.1 sont indiqués en mode Principal-secours, mais ne peuvent contenir qu’une seule machine. |
Syntaxe
describedatastore
Exemple
L’utilitaire describedatastore renvoie des informations d’ordre général qui s’appliquent à tous les data stores d’une machine, ainsi que des sections distinctes spécifiques contenant des informations propres à chaque type de data store.
Vous devriez enregistrer des data stores différents sur des machines distinctes, mais pour vous permettre de voir les informations renvoyées pour chaque type de data store, la sortie suivante présente une machine contenant tous les types ArcGIS Data Store sur la même machine. Les deux premières sections (Available ArcGIS Data Stores (Data stores ArcGIS Data Store disponibles) et General Information (Informations générales)) sont toujours renvoyées. Les sections relatives aux data stores renvoyées par l’utilitaire describedatastore varient en fonction du type de data store présent sur la machine sur laquelle vous exécutez l’utilitaire.
./describedatastore.sh
Available ArcGIS Data Stores
==============================================================
Relational Data Store
Tile Cache Data Store
Spatiotemporal Big Data Store
Graph Store
Object Store
General Information of ArcGIS Data Store on machine.domain.com
==============================================================
ArcGIS Data Store release....11.3.0.1234
Staging location............./arcgis/datastore/staging
Log location................./arcgis/datastore/logs
Free disk space..............174.00GB
Information for relational data store ds_sthiu0_5T
==============================================================
Backup location................/net/nwshare/dsbackups
Backup schedule................{"schedule-starttime":"00:00:00","schedule-frequency":"Every 1 DAYS"}
Days backup retained...........31
Data store status..............Started
SSL enabled....................true
Threshold for READONLY mode....2048MB
Last failover..................20150130190334005
Registered machines............MACHINE1.DOMAIN.COM, MACHINE4.DOMAIN.COM
Maximum connections............150
Owning system URL..............https://gisserver_webadaptor.domain.com/server
Portal for ArcGIS URL..........https://portal_webadaptor.domain.com/portal
Number of connections..........8 connection(s) to managed database
Data store mode................READWRITE
Is point-in-time recovery enabled...No
Information for tile cache data store ds_wztxj7um
==============================================================
Data location............/home/ags/arcgis/datastore/usr/arcgisdatastore/nosqldata
Data store status........Started
Last failover............20200130190334005
Backup location........../net/sharedir/datastore/backup
Backup schedule..........{"schedule-starttime":"01:00:00","schedule-frequency":"Every 2 DAYS"}
Deployment mode..........cluster
SSL enabled..............true
Member machines..........MACHINE1.DOMAIN.COM, MACHINE2.DOMAIN.COM, MACHINE3.DOMAIN.COM
Registered machines......MACHINE1.DOMAIN.COM, MACHINE2.DOMAIN.COM, MACHINE3.DOMAIN.COM
Owning system URL........https://gisserver_webadaptor.domain.com/server
Portal for ArcGIS URL....https://portal_webadaptor.domain.com/portal
Information for spatiotemporal big data store ds_qpko99Cl
==============================================================
Is cluster finalized................Yes
Max rebalance off time..............60 minutes
Automatic rebalance ................On
Threshold for READONLY mode.........1024MB
Backup location...................../net/dirshare2/sbds_bu
Backup schedule.....................{"schedule-starttime":"02:00:00","schedule-frequency":"Every 2 DAYS"}
Member machines.....................MACHINE1.DOMAIN.COM, MACHINE2.DOMAIN.COM, MACHINE3.DOMAIN.COM
Coordinator candidate machines in spatiotemporal cluster..MACHINE1.DOMAIN.COM, MACHINE2.DOMAIN.COM, MACHINE3.DOMAIN.COM
Current coordinator machine in cluster......MACHINE1.DOMAIN.COM
Data machines in spatiotemporal cluster.....MACHINE1.DOMAIN.COM, MACHINE2.DOMAIN.COM, MACHINE3.DOMAIN.COM
Registered machines.................MACHINE1.DOMAIN.COM, MACHINE2.DOMAIN.COM, MACHINE3.DOMAIN.COM
Owning system URL...................https://gisserver_webadaptor.domain.com/server
Portal for ArcGIS URL...............https://portal_webadaptor.domain.com/portal
Data store mode.....................READWRITE
Information for graph store x2b7s0n
==============================================================
Deployment mode..............primaryStandby
Backup location............../net/dirshare3/graphbu
Backup schedule..............{"schedule-starttime":"03:00:00","schedule-frequency":"Every 3 DAYS"}
Registered machines..........MACHINE1.DOMAIN.COM
Owning system URL............https://gisserver_webadaptor.domain.com/server
Portal for ArcGIS URL........https://portal_webadaptor.domain.com/portal
Information for object store w1tiknx
==============================================================
Deployment mode...........singleInstance
Backup location.........../net/dirshare4/myfiles/ods_bu
Backup schedule...........{"schedule-starttime":"04:00:00","schedule-frequency":"Every 1 DAYS"}
Registered machines.......MACHINE1.DOMAIN.COM
Owning system URL.........https://gisserver.domain.com:6443/server/admin
Portal for ArcGIS URL.....https://portal_webadaptor.domain.com/portaldiskcleanup
Cet utilitaire est utilisé avec des data stores relationnels, des data stores de cache tuilé et des data stores de Big Data spatio-temporelles.
L’utilitaire diskcleanup supprime les fichiers temporaires laissés par des opérations telles que restoredatastore et la mise à niveau de ArcGIS Data Store. Certains fichiers sont conservés après la mise à niveau afin de vous permettre d’identifier un échec de l’opération de mise à niveau ou de restauration. Une fois que vous confirmez la réussite de l’opération de mise à niveau ou de restauration et que le système fonctionne comme prévu, vous pouvez exécuter cet outil pour supprimer les fichiers temporaires et récupérer l’espace disque disponible sur les machines de data store.
Cet utilitaire nettoie l’espace disque sur une machine à la fois. Si vous avez besoin de nettoyer des fichiers sur plusieurs machines dans le même data store, vous devez exécuter l’outil sur chaque machine.
Syntaxe
diskcleanup
Exemple
Pour exécuter l’utilitaire diskcleanup, vous devez confirmer que vous souhaitez continuer.
./diskcleanup
You are attempting to cleanup some archived data generated as part of ArcGIS Data Store upgrades or backup-restore operations. Once removed, this data can't be recovered. Do you want to continue (Yes or No)?
listadminusers
Cet utilitaire est utilisé pour tous les types de data store.
L’utilitaire listadminusers retourne les noms d’utilisateur et les mots de passe de l’administrateur, du propriétaire du réplica et de l’administrateur de géodatabase d’un data store relationnel. Il renvoie les informations d’identification de l’administrateur pour tous les autres types de data store.
Syntaxe
listadminusers
Exemples
Dans cet exemple, listadminusers est exécuté sur une machine sur laquelle seul un répertoire de données relationnelles est installé.
./listadminusers.sh
Admin users for relational data store ds_abcd1234 ================================================= Database Admin User.... adm_32ret / tT30sbYk22jF Database Repl User..... dsrepuser / uWn/MV0678h4 GDB Admin User......... sde / iO=Qst751epb
Dans cet exemple, listadminusers est exécuté sur une machine sur laquelle seul un répertoire de Big Data spatio-temporelles est installé.
./listadminusers.sh
Admin users for spatiotemporal big data store bds_abcd1234 ================================================= Store admin user.... els_321ret / B1as70fF1
Dans cet exemple, listadminusers est exécuté sur une machine sur laquelle seule une base de graphiques est installée.
./listadminusers.sh
Admin users for graph store s2t0ic1 ================================================= Store admin user....root / ypz5kx2c5tk4fequ
Dans cet exemple, listadminusers est exécuté sur une machine sur laquelle seul un object store est installé.
./listadminusers.sh
Admin users for object store w1tiknx ================================================= Store admin user....n6o96nl53vzkm36d / bpvifyjz73xwhot4
listbackups
Cet utilitaire est utilisé pour tous les types de data store.
Lorsqu’il est exécuté pour des répertoires de données relationnelles, l’utilitaire listbackups fonctionne uniquement sur la machine principale du répertoire de données.
Exécutez l’utilitaire listbackups pour déterminer les éléments suivants :
- L’heure de démarrage de l’opération de sauvegarde
- Si une sauvegarde est terminée ou encore en cours d’exécution
- Si la sauvegarde a été créée à l’aide de l’utilitaire backupdatastore ou automatiquement par ArcGIS Data Store
- Les fichiers de sauvegarde viables. Si le fichier de sauvegarde n’est pas renvoyé par l’utilitaire listbackups, il ne peut pas être utilisé pour restaurer le data store. Par exemple, les fichiers de sauvegarde créés avec une version antérieure de ArcGIS Data Store risquent de ne pas pouvoir restaurer le data store.
- Le nombre de fichiers de sauvegarde dont vous disposez, pour déterminer si vous devez en supprimer
- Confirmer les noms des fichiers de sauvegarde avant d’exécuter l’utilitaire deletebackup
Lorsque vous exécutez l’utilitaire listbackups, indiquez l’emplacement de sauvegarde pour lequel vous voulez afficher la liste des fichiers de sauvegarde. Si vous ne spécifiez pas d’emplacement, l’utilitaire listbackups renvoie des sauvegardes pour l’emplacement de sauvegarde par défaut.
Syntaxe
listbackups [--store {relational | tileCache | spatiotemporal | graph | object}] [--location "<location_arguments>"]
Si vous ne spécifiez pas de type de data store (--store), l’utilitaire utilise le type relational par défaut et renvoie les sauvegardes du data store relationnel exécuté sur cette machine. Si le data store relationnel ne se trouve pas sur la machine où vous exécutez l’utilitaire, un message d’erreur est renvoyé.
Utilisez l’option --location pour découvrir les informations des sauvegardes dans un emplacement de sauvegarde inscrit en particulier. Si vous ne spécifiez pas d’emplacement, les informations relatives à l’emplacement de sauvegarde par défaut sont renvoyées. Indiquez l’un des arguments suivants avec l’option --location :
| Argument | Description |
|---|---|
name= | Indiquez le nom de l’emplacement de sauvegarde. Vous avez spécifié ce nom lorsque vous avez configuré l’emplacement de sauvegarde ou, si vous n’avez pas spécifié de nom, ArcGIS Data Store en a attribué un par défaut. |
location= | Spécifiez le chemin d’accès au répertoire de fichiers partagés, au compartiment S3 ou au conteneur de stockage Blob que vous avez inscrit comme emplacement de sauvegarde. |
Exemples
Cet exemple répertorie les sauvegardes pour l’emplacement de sauvegarde par défaut d’un data store relationnel :
./listbackups.sh --store relational
Backup_Name Status Backup_Time Mode ======================================================================= phase1proj_bu BackupComplete 2023-03-08 14:12 manual phase2proj_bu BackupComplete 2023-02-21 11:43 manual ds_gdt1omh-2023020130 BackupComplete 2023-02-01 03:00 scheduled Backups located at: '/net/myserver.net.com/dsbackups'
Dans cet exemple, les sauvegardes de stockage de Big Data spatio-temporelles sont répertoriées pour l’emplacement de sauvegarde nommé sbdsbu :
./listbackups.sh --store spatiotemporal --location "name=sbdsbu"
Backup_Name Status Backup_Time Mode ================================================================== backup1 BackupComplete 2023-07-11 09:47 manual Backups located at: '/net/myserver.ntw.com/spatiotemporal'
listdatasources
Cet utilitaire est utilisé avec des data stores de Big Data spatio-temporelles.
En raison d’un bug dans la version 10.8.1, ArcGIS GeoEvent Server les services de carte utilisant l’agrégation de carré ou d’hexagone ne sont pas affichés après la mise à niveau vers la version 10.9 ou ultérieure. Pour corriger cela, vous pouvez exécuter l’utilitaire listdatasources afin d’obtenir les noms des services de carte GeoEvent Server, et utiliser les noms de service qu’il renvoie avec l’utilitaire upgradedatasource afin de mettre à jour les données pour les services individuels.
L’utilitaire listdatasources peut s’exécuter sur n’importe quelle machine dans le data store de Big Data spatio-temporel.
Syntaxe
listdatasources
Exemple
Exécutez l’utilitaire listdatasources à une invite de commande pour renvoyer une liste de services de carte GeoEvent Server.
./listdatasources
listmanageduser
Cet utilitaire est utilisé pour tous les types de data store.
L’utilitaire listmanageduser renvoie le nom d’utilisateur et le mot de passe du compte qui détient les données de la couche d’entités hébergée dans les data stores relationnels et de Big Data spatio-temporels. Cet utilitaire renvoie également le nom d’utilisateur et le mot de passe du propriétaire du cache de scène pour les data stores de cache tuilé, ainsi que le propriétaire des graphiques situés dans le graph store et le propriétaire des vidéos de l’object store.
Syntaxe
listmanageduser
Exemples
Dans l’exemple suivant, listmanageduser est exécuté sur une machine contenant un répertoire de données relationnelles et du cache de tuiles. La machine est le répertoire de données principal.
./listmanageduser.sh
Managed user for relational data store ds_abcd1234 =================================================== UserName Password Database gwi_n2Te0 4cXddhZhve=Y db_qv5e1 Managed user for tile cache data store tcs_e41f0rj2 =================================================== UserName Password usr_n8778 y47ccno913
Dans cet exemple, listmanageduser est exécuté sur une machine de stockage de Big Data spatio-temporelles.
./listmanageduser.sh
Managed user for spatiotemporal big data store bds_6udbx4321 ============================================================= UserName Password fmr_o1He3 5vZggkPbaw+T
Dans l’exemple suivant, listmanageduser est exécuté sur une machine avec une base de graphiques.
./listmanageduser.sh
Managed user for graph store s2t0ic1 ================================================ UserName Password mu_vwmp8c6 m5c2so76y3b0qczf
Dans l’exemple suivant, listadminusers est exécuté sur une machine avec un object store.
./listmanageduser.sh
Managed user for object store w1tiknx ============================================================= Store credential........n6o96nl53vzkm36d / bpvifyjz73xwhot4
registerdatastore
Cet utilitaire est utilisé pour tous les types de data store.
Le data store conserve les informations relatives aux noms de machine du site GIS Server d’hébergement. Si vous transférez le site GIS Server d’hébergement vers de nouvelles machines (par exemple, si vous avez acheté du nouveau matériel ou si les machines GIS Server existantes sont défaillantes), vous devez désinscrire le data store du site GIS Server pour supprimer ces informations. Une fois le site GIS Server configuré sur une ou plusieurs nouvelles machines, inscrivez le data store auprès du site GIS Server à l’aide de l’utilitaire registerdatastore.
Remarque :
L’utilitaire registerdatastore permet d’inscrire le data store auprès du même site GIS Server qu’auparavant. Le stockage des données contient les données des couches hébergées du site GIS Server. Le fait de l’enregistrer sur un autre site GIS Server n’entraîne pas une nouvelle création des couches hébergées.
L’utilitaire registerdatastore peut s’exécuter sur la machine principale du data store relationnel ou du graph store, ou sur la machine principale d’un data store de cache tuilé qui s’exécute en mode Principal-secours. Il peut être exécuté sur n’importe quelle machine dans un data store de cache de tuiles ou un object store s’exécutant en mode grappe ou sur n’importe quelle machine de data store de Big Data spatio-temporel.
Syntaxe
registerdatastore <ArcGIS Server URL> <ArcGIS Server site administrator username> <ArcGIS Server site administrator password> --stores {relational | tileCache | spatiotemporal | graph | object}
Même si cette opération n’est pas recommandée, si différents types de stockages des données sont installés sur la même machine, vous pouvez les inscrire en même temps en les séparant par une virgule (pas d’espaces). Par exemple, saisissez --stores relational,tileCache.
Exemple
Dans cet exemple, un stockage des données relationnelles est réinscrit auprès d’un site GIS Server avec l’URL https://gisserver.domain.com:6443. Le nom d’utilisateur de l’administrateur du site ArcGIS Server principal est agsadmin et le mot de passe, Tan$p0n.
./registerdatastore.sh https://gisserver.domain.com:6443 agsadmin Tan$p0n --stores relational
removemachine
Cet utilitaire est utilisé avec des data stores relationnels, des data stores de cache tuilé et des data stores de Big Data spatio-temporelles, ainsi que des graph stores.
Employez l’utilitaire removemachine pour retirer une machine d’un répertoire de données contenant plusieurs machines. Utilisez cet utilitaire pour effectuer les opérations suivantes :
- Supprimez une machine de secours d’un data store relationnel ou d’un graph store. Vous pouvez exécuter cet utilitaire sur la machine de secours ou depuis la machine principale si la machine de secours n’est pas disponible.
- Retirez une machine d’un répertoire de données du cache de tuiles. Vous pouvez exécuter cet utilitaire sur n’importe quelle machine du répertoire de données du cache de tuiles, mais vous ne pouvez pas exécuter removemachine sur un répertoire de données du cache de tuiles composé d’une seule machine.
- Supprimez une machine d’un stockage de Big Data spatio-temporelles. Vous pouvez exécuter cet utilitaire sur n’importe quelle machine du répertoire de Big Data spatio-temporelles, mais vous ne pouvez pas exécuter removemachine sur un répertoire de Big Data spatio-temporelles composé d’une seule machine.
Si vous exécutez cet utilitaire sur la machine coordinatrice actuelle, l’une des machines restantes éligibles au rôle manager du cluster doit prendre le rôle de coordinateur actuel. Pour ce faire, le cluster doit comporter au moins deux autres machines auxquelles le rôle manager est attribué. Avant de supprimer une machine, exécutez l’utilitaire describedatastore pour identifier la machine qui joue le rôle de coordinateur actuel ainsi que les machines éligibles à cette fonction.
Syntaxe
removemachine <machine name> --store {relational | tileCache | spatiotemporal | graph} [--force {true | false}] [--prompt {yes | no}]
Vous devez indiquer le nom de la machine et le type de data store.
Spécifiez true pour l’option --force uniquement si le site ArcGIS Server inscrit n’est pas disponible.
Par défaut, vous êtes invité à confirmer l’exécution de l’utilitaire. Si vous ne souhaitez pas confirmer l’action, indiquez no pour l’option --prompt.
Exemples
Dans cet exemple, la machine du stockage de Big Data spatio-temporelles, gefour, est supprimée du stockage des données.
./removemachine.sh gefour --store spatiotemporal --prompt no
Dans cet exemple, le site de serveur d’hébergement n’est pas disponible et la machine de stockage de données relationnelles, fsdata, est supprimée du stockage de données.
./removemachine.sh fsdata --store relational --force true --prompt no
replacesslcertificate
Cet utilitaire est utilisé pour tous les types de data store.
Vous pouvez remplacer le certificat auto-signé ArcGIS Data Store utilisé par le serveur Web pour authentifier la communication entre le serveur d’hébergement et le data store, et entre les machines de data store par un certificat vérifié et signé par une autorité de certification ou un certificat de domaine. Vous pouvez également remplacer le certificat auto-signé utilisé pour la communication entre les machines via les ports pour les types de data store suivants :
- Stockage des données relationnelles
- Stockage des données du cache de tuiles
- Base de graphiques
- stockage d’objets
Cet utilitaire remplacera à terme l’utilitaire updatesslcertificate.
Pour plus d’informations, reportez-vous à la rubrique Remplacer le certificat SSL de ArcGIS Data Store.
Syntaxe
replacesslcertificate <source certificate file name with path> <password for the source certificate file> <alias for the certificate> --option <webserver | relational | graph | object | tileCache>
Exemples
Dans l’exemple suivant, le certificat auto-signé utilisé pour l’authentification par le serveur Web est remplacé par un fichier de certificat signé par une autorité de certification (mysignedcert.pfx).
./replacesslcertificate.sh /usr/files/mysignedcert.pfx "ps4mycert" "mycacert" --option webserver
Dans l’exemple suivant, le certificat auto-signé utilisé pour la communication avec le data store relationnel via les ports est remplacé par un certificat signé par une autorité de certification (mysecondsignedcert.pfx).
./replacesslcertificate.sh /usr/files/mysecondsignedcert.pfx "ps4mycert" "relcacert" --option relational
restoredatastore
Cet utilitaire est utilisé pour tous les types de data store.
Si vous n’avez plus accès aux données utilisées par vos couches hébergées, utilisez vos fichiers de sauvegarde et l’utilitaire restoredatastore pour récupérer le data store.
Si vous ne parvenez pas à récupérer le data store, installez ArcGIS Data Store sur une nouvelle machine, ne configurez pas le data store et restaurez la dernière sauvegarde complète sur la nouvelle machine.
Si vous utilisez un stockage des données relationnelles et que vous voulez récupérer les données des couches d’entités hébergées à un moment précis du passé, procédez à la restauration sur le stockage des données relationnelles existant.
Remarque :
Le data store relationnel doit être configuré pour prendre en charge la récupération ponctuelle. Vous pouvez restaurer un état précédent du data store relationnel uniquement si les fichiers de sauvegarde sont disponibles. Par exemple, si vous conservez les sauvegardes des cinq derniers jours uniquement, vous ne pouvez récupérer le stockage des données qu’à un moment donné de ces cinq jours.
Si vous devez remplacer l’une des machines d’un répertoire de données du cache de tuiles, il est fort probable que vous deviez rééquilibrer les caches des couches de scènes dans le répertoire de données du cache de tuiles. Une partie de ce processus requiert que vous restauriez le stockage de données du cache de tuiles, en définissant l’option replicatedata sur true. Pour connaître les instructions, reportez-vous à la rubrique Récupérer un répertoire de données.
L’utilitaire restoredatastore doit être exécuté sur la machine principale du data store relationnel. L’utilitaire peut être exécuté sur l’une des machines de data store de cache tuilé, de data store de Big Data spatio-temporelles, de graph store ou d’object store.
Remarque :
Pour savoir quels fichiers de sauvegarde vous pouvez utiliser lors de la restauration, exécutez l’utilitaire listbackups.
Syntaxe
restoredatastore [options]
Les options prises en charge sont répertoriées dans le tableau ci-après :
| Option | Description |
|---|---|
--store | Spécifie le type de data store à restaurer. Les valeurs valides sont relational, tileCache, spatiotemporal, graph et object. |
--target | Les valeurs valides sont most-recent, l’horodatage du fichier de sauvegarde au format <yyy-mm-dd-hh:mm:ss> et le nom du fichier de sauvegarde. Tous les types de data store prennent en charge le nom de fichier de sauvegarde avec l’option target. L’horodatage et most-recent sont uniquement pris en charge pour les data stores relationnels. Lors de la restauration après un blocage ou d’un transfert du data store relationnel, spécifiez --target most-recent. Si vous restaurez un data store relationnel à point précis dans le temps (ce qui nécessite que le data store relationnel soit configuré pour autoriser la récupération ponctuelle), indiquez la date et l’heure (UTC) auxquelles vous voulez restaurer le data store. Si vous voulez restaurer un fichier de sauvegarde spécifique, indiquez plutôt son nom. Si vous ne spécifiez pas de cible, la sauvegarde la plus récente est restaurée. |
--source-loc | Il s’agit du répertoire de niveau supérieur dans lequel se trouvent les fichiers de sauvegarde à utiliser pour restaurer le data store. Il s’agira du chemin d’accès à un emplacement de partage de fichiers, à un nom d’emplacement de sauvegarde ou à un emplacement de sauvegarde du stockage Blob Amazon S3 ou Azure. Conseil :Pour obtenir les emplacements sources de sauvegarde, vous pouvez exécuter l’utilitaire configurebackuplocation avec l’option --operation définie sur list. Si vous ne pouvez pas exécuter l’utilitaire configurebackuplocation (par exemple, si la machine du data store est en panne et que vous procédez à une restauration vers une nouvelle machine pour récupérer le data store), vous pouvez identifier l’emplacement source de sauvegarde par la présence d’un fichier nommé agsds_backup_sig. |
--bound | Les valeurs valides sont true et false. L’option --bound n’est prise en charge qu’avec les data stores relationnels. Par défaut, l’utilitaire suppose que vous restaurez le data store relationnel en vue d’utiliser le site GIS Server auprès duquel il a été inscrit lorsque vous avez créé la sauvegarde. Spécifiez --bound false uniquement si vous voulez restaurer le data store sans conserver l’association avec le site GIS Server du data store. Si vous avez déplacé les services hébergés vers un autre GIS Server, vous pouvez définir l’option --bound sur false (faux) et spécifier l’URL du nouveau site GIS Server avec l’option --server-url lors de la restauration. Vous pouvez également restaurer le data store relationnel non lié à partir de son GIS Server en dernier recours si le site GIS Server précédent est perdu et ne peut pas être récupéré. Vous pouvez restaurer le data store non lié et le configurer avec un nouveau site GIS Server fédéré. Cependant, les couches qui utilisent les données dans le stockage des données n’existent plus. Vous devez alors vous connecter à la base de données du stockage de données pour extraire les données dans un autre format, puis les republier dans ArcGIS Enterprise. |
--data-dir | Il s’agit du répertoire ArcGIS Data Store sur la machine sur laquelle vous restaurez la base de données. N’utilisez --data-dir que si vous restaurez le stockage de données sur une nouvelle machine. Si vous le restaurez sur une nouvelle machine, vous devez également spécifier l’option --source-loc. |
--server-url | Si vous spécifiez --bound true (ou si vous omettez l’option --bound) pour que le data store reste inscrit auprès du site GIS Server auprès duquel il a été inscrit lorsque vous avez créé la sauvegarde, spécifiez l’URL de ce site GIS Server. Si vous spécifiez --bound true et que vous avez transféré vos services vers un nouveau site GIS Server, utilisez l’opération --server-url pour spécifier l’URL du nouveau site GIS Server. Si vous spécifiez l’URL d’un nouveau site et que vous n’avez pas transféré les services vers ce nouveau serveur, les données du data store ne sont pas accessibles. |
--server-admin | Cette option est requise si vous spécifiez --bound true ou si vous n’indiquez pas l’option --bound. Spécifiez le nom d’utilisateur de l’administrateur ArcGIS Server. |
--server-password | Cette option est requise si vous spécifiez --bound true ou si vous n’indiquez pas l’option --bound. Fournissez le mot de passe de l’administrateur ArcGIS Server. |
--loaddata | Cette option est prise en charge avec les data stores de cache tuilé et les Spatiotemporal Big Data Stores, ainsi qu’avec les graph stores et les object stores. Les valeurs valides sont true et false. Définissez cette option sur false si vous devez restaurer le stockage de données sur un nouvel ensemble de machines, mais que l’espace de stockage de la première machine est insuffisant. Cela vous permet de restaurer la structure du stockage des données, d’ajouter des machines au stockage de données pour accommoder toutes les données, puis de réexécuter l’utilitaire restoredatastore avec l’option --loaddata définie sur true pour restaurer les données. Par défaut, cette option est définie sur true. |
--replicatedata | Prise en charge avec les data stores de cache tuilé. Les valeurs valides sont true et false. Définissez cette option sur true si vous devez rééquilibrer les données des caches de scènes une fois que vous avez ajouté une machine au stockage de données du cache de tuiles. |
--mode | Les valeurs valides sont primaryStandby et cluster. Lorsque vous restaurez un data store de cache tuilé sur une nouvelle machine, indiquez si vous souhaitez un data store de cache tuilé sur deux machines pour assurer une haute disponibilité (primaryStandby) ou un data store de cache tuilé évolutif sur plusieurs machines (cluster). |
--prompt | Les valeurs valides sont yes et no. vous exécutez cet utilitaire, vous êtes invité à confirmer l’action spécifiée. Si vous automatisez l’utilisation de cet utilitaire, définissez l’option --prompt sur no. Sinon, le script ne continue que si vous répondez à l’invite. |
Exemples
Dans cet exemple, la sauvegarde la plus récente se trouve à un emplacement de sauvegarde nommé rdsbackups et est restaurée dans le data store existant. Le type de data store par défaut étant relationnel et restant lié par défaut au site GIS Server auprès duquel il est inscrit, vous n’êtes pas obligé de spécifier --store relational ou --bound true. Toutefois, vous devez spécifier l’URL de GIS Server et les informations d’identification de l’administrateur.
./restoredatastore.sh --target most-recent --source-loc rdsbackups --server-url https://gisserver.domain.com:6443 --server-admin siteadmin --server-password SAup.4s
You are attempting to restore the data store from a data store backup. This process could take a long time, depending on the size of your data. Please do not interrupt the process once it has started. Do you want to continue (Yes or No)?Yes
Dans cet exemple, un data store relationnel sur lequel la récupération ponctuelle est activée est restauré à partir de l’emplacement de sauvegarde du data store relationnel sur un partage réseau à l’état dans lequel il se trouvait à 14h30 (UTC) le 17 juillet 2014.
./restoredatastore.sh --target 2014-07-17-14:30:00 --source-loc /net/sharedserver/entbackups/relds --server-url https://gisserver.domain.com:6443 --server-admin siteadmin --server-password SAup.4s
You are attempting to restore the data store from a data store backup. This process could take a long time, depending on the size of your data. Please do not interrupt the process once it has started. Do you want to continue (Yes or No)?Yes
Dans cet exemple, le stockage des données relationnelles est restauré sur une nouvelle machine grâce à un fichier de sauvegarde nommé movedatastore. Si vous le restaurez sur une nouvelle machine, vous devez spécifier l’emplacement du fichier de sauvegarde et celui du nouveau répertoire de données ArcGIS Data Store. Les services d’entités hébergées étant toujours exécutés sur le site GIS Server auprès duquel le data store relationnel est inscrit, l’option --bound true n’est pas requise, mais l’URL de GIS Server et les informations d’identification de l’administrateur le sont.
./restoredatastore.sh --target movedatastore --source-loc /net/buserver/data/backups --data-dir /usr/datastore --server-url https://gisserver.domain.com:6443 --server-admin siteadmin --server-password SAup.4s
You are attempting to restore the data store from a data store backup. This process could take a long time, depending on the size of your data. Please do not interrupt the process once it has started. Do you want to continue (Yes or No)?Yes
Dans l’exemple suivant, le stockage des données du cache de tuiles est restauré sur une nouvelle machine. Si vous le restaurez sur une nouvelle machine, vous devez spécifier l’emplacement du fichier de sauvegarde et celui du nouveau répertoire de données ArcGIS Data Store. Les services de scènes étant toujours exécutés sur le site GIS Server auprès duquel le data store de cache de tuiles est inscrit, l’option --bound true n’est pas requise, mais l’URL d’GIS Server et les informations d’identification de l’administrateur le sont.
./restoredatastore.sh --store tilecache --source-loc /net/buserver/scenedata/backups --data-dir /usr/datastore --server-url https://gisserver.domain.com:6443 --server-admin siteadmin --server-password SAup.4s
You are attempting to restore the data store from a data store backup. This process could take a long time, depending on the size of your data. Please do not interrupt the process once it has started. Do you want to continue (Yes or No)?Yes
Dans cet exemple, le répertoire de données du cache de tuiles est restauré à partir d’un fichier nommé mybackupfilename et les données des caches de scène sont rééquilibrées après l’ajout d’une nouvelle machine dans le répertoire de données du cache de tuiles.
./restoredatastore.sh --store tilecache --target mybackupfilename --serverurl https://gisserver.domain.com:6443 --server-admin siteadmin --server-password myAdminPWd! --replicatedata true
You are attempting to restore the data store from a data store backup. This process could take a long time, depending on the size of your data. Please do not interrupt the process once it has started. Do you want to continue (Yes or No)?Yes
Dans l’exemple suivant, un fichier de sauvegarde de stockage de Big Data spatio-temporelles (bds1) est restauré à partir d’un emplacement de sauvegarde nommé (awsloc).
./restoredatastore.sh --target bds1 --store spatiotemporal --source-loc 'name=awsloc' --server-url https://gisserver.domain.com:6443 --server-admin siteadmin --server-password SAup.4s
You are attempting to restore the data store from a data store backup. This process could take a long time, depending on the size of your data. Please do not interrupt the process once it has started. Do you want to continue (Yes or No)?Yes
Reportez-vous à la rubrique Récupérer un stockage des données pour connaître les étapes à suivre et obtenir un exemple de restauration d’un stockage des données spatio-temporelles après une défaillance matérielle.
revokeconnection
Cet utilitaire sert dans le cadre des data stores relationnels.
Si vous avez utilisé l’utilitaire allowconnection pour autoriser temporairement un autre client à se connecter directement au stockage des données relationnelles, vous pouvez annuler la connexion autorisée au moyen de l’utilitaire revokeconnection.
L’utilitaire revokeconnection peut être exécuté sur la machine de stockage des données relationnelles principale uniquement.
Syntaxe
revokeconnection <host name> <username> [<database>]
Exemple
Dans cet exemple, la base de données du stockage des données n’accepte plus les connexions de la machine workcom lorsqu’elles sont faites via l’utilisateur hqo.n_1E7.
./revokeconnection.sh workcom bn0_3Wa.m hqo.n_1E7
unregisterdatastore
Cet utilitaire est utilisé pour tous les types de data store.
Vous pouvez utiliser l’utilitaire unregisterdatastore pour effectuer les opérations suivantes :
- Désinscrivez un data store à une seule machine de n’importe quel type de site GIS Server d’hébergement.
Vous devez redémarrer le serveur d’hébergement après avoir désinscrit un object store.
- Dans les data stores exécutés en mode Principal-secours, vous pouvez désinscrire la machine principale après avoir supprimé la machine de secours.
- Pour les Spatiotemporal Big Data Stores et les data stores de cache tuilé exécutés en mode Cluster, vous pouvez désinscrire la dernière machine après avoir supprimé toutes les autres machines du cluster.
Remarque :
Si vous désinscrivez un data store pour le supprimer définitivement du déploiement, supprimez les couches hébergées qui utilisent les données avant de désinscrire ce data store. Par exemple, si les membres d’une organisation ont testé les GeoAnalytics Tools et ont utilisé le Spatiotemporal Big Data Store pour les couches créées par ces outils, mais qu’ils se sont ensuite aperçus que les couches pouvaient être stockées dans le data store relationnel à la place, supprimez les couches d’entités spatio-temporelles hébergées avant de désinscrire le Spatiotemporal Big Data Store. Dans le cas contraire, des éléments de couches inutilisables sont conservées dans le portail et des services inutilisables sont exécutés sur le serveur d’hébergement.
Lorsque vous désinscrivez une machine d’un data store, le site GIS Server d’hébergement (ou le site ArcGIS Knowledge Server dans le cas de graphes de connaissances) ne peut plus se connecter à cette machine et les services qui contenaient les données du data store désinscrit ne fonctionnent plus. Toutefois, cet utilitaire ne supprime pas les données ; si vous décidez que vous avez encore besoin du data store, vous pouvez utiliser l’utilitaire registerdatastore ou configuredatastore pour le rajouter.
Syntaxe
unregisterdatastore --stores {relational | tileCache | spatiotemporal | graph | object} [--prompt {yes | no}]
Si plusieurs types de stockage des données sont installés sur la même machine et que vous voulez en désinscrire plusieurs à la fois, spécifiez leur nom en les séparant par une virgule (pas d’espaces). Par exemple, pour désinscrire un stockage des données relationnelles et du cache de tuiles principale, saisissez --stores relational,tileCache.
Exemple
Ici, l’utilitaire unregisterdatastore s’exécute pour désinscrire les stockages des données relationnelles et du cache de tuiles du site GIS Server. Une invite est renvoyée, ce qui correspond au comportement par défaut. Pour supprimer l’invite, indiquez --prompt No.
./unregisterdatastore.sh --stores relational,tileCache You are going to unregister the data store. Do you want to continue (Yes or No)?Yes
updatebackupretaindays
Cet utilitaire sert dans le cadre des data stores relationnels.
Par défaut, ArcGIS Data Store conserve les fichiers de sauvegarde du stockage de données relationnelles pendant sept jours. Vous pouvez changer la fréquence à laquelle les fichiers de sauvegarde sont purgés du répertoire de sauvegarde, à l’aide de l’utilitaire updatebackupretaindays.
L’utilitaire updatebackupretaindays peut être exécuté sur la machine de stockage des données relationnelles principale uniquement.
Syntaxe
updatebackupretaindays <number of days>
Exemple
Dans l’exemple suivant, la durée de rétention des fichiers de sauvegarde est définie sur 10 jours :
./updatebackupretaindays.sh 10
updatebackupschedule
Cet utilitaire est utilisé pour tous les types de data store.
Par défaut, ArcGIS Data Store crée une sauvegarde complète du stockage des données relationnelles tous les quatre jours. Vous pouvez changer la fréquence à laquelle une sauvegarde complète est créée, à l’aide de l’utilitaire updatebackupschedule.
Il n’existe aucune sauvegarde automatique par défaut pour les data stores de cache tuilé ou de Big Data spatio-temporelles, ou les bases de graphiques. Pour définir un calendrier de sauvegarde automatique pour un stockage de Big Data spatio-temporelles, vous devez d’abord définir un emplacement de sauvegarde valide.
Indiquez une heure de début au format 24 heures, 00:00:00 représentant minuit et 13:00:00 une heure de l’après-midi. Utilisez l’option frequency pour indiquer le nombre de jours devant s’écouler entre chaque sauvegarde. Pour désactiver les sauvegardes automatiques, définissez la fréquence sur 0. Si vous désactivez les sauvegardes automatiques, veillez à exécuter l’utilitaire backupdatastore pour créer manuellement des sauvegardes.
Vous pouvez exécuter l’utilitaire updatebackupschedule sur la machine principale du répertoire de données relationnelles. Cet outil peut être exécuté sur n’importe quelle machine de répertoire de données du cache de tuiles ou de Big Data spatio-temporelles.
Pour plus d’informations sur les sauvegardes ArcGIS Data Store, consultez la rubrique Gérer les sauvegardes ArcGIS Data Store.
Syntaxe
updatebackupschedule [--store {relational | tileCache | spatiotemporal | graph | object}] [--starttime <local server time>] --frequency <number of days>
Si vous n’indiquez pas une nouvelle heure de début, le paramètre d’heure de début existant ne change pas. Si vous n’indiquez pas de type de stockage des données, le stockage des données relationnelles est utilisé par défaut.
Exemples
Dans cet exemple, les sauvegardes complètes d’un stockage des données relationnelles ont lieu à 23 h (heure sur le serveur local) tous les 10 jours :
./updatebackupschedule.sh --starttime 23:00:00 --frequency 10
Dans cet exemple, un calendrier de sauvegarde est défini pour un stockage des données du cache de tuiles. Après la copie de sauvegarde initiale de toutes les bases de données de stockages des données du cache de tuiles, ArcGIS Data Store copie les bases de données de stockages des données récemment créées à l’emplacement spécifié avec l’utilitaire configurebackuplocation tous les 14 jours.
./updatebackupschedule.sh --store tileCache --frequency 14
updatesslcertificate
Cet utilitaire est utilisé pour tous les types de data store.
Cet utilitaire est obsolète à compter de cette version. Il est conseillé d’utiliser l’utilitaire replacesslcertificate à la place.
Vous pouvez remplacer le certificat auto-signé utilisé par le serveur Web pour authentifier la communication entre le serveur d’hébergement et le data store, et entre les machines de data store par un certificat vérifié et signé par une autorité de certification ou un certificat de domaine.
Cet utilitaire ne remplace pas le certificat utilisé pour authentifier la communication via les ports.
Syntaxe
updatesslcertificate <source certificate file name with path> <password for the source certificate file> <alias for the certificate>
Exemple
Une fois que vous avez reçu un fichier de certificat signé par une autorité de certification, exécutez updatesslcertificate pour remplacer le certificat auto-signé ArcGIS Data Store utilisé pour la communication avec le serveur Web.
./updatesslcertificate.sh /usr/files/mysignedcert.pfx "ps4mycert" "mycacert"
upgradedatasource
Cet utilitaire est utilisé avec des data stores de Big Data spatio-temporelles.
En raison d’un bug dans la version 10.8.1, ArcGIS GeoEvent Server les services de carte utilisant l’agrégation de carré ou d’hexagone ne sont pas affichés après la mise à niveau vers la version 10.9 ou ultérieure. Pour corriger cela, exécutez l’utilitaire upgradedatasource pour mettre à jour les index associés aux données source pour ces services de carte GeoEvent Server.
Pendant la mise à jour des index, personne ne peut accéder au service de carte.
L’utilitaire upgradedatasource peut s’exécuter sur n’importe quelle machine dans le data store de Big Data spatio-temporel.
Syntaxe
upgradedatasource [<service name>]
Exemples
Dans cet exemple, toutes les sources de service de carte GeoEvent Server sont mises à niveau :
./upgradedatasource
Dans cet exemple, l’utilitaire upgradedatasource va mettre à jour les index utilisés par la reconnaissance de service de carte GeoEvent Server. Le nom du service a été déterminé à l’aide de l’utilitaire listdatasources.
./upgradedatasource recon
Vous avez un commentaire à formuler concernant cette rubrique ?