Как обновить Apigee Edge 4.51.00, 4.52.00 или 4.52.01 до версии 4.52.02

Apigee поддерживает обновление Edge для 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 Cassandra
4.52.00 Zookeeper, Cassandra, 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 для Private Cloud версии 4.51.00 или 4.52.00, следуйте инструкциям в разделе Обязательное обновление до Zookeeper 3.8.3, чтобы обновить Zookeeper.
  • Если вы обновляете Edge для частного облака версии 4.52.01, вы уже должны использовать Zookeeper версии 3.8.3, и вам не нужно выполнять никаких специальных действий для обновления Zookeeper.

Переход на Postgres 14

  • Если вы переходите с Edge for Private Cloud 4.51.00 на 4.52.02, вам необходимо выполнить действия по обновлению Postgres, даже если Edge for Private Cloud 4.52.02 не включает обновление Postgres. При обновлении Edge для частного облака с версии 4.51.00 до 4.52.02 требуются дополнительные действия по обновлению Postgres. Ознакомьтесь с разделом Обязательное обновление до Postgres 14.
  • Если вы обновляете Edge для 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, чтобы обеспечить оптимальную производительность в новых версиях. Хотя эти изменения минимальны, процесс обновления нарушает работу некоторых Management API, когда обновление запускается. Точные Management API, которые обычно нарушаются, перечислены в соответствующих разделах ниже.

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

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

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

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

Терминология

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

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

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

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

Стратегии обновления

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

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

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

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

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

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

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

Описанные выше последствия дополняют конкретные Management API, которые останутся нефункциональными во всех центрах обработки данных до тех пор, пока все центры обработки данных не будут обновлены. Такие Management 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 может значительно повлиять на трафик во время выполнения и некоторые Management API. Эти последствия также применимы во время отката и могут привести к простою или потере данных.

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

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

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

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

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

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

  • Компоненты Zookeeper, Postgres и LDAP уже обновлены до версии 4.52.02. Ваш кластер Edge для частного облака стабилен и работает. Если потребуется откат, кластер будет возвращен к этому состоянию.
  • Cassandra в Apigee версии 2.1.22.
  • Компоненты Edge:
    • Сервер управления взаимодействует с Cassandra по устаревшему протоколу Thrift.
    • Серверы среды выполнения (Message Processor и Router) взаимодействуют с 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. Перенаправьте весь трафик среды выполнения и Management 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. После завершения обновления поочередно выполните на каждом узле Cassandra следующую команду post_upgrade: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade
Состояние среды выполнения на этом этапе Статус управления на этом этапе
  • Трафик среды выполнения заблокирован в центрах обработки данных, которые обновляются
  • Среда выполнения полностью функционирует в других центрах обработки данных.

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

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

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

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

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

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

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

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

Шаг 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 и другие компоненты для Private Cloud 4.52.02

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

Если вы обновляете Edge для Private Cloud версии 4.52.01 или более ранней, выполните дополнительные действия для обновления Qpid и Postgres, а затем обновите остальные компоненты, следуя этим инструкциям.

Переход на Qpid J-Broker

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

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

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

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

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

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

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

Подробнее о том, как установить новый интерфейс Edge…

Обновление интерфейса Edge

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

Обновление с помощью 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 без отключения.

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

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

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

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

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

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

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

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

  1. Если у вас есть задания cron, настроенные на выполнение операции восстановления в Cassandra, отключите их до завершения обновления.
  2. Войдите в узел как root, чтобы установить Edge RPM.
  3. Установите yum-utils и yum-plugin-priorities. 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  4. Отключите SELinux, как описано в разделе Установка утилиты apigee-setup для Edge.
  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. Установите утилиту Edge 4.52.02 apigee-service и зависимости, выполнив следующую команду: 
      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-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: Кассандра
        • edge: все компоненты Edge, кроме Edge UI: Management Server, Message Processor, Router, Qpid Server, Postgres Server.
        • 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 UI на всех узлах, на которых они запущены, если вы ещё этого не сделали: 
      /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
    8. Протестируйте обновление, запустив утилиту apigee-validate на сервере управления, как описано в разделе Тестирование установки.

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

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

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

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

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

