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

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

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

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

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

Примечание:

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

Примечание:

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

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

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

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

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

Подготовка к повышению версии

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

• Перед обновлением вы можете получить все необходимые файлы на сайте My Esri, в том числе к образам контейнеров 11.5.
• Чтобы ArcGIS Notebook Server корректно функционировал, его версия должна соответствовать версии портала, с которым он интегрирован.
• Если сервер блокнотов в настоящий момент доступен в режиме только для чтения, отключите этот режим перед началом процесса обновления.
• Обновите Docker до версии 28.0.1 или более поздняя.
• Чтобы обновить развертывание 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.
• Не удаляйте существующий ArcGIS Notebook Server. Установщики ArcGIS Notebook Server и командной строки предназначены для обнаружения и обновления существующей инсталляции компонентов ArcGIS Notebook Server.
• Не отменяйте интеграцию сайта ArcGIS Notebook Server с порталом и не удаляйте его сервера блокнотов портала во время процесса обновления. Это неблагоприятно скажется на существующих блокнотах, размещенных на портале.
• Обновление ArcGIS Notebook Server можно выполнить либо с помощью программы установки, либо из командной строки. Выберите один из методов обновления.
• Перед обновлением очистите кэш всех интернет-браузеров, используемых на компьютере ArcGIS Notebook Server.

Перемещение директории рабочей области

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

Примечание:

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

1. Войдите на ваш портал ArcGIS Enterprise с правами администратора и откройте ArcGIS Notebook Server Manager.
2. Перейдите на вкладку Настройки.
3. Щелкните Директории.
4. Определите, находится ли текущий путь к директории arcgisworkspace в директории установки ArcGIS Notebook Server.

   <installdir>/arcgis/notebook/directories/arcgisworkspace

   Если директория arcgisworkspace находится в директории установки ArcGIS Notebook Server, то перед обновлением необходимо переместить директорию рабочей области в какое-либо местоположение за пределами этой директории установки.

   Если директория arcgisworkspace не находится в директории установки ArcGIS Notebook Server, то выполнять остальные шаги этого раздела не требуется.

5. Щелкните Редактировать для директории arcgisworkspace.
6. Замените существующее значение пути к этой директории на новый путь к директории arcgisworkspace, который находится вне директории установки.

   <installdir>/arcgis/arcgisnotebookserver/directories/arcgisworkspace

7. Щелкните Сохранить.
8. Вручную скопируйте все содержимое из предыдущей директории arcgisworkspace в новую директорию arcgisworkspace.

Обновление расположения хранилища конфигураций

Этот процесс необходим для развертываний ArcGIS Notebook Server Linux, когда директория рабочей области находится в директории установки Notebook Server. Дополнительные сведения см. в разделе Определение местоположения хранилища конфигурации.

Примечание:

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

1. Войдите на ваш портал ArcGIS Enterprise с правами администратора и откройте ArcGIS Notebook Server Manager.
2. Перейдите на вкладку Настройки.
3. Щелкните Хранилище конфигураций.
4. Проверьте, находится ли хранилище конфигурации в каталоге установки Notebook Server.

   Пример директории: /installation_directory/arcgis/notebookserver/usr/config-store.

5. Если хранилище конфигурации находится в каталоге установки Notebook Server, переместите конфигурацию во внешнее хранилище, выполнив следующие действия:
   1. Обновите путь к новому местоположению.

      Пример директории: /installation_directory/arcgisnotebookserver/usr/config-store.

   2. Щелкните Да, чтобы переместить текущую конфигурацию.
   3. Щелкните Сохранить.

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

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

Примечание:

Вам не нужно выполнять этот шаг, если директория сервера уже находится за пределами каталога установки Notebook Server.

1. Войдите на ваш портал ArcGIS Enterprise с правами администратора и откройте ArcGIS Notebook Server Manager.
2. Перейдите на вкладку Настройки.
3. Щелкните Директории.
4. Проверьте, находятся ли директории arcgisoutput, arcgisjobs и arcgissystem в директории установки.

   /installation_directory/arcgis/notebookserver/usr/directories

5. Если они расположены в директории установки, выполните следующие действия для каждой директории.
   1. Выберите Редактировать.
   2. Обновите путь к новому местоположению.

      Пример директории: /installation_directory/arcgisnotebookserver/usr/directories/<server directory>.

   3. Щелкните Сохранить.

Обновление директории журналов

Этот процесс необходим для развертываний ArcGIS Notebook Server Linux, когда директория журналов находится в директории установки Notebook Server.

Примечание:

Вам не нужно выполнять этот шаг, если директория журналов уже находится за пределами директории установки Notebook Server.

1. Войдите на ваш портал ArcGIS Enterprise с правами администратора и откройте ArcGIS Notebook Server Manager.
2. Перейдите на вкладку Настройки.
3. Щелкните Журналы.
4. Проверьте, находится ли директория журналов в директории установки.

   /installation_directory/arcgis/notebookserver/usr/directories

