Обновите Apigee Edge 4.50.00 или 4.51.00 до 4.52.00.

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

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

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

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

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

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

Обновить необходимые условия

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

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

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

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

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

• Убедитесь, что стратегия конкуренции Cassandra имеет значение LeveledCompactionStrategy
  Убедитесь, что для стратегии совместимости Cassandra установлено значение LeveledCompactionStrategy , как описано в разделе Изменение стратегии сжатия Cassandra .

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

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

Требуется обновление до Zookeeper 3.8.0.

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

Прежде чем обновлять Zookeeper, прочтите руководство по обслуживанию Zookeeper . Большинство производственных систем Edge используют кластер узлов Zookeeper, распределенных по нескольким центрам обработки данных. Некоторые из этих узлов настроены как избиратели, которые участвуют в выборах лидера Zookeeper, а остальные настроены как наблюдатели. Более подробную информацию см. в разделе «О лидерах, последователях, избирателях и наблюдателях» . Узлы избирателей выбирают лидера, после чего узлы избирателей сами становятся последователями.

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

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

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

Сделайте резервную копию всех узлов Zookeeper для использования в случае необходимости отката. Обратите внимание, что откат вернет Zookeeper в состояние, в котором была создана резервная копия. Примечание. Любые развертывания или изменения инфраструктуры в Apigee с момента создания резервной копии (информация которой хранится в Zookeeper) будут потеряны во время восстановления.

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

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

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

Примечание. В приведенных ниже примерах команд используется утилита nc для отправки данных в Zookeeper. Вы также можете использовать альтернативные утилиты для отправки данных в Zookeeper.

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

     sudo yum install nc

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

     echo stat | nc localhost 2181

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

     Zookeeper version: 3.8.0-5a02a05eddb59aee6ac762f7ea82e92a68eb9c0f, built on 2022-02-25 08:49 UTC
     Clients:
      /0:0:0:0:0:0:0:1:41246[0](queued=0,recved=1,sent=0)
     
     Latency min/avg/max: 0/0.2518/41
     Received: 647228
     Sent: 647339
     Connections: 4
     Outstanding: 0
     Zxid: 0x400018b15
     Mode: follower
     Node count: 100597

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

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

Обновите Zookeeper на узлах наблюдателя и ведомого.

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

1. Загрузите и запустите загрузку Edge for Private Cloud 4.52, как описано в разделе Обновление до 4.52.00, на узле с внешним подключением к Интернету . Скорее всего, процесс будет различаться в зависимости от того, имеет ли узел внешнее подключение к Интернету или вы выполняете автономную установку.
2. Обновите компонент Zookeeper:

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

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

Выключение лидера

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

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

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

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

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

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

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

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

Откат

В случае, если требуется откат:

1. Сначала выполните шаги отката для наблюдателей и ведомых.
2. Загрузите и выполните загрузку версии, к которой вы откатываетесь — 4.50 или 4.51. Процесс, скорее всего, будет различаться в зависимости от того, имеет ли узел внешнее подключение к Интернету или вы выполняете автономную установку.
3. Остановите Zookeeper, если он запущен на узле:

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

4. Удалите существующий Zookeeper:

     /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper uninstall

  /opt/apigee/apigee-setup/bin/setup.sh -p zk -f <silent-config-file>

Восстановить резервную копию

См. раздел Восстановление из резервной копии . Обратите внимание, что резервные копии Zookeeper, сделанные из более ранних версий Edge для частного облака, таких как 4.50 и 4.51, должны быть совместимы с версией Zookeeper в Edge для частного облака 4.52.

Требуется обновление до Postgres 14.

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

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

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

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

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

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

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

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

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

Эта процедура создает резервный сервер Postgres на новом узле. Убедитесь, что вы установили новый резервный сервер Postgres для существующей версии Edge (4.50.00 или 4.51.00), а не для версии 4.52.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 master:
      PG_MASTER=192.168.56.103
      # IP address of the new standby node
      PG_STANDBY=192.168.56.102

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

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

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

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

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

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

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

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

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

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

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

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

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

   5. Установите Постгрес:

      /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 :

   sudo 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 14 на месте, выполните следующие действия:

