Обновите Apigee Edge с 4.52.02 до 4.53.00.

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

Обзор совместимых путей обновления см. в матрице совместимости обновлений для выпусков Edge for Private Cloud .

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

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

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

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

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

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

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

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

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

• Убедитесь, что Edge работает
  Убедитесь, что Edge запущен и работает во время процесса обновления, с помощью команды:

  /opt/apigee/apigee-service/bin/apigee-all status

• Проверьте предварительные требования Cassandra
  

  Если вы ранее обновили Edge for Private Cloud со старой версии до версии 4.52.02 и теперь планируете обновление до версии 4.53.00, убедитесь, что вы выполнили необходимые действия после обновления для Cassandra. Эти действия описаны в документации по обновлению до версии 4.52.02, а также в разделе «Предварительные условия для обновления Cassandra» . Если вы не уверены, были ли выполнены эти действия при предыдущем обновлении, выполните их ещё раз, прежде чем переходить к обновлению до версии 4.53.00.

• Настройка ключей и сертификатов IDP в Edge для частного облака 4.53.00
  

  В Edge for Private Cloud 4.53.00 ключи и сертификаты IDP, используемые в компоненте apigee-sso теперь настраиваются через хранилище ключей. Вам потребуется экспортировать ранее использовавшиеся ключ и сертификат в хранилище ключей. Перед обновлением компонента SSO следуйте инструкциям в разделе «Обновление Apigee SSO со старых версий», чтобы получить подробную информацию о том, как это сделать.

• Требования Python
  Перед попыткой обновления убедитесь, что на всех узлах, включая узлы Cassandra, установлен Python 3.

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

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

Обновление Nginx 1.26 в Edge-Router

Обновление до Edge for Private Cloud 4.53.00 с предыдущих версий не приводит к автоматическому обновлению программного обеспечения Nginx до последней версии (1.26.x). Это сделано для предотвращения случайных побочных эффектов во время выполнения, вызванных изменениями, описанными в разделе «Изменения Nginx 1.26 в Apigee Edge 4.53.00» . Вы можете вручную обновить Nginx с версии 1.20.x до 1.26.x после проверки в средах с более низкими характеристиками. Для ручного обновления:

1. Убедитесь, что на узле Edge-Router установлено новейшее программное обеспечение версии 4.53.00.

   /opt/apigee/apigee-service/bin/apigee-service edge-router version

2. Проверьте и уточните версию Nginx, которую вы используете в данный момент.

   /opt/nginx/sbin/nginx -V

   Если вы используете более старую версию Nginx, вы можете выполнить следующие шаги, чтобы обновить Nginx до версии 1.26.X на узле маршрутизатора.

3. Остановить процесс Edge-Router на узле маршрутизатора

   /opt/apigee/apigee-service/bin/apigee-service edge-router stop

4. Обновите программное обеспечение nginx на узле маршрутизатора.

   dnf update apigee-nginx

5. Убедитесь, что версия Nginx обновлена.

   /opt/nginx/sbin/nginx -V

6. Запустить процесс маршрутизатора на узле

   /opt/apigee/apigee-service/bin/apigee-service edge-router start

7. Повторите процесс на каждом узле маршрутизатора, по одному за раз.

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

Apigee Edge for Private Cloud 4.53.00 включает обновление Cassandra до версии 4.0.13.

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

• Обновление с Cassandra 3.11.X до Cassandra 4.0.X — это простой процесс. Cassandra 4.0.X, выпущенная вместе с Edge for Private Cloud 4.53.00, совместима с компонентами среды выполнения и управления Private Cloud 4.52.02.
• Прямой откат с Cassandra 4.0.X до 3.11.X невозможен. Откат с использованием реплик или резервных копий — сложная процедура, которая может привести к простоям и/или потере данных. Устранение неполадок и обновление до Cassandra 4.0.X предпочтительнее, чем откат.
• Перед началом обновления важно ознакомиться с процедурами отката. Учёт нюансов отката во время обновления критически важен для обеспечения доступности подходящих путей отката.

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

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

Если добавление нового центра обработки данных невозможно, но возможность отката всё ещё необходима, для восстановления Cassandra 3.11.X потребуются резервные копии. Однако этот метод, скорее всего, повлечёт за собой как простой, так и потерю данных.

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

Работа с несколькими центрами обработки данных с Edge for Private Cloud 4.52.02 обеспечивает большую гибкость для откатов при обновлении до Edge for Private Cloud 4.53.00.

• Откаты возможны при наличии хотя бы одного центра обработки данных, работающего под управлением старой версии Cassandra (3.11.X).
• Если весь ваш кластер Cassandra обновлён до версии 4.0.X, не следует откатываться до Cassandra 3.11.X. Необходимо продолжать использовать новую версию Cassandra с другими компонентами Private Cloud 4.53.00 или 4.52.02.

Рекомендуемая методология обновления

1. Обновляйте по одному центру обработки данных Cassandra за раз: начните с обновления отдельных узлов Cassandra в одном центре обработки данных. Завершите обновление всех узлов Cassandra в одном центре обработки данных, прежде чем переходить к следующему.
2. Приостановите и проверьте: после обновления одного центра обработки данных приостановите работу, чтобы убедиться, что ваш кластер частного облака, особенно обновленный центр обработки данных, функционирует правильно.
3. Помните: вы сможете вернуться к предыдущей версии Cassandra только в том случае, если хотя бы один центр обработки данных все еще работает под управлением старой версии.
4. Чувствительность ко времени: хотя вы можете сделать короткую паузу (рекомендуется несколько часов) для проверки функциональности, вы не можете оставаться в состоянии смешанных версий бесконечно. Это связано с тем, что неоднородный кластер Cassandra (с узлами разных версий) имеет эксплуатационные ограничения.
5. Тщательное тестирование: Apigee настоятельно рекомендует провести комплексное тестирование производительности и функциональности перед обновлением следующего дата-центра. После обновления всех дата-центров откат к предыдущей версии невозможен.

Откат как процесс с двумя контрольными точками

1. Контрольная точка 1: Исходное состояние, все компоненты на версии 4.52.02. Полный откат возможен, если хотя бы один центр обработки данных Cassandra останется на старой версии.
2. Контрольная точка 2: После обновления всех узлов Cassandra во всех центрах обработки данных. Вы можете вернуться к этому состоянию, но не к контрольной точке 1.

Пример

Рассмотрим кластер из двух центров обработки данных (ЦОД):

1. Начальное состояние: узлы Cassandra в обоих ЦОДах используют версию 3.11.X. Все остальные узлы используют Edge for Private Cloud версии 4.52.02. Предположим, что на каждый ЦОД приходится три узла Cassandra.
2. Модернизация DC-1: поочередно модернизируйте три узла Cassandra в DC-1.
3. Пауза и проверка: приостановите работу кластера, особенно DC-1, чтобы убедиться в его корректной работе (проверьте производительность и функциональность). Вы можете вернуться к исходному состоянию, используя узлы Cassandra в DC-2. Помните, что эта пауза должна быть временной из-за ограничений кластера Cassandra со смешанными версиями.
4. Обновление DC-2: обновите оставшиеся три узла Cassandra в DC-2. Это станет вашей новой контрольной точкой отката.
5. Обновите другие компоненты: обновите узлы управления, среды выполнения и аналитики как обычно во всех центрах обработки данных, по одному узлу и одному центру обработки данных за раз. При возникновении проблем вы можете вернуться к состоянию, указанному на шаге 4.

Предпосылки для обновления Cassandra

1. Весь кластер работоспособен и полностью функционален с Cassandra 3.11.16.
2. Стратегия уплотнения установлена ​​на LeveledCompactionStrategy (необходимое условие для обновления до версии 4.52.02).
3. Убедитесь, что все указанные ниже шаги были выполнены в рамках первоначального обновления Cassandra 3.11 в Edge for Private Cloud 4.52.02:
   • Команда post_upgrade должна была быть выполнена на каждом узле Cassandra во время предыдущего обновления.
   • Команда drop_old_tables должна была быть выполнена на всем кластере Cassandra во время предыдущего обновления.

