Обновление ArcGIS Notebook Server (контейнеры Linux)

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

Пакет установки ArcGIS Notebook Server 11.1 определяет, установлена ли на вашей машине предыдущая версия ArcGIS Notebook Server. Если да, то вы можете обновить это ПО до версии 11.1.

При обновлении необходима повторная авторизация программного обеспечения ArcGIS Notebook Server для 11.1, если вы ранее выполнили обновление с версии 10.8.1 или более ранней версии.

Вы также должны установить новые образы контейнеров от Esri, чтобы предоставить своим пользователям среды выполнения блокнотов 11.1. Среды выполнения блокнотов из предыдущей версии останутся на сайте. Пользователи по-прежнему смогут запускать блокноты в этих средах. Но если ваши пользователи хотят использовать новые функции версии 11.1, им следует обновить среду выполнения своих блокнотов. Среды выполнения блокнотов, соответствующие версии 11.1, находятся в версии 8.0 (ArcGIS Notebook Server Standard 8.0 и ArcGIS Notebook Server Advanced 8.0).

Примечание:

Если какие-то блокноты применяли пользовательские среды выполнения, вам потребуется перестроить и повторно зарегистрировать пользовательские среды выполнения на сервере блокнотов Windows и обновить настройки среды выполнения для связанных элементов блокнота.

Примечание:

Среды выполнения блокнотов будут устаревать в соответствии с Жизненным циклом ArcGIS Enterprise. Блокноты не должны использовать устаревшие среды выполнения и должны быть обновлены до поддерживаемой среды.

При обновлении портала ArcGIS Enterprise будут обновлены также образцы блокнотов, доступные в галерее сайта.

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

Процесс обновления для ArcGIS Notebook Server осуществляется "по месту" и не требует деинсталляции и повторной установки ПО. На время процесса обновления сайт будет остановлен, а пользователи не смогут запускать блокноты и работать с ними, пока обновление не будет выполнено.

Следуйте инструкциям ниже, чтобы обновить ArcGIS Notebook Server до 10.8.111.1.

Подготовка к обновлению

Перед обновлением внимательно ознакомьтесь со следующей информацией:

• Перед обновлением вы можете получить все необходимые файлы на сайте My Esri, в том числе к образам контейнеров 11.1.
• Чтобы ArcGIS Notebook Server корректно функционировал, его версия должна соответствовать версии портала, с которым он интегрирован.
• Обновление Docker до версии 20.10.13 или более новой.
• Чтобы обновить развертывание ArcGIS Enterprise, выполните следующее:
  1. Обновите Portal for ArcGIS.
  2. Обновите ArcGIS Web Adaptor (для портала).
  3. Обновите сайт ArcGIS Server, обслуживающий хост-сервер портала.
  4. Обновите ArcGIS Web Adaptor (для Server).
  5. Обновите ArcGIS Data Store (обновите сначала основной, а затем резервный).
  6. Обновите все остальные сервера, включающие ArcGIS Notebook Server.
  7. Установка образцов данных ArcGIS Notebook Server
• Не удаляйте существующий ArcGIS Notebook Server. Установщики ArcGIS Notebook Server и командной строки предназначены для обнаружения и обновления существующей инсталляции компонентов ArcGIS Notebook Server.
• В ходе процесса обновления не нужно отменять интеграцию сайта ArcGIS Notebook Server с порталом либо удалять его назначение как Notebook Server для портала. Это неблагоприятно скажется на существующих блокнотах, размещенных на портале.
• Вы можете обновить ArcGIS Notebook Server с помощью программы Установки или Установщика из командной строки. Выберите один из методов обновления.
• Перед обновлением очистите кэш всех интернет-браузеров, используемых на компьютере ArcGIS Notebook Server.
• Учетная запись Windows, которая используется для сайта ArcGIS Notebook Server (от имени которой он запускается) должна оставаться неизменной в ходе процесса обновления.

Резервное копирование развертывания

Перед обновлением рекомендуется сделать резервное копирование вашего развертывания.

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

В версии 10.7 вам нужно вручную создать резервную копию хранилища конфигурации и директорий сервиса сайта.

Блокноты включаются в резервные копии портала с помощью утилиты webgisdr.

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

Выполните следующие действия для того, чтобы создать резервную копию:

1. Откройте Administrator Directory ArcGIS Notebook Server и войдите как пользователь с правами администратора.

   Обычно это URL-адрес вида https://notebookserver.domain.com:11443/arcgis/admin.

2. Перейдите к сайт > Экспорт сайта.
3. Введите полный путь к папке на машине, куда нужно экспортировать файл.

   У сайта должен быть доступ к этой папке.

4. Щелкните Экспорт.

   По завершении операции экспорта в директории появится ссылка на расположение файла резервной копии на сервере.

