Обновите Apigee Edge 4.51.00 или 4.52.00 или 4.52.01 до 4.52.02.

Apigee поддерживает прямое обновление Edge for Private Cloud с версии 4.51.00, 4.52.00 или 4.52.01 до версии 4.52.02. На этой странице описано, как выполнить такое обновление.

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

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

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

Какие компоненты необходимо обновить?

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

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

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

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

    Это позволяет иметь резервный план на случай, если обновление до новой версии не будет работать должным образом. Для получения дополнительной информации о резервном копировании см. раздел «Резервное копирование и восстановление» .

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

Какие особые шаги следует предпринять при обновлении?

Для обновления до Edge for Private Cloud 4.52.02 рекомендуется выполнить определенные шаги по обновлению конкретного программного обеспечения. Необходимые шаги зависят от вашей текущей версии. В таблице ниже приведены сведения о программном обеспечении, требующем дополнительных действий, и следуйте подробным инструкциям для каждого из них. После выполнения необходимых задач вернитесь к основной процедуре обновления, чтобы продолжить процесс обновления.

Текущая версия Программное обеспечение, для обновления которого до версии 4.52.02 требуются специальные действия.
4.52.01 Кассандра
4.52.00 Смотритель зоопарка , Кассандра , Qpid
4.51.00 Zookeeper , Postgres , Cassandra , Qpid

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

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

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

Обновите Zookeeper до версии 3.8.3.

В Edge for Private Cloud 4.52.02 обновление Zookeeper не предусмотрено. Однако, если вы обновляетесь с версии старше 4.52.01, вам необходимо выполнить описанные ниже шаги по обновлению Zookeeper.

  • Если вы выполняете обновление с Edge for Private Cloud версий 4.51.00 или 4.52.00, обратитесь к инструкциям в разделе « Требуется обновление до Zookeeper 3.8.3 для обновления Zookeeper».
  • Если вы обновляете Edge for Private Cloud с версии 4.52.01, у вас уже должна быть установлена ​​версия Zookeeper 3.8.3, и вам не нужно выполнять никаких специальных действий для обновления Zookeeper.

Обновите PostgreSQL до версии 14.

  • Если вы выполняете обновление с Edge for Private Cloud 4.51.00 до 4.52.02, вам необходимо выполнить шаги по обновлению Postgres, даже несмотря на то, что обновление Postgres в Edge for Private Cloud 4.52.02 не включено. Обновление с Edge for Private Cloud 4.51.00 до 4.52.02 требует дополнительных шагов по обновлению Postgres. См. раздел «Необходимое обновление до Postgres 14» .
  • При обновлении с Edge for Private Cloud 4.52.00 или 4.52.01 до 4.52.02 дополнительные шаги по обновлению Postgres не требуются.

Обновите Cassandra до версии 3.11.16.

В Apigee Edge for Private Cloud 4.52.02 включено обновление Cassandra до версии 3.11.16. Cassandra является критически важным компонентом Apigee, и это обновление также включает в себя обновления программного обеспечения драйверов в различных компонентах среды выполнения и управления, используемых для запросов и записи в Cassandra.

Поскольку это масштабное обновление, для обеспечения оптимальной производительности в новых версиях потребовались определенные изменения в модели данных Apigee в Cassandra. Хотя эти изменения минимальны, процесс обновления нарушает работу некоторых API управления при его запуске. Точные API управления, работа которых обычно нарушается, перечислены в соответствующих разделах ниже.

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

Портал для разработчиков — документирование API

Портал разработчиков Apigee Drupal предлагает различные функции для документирования ваших API. Хотя рекомендуется отказаться от использования портала разработчиков на основе Drupal 7, если вы все еще используете его и функцию SmartDocs, документ «Использование API SmartDocs» применим к вам. Если вы используете более новые версии портала разработчиков, это обновление никак не повлияет на документацию ваших API.