Если вы не уверены, были ли выполнены предыдущие шаги, вы можете безопасно повторить их снова. Убедитесь, что эти шаги выполнены на Cassandra 3.11, пока вы всё ещё используете Edge for Private Cloud 4.52.02, прежде чем пытаться обновиться до версии 4.53.00:

1. Выполните следующую команду post_upgrade поочередно на каждом узле Cassandra:

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

2. Выполните следующую команду, чтобы удалить старые неиспользуемые таблицы из кластера Cassandra. Эту команду следует выполнять только на одном узле кластера:

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

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

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

1. Резервное копирование Cassandra с помощью Apigee.
2. Сделайте снимки виртуальных машин узлов Cassandra (если это возможно).
3. Убедитесь, что порт 9042 доступен для узлов Cassandra со всех компонентов Edge for Private Cloud, включая сервер управления, процессор сообщений, маршрутизатор, Qpid и Postgres, если он ещё не настроен. Подробнее см. в разделе «Требования к порту» .

Шаг 2: Обновите все узлы Cassandra

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

После обновления всех узлов Cassandra в одном дата-центре подождите некоторое время (от 30 минут до нескольких часов), прежде чем переходить к узлам в следующем дата-центре. В это время тщательно проверьте дата-центр, который был обновлён, и убедитесь, что функциональные показатели и показатели производительности вашего кластера Apigee не изменились. Этот шаг критически важен для обеспечения стабильности дата-центра, в котором Cassandra была обновлена ​​до версии 4.0.X, в то время как остальные компоненты Apigee останутся на версии 4.52.02.

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 6.0.0 | Cassandra 4.0.13 | CQL spec 3.4.5 | Native protocol v5] 
   Metadata is verified

4. Выполните следующую команду post_upgrade на узле Cassandra:

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

5. Выполните следующие команды nodetool для перестроения индексов на узле Cassandra:

   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms api_products api_products_organization_name_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_api_products_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_organization_app_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_organization_name_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_end_user app_end_user_app_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_family_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_type_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_name_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_organization_name_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_parent_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_parent_status_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_status_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms maps maps_organization_name_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_app_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_consumer_key_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_organization_name_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_status_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_request_tokens oauth_10_request_tokens_consumer_key_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_request_tokens oauth_10_request_tokens_organization_name_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_verifiers oauth_10_verifiers_organization_name_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_verifiers oauth_10_verifiers_request_token_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_app_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_client_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_refresh_token_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_authorization_codes oauth_20_authorization_codes_client_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_authorization_codes oauth_20_authorization_codes_organization_name_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_name_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_organization_name_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_status_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_company_name_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_developer_email_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_organization_name_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_email_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_organization_name_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_status_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index cache cache_entries cache_entries_cache_name_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_operation_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_requesturi_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_responsecode_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_timestamp_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_user_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis a_name
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis a_org_name
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_active_rev
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_def_index_template
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_def_method_template
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_latest_rev
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_name
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_uuid
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_base_url
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_is_active
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_is_latest
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_name
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_org_name
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_rel_ver
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_rev_num
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_a_name
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_api_uuid
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_ar_uuid
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_base_url
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_name
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_org_name
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_r_name
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_r_uuid
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_res_path
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_rev_num
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_a_name
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_api_uuid
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_ar_uuid
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_base_url
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_name
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_org_name
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_res_path
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_rev_num
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 schemas s_api_uuid
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 schemas s_ar_uuid
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 security sa_api_uuid
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 security sa_ar_uuid
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_a_name
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_a_uuid
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_entity
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_name
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_org_name
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template_auth au_api_uuid
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index dek keys usecase_index

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

   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_created_date_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_org_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_updated_date_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_created_date_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_currency_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_dev_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_limit_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_org_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_prod_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_reason_code_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_sub_org_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_company_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_created_at_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_developer_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_lastmodified_at_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_org_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_env_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_job_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_org_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_class_name_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_group_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_name_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus org_triggers org_triggers_org_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_group_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_name_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_suite_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_item notification_service_item_org_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_item notification_service_item_status_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_black_list_item notification_service_black_list_item_org_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_black_list_item notification_service_black_list_item_to_email_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_email_template_item notification_email_template_item_name_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_email_template_item notification_email_template_item_org_id_idx

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

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

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

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

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

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

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

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

