创建 ArcGIS Enterprise 备份—Portal for ArcGIS

可将 ArcGIS Enterprise 部署的组件导出为备份文件，将来发生硬件故障或数据丢失时，可使用备份文件来恢复部署。备份文件包含门户项和设置、托管 Web 图层、联合和托管服务器设置，以及托管要素图层数据和托管场景图层缓存（如使用 ArcGIS Data Store）。

备份文件的大小以及创建备份文件所需的时间取决于以下方面：门户中项目的数量、拥有的托管 Web 图层的数量和类型、拥有的联合服务器的数量以及托管和联合服务器中 ArcGIS Server 计算机的数量。

可使用 webgisdr 实用程序通过导出操作和属性文件来创建 ArcGIS Enterprise 备份。您可在 Portal for ArcGIS 工具目录中找到该实用程序。使用实用程序时，请确保满足以下条件：

您指定的共享目录必须足以包含导出的文件。要估计文件的大小，请将 webgisdr 实用程序与导出操作搭配使用来创建 ArcGIS Enterprise 部署的测试导出。检查文件大小，确定要在共享目录中保留多少个文件，考虑到部署会随着时间增长，并相应地调整目录大小。由于文件大小可能会随时间增加，因此您应继续监控这些备份文件的大小并根据需要调整存储大小。
用于运行 ArcGIS Server、Portal for ArcGIS 和 ArcGIS Data Store 服务的域帐户或帐户必须拥有为备份文件指定的共享目录的写入权限。
每个组件的备份都位于其各自计算机上的临时目录中，然后方可将其移动到您指定的共享目录中。因此，以下目录必须有足够大的空间以包含各个组件的备份：
- Portal for ArcGIS：<Portal_content_directory>\temp
- ArcGIS Server：C:\Users\<user>\AppData\Local\Temp
- ArcGIS Data Store：<ArcGIS_Data_Store_directory>\temp
如果要创建增量备份 (BACKUP_RESTORE_MODE = incremental)，ArcGIS Enterprise 部署中的 ArcGIS Data Store 关系数据存储必须启用时间点恢复。

注：

如果您的门户内容存储在文件系统中，则实时防病毒扫描会影响备份的性能。请考虑从防病毒扫描程序中排除门户内容目录以及备份 SHARED_LOCATION 和 BACKUP_LOCATION 目录。

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

创建模板属性文件的副本。您可将副本保存到模板所在的目录或新目录下。
模板属性文件—webgisdr.properties—默认安装在 C:\Program Files\ArcGIS\Portal\tools\webgisdr 下。模板属性文件—
在本示例中，文件副本命名为 mywebgis.properties 并保存在 C:\propfiles 下。
打开属性文件副本并对其进行编辑，以包含站点的特定信息。
- PORTAL_ADMIN_URL = <门户管理目录 URL>
  指定 Portal for ArcGIS 管理目录的 URL。使用格式 https://portalhostname.domain.com:7443/arcgis，其中 portalhostname.domain.com 为安装了 Portal for ArcGIS 的计算机的完全限定名称。
- PORTAL_ADMIN_USERNAME = <门户管理员用户名>
  指定分配给管理员角色的门户成员的用户名。
- PORTAL_ADMIN_PASSWORD = <门户管理员密码>
  指定门户管理员帐户的密码。
- PORTAL_ADMIN_PASSWORD_ENCRYPTED = <true | false>
  首次使用管理员密码填充文件时，请将该选项设置为 false。保存文件后密码将加密，可将 PORTAL_ADMIN_PASSWORD_ENCRYPTED 的值设置为 true 以表示该密码已加密。如果以后需要更改密码，可设置 PORTAL_ADMIN_PASSWORD_ENCRYPTED = false，提供新的管理员密码，然后保存文件。
- BACKUP_RESTORE_MODE = <backup | full | incremental>
  指定要创建的备份类型。在 10.9 版本中引入 backup 模式，可在门户计算机上的硬盘空间有限或未定期安排备份时使用。使用此模式时，将限制内部事务日志的默认大小，防止其占满您的硬盘。如果仅创建完整备份，可将此属性设置为 backup。如果要创建完整备份和增量备份，可以创建两个不同的属性文件 - 一个具有 BACKUP_RESTORE_MODE = full，可偶尔用于创建完整备份，另一个具有 BACKUP_RESTORE_MODE = incremental，用于在完整备份的间隔生成增量备份。每个增量备份均包含自上一次完整备份后所发生的所有更改。