5. Если она находится в директории установки, выполните следующие действия, чтобы переместить ее во внешнее расположение.
   1. Обновите путь к новому местоположению.

      Пример директории: /installation_directory/arcgisnotebookserver/logs.директории

   2. Щелкните Сохранить.
   3. Вручную скопируйте все содержимое из старой директории журналов в новое расположение.

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

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

См. Резервное копирование и восстановление ArcGIS Notebook Server для получения дополнительной информации.

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

Обновите свой механизм контейнера до поддерживаемой версии.

Примечание:

На сайте Notebook Server с несколькими компьютерами выполните этот шаг на каждом компьютере.

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

Примечание:

Используйте установочный файл для обновления ArcGIS Notebook Server до версии 11.5. После обновления установки следует обновить сайт 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.5. Для этого используйте Мастер авторизации программного обеспечения.
3. Откройте мастер конфигурации, используя URL-адрес, который приводится по окончании обновления версии этой установки, и следуйте инструкциям на экране, чтобы обновить сайт.
4. Если ваш сайт состоит из нескольких компьютеров, выполните шаги с 1 по 3 на всех компьютерах сайта.

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

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

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

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

   <untar directory>/Setup -l yes -m silent

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

   <ArcGIS Notebook Server install directory>/tools/authorizeSoftware

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

   <ArcGIS Notebook Server install directory>/tools/authorizeSoftware --help

   Примечание:

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

3. Обновите сайт с помощью утилиты командной строки upgradesite.

   У утилиты есть два параметра:

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

   По умолчанию утилита upgradesite доступна в ${HOME}/arcgis/notebookserver/tools/upgradesiteutility/upgradesite.sh.

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

   > ./upgradesite.sh -s

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

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

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

После завершения работы утилиты обновления необходима повторная авторизация программного обеспечения ArcGIS Notebook Server для версии 11.5.

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

<ArcGIS Notebook Server install directory>/tools/authorizeSoftware

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

<ArcGIS Notebook Server install directory>/tools/authorizeSoftware --help

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

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

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

   <ArcGIS Notebook Server installation directory>/tools/authorizeSoftware -f <full path to the .prvc file> -o <full path to authorization file output>

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

   <ArcGIS Notebook Server installation directory>/tools/authorizeSoftware -f <full path to the .ecp file>

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

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

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

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

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

1. Откройте терминал, используя учетную запись установки ArcGIS Notebook Server.
2. Измените директорию на папку инструментов ArcGIS Notebook Server. По умолчанию это путь ${HOME}/arcgis/notebookserver/tools/postInstallUtility.
3. При необходимости обратитесь к справке утилиты, выполнив следующую команду: ./PostInstallUtility.sh -h
4. ArcGIS Notebook Server требует, чтобы на вашем компьютере был установлен Docker Engine Community Edition. Определите, активен ли на вашем компьютере Docker, выполнив следующую команду: ./PostInstallUtility.sh -d
5. Если требования установки Docker не выполнены, установите его сейчас.
6. Установите образ Notebooks, указав путь к нему. Образ должен быть заархивирован в формате .tar.gz. Если у вас лицензия Advanced и Docker Desktop, дважды запустите команду, чтобы установить образы контейнеров Standard и Advanced, загруженные с My Esri.

   Примечание:

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

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

   Примечание:

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

Примечание:

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

Замена экземпляров 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.5 и настройте его с ArcGIS Notebook Server.
По окончании обновления развертывания вы сможете использовать функциональность 11.5.
3. При обновлении с версии 10.8 или более ранней, чтобы разрешить использование расписания для блокнотов на вашем портале, выполните следующие действия:
   1. При необходимости обновите все пользовательские роли с правами доступа к блокнотам, чтобы добавить новое право доступа - Настройка расписаний блокнотов.
   2. Проинструктируйте авторов блокнотов обновлять рабочую среду блокнотов перед тем, как они будут использовать функцию настройки расписаний.

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

Теперь сайт ArcGIS Notebook Server 11.5 готов к работе с ArcGIS Notebooks.

Обновление сред выполнения существующих блокнотов и веб-инструментов

Этот процесс должен быть выполнен каждым автором для обновления своих блокнотов и веб-инструментов блокнотов для использования последних версий сред.

1. Выполните действия, описанные в разделе Изменение среды выполнения блокнота, чтобы обновить среду выполнения каждого элемента блокнота до последней версии среды выполнения.
2. Если блокнот опубликован как веб-инструмент, перезапишите веб-инструмент после обновления среды выполнения блокнота.
3. Если в некоторых блокнотах применялись пользовательские среды выполнения, обновите пользовательскую среду выполнения и обновите настройки среды выполнения для связанных элементов блокнота.

Удаление предыдущих сред выполнения блокнотов

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

Внимание:

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

1. Откройте командное окно от имени администратора.
2. Введите следующую команду, чтобы просмотреть список ваших текущих образов и запомните IMAGE ID предыдущей версии, которую вы хотите удалить.

   docker images -a

3. Введите следующую команду, чтобы удалить предыдущую версию среды выполнения.
   docker image rm <IMAGE ID>