Шаги по обновлению Apigee SSO со старых версий

В Edge for Private Cloud 4.53.00 ключи и сертификаты IDP, используемые в компоненте apigee-sso , теперь настраиваются через хранилище ключей. Вам потребуется экспортировать ранее использованные ключ и сертификат в хранилище ключей, настроить их, а затем продолжить обновление SSO обычным способом.

1. Определите существующий ключ и сертификат, используемые для настройки IDP:

   1. Получите сертификат, найдя значение SSO_SAML_SERVICE_PROVIDER_CERTIFICATE в файле конфигурации установки SSO или выполнив запрос к компоненту apigee-sso на предмет conf_login_service_provider_certificate .

      Используйте следующую команду на узле SSO, чтобы запросить путь к сертификату IDP у apigee-sso . В выходных данных найдите значение в последней строке.

      apigee-service apigee-sso configure -search conf_login_service_provider_certificate

   2. Получите ключ, найдя значение SSO_SAML_SERVICE_PROVIDER_KEY в файле конфигурации установки SSO или выполнив запрос к компоненту apigee-sso на предмет conf_login_service_provider_key .

      Используйте следующую команду на узле SSO, чтобы запросить путь к ключу IDP у apigee-sso . В выходных данных найдите значение в последней строке.

      apigee-service apigee-sso configure -search conf_login_service_provider_key

2. Экспортируйте ключ и сертификат в хранилище ключей:
   1. Экспортируйте ключ и сертификат в хранилище ключей PKCS12:

      sudo openssl pkcs12 -export -clcerts -in <certificate_path> -inkey <key_path> -out <keystore_path> -name <alias>

      Параметры:

      • certificate_path : Путь к файлу сертификата, полученному на шаге 1.a.
      • key_path : Путь к файлу закрытого ключа, полученному на шаге 1.b.
      • keystore_path : Путь к вновь созданному хранилищу ключей, содержащему сертификат и закрытый ключ.
      • alias : псевдоним, используемый для пары ключа и сертификата в хранилище ключей.

      Более подробную информацию см. в документации OpenSSL .

   2. (Необязательно) Экспортируйте ключ и сертификат из PKCS12 в хранилище ключей JKS:

      sudo keytool -importkeystore -srckeystore <PKCS12_keystore_path> -srcstoretype PKCS12 -destkeystore <destination_keystore_path> -deststoretype JKS -alias <alias>

      Параметры:

      • PKCS12_keystore_path : путь к хранилищу ключей PKCS12, созданному на шаге 2.a, содержащему сертификат и ключ.
      • destination_keystore_path : путь к новому хранилищу ключей JKS, куда будут экспортированы сертификат и ключ.
      • alias : псевдоним, используемый для пары ключа и сертификата в хранилище ключей JKS.

   Более подробную информацию смотрите в документации по keytool .

3. Измените владельца выходного файла хранилища ключей на пользователя «apigee»:

   sudo chown apigee:apigee <keystore_file>

4. Добавьте следующие свойства в файл конфигурации Apigee SSO и обновите их, указав путь к файлу хранилища ключей, пароль, тип хранилища ключей и псевдоним:

   # Path to the keystore file
   SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PATH=${APIGEE_ROOT}/apigee-sso/source/conf/keystore.jks
   
   # Keystore password
   SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PASSWORD=Secret123  # Password for accessing the keystore
   
   # Keystore type
   SSO_SAML_SERVICE_PROVIDER_KEYSTORE_TYPE=JKS  # Type of keystore, e.g., JKS, PKCS12
   
   # Alias within keystore that stores the key and certificate
   SSO_SAML_SERVICE_PROVIDER_KEYSTORE_ALIAS=service-provider-cert 

5. Обновите программное обеспечение Apigee SSO на узле SSO как обычно, используя следующую команду:

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f /opt/silent.conf

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

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

Установить Edge UI

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

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

Более подробную информацию см. в разделе Установка нового Edge UI .

Обновление с помощью Apigee mTLS

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

