Обновите 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 установлено значение LeveledCompactionStrategy , как описано в разделе Изменение стратегии сжатия Cassandra .

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

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

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

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

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

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

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

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

Откат высокого уровня

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

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

Более подробную информацию можно найти в разделе Откат обновления Cassandra 3.11.16 .

Документирование API на портале разработчика

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

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

Терминология, используемая в следующих разделах

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

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

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

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

  1. Кассандра в Apigee работает с версией 2.1.22.
  2. Компоненты Edge для частного облака 4.52.02:
    • Сервер управления взаимодействует с 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.
  • Если вы используете функцию SmartDocs на портале разработчиков Apigee Drupal 7, экспортируйте каждую из своих моделей, загрузив их в формате JSON из пользовательского интерфейса портала разработчика. Эти модели необходимо будет импортировать обратно в Apigee после обновления серверов управления.
  • Убедитесь, что порты 9160 и 9042 доступны из всех компонентов Edge for Private Cloud 4.52.02 на узлы Cassandra, если они еще не имеются. Дополнительную информацию см. в разделе «Требования к порту» .

Шаг 2. Обновите все узлы 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
  3. Вышеупомянутое выведет что-то вроде: 
    Cassandra version is verified - [cqlsh 5.0.1 | Cassandra 3.11.16 | CQL spec 3.4.4 | Native protocol v3] Metadata is verified
Состояние выполнения на данном этапе Состояние управления на данном этапе
Полностью функциональная среда выполнения После обновления Cassandra ухудшаются следующие функции управления:

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

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

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Состояние времени выполнения Состояние управления
Полностью функциональная среда выполнения API управления ухудшился:

Шаг 3a: [необязательно] Импортируйте ранее экспортированные документы SmartDocs.

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

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

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

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

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Состояние времени выполнения Состояние управления
Полнофункциональная среда выполнения Управление полностью функциональное

Шаг 5. Обновите все оставшиеся компоненты Edge for Private Cloud 4.52.02.

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

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

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

Шаг 6. Действия после обновления

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

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade

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

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

Выполните шаг 3а, если вы еще этого не сделали.

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

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

Требуется обновление до 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-ui restart
    8. Проверьте обновление, запустив утилиту apigee-validate на сервере управления, как описано в разделе «Проверка установки» .

Если позже вы решите откатить обновление, воспользуйтесь процедурой, описанной в разделе «Откат 4.52.02» .

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

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

После создания локального репозитория 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

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

  3. Чтобы установить сервис apigee с помощью веб-сервера Nginx:
    1. Настройте веб-сервер Nginx, как описано в разделе «Установка из репозитория с помощью веб-сервера Nginx» в разделе «Установка утилиты 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 — это компонент 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 /tmp/sa_silent_config
  8. Перезапустите компоненты пользовательского интерфейса на всех узлах, на которых они выполняются, если вы еще этого не сделали: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
  9. Проверьте обновление, запустив утилиту apigee-validate на сервере управления, как описано в разделе «Проверка установки» .

Если позже вы решите откатить обновление, воспользуйтесь процедурой, описанной в разделе «Откат 4.52.02» .

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

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

  • Вы должны обновить все узлы Cassandra и ZooKeeper, прежде чем обновлять любые другие узлы.
  • Для любого компьютера с несколькими пограничными компонентами (сервер управления, процессор сообщений, маршрутизатор, сервер QPID, но не сервер Postgres) используйте параметр -c edge , чтобы обновить их все одновременно.
  • Если для шага указано, что его следует выполнить на нескольких компьютерах, выполните его в указанном порядке компьютеров.
  • Для обновления монетизации не требуется отдельного шага. Он обновляется, когда вы указываете опцию -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 узла

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

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

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

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

  9. Перезапустите компонент пользовательского интерфейса Edge на компьютере 1: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

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

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

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

  1. Обновите Cassandra и ZooKeeper на машинах 1, 2 и 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,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. Обновите компоненты Edge на машинах 4, 5, 1, 2, 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Обновите Qpid на машине 4: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Обновите Qpid на машине 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Обновите пользовательский интерфейс 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
  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

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

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

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

  1. Обновите Cassandra и ZooKeeper на машинах 1, 2 и 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,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. Обновите компоненты Edge на машинах 6, 7, 8, 9, 1, 4 и 5 в следующем порядке: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Обновите Qpid на машинах 6 и 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Обновите новый пользовательский интерфейс ( ue ) или классический пользовательский интерфейс ( ui ) на компьютере 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -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: если вы установили новый пользовательский интерфейс Edge, перезапустите компонент edge-management-ui на соответствующем компьютере (может быть не на компьютере 1): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

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

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

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

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

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

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

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

  9. Перезапустите новый Edge UI ( edge-management-ui ) или Classic Edge UI ( edge-ui ) на машинах 1 и 7: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart

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

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

  1. Работник зоопарка
  2. Кассандра
  3. пс
  4. ЛДАП
  5. Edge, означающий профиль «-c Edge» на всех узлах в порядке: узлы с сервером QPID, сервером Edge Postgres, сервером управления, процессором сообщений и маршрутизатором.
  6. qpidd
  7. Edge UI (классический или новый)
  8. apigee-adminapi
  9. Apigee SSO

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