Чтобы выполнить обновление из локального хранилища 4.52.02:

  1. Создайте локальное хранилище 4.52.02, как описано в разделе "Создание локального хранилища Apigee" в статье Установка утилиты apigee-setup для Edge.
  2. Чтобы установить apigee-service из TAR-файла, выполните следующие действия:
    1. На узле с локальным хранилищем используйте следующую команду, чтобы упаковать локальное хранилище в один файл .tar с именем /opt/apigee/data/apigee-mirror/apigee-4.52.02.tar.gz: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. Скопируйте TAR-файл на узел, на котором вы хотите обновить Edge. Например, скопируйте его в каталог /tmp на новом узле.
    3. На новом узле распакуйте файл в каталог /tmp: 
      tar -xzf apigee-4.52.02.tar.gz

      Эта команда создает новый каталог с названием repos в каталоге, содержащем файл TAR. Пример: /tmp/repos.

    4. Установите утилиту Edge apigee-service и зависимости из /tmp/repos: 
      sudo bash /tmp/repos/bootstrap_4.52.02.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      Обратите внимание, что в эту команду вы включаете путь к каталогу repos.

  3. Чтобы установить apigee-service с помощью веб-сервера Nginx:
    1. Настройте веб-сервер Nginx, как описано в разделе "Установка из репозитория с помощью веб-сервера Nginx" в статье Как установить утилиту apigee-setup для Edge.
    2. На удаленном узле скачайте файл Edge bootstrap_4.52.02.sh в каталог /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

      где uName:pWord – имя пользователя и пароль, которые вы ранее задали для хранилища, а remoteRepo – IP-адрес или DNS-имя узла хранилища.

    3. На удаленном узле установите утилиту Edge apigee-setup и зависимости: 
      sudo bash /tmp/bootstrap_4.52.02.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      где uName:pWord – имя пользователя и пароль репозитория.

  4. Используйте apigee-service, чтобы обновить утилиту apigee-setup, как показано в примере ниже. 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  5. Обновите утилиту apigee-validate на сервере управления, как показано в примере ниже. 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  6. Обновите утилиту apigee-provision на сервере управления, как показано в примере ниже. 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  7. Запустите утилиту update на узлах в порядке, описанном в разделе Порядок обновления компьютеров. 
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    Где:

    • component – компонент Edge, который нужно обновить. Обычно обновляются следующие компоненты:
      • cs: Кассандра
      • edge: все компоненты Edge, кроме Edge UI: Management Server, Message Processor, Router, Qpid Server, Postgres Server.
      • 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 /tmp/sa_silent_config
  8. Перезапустите компоненты пользовательского интерфейса на всех узлах, на которых они запущены, если вы ещё этого не сделали: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
  9. Протестируйте обновление, запустив утилиту apigee-validate на сервере управления, как описано в разделе Тестирование установки.

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

Порядок обновления машины – обновление с версии 4.51.00, 4.52.00 или 4.52.01

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

  • Прежде чем обновлять все остальные компоненты, необходимо обновить все узлы ZooKeeper в центрах обработки данных. Если вы переходите с Edge Private Cloud 4.51.00 или 4.52.00, вам также нужно будет выполнить дополнительные действия, чтобы обновить zookeeper.
  • Postgresql необходимо обновить во всех центрах обработки данных. Если вы обновляете Edge Private Cloud 4.51.00, вам также потребуется выполнить дополнительные действия, чтобы обновить postgres.
  • Вам нужно обновить узлы LDAP во всех центрах обработки данных.
  • Вы должны обновить все узлы Cassandra, Management Server, Message Processor и Router, по одному центру обработки данных за раз, пока не будут обновлены все центры обработки данных.
  • Вам необходимо обновить компоненты edge-qpid-server и edge-postgres-server во всех центрах обработки данных.
  • Обновите узлы Qpid во всех центрах обработки данных. Если вы переходите с Edge Private Cloud 4.51.00 или 4.52.00, вам также потребуется выполнить дополнительные действия, чтобы обновить Qpid.
  • Обновите интерфейс Edge, новый интерфейс Edge и узлы SSO во всех центрах обработки данных.
  • Отдельно обновлять Монетизацию не нужно. Он обновляется, когда вы указываете параметр -c edge.

Отдельная лицензия на 1 узел

