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

Apigee поддерживает обновление Edge для Private Cloud напрямую с версии 4.53.00 или 4.53.01 до версии 4.54.00. В этой статье рассказывается, как это сделать.

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

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

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

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

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

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

Материалы для предварительного ознакомления

Ознакомьтесь со следующими темами, чтобы получить важную информацию об изменениях, внесенных в Edge для Private Cloud 4.54.00:

• Изменения в версии 4.54.00. Ознакомьтесь с изменениями в TLS и Java Callout, которые требуют подготовки перед обновлением. Подробнее об изменениях в версии 4.54.00…

• Двойная архитектура среды выполнения Java (Java 17 и Java 21). Начиная с версии 4.54.00, Edge для частного облака прекращает поддержку Java 8 и запускает компоненты на Java 17 или Java 21. Подробнее об изменениях в версии 4.54.00…

• Java не устанавливается автоматически во время начальной загрузки. Edge для Private Cloud 4.54.00 может обнаруживать установленные версии Java и проверять, установлены ли у вас Java 17 и 21.

• Новый интерфейс Edge в версии 4.54.00. Узнайте о переходе на новый интерфейс Edge в качестве интерфейса управления по умолчанию и удалении классического интерфейса (edge-ui). Подробную информацию вы найдете в статье Новый интерфейс Edge.

• Система единого входа Apigee в версии 4.54.00. Узнайте об обновленной архитектуре системы единого входа и изменениях в конфигурации для аутентификации. Дополнительную информацию можно найти в статье Apigee SSO.

• Nginx 1.30 в 4.54.00. Ознакомьтесь с информацией об автоматическом обновлении Nginx 1.30.x на пограничных маршрутизаторах, потенциальном влиянии на среду выполнения и мерах по устранению неполадок. Подробнее об изменениях в Nginx 1.30…

Требования для перехода

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

• Ознакомьтесь с примечаниями к выпуску и новыми функциями

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

• Автоматическое обнаружение двоичных файлов Java и сосуществование во время обновления. Установите Java, используя стандартные менеджеры пакетов (например, yum) или стандартные расположения (например, /usr/lib/jvm или update-alternatives). Не нужно настраивать обе версии в системной переменной PATH одновременно. Не удаляйте Java 8 перед обновлением. Не удаляйте Java 8, чтобы существующие сервисы Edge для Private Cloud 4.53.xx продолжали работать без перебоев до обновления.

• Резервное копирование всех узлов

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

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

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

• Убедитесь, что Edge работает

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

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

• Проверьте требования к Cassandra

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

• Остановите apigee-monit. Если на узле запущен apigee-monit, перед обновлением остановите его с помощью команды /opt/apigee/apigee-service/bin/apigee-service apigee-monit stop. Это предотвращает автоматический перезапуск компонентов apigee-monit во время их обновления. После завершения обновления снова включите его с помощью команды apigee-service apigee-monit start.

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

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

Обновление Router и Message Processor

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

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

Обновление сервера управления

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

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

Переход на OpenLDAP 2.6.10

В Edge for Private Cloud 4.54.00 используется OpenLDAP 2.6.10. Это обновление применяется ко всем топологиям развертывания Apigee OpenLDAP: с одним сервером, активно-пассивной и активно-активной (с несколькими главными серверами).

Подготовка и установка (все серверы LDAP)

Обновление до New Edge UI и Apigee SSO (если установлено)

В Apigee Edge для Private Cloud 4.54.00 классический интерфейс (edge-ui) заменен новым интерфейсом Edge (edge-management-ui). В зависимости от того, установлена ли и используется ли в вашей системе система единого входа Apigee, выберите один из двух вариантов ниже.

# Authentication mode for New Edge UI (Basic Authentication - No Apigee SSO)
AUTH_MODE=basic

# Access configuration for the New Edge UI
MANAGEMENT_UI_PORT=3001
MANAGEMENT_UI_APP_ENV=OPDK
MANAGEMENT_UI_IP=MANAGEMENT_UI_NODE_IP #Replace MANAGEMENT_UI_NODE_IP with the IP address or hostname of the UI node.
MANAGEMENT_UI_SCHEME=http

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

apigee-service apigee-sso stop

/opt/apigee/apigee-service/bin/apigee-service apigee-openldap setup-sso -f configFile

/opt/apigee/apigee-service/bin/apigee-service edge-management-ui configure-sso -f configFile

