Récupérer un ArcGIS Data Store

Si vous n’avez plus accès aux données d’un data store, par exemple si une machine ArcGIS Data Store se bloque ou si un éditeur supprime par erreur des données d’une couche d’entités hébergée, vous pouvez restaurer les données à l’aide des fichiers de sauvegarde.

Si une ou plusieurs machines du data store se bloquent et ne peuvent pas être récupérées, installez ArcGIS Data Store sur une nouvelle machine et restaurez la dernière sauvegarde complète disponible dans la nouvelle machine à l’aide de l’utilitaire restoredatastore.

Remarque :

Pour savoir quels fichiers de sauvegarde vous pouvez utiliser lors de la restauration, exécutez l’utilitaire listbackups.

La procédure dépend alors du type de data store, ainsi que du nombre ou du type de machines que vous remplacez. Voici quelques exemples de ces différences :

• Si vous remplacez toutes les machines d’un cache de tuiles (agrégat) ou d’un Spatiotemporal Big Data Store ou object store, vous exécutez l’utilitaire restoredatastore deux fois pour prendre en compte toutes les données.
• Si le data store relationnel est configuré pour la récupération ponctuelle, vous pouvez récupérer les données de couches d’entités hébergées à un moment précis dans le temps en procédant à la restauration sur le data store relationnel existant et en indiquant une date et une heure de restauration.
• Après avoir remplacé une machine dans un agrégat de data store de cache tuilé et restauré les données dans la nouvelle machine, vous redistribuez les données du cache de scène.

Informations importantes relatives à la restauration des répertoires de données

Gardez à l’esprit les informations suivantes en rapport avec la récupération ArcGIS Data Store :

• Vous devez vous assurer que les procédures de sauvegarde et de restauration fonctionnent en les testant sur des déploiements de développement ou de test. En effet, vous ne voulez pas découvrir un défaut dans un processus au moment où vous devez restaurer un déploiement de production.
• Les fichiers de sauvegarde utilisés pour la récupération sont compressés. Lorsque vous restaurez les données, ces fichiers doivent être décompressés dans un dossier intermédiaire. Cela signifie que vous devez disposer d’un dossier intermédiaire pouvant accommoder ces données. Par défaut, les fichiers sont mis en attente dans le répertoire de données ArcGIS Data Store. Si le data store relationnel ou de cache tuilé contient beaucoup de données, vous pouvez configurer un dossier intermédiaire distinct et le désigner afin de mettre en attente les fichiers pour la récupération du data store. Spécifiez le dossier intermédiaire distinct à l’aide de l’utilitaire changestaginglocation.
• Avant d’exécuter l’utilitaire restoredatastore, vérifiez que personne ne publie ou ne met à jour des couches. Ces nouveaux services et mises à jour seraient perdus puisqu’ils ne seraient pas inclus dans le fichier de sauvegarde que vous restaurez.
• Les clients et les services ne peuvent pas accéder aux données existantes dans le répertoire de données pendant que vous le restaurez.
• Lorsque vous déployez ArcGIS Enterprise sur site, mais que les fichiers de sauvegarde du data store se trouvent dans un stockage Cloud, la création de sauvegardes et la restauration à partir de celles-ci dureront plus longtemps que si les fichiers de sauvegarde se trouvaient dans des partages de fichiers locaux.

Restaurer un data store relationnel, un graph store ou un data store de cache tuilé (mode principal-secours) après un incident

Si le matériel cesse de fonctionner ou que le data store n’est ni disponible, ni accessible en ligne pour un data store relationnel à une seule machine, un data store de cache tuilé (s’exécutant en mode principal-secours) ou un graph store, installez ArcGIS Data Store sur une nouvelle machine et appliquez vos fichiers de sauvegarde à la nouvelle installation l’aide de l’utilitaire restoredatastore. Vous recréez ainsi le data store sur la nouvelle machine et maintenez son inscription auprès du site GIS Server existant.

Conseil :