При обновлении Apigee до версии 4.52.02 любые модели API, созданные с помощью функции SmartDocs на портале разработчиков Drupal 7, не будут автоматически перенесены в более новую версию. Вам необходимо вручную экспортировать каждую модель с помощью портала разработчиков и импортировать ее снова после завершения обновления.

Приведенная ниже терминология

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

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

В процессе обновления затрагиваются процессы выполнения и управления в регионе или центре обработки данных (ЦОД), где выполняется обновление. Независимо от обновляемого центра обработки данных, это влияет на работу некоторых API управления во всех центрах обработки данных. Влияние отмечается после каждого этапа.

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

Стратегии модернизации

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

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

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

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

  • Расширьте свой кластер Edge for Private Cloud, добавив временный центр обработки данных рядом с существующим для обработки трафика во время обновления, а затем выведите из эксплуатации один из центров обработки данных после завершения процесса обновления.
  • Если у вас нет возможности расшириться за счет дополнительного центра обработки данных, подготовьтесь к простоям и запланируйте обновление на периоды низкой нагрузки, чтобы минимизировать влияние на API управления и трафик в режиме реального времени.

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

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

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

Откат - высокий уровень

  • Влияние при откате

    Откат с Cassandra 3.11.x до 2.1.x затрагивает как трафик выполнения, так и трафик управления в центре обработки данных (ЦОД), где выполняется откат. Кроме того, некоторые API управления могут испытывать сбои во всех центрах обработки данных, независимо от того, в каком ЦОД в данный момент выполняется откат.

  • Следуйте подходу поэтапного отката DC-DC.

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

  • Откат частично обновленного кластера

    Если хотя бы один центр обработки данных остается полностью работоспособным на более старой версии Cassandra (2.1.22), то другие обновленные центры обработки данных можно откатить, выполнив перестройку с полностью функционального центра обработки данных Cassandra 2.1.X.

  • Откат в масштабе всего кластера

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

  • Вопросы, которые следует учесть перед обновлением

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

Откат кластеров с использованием одного центра обработки данных

Обновление Cassandra с версии 2.1.x до 3.11.x может существенно повлиять на трафик во время выполнения и на работу некоторых API управления. Эти последствия также сохраняются при откате и могут привести к простоям или потере данных.

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

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

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

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

Подробности см. в разделе «Откат обновления Cassandra 3.11.16» .

Шаг 0: Начальное состояние

  • Компоненты Zookeeper, Postgres и LDAP уже обновлены до версии 4.52.02. Ваш Edge для кластера частного облака стабилен и работает. Если потребуется откат, кластер будет возвращен в это состояние.
  • В Apigee установлена ​​Cassandra версии 2.1.22.
  • Краевые компоненты:
    • Сервер управления взаимодействует с Cassandra по устаревшему протоколу Thrift.
    • Серверы среды выполнения (обработчики сообщений и маршрутизаторы) взаимодействуют с Cassandra по устаревшему протоколу Thrift.
Состояние выполнения на данном этапе Состояние управления на данном этапе
Полнофункциональная среда выполнения Управление полностью функционально.

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

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

  1. Измените настройки Cassandra, чтобы она использовала LeveledCompactionStrategy.
  2. Создайте резервную копию Cassandra с помощью Apigee.
  3. Сделайте снимки виртуальных машин узлов Cassandra (если это возможно).
  4. Создайте на каждом узле Cassandra файл конфигурации обновления Cassandra по адресу /opt/apigee/apigee-cassandra/cass_upgrade.conf со следующим содержимым:
    # IP Address of node
HOSTIP=10.0.0.1

# Username for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
CASS_USERNAME=<cassuser>

# Password for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
CASS_PASSWORD=<casspass>

# Port for connecting to Cassandra via thrift. Optional. Defaults to 9160 if skipped.
CASS_PORT=9160

# Port for connecting to Cassandra via CQL. Optional. Defaults to 9042 if skipped.
CASS_CQL_PORT=9042