apigee-service apigee-sso uninstall

Перейдите на Qpid 10.0.1

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

Чтобы выполнить обновление до Qpid на месте без простоев:

1. Выберите один узел Qpid.

2. Остановите брокер Qpid на узле:

   apigee-service apigee-qpidd stop

3. Заблокируйте входящий трафик на порт брокера 5672 от всех процессоров сообщений, применив брандмауэр. Вы можете применить этот брандмауэр на уровне экземпляра узла Qpid или другого внешнего брандмауэра/сетевого компонента.

   Рекомендуем выполнить этот шаг для всех IP-адресов обработчиков сообщений. Например, чтобы с помощью IPTables отклонять запросы, поступающие с IP-адресов Message Processor на узел Qpid через порт 5672, можно использовать следующую команду:

   iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP

4. Снова запустите брокер Qpid, чтобы удалить существующие сообщения, если они есть:

   apigee-service apigee-qpidd start

5. Убедитесь, что существующие очереди пусты:

   /opt/apigee/apigee-qpidd/bin/qpid-stat -q

   Если сообщения застряли в очереди недоставленных сообщений (DLQ) (ax-q-axgroup-001-consumer-group-001-dl), очистите очередь, выполнив инструкции по устранению застревания данных аналитики в очереди недоставленных сообщений.

6. Убедившись, что очереди на старом узле очищены, остановите apigee-qpidd:

   apigee-service apigee-qpidd stop

7. Обновите Qpid на узле:

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

8. Перезапустите edge-qpid-server:

   apigee-service edge-qpid-server restart

9. Удалите правило брандмауэра, примененное на шаге 3.

   Повторите эти действия для всех IP-адресов обработчиков сообщений, к которым был применен брандмауэр. После удаления брандмауэров запросы, поступающие с IP-адресов обработчика сообщений на узел Qpid через порт 5672, будут приниматься. Если вы использовали iptables, чтобы добавить брандмауэр, то для его удаления и просмотра существующих настроек можно использовать следующие команды:

   iptables -F
   iptables -L

10. Чтобы убедиться, что очереди Qpid получают сообщения, используйте веб-мониторинг:

    http://QPID_NODE_IP:8090

11. Повторите шаги 1–9 для каждого узла Qpid.

Перейти на Postgres 18.6

В этом выпуске Edge обновлен до Postgres 18.6. В рамках этого обновления все данные Postgres переносятся в Postgres 18.6.

Большинство производственных систем Edge используют два узла Postgres, настроенных для репликации в режиме ожидания. Во время обновления, когда узлы Postgres отключены, данные аналитики по-прежнему записываются на узлы Qpid. После обновления узлов Postgres и их возвращения в онлайн-режим аналитические данные передаются на узлы Postgres.

Способ обновления Postgres зависит от того, как вы настроили хранилище данных для узлов Postgres:

• Если вы используете локальное хранилище данных для узлов Postgres , вам необходимо установить новый резервный узел Postgres на время обновления. После завершения обновления вы можете вывести из эксплуатации новый резервный узел Postgres. Дополнительный резервный узел Postgres необходим, если по какой-либо причине вам потребуется откатить обновление. Если вам нужно откатить обновление, после отката новый резервный узел Postgres становится основным узлом Postgres. Поэтому при установке нового резервного узла Postgres он должен находиться на узле, который соответствует всем аппаратным требованиям сервера Postgres, как определено в Требованиях к установке Edge.

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

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

Установка нового резервного узла Postgres

Эта процедура создает резервный сервер Postgres на новом узле. Убедитесь, что вы устанавливаете новый резервный сервер Postgres для существующей версии Edge (4.53.00 или 4.53.01), а не для версии 4.54.00.

Для установки используйте тот же файл конфигурации, который вы использовали для установки текущей версии Edge.

Чтобы создать резервный узел Postgres:

1. На текущем основном сервере Postgres отредактируйте файл /opt/apigee/customer/application/postgresql.properties, чтобы задать следующий токен. Если такого файла нет, создайте его:

   conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust

   где existing_standby_ip – IP-адрес текущего резервного сервера Postgres, а new_standby_ip – IP-адрес нового резервного узла.

2. Перезапустите apigee-postgresql на основном узле Postgres:

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart

3. Чтобы убедиться, что резервный узел добавлен, откройте файл /opt/apigee/apigee-postgresql/conf/pg_hba.conf на основном узле. В этом файле должны быть следующие строки:

   host replication apigee existing_standby_ip/32 trust
   host replication apigee new_standby_ip/32 trust

