Обновление Portal for ArcGIS

Настройка Portal for ArcGIS предназначена для обнаружения и обновления существующей установки Portal for ArcGIS. Вы можете выбрать интерактивное обновление через программу установки или в автоматическом режиме.

Важно:

Перед обновлением внимательно ознакомьтесь с общей информацией по обновлению ArcGIS Enterprise, а также со следующей информацией, касающейся Portal for ArcGIS.

[!CAUTION]Ваша база, её сайты интегрированных серверов и ArcGIS Pro (если лицензированы через портал) будут отключены во время обновления.

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

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

Резервное копирование ресурсов

Сделайте резервную копию данных и конфигурации вашего развертывания ArcGIS Enterprise перед обновлением Portal for ArcGIS. Чтобы обеспечить необходимые резервные копии, выполните следующие действия:

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

   Подсказка:

   Вы можете воспользоваться приведенными ниже действиями для создания резервной копии своего сайта или использовать инструмент WebGISDR для создания резервной копии развертывания ArcGIS Enterprise. Для этого выполните действия по экспорту ArcGIS Enterprise.

   • Все хранилища данных развертываются через ArcGIS Data Store. См. Обновление хранилища данных ArcGIS для получения подробной информации о запуске резервного копирования.

   • Все сайты с интегрированным ArcGIS Server. Чтобы можно было вернуться к предыдущей версии, импортируйте и восстановите сайт. См. раздел Резервное копирование и восстановление конфигурации сайта ArcGIS Server для получения дополнительной информации.

2. Определите объем дискового пространства, выделенный для директорий портала content, index, db и temp. Проверьте, чтобы свободное место на диска в 2.5 раза превышало этот объем. Если нет, выделите на диске объем в 2.5 раза больше занятого директориями пространства.

   При обновлении Portal for ArcGIS это пространство потребуется для резервного копирования и обновления ресурсов портала, информации о сайте и параметров безопасности. По умолчанию расположение этих каталогов — <Portal for ArcGIS installation directory>/arcgisportal. Те же рекомендации действуют если директория ресурсов находится на другом компьютере.

   При обновлении Portal for ArcGIS это пространство потребуется для резервного копирования и обновления ресурсов портала, информации о сайте и параметров безопасности. По умолчанию расположение этих каталогов — C:\arcgisportal. Те же рекомендации действуют если директория ресурсов находится на другом компьютере.

Концепции обновления

При обновлении помните следующее:

• Время, необходимое для выполнения процесса обновления, зависит от объема ресурсов на портале, от количества зарегистрированных учетных записей и от количества развертываемых компонентов и настроек.

• Убедитесь, что сотрудники вашей организации осведомлены о том, что обновление требует простоя, и готовы к новым функциям и изменениям, которые будут введены в новой версии.

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

• Если вы не можете обновить текущий web adaptor, вы можете установить обновленную версию ArcGIS Web Adaptor (IIS) на том же компьютере вместе с предыдущей версией. При обновлении необходимо сохранить такой же контекст web adaptor. Для этого удалите web adaptor, который в настоящий момент настроен на портале, затем удалите новую версию web adaptor с тем же именем, который использовался ранее. Имейте в виду, что два web adaptor с одинаковым контекстом нельзя установить на одном компьютере.

Примечание:

Программа установки Portal for ArcGIS запрашивает учетную запись, под которой будет работать служба Windows. Вы можете обновить существующие ресурсы, расположенные на общем сетевом ресурсе, при условии, что эти местоположения доступны для учетной записи, под которой работает служба Windows.

Если служба Windows запущена с учетной записью LocalSystem без пароля, перед обновлением измените учетную запись на локальную с паролем.

Лицензирование

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

• Вам необходимо получить новый файл лицензии портала от My Esri и повторно авторизовать программное обеспечение.

  Примечание:

  Файл лицензии, введенный во время обновления, будет использоваться для лицензирования пользователей и приложений портала. Убедитесь, что новый файл лицензии соответствует текущей конфигурации пользователя и приложения.