# Directory to be used by Cassandra upgrade scripts. Optional. Defaults to /tmp/cass_upgrade_scripts if skipped.
# Note that if upgrade is successful, this directory is deleted via root user - so provide a directory accordingly.
CASS_TMP_DIR=/tmp/cass_upgrade_scripts
    Если файл по адресу /opt/apigee/apigee-cassandra/cass_upgrade.conf создать не удаётся, создайте файл /opt/silent.conf с тем же содержимым на каждом узле Cassandra.
  5. Если вы используете функцию SmartDocs на портале разработчиков Apigee Drupal 7, экспортируйте каждую из ваших моделей, загрузив их в формате JSON из пользовательского интерфейса портала разработчиков. Эти модели необходимо будет импортировать обратно в Apigee после обновления серверов управления.
  6. Убедитесь, что порты 9160 и 9042 доступны со всех компонентов Edge для узлов Cassandra, если они еще не подключены. Дополнительную информацию см. в разделе «Требования к портам» .

Шаг 2: Перенаправьте трафик от первого центра обработки данных.

  1. Заблокируйте входящий трафик, используемый в процессе выполнения и управления, из первого центра обработки данных.
  2. Перенаправьте весь трафик и API управления в режиме реального времени на другие функциональные центры обработки данных.
  3. Убедитесь, что трафик во время выполнения и трафик управления успешно обрабатываются другими контроллерами домена (ЦД).

Шаг 3: Обновите все узлы Cassandra в первом центре обработки данных.

  1. Обновите все узлы Cassandra в центре обработки данных по одному. Выполните следующие команды на каждом узле по очереди: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. После обновления узла выполните следующую команду на этом узле, чтобы провести проверку перед продолжением:
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile
     В результате выполнения приведенной выше команды получится что-то вроде: 
    Cassandra version is verified - [cqlsh 5.0.1 | Cassandra 3.11.16 | CQL spec 3.4.4 | Native protocol v3] Metadata is verified
  3. После завершения обновления выполните следующую команду post_upgrade на каждом узле Cassandra по очереди: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade
Состояние выполнения на данном этапе Состояние управления на данном этапе
  • В центрах обработки данных, находящихся на стадии модернизации, блокируется трафик в режиме реального времени.
  • Программа работает в полном объеме и в других центрах обработки данных.

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

Обновите все узлы управления в центре обработки данных: 

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Состояние выполнения на данном этапе Состояние управления на данном этапе
  • В центрах обработки данных, находящихся на стадии модернизации, блокируется трафик в режиме реального времени.
  • Полнофункциональная среда выполнения

Шаг 5: Обновите все узлы среды выполнения в первом центре обработки данных.

Поочередно обновите все маршрутизаторы и узлы обработки сообщений в центре обработки данных: 

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Состояние выполнения на данном этапе Состояние управления на данном этапе
  • В центрах обработки данных, находящихся на стадии модернизации, блокируется трафик в режиме реального времени.
  • Программа работает в полном объеме и в других центрах обработки данных.

Шаг 6: Перенаправьте трафик обратно в первый центр обработки данных.

  • После обновления центра обработки данных First с помощью Cassandra, компонентов среды выполнения и сервера управления, необходимо повторно включить трафик среды выполнения и управления для центра обработки данных First.
  • Обеспечьте бесперебойную передачу данных во время выполнения и управления между центрами обработки данных.

Шаг 7: Модернизация других центров обработки данных

Повторите шаги с 1 по 6 для оставшихся центров обработки данных, по одному за раз, перенаправляя трафик с этих центров, обновляя программное обеспечение Apigee и повторно включая трафик в этих центрах обработки данных.

Шаг 8: Повторите этап обновления на всех узлах управления.

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

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

Шаг 9 — [Необязательно] Импорт смарт-документов, которые были экспортированы ранее.