Si la machine principale dans un déploiement principal-secours d’un data store relationnel, d’un graph store ou d’un data store de cache tuilé échoue, la machine de secours devient la machine principale. Supprimez la machine défaillante du déploiement. Vous pouvez ensuite installer ArcGIS Data Store sur une nouvelle machine et la configurer comme machine de secours. Il n’est pas nécessaire de restaurer les données à partir d’un fichier de sauvegarde, car les données sont répliquées de la machine principale vers la machine de secours. De même, si une machine de secours connaît une défaillance et ne peut pas être récupérée, il n’est pas nécessaire de restaurer les données. Supprimez la machine de secours du déploiement, installez ArcGIS Data Store sur une nouvelle machine et configurez-la comme machine de secours.

1. Installez ArcGIS Data Store sur une nouvelle machine.

   Ne procédez pas à la configuration. Fermez l’assistant de configuration ArcGIS Data Store lorsqu’il s’ouvre au terme de l’installation.

2. Ouvrez une commande shell.
3. Exécutez l’utilitaire restoredatastore depuis <ArcGIS Data Store installation directory>\datastore\tools pour restaurer la sauvegarde la plus récente du data store relationnel, du graph store ou du data store de cache tuilé.

   Reportez-vous à la référence des utilitaires ou saisissez --help sur la ligne de commande pour obtenir la syntaxe.

   Cet exemple restaure la sauvegarde la plus récente d’un data store relationnel à partir de /net/fortknox/backups/datastore/relational dans /usr/arcgisdatastore. Comme le data store reste par défaut lié au site GIS Server auprès duquel il est inscrit, vous n’êtes pas obligé de spécifier --bound true, mais vous devez indiquer l’URL du site GIS Server et les identifiants de connexion de l’administrateur.

   ./restoredatastore --store relational --target most-recent --source-loc /net/fortknox/backups/datastore/relational --data-dir /usr/arcgisdatastore --server-url https://gisserver.domain.com:6443 --server-admin siteadmin --server-password MySApw

   Si le répertoire que vous spécifiez avec l’option --data-dir n’existe pas déjà, il sera créé. S’il existe, vous devez disposer d’un accès en écriture sur ce dernier et il doit être vide. Dans le cas contraire, l’opération de restauration ne pourra pas aboutir.

4. Confirmez que vous souhaitez restaurer le stockage des données en saisissant yes.

Restaurer un stockage des données relationnelles existant à un moment donné

Si le data store relationnel est configuré pour prendre en charge la récupération ponctuelle, vous pouvez utiliser les fichiers de sauvegarde pour restaurer le data store relationnel à un moment donné que vous spécifiez. Par exemple, si un éditeur apporte des modifications importantes aux données dans une couche d’entités hébergée et découvre le jour d’après que ces modifications n’avaient pas lieu d’être, vous pouvez restaurer l’état antérieur à ces modifications du stockage des données relationnelles.

Les heures spécifiées doivent être exprimées en UTC (Temps Universel Coordonné).

Remarque :

Toutes les couches d’entités publiées sur le portail après un moment donné auquel vous restaurez le stockage des données relationnelles ne seront plus valides, car les données utilisées par ces couches n’existent plus dans le stockage des données.

Notez également que si vous avez désactivé les sauvegardes automatiques, vous ne pouvez pas effectuer de restauration à un moment spécifique.

1. Ouvrez une commande shell.
2. Exécutez l’utilitaire restoredatastore depuis <ArcGIS Data Store installation directory>\datastore\tools pour restaurer les données à un moment spécifique.

   La syntaxe permettant de restaurer le stockage des données relationnelles à un moment donné est la suivante :

   restoredatastore --store relational --target <date and time> --server-url <ArcGIS Server URL> --server-admin <ArcGIS Server admin user> --server-password <ArcGIS Server admin password>

   Saisissez, par exemple, les informations suivantes pour restaurer le data store à partir de fichiers à l’état qu’il présentait à 17 h 00 UTC le 20 mars 2014.

   ./restoredatastore --store relational --target 2014-03-20-17:00:00 --server-url https://gisserver.domain.com:6443 --server-admin siteadmin --server-password MySApw
   
   You are going 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

3. Confirmez que vous souhaitez restaurer le stockage des données en saisissant yes.

   Conseil :

   Pour rédiger un script de création de l’utilitaire restoredatastore, incluez un indicateur pour supprimer l’invite de confirmation, comme dans l’exemple suivant :

   restoredatastore --store relational --target 2014-03-20-17:00:00 --prompt no

   Vos données de couches d’entités hébergées sont restaurées au moment spécifié.