• Перед обновлением Portal for ArcGIS убедитесь, что все автономные лицензии ArcGIS Pro зарегистрированы участниками вашей организации. Вы можете просмотреть действия с лицензиями, чтобы узнать, какие пользователи открепили свои лицензии ArcGIS Pro для использования в автономном режиме. Информацию о том, как зарегистрировать автономную лицензию, см. в разделе Прикрепление автономной лицензии.

• Имена пользователей Editor, GIS Professional Standard и GIS Professional Advanced, использовавшиеся в некоторых предыдущих версиях, были изменены на Contributor, Professional и Professional Plus, соответственно. Вы можете заметить это обновление при импорте нового файла лицензии Portal for ArcGIS.

• Если тип пользователя участника больше недоступен после обновления, вам необходимо назначить ему другой тип пользователя. Список доступных типов пользователей см. в разделе Типы пользователей.

• После обновления некоторые типы пользователей могут получить доступ к дополнительным приложениям, которые ранее были доступны только в виде дополнительных лицензий. Если какое-либо приложение включено в назначенный участнику тип пользователя, предоставлять ему дополнительную лицензию на это приложение не требуется. Дополнительные сведения о приложениях и типах пользователей, в которые они входят, см. в разделе Введение в лицензирование приложений.

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

• Начиная с версии 11.4, ArcGIS License Manager больше не нужен для включения лицензий именованного пользователя для ArcGIS Pro, дополнительных модулей ArcGIS Pro, ArcGIS Drone2Map и ArcGIS AllSource.

Содержание

При работе с ресурсами нужно учитывать следующее:

• Если на портале зарегистрированы элементы с неинтегрированного сайта ArcGIS Server, то вам не нужно обновлять этот сайт ArcGIS Server, чтобы использовать сервисы этого сайта на своем портале. Сервисы из предыдущих версий ArcGIS Server могут использоваться Portal for ArcGIS.

• Если вы создали пользовательскую базовую карту или группу настраиваемых приложений и предоставили доступ к базовым картам Esri или ArcGIS Configurable Apps для этой группы, вы должны опубликовать эти элементы для группы после обновления.

• Если в картах и приложениях используются ресурсы ArcGIS Living Atlas of the World, перед обновлением убедитесь в том, что для используемых элементов доступна поддержка, и они не устарели. В каждом выпуске некоторые ресурсы ArcGIS Living Atlas удаляются и становятся недоступными. Если вы используете такой элемент, после обновления он не будет работать. Список ресурсов ArcGIS Living Atlas, которые были удалены в этой версии, см. в разделе Жизненные циклы и обновления ресурсов ArcGIS Living Atlas.

Приложения

При работе с приложениями нужно учитывать следующее:

• Если у вас есть настроенные на портале приложения Esri, убедитесь, что используемая версия совместима с версией Portal for ArcGIS после обновления.

• Если у вас на портале настроены пакеты мобильных карт ArcGIS Navigator, вы должны перенастроить их после обновления Portal for ArcGIS.

Отказоустойчивые и реплицируемые среды

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

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

1. Из командной строки запустите скрипт установки Portal for ArcGIS от имени того же пользователя, который устанавливал существующий портал, (например, <CD ROOT or untar directory>/Setup).

   Вам не нужно останавливать Portal for ArcGIS перед запуском этого скрипта.

   Подсказка:

   Чтобы запустить скрипт установки с установочного диска Portal for ArcGIS, щелкните скрипт и выберите кнопку Запустить в окне терминала.

2. Выберите продолжить или выйти из обновления после того, как установка обнаружит существующую версию Portal for ArcGIS на целевом компьютере. См. пример ниже:

   =========================================================================
   Portal for ArcGIS <New Version> (Linux)
   =========================================================================
   Your Portal for ArcGIS <Previous Version> is installed at:
   /home/ags/arcgis/portal
   Confirm Settings
   =========================================================================
   Product to upgrade:             Portal for ArcGIS <Previous Version> (Linux)
   Location to upgrade:            /home/ags/arcgis/portal
   Your Portal for ArcGIS <Previous Version> will be stopped when performing the
   upgrade and Portal for ArcGIS <New Version>
   will be started after the upgrade completes.
     'y' to continue with these settings
     'q' to exit without upgrading this product
   Enter choice [y,q] (y):
   