После обновления всех серверов управления вы сможете импортировать модели смарт-документов, экспортированные на шаге 1. Решение о том, делать это или нет, можно принять позже.

Это необходимо сделать только в том случае, если вы используете портал разработчика на основе Drupal 7 и функцию SmartDocs.

Состояние выполнения на данном этапе Состояние управления на данном этапе
Полнофункциональная среда выполнения Управление полностью функционально.

Шаг 10 — Удаление неиспользуемых таблиц

Выполните следующую команду, чтобы удалить старые неиспользуемые таблицы из кластера Cassandra. До выполнения этой команды вы не сможете использовать некоторые функции Cassandra (например, настройку новой аутентификации — старые механизмы аутентификации будут продолжать работать). Эта команда может быть выполнена только на одном узле кластера. 

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra drop_old_tables -f configFile

Шаг 11 — Обновите все оставшиеся компоненты Edge и другие компоненты для частного облака версии 4.52.02.

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

На данном этапе, если вы выполняете обновление с версий, предшествующих Edge for Private Cloud 4.52.01, выполните следующие дополнительные шаги для обновления Qpid и Postgres , а также обновите остальные компоненты в соответствии с этими шагами.

Перейти на Qpid J-Broker

Несмотря на то, что Edge for Private Cloud 4.52.02 не включает обновление QPID, если вы обновляетесь с версий старше 4.52.01, вам необходимо выполнить шаги по обновлению QPID.

  • При обновлении Edge for Private Cloud с версии 4.51.00 или 4.52.00 до 4.52.02 необходимо выполнить дополнительные шаги по обновлению Qpid. См. раздел «Обновление Qpid», если вы обновляете версию с 4.51.00 или 4.52.00 до 4.52.02.
  • Если вы выполняете обновление с Edge for Private Cloud 4.52.01 до 4.52.02, у вас уже должна быть установлена ​​последняя версия Qpid Broker, и никаких дополнительных шагов по обновлению Qpidupgrade не требуется.

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

В этом разделе перечислены моменты, касающиеся пользовательского интерфейса Edge. Для получения дополнительной информации см. раздел «Новый пользовательский интерфейс Edge для частного облака» .

Установите интерфейс Edge.

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

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

Для получения дополнительной информации см. раздел «Установка нового пользовательского интерфейса Edge» .

Обновите пользовательский интерфейс Edge.

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

  • С версии 4.51.00 до 4.52.00 (с уже установленным новым пользовательским интерфейсом Edge): используйте инструкции по обновлению компонента edge-management-ui приведенные в этом разделе .

Обновление с использованием Apigee mTLS

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

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

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

Если для устранения неполадки требуется откатить обновление до предыдущей версии, см. раздел «Откат версии 4.52.00» для получения подробных инструкций.

Информация об обновлении журнала

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

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

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

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

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

Обновление без простоя, или поэтапное обновление, позволяет обновить вашу установку Edge без остановки работы браузера.

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

Ключ к модернизации без простоев — это последовательное удаление каждого маршрутизатора из балансировщика нагрузки. Затем необходимо обновить маршрутизатор и любые другие компоненты на том же компьютере, что и маршрутизатор, и снова добавить маршрутизатор в балансировщик нагрузки.

  1. Обновите оборудование в правильном порядке для вашей системы, как описано в разделе «Порядок обновления оборудования» .
  2. Когда придёт время обновить маршрутизаторы, выберите любой маршрутизатор и сделайте его недоступным, как описано в разделе «Включение/отключение доступности сервера (обработчика сообщений/маршрутизатора)» .
  3. Обновите выбранный маршрутизатор и все остальные компоненты Edge на том же компьютере, что и маршрутизатор. Во всех конфигурациях Edge отображается маршрутизатор и обработчик сообщений на одном узле.
  4. Восстановите доступность маршрутизатора.
  5. Повторите шаги 2–4 для остальных маршрутизаторов.
  6. Продолжите обновление для всех оставшихся компьютеров в вашей установке.

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

