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

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

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

Лицо, запускающее обновление, должно быть тем же человеком, который первоначально установил 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.3.

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

Прежде чем обновлять 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.3-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.01, на узле с внешним подключением к Интернету . Скорее всего, процесс будет различаться в зависимости от того, имеет ли узел внешнее подключение к Интернету или вы выполняете автономную установку.
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

5. Установите Zookeeper как обычно:

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

6. После отката всех ведомых и наблюдателей откатите ведущий узел, выполнив шаги со 2 по 5 на ведущем узле.
7. После отката всех узлов проверьте работоспособность кластера и убедитесь, что в кластере есть ведущий узел.

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

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

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

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

• Если вы обновляете Edge for Private Cloud 4.51.00 до 4.52.01, необходимо выполнить дополнительные шаги по обновлению Postgres. Обратитесь к разделу «Необходимое обновление до Postgres 14», если вы обновляетесь с версии 4.51.00 до 4.52.01.
• Если вы обновляете Edge for Private Cloud 4.52.00 до 4.52.01, никаких дополнительных действий по обновлению Postgres не требуется.

Обновить Qpid

Этот выпуск Edge для частного облака включает обновление до Qpid J-Broker.

Мы рекомендуем вам выбрать один из следующих методов для обновления Qpid:

• Обновление на месте без простоев
• Ввод в эксплуатацию нового узла Qpid

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

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

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

1. Для начала выберите один узел Qpid.
2. Остановите брокера Qpid на узле:

   apigee-service apigee-qpidd stop

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

   Мы рекомендуем выполнить одно и то же действие для всех IP-адресов обработчика сообщений. Например, чтобы отбросить запросы, поступающие с IP-адресов процессора сообщений на узел Qpid на порту 5672 с помощью IPTables, вы можете использовать такую ​​команду:

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

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

   apigee-service apigee-qpidd start

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

   qpid-stat -q

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

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

   apigee-service apigee-qpidd stop

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

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

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

   apigee-service edge-qpid-server restart

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

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

   iptables -F
     iptables -L

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

    http://QPID_NODE_IP:8090

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

Ввод в эксплуатацию нового узла Qpid

Этот метод настраивает и устанавливает apigee-qpidd и edge-qpid-server на новом узле.

1. Добавьте новый узел Qpid. На этом этапе настраивается узел Qpid с J-брокером. Подробные инструкции см. в разделе Добавление сервера Qpid .
2. Выберите существующий узел Qpid (узел из версии, с которой вы обновляетесь).
3. Остановите брокера Qpid на узле:

   apigee-service apigee-qpidd stop

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

   Мы рекомендуем выполнить одно и то же действие для всех IP-адресов обработчика сообщений. Например, чтобы отбросить запросы, поступающие с IP-адресов процессора сообщений на узел Qpid на порту 5672 с помощью IPTables, вы можете использовать такую ​​команду:

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

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

   apigee-service apigee-qpidd start

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

   qpid-stat -q

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

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

   apigee-service apigee-qpidd stop

8. Отмените регистрацию старого узла Qpid, выполнив действия, описанные в разделе Удаление сервера Qpid .
9. Продолжайте добавлять новый узел и удалять старый узел по одному, пока все узлы Qpid не будут обновлены.

Откат

Чтобы вернуться к предыдущей версии функции, обязательно загрузите файл bootstrap.sh для той версии, до которой вы хотите выполнить откат. Чтобы откатиться на версию 4.52.00, скачайте bootstrap_4.52.00.sh .

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

1. Остановите существующего брокера Qpid

   apigee-service apigee-qpidd stop

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

   Мы рекомендуем выполнить одно и то же действие для всех IP-адресов обработчика сообщений. Например, чтобы отбросить запросы, поступающие с IP-адресов процессора сообщений на узел Qpid на порту 5672 с помощью IPTables, вы можете использовать такую ​​команду:

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

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

   apigee-service apigee-qpidd start

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

   http://QPID_NODE_IP:8090

   Примечание. Если этот порт 8090 на узле QPID недоступен, вы можете использовать альтернативные механизмы, такие как переадресация портов SSH, для доступа к этому URL-адресу.
5. Убедившись, что очереди опустошены, остановите и удалите Qpid:

   apigee-service apigee-apidd uninstall

6. Удалите каталог данных Qpid:

   rm -r APIGEE_ROOT/data/apigee-qpidd

7. Переустановите брокер Qpid:

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

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

   iptables -F

   iptables -L

Новый интерфейс 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.01 на узле с внешним подключением к Интернету.

Используйте следующую процедуру для обновления компонентов 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.01.sh в /tmp/bootstrap_4.52.01.sh :

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

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

      sudo bash /tmp/bootstrap_4.52.01.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.01» .

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

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

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

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

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

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

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

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

      tar -xzf apigee-4.52.01.tar.gz

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

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

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

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

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

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

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

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

      sudo bash /tmp/bootstrap_4.52.01.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.01» .

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1. смотритель зоопарка
2. Кассандра
3. пс
4. ЛДАП
5. Edge, что означает профиль «-c Edge» на всех узлах по порядку: узлы с сервером Qpid, пограничным сервером Postgres, сервером управления, процессором сообщений и маршрутизатором.
6. qpidd
7. Пользовательский интерфейс Edge (классический или новый)
8. apigee-adminapi
9. Апиги Единый вход

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