Restaurer un répertoire de données du cache de tuiles agrégé pour redistribuer les données du cache de scène après un blocage

Si une machine dans un data store de cache tuilé s’exécutant en mode d’agrégat connaît un blocage et que vous ne parvenez pas à la ramener en ligne, remplacez la machine perdue et restaurez le data store de cache tuilé sur la nouvelle machine. Lors de la restauration des données, ArcGIS Data Store redistribue des copies des données du cache de scène à toutes les machines du data store, y compris à la nouvelle machine.

Suivez les instructions ci-après pour détecter et remplacer une machine défaillante du répertoire de données du cache de tuiles et procéder à une restauration pour redistribuer les données du cache de scène dans le cadre de la haute disponibilité :

1. Si vous pensez qu’un problème s’est produit sur l’une des machines du data store de cache tuilé, exécutez l’utilitaire describedatastore pour vérifier qu’une machine est inaccessible.
2. Si le résultat indique la présence d’un problème sur une machine, essayez de récupérer la machine.

   Par exemple, si un câble réseau ou d’alimentation est débranché, rebranchez-le et démarrez la machine.

3. Si vous parvenez à récupérer la machine, ramenez-la en ligne et exécutez à nouveau l’utilitaire describedatastorepour vérifier que la machine est à nouveau accessible en ligne et qu’elle participe au data store de cache tuilé.

   Effectuez certains tests sur les couches de scènes pour vérifier qu’elles sont accessibles. En l’absence d’erreurs, vous avez terminé. Cependant, si vous ne parvenez pas à récupérer la machine, passez à l’étape suivante.

4. Exécutez l’utilitaire removemachine avec l’option --force pour retirer la machine défaillante du data store de cache tuilé.

   Dans cet exemple, la machine tilecache3 est inaccessible et ne peut pas être récupérée. ArcGIS Data Store ne pouvant pas accéder à la machine, vous devez spécifier --force true pour la retirer du data store de cache tuilé.

   ./removemachine tilecache3 --store tilecache --force true

5. Obtenez une nouvelle machine dotée du même système d’exploitation que l’ancienne machine. Installez ArcGIS Data Store sur la nouvelle machine et ajoutez-la au data store de cache tuilé existant en la configurant avec le même site ArcGIS Server d’hébergement.
6. Exécutez la commande REST validate de ArcGIS Server pour vérifier que les données de cache de scène existantes sont hautement disponibles.

   Si vous recevez un message indiquant qu’il n’existe qu’une seule copie d’un ou de plusieurs caches de couches de scènes, passez aux étapes suivantes.

7. Vérifiez que vous avez configuré un emplacement de sauvegarde partagé pour le répertoire de données du cache de tuiles. Si tel n’est pas le cas, configurez-en un maintenant.
8. Assurez-vous que personne n’effectue de publication ou de mise à jour sur une couche de scènes, ou ne crée de caches de scène.

   Pour savoir si un cache de scène est en cours de création ou de recréation, connectez-vous à l’instance ArcGIS Server Manager du serveur d’hébergement, ouvrez Site > Jobs (Tâches), sélectionnez System/SceneCachingControllers dans la liste déroulante Services et cliquez sur Query (Requête). Si le serveur est en train de créer des caches de serveur, le statut de la tâche apparaît à l’issue de cette requête. Patientez jusqu’à ce que ces tâches liées au cache se terminent. Si aucune tâche liée au cache de scène n’apparaît, vous pouvez continuer.

   Pour vous assurer que personne ne publie de nouvelles couches ou des mises à jour, vous pouvez mettre ArcGIS Enterprise en mode de lecture seule. Gardez cependant à l’esprit que cela affecte tous les utilisateurs du portail.

9. Créez une sauvegarde du répertoire de données du cache de tuiles.

   Dans cet exemple, un fichier de sauvegarde nommé myscenecachebu est créé et stocké dans un emplacement de sauvegarde dans un paquet Amazon Simple Storage Service (S3) que vous avez inscrit en tant qu’emplacement de sauvegarde du data store de cache tuilé.

   ./backupdatastore myscenecachebu --store tilecache --location type=s3;location=mys3bucket