Чтобы обновить автономную конфигурацию с одним узлом до версии 4.52.02:
  1. Обновите все компоненты: 
    /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
  2. Если вы установили apigee-adminapi, обновите утилиту apigee-adminapi: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

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

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

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

  1. Обновите Zookeeper на машине 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. Обновите Postgres на машине 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Обновите LDAP на компьютере 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. Обновите Cassandra на машине 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  5. Обновите компоненты Edge на компьютерах 1 и 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Обновите Qpid на компьютере 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Обновите интерфейс на машине 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. (Если вы установили apigee-adminapi) Обновите утилиту apigee-adminapi на компьютере 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (Если вы установили Apigee SSO) Обновите Apigee SSO на компьютере 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    где sso_config_file – это файл конфигурации, созданный при установке SSO.

  10. Перезапустите компонент Edge UI на компьютере 1: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Обновление с 5 узлами

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

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

  1. Обновите ZooKeeper на компьютерах 1, 2 и 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. Обновите Postgres на машине 4: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Обновите Postgres на компьютере 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Обновите LDAP на компьютере 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Обновите Cassandra на компьютерах 1, 2 и 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  6. Обновите компоненты Edge на компьютерах 1, 2, 3, 4, 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Обновите Qpid на машине 4: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Обновите Qpid на компьютере 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  9. Обновите интерфейс 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
  10. (Если вы установили apigee-adminapi) Обновите утилиту apigee-adminapi на компьютере 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  11. (Если вы установили Apigee SSO) Обновите Apigee SSO на компьютере 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    где sso_config_file – файл конфигурации, созданный при установке SSO.

  12. Перезапустите компонент интерфейса:
    • Классический интерфейс. Если вы используете классический интерфейс, перезапустите компонент 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

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

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

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

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

    где sso_config_file – файл конфигурации, созданный при установке SSO.

  11. Перезапустите компонент интерфейса:
    • Классический интерфейс. Если вы используете классический интерфейс, перезапустите компонент 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 и номеров узлов приведен в разделе Топологии установки.

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

    где sso_config_file – файл конфигурации, созданный при установке SSO.

  11. Перезапустите компонент интерфейса:
    • Классический интерфейс. Если вы используете классический интерфейс, перезапустите компонент 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 и номеров узлов приведен в разделе Топологии установки.

  1. Обновите ZooKeeper на компьютерах 1,2,3,7,8,9 в обоих контроллерах домена:

    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. Обновите Postgres на компьютерах 6 и 12 в обоих центрах обработки данных: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Обновите LDAP на компьютерах 1 и 7 в обоих ЦОД: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

  4. Заблокировать трафик в DC-1 и убедиться, что весь трафик перенаправлен в DC-2

  5. Обновите Cassandra на компьютерах 1, 2 и 3 в DC-1: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  6. Обновите сервер управления на машине 1 в DC-1: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Обновите Router и Message Processor на компьютерах 2 и 3 в DC-1: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. Разблокируйте трафик в DC-1, проверьте DC-1 и перейдите к DC-2, заблокировав трафик в DC-2 и перенаправив его в DC-1.
  9. Обновите Cassandra на машинах 7,8,9 в DC-2: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  10. Обновите сервер управления на компьютере 7 в DC-2: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. Обновите Router и Message Processor на компьютерах 8 и 9 в DC-2: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. Разблокируйте трафик в ЦОД-2. Теперь оба ЦОД будут обрабатывать трафик.
  13. Повторно выполните команду обновления на всех серверах управления в центрах обработки данных на компьютерах 1 и 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  14. Обновите edge-qpid-server и edge-postgres-server на машинах 4,5,6,10,11,12 в обоих ЦОД: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  15. Обновите Qpid на компьютерах 4, 5, 10 и 11 в обоих центрах обработки данных: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  16. Обновите новый (ue) или классический (ui) интерфейс в обоих ЦОД: 
    /opt/apigee/apigee-setup/bin/update.sh -c  [ui|ue] -f configFile
  17. Если вы установили apigee-adminapi, обновите его в обоих ЦОД: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  18. Если вы установили Apigee SSO, обновите узлы Apigee SSO в обоих ЦОД: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile
  19. Перезапустите компонент нового пользовательского интерфейса Edge (edge-management-ui) или классического пользовательского интерфейса Edge (edge-ui) в обоих ЦОД: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart