Создание резервной копии ArcGIS Enterprise

Вы можете экспортировать компоненты ArcGIS Enterprise в файл резервной копии, который в дальнейшем можно использовать для восстановления в случае аппаратного отказа или потери данных. В этом файле содержатся элементы портала и настройки, размещённые веб-слои, настройки интегрированного и хост-сервера и, если используется ArcGIS Data Store, данные размещённых векторных слоёв и кэши листов размещённых слоёв сцен. Размер файла резервной копии и время, необходимое для его создания, зависят от количества элементов портала, числа и типа размещенных веб-слоев, количества интегрированных серверов, а также от того, сколько используется компьютеров ArcGIS Server на размещающих и интегрированных серверах. Когда вы архивируете развертывание, которое не содержит данных или сервисов, размер полученного файла составляет примерно 400 МБ. Ваш файл всегда будет больше.

Используйте утилиту webgisdr с операцией export и файлом свойств для создания резервной копии ArcGIS Enterprise. Утилиту можно найти в директории инструментов Portal for ArcGIS. Чтобы использовать утилиту, необходимо выполнение следующих условий:

• В указанной папке должно быть достаточно места для хранения экспортируемого файла. Выполните проверочный экспорт из 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 Data Store в ArcGIS Enterprise следует включить опцию восстановления на определенный момент времени.

Для создания резервной копии ArcGIS Enterprise выполните следующие шаги:

1. Создайте копию файла свойств шаблона. Вы можете сохранить копию в той же папке, где находится шаблон, или в новой папке.

   Файл шаблона свойств – webgisdr.properties – по умолчанию установлен в C:\Program Files\ArcGIS\Portal\tools\webgisdr.

   В этом примере копия файла называется mywebgis.properties и сохраняется в C:\propfiles.