5. Скачайте этот файл с расширением .agssite как можно быстрее.

Обновление с помощью программы установки

Примечание:

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

Если ваш сайт состоит из нескольких компьютеров, выполните действия из шагов с1 по 3 на одном компьютере, а затем повторите их на остальных компьютерах сайта.

ArcGIS Notebook Server предназначен для обнаружения и обновления существующей инсталляции компонентов ArcGIS Notebook Server.

1. Чтобы начать процесс обновления, запустите ./Setup из того расположения, в которое был распакован ArcGIS Notebook Server, и следуйте подсказкам на экране для завершения обновления.

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

   Предыдущая версия ArcGIS Notebook Server будет удалена, затем будет установлена обновленная версия ArcGIS Notebook Server.

2. По завершении работы утилиты обновления выполните повторную авторизацию программного обеспечения ArcGIS Notebook Server для версии 11.1. Для этого используйте мастер авторизации программного обеспечения.
3. Откройте Мастер конфигурации, используя URL, указанный в конце процесса установки, и следуйте инструкциям на экране, чтобы обновить сайт.
4. Если ваш сайт состоит из нескольких компьютеров, выполните шаги с 1 по 3 на всех компьютерах сайта.

Обновление из командной строки

Для обновления ПО через командную строку необходимо выполнить следующие действия:

1. Чтобы начать обновление, запустите команду установки ArcGIS Notebook Serverс аргументом, показанным на примере ниже. Убедитесь, что используется та же самая учетная запись ArcGIS Notebook Server, что и для предыдущей установки.

   Предыдущая версия ArcGIS Notebook Server будет удалена, после чего будет установлена обновленная версия ArcGIS Notebook Server.

   setup.exe /qn USER_NAME=<ArcGIS Notebook Server account username> PASSWORD=<password> ACCEPTEULA=yes

2. Использйте утилиту upgradesite для выполнения обновления, запустив следующую команду. По умолчанию, утилиту upgradesite можно найти в C:\Program Files\ArcGIS\NotebookServer\tools\upgradesiteutility\upgradesite.bat.

   upgradesite.bat -s

   Утилита будет отображать ход выполнения и завершит работу по окончании обновления. У утилиты есть два параметра:

   • -s — при включении в команду, улитита будет выполнять обновление. Обновление не будет запущено без -s. Это является мерой предосторожности, позволяющей гарантировать, что вы будете запускать обновление только тогда, когда будете готовы.
   • -h — отображает справку инструмента. Если команда запущена без -s, также будет показана справка.

3. Если ваш сайт состоит из нескольких компьютеров, повторите шаги с 1 по 2 на всех компьютерах сайта, затем перейдите к шагам в следующем разделе.

Авторизация в автоматическом режиме

По завершении работы утилиты обновления выполните повторную авторизацию программного обеспечения ArcGIS Notebook Server для версии 11.1, если вы ранее обновили версию с 10.8.1 или более ранней.

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

Если у вас есть файл авторизации, а ваш компьютер подключен к интернету, выполните следующие действия:

<System disk drive>\Program Files\ArcGIS\NotebookServer\framework\bin /S /Ver <version number> /LIF <full path and name of authorization file>

Авторизация в отключенной среде

Вы можете авторизовать ArcGIS Notebook Server в среде без подключения к интернету с помощью файла инициализации (.prvc). В течение этого процесса для вас будет создан файл, который вы после этого отправите в Esri.

1. После завершения обновления ArcGIS Notebook Server выполните в командной строке следующую команду:

   <System disk drive>\Program Files\Common Files\ArcGIS\bin\SoftwareAuthorization.exe /F <full path to the .prvc file> /O <full path to authorization file output>

2. После создания информационного файла выполните одно из следующих действий:
   • Перейдите на сайт службы поддержки пользователей Esri https://service.esri.com/drm. Следуйте инструкциям на экране, чтобы выгрузить информационный файл авторизации и загрузить файл авторизации .ecp.
   • Отправьте информационный файл авторизации по адресу: [e-mail]. Esri отправит файл авторизации .ecp на ваш адрес электронной почты.
3. После получения файла авторизации .ecp любым из предложенных выше способов запустите скрипт authorizeSoftware еще раз для завершения процесса авторизации:

   <System disk drive>\Program Files\Common Files\ArcGIS\bin\SoftwareAuthorization.exe /F <full path to the .ecp file>

Повторите этот рабочий процесс для каждого компьютера с ArcGIS Notebook Server.

Действия после обновления

Чтобы ваш обновленный и повторно авторизованный сайт ArcGIS Notebook Server можно было использовать, вы должны запустить после установки утилиту, которая добавит на сайт новые образы контейнеров Docker. Для обеспечения соответствия версий вам необходимо, кроме того, заменить экземпляры ArcGIS Web Adaptor, зарегистрированные на вашем сайте.

