Restaurer ArcGIS Enterprise

En cas de défaillance d’une partie de l’organisation ArcGIS Enterprise, vous pouvez la restaurer à l’aide de l’outil WebGISDR et d’un fichier de sauvegarde exporté précédemment. Vous devez tenir compte des éléments suivants lorsque vous restaurez ArcGIS Enterprise :

Tout élément ou service créé depuis la dernière exportation est perdu.
Les caches de cartes et de services de tuiles, les sources de données référencées pour les services Web et les fichiers de sauvegarde de stockage de Big Data spatio-temporelles ne sont pas compris dans la sauvegarde que vous avez créée avec l’outil WebGISDR. Une fois que vous avez utilisé l’outil WebGISDR pour une restauration à partir de votre sauvegarde, ces éléments doivent être restaurés séparément.
La version de l’organisation ArcGIS Enterprise vers laquelle vous effectuez la restauration doit être identique à celle utilisée pour créer la sauvegarde. De plus, vous devez restaurer le même type de système d’exploitation. Par exemple, vous ne pouvez pas créer la sauvegarde d’une organisation sur Linux et la restaurer sur des ordinateurs Microsoft Windows.
Lorsque vous restaurez une organisation ArcGIS Enterprise haute disponibilité, l’outil WebGISDR conserve les paramètres de haute disponibilité pour tous les composants.
Si vous avez créé des sauvegardes incrémentielles de votre organisation ArcGIS Enterprise, vous devez posséder la dernière sauvegarde incrémentielle et la dernière sauvegarde complète créée avant cette sauvegarde incrémentielle pour restaurer votre organisation.
Le compte de domaine qui exécute l’outil WebGISDR doit disposer au moins de l’accès en lecture sur BACKUP_LOCATION et, s’il y a lieu, de l’accès en écriture sur SHARED_LOCATION.
Si vous spécifiez un emplacement partagé, le compte de domaine qui exécute ArcGIS Server, Portal for ArcGIS et ArcGIS Data Store doit disposer d’un accès en lecture sur ce répertoire.

Avant d’effectuer la restauration, il est conseillé de prendre connaissance des bonnes pratiques pour restaurer une organisation.

Dépendances des données lors de la restauration

Le processus de restauration d’ArcGIS Server respecte les noms d’hôte des éléments ArcGIS Data Store existants, ce qui signifie que les données sont restaurées sur les instances actuellement inscrites auprès du serveur d’hébergement dans l’environnement cible. Tous les autres éléments de data store, comme les bases de données et les dossiers, sont restaurés tels qu’ils existaient dans l’environnement source. Vérifiez que les chemins d’accès aux éléments de data store sont accessibles dans l’environnement cible :

Éléments de data store de type base de données : en fonction du fournisseur, il existe différentes façons de s’assurer que l’instance ou le nom d’hôte d’une base de données relationnelle est résolu, comme les alias CNAME, les fichiers tnsnames.ora ou les entrées \etc\hosts. Pour plus d’informations, contactez votre fournisseur ou votre administrateur de base de données.
Éléments de data store de type dossier : les données locales ou d’un réseau peuvent être résolues à l’aide de liens symboliques ou par le montage des chemins d’accès aux lecteurs si nécessaire, en fonction des chemins utilisés par le service publié.

Restaurer une organisation

Pour restaurer l’organisation ArcGIS Enterprise sur les mêmes ordinateurs que ceux utilisés pour créer le fichier de sauvegarde, procédez comme suit :

Remarque :

L’organisation peut également être restaurée sur les machines d’une instance ArcGIS Enterprise de secours qui utilisent la même URL ArcGIS Web Adaptor ou d’équilibreur de charge et sur les sites ArcGIS Server qui ont la même URL de services que l’organisation principale.

Si vous devez modifier le fichier de propriétés que vous avez créé pour l’exportation ArcGIS Enterprise, créez une copie du fichier pour l’opération d’importation et mettez à jour les propriétés voulues. Le fichier de propriétés que vous avez créé pour l’opération d’exportation peut être référencé au cours des étapes qui suivent, si vous n’avez pas besoin de modifier des paramètres.

Vous pouvez avoir besoin d’indiquer des données d’identification d’administrateur de portail différentes, de modifier l’emplacement du fichier de sauvegarde ou de spécifier un fichier de sauvegarde. Si vous utilisez un fichier de propriétés créé avant une mise à niveau, assurez-vous que toutes les valeurs chiffrées ont été remplacées par leurs valeurs non chiffrées et que les valeurs booléennes correspondantes sont définies sur false.

Par défaut, l’outil WebGISDR restaure la sauvegarde la plus récente. Pour les sauvegardes basées sur le système de fichiers, la sauvegarde la plus récente est déterminée par l’horodatage de la dernière modification du fichier. Pour les sauvegardes basées sur le Cloud, la sauvegarde la plus récente est déterminée par l’âge du fichier webgis-config.json dans le dossier de sauvegarde. Pour restaurer un fichier plus ancien que le fichier de sauvegarde le plus récent, vous devez mettre à jour le chemin d’accès défini pour BACKUP_LOCATION dans le fichier de propriétés.