• Удалите Apigee mTLS .
• Переустановите Apigee mTLS .

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

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

Если в результате сбоя необходимо откатить обновление до предыдущей версии, подробные инструкции см. в разделе Откат до версии 4.53.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. Продолжайте обновление для всех оставшихся машин в вашей установке.

Перед обновлением и после него позаботьтесь о следующем:

• На комбинированном узле маршрутизатора и процессора сообщений:
  • Перед обновлением выполните следующее:
    1. Сделайте маршрутизатор недоступным.
    2. Сделать обработчик сообщений недоступным.
  • После обновления – выполните следующее:
    1. Сделайте обработчик сообщений доступным.
    2. Сделайте маршрутизатор доступным.
• На отдельных узлах маршрутизатора:
  • Перед обновлением сделайте маршрутизатор недоступным .
  • После обновления сделайте маршрутизатор доступным .
• На отдельных узлах процессора сообщений:
  • Перед обновлением сделайте обработчик сообщений недоступным .
  • После обновления сделайте обработчик сообщений доступным .

Использовать тихий файл конфигурации

Команде обновления необходимо передать файл конфигурации для режима «тихой установки». Файл конфигурации для режима «тихой установки» должен быть тем же, что использовался для установки Edge for Private Cloud 4.52.02.

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

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

1. Если таковые имеются, отключите все задания cron , настроенные на выполнение операции восстановления на Cassandra, до завершения обновления.
2. Войдите в свой узел как пользователь root, чтобы установить RPM-пакеты Edge.
3. Отключите SELinux, как описано в разделе Установка утилиты Edge apigee-setup .
4. Если вы выполняете установку на 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

5. Если вы сейчас используете Edge 4.52.02:

   1. Загрузите файл Edge bootstrap_4.53.00.sh в /tmp/bootstrap_4.53.00.sh :

      curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh

   2. Установите утилиту Edge 4.53.00 apigee-service и ее зависимости, выполнив следующую команду:

      sudo bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord

      Где uName:pWord — имя пользователя и пароль, полученные от Apigee. Если вы не укажете pWord , вам будет предложено ввести его.

      По умолчанию установщик проверяет наличие Java 1.8. Если у вас её нет, установщик установит её автоматически.

      Используйте параметр JAVA_FIX , чтобы указать способ установки Java. JAVA_FIX принимает следующие значения:

      • I : Установить OpenJDK 1.8 (по умолчанию).
      • C : Продолжить без установки Java.
      • Q : Выйти. Для этого вам необходимо установить Java самостоятельно.
   3. Используйте apigee-service для обновления утилиты apigee-setup , как показано в следующем примере:

      /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

   4. Обновите утилиту apigee-validate на сервере управления, как показано в следующем примере:

      /opt/apigee/apigee-service/bin/apigee-service apigee-validate update

   5. Обновите утилиту apigee-provision на сервере управления, как показано в следующем примере:

      /opt/apigee/apigee-service/bin/apigee-service apigee-provision update

   6. Запустите утилиту update на своих узлах, выполнив следующую команду:

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

      Сделайте это в порядке, описанном в разделе Порядок обновления машины .

      Где:

      • component — это компонент Edge, который нужно обновить. Возможные значения:
        • cs : Кассандра
        • edge : все компоненты Edge, за исключением Edge UI: сервер управления, процессор сообщений, маршрутизатор, сервер QPID, сервер Postgres
        • ldap : OpenLDAP
        • ps : postgresql
        • qpid : qpidd
        • sso : Apigee SSO (если вы установили SSO)
        • ue : Новый интерфейс Edge
        • ui : Классический интерфейс Edge
        • zk : Zookeeper
      • configFile — это тот же файл конфигурации, который вы использовали для определения компонентов Edge во время установки 4.52.02.

      Вы можете запустить update.sh для всех компонентов, установив component «all», но только если у вас профиль установки Edge all-in-one (AIO). Например:

      /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config

   7. Перезапустите компоненты Edge UI на всех узлах, где они работают, если вы еще этого не сделали:

      /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart

   8. Проверьте обновление, запустив утилиту apigee-validate на сервере управления, как описано в разделе Проверка установки .

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

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

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

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

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

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