Запуск утилиты пост-установки

Чтобы запустить утилиту пост-установки, выполните следующие действия:

1. Откройте окно командной строки от имени администратора.
2. Измените директорию на папку инструментов ArcGIS Notebook Server. По умолчанию это путь C:\Program Files\ArcGIS\NotebookServer\tools\postInstallUtility.
3. При необходимости обратитесь к справке утилиты, выполнив следующую команду: PostInstallUtility.bat -h
4. ArcGIS Notebook Server требует, чтобы на вашем компьютере был установлен Docker Engine Community Edition. Определите, активен ли на вашем компьютере Docker, выполнив следующую команду: PostInstallUtility.bat -d
5. Если Docker Desktop не установлен, установите его сейчас.

   ArcGIS Notebook Server использует контейнеры Linux в Docker Desktop. При установке Docker Desktop убедитесь, что вы указали контейнеры Linux и не выбрали параметр Переключиться на контейнеры Windows.

6. При использовании Docker Desktop измените каждую из следующих настроек:
   1. Щелкните правой кнопкой мыши кнопку Docker на панели задач и выберите Параметры. В разделе Общие установите флажок Предоставить демон на tcp://localhost:2375 без TLS.

      Вы будете использовать Docker Remote API, для которого требуется порт 2375.

   2. Щелкните правой кнопкой мыши кнопку Docker на панели задач и выберите Параметры. В меню Настройки щелкните Ресурсы > Файловое хранилище и добавьте директорию диска, которую будете использовать для хранилища конфигурации ArcGIS Notebook Server.

      Примечание:

      Docker для Windows поддерживает только локальные каталоги на Windows, которые должны публиковаться с контейнерами Linux.

7. Установите образ Notebooks, указав путь к нему. Образ должен быть заархивирован в формате .tar.gz. Если у вас лицензия Advanced и Docker Desktop, дважды запустите команду, чтобы установить образы контейнеров Standard и Advanced, загруженные с My Esri.

   Примечание:

   Убедитесь, что на компьютере имеется не менее 75 ГБ свободного места на диске.

   Запустите следующую команду: PostInstallUtility.bat -l <path of .tar.gz Docker image>

   Примечание:

   Убедитесь, что вы установили оба образа контейнера. Даже если у вас есть лицензия Advanced, вашим пользователям все равно может потребоваться среда выполнения Standard.

Установка и настройка образцов данных ArcGIS Notebook Server

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

Чтобы установить и настроить образцы данных, выполните следующие действия:

1. Запустите мастер установки образцов данных ArcGIS Notebook Server, загруженный с My Esri.

   Образцы данных устанавливаются в каталог, в котором установлен ArcGIS Notebook Server.

2. Откройте окно командной строки от имени администратора.
3. Перейдите в папку инструментов ArcGIS Notebook Server.

   По умолчанию это путь C:\Program Files\ArcGIS\NotebookServer\tools\postInstallUtility.

4. При необходимости обратитесь к справке утилиты, выполнив следующую команду:

    > PostInstallUtility.bat -h

5. Запустите утилиту после установки, чтобы извлечь образцы данных в каталог arcgisworkspace на сайте сервера блокнотов:

    PostInstallUtility.bat -x

Замена экземпляров ArcGIS Web Adaptor

Чтобы заменить экземпляры ArcGIS Web Adaptor, выполните следующие действия:

1. Отмените регистрацию предыдущего экземпляра ArcGIS Web Adaptor на вашем сайте и выполните деинсталляцию.
   1. Войдите в ArcGIS Notebook Server Administrator Directory.
   2. Выберите Система > Web Adaptors > зарегистрированный компьютер.
   3. Щелкните Отменить регистрацию Web Adaptor.
2. Установите новый экземпляр ArcGIS Web Adaptor 11.1 и настройте его с ArcGIS Notebook Server.
По окончании обновления развертывания вы сможете воспользоваться функционалом версии 11.1.
3. При обновлении с версии 10.8 или более ранней, чтобы разрешить использование расписания для блокнотов на вашем портале, выполните следующие действия:
   1. При необходимости обновите любую из своих пользовательских ролей, у которых есть права доступа к блокнотам, чтобы добавить новое право: Настройка расписаний блокнотов.
   2. Попросите авторов ваших записных книжек обновить среду выполнения каждого из своих блокнотов, если они хотят использовать расписание.

      Расписание работает только с блокнотами, использующими среду выполнения 10.8.1 (версия 4.0) или более новую.

Ваш сайт ArcGIS Notebook Server 11.1 готов к размещению ArcGIS Notebooks.