- SHARED_LOCATION = <备份文件位置>
  指定要创建 ArcGIS Server、Portal for ArcGIS 和 ArcGIS Data Store 备份文件临时副本的共享位置。运行 ArcGIS Server、Portal for ArcGIS 和 ArcGIS Data Store 服务的域帐户和运行 webgisdr 实用程序的帐户必须具有此位置的写入权限。确保该位置足以容纳每个组件的备份文件。虽然经过压缩，但文件仍然相当大，具体取决于数据的数量和类型。如果有托管场景图层和缓存，并且 INCLUDE_SCENE_TILE_CACHES 设置为 true，则 ArcGIS Data Store 备份文件可能非常大。
  确保路径中的反斜线已被转义。例如，C:\backups 将被输入为 C:\\backups，\fileserver\backups 将被输入为 \\\\fileserver\\backups。
- INCLUDE_SCENE_TILE_CACHES = <true | false>
  如果要将托管场景图层发布至门户并在备份中包含场景缓存数据，可将 INCLUDE_SCENE_TILE_CACHES 设置为 true。请注意，如果设置为 true，备份中将包含所有场景缓存数据，而不仅仅是上次备份后创建的新缓存数据。如果已知上次备份后未创建新的场景缓存，或者不需要将场景发布至门户，可将 INCLUDE_SCENE_TILE_CACHES 设置为 false。
- BACKUP_STORE_PROVIDER = {FileSystem | AmazonS3 | AzureBlob}
  定义是否要保存文件系统或云存储上的 webgissite 备份文件。
  要将您的 ArcGIS Enterprise 备份存入本地文件共享位置，请指定 FileSystem，然后 webgisdr 实用程序将把您的备份文件存入您指定用于 BACKUP_LOCATION 的文件共享中。
  要将您的 ArcGIS Enterprise 备份存入 Amazon Simple Storage Service (S3) 或 S3 兼容存储段存储位置，请创建一个专为存储由 webgisdr 实用程序生成的备份文件的存储段，并使用访问您的存储段所需的信息更新 S3 属性。
  要将您的 ArcGIS Enterprise 备份存入 Microsoft Azure Blob 存储，请创建一个专为存储由 webgisdr 实用程序生成的备份文件的 Azure Blob 存储容器，并使用访问您的容器所需的信息更新 Azure 属性。
  注：
  如果您的 ArcGIS Enterprise 部署为本地部署，但是备份存储在云中，则与将备份存储在本地文件共享中相比，创建备份和恢复备份所需的时间更长。
- BACKUP_LOCATION = <备份文件本地位置>
  指定 webgissite 备份文件的位置。
  确保路径中的反斜线已被转义。例如，C:\backups 将被输入为 C:\\backups，\\fileserver\backups 将被输入为 \\\\fileserver\\backups。
  备份文件最初将被存入 SHARED_LOCATION，但是将被复制到 BACKUP_LOCATION。确保该位置足以容纳备份文件。虽然经过压缩，但文件仍然相当大，具体取决于数据的数量和类型。运行 webgisdr 实用程序的帐户必须拥有对 BACKUP_LOCATION 的写入权限。
  如果您设置 BACKUP_LOCATION 为文件夹，灾难恢复工具将向该文件夹导入最新的可用备份文件。如果您设置 BACKUP_LOCATION 为文件夹中的特定备份文件，则灾难恢复工具将导入该文件。
  注：
  在导出期间，打包备份可能要花费很长时间，请考虑将 BACKUP_LOCATION 设置为本地路径。然后，您可以将操作完成的包复制到所需位置。确保本地驱动器上有足够的空间，用于临时存储备份。
- COMPRESSION_METHOD= <copy | fastest | fast | normal | maximum | ultra>
  确定 webgissite 备份的压缩方法。如果未填充或注释掉默认值，则该值为 copy。在大多数情况下，可将其保留为已注释状态。管理员可以选择进一步压缩备份，但这会导致完成备份所需的时间增加。
- 如果您设置 BACKUP_STORE_PROVIDER 为 AmazonS3，请提供有关如下属性的信息：
  - S3_ACCESSKEY = <您的 Amazon Web Services (AWS) 帐户的访问密钥>
    如果您设置 S3_CREDENTIAL_TYPE = accessKey，则您只需设置本项。该访问密钥所代表的 IAM 用户必须有您指定的具有 S3_BUCKET 属性的 S3 存储段的读写权限。
  - S3_SECRETKEY = <您的 AWS 帐户的保密密钥>
    为您的 AWS 帐户指定与访问密钥相关的保密密钥。仅当 S3_CREDENTIAL_TYPE 设置为 accessKey 时，使用此项。
  - S3_ENCRYPTED = false
    将此设置保留为 false。当您运行 webgisdr 实用程序时，如果您将 S3_CREDENTIAL_TYPE 设置为 accessKey，则实用程序将加密访问密钥和保密密钥，并设置 S3_ENCRYPTED 为加密访问密钥值。
  - S3_BUCKET= <S3 存储段名称>
    这是您想要存入 ArcGIS Enterprise 备份文件的 Amazon S3 存储段的名称。
  - S3_CREDENTIAL_TYPE= <IAMRole | accessKey>
    如果您要使用 AWS IAM 角色访问 S3_BUCKET，请将 S3_CREDENTIAL_TYPE 设置为 IAMRole。如果您要通过一个访问密钥使用 AWS IAM 用户访问 S3_BUCKET，请将其设置为 accessKey。该 IAM 角色或用户必须有您指定的具有 S3_BUCKET 属性的 S3 存储段的读写权限。
  - S3_REGION= <AWS 区域，您创建 S3 存储段的位置>
  - S3_BACKUP_NAME = <备份文件名称>
    仅当您恢复 ArcGIS Enterprise 部署时，使用本属性。指定要恢复的备份文件的名称。如果您不指定备份文件的名称，则将恢复最新的备份文件。