10. Employez l’utilitaire restoredatastore avec l’option replicatedata définie sur true pour remplacer le contenu du data store de cache tuilé et rééquilibrer le contenu entre toutes les machines.

    Dans l’exemple suivant, le fichier myscenecachebu est utilisé pour restaurer le data store de cache tuilé et l’option replicatedata est définie sur true pour indiquer à ArcGIS Data Store que deux copies de chaque cache de scène doivent être distribuées à toutes les machines du data store de cache tuilé.

    ./restoredatastore.sh --store tilecache --target myscenecachebu --serverurl https://gisserver.domain.com:6443 --server-admin myadmin --server-password myAdminPWd! --replicatedata true

11. Si vous avez placé ArcGIS Enterprise en mode de lecture seule, appliquez à nouveau le mode de lecture-écriture.
12. Exécutez à nouveau la commande validate pour vérifier qu’il existe deux copies de tous les caches de scène.

Restaurer un data store après la perte de toutes les machines

Si vous devez remplacer toutes les machines dans un data store de cache tuilé, un Spatiotemporal Big Data Store ou un object store (par exemple, en cas de destruction de votre centre de données en raison d’une inondation, ou si vous devez revenir à une ancienne version de ArcGIS Enterprise), procédez comme suit pour restaurer le data store :

1. Installez ArcGIS Data Store sur une nouvelle machine.

   Ne procédez pas à la configuration. Fermez l’assistant de configuration ArcGIS Data Store lorsqu’il s’ouvre au terme de l’installation.

2. Ouvrez une commande shell.
3. Exécutez l’utilitaire restoredatastore depuis <ArcGIS Data Store installation directory>\datastore\tools et définissez l’opération --loaddata sur false pour préparer la première machine à la restauration du Spatiotemporal Big Data Store.

   Reportez-vous à la référence des utilitaires ou saisissez --help sur la ligne de commande pour obtenir la syntaxe.

   Cet exemple prépare la nouvelle machine à la restauration de la sauvegarde la plus récente d’un data store de Big Data spatio-temporelles à partir de /net/myserver/backups/spatiotemporal dans /usr/arcgisdatastore. L’opération --loaddata étant définie sur false, les données ne sont pas encore chargées.

   ./restoredatastore --store spatiotemporal --target most-recent --source-loc /net/myserver/backups/spatiotemporal --data-dir /usr/arcgisdatastore --loaddata false --server-url https://gisserver.domain.com:6443 --server-admin siteadmin --server-password MySApw

   Si le répertoire que vous spécifiez avec l’option --data-dir n’existe pas, le data store le crée. S’il existe, vous devez disposer d’un accès en écriture sur ce dernier et il doit être vide. Dans le cas contraire, l’opération de restauration ne peut pas aboutir.

   Pour charger les données pour un data store de cache tuilé, vous devez spécifier --store tilecache et l’emplacement de sauvegarde du cache tuilé via l’opération --source-loc dans l’exemple précédent.

4. Installez ArcGIS Data Store sur des machines supplémentaires et exécutez l’assistant de configuration ArcGIS Data Store ou l’utilitaire configuredatastore sur chacune d’elles pour ajouter des machines à votre serveur d’hébergement.
5. Exécutez de nouveau l’utilitaire restoredatastore sans l’option --loaddata ou avec --loaddata défini sur true pour restaurer toutes les données.

   Les données seront distribuées sur toutes les machines du répertoire de données du cache de tuile ou de Big Data spatio-temporelles.

   Cet exemple restaure les données dans le data store de Big Data spatio-temporelles récemment configuré à l’aide du même fichier de sauvegarde (sur /net/myserver/backups/spatiotemporal). L’option --loaddata étant définie sur true par défaut, il n’est pas nécessaire de la spécifier lorsque vous chargez les données.

   ./restoredatastore --store spatiotemporal --target most-recent --source-loc /net/myserver/backups/spatiotemporal --data-dir /usr/arcgisdatastore --server-url https://gisserver.domain.com:6443 --server-admin siteadmin --server-password MySApw

Restaurer un Spatiotemporal Big Data Store ou un object store lorsque la machine cible peut contenir toutes les données du fichier de sauvegarde

