Skip To Content

Настройка восстановления ArcGIS Enterprise после отказа

Вы можете реплицировать ArcGIS Enterprise, создав резервное дежурное развертывание. Если на первичном развертывании происходит отказ, можно подключить дежурное развертывание и сделать его активным.

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

Экспортируйте компоненты первичного развертывания ArcGIS Enterprise в сжатый файл с помощью инструмента webgisdr и используйте этот сжатый файл для настройки дежурного развертывания.

Примечание:

  • Утилита webgisdr не перемещает листы кэша картографического сервиса. Если Веб-ГИС включает картографический сервис или кэши размещённых слоев листов, которые используются сайтом GIS Server текущего развертывания, создайте резервную копию всех директорий, где хранятся листы кэша (например, вся директория arcgiscache в C:\arcgisserver\directories\ или <ArcGIS Server installation directory>/arcgis/server/usr/directories). Вручную разместите копии в соответствующей директории arcgiscache или как отдельное развёртывание.
  • Не поддерживается более одного кластера ArcGIS Server при использовании инструмента webgisdr для создания реплики ArcGIS Enterprise в резервном дежурном развертывании.
  • Все компьютеры в обоих развертываниях должны использовать одну и ту же операционную систему. Например, первичное развертывание не может размещаться на компьютерах с Windows, в дежурное - с Linux.

ЭкспортArcGIS Enterprise

Используйте утилиту webgisdr с операцией export и файлом свойств для экспорта данных из первичного развертывания ArcGIS Enterprise. Экспортированный файл содержит хранилища данных портала, хост-сервера, реляционное хранилище данных и хранилище полистного кэша, а также интегрированные серверы. Размер файла и время его создания зависят от количества элементов на портале, числа и типа размещенных веб-слоев, количества интегрированных серверов, а также числа машин ArcGIS Server на размещенных и интегрированных серверах.

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

  • В указанной папке должно быть достаточно места для хранения экспортируемого файла. Выполните проверочный экспорт из ArcGIS Enterprise, чтобы узнать, каков будет размер файла и решить, сколько файлов вы будете хранить в общей папке, и соответственно определить размер этой папки.
  • Имя пользователя, ID пользователя и ID группы учетной записи, которая использовалась для установки каждого из компонентов ПО в ArcGIS Enterprise как на первичном, так и на дежурном развертываниях, и учетная запись, использовавшаяся для запуска инструмента webgisdr, должны совпадать и иметь права доступа для чтения и записи в общей директории.
  • Реляционное хранилище данных ArcGIS Data Store в развертывании ArcGIS Enterprise должно быть настроено на восстановление по временной метке.

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

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

    Файл шаблона свойств – webgisdr.properties – по умолчанию установлен в /arcgis/portal/tools/webgisdr.

    В этом примере копия файла называется mywebgis.properties и сохраняется в /home/ags/arcgis/portal/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}

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

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

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

      Это – новое свойство, появившееся в версии 10.5.1. Если задано BACKUP_STORE_PROVIDER = FileSystem, резервные файлы исходно сохраняются в SHARED_LOCATION, а затем компируются в BACKUP_LOCATION Убедитесь, что размер папки достаточен для хранения файла архива. Хотя этот файл сжат, он может быть довольно большим, в зависимости от объема и типа имеющихся данных. Учетная запись, под которой запускается утилита webgisdr, должна иметь права на запись и чтение в 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 для создания накопительных архивов в период между созданиями полных архивов. Накопительный архив содержит все изменения, начиная с последнего полного резервного копирования.

      Если не задать BACKUP_RESTORE_MODE в файле свойств, архивные файлы full создаются по умолчанию.

    • Если портал 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.

    • Начиная с версии 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.

        Подсказка:

        Вы указали имя учетной записи хранилища при выборе Использовать облачное хранилище 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, укажите информацию для следующих свойств (новое в 10.5.1.):
      • 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 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. Сохраните файл свойств.

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

  4. Откройте окно командной строки, выберите местоположение утилиты webgisdr и запустите ее с опцией export.

    В этом примере файл свойств (mywebgis.properties) сохранен в созданной пользователем папке /home/ags/arcgis/portal/propfiles.

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

Файл будет создан в расположении, указанном в файле параметров в строке SHARED_LOCATION. Имя файла <timestamp>.webgissite.

Перемещение экспортированного файла

Если файл экспорта создан в местоположении, недоступном для дежурного развертывания, переместите его в такое место, куда есть доступ с компьютеров дежурного развертывания. Сделайте копию файла свойств специально для импорта и обновите значение SHARED_LOCATION в новом файле свойств, указав новое местоположение файла экспорта. Убедитесь, что файл свойств, который будет использоваться для импорта ArcGIS Enterprise, доступен для компьютеров дежурного развертывания.

Убедитесь, что учетная запись для установки ArcGIS Server, Portal for ArcGIS и ArcGIS Data Store имеет права чтения в папке, где сохранен файл архива.

В качестве примера для этого рабочего процесса копия файла свойств называется toimport.properties.

Установка компонентов для дежурного развертывания

Перед тем как импортировать данные в резервное развертывание ArcGIS Enterprise в первый раз, необходимо установить и настроить все компоненты ПО (ArcGIS Server, Portal for ArcGIS, ArcGIS Web Adaptor и ArcGIS Data Store) на резервных компьютерах. URL для доступа к порталу (либо URL балансировщика нагрузки, либо URL web adaptor) и URL сервисов ArcGIS Server должны быть одинаковыми для резервного развертывания, так же как и для основного.

Например, если URL для доступа к порталу основного развертывания - https://myportalslb.organization.com/portal, и URL сервисов GIS Server основного развертывания https://myserverslb.organization.com/server, для резервного развертывания должны использоваться такие же URL.

Дополнительные лицензии ArcGIS для дежурного развертывания не требуются, поскольку к нему не осуществляется доступ; вы сделаете его активным только при отказе первичного.

Импорт в дежурное развертывание

После того, как на резервных компьютерах создано пустое развертывание, импортируйте ресурсы с первичного развертывания.

Если ваше основное развертывание ArcGIS Enterprise высокой доступности, инструмент webgisdr сохранит настройки высокой доступности для сайта GIS Server, реляционного хранилища и хранилища полистного кэша ArcGIS Data Store при выполнении вами импорта в резервное развертывание. Для портала инструмент webgisdr отменит регистрацию компьютера резервного портала, пересохранит портал на основном компьютере и заново зарегистрирует резервный компьютер во время импорта.

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

    В этом примере файл свойств (toimport.properties) сохранен в созданной пользователем папке /home/ags/arcgis/portal/propfiles.

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

    Помните, что файл свойств не обязательно должен находится в том месте, где он был создан. Если вы его переместили, укажите новое местоположение в параметре --file.

Обслуживание дежурного развертывания

Для минимизации потери данных, выполняйте экспорт из первичного развертывания в дежурное как можно чаще. То, как часто вы можете это делать, зависит от времени, необходимого для экспорта и импорта, а также от возможности использования скриптов для процессов экспорта и импорта, которые не требуют ручного вмешательства пользователя (например, без необходимости физического копирования файлов с одного места на другое).

Переключение на дежурное развертывание при отказе первичного

Как обсуждалось в разделе Восстановление после сбоя и репликация, IT-отдел может подключить дежурное развертывание при отказе первичного.