Par exemple, pour restaurer le fichier de sauvegarde Sep-08-2025_17-10-44.webgissite depuis /usr/bus, définissez BACKUP_LOCATION = /usr/bus/Sep-08-2025_17-10-44.webgissite.

Par exemple, pour restaurer le fichier de sauvegarde Sep-08-2025_17-10-44.webgissite depuis C:\temp, définissez BACKUP_LOCATION = C:\temp\Sep-08-2025_17-10-44.webgissite.

Pour voir des exemples de fichiers de propriétés de l’outil WebGISDR, reportez-vous à la section Exemples de fichiers de propriétés ci-dessous.
Ouvrez une invite de commande sur la machine Portal for ArcGIS, accédez à l’emplacement de l’outil WebGISDR et exécutez l’outil avec l’option d’importation. Pour plus d’informations, reportez-vous à la section Arguments de l’environnement d’exécution.

L’emplacement par défaut de l’outil WebGISDR est <Portal for ArcGIS installation directory>/tools/webgisdr.

Dans l’exemple suivant, le fichier de propriétés (toimport.properties) a été enregistré dans le répertoire créé par l’utilisateur /home/ags/arcgis/portal/propfiles.

webgisdr --import --file /home/ags/arcgis/portal/propfiles/toimport.properties

Notez que le fichier de propriétés ne doit pas nécessairement se trouver dans le répertoire dans lequel vous l’avez enregistré lors de sa création. Si vous le déplacez, spécifiez le nouvel emplacement du répertoire à l’aide du paramètre --file.
Ouvrez une fenêtre de commande sur la machine Portal for ArcGIS, accédez à l’emplacement de l’outil WebGISDR et exécutez l’outil avec l’option d’importation. Pour plus d’informations, reportez-vous à la section Arguments de l’environnement d’exécution.

L’emplacement par défaut de l’outil WebGISDR est C:\Program Files\ArcGIS\Portal\tools\webgisdr.

Dans l’exemple suivant, le fichier de propriétés (toimport.properties) a été enregistré dans le dossier créé par l’utilisateur C:\propfiles.

webgisdr --import --file C:\propfiles\toimport.properties

Notez que le fichier de propriétés ne doit pas nécessairement se trouver dans le dossier dans lequel vous l’avez enregistré lors de sa création. Si vous le déplacez, spécifiez le nouvel emplacement du dossier à l’aide du paramètre --file.

Remarque :

En cas de blocage de l’outil en cours d’exécution, assurez-vous que l’invite de commande n’est pas en mode QuickEdit. Reportez-vous à la rubrique Problèmes courants et solutions pour plus d’informations.
Si votre organisation contient des caches de couche de tuiles de service de carte ou hébergées, déplacez manuellement les copies de sauvegarde que vous avez effectuées et placez les fichiers dans le répertoire arcgiscache d’origine.
Si votre organisation contient un stockage de Big Data spatio-temporelles, utilisez l’outil restoredatastore d’ArcGIS Data Store pour en restaurer une sauvegarde.
Si vous aviez des données basées sur des fichiers stockées sur la même machine que l’un de vos composants ArcGIS Enterprise et que cette machine présentait une défaillance, restaurez vos copies de sauvegarde dans le même chemin sur la nouvelle machine.

Par exemple, si vous aviez un dossier contenant des géodatabases fichier et des shapefiles sur l’une des machines de votre site ArcGIS GIS Server et que cette machine présentait une défaillance, placez la copie de sauvegarde de ce dossier dans le même chemin de répertoire sur la nouvelle machine. Cette opération est nécessaire car vous avez inscrit l’emplacement du fichier auprès du site ArcGIS Server. Si l’emplacement des données change, les services ne pourront pas trouver les données.
Si votre organisation inclut un site ArcGIS Mission Server, restaurez-le en suivant les instructions de la documentation d’ArcGIS Mission Server.
Si votre organisation inclut ArcGIS GeoEvent Server, importez la configuration sur le site fédéré.

Exemples de fichiers de propriétés

Consultez les fichiers de propriétés de l’outil WebGISDR suivants utilisés lors de la restauration d’une organisation ArcGIS Enterprise :