4. Установите новый резервный сервер Postgres:

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

      # IP address of the current primary(master):
      PG_MASTER=PG_MASTER_NODE_IP
      # IP address of the new standby node
      PG_STANDBY=PG_STANDBY_NODE_IP

   2. Отключите SELinux, как описано в статье Установка утилиты apigee-setup для Edge.

   3. Скачайте и запустите скрипт начальной загрузки для вашей версии Edge:

      • Если вы используете Edge 4.53.00:

        Скачайте файл 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

        Установите утилиту Edge apigee-service и зависимости:

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

      • Если вы используете Edge 4.53.01:

        Скачайте файл Edge bootstrap_4.53.01.sh в папку /tmp/bootstrap_4.53.01.sh:

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

        Установите утилиту Edge apigee-service и зависимости:

        bash /tmp/bootstrap_4.53.01.sh apigeeuser=uName apigeepassword=pWord

   4. Используйте apigee-service, чтобы установить утилиту apigee-setup:

      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

   5. Установите Postgres:

      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile

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

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

Выполнение обновления Postgres на месте

Предварительный шаг

Прежде чем выполнять обновление Postgres на месте, выполните следующие действия на основном и резервном хостах, чтобы обновить свойство max_locks_per_transaction в apigee-postgresql:

1. Если файла /opt/apigee/customer/application/postgresql.properties нет, создайте его .

2. Передайте право собственности на этот файл пользователю apigee :

   chown apigee:apigee /opt/apigee/customer/application/postgresql.properties

3. Добавьте в файл следующее свойство:

   conf/postgresql.conf+max_locks_per_transaction=30000

4. Настройте apigee-postgresql :

   apigee-service apigee-postgresql configure

5. Перезапустите apigee-postgresql :

   apigee-service apigee-postgresql restart

Выполните обновление на месте

Чтобы выполнить обновление до Postgres 18, сделайте следующее:

1. Обновите Postgres на основном хосте

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

2. Выполните команду настройки на основном хосте:

   apigee-service apigee-postgresql setup -f configFile

3. Выполните команду настройки на основном хосте:

   apigee-service apigee-postgresql configure

4. Перезапустите основной хост:

   apigee-service apigee-postgresql restart

5. Чтобы сделать его основным, выполните следующие действия:

   apigee-service apigee-postgresql setup-replication-on-master -f configFile

6. Убедитесь, что основной организатор начал встречу:

   apigee-service apigee-postgresql wait_for_ready

7. Чтобы отключить режим ожидания:

   apigee-service apigee-postgresql stop

8. Обновите резервный экземпляр.

   Примечание. Если на этом шаге произойдет ошибка, ее можно проигнорировать. update.sh попытается запустить резервный сервер с неправильной конфигурацией. Если Postgres обновлен до версии 18, ошибку можно игнорировать.

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

9. Убедитесь, что резервный сервер остановлен:

   apigee-service apigee-postgresql stop

10. Удалите старую конфигурацию резервного сервера:

    rm -rf /opt/apigee/data/apigee-postgresql/

11. Настройте репликацию на резервном сервере:

    apigee-service apigee-postgresql setup-replication-on-standby -f configFile

12. Удалите строку conf/postgresql.conf+max_locks_per_transaction=30000 из файла /opt/apigee/customer/application/postgresql.properties как на основном, так и на резервном хосте. Эта строка была добавлена на предварительном этапе .

    После выполнения этой процедуры резервный сервер запустится.

Вывод узла Postgres из эксплуатации

После завершения обновления выведите из эксплуатации новый резервный узел:

1. Убедитесь, что Postgres работает:

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

   Если Postgres не запущен, запустите его:

   /opt/apigee/apigee-service/bin/apigee-all start

2. Получите UUID нового резервного узла, выполнив на нем следующую команду curl:

   curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self

   В конце выходных данных вы увидите UUID узла в следующем формате:

   "type" : [ "postgres-server" ],
   "uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"

3. Остановите новый резервный узел, выполнив на нем следующую команду:

   /opt/apigee/apigee-service/bin/apigee-all stop

4. На основном узле Postgres отредактируйте файл /opt/apigee/customer/application/postgresql.properties, чтобы удалить новый резервный узел из conf_pg_hba_replication.connection:

   conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust

5. Перезапустите apigee-postgresql на основном узле Postgres:

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart

6. Убедитесь, что новый резервный узел удален, проверив файл /opt/apigee/apigee-postgresql/conf/pg_hba.conf на основном узле. В файле должна быть только следующая строка:

   host replication apigee existing_standby_ip/32 trust

7. Удалите UUID резервного узла из ZooKeeper, выполнив следующий вызов Edge Management API на узле сервера управления:

   curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid

Действия после обновления для Postgres

После крупного обновления Postgres внутренняя статистика Postgres удаляется. Эти статистические данные помогают планировщику запросов Postgres использовать наиболее оптимальные индексы и пути для выполнения запросов.

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

Чтобы устранить эту проблему, выполните команду ANALYZE для всех таблиц в базе данных на основном узле Postgres. Вы также можете выполнить команду ANALYZE для нескольких таблиц одновременно.

Переход на ZooKeeper 3.8.5

В этом выпуске Edge для частного облака обновлен ZooKeeper до версии 3.8.5. В рамках этого обновления все данные ZooKeeper будут перенесены в ZooKeeper 3.8.5.

Прежде чем обновлять ZooKeeper, ознакомьтесь с руководством по обслуживанию ZooKeeper. Большинство производственных систем Edge используют кластер узлов ZooKeeper, распределенных по нескольким центрам обработки данных. Некоторые из этих узлов настроены как избиратели, которые участвуют в выборах лидера ZooKeeper, а остальные настроены как наблюдатели. Подробнее о лидерах, подписчиках, голосующих и наблюдателях… Узлы-избиратели выбирают лидера, после чего сами становятся последователями.

В процессе обновления может возникнуть кратковременная задержка или сбой записи в ZooKeeper при отключении ведущего узла. Это может повлиять на операции управления, которые записывают данные в ZooKeeper, например на развертывание прокси-сервера, и на изменения инфраструктуры Apigee, например на добавление или удаление Message Processor и т. д. Обновление ZooKeeper не должно повлиять на API среды выполнения Apigee (если только эти API среды выполнения не вызывают Management API), если вы будете следовать приведенной ниже процедуре.

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

Создайте резервную копию

Take a backup of all nodes of ZooKeeper for use in case a rollback is required. Обратите внимание, что при откате ZooKeeper будет восстановлен до состояния, в котором он находился на момент создания резервной копии.

/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper backup

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

Определите лидера, последователей и наблюдателей

1. Если он не установлен на узле ZooKeeper, установите nc:

   yum install nc

2. Выполните на узле следующую команду nc, где 2181 – это порт ZooKeeper:

   echo stat | nc localhost 2181

   Вы должны увидеть примерно следующее:

   Zookeeper version: 3.8.5-19f1842d4b6ee1f82cc8b05284959b26c6ae507d, built on 2025-09-03 21:35 UTC
   Clients:
    /[0:0:0:0:0:0:0:1]:40696[0](queued=0,recved=1,sent=0)
   
   Latency min/avg/max: 3/4.3333/6
   Received: 4
   Sent: 3
   Connections: 1
   Outstanding: 0
   Zxid: 0x500000005
   Mode: follower

   В строке Mode выходных данных для узлов вы должны увидеть observer, leader или follower (то есть голосующий узел, который не является лидером) в зависимости от конфигурации узла.

1. Повторите шаги 1 и 2 на каждом узле ZooKeeper.

Как обновить ZooKeeper на узлах наблюдателя и подписчика

Обновите ZooKeeper на каждом из узлов наблюдателя и подписчика следующим образом:

1. Скачайте и запустите начальную загрузку Edge для Private Cloud 4.54.00, как описано в разделе Обновление до версии 4.54.00 на узле с внешним подключением к интернету . Процесс может различаться в зависимости от того, есть ли у узла внешнее подключение к интернету или вы выполняете офлайн-установку.

2. Обновите компонент ZooKeeper:

   /opt/apigee/apigee-setup/bin/update.sh -c zk -f silent-config-file

   Примечание. Если на этих узлах установлены другие компоненты (например, Cassandra), вы можете обновить их сейчас (например, с помощью профиля zk,cs) или позже. Apigee рекомендует сначала обновить только ZooKeeper и убедиться, что кластер работает правильно, прежде чем обновлять другие компоненты.

3. Повторите описанные выше шаги для каждого узла наблюдателя и подписчика ZooKeeper.

