Обновите 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.

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

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

Вам необходимо обновить все компоненты 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 , Кассандра , 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.

Обновление до 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 не требуется.

Обновление до Кассандры 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, не будут автоматически перенесены в более новую версию. Предполагается, что вы вручную экспортируете каждую модель с помощью портала разработчика и снова импортируете ее после завершения обновления.

Терминология, используемая ниже

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

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

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

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

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

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

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

Единый дата-центр

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

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

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

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

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

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

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

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

  • Следуйте подходу DC by DC Rollback

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

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

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

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

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

  • Рекомендации перед обновлением

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

Откат-кластеры с единым дата-центром

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

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

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

Кластеры отката с несколькими дата-центрами

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

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

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

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

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

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

  1. Измените Cassandra, чтобы она использовала LeveledCompactionStrategy.
  2. Сделайте резервную копию Кассандры с помощью 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 к 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. Обновите все рабочие узлы в первом центре обработки данных.

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

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

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

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

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

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

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

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

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

Чтобы обновить компонент пользовательского интерфейса Edge, рассмотрите версию 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.

Обновление с нулевым временем простоя возможно только в конфигурации с 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. Войдите на свой узел как root, чтобы установить Edge RPM.
  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-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: сервер управления, процессор сообщений, маршрутизатор, сервер Qpid, сервер Postgres.
        • ldap : OpenLDAP
        • ps : постгреск
        • qpid : qpidd
        • sso : Apigee SSO (если вы установили SSO)
        • ue : новый интерфейс Edge
        • ui : Классический интерфейс Edge.
        • zk : Смотритель зоопарка
      • configFile — это тот же файл конфигурации, который вы использовали для определения компонентов Edge во время установки 4.50.00 или 4.51.00.

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

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

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

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

  1. Создайте локальный репозиторий 4.52.02, как описано в разделе «Создание локального репозитория Apigee» в разделе «Установка утилиты Edge apigee-setup» .
  2. Чтобы установить сервис apigee из файла .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 Webserver:
    1. Настройте веб-сервер NGINX, как описано в « Утилита« Установить из репо с использованием NGINX Webserver », на установке Edge Apigee-Setup .
    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 является краевым компонентом для обновления. Вы обычно обновляете следующие компоненты:
      • cs : Кассандра
      • edge : Все компоненты края, кроме Edge UI: сервер управления, процессор сообщений, маршрутизатор, сервер QPID, Postgres Server
      • ldap : OpenLDAP
      • ps : Postgresql
      • qpid : QPIDD
      • sso : Apigee SSO (если вы установили SSO)
      • ue New Edge UI
      • ui : классический интерфейс Edge
      • zk : Zookeeper
    • configFile - это тот же файл конфигурации, который вы использовали для определения ваших краевых компонентов во время установки 4.50.00 или 4.51.00.

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

Если вы позже решите отменить обновление, используйте процедуру, описанную в Roll Back 4.52.02 .

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

Порядок, который вы обновляете машины в установке края, важен:

  • Вы должны обновить все узлы Zookeeper через центры обработки данных, прежде чем обновить все другие компоненты. Если вы обновляетесь с Edge Private Cloud 4.51.00 (или) 4.52.00, вам также необходимо будет выполнить дополнительные шаги по обновлению Zookeeper .
  • Вы должны обновить PostgreSQL во всех центрах обработки данных. Если вы обновляетесь с Edge Private Cloud 4.51.00, вам также нужно будет выполнить дополнительные шаги для обновления Postgres .
  • Вы должны обновить узлы LDAP во всех центрах обработки данных.
  • Вы должны обновить все узлы Cassandra, сервер управления, процессор сообщений и маршрутизатор, по одному центру обработки данных , пока все центры обработки данных не будут обновлены.
  • Вы должны обновить компоненты edge-qpid-server и edge-postgres-server во всех центрах обработки данных.
  • Вы должны обновить узлы QPID во всех центрах обработки данных. Если вы обновляетесь с Edge Private Cloud 4.51.00 (или) 4.52.00, вам также необходимо будет выполнить дополнительные шаги для обновления QPID .
  • Обновление Edge UI и новый Edge UI, SSO -узлы во всех центрах обработки данных.
  • Нет отдельного шага для обновления монетизации. Он обновляется, когда вы указываете опцию -c Edge.

1-узловое автономное обновление

Чтобы обновить 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

2-узловое автономное обновление

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

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

  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. Обновлять края компонентов на машине 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 на машине 1: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

5-узловое обновление

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

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

  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. Обновления края компонентов на машинах 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. Обновите пользовательский интерфейс:
    • Классический пользовательский интерфейс: если вы используете классический пользовательский интерфейс, то обновите компонент ui на машине 1, как показано в следующем примере: 
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    • New Edge UI: если вы установили новый Edge UI, то обновите компонент 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
    • New Edge UI: если вы установили новый Edge UI, перезапустите компонент edge-management-ui на соответствующей машине (не может быть машиной 1): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

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

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

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

  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. Обновления края компонентов на машинах 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
    • New Edge UI: если вы установили новый Edge UI, перезапустите компонент edge-management-ui на соответствующей машине (не может быть машиной 1): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

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

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

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

  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. Обновлять края компонентов на машинах 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
    • New Edge UI: если вы установили новый Edge UI, перезапустите компонент edge-management-ui на машинах 6 и 7: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

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

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

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

  1. Обновление Zookeeper на машинах 1,2,3,7,8,9 в обоих DCS: 

    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. Обновите постгры на машинах 6,12 в обоих DC: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Обновите LDAP на машинах 1,7 в обоих DCS: 
    /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. Обновить маршрутизатор, процессор сообщений на машине 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. Обновить маршрутизатор, процессор сообщений на машине 8,9 в DC-2: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. Разблокировать трафик в DC-2, а теперь оба DC будут обрабатывать трафик
  13. Повторно запустите команду Update во всех управленческих серверах в DCS на машине 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 в обоих DCS: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  15. Обновите QPID на машине 4,5,10,11 в обоих DC: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  16. Обновите новый пользовательский интерфейс (UE) или классический пользовательский интерфейс (пользовательский интерфейс) в обоих DCS: 
    /opt/apigee/apigee-setup/bin/update.sh -c  [ui|ue] -f configFile
  17. (Если вы установили Apigee-Adminapi) Обновите Apigee-Adminapi в обоих DC: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  18. (Если вы установили Apigee SSO) Обновите узлы Apigee SSO в обоих DC: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile
  19. Перезапустите новый Edge UI (Edge-Management-UI) или классический Edge UI (Edge-UI) в обоих DC: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart