Как обновить 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 для частного облака 4.54.00 может обнаруживать установленные версии Java и проверять, установлены ли у вас Java 17 и 21.

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

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

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

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

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

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

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

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

• Создать резервную копию всех узлов

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

• Резервная копия файла конфигурации

  Убедитесь, что резервные копии файлов конфигурации для Edge для частного облака 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

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

/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 для частного облака 4.54.00 классический интерфейс (edge-ui) удален и заменен на новый интерфейс Edge (edge-management-ui). В зависимости от того, установлена ли в вашей системе Apigee SSO и используется ли она, следуйте одному из двух вариантов ниже.

# 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

   Если сообщения застряли в очереди недоставленных сообщений (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, как описано в разделе Установка утилиты Edge apigee-setup.

   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-setup, используйте apigee-service:

      /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).

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

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

Создайте резервную копию всех узлов ZooKeeper на случай, если потребуется выполнить откат. Обратите внимание, что при откате 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 для частного облака 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 для частного облака 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 для частного облака 4.53.00 или 4.53.01 обеспечивает большую гибкость при откате во время обновления до Edge для частного облака 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 для частного облака версии 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 по умолчанию. Это необходимо для того, чтобы команды 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:

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

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

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

В команду обновления необходимо передать файл конфигурации в тихом режиме. Хотя файл конфигурации для автоматической установки в основном похож на тот, который вы использовали для установки 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, как описано в разделе Установка утилиты Edge apigee-setup .

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 для частного облака версии 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, кроме нового интерфейса Edge: сервер управления, процессор сообщений, маршрутизатор, сервер QPID, сервер Postgres

        • 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 All-in-One (AIO). Пример:

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

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

      /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, кроме нового интерфейса Edge: сервер управления, процессор сообщений, маршрутизатор, сервер QPID, сервер Postgres

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

   /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. Как обновить интерфейс New 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

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

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

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