- 如果您的 ArcGIS Enterprise 部署在 AWS 上运行，且门户内容目录存储在 Amazon S3 中，则需要内容目录的备份存储段。该存储段不应与门户所在的存储段相同。否则，每次执行备份都会出现重复内容。在 S3 中创建一个备份存储段，在属性文件中将 PORTAL_BACKUP_S3_BUCKET 设置为存储段的名称并将 PORTAL_BACKUP_S3_REGION 设置为创建 S3 存储段的 AWS 区域。有关此类型实施的详细信息，请参阅 ArcGIS Enterprise on Amazon Web Services 帮助中的使用 AWS 存储服务配置高可用性 ArcGIS Enterprise。
  注：
  如果您的部署的机器使用 VPC 终端节点访问 Amazon S3，则不允许跨区域复制。在实施地理冗余时，在与备用部署相同的区域中创建一个存储段，并确保在运行 WebGISDR 导入操作之前使用 AWS CLI（或自动化过程）同步导出的门户内容备份存储段。此复制存储段需在 webgisdr.properties 恢复文件中指定为具有适当区域的 PORTAL_BACKUP_S3_BUCKET。
  旧版本：
  在 ArcGIS Enterprise 10.5.1 之前的版本中，PORTAL_BACKUP_S3_BUCKET 属性为 BACKUP_BUCKET_NAME。
- 如果您设置 BACKUP_STORE_PROVIDER 为 AzureBlob，请提供有关如下属性的信息：
  - AZURE_BLOB_ACCOUNT_NAME = <Azure 存储帐户>
    指定 Azure Blob 存储帐户名称。
    提示：
    当您在 Cloud Builder 的部署选项面板上选择使用 Azure 云存储进行配置和内容存储选项时，您指定了此存储帐户名称。
  - AZURE_BLOB_ACCOUNT_KEY = <帐户密钥>
    指定与 Azure Blob 存储帐户相关联的帐户密钥。
  - AZURE_BLOB_ACCOUNT_KEY_ENCRYPTED = false
    当您首次为文件添加 ACCOUNT_KEY 值时，指定 false。当您保存 webgisdr.properties 文件时，密钥将被加密，且该工具将这些属性设置为 true。
  - AZURE_BLOB_CONTAINER_NAME = <Azure 存储容器的名称>
    指定 Blob 容器名称。
  - AZURE_BLOB_ACCOUNT_ENDPOINT_SUFFIX = <Blob 存储帐户端点>
    指定 Blob 服务存储帐户端点。
  - （可选）AZURE_BLOB_ENDPOINT_URL = <Blob 服务 URL>
    如果您使用自定义 blob 存储端点，则请指定 Blob 服务端点 URL。如果您未使用自定义端点，请不要取消注释此行。默认 URL 的格式为 https://<BLOB_ACCOUNT_NAME>.blob.core.windows.net。
- 您也可以将门户内容目录存储在 Azure Blob 存储容器中。如果您如此操作，则需要 Azure 中内容目录的备份存储段。该存储段不应与门户所在的存储段相同。否则，每次执行备份都会出现重复内容。以 PORTAL_BACKUP_BLOB 开头的属性集定义了用于门户内容目录的帐户。这些属性的值应与以上 AZURE_BLOB 部分中的设置值相匹配；该部分的定义也适用于此处。
  - PORTAL_BACKUP_BLOB_ACCOUNT_NAME = <Azure 存储帐户>
  - PORTAL_BACKUP_BLOB_ACCOUNT_KEY = <帐户密钥>
  - PORTAL_BACKUP_BLOB_ACCOUNT_KEY_ENCRYPTED = false
  - PORTAL_BACKUP_BLOB_CONTAINER_NAME = <Azure 存储容器的名称>
  - PORTAL_BACKUP_BLOB_ACCOUNT_ENDPOINT_SUFFIX = <Blob 存储帐户端点>
  - （可选）PORTAL_BACKUP_BLOB_ENDPOINT_URL = <自定义 Blob 服务 URL>
