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

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

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

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

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

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

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

Вам необходимо обновить все компоненты 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 в разделе «Шаги после обновления» . Если вы не уверены, были ли выполнены эти действия во время предыдущего обновления, выполните их еще раз, прежде чем приступить к обновлению до версии 4.53.00.
  • Настройка ключей и сертификатов IDP в Edge для частного облака 4.53.00

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

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

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

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

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

Рассмотрим кластер с двумя центрами обработки данных (DC):

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

Предварительные условия для обновления Кассандры

Вам следует использовать Cassandra 3.11.16 с Edge for Private Cloud 4.52.02 и убедиться в следующем:
  • Весь кластер работоспособен и полностью функционален с Cassandra 3.11.16.
  • Для стратегии уплотнения установлено значение LeveledCompactionStrategy (необходимое условие для обновления до версии 4.52.02).
  • Все шаги после обновления, начиная с первоначального обновления до Cassandra 3.11.16 в рамках обновления 4.52.02, выполнены. Если нет, повторите эти шаги. Это применимо только в том случае, если вы обновили версию Private Cloud 4.52.02 с более старой версии.

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

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

  1. Сделайте резервную копию Кассандры с помощью 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
     Если вы используете монетизацию , также запустите следующие команды перестроения индексов, связанные с пространствами ключей монетизации: 
    /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 теперь настраиваются через хранилище ключей. Вам нужно будет экспортировать ключ и сертификат, использованные ранее, в хранилище ключей, настроить его, а затем продолжить обновление единого входа как обычно.

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

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

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

      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 .

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

      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.

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

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

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

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

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

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

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

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

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

  1. Если они есть, отключите все задания cron , настроенные для выполнения операции восстановления в Cassandra, до завершения обновления.
  2. Войдите на свой узел как root, чтобы установить Edge RPM.
  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. Установите утилиту apigee-service Edge 4.53.00 и зависимости, выполнив следующую команду:
      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: сервер управления, процессор сообщений, маршрутизатор, сервер QPID, сервер Postgres.
        • ldap : OpenLDAP
        • ps : постгреск
        • qpid : qpidd
        • sso : Apigee SSO (если вы установили SSO)
        • ue : новый интерфейс Edge
        • ui : Классический интерфейс Edge.
        • zk : Смотритель зоопарка
      • configFile — это тот же файл конфигурации, который вы использовали для определения компонентов Edge во время установки 4.52.02.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Список топологий 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: если вы установили новый пользовательский интерфейс Edge, обновите компонент ue на соответствующем компьютере (может быть не на компьютере 1): 
      /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
  9. (Если вы установили apigee-adminapi ) Обновлена ​​утилита apigee-adminapi на компьютере 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  10. (Если вы установили Apigee SSO) Обновите Apigee SSO на компьютере 1:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  11. Перезапустите компонент пользовательского интерфейса:
    • Классический пользовательский интерфейс. Если вы используете классический пользовательский интерфейс, перезапустите компонент edge-ui на компьютере 1, как показано в следующем примере: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • Новый пользовательский интерфейс Edge: если вы установили новый пользовательский интерфейс Edge, перезапустите компонент edge-management-ui на соответствующем компьютере (может быть не на компьютере 1): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

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

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

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

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

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

  10. Перезапустите компонент пользовательского интерфейса:
    • Классический пользовательский интерфейс. Если вы используете классический пользовательский интерфейс, перезапустите компонент edge-ui на компьютере 1, как показано в следующем примере: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • Новый пользовательский интерфейс Edge: если вы установили новый пользовательский интерфейс Edge, перезапустите компонент edge-management-ui на соответствующем компьютере (может быть не на компьютере 1): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

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

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

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

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

      3. Где 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. ЛДАП
  5. Edge, что означает профиль «-c Edge» на всех узлах по порядку: узлы с сервером Qpid, пограничным сервером Postgres, сервером управления, процессором сообщений и маршрутизатором.
  6. qpidd
  7. Edge UI (классический или новый)
  8. apigee-adminapi
  9. Apigee SSO

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

,

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

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

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

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

После установки оборотов 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 в соответствии с этапами обновления публикации . Если вы не уверены, были ли эти шаги выполнены во время предыдущего обновления, заполните их снова, прежде чем перейти к обновлению до версии 4.53.00.
  • Настройка клавиш IDP и сертификаты в Edge для частного облака 4.53.00

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

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

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

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

Требуется обновление до 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 предпочтительнее отката.
  • Важно ознакомиться с процедурами отката, прежде чем пытаться обновить. Учитывая нюансы отката во время обновления, имеет решающее значение для обеспечения доступных соответствующих путей отката.

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

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

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

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

Управление несколькими центрами обработки данных с Edge для частного облака 4.52.02 предлагает большую гибкость для откатов во время обновления до Edge для частного облака 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. Чувствительный ко времени: хотя вы можете сделать паузу в течение короткого периода (рекомендуется несколько часов) для проверки функциональности, вы не можете оставаться в состоянии смешанной версии на неопределенный срок. Это связано с тем, что неравномерный кластер Кассандры (с узлами в разных версиях) имеет эксплуатационные ограничения.
  5. Тщательное тестирование: Apigee настоятельно рекомендует всестороннее тестирование производительности и функциональности перед модернизацией следующего центра обработки данных. Как только все центры обработки данных будут обновлены, откат на более раннюю версию невозможно.