Si la première machine sur laquelle vous créez votre Spatiotemporal Big Data Store de remplacement ou object store (mode d’agrégat) contient suffisamment d’espace disque et de mémoire pour contenir toutes les données de votre fichier de sauvegarde ou si vous effectuez la restauration sur vos machines de data store existantes, il vous suffit d’exécuter l’utilitaire restoredatastore une seule fois. Une fois la restauration réalisée, vous pouvez ajouter les autres nouvelles machines à votre Spatiotemporal Big Data Store ou object store. ArcGIS Data Store répliquera les données sur les autres machines.

1. Installez ArcGIS Data Store sur une nouvelle machine.

   Ne procédez pas à la configuration. Fermez l’assistant de configuration ArcGIS Data Store lorsqu’il s’ouvre au terme de l’installation.

2. Ouvrez une commande shell.
3. Exécutez l’utilitaire restoredatastore depuis <ArcGIS Data Store installation directory>\datastore\tools et incluez l’opération --loaddata définie sur true.

   Reportez-vous à la référence des utilitaires ou saisissez --help sur la ligne de commande pour obtenir la syntaxe.

   Cet exemple prépare la nouvelle machine à la restauration de la sauvegarde la plus récente d’un data store de Big Data spatio-temporelles à partir de /net/myserver/backups/spatiotemporal dans /usr/arcgisdatastore. L’opération --loaddata est définie sur true car cette nouvelle machine peut contenir toutes les données du fichier de sauvegarde.

   ./restoredatastore --store spatiotemporal --target most-recent --source-loc /net/myserver/backups/spatiotemporal --data-dir /usr/arcgisdatastore --loaddata true --server-url https://gisserver.domain.com:6443 --server-admin siteadmin --server-password MySApw

   Si le répertoire que vous spécifiez avec l’option --data-dir n’existe pas, le data store le crée. S’il existe, vous devez disposer d’un accès en écriture sur ce dernier et il doit être vide. Dans le cas contraire, l’opération de restauration ne peut pas aboutir.

   Notez que vous pouvez omettre l’opération --loaddata dans ce cas, car les données sont chargées par défaut.

   Si la machine ne peut pas accueillir toutes les données du fichier de sauvegarde, l’opération de restauration échoue.

4. Installez ArcGIS Data Store sur des machines supplémentaires et exécutez l’assistant de configuration ArcGIS Data Store ou l’utilitaire configuredatastore sur chacune d’elles pour ajouter des machines Spatiotemporal Big Data Store dans le serveur d’hébergement.

   ArcGIS Data Store distribue et réplique les données sur les autres machines.

Restaurer un stockage des données du cache de tuiles ou relationnelles sur un autre système d’exploitation

Vous pouvez utiliser vos fichiers de sauvegarde pour restaurer un data store de cache tuilé ou relationnel sur une machine exécutant un système d’exploitation (SE) différent.

Par exemple, si le data store de cache tuilé s’exécute sur un serveur Microsoft Windows, mais que votre service informatique commence à utiliser des serveurs Linux, vous pouvez utiliser les fichiers de sauvegarde créés avec une installation ArcGIS Data Store sur le serveur Windows pour effectuer la restauration sur un data store de cache tuilé sur le serveur Linux.

1. Installez ArcGIS Data Store sur le nouveau serveur.

   Ne procédez pas à la configuration.

2. Si vous ne possédez pas encore de sauvegarde complète du data store de cache tuilé ou relationnel existant, faites appel à l’utilitaire backupdatastore pour en créer une.
3. Placez le fichier de sauvegarde dans un emplacement partagé accessible par la nouvelle installation ArcGIS Data Store.
4. Exécutez l’utilitaire restoredatastore pour effectuer la restauration sur la nouvelle machine. Utilisez l’opération --server-url pour spécifier l’URL du serveur d’hébergement existant du portail (un site GIS Server) lors de la restauration pour que les couches de scènes et d’entités hébergées existantes continuent à fonctionner.

   Dans cet exemple, un data store de cache tuilé est restauré et inscrit auprès du site GIS Server https://mygisserver.domain.com:6443. Le fichier de sauvegarde se trouve dans le répertoire partagé /net/backups/tilecache et le répertoire ArcGIS Data Store sur la nouvelle machine est /arcgis/datastore.

   ./restoredatastore.sh --store tileCache --source-loc /net/backups/tilecache --data-dir /arcgis/datastore --server-url https://gisserver.domain.com:6443 --server-admin siteadmin --server-password MySApw