Skip To Content

创建 ArcGIS Enterprise 备份

可将 ArcGIS Enterprise 部署组件导出为备份文件,将来发生硬件故障或数据丢失时,可使用备份文件来恢复部署。备份文件包含门户项和设置、托管 Web 图层、联合和托管服务器设置,以及托管要素图层数据和托管场景图层缓存(如使用 ArcGIS Data Store)。备份文件的大小以及创建备份文件所需的时间取决于以下方面:门户中项目的数量、拥有的托管 Web 图层的数量和类型、拥有的联合服务器的数量以及托管和联合服务器中 ArcGIS Server 计算机的数量。备份不含任何数据或服务的部署时,所生成的文件大小约为 400 MB。通常情况下,备份文件的大小将大于 380MB。

可使用 webgisdr 实用程序通过导出操作和属性文件来创建 ArcGIS Enterprise 备份。您可在 Portal for ArcGIS 工具目录中找到该实用程序。要使用此实用程序,必须满足下列条件:

  • 您指定的共享目录必须足以包含导出的文件。执行一次 ArcGIS Enterprise 部署测试导出以大概了解文件大小,确定共享目录中要保留的文件数量,然后相应估算目录的大小。
  • 用于安装 ArcGIS Enterprise 中每个软件组件的帐户必须拥有共享目录的读写权限。
  • 每个组件的备份放置在各组件的计算机上的临时目录中,然后移动至您指定的共享目录;因此,以下目录必须足够大才能包含各组件的备份:
    • Portal for ArcGIS: <Portal_content_directory>/temp
    • ArcGIS Server: /<ArcGIS_Server_installation_directory>/temp
    • ArcGIS Data Store: <ArcGIS_Data_Store_directory>/temp
  • ArcGIS Enterprise 部署中的 ArcGIS Data Store 关系数据存储必须启用时间点恢复。

按照如下步骤创建 ArcGIS Enterprise 部署的备份:

  1. 创建模板属性文件的副本。您可将副本保存到模板所在的目录或新目录下。

    模板属性文件—webgisdr.properties—默认安装在 /arcgis/portal/tools/webgisdr 下。

    在本示例中,文件副本命名为 mywebgis.properties 并保存在 /home/ags/arcgis/portal/propfiles 下。

  2. 打开属性文件副本并对其进行编辑,以包含站点的特定信息。

    • SHARED_LOCATION = <备份文件位置>

      指定要创建 ArcGIS ServerPortal for ArcGISArcGIS Data Store 备份文件临时副本的共享位置。已安装 ArcGIS ServerPortal for ArcGISArcGIS Data Store 的帐户和运行 webgisdr 实用程序的帐户必须具有此位置的读写权限。 确保该位置足以容纳备份文件。虽然经过压缩,但文件仍然相当大,具体取决于数据的数量和类型。如果有托管场景图层和缓存,并且 INCLUDE_SCENE_TILE_CACHES 设置为 true,则 ArcGIS Data Store 备份文件可能非常大。

      旧版本:

      Portal for ArcGIS 10.4 中,该属性为 SHARED_FOLDER

    • BACKUP_STORE_PROVIDER = {FileSystem | AmazonS3}

      此属性为 10.5.1 版本的新功能。如果要将您的 ArcGIS Enterprise 备份存入本地文件共享位置,请指定 FileSystem,然后 webgisdr 实用程序将把您的备份文件存入您指定用于 BACKUP_LOCATION 的文件共享中。

      如果您想将您的 ArcGIS Enterprise 备份存入 Amazon 简单存储服务 (S3) 存储段,请创建一个专为存储由 webgisdr 实用程序生成的备份文件的 S3 存储段,并使用访问您的存储段所需的信息更新 S3 属性

    • BACKUP_LOCATION = <备份文件本地位置>

      此属性为 10.5.1 版本的新功能。如果您设置 BACKUP_STORE_PROVIDER = FileSystem,那么备份文件会最先存储在 SHARED_LOCATION 中,但是随后会被复制到BACKUP_LOCATION。请确保该位置的内存足以容纳备份文件。虽然经过压缩,但文件仍然相当大,具体取决于数据的数量和类型。运行 webgisdr 实用程序的帐户必须拥有对 BACKUP_LOCATION 的读写权限。

    • PORTAL_ADMIN_URL = <portal admin directory URL>

      指定 Portal for ArcGIS 管理目录的 URL。使用格式 https://portalhostname.domain.com:7443/arcgis,其中 portalhostname.domain.com 为安装了 Portal for ArcGIS 的计算机的完全限定名称。

    • PORTAL_ADMIN_USERNAME = <portal administrator user name>

      指定分配给 Esri 定义的管理员角色的门户成员的用户名。

    • PORTAL_ADMIN_PASSWORD = <portal administrator password>

      指定门户管理员账户的密码。

    • PORTAL_ADMIN_PASSWORD_ENCRYPTED = <true | false>

      首次使用管理员密码填充文件时,请将该选项设置为 false。保存文件后密码将加密,可将 PORTAL_ADMIN_PASSWORD_ENCRYPTED 的值设置为 true 以表示该密码已加密。如果以后需要更改密码,可设置 PORTAL_ADMIN_PASSWORD_ENCRYPTED = false,提供新的管理员密码,然后保存文件。

    • INCLUDE_SCENE_TILE_CACHES = <true | false>

      如果要将托管场景图层发布至门户并在备份中包含场景缓存数据,可将 INCLUDE_SCENE_TILE_CACHES 设置为 true。请注意,如果设置为 true,备份中将包含所有场景缓存数据,而不仅仅是上次备份后创建的新缓存数据。如果已知上次备份后未创建新的场景缓存,或者不需要将场景发布至门户,可将 INCLUDE_SCENE_TILE_CACHES 设置为 false

    • BACKUP_RESTORE_MODE = <full | incremental>

      如果仅创建完整备份,可将此属性设置为 full。要减小备份的大小,可以创建两个不同的属性文件 - 一个具有 BACKUP_RESTORE_MODE = full,可偶尔用于创建完整备份,另一个具有 BACKUP_RESTORE_MODE = incremental,用于在完整备份的间隔生成增量备份。每个增量备份均包含自上一次完整备份后所发生的所有更改。

      如果未在属性文件中设置 BACKUP_RESTORE_MODE,将默认创建 full 备份。

    • 如果您的 ArcGIS Enterprise 部署在 AWS 上运行,且门户内容目录存储在 Amazon S3 中,则需要内容目录的备份存储段。在 S3 中创建一个备份存储段,然后在属性文件中将 PORTAL_BACKUP_S3_BUCKET 设置为存储段的名称并将 PORTAL_BACKUP_S3_REGION 设置为创建 S3 存储段的 AWS 区域。有关此类型实施的详细信息,请参阅 ArcGIS Enterprise 帮助中的使用 AWS 存储服务配置高可用性 ArcGIS Enterprise on Amazon Web Services

      旧版本:

      ArcGIS Enterprise 10.5.1 之前的版本中,PORTAL_BACKUP_S3_BUCKET 属性为 BACKUP_BUCKET_NAME

    • 从 10.5.1 ArcGIS Enterprise Cloud Builder for Microsoft Azure 开始,您可以将门户内容目录存储在 Azure Blob 存储容器中。要使用 webgisdr 实用程序创建此部署的备份,您必须设置以下属性(10.5.1 版本的新功能):
      • PORTAL_BACKUP_BLOB_ACCOUNT_NAME = <Azure 存储帐户>

        PORTAL_BACKUP_BLOB_ACCOUNT_NAME 设置为 Azure Blob 存储帐户名称。

        提示:

        当您在 Cloud Builder 的部署选项面板上选择使用 Azure 云存储进行配置和内容存储时,您指定了此存储帐户名称。

      • PORTAL_BACKUP_BLOB_ACCOUNT_KEY = <帐户密钥>

        PORTAL_BACKUP_BLOB_ACCOUNT_KEY 设置为与 Azure Blob 存储帐户相关联的帐户密钥。

      • PORTAL_BACKUP_BLOB_ACCOUNT_KEY_ENCRYPTED = false

        在首先添加 PORTAL_BACKUP_BLOB_ACCOUNT_KEY_ENCRYPTED 值时,将 false 设置为 PORTAL_BACKUP_BLOB_ACCOUNT_KEY。当您保存 webgisdr.properties 文件时,密钥将被加密,且该工具将 PORTAL_BACKUP_BLOB_ACCOUNT_KEY 设置为 true

      • PORTAL_BACKUP_BLOB_ACCOUNT_ENDPOINT = <Blob 存储帐户端点>

        指定 Blob 服务存储帐户端点

      • PORTAL_BACKUP_BLOB_ENDPOINT_URL = <Blob 服务 URL>

        指定 Blob 服务端点 URL。此 URL 格式为:https://<PORTAL_BACKUP_BLOB_ACCOUNT_NAME>.<PORTAL_BACKUP_BLOB_ACCOUNT_ENDPOINT>/<container name>

    • 如果您设置 BACKUP_STORE_PROVIDERAmazonS3,请提供有关如下属性的信息(10.5.1 版本的新功能):
      • S3_ACCESSKEY = <您的 AWS 帐户的访问密钥>

        如果您设置 S3_CREDENTIAL_TYPE = accessKeys,则您只需设置本项。该访问密钥所代表的 IAM 用户必须有您指定的具有 S3_BUCKET 属性的 S3 存储段的读写权限。

      • S3_SECRETKEY = <您的 AWS 帐户的保密密钥>

        为您的 AWS 帐户指定与访问密钥相关的保密密钥。仅当 S3_CREDENTIAL_TYPE 设置为 accessKeys 时,使用此项。

      • S3_ENCRYPTED = false

        将此设置保留为 false。当您运行 webgisdr 实用程序时,如果您将 S3_CREDENTIAL_TYPE 设置为 accessKeys,则实用程序将加密访问密钥和保密密钥,并设置 S3_ENCRYPTED 为加密访问密钥值。

      • S3_BUCKET = <S3 存储段名称>

        这是您想要存入 ArcGIS Enterprise 备份文件的 Amazon S3 存储段的名称。

      • S3_CREDENTIAL_TYPE= <IAMRole | accessKeys

        如果您要使用 AWS IAM 角色访问 S3_CREDENTIAL_TYPE,请将 IAMRole 设置为 S3_BUCKET。如果您要通过一个访问密钥使用 AWS IAM 用户访问 accessKeys,请将其设置为 S3_BUCKET。该 IAM 角色或用户必须有您指定的具有 S3_BUCKET 属性的 S3 存储段的读写权限。

      • S3_REGION = <AWS 区域,您创建 S3 存储段的位置>
      • S3_BACKUP_NAME = <备份文件名称>

        仅当您恢复 ArcGIS Enterprise 部署时,使用本属性。指定要恢复的备份文件的名称。如果您不指定备份文件的名称,则将恢复最新的备份文件。

    在本示例中,URL 为 https://portalhostname.domain.com:7443/arcgis 的门户的完整备份,及其托管与联合服务器的服务和设置,以及存储在 ArcGIS Data Store 关系数据存储中的托管要素图层数据最初将输出至 \\\\myserver\\tempbackups 上的文件。单独的文件将被压缩成单个备份文件 (entbackup)) 并复制到 \\mybuserver\\wgbackups。将不包含 ArcGIS Data Store 切片缓存数据存储的场景图层缓存,因为 INCLUDE_SCENE_TILE_CACHES 设置为 false

    BACKUP_STORE_PROVIDER = FileSystem
    SHARED_LOCATION = \\\\myserver\\tempbackups
    BACKUP_LOCATION = \\\\mybuserver\\wgbackups\\entbackup
    PORTAL_ADMIN_URL = https://portalhostname.domain.com:7443/arcgis
    PORTAL_ADMIN_USERNAME = admin
    PORTAL_ADMIN_PASSWORD = Th3.Ad.Pass
    PORTAL_ADMIN_PASSWORD_ENCRYPTED = false
    INCLUDE_SCENE_TILE_CACHES = false
    BACKUP_RESTORE_MODE = full

    在本示例中,URL 为 https://portalonaws.mydomain.com:7443/gis 的门户的完整备份,及其内容目录(储存在 S3 存储段 portalcontent),托管与联合服务器的服务和设置,以及储存在关系和切片缓存数据存储中的数据将被输出至 AWS 区域 eu-west-1 中的 S3 存储段 entbackups。备份文件名为 fullbackup06June。IAM 角色用于访问 AWS 帐户。

    BACKUP_STORE_PROVIDER = AmazonS3 SHARED_LOCATION = \\\\myserver\\tempbackups BACKUP_LOCATION = \\\\mybuserver\\wgbackups\\entbackupfile PORTAL_ADMIN_URL = https://portalhostname.mydomain.com:7443/arcgis PORTAL_ADMIN_USERNAME = entadmin PORTAL_ADMIN_PASSWORD = p0rtl.a.p PORTAL_ADMIN_PASSWORD_ENCRYPTED = false INCLUDE_SCENE_TILE_CACHES = true BACKUP_RESTORE_MODE = full PORTAL_BACKUP_S3_BUCKET = portalcontent S3_BUCKET = entbackups S3_CREDENTIAL_TYPE = IAMRole S3_REGION = eu-west-1
    S3_BACKUP_NAME = fullbackup06June

  3. 保存属性文件。

    使用该文件运行 webgisdr 实用程序后,PORTAL_ADMIN_PASSWORD 值将在文件中被加密,而 PORTAL_ADMIN_PASSWORD_ENCRYPTED 被设置为 true

  4. Portal for ArcGIS 计算机上打开 shell 命令,将目录更改为 webgisdr 实用程序的位置,然后使用导出选项运行实用程序。

    webgisdr 实用程序安装在 <Portal for ArcGIS installation directory>/tools/webgisdr 中。

    webgisdr 的语法如下:

    webgisdr --{export | import} --file <location and name of properties file>

    如前所述,属性文件 (mywebgis.properties) 保存在用户创建的目录 /home/ags/arcgis/portal/propfiles 下。

    webgisdr --export --file /home/ags/arcgis/portal/propfiles/mywebgis.properties

    将在为属性文件中的 SHARED_LOCATION 指定的位置上创建备份文件。文件名为 <timestamp>.webgissite

  5. 如果您的 ArcGIS Enterprise 部署包括地图服务或托管切片图层缓存,则手动创建用于存储缓存切片的所有目录的备份副本(例如,arcgiscacheC:\arcgisserver\directories\ 下的整个 <ArcGIS Server installation directory>/arcgis/server/usr/directories 目录)。

    这些目录将包含地图缓存切片以及切片方案文件 conf.xml。缓存目录也可能包含文件地理数据库 status.gdb,该数据库包含已构建切片的信息。

可使用此文件来恢复您的 ArcGIS Enterprise