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

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

• С 4:18:05 до 4:51:00

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

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

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

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

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

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

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

Требования к обновлению

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

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

  Это позволит вам иметь запасной план на случай, если обновление до новой версии не будет работать должным образом. Подробнее о резервном копировании и восстановлении…

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

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

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

В этом разделе перечислены особенности нового интерфейса Edge.

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

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

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

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

Если вы установили бета-версию интерфейса Edge (ранее известную как новый интерфейс Edge или UE) в версии 4.18.05, вам необходимо удалить ее и выполнить чистую установку версии 4.19.01, 4.19.06 или 4.50.00 интерфейса Edge. Подробнее о новом интерфейсе Edge для частного облака…

Как устранить неполадки с обновлением

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

Если сбой требует отката обновления до предыдущей версии, ознакомьтесь с разделом Откат версии 4.50.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:
  • Перед обновлением сделайте Message Processor недоступным.
  • После обновления сделайте Message Processor доступным.

С помощью файла конфигурации в фоновом режиме

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

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

Чтобы обновить компоненты 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.50.00 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

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

   sudo bash /tmp/bootstrap_4.50.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 самостоятельно.
9. Чтобы обновить утилиту apigee-setup, используйте apigee-service:

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

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

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

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

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

12. Запустите утилиту update на узлах в порядке, описанном в разделе Порядок обновления машин:

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

    где component – компонент Edge, который нужно обновить. Возможные значения:

    • "cs": Cassandra
    • edge": все компоненты Edge, кроме интерфейса Edge: сервер управления, Message Processor, маршрутизатор, сервер QPID, сервер Postgres.
    • "ldap": OpenLDAP
    • "ps": postgresql
    • "qpid": qpidd
    • "sso": Apigee SSO (если вы установили SSO).
    • "ui": Edge UI
    • "zk": Zookeeper

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

      tar -xzf apigee-4.50.00.tar.gz

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

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

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

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

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

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

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

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

      sudo bash /tmp/bootstrap_4.50.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": Cassandra
     • edge – все компоненты Edge, кроме Edge UI; Компонент Edge включает сервер управления, обработчик сообщений, маршрутизатор, сервер QPID и сервер Edge Postgres.
     • "ldap": OpenLDAP
     • "ps": postgresql
     • "qpid": qpidd
     • "sso": Apigee SSO (если вы установили SSO).
     • "ui": Edge UI
     • "zk": Zookeeper
   • configFile – это тот же файл конфигурации, который вы использовали для определения компонентов Edge во время установки версии 4.18.05.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1. Обновите 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

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

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

Список топологий 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. Обновите интерфейс на компьютере 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. Обновите 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. Обновите интерфейс на компьютере 1:

   /opt/apigee/apigee-setup/bin/update.sh -c ui -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

Обновление кластера из 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. Обновите интерфейс на компьютерах 6 и 7:

   /opt/apigee/apigee-setup/bin/update.sh -c ui -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

Обновление кластера из 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. Обновление 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. Обновите 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

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. Обновление интерфейса:
   1. Машина 1 в центре обработки данных 1:

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

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

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

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

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

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.

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

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

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

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