3. Введите y и нажмите Enter, чтобы принять заданные параметры и продолжить обновление.

   Вам потребуется авторизовать ПО с использованием нового файла авторизации .json. По окончании обновления Portal for ArcGIS веб-сайт портала откроется в окне браузера.

4. Запустите программу установки Portal for ArcGIS Setup.exe и прочитайте приветственный экран и условия. Когда вы будете готовы продолжить установку, щелкните Далее.

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

   Отображаются устанавливаемые компоненты.

6. ЩелкнитеУстановить, чтобы начать обновление. Не прерывайте процесс установки.

   Примечание:

   Он может занять некоторое время.

7. Щелкните Завершить, чтобы закрыть мастер установки.

   Веб-сайт портала откроется в окне браузера.

8. Очистите кэш браузера (включая файлы cookies).

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

9. На странице Импорт файла лицензии откройте файл лицензии .json , который вы получили от My Esri, содержащий авторизованные типы пользователей и приложения. Нажмите Продолжить обновление портала.

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

   Примечание:

   Файл лицензии, введенный во время обновления, будет использоваться для лицензирования пользователей и приложений портала. Убедитесь, что новый файл лицензии соответствует текущей конфигурации пользователя и приложения.

10. Войдите в компьютер, на котором размещается ArcGIS Web Adaptor, который вы используете со своим порталом, и удалите ArcGIS Web Adaptor. Подробные инструкции см. в статье о деинсталляции Java (Linux). Убедитесь, что вы записали имя web adaptor перед его удалением.

11. Установите веб-адаптер, который будет использоваться с вашим порталом. Подробные инструкции см. в статье об установке Java (Linux). Убедитесь, что вы используете то же имя web adaptor, что и в предыдущей версии.

12. Настройте ArcGIS Web Adaptor для своего портала. Подробные инструкции см. в разделе по настройке Java (Linux).

    Примечание:

    Псевдоним DNS, если он присутствует, следует использовать для доступа к web adapter при повторной регистрации на портале, если в Свойствах системы не задан WebContextURL.

13. Войдите в компьютер, на котором размещается ArcGIS Web Adaptor, используемый с вашим порталом, и удалите ArcGIS Web Adaptor. Подробные инструкции см. в статье о деинсталляции IIS или Java (Windows). Убедитесь, что вы записали имя web adaptor перед его удалением.

14. Установите веб-адаптер, который будет использоваться с вашим порталом. Подробные инструкции см. в статье об установке IIS или Java (Windows). Убедитесь, что вы используете то же имя web adaptor, что и в предыдущей версии.

15. Настройте ArcGIS Web Adaptor для своего портала. Подробные инструкции см. в разделе по настройке IIS или Java (Windows).

    Примечание:

    Псевдоним DNS, если он присутствует, следует использовать для доступа к web adapter при повторной регистрации на портале, если в Свойствах системы не задан WebContextURL.

16. Убедитесь, что вы можете войти на портал, используя URL-адрес ArcGIS Web Adaptor и учетную запись администратора организации.

    Адрес URL имеет формат https://webadaptorhost.example.com/webadaptorname/home.

    Примечание:

    • Если появляется уведомление о необходимости выполнения дополнительных шагов после обновления, вы должны нажать кнопку OK в диалоговом окне сообщения, чтобы выполнить требуемые после обновления шаги. К ним относятся обновление переиндексированных ресурсов (ручная переиндексация требуется после каждого обновления, если ресурсы находятся в бакете Amazon S3 или Azure Blob Storage) и обновление связи между компьютерами Portal for ArcGIS в отказоустойчивом портале.

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

17. Обновите остальные компоненты ArcGIS Enterprise.

Обновление в автоматическом режиме

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

1. Из командной строки запустите скрипт установки Portal for ArcGIS от того же пользователя, который применялся для установки существующего портала

   Следующий пример предоставляет скрипту аргументы, необходимые для автоматического обновления Portal для ArcGIS.

   <CD ROOT or untar directory>/Setup -l yes -m silent
   

   Для полного объяснения аргументов, которые можно использовать в скрипте установки, см. раздел Установка Portal for ArcGIS в автоматическом режиме на Linux

