Как обновить Apigee Edge 4.51.00 или 4.52.00 до версии 4.52.01

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

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

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

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

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

Вам необходимо обновить все компоненты 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, такие как добавление или удаление процессора сообщений. При обновлении Zookeeper в соответствии с приведенной ниже процедурой не должно быть никакого влияния на API времени выполнения Apigee (если только эти API времени выполнения не вызывают API управления).

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

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

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

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

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

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

Примечание. В приведенных ниже примерах команд для отправки данных в Zookeeper используется утилита nc. Вы также можете использовать другие утилиты для отправки данных в 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 выходных данных для узлов должно быть указано observer, leader или follower (то есть голосующий, но не лидер) в зависимости от конфигурации узла. Примечание. При отдельной установке Edge с одним узлом ZooKeeper для параметра Mode устанавливается значение standalone.

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

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

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

1. Скачайте и запустите загрузчик Edge для частного облака 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. Если вы переходите с версии 4.51.00 на 4.52.01, ознакомьтесь с разделом Обязательный переход на Postgres 14.
• Если вы переходите с Edge для частного облака версии 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-адресов обработчиков сообщений. Например, чтобы с помощью IPTables ОТКЛОНИТЬ запросы, поступающие от IP-адресов обработчика сообщений к узлу Qpid на порту 5672, можно использовать следующую команду:

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

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

   apigee-service apigee-qpidd start

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

   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.

Как запустить новый узел Qpid

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

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

   apigee-service apigee-qpidd stop

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

   Рекомендуем выполнить то же действие для всех IP-адресов обработчиков сообщений. Например, чтобы с помощью IPTables ОТКЛОНИТЬ запросы, поступающие от IP-адресов обработчика сообщений к узлу Qpid на порту 5672, можно использовать следующую команду:

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

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

   apigee-service apigee-qpidd start

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

   qpid-stat -q

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

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

   apigee-service apigee-qpidd stop

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

Откат

Чтобы выполнить откат до предыдущей версии Feature Release, скачайте файл bootstrap.sh для нужной версии. Чтобы выполнить откат до версии 4.52.00, скачайте файл bootstrap_4.52.00.sh.

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

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

   apigee-service apigee-qpidd stop

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

   Рекомендуем выполнить то же действие для всех IP-адресов обработчиков сообщений. Например, чтобы с помощью IPTables ОТКЛОНИТЬ запросы, поступающие от IP-адресов обработчика сообщений к узлу Qpid на порту 5672, можно использовать следующую команду:

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

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

Подробнее об установке нового интерфейса Edge…

Как обновить интерфейс Edge

Чтобы обновить компонент Edge UI, учитывайте версию 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.

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

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

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

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

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

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

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

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

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

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

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

4. Отключите SELinux, как описано в разделе Установка утилиты apigee-setup Edge.
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: Cassandra
        • edge: все компоненты Edge, кроме интерфейса Edge: сервер управления, процессор сообщений, маршрутизатор, сервер QPID, сервер Postgres
        • ldap: OpenLDAP
        • ps: postgresql
        • qpid: qpidd
        • sso: Apigee SSO (если вы установили SSO)
        • ue: новый интерфейс Edge
        • ui – классический интерфейс Edge;
        • zk: смотритель зоопарка
      • configFile – это тот же файл конфигурации, который вы использовали для определения компонентов Edge во время установки версии 4.50.00 или 4.51.00.

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

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

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

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

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

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

Как обновить версию до 4.52.01 из локального репозитория

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

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

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

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

1. Создайте локальный репозиторий 4.52.01, как описано в разделе "Создание локального репозитория Apigee" статьи Установка утилиты apigee-setup Edge.
2. Чтобы установить apigee-service из файла .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

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

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

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

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

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

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

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

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

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

Порядок обновления машин в установке Edge имеет важное значение:

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

Отдельное обновление с одним узлом

Чтобы обновить конфигурацию с одним узлом до версии 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

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

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

Список топологий 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

Обновление с пятью узлами

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

Список топологий 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

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

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

Список топологий 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. Обновите Cassandra и ZooKeeper:
   1. На машинах 1, 2 и 3 в центре обработки данных 1:

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

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

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

2. Обновите Postgres:
   1. Машина 6 в центре обработки данных 1

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

   2. Машина 12 в центре обработки данных 2

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

3. Обновление LDAP:
   1. Машина 1 в центре обработки данных 1

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

   2. Машина 7 в центре обработки данных 2

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

4. Как обновить компоненты Edge:
   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, обновите ее:
   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 (edge-management-ui) или классический интерфейс Edge (edge-ui) на компьютерах 1 и 7:

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

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

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

1. ZooKeeper
2. Cassandra
3. ps
4. LDAP
5. Edge – профиль "-c edge" на всех узлах в следующем порядке: узлы с сервером Qpid, сервером Edge Postgres, сервером управления, Message Processor и маршрутизатором.
6. qpidd
7. Интерфейс Edge (классический или новый)
8. apigee-adminapi
9. Apigee SSO

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