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

Apigee поддерживает обновление Edge для частного облака непосредственно с версий 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 for 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 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 для частного облака 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, не будут автоматически перенесены в новую версию. Вам нужно вручную экспортировать каждую модель через портал для разработчиков и импортировать ее снова после обновления.

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

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

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

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

На каждом этапе ниже описано состояние среды выполнения и управления.

Стратегии перехода

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

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

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

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

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

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

  • Обновление токенов OAuth API среды выполнения
  • API времени выполнения с использованием правила "Объект доступа"
  • API управления, в которых перечислены приложения разработчиков
  • API для управления информацией о товарах

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

Откат (общие сведения)

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

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

  • Как выполнить откат для каждого центра обработки данных

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

  • Как откатить частично обновленный кластер

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

  • Откат на уровне кластера

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

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

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

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

При обновлении Cassandra с версии 2.1.x до 3.11.x может значительно измениться трафик во время выполнения и некоторые 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.
    • Серверы времени выполнения (процессоры сообщений и маршрутизаторы), взаимодействующие с 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 в центре обработки данных 1 по очереди. Выполните следующие команды на каждом узле по очереди: 
    /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. Обновите все узлы среды выполнения в первом центре обработки данных

Поочередно обновите все узлы маршрутизаторов и 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 для частного облака 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. Если вы переходите с версии 4.51.00 или 4.52.00 на версию 4.52.02, ознакомьтесь с разделом Обновление Qpid.
  • Если вы обновляете Edge для частного облака с версии 4.52.01 до 4.52.02, то у вас уже должна быть установлена последняя версия брокера Qpid, и никаких дополнительных действий по обновлению Qpid выполнять не нужно.

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

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

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

После завершения первоначальной установки Apigee рекомендует установить интерфейс Edge, который представляет собой улучшенный пользовательский интерфейс для разработчиков и администраторов 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, не отключая Edge.

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

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

  1. Обновите машины в правильном порядке, как описано в разделе Порядок обновления машин.
  2. Когда придет время обновить маршрутизаторы, выберите любой из них и сделайте его недоступным, как описано в разделе Включение и отключение доступности сервера (процессора сообщений или маршрутизатора).
  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, чтобы установить пакеты RPM Edge.
  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: Cassandra
        • 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 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.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: Cassandra
      • 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 All-in-One (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, сервера управления, Message Processor и маршрутизатора, по одному центру обработки данных за раз, пока все центры обработки данных не будут обновлены.
  • Вам необходимо обновить компоненты edge-qpid-server и edge-postgres-server во всех центрах обработки данных.
  • Вам необходимо обновить узлы Qpid во всех центрах обработки данных. Если вы переходите с Edge Private Cloud 4.51.00 или 4.52.00, вам также нужно будет выполнить дополнительные действия, чтобы обновить Qpid.
  • Обновите интерфейс Edge и новый интерфейс Edge, а также узлы SSO во всех центрах обработки данных.
  • Отдельно обновлять монетизацию не нужно. Он обновляется, когда вы указываете параметр края -c.

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

Чтобы обновить конфигурацию с одним узлом до версии 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

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

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

Список топологий 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

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

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

Список топологий 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) интерфейс на компьютере 1: 
    /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. Обновите маршрутизатор и 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. Обновите маршрутизатор и Message Processor на машинах 8 и 9 в DC-2: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. Разблокируйте трафик в DC-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