1. Обновите postgres на главном хосте

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

2. Запустите команду установки на главном хосте:

   apigee-service apigee-postgresql setup -f /opt/silent.conf

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

   apigee-service apigee-postgresql configure

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

   apigee-service apigee-postgresql restart

5. Настройте его как главный:

   apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf

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

   apigee-service apigee-postgresql wait_for_ready

7. Остановите режим ожидания:

   apigee-service apigee-postgresql stop

8. Обновите режим ожидания.

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

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

9. Убедитесь, что режим ожидания остановлен:

   apigee-service apigee-postgresql stop

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

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

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

    apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf

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, выполнив следующий вызов API управления Edge на узле сервера управления:

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

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

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

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

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

Новый интерфейс Edge

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

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

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

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

Дополнительные сведения см. в разделе Установка нового пользовательского интерфейса Edge .

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

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

• С 4.51.00 по 4.52.00 (с уже установленным новым пользовательским интерфейсом Edge): используйте инструкции по обновлению в этом разделе для компонента edge-management-ui .

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

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

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

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

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

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

Регистрация информации об обновлении

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1. Если они есть, отключите все задания cron , настроенные для выполнения операции восстановления в Cassandra, до завершения обновления.
2. Войдите на свой узел как root, чтобы установить Edge RPM.
3. Установите yum-utils и yum-plugin-priorities :

   sudo yum install yum-utils
   sudo yum install yum-plugin-priorities