Откат как процесс с двумя чековыми пунктами
  1. Контрольная точка 1: начальное состояние со всеми компонентами в версии 4.52.02. Полный откат возможен, пока в более старой версии остается хотя бы один центр обработки данных Cassandra.
  2. Контрольная точка 2: после того, как все узлы Cassandra во всех центрах обработки данных обновляются. Вы можете вернуться к этому состоянию, но вы не можете вернуться к контрольной точке 1.
Пример

Рассмотрим кластер с двумя ценными (DC):

  1. Начало штата: узлы Cassandra в обоих DCS находятся на версии 3.11.x. Все остальные узлы находятся на грани для частного облака версии 4.52.02. Предположим, что три узла Cassandra на DC.
  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 и обеспечить следующее:
  • Весь кластер работает и полностью функционален с Cassandra 3.11.16.
  • Стратегия уплотнения установлена ​​на LeveledCompactionStrategy (предпосылка для обновления до версии 4.52.02).
  • Все шаги после обновления от начального обновления до Cassandra 3.11.16 как часть обновления 4,52,02. Если нет, повторно запустите эти шаги. Это применимо только в том случае, если вы обновились до частной облачной версии 4.52.02 из более старой версии.

Шаг 1: подготовиться к обновлению

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

  1. Резервное копирование Cassandra с помощью Apigee.
  2. Возьмите снимки VM узлов Cassandra (если это возможно).
  3. Убедитесь, что порт 9042 доступен со всех краев для частных облачных компонентов, включая сервер управления, процессор сообщений, маршрутизатор, QPID и Postgres, для узлов Cassandra, если они еще не настроены. Обратитесь к требованиям порта для получения дополнительной информации.

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

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

После обновления всех узлов Cassandra в центре обработки данных подождите некоторое время (30 минут до нескольких часов), прежде чем продолжить с узлами в следующем центре обработки данных. В течение этого времени тщательно просмотрите центр обработки данных, который был обновлен, и убедитесь, что функциональные показатели и показатели производительности вашего кластера Apigee не повреждены. Этот шаг имеет решающее значение для обеспечения стабильности центра обработки данных, где Cassandra была обновлена ​​до версии 4.0.x, в то время как остальные компоненты Apige остаются на версии 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: Обновите все оставшиеся края для частного облака 4.53.00 Компоненты

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

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

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

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

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

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

      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 для пути ключа IDP. В выводе ищите значение на последней строке. 

      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 : Path to Pkcs12 -магазин ключей, созданный на шаге 2.a, содержащий сертификат и ключ.
      • destination_keystore_path : путь к новому магазину ключей JKS, где будут экспортированы сертификат и ключ.
      • alias : псевдоним, используемый для пары ключей и сертификатов в хранилище ключей JKS.

      3. Обратитесь к документации Keytool для получения более подробной информации.

  3. Измените владельца файла Key Store Output на пользователь «Apigee»: 
    sudo chown apigee:apigee <keystore_file>
  4. Добавьте следующие свойства в файл конфигурации Apigee SSO и обновите их с помощью пути файла KeyStore, пароля, типа клавиш и псевдонима: 
    # 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 UI

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

Установите интерфейс Edge

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

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

Для получения дополнительной информации см. Установите новый интерфейс Edge .

Обновление с Apigee MTLS

Чтобы обновить Apigee MTLS , сделайте следующие шаги:

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

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

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

Информация об обновлении журнала

По умолчанию утилита update.sh записывает информацию журнала: 

/opt/apigee/var/log/apigee-setup/update.log

Если человек, запускающий утилиту update.sh не имеет доступа к этому каталогу, он записывает журнал в каталог /tmp в качестве файла с именем update_username.log .

Если у человека нет доступа к /tmp , утилита update.sh не удается.

Обновление нулевого времени

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

Обновление с нулевым временем возможно только с 5-узловой конфигурацией и больше.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    Вы можете запустить update.sh против всех компонентов, установив component на «All», но только если у вас есть профиль установки All-In-One (AIO). Например: 

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

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

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

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

  • Вы должны обновить все узлы Cassandra и Zookeeper, прежде чем обновлять любые другие узлы.
  • Для любой машины с несколькими краевыми компонентами (сервер управления, процессор сообщений, маршрутизатор, 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 узлами:

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

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

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

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

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

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

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

  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. Обновления края компонентов на машине 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. Обновите пользовательский интерфейс:
    • Классический пользовательский интерфейс: если вы используете классический пользовательский интерфейс, то обновите компонент ui на машине 1, как показано в следующем примере: 
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    • New Edge UI: если вы установили новый Edge UI, то обновите компонент ue на соответствующей машине (не может быть машина 1): 
      /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
  9. (Если вы установили apigee-adminapi ), обновили утилиту apigee-adminapi на машине 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  10. (Если вы установили Apigee SSO) Обновите Apigee SSO на машине 1:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  11. Перезагрузить компонент пользовательского интерфейса:
    • Классический пользовательский интерфейс: если вы используете классический пользовательский интерфейс, то перезапустите компонент edge-ui на машине 1, как показано в следующем примере: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • New Edge UI: если вы установили новый Edge UI, перезапустите компонент edge-management-ui на соответствующей машине (не может быть машиной 1): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  1. Зокепер
  2. Кассандра
  3. пс
  4. LDAP
  5. Edge, meaning the "-c edge" profile on all nodes in the order: nodes with Qpid server, Edge Postgres Server, Management Server, Message Processor, and Router.
  6. qpidd
  7. Edge UI (either classic or new)
  8. apigee-adminapi
  9. Apigee SSO

After you finish updating, be sure to restart the Edge UI component on all machines running it.