Устраните лидера

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

/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

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

Убедитесь, что выбран новый лидер

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

Лидер по обновлениям

Выполните те же действия, что и в разделе Обновление ZooKeeper на узлах наблюдателя и подписчика выше.

После обновления старого узла-лидера проверьте состояние кластера и убедитесь, что узел-лидер существует.

Обновление до Cassandra 5.0.8

В Apigee Edge for Private Cloud 4.54.00 входит обновление Cassandra до версии 5.0.8.

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

• Обновление с Cassandra 4.0.X до Cassandra 5.0.X выполняется последовательно.

• Прямой откат с Cassandra 5.0.X до 4.0.X невозможен. Откат с помощью реплик или резервных копий – сложная процедура, которая может привести к простою и/или потере данных. Вместо отката рекомендуется устранить неполадки и перейти на Cassandra 5.0.X.

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

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

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

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

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

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

• Для отката требуется хотя бы один центр обработки данных, в котором работает более ранняя версия Cassandra (4.0.X).

Рекомендуемая методика перехода

1. Обновляйте по одному центру обработки данных Cassandra за раз. Начните с обновления узлов Cassandra по отдельности в одном центре обработки данных. Завершите обновление всех узлов Cassandra в одном центре обработки данных, прежде чем переходить к следующему.

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

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

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

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

Процесс отката контрольной точки

Единая контрольная точка отката. Когда все компоненты обновлены до версии 4.54.00, откат Cassandra возможен, только если хотя бы один центр обработки данных Cassandra продолжает работать на более старой версии. После обновления последнего центра обработки данных Cassandra обновление до Edge для Private Cloud 4.54.00 завершено, и откат больше невозможен.

Пример

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

1. Начальное состояние. Узлы Cassandra в обоих ЦОД работают на версии 4.0.X. Все остальные узлы работают на Edge for Private Cloud версии 4.54.00. Предположим, что в каждом ЦОД есть три узла Cassandra.

2. Обновите DC-1. Поочередно обновите три узла Cassandra в DC-1.

3. Приостановка и проверка. Приостановите работу, чтобы убедиться, что кластер, особенно DC-1, работает правильно (проверьте производительность и функциональность). Вы можете выполнить откат к исходному состоянию, используя узлы Cassandra в DC-2. Помните, что эта пауза должна быть временной из-за ограничений кластера Cassandra со смешанными версиями.

4. Обновите DC-2. Обновите оставшиеся три узла Cassandra в DC-2. После успешного обновления всех узлов Cassandra в DC-2 обновление Edge для Private Cloud 4.54.00 будет завершено.

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

Вы должны использовать Cassandra 4.0.X с Edge для Private Cloud 4.53.00 или 4.53.01 и убедиться в следующем:

1. Установите Java 17 в качестве версии Java по умолчанию на сервере. Cassandra 5.0.X не поддерживает Java 8. Вы не можете запустить Cassandra 5.0.X или ее утилиту nodetool с Java 8. Убедитесь, что на каждом узле Cassandra установлена Java 17, и установите Java 17 в качестве версии Java по умолчанию перед выполнением шагов обновления Cassandra, чтобы команды nodetool выполнялись с Java 17:

   alternatives --set java JAVA_17_PATH/bin/java

   Убедитесь, что активной версией Java по умолчанию является Java 17:

   java -version

2. Весь кластер работает и полностью совместим с Cassandra 4.0.X.

3. Для стратегии сжатия задано значение LeveledCompactionStrategy (необходимое условие для обновления до версии 4.53.00 или 4.53.01).

4. Убедитесь, что каждый из перечисленных ниже шагов был выполнен в рамках первоначального обновления Cassandra 4.0.X в Edge для частного облака версии 4.53.00 или 4.53.01.

   • Команда post_upgrade была выполнена на каждом узле Cassandra во время предыдущего обновления.

   • Команда drop_old_tables была выполнена для всего кластера Cassandra во время предыдущего обновления.

Если вы не уверены, что команды post_upgrade и drop_old_tables были выполнены в Cassandra 4.0.X при использовании Edge для Private Cloud 4.53.00 или 4.53.01, вы можете безопасно запустить их повторно, прежде чем пытаться выполнить обновление до версии 4.54.00.

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

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

1. Резервное копирование Cassandra с помощью Apigee.

2. Сделайте снимки виртуальных машин узлов Cassandra (если возможно).

3. Убедитесь, что порт 9042 доступен из всех компонентов Edge для частного облака, включая сервер управления, процессор сообщений, маршрутизатор, Qpid и Postgres, для узлов Cassandra, если они ещё не настроены. Дополнительную информацию можно найти в разделе Требования к портам.

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

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

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

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.2.0 | Cassandra 5.0.8 | CQL spec 3.4.7 | Native protocol v5]
   Metadata is verified

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

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

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

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra cleanup_old_index

6. Выполните следующие команды 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 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 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 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 cache cache_entries cache_entries_cache_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 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

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

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

• Удалите Apigee mTLS .

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

Как откатить обновление

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

Если вам нужно откатить обновление до предыдущей версии, следуйте инструкциям в разделе Откат до версии 4.54.00.

Запись информации об обновлении

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

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

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

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

Обновление без простоя

Обновление без простоя, или последовательное обновление, позволяет обновить Edge без его отключения.

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

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

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

2. Когда придет время обновить маршрутизаторы, выберите любой из них и сделайте его недоступным, как описано в разделе Включение/отключение доступности сервера (процессора сообщений/маршрутизатора) .

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

4. Сделайте маршрутизатор снова доступным.

5. Повторите шаги 2–4 для остальных маршрутизаторов.

6. Обновите оставшиеся компьютеры.

Перед обновлением и после него выполните следующие действия:

• На комбинированном узле маршрутизатора и обработчика сообщений:

  • Перед обновлением выполните следующие действия:

    1. Сделайте маршрутизатор недоступным.

    2. Сделайте Message Processor недоступным.

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

    1. Сделайте Message Processor доступным.

    2. Как сделать маршрутизатор доступным

• На отдельных узлах маршрутизатора:

  • Перед обновлением сделайте маршрутизатор недоступным.

  • После обновления сделайте маршрутизатор доступным.

• На отдельных узлах Message Processor:

  • Перед обновлением сделайте Message Processor недоступным.

  • После обновления сделайте Message Processor доступным.

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

В команду обновления необходимо передать файл конфигурации для автоматической установки. Хотя файл конфигурации для автоматической установки в основном похож на тот, который вы использовали для установки Edge для Private Cloud 4.53.00 или 4.53.01, вам может потребоваться внести изменения в такие компоненты, как пользовательский интерфейс и SSO, как описано в разделе Обновление до нового пользовательского интерфейса Edge и Apigee SSO (если установлено).

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

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

1. Если у вас есть задания cron, настроенные на восстановление Cassandra, отключите их до завершения обновления.

2. Войдите в узел как root, чтобы установить Edge RPM.

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

3. Отключите SELinux, как описано в статье Установка утилиты apigee-setup для Edge .

4. Если вы устанавливаете на AWS , выполните следующие команды yum-configure-manager:

   yum update rh-amazon-rhui-client.noarch
   yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

5. Если вы используете Edge для Private Cloud 4.53.00 или 4.53.01:

   1. Скачайте файл Edge bootstrap_4.54.00.sh в папку /tmp/bootstrap_4.54.00.sh :

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

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

      bash /tmp/bootstrap_4.54.00.sh apigeeuser=uName apigeepassword=pWord

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

      По умолчанию установщик проверяет, установлены ли у вас Java 17 и 21.

   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, который нужно обновить. Некоторые возможные значения:

        • edge : все компоненты Edge, кроме New Edge UI: Management Server, Message Processor, Router, QPID Server, Postgres Server.

        • ldap : OpenLDAP

        • ue : новый интерфейс Edge

        • qpid : Apigee Qpid

        • ps : Apigee Postgresql

        • zk : ZooKeeper

        • cs : Кассандра

      • configFile – это тот же файл конфигурации, который вы использовали для определения компонентов Edge во время установки версии 4.53.00 или 4.53.01.

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

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

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

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

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

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

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

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

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

• Создайте TAR-файл репозитория, скопируйте его на узел и обновите Edge из этого файла.

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

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

1. Создайте локальное хранилище 4.54.00, как описано в разделе "Создание локального хранилища Apigee" статьи Установка утилиты apigee-setup для Edge.

