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

Как обновить Apigee Edge 4.52.02 или 4.53.00 до версии 4.53.01

Apigee поддерживает обновление Edge для частного облака непосредственно с версии 4.52.02 или 4.53.00 до версии 4.53.01. В этой статье рассказывается, как это сделать.

Обзор совместимых путей обновления можно найти в матрице совместимости обновлений для версий Edge для частного облака.

Внимание! Поскольку Edge for Private Cloud 4.53.01 включает в себя значительное обновление версии Cassandra, не рекомендуется выполнять это обновление по одному центру обработки данных за раз. Шаги по обновлению, перечисленные в этом документе, и утверждения (например, об отсутствии влияния на трафик прокси-сервера во время выполнения) основаны на предположении, что шаги по обновлению выполняются в соответствии с документацией: сначала завершите обновление кластера Cassandra во всех центрах обработки данных, а затем обновите узлы приложений, такие как edge-management-server, edge-message-processor и т. д.

Кто может выполнить обновление

Обновление должен выполнять тот же пользователь, который изначально установил Edge, или пользователь с правами root.

После установки пакетов RPM Edge их может настроить любой пользователь.

Какие компоненты нужно обновить

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

Требования к обновлению

Изменения в Edge для частного облака 4.53.01

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

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

Создайте резервную копию всех узлов
Перед обновлением мы рекомендуем создать полную резервную копию всех узлов в целях безопасности. Чтобы создать резервную копию, следуйте инструкциям для вашей версии Edge.
Это позволит вам иметь резервный план на случай, если обновление до новой версии не будет работать должным образом. Подробнее о резервном копировании и восстановлении…
Убедитесь, что Edge работает
Убедитесь, что Edge работает во время обновления, с помощью следующей команды:
```
/opt/apigee/apigee-service/bin/apigee-all status
```
Проверьте требования Cassandra

Если вы ранее выполнили обновление с более ранней версии Edge для частного облака до версии 4.52.02 и теперь планируете перейти на версию 4.53.01, убедитесь, что вы выполнили необходимые действия после обновления для Cassandra. Эти шаги описаны в документации по обновлению до версии 4.52.02, а также в разделе Предварительные условия для обновления Cassandra. Если вы не уверены, были ли выполнены эти шаги во время предыдущего обновления, выполните их ещё раз, прежде чем переходить к версии 4.53.01.
Настройка ключей и сертификатов поставщика идентификационной информации в Edge для частного облака 4.53.01

В Edge для частного облака 4.53.01 ключи и сертификаты поставщика идентификационной информации, используемые в компоненте apigee-sso, теперь настраиваются через хранилище ключей. Вам нужно будет экспортировать ключ и сертификат, которые вы использовали ранее, в хранилище ключей. Подробные инструкции по обновлению компонента SSO приведены в разделе Как обновить Apigee SSO с более ранних версий.
Требования к Python
Перед обновлением убедитесь, что на всех узлах, включая узлы Cassandra, установлен Python 3.

Что нужно учитывать при переходе на новую версию

Чтобы перейти на Edge для частного облака 4.53.01, выполните определенные действия по обновлению ПО. Необходимые действия зависят от текущей версии. В таблице ниже перечислены программы, для которых требуются дополнительные действия. Следуйте подробным инструкциям для каждой из них. После выполнения необходимых задач вернитесь к основной процедуре обновления, чтобы продолжить процесс.

Текущая версия	Программное обеспечение, для обновления которого до версии 4.53.01 требуются специальные действия
4.52.02	LDAP, Cassandra, Zookeeper, Postgres
4.53.00	LDAP, Zookeeper, Postgres

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

Автоматическое распространение настроек ресурса

Если вы задали какие-либо свойства, отредактировав файлы .properties в /opt/apigee/customer/application, то эти значения сохранятся после обновления.

Обязательное обновление до OpenLDAP 2.6

Ниже приведены пошаговые инструкции по обновлению базового сервиса LDAP Apigee Edge для частного облака с устаревшей версии OpenLDAP 2.4 до OpenLDAP 2.6. Это обновление обязательно для перехода на Apigee Edge для частного облака версии 4.53.01 и более поздних. Это обновление применимо ко всем топологиям развертывания LDAP Apigee: односерверной, активной и пассивной, а также активной и активной (с несколькими основными серверами).

Требования и рекомендации

Обратите внимание, что во время обновления LDAP API управления и, следовательно, интерфейс Apigee будут полностью недоступны во всех регионах. Все административные задачи, такие как управление пользователями, ролями, приложениями и организациями, будут завершаться с ошибкой. Их следует приостановить. Это не повлияет на обработку трафика прокси-сервера API. Перед тем как продолжить обновление LDAP, убедитесь, что все серверы управления периферией и интерфейс Edge выключены.
Резервная копия имеет решающее значение. Полная и проверенная резервная копия существующих данных LDAP обязательна. Если продолжить без резервной копии, данные будут утеряны безвозвратно. Чтобы получить согласованный моментальный снимок данных LDAP, резервное копирование необходимо запустить, пока сервис LDAP ещё работает. Резервная копия необходима для обновления. Без резервной копии вы не сможете ни выполнить обновление, ни вернуться к предыдущей версии, поскольку в процессе обновления данные LDAP будут удалены.

Подготовка и установка (для всех LDAP-серверов)

Шаги, описанные в этом разделе (шаги 2–5), одинаковы для всех топологий развертывания LDAP. Эти действия необходимо выполнить на каждом сервере, на котором установлен компонент apigee-openldap, независимо от его роли.

Прежде чем продолжить обновление LDAP, убедитесь, что все edge-management-server и edge-ui отключены.
```
apigee-service edge-management-server stop
apigee-service edge-ui stop
```
Как создать резервную копию существующих данных LDAP

Прежде чем вносить какие-либо изменения, создайте полную резервную копию текущих данных LDAP со всех серверов LDAP. Это позволит создать безопасную точку восстановления.
- Выполните команду резервного копирования. В каталоге /opt/apigee/backup/openldap будет создан архив резервной копии с временной меткой.
```
apigee-service apigee-openldap backup
```
- Получить общее количество записей. Запишите количество записей в каталоге для проверки после обновления (количество записей должно совпадать на всех серверах LDAP). Это проверка на адекватность.
```
# Note: Replace 'YOUR_PASSWORD' with your current LDAP manager password.
ldapsearch -o ldif-wrap=no -b "dc=apigee,dc=com" \
-D "cn=manager,dc=apigee,dc=com" -H ldap://:10389 -LLL -x -w 'YOUR_PASSWORD' | wc -l
```
Как остановить LDAP и очистить каталоги данных

Это действие необходимо выполнить на всех LDAP-серверах. Это необходимо из-за изменения основной версии и структурных различий. Чистый каталог гарантирует отсутствие конфликтов. Когда все серверы LDAP будут остановлены, начнутся сбои в работе API управления и интерфейса.
- Остановите сервис LDAP.
```
apigee-service apigee-openldap stop
```
- Безвозвратно удалите старые каталоги данных и конфигурации LDAP.
```
rm -rf /opt/apigee/data/apigee-openldap/*
```
Как установить и настроить новую версию LDAP

