Как обновить Apigee Edge 4.52.02 до версии 4.53.00

Apigee поддерживает обновление Edge для частного облака непосредственно с версии 4.52.02 до версии 4.53.00. В этой статье рассказывается, как это сделать.

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

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

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

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

Какие компоненты нужно обновить

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

Требования к обновлению

Перед обновлением Apigee Edge убедитесь, что выполнены следующие условия:

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

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

  • Убедитесь, что Edge работает
    Убедитесь, что Edge работает во время обновления, с помощью следующей команды: 
    /opt/apigee/apigee-service/bin/apigee-all status
  • Проверьте требования Cassandra

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

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

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

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

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

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

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

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

  1. Убедитесь, что на пограничном маршрутизаторе установлена последняя версия ПО 4.53.00.

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

  2. Как проверить версию Nginx

    /opt/nginx/sbin/nginx -V

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

  3. Остановите процесс пограничного маршрутизатора на узле маршрутизатора

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

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

    dnf update apigee-nginx-1.26.3

  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 для частного облака 4.53.00 включает обновление Cassandra до версии 4.0.13.

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

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

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

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

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

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

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

  • Для отката требуется, чтобы хотя бы один центр обработки данных работал с более старой версией Cassandra (3.11.X).
  • Если весь кластер Cassandra обновлен до версии 4.0.X, вы не сможете выполнить откат до версии 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 для частного облака версии 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

Вам следует использовать Cassandra 3.11.16 с Edge для частного облака 4.52.02 и убедиться в следующем:
  1. Весь кластер работает и полностью совместим с Cassandra 3.11.16.
  2. Стратегия сжатия задана как LeveledCompactionStrategy (обязательное условие для перехода на версию 4.52.02).
  3. Убедитесь, что все перечисленные ниже действия были выполнены в рамках первоначального обновления Cassandra 3.11 в Edge для 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 доступен для всех компонентов Edge для частного облака, включая сервер управления, процессор сообщений, маршрутизатор, Qpid и Postgres, для узлов Cassandra, если он ещё не настроен. Подробнее о требованиях к портам…

Шаг 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
     Если вы используете монетизацию, также выполните следующие команды rebuild indices, связанные с пространствами ключей монетизации: 
    /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. Обновите все узлы среды выполнения

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

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

Шаг 5. Обновите все оставшиеся компоненты Edge для частного облака 4.53.00

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

Как обновить Apigee SSO с более ранних версий

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

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

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

      Чтобы запросить у apigee-sso путь к сертификату поставщика идентификационной информации, выполните на узле 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: 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а.
      • key_path – путь к файлу закрытого ключа, полученному на шаге 1б.
      • 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а и содержащему сертификат и ключ.
      • destination_keystore_path – путь к новому хранилищу ключей JKS, в которое будут экспортированы сертификат и ключ.
      • alias – псевдоним, используемый для пары ключей и сертификатов в хранилище ключей JKS.

      3. Подробная информация приведена в документации по 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. Подробнее о новом интерфейсе Edge для частного облака…

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

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

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

Подробнее об установке нового интерфейса Edge…

Как обновить 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.

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

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

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

До и после обновления выполните следующие действия:

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

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

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

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

  1. Если они есть, отключите все задания cron, настроенные на выполнение операции восстановления в Cassandra, до завершения обновления.
  2. Войдите в узел как root, чтобы установить пакеты RPM Edge.
  3. Отключите SELinux, как описано в разделе Установка утилиты apigee-setup Edge.
  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: Cassandra
        • edge: все компоненты Edge, кроме интерфейса Edge: сервер управления, процессор сообщений, маршрутизатор, сервер QPID, сервер Postgres
        • ldap: OpenLDAP
        • ps: postgresql
        • qpid: qpidd
        • sso: Apigee SSO (если вы установили SSO)
        • ue: новый интерфейс Edge
        • ui – классический интерфейс Edge;
        • zk: смотритель зоопарка
      • 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 на всех узлах, на которых они выполняются, если вы ещё этого не сделали: 
      /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-файл репозитория, скопируйте его на узел и обновите Edge с помощью этого файла.
  • Установите веб-сервер на узле с локальным репозиторием, чтобы другие узлы могли получить к нему доступ. Apigee предоставляет веб-сервер Nginx, но вы можете использовать и собственный.

Чтобы обновить локальный репозиторий 4.53.00:

  1. Создайте локальный репозиторий версии 4.53.00, как описано в разделе "Создание локального репозитория Apigee" статьи Установка утилиты apigee-setup для Edge.
  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

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

  3. Чтобы установить apigee-service с помощью веб-сервера Nginx:
    1. Настройте веб-сервер Nginx, как описано в разделе "Установка из репозитория с помощью веб-сервера Nginx" статьи Установка утилиты apigee-setup Edge.
    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: Cassandra
      • edge: все компоненты Edge, кроме интерфейса Edge: сервер управления, процессор сообщений, маршрутизатор, сервер QPID, сервер Postgres.
      • ldap: OpenLDAP
      • ps: postgresql
      • qpid: qpidd
      • sso: Apigee SSO (если вы установили SSO)
      • ue Новый интерфейс Edge
      • ui – классический интерфейс Edge;
      • zk: смотритель зоопарка
    • configFile – это тот же файл конфигурации, который вы использовали для определения компонентов Edge во время установки версии 4.50.00 или 4.51.00.

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

    /opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
  8. Перезапустите компоненты интерфейса на всех узлах, на которых они выполняются, если вы ещё этого не сделали: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
  9. Проверьте обновление, запустив утилиту apigee-validate на сервере управления, как описано в разделе Проверка установки.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Список топологий 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 на компьютерах 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. Обновите 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:
    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, обновите ее:
    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 (edge-management-ui) или классический интерфейс Edge (edge-ui) на компьютерах 1 и 7: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart

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

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

  1. ZooKeeper
  2. Cassandra
  3. ps
  4. LDAP
  5. Edge – профиль "-c edge" на всех узлах в следующем порядке: узлы с сервером Qpid, сервером Edge Postgres, сервером управления, Message Processor и маршрутизатором.
  6. qpidd
  7. Интерфейс Edge (классический или новый)
  8. apigee-adminapi
  9. Apigee SSO

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