2. Откройте копию файла свойств и отредактируйте его, включив сведения, относящиеся к вашему сайту.

   • SHARED_LOCATION = <местоположение резервных файлов>

     Выберите место на диске, где будут созданы временные копии резервных файлов ArcGIS Server, Portal for ArcGIS, and ArcGIS Data Store. Доменная учетная запись, под которой запускается ArcGIS Server, Portal for ArcGIS и сервис ArcGIS Data Store, и учетная запись, которая используется для запуска утилиты webgisdr, должны иметь права доступа для записи данных в эту папку. Убедитесь, что размер папки достаточен для хранения файла архива. Хотя файл сжат, он может быть довольно велик, в зависимости от объема и типа имеющихся данных. Если у вас имеются размещенные слои сцен и кэш, а для параметра INCLUDE_SCENE_TILE_CACHES установлено значение true, размер файла архива ArcGIS Data Store будет особенно большим.

     Прежние версии:

     В Portal for ArcGIS 10.4 значением этого свойства было SHARED_FOLDER.

   • BACKUP_STORE_PROVIDER = {FileSystem | AmazonS3 | Azure}

     Если вы хотите сохранить свою резервную копию ArcGIS Enterprise в локальном местоположении файлового хранилища, укажите FileSystem, и тогда утилита webgisdr сохранит файлы резервного копирования в файловом хранилище, которое будет задано для BACKUP_LOCATION.

     Если вы хотите хранить свои резервные копии ArcGIS Enterprise на Amazon Simple Storage Service (S3), создайте блок памяти S3 специально для хранения архивных файлов, созданных с помощью утилиты webgisdr, и обновите свойства S3, добавив информацию, необходимую для доступа к этому блоку памяти.

     Если вы хотите хранить свои резервные копии ArcGIS Enterprise на Azure Blob storage, создайте контейнер Azure Blob storage специально для хранения архивных файлов, созданных с помощью утилиты webgisdr, и обновите свойства Azure, добавив информацию, необходимую для доступа к этому контейнеру.

   • BACKUP_LOCATION = <местоположение файла резервного копирования на локальном ресурсе>

     Файлы резервного копирования сначала сохраняются в SHARED_LOCATION, но затем копируются в BACKUP_LOCATION. Убедитесь, что размер папки достаточен для хранения файла архива. Хотя этот файл сжат, он может быть довольно большим, в зависимости от объема и типа имеющихся данных. Учетная запись, под которой запускается утилита webgisdr, должна иметь права на запись в BACKUP_LOCATION.

     Если в качестве BACKUP_LOCATION будет задана папка, то инструмент аварийного восстановления импортирует в эту папку самый последний доступный файл резервной копии. Если вы установите BACKUP_LOCATION в определённый файл резервной копии в этой папке, то инструмент аварийного восстановления импортирует именно этот файл.

   • PORTAL_ADMIN_URL = <URL директории администрирования портала>

     Укажите URL-адрес директории администрирования Portal for ArcGIS. Используйте формат https://portalhostname.domain.com:7443/arcgis, где portalhostname.domain.com – это полное имя компьютера, на котором установлен Portal for ArcGIS.

   • PORTAL_ADMIN_USERNAME = <имя пользователя администратора портала>

     Укажите имя пользователя участника портала, которому присвоена роль администратора, заданная Esri.

   • PORTAL_ADMIN_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 для создания накопительных архивов в период между созданиями полных архивов. Накопительный архив содержит все изменения, начиная с последнего полного резервного копирования.

   • Если портал ArcGIS Enterprise запущен на AWS, и директория ресурсов хранится на Amazon S3, потребуется бакет архивной копии для этой директории. Создайте бакет резервного копирования на S3 и задайте PORTAL_BACKUP_S3_BUCKET в файле свойств, чтобы назвать бакет и настроить PORTAL_BACKUP_S3_REGION в качестве региона AWS, в котором создаётся бакет S3. Дополнительную информацию об этом типе реализации см. в разделе Настройка отказоустойчивого ArcGIS Enterprise с сервисами хранения AWS в Справке ArcGIS Enterprise on Amazon Web Services.

     Прежние версии:

     До ArcGIS Enterprise 10.5.1 свойство PORTAL_BACKUP_S3_BUCKET было BACKUP_BUCKET_NAME.

   • Вы можете сохранить директорию ресурсов портала в контейнере хранилища Azure Blob. Чтобы использовать утилиту webgisdr для создания резервной копии развёртывания, вам надо установить следующие свойства:
     • PORTAL_BACKUP_BLOB_ACCOUNT_NAME = <Учётная запись хранилища Azure>

       Установите PORTAL_BACKUP_BLOB_ACCOUNT_NAME для имени учетной записи хранилища Azure Blob.

       Подсказка:

       Вы указали имя учетной записи хранилища при выборе Использовать облачное хранилище Azure для хранения конфигурации и ресурсов на панели Опциях развертывания в Cloud Builder.

     • 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 = <URL сервиса Blob>

       Укажите конечную точку учетной записи хранилища сервиса Blob. URL в формате https://<PORTAL_BACKUP_BLOB_ACCOUNT_NAME>.<PORTAL_BACKUP_BLOB_ACCOUNT_ENDPOINT>/<container name>.

   • Если вы установите BACKUP_STORE_PROVIDER на AmazonS3, укажите информацию для следующих свойств:
     • S3_ACCESSKEY= <Ключ доступа для учётной записи AWS>

       Это надо будет сделать, только если вы зададите S3_CREDENTIAL_TYPE=accessKeys. Пользователь IAM, представленный этим ключом доступа, должен обладать правами доступа для чтения и записи в бакет S3, который указывается в параметре S3_BUCKET.

     • S3_SECRETKEY= <Секретный ключ для учетной записи AWS>

       Укажите секретный ключ, который связан с ключом доступа для учетной записи AWS. Это используется, только если для S3_CREDENTIAL_TYPE задано accessKeys.

     • S3_ENCRYPTED = false

       Оставьте для него значение false. Если при запуске утилиты webgisdr для S3_CREDENTIAL_TYPE задано значение accessKeys, утилита зашифрует ключ доступа и секретный ключ и установит для S3_ENCRYPTED зашифрованное значение ключа доступа.

     • S3_BUCKET= <имя бакета S3>

       Это – имя бакета S3 Amazon, в котором вы хотели бы сохранить файл архива ArcGIS Enterprise.

     • S3_CREDENTIAL_TYPE= <IAMRole | accessKeys

       Установите S3_CREDENTIAL_TYPE на IAMRole, если вы хотите открыть S3_BUCKET с помощью роли AWS IAM. Задайте для него accessKeys, если вы хотите открыть S3_BUCKET от имени пользователя AWS IAM посредством ключа доступа. Роль или пользователь IAM должны обладать правами доступа для чтения и записи в бакет S3, который указывается в параметре S3_BUCKET.

     • 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), сервисы и параметры хост- и интегрированных серверов портала, а также данные, хранящиеся в реляционном хранилище данных и хранилище данных полистного кэша будут с записаны в бакет S3 entbackups в регионе AWS eu-west-1. Имя файла резервной копии – fullbackup06June. Роль IAM используется для доступа к учетной записи AWS.

   BACKUP_STORE_PROVIDER = AmazonS3 PORTAL_ADMIN_URL = https://portalonaws.mydomain.com:7443/gis 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. Сохраните файл свойств.

   Значение PORTAL_ADMIN_PASSWORD в файле будет зашифровано, а для PORTAL_ADMIN_PASSWORD_ENCRYPTED задается true, поскольку вы запускаете утилиту webgisdr с эти файлом.

4. Откройте окно командной строки на компьютере Portal for ArcGIS, укажите местоположение утилиты webgisdr и запустите эту утилиту с опцией export.

   По умолчанию утилита 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

5. Если ArcGIS Enterprise включает картографический сервис или кэши размещённых слоев листов, вручную создайте резервную копию всех директорий, где хранятся листы кэша (например, вся директория arcgiscache в C:\arcgisserver\directories\ или <ArcGIS Server installation directory>/arcgis/server/usr/directories).

   В этих директориях будут содержаться листы кэша и файл схемы листов conf.xml. Директории кэша также могут содержать файловую базу геоданных, status.gdb, которая содержит информацию о созданных листах.

Вы можете использовать этот файл для восстановления ArcGIS Enterprise.