Используйте файл конфигурации для тихой настройки.

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

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

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

  1. Если таковые имеются, отключите все задания cron , настроенные для выполнения операции восстановления Cassandra, до завершения обновления.
  2. Для установки RPM-пакетов Edge войдите в систему на своем узле как root.
  3. Установите yum-utils и yum-plugin-priorities :
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  4. Отключите SELinux, как описано в разделе «Установка утилиты Edge apigee-setup» .
  5. Если вы устанавливаете Oracle на версию 7.x , выполните следующую команду: 
    sudo yum-config-manager --enable ol7_optional_latest
  6. Если вы устанавливаете программу на 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

  7. Если вы используете Edge версии 4.51.00:

    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.52.02.sh
    2. Установите утилиту apigee-service и зависимости для Edge 4.52.02, выполнив следующую команду:
      sudo bash /tmp/bootstrap_4.52.02.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-setup используйте apigee-service , как показано в следующем примере: 
      /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 : Кассандра
        • edge : Все компоненты Edge, кроме пользовательского интерфейса Edge: сервер управления, обработчик сообщений, маршрутизатор, сервер Qpid, сервер Postgres.
        • ldap : OpenLDAP
        • ps .: postgresql
        • qpid : qpidd
        • sso : Apigee SSO (если вы установили SSO)
        • ue : Новый интерфейс Edge
        • ui : Классический интерфейс Edge
        • zk : Смотритель зоопарка
      • configFile — это тот же конфигурационный файл, который вы использовали для определения компонентов Edge во время установки версий 4.50.00 или 4.51.00.

      Вы можете запустить update.sh для всех компонентов, установив component в значение "all", но только если у вас установлен профиль установки Edge "все в одном" (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.52.02».

Обновите версию до 4.52.02 из локального репозитория.

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

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

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

Для обновления из локального репозитория версии 4.52.02:

  1. Создайте локальный репозиторий версии 4.52.02, как описано в разделе «Создание локального репозитория Apigee» в инструкции по установке утилиты Edge apigee-setup .
  2. Для установки apigee-service из .tar-архива :
    1. On the node with the local repo, use the following command to package the local repo into a single .tar file named /opt/apigee/data/apigee-mirror/apigee-4.52.02.tar.gz : 
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. Copy the .tar file to the node where you want to update Edge. For example, copy it to the /tmp directory on the new node.
    3. On the new node, untar the file to the /tmp directory:
      tar -xzf apigee-4.52.02.tar.gz

      This command creates a new directory, named repos , in the directory containing the .tar file. For example /tmp/repos .

    4. Install the Edge apigee-service utility and dependencies from /tmp/repos :
      sudo bash /tmp/repos/bootstrap_4.52.02.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      Notice that you include the path to the repos directory in this command.

  3. To install apigee-service using the Nginx webserver:
    1. Configure the Nginx web server as described in "Install from the repo using the Nginx webserver" at Install the Edge apigee-setup utility .
    2. On the remote node, download the Edge bootstrap_4.52.02.sh file to /tmp/bootstrap_4.52.02.sh :
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh

      Where uName:pWord are the username and password you set previously for the repo, and remoteRepo is the IP address or DNS name of the repo node.

    3. On the remote node, install the Edge apigee-setup utility and dependencies:
      sudo bash /tmp/bootstrap_4.52.02.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      Where uName:pWord are the repo username and password.

  4. Use apigee-service to update the apigee-setup utility, as the following example shows: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  5. Update the apigee-validate utility on the Management Server, as the following example shows: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  6. Update the apigee-provision utility on the Management Server, as the following example shows: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  7. Run the update utility on your nodes in the order described in Order of machine update :
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    Где:

    • component is the Edge component to update. You typically update the following components:
      • cs : Cassandra
      • edge : All Edge components except Edge UI: Management Server, Message Processor, Router, Qpid Server, Postgres Server
      • ldap : OpenLDAP
      • ps : postgresql
      • qpid : qpidd
      • sso : Apigee SSO (if you installed SSO)
      • ue New Edge UI
      • ui : Classic Edge UI
      • zk : Zookeeper
    • configFile is the same configuration file that you used to define your Edge components during the 4.50.00 or 4.51.00 installation.

    You can run update.sh against all components by setting component to "all", but only if you have an Edge all-in-one (AIO) installation profile. For example: 

    /opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
  8. Restart the UI components on all nodes running it, if you haven't done so already: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
  9. Test the update by running the apigee-validate utility on the Management Server, as described in Test the install .

If you later decide to roll back the update, use the procedure described in Roll back 4.52.02 .

Order of machine update - upgrade from 4.51.00 (or) 4.52.00 (or) 4.52.01

The order that you update the machines in an Edge installation is important:

  • You must update all ZooKeeper nodes across data centers before upgrading all other components. If you are upgrading from Edge Private Cloud 4.51.00 (or) 4.52.00, you will also need to follow additional steps to upgrade zookeeper .
  • You must update Postgresql across all the data centers. If you are upgrading from Edge Private Cloud 4.51.00, you will also need to follow additional steps to upgrade postgres .
  • You must update LDAP nodes across all the data centers.
  • You must update all Cassandra, Management Server, Message Processor and Router nodes, one data center at a time , until all data centers are upgraded.
  • You must update edge-qpid-server & edge-postgres-server components across all data centers.
  • You must upgrade Qpid nodes across all data centers. If you are upgrading from Edge Private Cloud 4.51.00 (or) 4.52.00, you will also need to follow additional steps to upgrade Qpid .
  • Update Edge UI and New Edge UI, SSO nodes across all data centers.
  • There is no separate step to update Monetization. It is updated when you specify the -c edge option.

1-node standalone upgrade

To upgrade a 1-node standalone configuration to 4.52.02:
  1. Update all components: 
    /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
  2. (If you installed apigee-adminapi ) Updated the apigee-adminapi utility: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

2-node standalone upgrade

Update the following components for a 2-node standalone installation:

See Installation topologies for the list of Edge topologies and node numbers.

  1. Update Zookeeper on machine 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. Update Postgres on machine 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Update LDAP on machine 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. Update Cassandra on machine 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  5. Update Edge components on machine 1 and 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Update Qpid on Machine 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Update the UI on machine 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. (If you installed apigee-adminapi ) Updated the apigee-adminapi utility on machine 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (If you installed Apigee SSO) Update Apigee SSO on machine 1:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Where sso_config_file is the configuration file you created when you installed SSO .

  10. Restart the Edge UI component on machine 1: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

5-node upgrade

Update the following components for a 5-node installation:

See Installation topologies for the list of Edge topologies and node numbers.

  1. Update ZooKeeper on machines 1, 2, and 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. Update Postgres on machine 4: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Update Postgres on machine 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Update LDAP on machine 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Update Cassandra on machines 1, 2, and 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  6. Update Edge components on machines 1, 2, 3, 4, 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Update Qpid on machine 4: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Update Qpid on machine 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  9. Update the Edge UI:
    • Classic UI: If you are using the classic UI, then update the ui component on machine 1, as the following example shows: 
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    • New Edge UI: If you installed the new Edge UI, then update the ue component on the appropriate machine (may not be machine 1): 
      /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
  10. (If you installed apigee-adminapi ) Updated the apigee-adminapi utility on machine 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  11. (If you installed Apigee SSO) Update Apigee SSO on machine 1:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Where sso_config_file is the configuration file you created when you installed SSO .

  12. Restart the UI component:
    • Classic UI: If you are using the classic UI, then restart the edge-ui component on machine 1, as the following example shows: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • New Edge UI: If you installed the new Edge UI, then restart the edge-management-ui component on the appropriate machine (may not be machine 1): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

9-node cluster upgrade

Update the following components for a 9-node clustered installation:

See Installation topologies for the list of Edge topologies and node numbers.

  1. Update ZooKeeper on machine 1, 2, and 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. Update Postgres on machine 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Update Postgres on machine 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Update LDAP on machine 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Update Cassandra on machine 1, 2, and 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  6. Update Edge components on machines 1, 4, 5, 6, 7, 8, and 9 in that order: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Update Qpid on machines 6 and 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Update either the new UI ( ue ) or classic UI ( ui ) on machine 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  9. (If you installed apigee-adminapi ) Update the apigee-adminapi utility on machine 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  10. (If you installed Apigee SSO) Update Apigee SSO on machine 1:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Where sso_config_file is the configuration file you created when you installed SSO .

  11. Restart the UI component:
    • Classic UI: If you are using the classic UI, then restart the edge-ui component on machine 1, as the following example shows: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • New Edge UI: If you installed the new Edge UI, then restart the edge-management-ui component on the appropriate machine (may not be machine 1): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

13-node cluster upgrade

Update the following components for a 13-node clustered installation:

See Installation topologies for the list of Edge topologies and node numbers.

  1. Update ZooKeeper on machines 1, 2, and 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. Update Postgres on machine 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Update Postgres on machine 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Update LDAP on machines 4 and 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Update Cassandra on machines 1, 2, and 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  6. Update Edge components on machines 6, 7, 10, 11, 12, 13, 8, and 9 in that order: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Update Qpid on machines 12 and 13: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Update either the new UI ( ue ) or classic UI ( ui ) on machines 6 and 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  9. (If you installed apigee-adminapi ) Updated the apigee-adminapi utility on machines 6 and 7: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  10. (If you installed Apigee SSO) Update Apigee SSO on machines 6 and 7:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Where sso_config_file is the configuration file you created when you installed SSO .

  11. Restart the UI component:
    • Classic UI: If you are using the classic UI, then restart the edge-ui component on machines 6 and 7, as the following example shows: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • New Edge UI: If you installed the new Edge UI, then restart the edge-management-ui component on machines 6 and 7: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

12-node cluster upgrade

Update the following components for a 12-node clustered installation:

See Installation topologies for the list of Edge topologies and node numbers.

  1. Update ZooKeeper on machines 1,2,3,7,8,9 in both DCs: 

    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. Update Postgres on machines 6,12 in both DCs: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Update LDAP on machines 1,7 in both DCs: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

  4. Block the traffic in DC-1 and make sure all the traffic rerouted to other DC-2

  5. Update Update Cassandra on machine 1,2,3 in DC-1: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  6. Update Management Server on machine 1 in DC-1: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Update Router, Message Processor on machine 2,3 in DC-1: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. Unblock the traffic in DC-1 and validate the DC-1 and proceed with the DC-2 by blocking traffic in DC-2 and reroute the traffic to DC-1
  9. Update Cassandra on machine 7,8,9 in DC-2: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  10. Update Management Server on machine 7 in DC-2: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. Update Router, Message Processor on machine 8,9 in DC-2: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. Unblock the traffic in DC-2 and now, both DCs will handle traffic
  13. Re-run the update command in all the management-server across DCs on machine 1 & 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  14. Update edge-qpid-server & edge-postgres-server on machine 4,5,6,10,11,12 in both DCs: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  15. Update Qpid on machine 4,5,10,11 in both DCs: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  16. Update either the new UI (ue) or classic UI (ui) in both DCs: 
    /opt/apigee/apigee-setup/bin/update.sh -c  [ui|ue] -f configFile
  17. (If you installed apigee-adminapi) Update the apigee-adminapi in both DCs: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  18. (If you installed Apigee SSO) Update Apigee SSO nodes in both DCs: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile
  19. Restart the new Edge UI (edge-management-ui) or classic Edge UI (edge-ui) component in both DCs: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart