Skip to main content

restoredatastore

Cet utilitaire est utilisé pour tous les types ArcGIS 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 relational data store et devez 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 relational data store existant.

Remarque :

Le relational data store doit être configuré pour prendre en charge la récupération ponctuelle. Vous pouvez restaurer un état précédent du relational data store 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.

L’utilitaire restoredatastore doit être exécuté sur la machine principale du relational data store. L’utilitaire peut être exécuté sur l’une des machines de spatiotemporal Big Data store, 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, spatiotemporal, graph ou 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 relational data stores.

Lors de la restauration après un blocage ou lors d’un transfert du relational data store, spécifiez --target most-recent. Si vous restaurez un relational data store à point précis dans le temps (ce qui nécessite que le relational data store soit configuré pour autoriser la récupération ponctuelle), indiquez la date et l’heure (UTC) auxquelles vous devez 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’agit du chemin d’accès à un emplacement de partage de fichiers, à un nom d’emplacement de sauvegarde ou à un emplacement de sauvegarde Amazon S3 ou Azure Blob Storage.

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 le relational data store.

Par défaut, l’utilitaire suppose que vous restaurez le relational data store 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 relational data store 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 data store 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 data store 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 sur lequel 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’option --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. Fournissez 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 le spatiotemporal Big Data store, le graph store et l’object store.

Les valeurs valides sont true et false.

Définissez cette option sur false si vous devez restaurer le data store 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 data store, d’ajouter des machines au data store pour accueillir 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.

--mode

Les valeurs valides sont singleInstance et cluster.

Lorsque vous restaurez un graph store ou un object store sur une nouvelle machine, vous pouvez spécifier cluster pour faire passer le data store du mode Une seule instance au mode Cluster ou spécifier singleInstance pour faire passer le data store du mode Cluster au mode Une seule instance.

--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. Par défaut, le data store est de type relational et il reste lié au site GIS Server auprès duquel il est inscrit, vous n’êtes donc pas obligé de spécifier --store relational ou --bound true. Toutefois, vous devez spécifier l’URL GIS Server et les informations d’identification de l’administrateur.

./restoredatastore.sh --target most-recent --source-loc rdsbackups --server-url https://gisserver.example.com:6443 --server-admin siteadmin --server-password SAup.4s

restoredatastore --target most-recent --source-loc rdsbackups --server-url https://gisserver.example.com:6443 --server-admin siteadmin --server-password $Aup.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 relational data store sur lequel la récupération ponctuelle est activée est restauré à partir de l’emplacement de sauvegarde du relational data store 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.example.com:6443 --server-admin siteadmin --server-password SAup.4s

restoredatastore --target 2014-07-17-14:30:00 --source-loc \\sharedserver\entbackups\relds --server-url https://gisserver.example.com:6443 --server-admin siteadmin --server-password $Aup.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 relational data store 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 contenu 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 relational data store est inscrit, l’option --bound true n’est pas requise, mais l’URL 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.example.com:6443 --server-admin siteadmin --server-password SAup.4s

restoredatastore --target movedatastore --source-loc \\buserver\data\backups --data-dir C:\datastore --server-url https://gisserver.example.com:6443 --server-admin siteadmin --server-password $Aup.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, 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.example.com:6443 --server-admin siteadmin --server-password SAup.4s

restoredatastore --target bds1 --store spatiotemporal --source-loc name=awsloc --server-url https://gisserver.example.com:6443 --server-admin siteadmin --server-password $Aup.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.

Dans cet exemple, le graph store 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 contenu ArcGIS Data Store. Les couches de graphe de connaissances étant toujours exécutées sur le site GIS Server auprès duquel le graph store est inscrit, l’option --bound true n’est pas requise, mais l’URL GIS Server et les informations d’identification de l’administrateur le sont.

./restoredatastore.sh --store graph --source-loc /net/buserver/kgdata/backups --data-dir /usr/datastore --server-url https://gisserver.example.com:6443 --server-admin siteadmin --server-password SAup.4s

restoredatastore --store graph --source-loc \\buserver\kgdata\backups --data-dir C:\datastore --server-url https://gisserver.example.com:6443 --server-admin siteadmin --server-password $SAup.4s