На всех серверах LDAP используйте стандартные скрипты Apigee, чтобы скачать и установить новую версию компонента.
- Установите новый компонент LDAP. Скрипт обновления считывает файл конфигурации и устанавливает новый пакет apigee-openldap.
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f /opt/silent.conf
```
- Проверьте новую версию LDAP. После завершения установки перезагрузите профиль и убедитесь, что новая версия LDAP установлена правильно.
```
source ~/.bash_profile
ldapsearch -VV
Expected output:
ldapsearch: @(#) $OpenLDAP: ldapsearch 2.6.7
```
Остановите LDAP на всех серверах до восстановления данных

Это важный шаг синхронизации. Прежде чем восстанавливать резервную копию, убедитесь, что на всех серверах остановлена недавно установленная служба LDAP. На каждом сервере LDAP выполните следующие команды:
```
apigee-service apigee-openldap stop
rm -rf /opt/apigee/data/apigee-openldap/ldap/*
```
Как восстановить данные LDAP

Стратегия заключается в том, чтобы восстановить резервную копию на первом активном сервере. Этот сервер будет источником достоверных данных, реплицируя их на другие серверы в многосерверной конфигурации.
1. Как определить первый активный сервер для восстановления
  - Для конфигурации с одним сервером это единственный сервер LDAP. Вы можете перейти к следующему шагу.
  - Для конфигураций "активный-пассивный" и "активный-активный": выполните следующую диагностическую команду на каждом сервере LDAP:
```
grep -i '^olcSyncrepl:' /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase*\ldif
Note:
-If this command returns output, the server is a passive server.
-If it returns no output, the server is the active server.
```
2. Как восстановить данные из резервной копии
  
  Прежде чем продолжить, убедитесь, что шаг 5 успешно выполнен на всех серверах LDAP.
  - На первом активном сервере, который вы определили выше, перейдите в каталог резервных копий.
```
cd /opt/apigee/backup/openldap
```
  - Выполните команду restore. Чтобы избежать восстановления не той или более старой версии, настоятельно рекомендуем указать точную временную метку резервной копии из шага 2.
```
# To restore a specific backup (recommended):
apigee-service apigee-openldap restore 2025.08.11,23.34.00

# To restore the latest available backup by default:
apigee-service apigee-openldap restore
```
  - После успешного завершения процесса восстановления запустите службу LDAP на первом активном сервере.
```
apigee-service apigee-openldap start
```
Запустите оставшиеся серверы LDAP

Если у вас настроено несколько серверов, запустите службу на каждом из них:
```
apigee-service apigee-openldap start
```
Примечание. Восстанавливать данные на этих серверах вручную не нужно. При запуске они подключатся к первому серверу (на котором теперь хранятся восстановленные данные) и автоматически синхронизируют весь каталог с помощью репликации.
Финальная проверка

На последнем этапе нужно убедиться, что обновление прошло успешно и данные в кластере LDAP согласованы.
- Выполните команду проверки на всех серверах LDAP. Количество записей должно быть одинаковым на всех серверах и соответствовать количеству, полученному на шаге 2.
- После того как вы убедитесь, что данные верны и согласованы, обновление LDAP будет завершено. Теперь вы можете запустить edge-management-server, edge-ui и другие зависимые компоненты в соответствии со стандартной процедурой обновления вашей организации.

Требуется обновление до Cassandra 4.0.18

Apigee Edge для частного облака 4.53.01 включает обновление Cassandra до версии 4.0.18.

Обновления и откат

Переход с Cassandra 3.11.X на Cassandra 4.0.X – простой процесс. Cassandra 4.0.X, выпущенная с Edge для частного облака 4.53.00, совместима с компонентами среды выполнения и управления частного облака 4.52.02.
Прямой откат с Cassandra 4.0.X до 3.11.X невозможен. Восстановление с помощью реплик или резервных копий – сложная процедура, которая может привести к простою и/или потере данных. Устранение неполадок и обновление до Cassandra 4.0.X предпочтительнее отката.
Перед обновлением ознакомьтесь с процедурами отката. При переходе на новую версию важно учитывать нюансы отката, чтобы обеспечить его возможность.

Один центр обработки данных

Переход с версии 3.11.X на 4.0.X в пределах одного центра обработки данных выполняется без проблем, но откат на предыдущую версию сложен и может привести к простою и потере данных. Для рабочих нагрузок настоятельно рекомендуется добавить новый центр обработки данных с хотя бы одним узлом Cassandra, доступным в новом центре обработки данных, прежде чем начинать обновление. Это позволит выполнить откат Cassandra без потери данных и перебоев в работе API. Этот дополнительный центр обработки данных можно будет отключить после завершения обновления или достижения контрольной точки 2.

Если добавить новый центр обработки данных невозможно, но вам нужна возможность отката, для восстановления Cassandra 3.11.X потребуются резервные копии. Однако этот метод, скорее всего, приведет к простою и потере данных.

Несколько центров обработки данных

Использование нескольких центров обработки данных с Edge для частного облака 4.52.02 обеспечивает большую гибкость при откате во время обновления до Edge для частного облака 4.53.00.

Для отката требуется, чтобы хотя бы один центр обработки данных работал с более старой версией Cassandra (3.11.X).
Если весь кластер Cassandra обновлен до версии 4.0.X, вы не сможете выполнить откат до версии 3.11.X. Продолжайте использовать более новую версию Cassandra с другими компонентами Private Cloud 4.53.00 или 4.52.02.

Как выполнить откат в два этапа

Контрольная точка 1. Исходное состояние, в котором все компоненты имеют версию 4.52.02. Полный откат возможен, если хотя бы один центр обработки данных Cassandra останется на более старой версии.
Контрольная точка 2. После обновления всех узлов Cassandra во всех центрах обработки данных. Вы можете откатить до этого состояния, но не вернуться к контрольной точке 1.

Пример

Рассмотрим кластер с двумя центрами обработки данных:

Исходное состояние. Узлы Cassandra в обоих центрах обработки данных работают с версией 3.11.X. Все остальные узлы работают под управлением Edge для частного облака версии 4.52.02. Предположим, что в каждом центре обработки данных три узла Cassandra.
Обновление DC-1. Обновите три узла Cassandra в DC-1 по очереди.
Приостановить и проверить. Приостановите работу кластера, чтобы убедиться, что он, особенно DC-1, работает правильно (проверьте производительность и функциональность). Вы можете откатить до исходного состояния, используя узлы Cassandra в DC-2. Помните, что приостановка должна быть временной из-за ограничений кластера Cassandra со смешанными версиями.
Обновите DC-2. Обновите оставшиеся три узла Cassandra в DC-2. Это станет новой контрольной точкой для отката.
Обновите другие компоненты. Обновите узлы управления, среды выполнения и аналитики обычным образом во всех центрах обработки данных, по одному узлу и одному центру обработки данных за раз. В случае возникновения неполадок вы можете откатить перенос до состояния шага 4.

Предварительные условия для обновления Cassandra

Вам следует использовать Cassandra 3.11.16 с Edge для частного облака 4.52.02 и убедиться в следующем:

Весь кластер работает и полностью совместим с Cassandra 3.11.16.
Стратегия сжатия задана как LeveledCompactionStrategy (обязательное условие для перехода на версию 4.52.02).
Убедитесь, что каждый из перечисленных ниже шагов был выполнен в рамках первоначального обновления Cassandra 3.11 в Edge для частного облака версии 4.52.02.
- Команда post_upgrade была выполнена на каждом узле Cassandra во время предыдущего обновления.
- Команда drop_old_tables была выполнена во всем кластере Cassandra во время предыдущего обновления.
Примечание. Описанные выше шаги (после обновления и Удаление неиспользуемых таблиц) являются стандартными и должны были быть выполнены при обновлении кластера до Edge для частного облака 4.52.02 с более ранних версий.

Если вы не уверены, что команды post_upgrade и drop_old_tables были выполнены в Cassandra 3.11 при использовании Edge для частного облака 4.52.02, вы можете повторно запустить их, прежде чем пытаться выполнить обновление до версии 4.53.01.

Шаг 1. Подготовьтесь к переходу на новую версию

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

Создайте резервную копию Cassandra с помощью Apigee.
Сделайте снимки виртуальных машин узлов Cassandra (если это возможно).
Убедитесь, что порт 9042 доступен для всех компонентов Edge для частного облака, включая сервер управления, процессор сообщений, маршрутизатор, Qpid и Postgres, для узлов Cassandra, если он ещё не настроен. Подробнее о требованиях к портам…

Шаг 2. Обновите все узлы Cassandra

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

После обновления всех узлов Cassandra в центре обработки данных подождите некоторое время (от 30 минут до нескольких часов), прежде чем переходить к узлам в следующем центре обработки данных. В этот период внимательно изучите обновленный центр обработки данных и убедитесь, что функциональные и эксплуатационные показатели кластера Apigee не изменились. Этот шаг необходим для обеспечения стабильности центра обработки данных, в котором Cassandra была обновлена до версии 4.0.X, а остальные компоненты Apigee остались на версии 4.52.02.

Чтобы обновить узел Cassandra, выполните следующую команду:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
```
После обновления узла выполните на нем следующую команду, чтобы провести проверку перед дальнейшими действиями:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile
```

Вы получите примерно следующий результат:

Cassandra version is verified - [cqlsh 6.0.0 | Cassandra 4.0.18 | CQL spec 3.4.5 | Native protocol v5] 
Metadata is verified

Выполните следующую команду post_upgrade на узле Cassandra:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade
```
Выполните следующую команду cleanup_old_index на узле Cassandra:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra cleanup_old_index
```

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

/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms api_products api_products_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_api_products_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_organization_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_end_user app_end_user_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_family_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_type_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_parent_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_parent_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms maps maps_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_consumer_key_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_request_tokens oauth_10_request_tokens_consumer_key_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_request_tokens oauth_10_request_tokens_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_verifiers oauth_10_verifiers_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_verifiers oauth_10_verifiers_request_token_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_client_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_refresh_token_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_authorization_codes oauth_20_authorization_codes_client_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_authorization_codes oauth_20_authorization_codes_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_company_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_developer_email_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_email_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index cache cache_entries cache_entries_cache_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_operation_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_requesturi_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_responsecode_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_timestamp_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_user_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis a_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_active_rev
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_def_index_template
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_def_method_template
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_latest_rev
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_base_url
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_is_active
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_is_latest
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_rel_ver
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_rev_num
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_base_url
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_r_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_r_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_res_path
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_rev_num
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_base_url
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_res_path
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_rev_num
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 schemas s_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 schemas s_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 security sa_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 security sa_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_a_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_entity
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template_auth au_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index dek keys usecase_index

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

/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_created_date_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_updated_date_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_created_date_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_currency_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_dev_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_limit_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_prod_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_reason_code_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_sub_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_company_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_created_at_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_developer_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_lastmodified_at_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_env_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_job_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_class_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_group_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus org_triggers org_triggers_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_group_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_suite_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_item notification_service_item_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_item notification_service_item_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_black_list_item notification_service_black_list_item_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_black_list_item notification_service_black_list_item_to_email_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_email_template_item notification_email_template_item_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_email_template_item notification_email_template_item_org_id_idx

Шаг 3. Обновите все узлы управления

Поочередно обновите все узлы управления во всех регионах:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Шаг 4. Обновите все узлы среды выполнения

Обновите все узлы маршрутизаторов и Message Processor во всех регионах по одному:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Шаг 5. Обновите все оставшиеся компоненты Edge для частного облака 4.53.01

Поочередно обновите все оставшиеся узлы edge-qpid-server и edge-postgres-server во всех регионах.

Требуется обновление до Zookeeper 3.8.4

В этом выпуске Edge для частного облака реализован переход на Zookeeper 3.8.4. В рамках этого обновления все данные Zookeeper будут перенесены в Zookeeper 3.8.4.

Перед обновлением Zookeeper ознакомьтесь с руководством по обслуживанию Zookeeper. Большинство производственных систем Edge используют кластер узлов Zookeeper, распределенных по нескольким центрам обработки данных. Некоторые из этих узлов настроены как голосующие, которые участвуют в выборах лидера Zookeeper, а остальные – как наблюдатели. Подробнее о лидерах, подписчиках, избирателях и наблюдателях… Узлы-избиратели выбирают лидера, а затем сами становятся последователями.

Во время обновления при отключении ведущего узла может возникнуть временная задержка или ошибка записи в Zookeeper. Это может повлиять на операции управления, которые записывают данные в Zookeeper, например на развертывание прокси и изменения инфраструктуры Apigee, такие как добавление или удаление процессора сообщений. При обновлении Zookeeper в соответствии с приведенной ниже процедурой не должно быть никакого влияния на API времени выполнения Apigee (если только эти API времени выполнения не вызывают API управления).

Процесс обновления включает создание резервной копии каждого узла. Затем обновляются все наблюдатели и подписчики, а в конце – ведущий узел.

Создайте резервную копию

Создайте резервную копию всех узлов Zookeeper на случай, если потребуется выполнить откат. Обратите внимание, что при откате Zookeeper будет восстановлен до состояния, в котором он находился на момент создания резервной копии. Примечание. Все развертывания и изменения инфраструктуры в Apigee, выполненные после создания резервной копии (информация о которых хранится в Zookeeper), будут потеряны при восстановлении.

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper backup

Если вы используете виртуальные машины, можно также сделать их снимки или резервные копии для восстановления или отката (если это необходимо).

Как определить лидера, последователей и наблюдателей

Примечание. В приведенных ниже примерах команд для отправки данных в Zookeeper используется утилита nc. Вы также можете использовать другие утилиты для отправки данных в Zookeeper.

Если на узле ZooKeeper не установлено приложение nc, установите его:
```
  sudo yum install nc
```
Выполните на узле следующую команду nc, где 2181 – порт ZooKeeper:
```
  echo stat | nc localhost 2181
```
Вы должны увидеть примерно такой результат:
```
  Zookeeper version: 3.8.4-5a02a05eddb59aee6ac762f7ea82e92a68eb9c0f, built on 2022-02-25 08:49 UTC
  Clients:
   /0:0:0:0:0:0:0:1:41246[0](queued=0,recved=1,sent=0)
  
  Latency min/avg/max: 0/0.2518/41
  Received: 647228
  Sent: 647339
  Connections: 4
  Outstanding: 0
  Zxid: 0x400018b15
  Mode: follower
  Node count: 100597
```
В строке Mode выходных данных для узлов должно быть указано observer, leader или follower (то есть голосующий, но не лидер) в зависимости от конфигурации узла. Примечание. При отдельной установке Edge с одним узлом ZooKeeper для параметра Mode устанавливается значение standalone.
Повторите шаги 1 и 2 на каждом узле ZooKeeper.

Как обновить Zookeeper на узлах наблюдателя и последователя

Обновите Zookeeper на каждом из узлов наблюдателя и последователя следующим образом:

Скачайте и запустите начальную загрузку Edge для частного облака 4.53.01, как описано в разделе Обновление до версии 4.53.01 на узле с внешним подключением к интернету. Процесс установки зависит от того, подключен ли узел к интернету или вы выполняете офлайн-установку.
Обновите компонент Zookeeper:
```
  /opt/apigee/apigee-setup/bin/update.sh -c zk -f <silent-config-file>
```
Примечание. Если на этих узлах установлены другие компоненты (например, Cassandra), вы можете обновить их сейчас (например, с помощью профиля cs,zk) или позже. Apigee рекомендует сначала обновить только ZooKeeper и убедиться, что кластер работает правильно, прежде чем обновлять другие компоненты.
Повторите описанные выше шаги на каждом узле наблюдателя и последователя Zookeeper.

Как отключить лидера

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

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

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

Проверьте, что новый лидер выбран

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

Руководитель по переходу

Выполните те же действия, что и в разделе Обновление Zookeeper на узлах наблюдателя и подчиненных узлах выше.

После обновления старого ведущего узла проверьте состояние кластера и убедитесь, что ведущий узел присутствует.

Обновление Nginx до версии 1.26 в Edge-Router

При обновлении до Edge для частного облака 4.53.01 с предыдущих версий программное обеспечение Nginx не обновляется автоматически до последней версии (1.26.x). Это позволит избежать непредвиденных побочных эффектов во время выполнения в результате изменений, описанных в разделе Изменения в Nginx 1.26 в Apigee Edge 4.53.01. Вы можете вручную обновить Nginx с версии 1.20.x до 1.26.x после проверки в более ранних версиях. Чтобы обновить устройство вручную:

Убедитесь, что на пограничном маршрутизаторе установлена последняя версия ПО 4.53.01.
```
/opt/apigee/apigee-service/bin/apigee-service edge-router version
```
Как проверить версию Nginx
```
/opt/nginx/sbin/nginx -V
```
Если вы используете более раннюю версию Nginx, выполните следующие действия, чтобы обновить ее до версии 1.26.X на узле маршрутизатора.
Остановите процесс пограничного маршрутизатора на узле маршрутизатора
```
/opt/apigee/apigee-service/bin/apigee-service edge-router stop
```
Как обновить программное обеспечение nginx на узле маршрутизатора
```
dnf update apigee-nginx-1.26.3
```
Как проверить, что версия Nginx обновлена
```
/opt/nginx/sbin/nginx -V
```
Запустите процесс маршрутизатора на узле
```
/opt/apigee/apigee-service/bin/apigee-service edge-router start
```
Повторите процесс для каждого узла маршрутизатора по очереди.

Требуется обновление до Postgres 17

В этом выпуске Edge обновлена версия Postgres до 17. В рамках этого обновления все данные Postgres будут перенесены в Postgres 17.

В большинстве производственных систем Edge используются два узла Postgres, настроенные для репликации "основной-резервный". Во время обновления, когда узлы Postgres отключены, данные аналитики по-прежнему записываются в узлы Qpid. После того как узлы Postgres будут обновлены и снова подключены к сети, на них будут переданы данные аналитики.

Способ обновления Postgres зависит от того, как вы настроили хранилище данных для узлов Postgres:

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

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

Установка нового резервного узла Postgres

Эта процедура позволяет создать резервный сервер Postgres на новом узле. Убедитесь, что вы устанавливаете новый резервный сервер Postgres для существующей версии Edge (4.52.02 или 4.53.00), а не для версии 4.53.01.

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

Чтобы создать новый резервный узел Postgres:

На текущем основном сервере Postgres измените файл /opt/apigee/customer/application/postgresql.properties, чтобы задать следующий токен. Если такого файла нет, создайте его:
```
conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust
```
где existing_standby_ip – IP-адрес текущего резервного сервера Postgres, а new_standby_ip – IP-адрес нового резервного узла.
Перезапустите apigee-postgresql на основном сервере Postgres:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
```
Убедитесь, что новый резервный узел добавлен, просмотрев файл /opt/apigee/apigee-postgresql/conf/pg_hba.conf на основном узле. В этом файле должны быть следующие строки:
```
host replication apigee existing_standby_ip/32 trust
host replication apigee new_standby_ip/32 trust
```
Установите новый резервный сервер Postgres:
1. Измените файл конфигурации, который вы использовали для установки текущей версии Edge, чтобы указать следующее:
```
# IP address of the current master:
PG_MASTER=192.168.56.103
# IP address of the new standby node
PG_STANDBY=192.168.56.102
```
2. Отключите SELinux, как описано в разделе Установка утилиты Edge apigee-setup.
3. Если вы используете Edge 4.52.02:
  1. Скачайте файл Edge bootstrap_4.52.02.sh в каталог /tmp/bootstrap_4.52.02.sh :
```
curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.51.00.sh
```
  2. Установите утилиту Edge apigee-service и зависимости:
```
sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord
```
  Если вы используете Edge 4.53.00:
  1. Скачайте файл Edge bootstrap_4.53.00.sh в каталог /tmp/bootstrap_4.53.00.sh :
```
curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
```
  2. Установите утилиту Edge apigee-service и зависимости:
```
sudo bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord
```
4. Чтобы установить утилиту apigee-setup, используйте apigee-service:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
```
5. Установите Postgres:
```
/opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
```
6. На новом резервном узле выполните следующую команду:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
```
  Убедитесь, что это резервный сервер.

Как выполнить обновление Postgres на месте

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

Предварительный шаг

Прежде чем выполнять обновление Postgres на месте, выполните следующие действия на основном и резервном хостах, чтобы обновить свойство max_locks_per_transaction в файле apigee-postgresql:

Если его нет, создайте файл /opt/apigee/customer/application/postgresql.properties.
Передать право собственности на этот файл пользователю apigee:
```
sudo chown apigee:apigee /opt/apigee/customer/application/postgresql.properties
```
Добавьте в файл следующее свойство:
```
conf/postgresql.conf+max_locks_per_transaction=30000
```
Настройте устройство "apigee-postgresql":
```
apigee-service apigee-postgresql configure
```
Перезапустить apigee-postgresql:
```
apigee-service apigee-postgresql restart
```

Выполните обновление на месте

Чтобы выполнить обновление до Postgres 17, сделайте следующее:

Как обновить postgres на главном хосте

/opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf

Выполните команду установки на главном хосте:
```
apigee-service apigee-postgresql setup -f /opt/silent.conf
```
Выполните команду configure на главном хосте:
```
apigee-service apigee-postgresql configure
```
Перезапустите основной хост:
```
apigee-service apigee-postgresql restart
```

Настройте его как основной:

apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf

Убедитесь, что основной организатор начал игру:
```
apigee-service apigee-postgresql wait_for_ready
```
Чтобы остановить режим ожидания:
```
apigee-service apigee-postgresql stop
```
Обновите резервный сервер.
Примечание. Если на этом этапе возникнет ошибка, ее можно проигнорировать. update.sh попытается запустить резервный сервер с неправильной конфигурацией. Если установка Postgres обновлена до версии 17, ошибку можно игнорировать.
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
```
Убедитесь, что режим ожидания отключен:
```
apigee-service apigee-postgresql stop
```
Удалите старую конфигурацию резервного сервера:
```
rm -rf /opt/apigee/data/apigee-postgresql/
```

Настройте репликацию на резервном сервере:

apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf

Удалите строку conf/postgresql.conf+max_locks_per_transaction=30000 из файла /opt/apigee/customer/application/postgresql.properties на основном и резервном хостах. Эта строка была добавлена на предварительном этапе.

После этого режим ожидания запустится успешно.

Как вывести из эксплуатации узел Postgres

После завершения обновления отключите новый резервный узел:

Убедитесь, что Postgres работает:
```
/opt/apigee/apigee-service/bin/apigee-all status
```
Если Postgres не запущен, запустите его:
```
/opt/apigee/apigee-service/bin/apigee-all start
```
Получите UUID нового резервного узла, выполнив следующую команду curl на новом резервном узле:
```
curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self
```
В конце выходных данных должен быть указан UUID узла в следующем формате:
```
"type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
```
Остановите новый резервный узел, выполнив на нем следующую команду:
```
/opt/apigee/apigee-service/bin/apigee-all stop
```
На основном узле Postgres измените файл /opt/apigee/customer/application/postgresql.properties, чтобы удалить новый резервный узел из conf_pg_hba_replication.connection:
```
conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust
```
Перезапустите apigee-postgresql на основном сервере Postgres:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
```
Убедитесь, что новый резервный узел удален, просмотрев файл /opt/apigee/apigee-postgresql/conf/pg_hba.conf на основном узле. В этом файле должна быть только следующая строка:
```
host replication apigee existing_standby_ip/32 trust
```
Удалите UUID резервного узла из ZooKeeper, выполнив следующий вызов Edge Management API на узле сервера управления:
```
curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid
```

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

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

Postgres может постепенно восстанавливать статистику по мере выполнения запросов и при работе демона autovacuum. Однако до тех пор, пока статистика не будет восстановлена, запросы могут выполняться медленно.

Чтобы устранить эту проблему, выполните команду ANALYZE для всех таблиц в базе данных на главном узле Postgres. Вы также можете выполнить команду ANALYZE для нескольких таблиц одновременно.

Примечание. ANALYZE может выполняться долго, но при этом она устанавливает только блокировку чтения таблицы, позволяя другим операциям в Postgres выполняться параллельно с ANALYZE.

Как обновить Apigee SSO с более ранних версий

В Edge для частного облака 4.53.01 ключи и сертификаты поставщика идентификационной информации, используемые в компоненте apigee-sso, теперь настраиваются через хранилище ключей. Вам нужно будет экспортировать ключ и сертификат, использованные ранее, в хранилище ключей, настроить его, а затем обновить SSO обычным способом.

Определите существующий ключ и сертификат, используемые для настройки поставщика идентификационной информации:
1. Чтобы получить сертификат, найдите значение SSO_SAML_SERVICE_PROVIDER_CERTIFICATE в файле конфигурации установки SSO или запросите компонент apigee-sso для conf_login_service_provider_certificate.
  
  Чтобы запросить у apigee-sso путь к сертификату поставщика идентификационной информации, выполните на узле SSO следующую команду: В выходных данных найдите значение в последней строке.
```
apigee-service apigee-sso configure -search conf_login_service_provider_certificate
```
2. Чтобы получить ключ, найдите значение SSO_SAML_SERVICE_PROVIDER_KEY в файле конфигурации установки SSO или запросите компонент apigee-sso для conf_login_service_provider_key.
  
  Чтобы запросить путь к ключу поставщика идентификационной информации, используйте следующую команду в узле SSO: apigee-sso. В выходных данных найдите значение в последней строке.
```
apigee-service apigee-sso configure -search conf_login_service_provider_key
```
Экспортируйте ключ и сертификат в хранилище ключей:
1. Экспортируйте ключ и сертификат в хранилище ключей PKCS12:
```
sudo openssl pkcs12 -export -clcerts -in <certificate_path> -inkey <key_path> -out <keystore_path> -name <alias>
```
  Параметры:
  - certificate_path: путь к файлу сертификата, полученному на шаге 1а.
  - key_path – путь к файлу закрытого ключа, полученному на шаге 1б.
  - keystore_path: путь к созданному хранилищу ключей, содержащему сертификат и закрытый ключ.
  - alias – псевдоним, используемый для пары ключей и сертификатов в хранилище ключей.
  Подробная информация приведена в документации OpenSSL.
2. При необходимости экспортируйте ключ и сертификат из PKCS12 в хранилище ключей JKS:
```
sudo keytool -importkeystore -srckeystore <PKCS12_keystore_path> -srcstoretype PKCS12 -destkeystore <destination_keystore_path> -deststoretype JKS -alias <alias>
```
  Параметры:
  - PKCS12_keystore_path – путь к хранилищу ключей PKCS12, созданному на шаге 2а и содержащему сертификат и ключ.
  - destination_keystore_path – путь к новому хранилищу ключей JKS, в которое будут экспортированы сертификат и ключ.
  - alias – псевдоним, используемый для пары ключей и сертификатов в хранилище ключей JKS.
Измените владельца выходного файла хранилища ключей на пользователя apigee:
```
sudo chown apigee:apigee <keystore_file>
```

Добавьте в файл конфигурации Apigee SSO следующие свойства и укажите в них путь к файлу хранилища ключей, пароль, тип хранилища ключей и псевдоним:

# Path to the keystore file
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PATH=${APIGEE_ROOT}/apigee-sso/source/conf/keystore.jks

# Keystore password
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PASSWORD=Secret123  # Password for accessing the keystore

# Keystore type
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_TYPE=JKS  # Type of keystore, e.g., JKS, PKCS12

# Alias within keystore that stores the key and certificate
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_ALIAS=service-provider-cert

Обновите ПО Apigee SSO на узле SSO обычным способом, используя следующую команду:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f /opt/silent.conf
```

Новый интерфейс Edge

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

Как установить интерфейс Edge

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

Обратите внимание, что для интерфейса Edge требуется отключить базовую аутентификацию и использовать IDP, например SAML или LDAP.

Подробнее об установке нового интерфейса Edge…

Как обновить Apigee mTLS

Чтобы обновить Apigee mTLS , выполните следующие действия:

Как отменить обновление

Если обновление не удалось, попробуйте устранить проблему и снова выполнить команду update.sh. Вы можете запустить обновление несколько раз, и оно будет продолжено с того места, где остановилось в прошлый раз.

Если из-за сбоя вам нужно выполнить откат к предыдущей версии, следуйте инструкциям в разделе Как выполнить откат к версии 4.53.01.

Регистрация информации об обновлении

По умолчанию утилита update.sh записывает информацию в журнал:

/opt/apigee/var/log/apigee-setup/update.log

Если у пользователя, запустившего утилиту update.sh, нет доступа к этому каталогу, журнал будет записан в каталог /tmp в виде файла update_username.log.

Если у пользователя нет доступа к объекту /tmp, утилита update.sh не будет работать.

Обновление без простоя

Обновление без простоя, или последовательное обновление, позволяет обновить установку Edge, не отключая Edge.

Обновление без простоев возможно только при конфигурации с пятью узлами и более.

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

Обновите машины в правильном порядке, как описано в разделе Порядок обновления машин.
Когда придет время обновить маршрутизаторы, выберите любой из них и сделайте его недоступным, как описано в разделе Включение и отключение доступности сервера (процессора сообщений или маршрутизатора).
Обновите выбранный маршрутизатор и все остальные компоненты Edge на том же компьютере, что и маршрутизатор. Во всех конфигурациях Edge маршрутизатор и Message Processor находятся на одном узле.
Сделайте маршрутизатор снова доступным.
Повторите шаги 2–4 для остальных маршрутизаторов.
Продолжите обновление на остальных компьютерах.

До и после обновления выполните следующие действия:

На комбинированном узле маршрутизатора и обработчика сообщений:
- Перед обновлением выполните следующие действия:
  1. Сделайте маршрутизатор недоступным.
  2. Сделайте Message Processor недоступным.
- После обновления выполните следующие действия:
  1. Убедитесь, что Message Processor доступен.
  2. Убедитесь, что маршрутизатор доступен.
На узлах маршрутизатора:
- Перед обновлением сделайте маршрутизатор недоступным.
- После обновления обеспечьте доступность маршрутизатора.
На отдельных узлах Message Processor:
- Перед обновлением сделайте процессор сообщений недоступным.
- После обновления сделайте процессор сообщений доступным.

Как использовать файл конфигурации для автоматической установки

В команду обновления необходимо передать файл конфигурации в тихом режиме. Файл конфигурации должен быть тем же, который вы использовали для установки Edge for Private Cloud 4.52.02 или 4.53.00.

Обновление до версии 4.53.01 на узле с внешним подключением к интернету

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

Если они есть, отключите все задания cron, настроенные на выполнение операции восстановления в Cassandra, до завершения обновления.
Войдите в узел как root, чтобы установить пакеты RPM Edge.
Примечание. Для установки RPM-пакета требуется доступ с правами root, но для настройки Edge он не нужен.
Отключите SELinux, как описано в разделе Установка утилиты apigee-setup Edge.

Если вы устанавливаете ПО на AWS, выполните следующие команды yum-configure-manager:

yum update rh-amazon-rhui-client.noarch
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

Если вы используете Edge 4.52.02 или 4.53.00:
1. Скачайте файл Edge bootstrap_4.53.01.sh в /tmp/bootstrap_4.53.01.sh:
```
curl https://software.apigee.com/bootstrap_4.53.01.sh -o /tmp/bootstrap_4.53.01.sh
```
2. Установите утилиту apigee-service Edge 4.53.01 и зависимости, выполнив следующую команду:
```
sudo bash /tmp/bootstrap_4.53.01.sh apigeeuser=uName apigeepassword=pWord
```
  где uName:pWord – имя пользователя и пароль, полученные от Apigee. Если вы не укажете pWord, вам будет предложено ввести его.
  
  По умолчанию установщик проверяет, установлена ли у вас Java 1.8. Если нет, установщик установит его.
  
  Используйте параметр JAVA_FIX, чтобы указать, как обрабатывать установку Java. JAVA_FIX принимает следующие значения:
  - I – установить OpenJDK 1.8 (по умолчанию).
  - C – продолжить без установки Java.
  - Q: закрыть. В этом случае вам нужно будет установить Java самостоятельно.
3. Используйте apigee-service, чтобы обновить утилиту apigee-setup, как показано в следующем примере:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
```
4. Обновите утилиту apigee-validate на сервере управления, как показано в следующем примере:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
```
5. Обновите утилиту apigee-provision на сервере управления, как показано в следующем примере:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
```
6. Запустите утилиту update на узлах, выполнив следующую команду:
```
/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
```
  Выполните действия в порядке, описанном в разделе Порядок обновления компьютера.
  
  Где:
  - component – компонент Edge, который нужно обновить. Некоторые возможные значения:
    - cs: Cassandra
    - edge: все компоненты Edge, кроме интерфейса Edge: сервер управления, процессор сообщений, маршрутизатор, сервер QPID, сервер Postgres
    - ldap: OpenLDAP
    - ps: postgresql
    - qpid: qpidd
    - sso: Apigee SSO (если вы установили SSO)
    - ue: новый интерфейс Edge
    - ui – классический интерфейс Edge;
    - zk: смотритель зоопарка
  - configFile – это тот же файл конфигурации, который вы использовали для определения компонентов Edge во время установки версии 4.52.02 или 4.53.00.
  Вы можете запустить update.sh для всех компонентов, задав для component значение "all", но только если у вас есть профиль установки Edge All-in-One (AIO). Пример:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
```
7. Перезапустите компоненты интерфейса Edge на всех узлах, на которых они выполняются, если вы ещё этого не сделали:
```
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
```
8. Проверьте обновление, запустив утилиту apigee-validate на сервере управления, как описано в разделе Проверка установки.

Если вы решите отменить обновление, следуйте инструкциям в разделе Как откатить версию 4.53.01.

Как обновить версию до 4.53.01 из локального репозитория

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

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

Создайте TAR-файл репозитория, скопируйте его на узел и обновите Edge с помощью этого файла.
Установите веб-сервер на узле с локальным репозиторием, чтобы другие узлы могли получить к нему доступ. Apigee предоставляет веб-сервер Nginx, но вы можете использовать и собственный.

Чтобы обновить локальный репозиторий 4.53.01:

Создайте локальный репозиторий 4.53.01, как описано в разделе "Создание локального репозитория Apigee" в статье Установка утилиты apigee-setup Edge.
ПРИМЕЧАНИЕ. Если у вас уже есть репозиторий, вы можете добавить в него репозиторий 4.53.01, как описано в разделе "Обновление локального репозитория Apigee" на странице Установка утилиты apigee-setup для Edge.
Чтобы установить apigee-service из файла .tar, выполните следующие действия:
1. На узле с локальным репозиторием используйте следующую команду, чтобы упаковать локальный репозиторий в один файл .tar с именем /opt/apigee/data/apigee-mirror/apigee-4.53.01.tar.gz:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
```
2. Скопируйте TAR-файл на узел, на котором нужно обновить Edge. Например, скопируйте его в каталог /tmp на новом узле.
3. На новом узле разархивируйте файл в каталог /tmp:
```
tar -xzf apigee-4.53.01.tar.gz
```
  Эта команда создаст новый каталог с названием repos в каталоге, содержащем файл .tar. Пример: /tmp/repos.
4. Установите утилиту Edge apigee-service и зависимости из /tmp/repos:
```
sudo bash /tmp/repos/bootstrap_4.53.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
```
  Обратите внимание, что в этой команде указан путь к каталогу repos.
Чтобы установить apigee-service с помощью веб-сервера Nginx:
1. Настройте веб-сервер Nginx, как описано в разделе "Установка из репозитория с помощью веб-сервера Nginx" статьи Установка утилиты apigee-setup Edge.
2. На удаленном узле скачайте файл Edge bootstrap_4.53.01.sh в каталог /tmp/bootstrap_4.53.01.sh:
```
/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.53.01.sh -o /tmp/bootstrap_4.53.01.sh
```
  где uName:pWord – это имя пользователя и пароль, которые вы задали ранее для репозитория, а remoteRepo – IP-адрес или имя DNS узла репозитория.
3. На удаленном узле установите утилиту Edge apigee-setup и зависимости:
```
sudo bash /tmp/bootstrap_4.53.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
```
  где uName:pWord – имя пользователя и пароль репозитория.
Используйте apigee-service, чтобы обновить утилиту apigee-setup, как показано в следующем примере:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update 
```
Обновите утилиту apigee-validate на сервере управления, как показано в следующем примере:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
```
Обновите утилиту apigee-provision на сервере управления, как показано в следующем примере:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
```
Запустите утилиту update на узлах в порядке, описанном в разделе Порядок обновления машин:
```
/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
```
Где:
- component – компонент Edge, который нужно обновить. Обычно обновляются следующие компоненты:
  - cs: Cassandra
  - edge: все компоненты Edge, кроме интерфейса Edge: сервер управления, процессор сообщений, маршрутизатор, сервер QPID, сервер Postgres.
  - ldap: OpenLDAP
  - ps: postgresql
  - qpid: qpidd
  - sso: Apigee SSO (если вы установили SSO)
  - ue Новый интерфейс Edge
  - ui – классический интерфейс Edge;
  - zk: смотритель зоопарка
- configFile – это тот же файл конфигурации, который вы использовали для определения компонентов Edge во время установки версии 4.52.02 или 4.53.00.
  Примечание. Файл конфигурации должен быть доступен для чтения пользователю apigee. Чтобы изменить владельца, используйте следующую команду:
```
chown apigee:apigee configFile
```
Вы можете запустить update.sh для всех компонентов, задав для параметра component значение "all", но только если у вас есть профиль установки Edge All-in-One (AIO). Пример:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
```
Перезапустите компоненты интерфейса на всех узлах, на которых они выполняются, если вы ещё этого не сделали:
```
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
```
Проверьте обновление, запустив утилиту apigee-validate на сервере управления, как описано в разделе Проверка установки.

Если вы решите отменить обновление, следуйте инструкциям в разделе Как откатить версию 4.53.01.

Порядок обновления машин

Порядок обновления машин в установке Edge имеет важное значение:

Прежде чем обновлять другие компоненты, необходимо обновить все узлы LDAP. Чтобы обновить LDAP, вам нужно выполнить специальные действия.
Вам необходимо обновить все узлы Cassandra и ZooKeeper. Если вы переходите с версии 4.52.02, выполните специальные действия по обновлению Cassandra. Чтобы обновить Zookeeper для версий 4.52.02 или 4.53.00, необходимо выполнить специальные действия.
Чтобы обновить все серверы управления, маршрутизаторы и процессоры сообщений, используйте параметр -c edge.
Вам необходимо обновить все узлы Postgres, выполнив специальные инструкции по обновлению Postgres.
Вам необходимо обновить компоненты edge-qpid-server и edge-postgres-server во всех центрах обработки данных.
Необходимо обновить все узлы Qpid.
Вам необходимо обновить узлы интерфейса Edge, а также узлы нового интерфейса Edge и SSO(если применимо).
Отдельно обновлять монетизацию не нужно. Он обновляется, когда вы указываете параметр края -c.

Отдельное обновление с одним узлом

Чтобы обновить отдельную конфигурацию с одним узлом до версии 4.53.01:

Обновите все компоненты:

/opt/apigee/apigee-setup/bin/update.sh -c all -f configFile

Если вы установили утилиту apigee-adminapi, обновите apigee-adminapi ее:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```

Отдельное обновление с двумя узлами

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

Список топологий Edge и номеров узлов приведен в разделе Топологии установки.

Обновите LDAP на компьютере 1:

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

Обновите Cassandra и ZooKeeper на машине 1:

/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

Обновите компоненты Edge на компьютере 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

Обновите Postgres на компьютере 2:

/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

Обновите компоненты Edge на компьютере 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

Обновите Qpid на компьютере 2:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Обновите интерфейс на компьютере 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
```
(Если вы установили apigee-adminapi) Обновлена утилита apigee-adminapi на компьютере 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
Если вы установили Apigee SSO, обновите Apigee SSO на компьютере 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
где sso_config_file – это файл конфигурации, созданный при установке SSO.
Перезапустите компонент Edge UI на компьютере 1:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```

Обновление с пятью узлами

Обновите следующие компоненты для установки с пятью узлами:

Список топологий Edge и номеров узлов приведен в разделе Топологии установки.

Обновите LDAP на компьютере 1:

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

Обновите Cassandra и ZooKeeper на машинах 1, 2 и 3:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
Обновите компоненты Edge на машинах 1, 2 и 3:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

Обновите Postgres на компьютере 4:

/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

Обновите Postgres на компьютере 5:

/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

Обновите компоненты Edge на машинах 4 и 5:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

Обновите Qpid на компьютере 4:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Обновите Qpid на компьютере 5:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Как обновить интерфейс Edge:
- Классический интерфейс. Если вы используете классический интерфейс, обновите компонент ui на компьютере 1, как показано в следующем примере:
```
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
```
- Новый интерфейс Edge. Если вы установили новый интерфейс Edge, обновите компонент ue на подходящем компьютере (это может быть не компьютер 1):
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
```
(Если вы установили apigee-adminapi) Обновлена утилита apigee-adminapi на компьютере 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
Если вы установили Apigee SSO, обновите Apigee SSO на компьютере 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
где sso_config_file – это файл конфигурации, созданный при установке SSO.
Перезапустите компонент интерфейса:
- Классический интерфейс. Если вы используете классический интерфейс, перезапустите компонент edge-ui на компьютере 1, как показано в следующем примере:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
- Новый интерфейс Edge. Если вы установили новый интерфейс Edge, перезапустите компонент edge-management-ui на подходящем компьютере (это может быть не компьютер 1):
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```

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

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

Список топологий Edge и номеров узлов приведен в разделе Топологии установки.

Обновите LDAP на компьютере 1:

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

Обновите Cassandra и ZooKeeper на машинах 1, 2 и 3:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
Обновите компоненты Edge на машинах 1, 4 и 5 (сервер управления, обработчик сообщений, маршрутизатор) в указанном порядке:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

Обновите Postgres на компьютере 8:

/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

Обновите Postgres на компьютере 9:

/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

Обновите компоненты Edge на машинах 6, 7, 8 и 9 в указанном порядке:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

Обновите Qpid на машинах 6 и 7:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Обновите новый (ue) или классический (ui) интерфейс на компьютере 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
Если вы установили утилиту apigee-adminapi, обновите ее apigee-adminapi на компьютере 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
Если вы установили Apigee SSO, обновите Apigee SSO на компьютере 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
где sso_config_file – это файл конфигурации, созданный при установке SSO.
Перезапустите компонент интерфейса:
- Классический интерфейс. Если вы используете классический интерфейс, перезапустите компонент edge-ui на компьютере 1, как показано в следующем примере:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
- Новый интерфейс Edge. Если вы установили новый интерфейс Edge, перезапустите компонент edge-management-ui на подходящем компьютере (это может быть не компьютер 1):
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```

Обновление кластера из 13 узлов

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

Список топологий Edge и номеров узлов приведен в разделе Топологии установки.

Обновите LDAP на машинах 4 и 5:

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

Обновите Cassandra и ZooKeeper на машинах 1, 2 и 3:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
Обновите компоненты Edge на машинах 6, 7, 10 и 11 в указанном порядке:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

Обновите Postgres на компьютере 8:

/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

Обновите Postgres на компьютере 9:

/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

Обновите компоненты Edge на машинах 12, 13, 8 и 9 в указанном порядке:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

Обновите Qpid на компьютерах 12 и 13:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Обновите новый (ue) или классический (ui) интерфейс на компьютерах 6 и 7:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
(Если вы установили apigee-adminapi.) Обновите утилиту apigee-adminapi на компьютерах 6 и 7:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
Если вы установили Apigee SSO, обновите Apigee SSO на машинах 6 и 7:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
где sso_config_file – это файл конфигурации, созданный при установке SSO.
Перезапустите компонент интерфейса:
- Классический интерфейс. Если вы используете классический интерфейс, перезапустите компонент edge-ui на машинах 6 и 7, как показано в следующем примере:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
- Новый интерфейс Edge. Если вы установили новый интерфейс Edge, перезапустите компонент edge-management-ui на машинах 6 и 7:
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```

Обновление кластера из 12 узлов

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

Список топологий Edge и номеров узлов приведен в разделе Топологии установки.

Обновление LDAP:
1. Машина 1 в центре обработки данных 1
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
2. Машина 7 в центре обработки данных 2
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
Обновите Cassandra и ZooKeeper:
1. Машины 1, 2 и 3 в центре обработки данных 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
2. На машинах 7, 8 и 9 в центре обработки данных 2:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
Как обновить компоненты Edge:
1. На машинах 1, 2 и 3 в центре обработки данных 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
2. На машинах 7, 8 и 9 в центре обработки данных 2
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
Обновите Postgres:
1. Машина 6 в центре обработки данных 1
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
2. Машина 12 в центре обработки данных 2
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
Как обновить компоненты Edge:
1. Машины 4, 5 и 6 в центре обработки данных 1
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
2. Компьютеры 10, 11, 12 в центре обработки данных 2
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
Обновление qpidd:
1. Машины 4, 5 в Центре обработки данных 1
  1. Обновите qpidd на машине 4:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
  2. Обновите qpidd на компьютере 5:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
2. Машины 10, 11 в центре обработки данных 2
  1. Обновите qpidd на компьютере 10:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
  2. Обновите qpidd на компьютере 11:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
Обновите новый (ue) или классический (ui) интерфейс:
1. Машина 1 в центре обработки данных 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
2. Машина 7 в центре обработки данных 2:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
Если вы установили утилиту apigee-adminapi, обновите apigee-adminapi ее:
1. Машина 1 в центре обработки данных 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
2. Машина 7 в центре обработки данных 2:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
Если вы установили Apigee SSO, обновите ее:
1. Машина 1 в центре обработки данных 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
2. Машина 7 в центре обработки данных 2:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
Перезапустите новый интерфейс Edge (edge-management-ui) или классический интерфейс Edge (edge-ui) на компьютерах 1 и 7:
```
/opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart
```

Для нестандартной конфигурации

Если у вас нестандартная конфигурация, обновите компоненты Edge в следующем порядке:

LDAP
Cassandra
Смотритель зоопарка
Сервер управления
Message Processor
Маршрутизатор
Postgres
Edge, то есть профиль "-c edge" на всех узлах в следующем порядке: узлы с сервером Qpid, сервер Edge Postgres.
Примечание. Если на узле установлены и сервер Qpid, и сервер Edge Postgres, выполните шаг профиля "-c edge".
qpidd
Интерфейс Edge (классический или новый)
apigee-adminapi
Apigee SSO

После завершения обновления обязательно перезапустите компонент Edge UI на всех машинах, на которых он работает.

Как обновить Apigee Edge 4.52.02 или 4.53.00 до версии 4.53.01

Кто может выполнить обновление

Какие компоненты нужно обновить

Требования к обновлению

Что нужно учитывать при переходе на новую версию

Автоматическое распространение настроек ресурса

Обязательное обновление до OpenLDAP 2.6

Требования и рекомендации

Подготовка и установка (для всех LDAP-серверов)

Требуется обновление до Cassandra 4.0.18

Обновления и откат

Один центр обработки данных

Несколько центров обработки данных

Рекомендуемый метод обновления

Как выполнить откат в два этапа

Пример

Предварительные условия для обновления Cassandra

Шаг 1. Подготовьтесь к переходу на новую версию

Шаг 2. Обновите все узлы Cassandra

Шаг 3. Обновите все узлы управления

Шаг 4. Обновите все узлы среды выполнения

Шаг 5. Обновите все оставшиеся компоненты Edge для частного облака 4.53.01

Требуется обновление до Zookeeper 3.8.4

Создайте резервную копию

Как определить лидера, последователей и наблюдателей

Как обновить Zookeeper на узлах наблюдателя и последователя

Как отключить лидера

Проверьте, что новый лидер выбран

Руководитель по переходу

Обновление Nginx до версии 1.26 в Edge-Router

Требуется обновление до Postgres 17

Установка нового резервного узла Postgres

Как выполнить обновление Postgres на месте

Предварительный шаг

Выполните обновление на месте

Как вывести из эксплуатации узел Postgres

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

Как обновить Apigee SSO с более ранних версий

Новый интерфейс Edge

Как установить интерфейс Edge

Как обновить Apigee mTLS

Как отменить обновление

Регистрация информации об обновлении

Обновление без простоя

Как использовать файл конфигурации для автоматической установки

Обновление до версии 4.53.01 на узле с внешним подключением к интернету

Как обновить версию до 4.53.01 из локального репозитория

Порядок обновления машин

Отдельное обновление с одним узлом

Отдельное обновление с двумя узлами

Обновление с пятью узлами

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

Обновление кластера из 13 узлов

Обновление кластера из 12 узлов

Для нестандартной конфигурации