2. Из командной строки запустите скрипт установки Portal for ArcGIS.

   В следующем примере используется учетная запись Portal для ArcGIS, используемая программным обеспечением, admin а пароль — itsasecret.

   <path to Portal for ArcGIS setup download>\setup.exe /qb USER_NAME=admin PASSWORD=itsasecret ACCEPTEULA=yes

   Для полного объяснения аргументов, которые можно использовать со скриптом установки, см. раздел Установка Portal for ArcGIS в автоматическом режиме

3. Используйте утилиту командной строки upgradeportal для обновления в автоматическом режиме и выполнения операций после установки.

   1. В командной строке зайдите в папку <Portal install directory>/tools/upgradeportal.

   2. В командной строке зайдите в папку <Portal install directory>\tools\upgradeportal.

   3. Запустите следующую команду:

      upgradeportal.sh -lf <path to portal json file> -s

      upgradeportal.bat -lf <path to portal json file> -s

      Для помощи запустите команду с -h или --help. Также можно использовать операцию обновления в ArcGIS Portal Administrator API для обновления Portal for ArcGIS. Дополнительные сведения см. в разделе Обновление документации в справке по ArcGIS Portal Admin API.

Задачи после обновления

После обновления Portal for ArcGIS вам, возможно, потребуется выполнить следующие задачи после обновления, чтобы обеспечить правильную работу своего развертывания.

Обновление файлов свойств WebGISDR, созданных до обновления

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

Если файл свойств содержит зашифрованные значения, замените их на незашифрованные значения и установите соответствующие булевы значения, указывающие на то, зашифровано ли свойство в false.

Дополнительные сведения см. в разделе Файл свойств инструмента WebGISDR.

Ручное обновление служебных сервисов

Если вы используете служебные сервисы OfflinePackaging, RasterUtilities или GeocodingTools, вы должны вручную обновить их после выполнения обновления версии:

1. По завершении обновления войдите в ArcGIS Server Manager как пользователь - владелец этих служебных сервисов.

2. В разделе Управление сервисами на вкладке Сервисы щелкните папку Утилиты.

3. Нажмите на кнопку Свойства публикации .

4. В открывшемся диалоговом окне нажмите Сохранить.

   Это обновит сервис на вашем портале.

5. Войдите на портал как администратор. На вкладке Ресурсы найдите сервис, который вы обновили. Щёлкните Опубликовать. Измените опции публикации, если требуется, и нажмите OK.

   Это обновит сервис для каждой группы, для которой он опубликован.

6. Повторите шаги для каждого сервиса.

Настройка сервисов маршрутизации

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

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

1. Войдите под учетной записью администратора по умолчанию или участника с пользовательской ролью, имеющей права на управление настройками портала.

2. Щелкните Организация вверху сайта, затем выберите Настройки.

3. Щелкните Служебные сервисы в левой части страницы.

4. Щелкните Путевые листы и маршрутизация в правой части страницы.

5. Щелкните Обновление сервисов маршрутизации и выберите Сетевой набор данных, который я хочу опубликовать.

6. Выполните описанные здесь шаги в Настройке сервисов маршрутизации, чтобы настроить сервисы маршрутизации с использованием сетевого набора данных.

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

Проблемы с устранением неполадок после обновления

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

Примечание:

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

После обновления портал отображается некорректно или не позволяет выполнить вход в

Очистите кэш браузера (включая файлы cookies). Обычно эти ошибки возникают в связи с тем, что в кэше браузера осталась информация из предыдущей версии веб-сайта. Если вы до сих пор не можете войти, убедитесь, что вы используете учетную запись основного администратора или учетную запись, которая имеет права доступа администратора портала. Если карточки на вкладке Обзор организации не загружаются, импортируйте файл лицензии портала (.json). Файл лицензии можно импортировать через Portal Administrator Directory с помощью URL-адреса https://portal.example.com:7443/arcgis/portaladmin/license/importLicense. Убедитесь, что это правильный файл лицензии для портала. При импорте нового файла лицензий все типы пользователей и лицензии приложений в вашей организации будут перезаписаны новым файлом лицензий.

