Присоединение дополнительных компьютеров к сайту ArcGIS Notebook Server

ArcGIS Notebook Server поддерживает сайты с несколькими компьютерами, начиная с версии 10.7.1. На сайтах с несколькими компьютерами каждый компьютер настроен одинаково, с одинаковыми установленными Docker, и каждый может запускать ArcGIS Notebooks.

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

В версии 10.7 поддерживаются только сайты на одной машине.

Сайты ArcGIS Notebook Server с несколькими компьютерами позволяют поддерживать большее количество одновременно работающих с блокнотами пользователей. Если у вас множество активных пользователей, или если ресурсов одного компьютера недостаточно для нужд пользователей, расширение сайта на несколько компьютеров предоставляет множество преимуществ.

Примечание:

Если у вас есть несколько пользователей Notebook, которым требуется больше ресурсов, вы можете изменить ограничение ресурсов сайта, в качестве альтернативы добавления компьютеров.

Все компьютеры на сайте ArcGIS Notebook Server содержат одинаковое ПО, одинаковых версий и с одинаковыми файлами лицензий. На первом настраиваемом компьютере необходимо создать сайт ArcGIS Notebook Server. Затем к сайту можно добавить дополнительные компьютеры ArcGIS Notebook Server.

Примечание:

В отличие от других ролей ArcGIS Server, ArcGIS Notebook Server не поддерживает добавление дополнительных компьютеров на сайт с первого компьютера. Необходимо обратиться по очереди к каждому компьютеру и присоединить их к сайте, используя мастер конфигурации ArcGIS Notebook Server или утилиту joinsite.

До начала установки

При создании сайта определяете где будет находиться хранилище конфигурации, директория с критическими файлами и данные конфигурации вашего сайта. Ваш сайт также имеет серверные директории system и workspace.

При первом создании сайта ArcGIS Notebook Server, вы задаете местоположения хранилища конфигурации и серверных директорий. На сайте, содержащем несколько компьютеров, необходимо предоставить общий доступ к хранилищу конфигурации и серверным директориям, чтобы другие компьютеры могли получить к ним доступ. Каждому компьютеру, который присоединяется к сайту, должны быть предоставлены права чтения и записи в этих директориях.

Установка и настройка сайта из нескольких компьютеров

При настройке сайта ArcGIS Notebook Server с несколькими компьютерами, имеется еще несколько дополнительных шагов, которые приведены в этом руководстве.

1. Просмотрите системные требования для ArcGIS Notebook Server, чтобы проверить компьютеры на соответствие им. На каждом компьютере настройте брандмауэры на открытие порта 11443 для коммуникаций между компьютерами в развертывании ArcGIS Enterprise.

   Убедитесь, что установка осуществляется от лица одного и того же пользователя операционной системы на обоих компьютерах. Учетная запись, которая используется при установке ArcGIS Notebook Server – это учетная запись, от имени которой будет запускаться ПО. Пользователи групп и все остальные пользователи должны иметь для директории установки ArcGIS Notebook Server по крайней мере права на выполнение. Обратите внимание, что установка ArcGIS Notebook Server от имени корневой учетной записи не поддерживается. Учетная запись, использующаяся для установки на двух разных компьютерах, может быть следующая:

   1. Установите ArcGIS Notebook Server на первом компьютере в папку /data/ags от имени пользователя ags с ID 58103.
   2. Установите ArcGIS Notebook Server на втором компьютере в папку /data/ags под тем же именем и с тем же ID пользователя (ags, 58103).
2. Убедитесь, что вы уже сделали следующее во время процесса установки до этого момента:
   1. Установите Docker на каждом компьютере. На каждом компьютере загрузите образ Docker, предоставляемый Esri, и сохраните его в доступном для системы месте.
   2. Установите и авторизуйте ArcGIS Notebook Server на каждом компьютере. Вы также можете установить ПО в автоматическом режиме.
   3. Запустите утилиту командной строки PostInstaller (находится в <ArcGIS Notebook Server installation directory>/tools/postInstallUtility),чтобы загрузить образы Docker в локальный репозиторий на каждом компьютере.
   4. Выполните шаги по настройке ArcGIS Notebook Server после установки.
3. Создайте две директории в сети, предоставьте к ним общий доступ и укажите пользователя-владельца, от лица которого выполняется установка. Одна из них предназначена для хранилища конфигурации, а другая – для директорий сервера. Необходимо предоставить для папок права доступа, по крайней мере, 700 пользователям.

   Примечание:

   Общие сетевые директории, которые скрыты или используют специальные символы (например, $), не поддерживаются ArcGIS Notebook Server.

   Например:
   1. Создайте директорию с именем config-store. Укажите владельца как ags, с ID пользователя 58103. Предоставьте учетной записи права доступа к директории уровня 700.
   2. Откройте общий доступ к папке config-store, чтобы оба компьютера имели доступ к директории с использованием одного пути, например, /net/myserver/config-store.
   3. Создайте директорию с именем arcgisnotebookserver. Укажите владельца как ags, с ID пользователя 58103. Предоставьте учетной записи права доступа к директории уровня 700.
   4. Откройте общий доступ к папке arcgisnotebookserver, чтобы оба компьютера имели доступ к этой папке с использованием одного пути, например, /net/myserver/arcgisnotebookserver.

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

4. С одного из ваших компьютеров создайте новый сайт ArcGIS Notebook Server. Убедитесь, что использованы пути к вашим серверным директориям и хранилищу конфигурации, созданным ранее.
5. Когда предыдущие шаги выполнены, вы можете присоединять дополнительные компьютеры к созданному сайту, с использованием мастера конфигурации. Если вы предпочитаете использовать для этого командную строку, перейдите к шагу 6.
   1. На первом дополнительном компьютере откройте Мастер конфигурации ArcGIS Notebook Server.
   2. Изучите инструкции Мастера, затем щелкните Продолжить.
   3. Щелкните Подключиться к существующему сайту.
   4. Введите URL сайта и учетные данные для сайта ArcGIS Notebook Server, в соответствии с шагом 4.
   5. Повторите шаги с по для каждого дополнительного компьютера, который вы хотите присоединить к сайту.
6. Вместо использования Мастера конфигурации можно присоединить компьютер к сайту с помощью утилиты командной строки.
   1. Убедитесь, что вы вошли на компьютер под учетной записью ArcGIS Notebook Server.
   2. Откройте командную строку и запустите утилиту, расположенную в <ArcGIS Notebook Server install directory>/tools/JoinSiteUtility/joinsite.sh. Ниже приведены параметры командной строки для утилиты:

      Параметр	Описание
      -u или --username	Имя пользователя основного администратора сайта. Имя пользователя не должно содержать эти символы: \/:*?|<>
      -p или --password	Пароль основного администратора сайта. Пароль не может содержать эти символы: \/:*?|<>
      -f или --file	Файл подключения хранилища конфигурации для утилиты joinsite.
      -s или --siteUrl	URL имеющегося сайта ArcGIS Notebook Server, в формате https://notebookserver.domain.com:11443/arcgis/admin.
      -h или --help	Отображение справки командной строки и выход.

      Пример команды:

      <ArcGIS Notebook Server install directory>/tools/JoinSiteUtility/joinsite.sh -u notebookPSA -p my.Password3 -s https://notebookserver.domain.com:11443/arcgis/admin

      Если учетные данные и URL сайта указаны правильно, утилита присоединит компьютер к сайту ArcGIS Notebook Server. Повторите данный шаг для каждого дополнительного компьютера.

После присоединения к сайту всех компьютеров, последующий процесс настройки не отличается от настройки сайта с одним компьютером. Продолжите установку и настройку ArcGIS Web Adaptor на сайте. Теперь следует настроить сайт на работу с порталом ArcGIS Enterprise.

Присоединение к сайту из командной строки

Также можно использовать утилиту командной строки joinSite для добавления компьютеров к сайту ArcGIS Notebook Server. Для данной утилиты необходимо указать местоположение хранилища конфигурации существующего сайта, а не его адрес URL. Из-за этого утилита получает преимущество в некоторых случаях, когда использование URL засоряет сетевые запросы, проходящие последовательно через сайт. Обдумайте возможность использования этой утилиты, если компьютеры вашего сайта ArcGIS Notebook Server уже перегружены сетевыми запросами, или если вы хотите одновременно добавить большое количество компьютеров на ваш сайт.

Утилита join-site устанавливается в папку \tools\JoinSiteUtility в директории установки ArcGIS Notebook Server. Запустите утилиту join-site на компьютере ArcGIS Notebook Server, который вы хотите добавить к существующему сайту, используя учетную запись Run As для ArcGIS Notebook Server.

1. Выдайте для сетевой учетной записи, используемой для запуска службы ArcGIS Notebook Server, права доступа для чтения и записи папки хранилища конфигурации существующего сайта на компьютерах, которые вы хотите добавить в сайт.
2. Создайте файл JavaScript Object Notation (JSON) с именем connection.json.
3. Добавьте следующую строку в файл, заменив <path to the configuration store> на местоположение хранилища конфигурации существующего сайта ArcGIS Server:

   {"configPersistenceType": "FILESYSTEM", "connectionString": "<path to the configuration store>"}

   В этом примере используется путь /net/mymachine/data/arcgisnotebookserver/usr/config-store к хранилищу конфигурации существующего сайта:

   {"connectionString": "/net/mymachine/data/arcgisnotebookserver/usr/config-store", " configPersistenceType": "FILESYSTEM" }

4. Сохраните и закройте файл connection.json.
5. Перенесите файл connection.json на компьютер, который будет добавлен в сайт, или в сетевую директорию, к которой у добавляемого в сайт компьютера есть доступ.
6. Откройте окно командной строки и запустите join-site.
Синтаксис выглядит так:
joinSite -f <The file path to the configuration store JSON file>
В этом примере предполагается, что файл JSON хранилища конфигурации (connection.json) находится в том же каталоге, что и инструмент join-site (\tools\JoinSiteUtility).
joinsite.bat -f connection.json

Компьютер присоединен к сайту ArcGIS Notebook Server.