恢复 ArcGIS Enterprise
如果部分 ArcGIS Enterprise 组织失败,您可使用 Web GIS 灾难恢复 (WebGISDR) 工具和先前导出的备份文件将其恢复。 在恢复 ArcGIS Enterprise 时需要注意以下事项:
自上次导出以来创建的所有项目和服务都将丢失。
使用 WebGISDR 工具创建的备份不包括地图和切片服务缓存、web 服务的参考数据源以及时空大数据存储备份文件。 当使用 WebGISDR 工具从备份中恢复后,必须单独恢复这些内容。
您要恢复到的 ArcGIS Enterprise 组织的版本必须与您创建备份时的版本相同。 或者,您必须恢复至相同类型的操作系统。 例如,您无法在 Linux 上创建组织的备份并将其恢复至 Microsoft Windows 计算机。
当恢复高可用性 ArcGIS Enterprise 组织时,WebGISDR 工具会保持所有组件的高可用性设置。
如果您已创建 ArcGIS Enterprise 组织的增量备份,则必须具备最新的增量备份以及在该增量备份之前创建的最新完整备份,才能恢复您的组织。
运行 WebGISDR 工具的域账户必须至少具有对
BACKUP_LOCATION的读取权限以及对SHARED_LOCATION的写入权限(如果适用)。如果指定共享位置,运行 ArcGIS Server、Portal for ArcGIS 和 ArcGIS Data Store 的域账户必须具有对目录的读取权限。
建议您在恢复之前查看恢复组织的最佳做法。
恢复
ArcGIS Server 恢复过程支持现有 ArcGIS Data Store 项目的主机名,这意味着数据将恢复到当前在目标环境中的托管服务器上注册的实例。 所有其他数据存储项目(例如数据库和文件夹)都将恢复为源环境中的状态。 确保数据存储项目的路径在目标环境中可访问:
数据库数据存储项目 - 根据提供商的不同,有多种方法可以确保关系数据库的实例或主机名得到解析 - 例如 CNAME 别名、
tnsnames.ora文件或\etc\hosts条目。 有关详细信息,请参阅您的数据库提供商或数据库管理员。文件夹数据存储项目 - 可以使用符号链接或根据已发布服务所使用的路径根据需要将路径安装到驱动器来解析网络或本地路径中的数据。
恢复组织
按照以下步骤将您的 ArcGIS Enterprise 组织恢复到创建备份文件时所在的计算机上:
注:
您的组织也可以恢复到使用相同 ArcGIS Web Adaptor 或负载均衡器 URL 的备用 ArcGIS Enterprise 中的计算机以及与主要组织具有相同服务 URL 的 ArcGIS Server 站点。
如果您需要更改为 ArcGIS Enterprise 导出创建的属性文件,请为导入操作复制该文件并更新所需的属性。 如果不需要更改任何设置,则可以在以下步骤中引用您为导出操作创建的属性文件。
您可能想要提供不同的门户管理员凭据、更改备份文件位置或指定备份文件。 如果使用升级前创建的属性文件,确保所有加密值都已被替换为未加密的值,并且相应的布尔值设置为
false。默认情况下,WebGISDR 工具会恢复最新的备份。 对于基于文件系统的备份,最近备份可通过文件的上次修改时间戳确定。 对于基于云的备份,最近备份可通过备份文件夹中
webgis-config.json文件的创建时间确定。 要恢复最新备份之前的文件,您需要更新属性文件中的BACKUP_LOCATION路径。例如,要恢复
/usr/bus中的备份文件Sep-08-2025_17-10-44.webgissite,请设置BACKUP_LOCATION=/usr/bus/Sep-08-2025_17-10-44.webgissite。例如,要恢复
C:\temp中的备份文件Sep-08-2025_17-10-44.webgissite,请设置BACKUP_LOCATION=C:\temp\Sep-08-2025_17-10-44.webgissite。例如 WebGISDR 工具属性文件,请参阅以下示例属性文件部分。
在 Portal for ArcGIS 计算机上打开命令 shell,将目录更改为 WebGISDR 工具的位置,然后使用导入选项运行该工具。 有关详细信息,请参阅运行时参数。
WebGISDR 工具的默认位置为
<Portal for ArcGIS installation directory>/tools/webgisdr。在以下示例中,属性文件 (
toimport.properties) 保存在用户创建的目录/home/ags/arcgis/portal/propfiles下。webgisdr --import --file /home/ags/arcgis/portal/propfiles/toimport.properties请注意,属性文件不必位于创建此文件时所保存的目录中。 如果此文件发生移动,请使用
--file参数指定新的目录位置。在 Portal for ArcGIS 计算机上打开命令窗口,将目录更改为 WebGISDR 工具的位置,然后使用导入选项运行该工具。 有关详细信息,请参阅运行时参数。
WebGISDR 工具的默认位置为
C:\Program Files\ArcGIS\Portal\tools\webgisdr。在以下示例中,属性文件 (
toimport.properties) 保存在用户创建的文件夹C:\propfiles中。webgisdr --import --file C:\propfiles\toimport.properties请注意,属性文件不必位于创建此文件时所保存的文件夹中。 如果此文件发生移动,请使用
--file参数指定新的文件夹位置。注:
如果工具在运行时似乎停止,请确保命令提示符不在 QuickEdit 模式下。 有关详细信息,请参阅常见问题及解决方案。
如果您的组织包括地图服务或托管切片图层缓存,则手动移动您创建的备份副本,并将文件放到原始
arcgiscache目录下。如果您的组织包括时空大数据存储,请使用 ArcGIS Data Store restoredatastore 工具恢复其备份。
如果您的基于文件的数据存储在与某一 ArcGIS Enterprise 组件相同的计算机上,且该计算机发生故障,则将备份副本恢复至新计算机上的同一路径。
例如,如果您在 ArcGIS GIS 服务器站点的其中一台计算机上建有一个包含文件地理数据库和 shapefile 的文件夹,且该计算机发生故障,则将此文件夹的备份副本放到新计算机上的同一目录路径下。 这样做很有必要,因为您向 ArcGIS Server 站点注册了文件位置。 如果数据位置更改,服务将无法找到数据。
如果您的组织包括 ArcGIS Mission Server 站点,请按照 ArcGIS Mission Server 文档中的说明恢复站点。
如果您的组织包括 ArcGIS GeoEvent Server,请将配置导入到联合站点。
示例属性文件
查看恢复 ArcGIS Enterprise 组织时使用的以下示例 WebGISDR 工具属性文件:
在此示例中,WebGISDR 工具将连接到门户 URL
https://portalhostname.example.com:7443/arcgis并恢复存储在/net/backupserver/drbackups中的最新备份。 WebGISDR 工具会将组件备份提取到/net/backupserver/tempbackups并使用相应的备份恢复 ArcGIS Data Store、所有联合服务器、托管服务器以及门户。 请确保所有组件至少具备由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在此示例中,WebGISDR 工具将连接到门户 URL
https://portalhostname.example.com:7443/arcgis并恢复存储在\\mybuserver\wgbackups\entbackup中的最新备份。 WebGISDR 工具会将组件备份提取到\myserver\tempbackups并使用相应的备份恢复 ArcGIS Data Store、所有联合服务器、托管服务器以及门户。 请确保所有组件至少具备由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在此示例中,WebGISDR 工具将连接到门户 URL
https://portalonaws.example.com:7443/arcgis并从entbackups存储段恢复由S3_BACKUP_NAME属性指定的fullbackup06June备份。 以下组件将使用各自的备份依次恢复:ArcGIS Data Store、所有联合服务器和托管服务器以及门户。 WebGISDR 工具将使用IAMRole(通过其正在运行的实例进行了配置)来下载备份,但也可以将其配置为使用访问密钥。 请确保所有组件至少具备由SHARED_LOCATION属性指定的路径的读取权限。 门户内容将从contentbackups存储段中恢复。 如果备份存储段与目标门户位于不同的区域,请确保未配置 VPC 端点,以免阻止门户发出出站请求以恢复内容。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
在此示例中,WebGISDR 工具将连接到门户 URL
https://portalonazure.example.com:7443/arcgis,并从entbackups存储账户中的drbackups容器恢复最新备份。 以下组件将使用各自的备份依次恢复:ArcGIS Data Store、所有联合服务器和托管服务器以及门户。 请确保所有组件至少具备由SHARED_LOCATION属性指定的路径的读取权限。 门户内容将根据entbackups存储账户的contentbackups容器中的内容进行恢复。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