4. Отключите SELinux, как описано в разделе Установка утилиты Edge apigee-setup .
5. Если вы устанавливаете Oracle 7.x , выполните следующую команду:

   sudo yum-config-manager --enable ol7_optional_latest

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

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

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

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

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

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

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

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

      По умолчанию установщик проверяет, установлена ​​ли у вас Java 1.8. Если вы этого не сделаете, установщик установит его за вас.

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

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

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

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

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

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

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

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

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

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

      Где:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

         tar -xzf apigee-4.52.00.tar.gz

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

      Где:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   2. (Если вы установили apigee-adminapi ) Обновлена ​​утилита apigee-adminapi :

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

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

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

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

   1. Обновите Cassandra и ZooKeeper на машине 1:

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

   2. Обновите Qpid и Postgres на машине 2:

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

   3. Обновите LDAP на машине 1:

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

   4. Обновите компоненты Edge на машинах 2 и 1:

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

   5. Обновите пользовательский интерфейс на компьютере 1:

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

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

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

   7. (Если вы установили Apigee SSO) Обновите Apigee SSO на компьютере 1:

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

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

   8. Перезапустите компонент Edge UI на компьютере 1:

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

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

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

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

   1. Обновите Cassandra и ZooKeeper на машинах 1, 2 и 3:

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

   2. Обновите Qpid и Postgres на машине 4:

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

   3. Обновите Qpid и Postgres на машине 5:

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

   4. Обновите LDAP на машине 1:

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

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

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

   6. Обновите пользовательский интерфейс Edge:
      • Классический пользовательский интерфейс. Если вы используете классический пользовательский интерфейс, обновите компонент ui на компьютере 1, как показано в следующем примере:

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

      • Новый пользовательский интерфейс Edge: если вы установили новый пользовательский интерфейс Edge, обновите компонент ue на соответствующем компьютере (может быть не на компьютере 1):

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

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

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

   8. (Если вы установили Apigee SSO) Обновите Apigee SSO на компьютере 1:

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

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

   9. Перезапустите компонент пользовательского интерфейса:
      • Классический пользовательский интерфейс. Если вы используете классический пользовательский интерфейс, перезапустите компонент edge-ui на компьютере 1, как показано в следующем примере:

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

      • Новый пользовательский интерфейс Edge: если вы установили новый пользовательский интерфейс Edge, перезапустите компонент edge-management-ui на соответствующем компьютере (может быть не на компьютере 1):

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

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

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

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

   1. Обновите Cassandra и ZooKeeper на машинах 1, 2 и 3:

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

   2. Обновите Qpid на машинах 6 и 7:

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

   3. Обновите Postgres на машине 8:

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

   4. Обновите Postgres на машине 9:

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

   5. Обновите LDAP на машине 1:

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

   6. Обновите компоненты Edge на машинах 6, 7, 8, 9, 1, 4 и 5 в следующем порядке:

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

   7. Обновите новый пользовательский интерфейс ( ue ) или классический пользовательский интерфейс ( ui ) на компьютере 1:

      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

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

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

   9. (Если вы установили Apigee SSO) Обновите Apigee SSO на компьютере 1:

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

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

   10. Перезапустите компонент пользовательского интерфейса:
       • Классический пользовательский интерфейс. Если вы используете классический пользовательский интерфейс, перезапустите компонент edge-ui на компьютере 1, как показано в следующем примере:

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

       • Новый пользовательский интерфейс Edge: если вы установили новый пользовательский интерфейс Edge, перезапустите компонент edge-management-ui на соответствующем компьютере (может быть не на компьютере 1):

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

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

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

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

   1. Обновите Cassandra и ZooKeeper на машинах 1, 2 и 3:

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

   2. Обновите Qpid на машинах 12 и 13:

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

   3. Обновите Postgres на машине 8:

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

   4. Обновите Postgres на машине 9:

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

   5. Обновите LDAP на машинах 4 и 5:

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

   6. Обновите компоненты Edge на компьютерах 12, 13, 8, 9, 6, 7, 10 и 11 в следующем порядке:

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

   7. Обновите новый пользовательский интерфейс ( ue ) или классический пользовательский интерфейс ( ui ) на компьютерах 6 и 7:

      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

   8. (Если вы установили apigee-adminapi ) Обновлена ​​утилита apigee-adminapi на машинах 6 и 7:

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

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

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

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

   10. Перезапустите компонент пользовательского интерфейса:
       • Классический пользовательский интерфейс. Если вы используете классический пользовательский интерфейс, перезапустите компонент edge-ui на компьютерах 6 и 7, как показано в следующем примере:

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

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

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

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

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

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

   1. Обновите Кассандру и ZooKeeper:
      1. На компьютерах 1, 2 и 3 в центре обработки данных 1:

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

      2. На компьютерах 7, 8 и 9 в дата-центре 2.

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

   2. Обновить qpidd:
      1. Машины 4, 5 в дата-центре 1
         1. Обновите qpidd на машине 4:

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

         2. Обновите qpidd на машине 5:

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

      2. Машины 10, 11 в ЦОД 2
         1. Обновите qpidd на машине 10:

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

         2. Обновите qpidd на машине 11:

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

   3. Обновить Постгрес:
      1. Машина 6 в дата-центре 1

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

      2. Машина 12 в дата-центре 2

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

   4. Обновить LDAP:
      1. Машина 1 в дата-центре 1

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

      2. Машина 7 в дата-центре 2

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

   5. Обновите компоненты Edge:
      1. Машины 4, 5, 6, 1, 2, 3 в дата-центре 1

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

      2. Машины 10, 11, 12, 7, 8, 9 в дата-центре 2

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

   6. Обновите либо новый пользовательский интерфейс ( ue ), либо классический пользовательский интерфейс ( ui ):
      1. Машина 1 в дата-центре 1:

         /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

      2. Машина 7 в дата-центре 2:

         /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

   7. (Если вы установили apigee-adminapi ) Обновлена ​​утилита apigee-adminapi :
      1. Машина 1 в дата-центре 1:

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

      2. Машина 7 в дата-центре 2:

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

   8. (Если вы установили Apigee SSO) Обновите Apigee SSO:
      1. Машина 1 в дата-центре 1:

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

      2. Машина 7 в дата-центре 2:

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

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

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

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

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

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

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

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