- IS_PORTAL_PKI_AUTHENTICATED = <true | false>
  如果已配置公钥基础设施 (PKI) 以安全访问门户，请将此值设置为 true。
  了解有关门户身份验证选项的详细信息
  如果设置为 true，请为以下附加属性提供值：
  - PORTAL_CLIENT_CERTIFICATE_FILE_PATH = <证书的完整文件路径>
    指定 PKCS12 格式的门户 PKI 证书的完整文件路径。
  - PORTAL_CLIENT_CERTIFICATE_PASSWORD = <证书密码>
    指定 PKI 证书的相应密码。
  - PORTAL_CLIENT_CERTIFICATE_PASSWORD_ENCRYPTED = false
    首次输入证书密码值时，请将此值保留为 false。保存此值后首次运行工具时，该工具将对密码进行加密并将此属性更改为 true。
在本示例中，URL 为 https://portalhostname.domain.com:7443/arcgis 的门户的备份，及其托管与联合服务器的服务和设置，以及存储在 ArcGIS Data Store 关系数据存储中的托管要素图层数据最初将输出至 \\\\myserver\\tempbackups 上的文件。单独的文件将被压缩成单个备份文件 (entbackup) 并复制到 \\mybuserver\\wgbackups。将不包含 ArcGIS Data Store 切片缓存数据存储的场景图层缓存，因为 INCLUDE_SCENE_TILE_CACHES 设置为 false。
```
PORTAL_ADMIN_URL = https://portalhostname.domain.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
```
在本示例中，URL 为 https://portalonaws.mydomain.com:7443/gis 的门户的备份，及其内容目录（储存在 S3 存储段 portalcontent），托管与联合服务器的服务和设置，以及储存在关系和切片缓存数据存储中的数据将被输出至 AWS 区域 eu-west-1 中的 S3 存储段 entbackups。备份文件名为 fullbackup06June。 IAM 角色用于访问 AWS 帐户。
```
PORTAL_ADMIN_URL = https://portalonaws.mydomain.com:7443/arcgis
PORTAL_ADMIN_USERNAME = entadmin
PORTAL_ADMIN_PASSWORD = p0rtl.a.p
PORTAL_ADMIN_PASSWORD_ENCRYPTED = false

BACKUP_RESTORE_MODE = backup
SHARED_LOCATION = \\fileserver\backups
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
```
此示例适用于 Microsoft Azure Blob 存储。 URL 为 https://portalonazure.domain.com:7443/arcgis 的门户的备份、其内容目录、门户托管与联合服务器的服务和设置，以及存储在关系数据存储和切片缓存数据存储中的数据将被输出至 Azure Blob drbackups。
```
PORTAL_ADMIN_URL = https://portalonazure.domain.com:7443/arcgis
PORTAL_ADMIN_USERNAME = entadmin
PORTAL_ADMIN_PASSWORD = p0rtl.a.p

BACKUP_RESTORE_MODE = backup
SHARED_LOCATION = \\fileserver\backups
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
```
保存属性文件。
使用该文件运行 webgisdr 实用程序后，PORTAL_ADMIN_PASSWORD 值将在文件中被加密，而 PORTAL_ADMIN_PASSWORD_ENCRYPTED 被设置为 true。
在 Portal for ArcGIS 计算机上打开命令窗口，将目录更改为 webgisdr 实用程序的位置，然后使用导出选项运行该实用程序。
webgisdr 实用程序的默认位置为 C:\Program Files\ArcGIS\Portal\tools\webgisdr。
webgisdr 实用程序的语法如下：
```
webgisdr --{export | import} --file <location and name of properties file>
```
如前所述，属性文件 (mywebgis.properties) 保存在用户创建的文件夹 C:\propfiles 中。
```
webgisdr --export --file C:\propfiles\mywebgis.properties
```
注：
如果工具在运行时似乎停止，请确保命令提示符不在 QuickEdit 模式下。有关详细信息，请参阅常见问题及解决方案。
如果您的 ArcGIS Enterprise 部署包括地图服务或托管切片图层缓存，则手动创建用于存储缓存切片的所有目录的备份副本（例如，C:\arcgisserver\directories\ 或 <ArcGIS Server installation directory>/arcgis/server/usr/directories 下的整个 arcgiscache 目录）。
这些目录将包含地图缓存切片以及切片方案文件 conf.xml。缓存目录也可能包含文件地理数据库 status.gdb，该数据库包含已构建切片的信息。

可使用此文件来恢复 ArcGIS Enterprise。

有关此主题的反馈?

注：

注：

注：

注：

旧版本：

提示：

注：