2. Установите apigee-service на целевых узлах одним из следующих способов:

   • Вариант 1 .Установите apigee-service из TAR-файла

     1. На узле с локальным репозиторием используйте следующую команду, чтобы упаковать локальный репозиторий в один файл .tar с именем /opt/apigee/data/apigee-mirror/apigee-4.54.00.tar.gz:

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

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

     3. На новом узле распакуйте файл в каталог /tmp:

        tar -xzf apigee-4.54.00.tar.gz

        Эта команда создает новый каталог с названием repos в каталоге, содержащем TAR-файл. (пример: /tmp/repos).

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

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

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

   • Вариант 2. Установка apigee-service с помощью веб-сервера Nginx

     1. Настройте веб-сервер Nginx, как описано в разделе "Установка из репозитория с помощью веб-сервера Nginx" статьи Как установить утилиту apigee-setup для Edge.

     2. На удаленном узле скачайте файл Edge bootstrap_4.54.00.sh в каталог /tmp/bootstrap_4.54.00.sh:

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

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

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

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

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

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, который нужно обновить. Некоторые возможные значения:

     • edge : все компоненты Edge, кроме New Edge UI: Management Server, Message Processor, Router, QPID Server, Postgres Server.

     • ldap : OpenLDAP

     • ue : новый интерфейс Edge

     • qpid : Apigee Qpid

     • ps : Apigee Postgresql

     • zk : ZooKeeper

     • cs : Кассандра

   • configFile – это тот же файл конфигурации, который вы использовали для определения компонентов Edge во время установки версии 4.53.00 или 4.53.01.

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

     chown apigee:apigee configFile

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

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

7. Перезапустите компоненты пользовательского интерфейса на всех узлах, на которых они запущены, если вы ещё этого не сделали:

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

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

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

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

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

1. Обновите все узлы Router и Message Processor во всех центрах обработки данных с помощью параметра -c edge.

2. Обновите все узлы сервера управления во всех центрах обработки данных, используя параметр -c edge.

3. Обновите все узлы LDAP во всех центрах обработки данных. Если вы переходите с Edge for Private Cloud 4.53.00, вам нужно будет выполнить дополнительные действия, описанные в разделе Специальные действия по обновлению LDAP.

4. Обновите пользовательский интерфейс и систему единого входа Apigee (если она установлена) во всех центрах обработки данных:

   1. Если apigee-sso не установлен, следуйте инструкциям в разделе Вариант 1. Обновление интерфейса (без Apigee SSO), чтобы перейти на новый интерфейс Edge.

   2. Если apigee-sso установлено, следуйте инструкциям в разделе Вариант 2. Обновление пользовательского интерфейса (с Apigee SSO), чтобы перейти на New Edge UI и Apigee SSO.

5. Обновите все компоненты Qpid и edge-qpid-server во всех центрах обработки данных, следуя специальным инструкциям для Qpid.

6. Обновите все компоненты Postgresql и edge-postgres-server во всех центрах обработки данных, следуя специальным инструкциям для Postgres.

7. Обновите все компоненты Zookeeper во всех центрах обработки данных, следуя специальным инструкциям по обновлению Zookeeper.

8. Обновите все компоненты Cassandra во всех центрах обработки данных, следуя специальным инструкциям по обновлению Cassandra.

9. Отдельного шага для обновления монетизации нет. Оно обновляется, когда вы указываете параметр -c edge.

Обновление отдельного узла

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

При обновлении с Edge для Private Cloud 4.53.00 сначала необходимо обновить LDAP, следуя инструкциям по обновлению с версии 4.53.00 до 4.54.00, прежде чем начинать обновление всех компонентов.

1. Обновление всех компонентов:

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

2. Если вы установили apigee-adminapi, обновите утилиту apigee-adminapi:

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

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

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

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

1. Обновите компоненты Edge на компьютере 1:

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

2. Обновите LDAP на компьютере 1:

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

3. Обновите новый интерфейс Edge на компьютере 1:

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

4. Обновите компоненты Edge на компьютере 2:

   /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. Обновите Postgres на машине 2:

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

7. Обновите Cassandra и ZooKeeper на компьютере 1:

   /opt/apigee/apigee-setup/bin/update.sh -c zk,cs -f configFile

8. Если вы установили apigee-adminapi, обновите утилиту apigee-adminapi на компьютере 1:

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

Обновление до 5 узлов

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

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

1. Обновите компоненты Edge на компьютерах 2, 3 и 1:

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

2. Обновите LDAP на компьютере 1:

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

3. Обновите новый интерфейс Edge на компьютере 1:

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