Элементы, группы и пользователи на портале не отображаются

После установки ПО и указания учетной записи основного администратора запускается переиндексация портала. Если переиндексация выполнена не полностью, то вы можете не видеть свои элементы, группы и пользователей. Для завершения процесса переиндексации потребуется некоторое время, которое будет зависеть от количества пользователей и объема ресурсов в вашей организации. Например, для небольшой организации (несколько сотен пользователей и элементов ресурсов), где Portal for ArcGIS работает на 8-ядерном компьютере, процесс переиндексации займет порядка 15 минут. А для большой организации (десятки тысяч пользователей и элементов ресурсов), где Portal for ArcGIS работает на 8-ядерном компьютере, процесс переиндексации может занять более 3 часов.

Проверка состояния переиндексации

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

1. Откройте Portal Administrator API и войдите под первичной учетной записью администратора.

   URL-адрес имеет формат https://portal.example.com:7443/arcgis/portaladmin.

2. Нажмите Система > Индексатор > Статус индекса.

3. Обновить страницу, чтобы увидеть последний статус.

Ресурсы ArcGIS Living Atlas больше недоступны

Если слой ArcGIS Living Atlas недоступен в ресурсах вашей организации после обновления, возможно, что этот элемент будет выведен из эксплуатации после этого релиза. Поставьте отметку Жизненный цикл и обновление ресурсов ArcGIS Living Atlas для получения обновленного списка устаревших элементов.

Если ресурсы подписки или премиум-ресурсы не получается открыть после обновления, убедитесь, что учетная запись ArcGIS Online, используемая при настройке портала для доступа к этим ресурсам, по-прежнему действительна. Если нет, вы должны выполнить дополнительные действия для обновления этой учетной записи и ресурса ArcGIS Living Atlas.

Количество выданных лицензий превышает количество доступных лицензий

Уведомление Количество назначенных лицензий превышает количество доступных лицензий. Участники, получившие эти лицензии, могут столкнуться с проблемой невозможности входа на портал. Для получения более подробной информации перейдите в раздел Лицензии. отображается для администраторов, если при входе на портал лицензирование портала перерасходовано. Число пользователей, которым назначен тип пользователя или дана дополнительная лицензия, превышает число доступных лицензий.

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

Участникам лицензии были назначены дважды

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

Ошибка создания учетной записи основного администратора

Если эта ошибка получена при создании учетной записи основного администратора, то помочь устранить ее может информация, которая имеется в журналах портала. Эта ошибка часто возникает по причине временной потери подключения к интернету при создании учетной записи. Чтобы получить доступ к журналам, перейдите в каталог журналов и откройте самый свежий файл журнала (например, <Portal for ArcGIS installation directory>/arcgisportal/logs/<machine name>/portal/portal-20141201.095803-8596-0.0.log). Если необходимо, вы можете передать эту информацию в Службу технической поддержки Esri.

Если вы возвращаетесь к предыдущему развертыванию, скопируйте все файлы журнала перед возвратом, чтобы облегчить устранение неполадок. Чтобы получить доступ к журналам, перейдите в директорию журналов (например, <Portal for ArcGIS installation directory>/arcgisportal/logs/).

Если эта ошибка получена при создании учетной записи основного администратора, то помочь устранить ее может информация, которая имеется в журналах портала. Эта ошибка часто возникает по причине временной потери подключения к интернету при создании учетной записи. Чтобы получить доступ к журналам, перейдите в каталог журналов и откройте самый свежий файл журнала (например, C:\arcgisportal\logs\<machine name>\portal\portal-20141201.095803-8596-0.0.log). Если необходимо, вы можете передать эту информацию в Службу технической поддержки Esri.

Если вы возвращаетесь к предыдущему развертыванию, скопируйте все файлы журнала перед возвратом, чтобы облегчить устранение неполадок. Чтобы получить доступ к журналам, перейдите в директорию журналов (например, C:\arcgisportal\logs\).