1. Создайте локальный репозиторий 4.53.00, как описано в разделе «Создание локального репозитория Apigee» в разделе Установка утилиты Edge apigee-setup .
2. Чтобы установить apigee-service из файла .tar :
   1. На узле с локальным репозиторием используйте следующую команду для упаковки локального репозитория в один файл .tar с именем /opt/apigee/data/apigee-mirror/apigee-4.53.00.tar.gz :

      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

   2. Скопируйте файл .tar на узел, на котором вы хотите обновить Edge. Например, скопируйте его в каталог /tmp на новом узле.
   3. На новом узле распакуйте файл в каталог /tmp :

      tar -xzf apigee-4.53.00.tar.gz

      Эта команда создаёт новый каталог с именем repos в каталоге, содержащем файл .tar. Например /tmp/repos .

   4. Установите утилиту Edge apigee-service и зависимости из /tmp/repos :

      sudo bash /tmp/repos/bootstrap_4.53.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

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

3. Чтобы установить apigee-service с помощью веб-сервера Nginx:
   1. Настройте веб-сервер Nginx, как описано в разделе «Установка из репозитория с помощью веб-сервера Nginx» в разделе Установка утилиты Edge apigee-setup .
   2. На удаленном узле загрузите файл Edge bootstrap_4.53.00.sh в /tmp/bootstrap_4.53.00.sh :

      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh

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

   3. На удаленном узле установите утилиту Edge apigee-setup и зависимости:

      sudo bash /tmp/bootstrap_4.53.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

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

4. Используйте apigee-service для обновления утилиты apigee-setup , как показано в следующем примере:

   /opt/apigee/apigee-service/bin/apigee-service apigee-setup update 

5. Обновите утилиту apigee-validate на сервере управления, как показано в следующем примере:

   /opt/apigee/apigee-service/bin/apigee-service apigee-validate update

6. Обновите утилиту apigee-provision на сервере управления, как показано в следующем примере:

   /opt/apigee/apigee-service/bin/apigee-service apigee-provision update

7. Запустите утилиту update на своих узлах в порядке, описанном в разделе Порядок обновления машины :

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

   Где:

   • component — это компонент Edge, который нужно обновить. Обычно обновляются следующие компоненты:
     • cs : Кассандра
     • edge : все компоненты Edge, за исключением Edge UI: сервер управления, процессор сообщений, маршрутизатор, сервер QPID, сервер Postgres
     • ldap : OpenLDAP
     • ps : postgresql
     • qpid : qpidd
     • sso : Apigee SSO (если вы установили SSO)
     • ue New Edge UI
     • ui : Классический интерфейс Edge
     • zk : Zookeeper
   • 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.53.00 .

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

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

• Перед обновлением любых других узлов необходимо обновить все узлы Cassandra и ZooKeeper.
• Для любой машины с несколькими компонентами Edge (сервер управления, процессор сообщений, маршрутизатор, сервер QPID, но не сервер Postgres) используйте опцию -c edge , чтобы обновить их все одновременно.
• Если для шага указано, что его следует выполнить на нескольких машинах, выполняйте его в указанном порядке машин.
• Обновление монетизации не требует отдельного шага. Оно обновляется при указании опции -c edge .

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

Чтобы обновить автономную конфигурацию с 1 узлом до версии 4.53.00:

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 узлами:

Список топологий 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 UI на машине 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 UI: Если вы установили новый Edge UI, обновите компонент 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 UI: Если вы установили новый Edge UI, перезапустите компонент 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 UI: Если вы установили новый Edge UI, перезапустите компонент 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 на машинах 6 и 7:

   /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

    • Новый пользовательский интерфейс Edge: если вы установили новый пользовательский интерфейс Edge, перезапустите компонент edge-management-ui на компьютерах 6 и 7:

      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

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

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

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

1. Обновите Кассандру и 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. Обновить Постгрес:
   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:
   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

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

9. Перезапустите новый компонент Edge UI ( edge-management-ui ) или классический компонент Edge UI ( edge-ui ) на компьютерах 1 и 7:

   /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart

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

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

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

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