4. Обновите компоненты Edge на компьютерах 4 и 5:

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

5. Обновите Qpid на компьютерах 4 и 5:

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

6. Обновите Postgres на компьютерах 4 и 5:

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

7. Обновите Cassandra и ZooKeeper на компьютерах 1, 2 и 3:

   /opt/apigee/apigee-setup/bin/update.sh -c zk,cs -f configFile

8. Если вы установили apigee-adminapi, обновите утилиту apigee-adminapi на компьютере 1:

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

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

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

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

1. Обновите компоненты Edge на компьютерах 4, 5 и 1 (маршрутизатор, обработчик сообщений и сервер управления) в указанном порядке:

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

2. Обновите LDAP на компьютере 1:

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

3. Обновите новый интерфейс Edge на компьютере 1:

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

4. Обновите компоненты Edge на компьютерах 6, 7, 8 и 9 в указанном порядке:

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

5. Обновите Qpid на компьютерах 6 и 7:

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

6. Обновите Postgres на компьютере 8:

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

7. Обновите Postgres на компьютере 9:

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

8. Обновите Cassandra и ZooKeeper на компьютерах 1, 2 и 3:

   /opt/apigee/apigee-setup/bin/update.sh -c zk,cs -f configFile

9. Если вы установили apigee-adminapi, обновите утилиту apigee-adminapi на компьютере 1:

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

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

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

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

1. Обновите компоненты Edge на компьютерах 10, 11, 6 и 7 в указанном порядке:

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

2. Обновите LDAP на компьютерах 4 и 5:

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

3. Обновите новый интерфейс Edge на компьютерах 6 и 7:

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

4. Обновите компоненты Edge на компьютерах 12, 13, 8 и 9 в указанном порядке:

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

5. Обновите Qpid на компьютерах 12 и 13:

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

6. Обновите Postgres на компьютере 8:

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

7. Обновите Postgres на компьютере 9:

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

8. Обновите Cassandra и ZooKeeper на компьютерах 1, 2 и 3:

   /opt/apigee/apigee-setup/bin/update.sh -c zk,cs -f configFile

9. (Если вы установили apigee-adminapi) Обновите утилиту apigee-adminapi на компьютерах 6 и 7:

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

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

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

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

1. Обновите компоненты Edge (маршрутизатор и обработчик сообщений):

   • На компьютерах 2 и 3 в центре обработки данных 1:

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

   • На машинах 8 и 9 в центре обработки данных 2:

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

2. Обновите компоненты Edge (сервер управления):

   • На компьютере 1 в центре обработки данных 1:

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

   • На машине 7 в центре обработки данных 2:

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

3. Обновить LDAP:

   • Компьютер 1 в центре обработки данных 1:

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

   • Компьютер 7 в центре обработки данных 2:

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

4. Обновите компоненты New Edge UI:

   • На компьютере 1 в центре обработки данных 1:

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

   • На машине 7 в центре обработки данных 2:

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

5. Обновите компоненты Edge:

   • Машины 4, 5, 6 в центре обработки данных 1:

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

   • Машины 10, 11, 12 в центре обработки данных 2:

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

6. Обновите qpidd:

   • Машины 4 и 5 в центре обработки данных 1:

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

   • Машины 10 и 11 в центре обработки данных 2:

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

7. Обновите Postgres:

   • Компьютер 6 в центре обработки данных 1:

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

   • Компьютер 12 в центре обработки данных 2:

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

8. Обновите Cassandra и ZooKeeper:

   • Машины 1, 2 и 3 в центре обработки данных 1:

     /opt/apigee/apigee-setup/bin/update.sh -c zk,cs -f configFile

   • На компьютерах 7, 8 и 9 в центре обработки данных 2:

     /opt/apigee/apigee-setup/bin/update.sh -c zk,cs -f configFile

9. Если вы установили apigee-adminapi, обновите утилиту apigee-adminapi:

   • Компьютер 1 в центре обработки данных 1:

     /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

   • Компьютер 7 в центре обработки данных 2:

     /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

Нестандартная конфигурация

If you have a non-standard configuration, then update Edge components in the following order:

1. Маршрутизатор

2. Message Processor

3. Сервер управления

4. LDAP

5. Интерфейс (классический или новый)

6. SSO (если применимо)

7. Qpid и edge-qpid-server

8. Postgres и edge-postgres-server;

9. ZooKeeper

10. Cassandra

11. apigee-adminapi