Dans cet exemple, l’outil WebGISDR se connecte au portail à l’URLhttps://portalhostname.example.com:7443/arcgis et restaure la dernière sauvegarde stockée dans /net/backupserver/drbackups. L’outil WebGISDR extrait les sauvegardes de composant dans /net/backupserver/tempbackups et restaure ArcGIS Data Store, tous les serveurs fédérés, le serveur d’hébergement et le portail à l’aide de leurs sauvegardes respectives. Veillez à ce que tous les composants aient au moins un accès en lecture au chemin représenté par la propriété SHARED_LOCATION.
```
PORTAL_ADMIN_URL = https://portalhostname.example.com:7443/arcgis
PORTAL_ADMIN_USERNAME = admin
PORTAL_ADMIN_PASSWORD = Th3.Ad.Pass
PORTAL_ADMIN_PASSWORD_ENCRYPTED = false
BACKUP_RESTORE_MODE = backup
SHARED_LOCATION = /net/backupserver/tempbackups
INCLUDE_SCENE_TILE_CACHES = false
BACKUP_STORE_PROVIDER = FileSystem
BACKUP_LOCATION = /net/backupserver/drbackups
```
Dans cet exemple, l’outil WebGISDR se connecte au portail à l’URL https://portalhostname.example.com:7443/arcgis et restaure la dernière sauvegarde stockée dans \\mybuserver\wgbackups\entbackup. L’outil WebGISDR extrait les sauvegardes de composant dans \myserver\tempbackups et restaure ArcGIS Data Store, tous les serveurs fédérés, le serveur d’hébergement et le portail à l’aide de leurs sauvegardes respectives. Veillez à ce que tous les composants aient au moins un accès en lecture au chemin représenté par la propriété SHARED_LOCATION.
```
PORTAL_ADMIN_URL = https://portalhostname.example.com:7443/arcgis
PORTAL_ADMIN_USERNAME = admin
PORTAL_ADMIN_PASSWORD = Th3.Ad.Pass
PORTAL_ADMIN_PASSWORD_ENCRYPTED = false
BACKUP_RESTORE_MODE = backup
SHARED_LOCATION = \\\\myserver\\tempbackups
INCLUDE_SCENE_TILE_CACHES = false
BACKUP_STORE_PROVIDER = FileSystem
BACKUP_LOCATION = \\\\mybuserver\\wgbackups\\entbackup
```
Dans cet exemple, l’outil WebGISDR se connecte au portail à l’URL https://portalonaws.example.com:7443/arcgis et restaure la sauvegarde fullbackup06June définie par la propriété S3_BACKUP_NAME du compartiment entbackups. Les composants suivants sont restaurés dans l’ordre à partir de leur sauvegarde respective : ArcGIS Data Store, tous les serveurs fédérés, le serveur d’hébergement et le portail. L’outil WebGISDR utilise leIAMRole configuré avec l’instance sur laquelle il s’exécute pour télécharger la sauvegarde, mais il peut être configuré également pour utiliser des clés d’accès. Veillez à ce que tous les composants aient au moins un accès en lecture au chemin représenté par la propriété SHARED_LOCATION. Le contenu du portail est restauré à partir du compartiment contentbackups. Si le paquet de sauvegarde se trouve dans une autre région que celle du portail cible, assurez-vous qu’il n’existe aucun point de terminaison VPC configuré qui empêche le portail d’émettre des requêtes sortantes pour restaurer le contenu.
```
PORTAL_ADMIN_URL = https://portalonaws.example.com:7443/arcgis
PORTAL_ADMIN_USERNAME = entadmin
PORTAL_ADMIN_PASSWORD = p0rtl.a.p
PORTAL_ADMIN_PASSWORD_ENCRYPTED = false
BACKUP_RESTORE_MODE = backup
INCLUDE_SCENE_TILE_CACHES = true
BACKUP_STORE_PROVIDER = AmazonS3
S3_BUCKET = entbackups
S3_CREDENTIAL_TYPE = IAMRole
S3_REGION = eu-west-1
S3_BACKUP_NAME = fullbackup06June
PORTAL_BACKUP_S3_BUCKET = contentbackups
PORTAL_BACKUP_S3_REGION =eu-west-1
```

Dans cet exemple, l’outil WebGISDR se connecte au portail à l’URL https://portalonazure.example.com:7443/arcgis et restaure la dernière sauvegarde à partir du conteneur drbackups du compte de stockage entbackups. Les composants suivants sont restaurés dans l’ordre à partir de leur sauvegarde respective : ArcGIS Data Store, tous les serveurs fédérés, le serveur d’hébergement et le portail. Veillez à ce que tous les composants aient au moins un accès en lecture au chemin représenté par la propriété SHARED_LOCATION. Le contenu du portail est restauré à partir du contenu du conteneur contentbackups dans le compte de stockage entbackups.
```
PORTAL_ADMIN_URL = https://portalonazure.example.com:7443/arcgis
PORTAL_ADMIN_USERNAME = entadmin
PORTAL_ADMIN_PASSWORD = p0rtl.a.p
BACKUP_RESTORE_MODE = backup
BACKUP_STORE_PROVIDER = AzureBlob
AZURE_BLOB_ACCOUNT_NAME = entbackups
AZURE_BLOB_ACCOUNT_KEY = <key>
AZURE_BLOB_ACCOUNT_KEY_ENCRYPTED =false
AZURE_BLOB_ACCOUNT_ENDPOINT_SUFFIX = core.windows.net
AZURE_BLOB_CONTAINER_NAME = drbackups
PORTAL_BACKUP_BLOB_ACCOUNT_NAME = entbackups
PORTAL_BACKUP_BLOB_ACCOUNT_KEY = <key>
PORTAL_BACKUP_BLOB_ACCOUNT_KEY_ENCRYPTED = false
PORTAL_BACKUP_BLOB_ACCOUNT_ENDPOINT_SUFFIX = core.windows.net
PORTAL_BACKUP_BLOB_CONTAINER_NAME = contentbackups
```