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

В этом разделе рассказывается, как перейти с Apigee Edge 4.19.06 или 4.50.00 на версию 4.51.00.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Эта процедура позволяет создать резервный сервер Postgres на новом узле. Убедитесь, что вы устанавливаете новый резервный сервер Postgres для существующей версии Edge (4.19.06 или 4.50.00), а не для версии 4.51.00.

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

Чтобы создать новый резервный узел Postgres:

  1. На текущем основном сервере Postgres измените файл /opt/apigee/customer/application/postgresql.properties, чтобы задать следующий токен. Если такого файла нет, создайте его:
    conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust

    где existing_standby_ip – IP-адрес текущего резервного сервера Postgres, а new_standby_ip – IP-адрес нового резервного узла.

  2. Перезапустите apigee-postgresql на основном сервере Postgres:
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  3. Убедитесь, что новый резервный узел добавлен, просмотрев файл /opt/apigee/apigee-postgresql/conf/pg_hba.conf на основном узле. В этом файле должны быть следующие строки:
    host replication apigee existing_standby_ip/32 trust
    host replication apigee new_standby_ip/32 trust
  4. Установите новый резервный сервер Postgres:
    1. Измените файл конфигурации, который вы использовали для установки текущей версии Edge, чтобы указать следующее:
      # IP address of the current master:
      PG_MASTER=192.168.56.103
      # IP address of the new standby node
      PG_STANDBY=192.168.56.102
    2. Отключите SELinux, как описано в разделе Установка утилиты Edge apigee-setup.
    3. Выполните одно из следующих действий в зависимости от того, с какой версии Edge вы переходите:
      • Если вы обновляете версию Edge 4.19.06, скачайте файл bootstrap_4.19.06.sh в каталог /tmp/bootstrap_4.19.06.sh :
        curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh

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

        sudo bash /tmp/bootstrap_4.19.06.sh apigeeuser=uName apigeepassword=pWord
      • Если вы обновляете версию 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

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

        sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord
    4. Чтобы установить утилиту apigee-setup, используйте apigee-service:
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    5. Установите Postgres:
      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    6. На новом резервном узле выполните следующую команду:
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

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

Как выполнить обновление Postgres на месте

Чтобы выполнить обновление до версии Postgres 10.17, сделайте следующее:

  1. Как обновить postgres на главном хосте
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
  2. Выполните команду установки на главном хосте:
    apigee-service apigee-postgresql setup -f /opt/silent.conf
  3. Выполните команду configure на главном хосте:
    apigee-service apigee-postgresql configure
  4. Перезапустите основной хост:
    apigee-service apigee-postgresql restart
  5. Настройте его как основной:
    apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf
  6. Убедитесь, что основной организатор начал игру:
    apigee-service apigee-postgresql wait_for_ready
  7. Чтобы остановить режим ожидания:
    apigee-service apigee-postgresql stop
  8. Обновите резервный сервер.

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

    /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
  9. Убедитесь, что режим ожидания отключен:
    apigee-service apigee-postgresql stop
  10. Удалите старую конфигурацию резервного сервера:
    rm -rf /opt/apigee/data/apigee-postgresql/
  11. Настройте репликацию на резервном сервере:
    apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf

После этого режим ожидания запустится успешно.

Как вывести из эксплуатации узел Postgres

После завершения обновления отключите новый резервный узел:

  1. Убедитесь, что Postgres работает:
    /opt/apigee/apigee-service/bin/apigee-all status

    Если Postgres не запущен, запустите его:

    /opt/apigee/apigee-service/bin/apigee-all start
  2. Получите UUID нового резервного узла, выполнив следующую команду curl на новом резервном узле:
    curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self

    В конце выходных данных должен быть указан UUID узла в следующем формате:

    "type" : [ "postgres-server" ],
    "uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
  3. Остановите новый резервный узел, выполнив на нем следующую команду:
    /opt/apigee/apigee-service/bin/apigee-all stop
  4. На основном узле Postgres измените файл /opt/apigee/customer/application/postgresql.properties, чтобы удалить новый резервный узел из conf_pg_hba_replication.connection:
    conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust
  5. Перезапустите apigee-postgresql на основном сервере Postgres:
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  6. Убедитесь, что новый резервный узел удален, просмотрев файл /opt/apigee/apigee-postgresql/conf/pg_hba.conf на основном узле. В этом файле должна быть только следующая строка:
    host replication apigee existing_standby_ip/32 trust
  7. Удалите UUID резервного узла из ZooKeeper, выполнив следующий вызов Edge Management API на узле сервера управления:
    curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid

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

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

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

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

  • Убедитесь, что Edge работает
    Убедитесь, что Edge работает во время процесса обновления, используя следующую команду:
    /opt/apigee/apigee-service/bin/apigee-all status

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

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

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

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

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

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

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

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

Как обновить Apigee mTLS

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

Как отменить обновление

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

Если из-за сбоя вам нужно выполнить откат к предыдущей версии, следуйте инструкциям в разделе Как выполнить откат к версии 4.51.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. Продолжите обновление на остальных компьютерах.

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

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

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

Как обновить до версии 4.51.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.51.00 bootstrap_4.51.00.sh в папку: /tmp/bootstrap_4.51.00.sh
    curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
  8. Установите утилиту Edge 4.51.00 apigee-service и зависимости, выполнив следующую команду:
    sudo bash /tmp/bootstrap_4.51.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-service, чтобы обновить утилиту apigee-setup, как показано в следующем примере:
    /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: сервер управления, процессор сообщений, маршрутизатор, сервер QPID, сервер Postgres
      • ldap: OpenLDAP
      • ps: postgresql
      • qpid: qpidd
      • sso: Apigee SSO (если вы установили SSO)
      • ue: новый интерфейс Edge
      • ui – классический интерфейс Edge;
      • zk: смотритель зоопарка
    • configFile – это тот же файл конфигурации, который вы использовали для определения компонентов Edge во время установки версии 4.19.06 или 4.50.00.

    Вы можете запустить 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.51.00.

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

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

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

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

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

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

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

    4. Установите утилиту Edge apigee-service и зависимости из /tmp/repos:
      sudo bash /tmp/repos/bootstrap_4.51.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

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

  3. Чтобы установить apigee-service с помощью веб-сервера NGINX:
    1. Настройте веб-сервер NGINX, как описано в разделе "Установка из репозитория с помощью веб-сервера NGINX" статьи Установка утилиты apigee-setup Edge.
    2. На удаленном узле скачайте файл Edge bootstrap_4.51.00.sh в каталог /tmp/bootstrap_4.51.00.sh:
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh

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

    3. На удаленном узле установите утилиту Edge apigee-setup и зависимости:
      sudo bash /tmp/bootstrap_4.51.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: сервер управления, процессор сообщений, маршрутизатор, сервер QPID, сервер Postgres.
      • ldap: OpenLDAP
      • ps: postgresql
      • qpid: qpidd
      • sso: Apigee SSO (если вы установили SSO)
      • ue Новый интерфейс Edge
      • ui – классический интерфейс Edge;
      • zk: смотритель зоопарка
    • configFile – это тот же файл конфигурации, который вы использовали для определения компонентов Edge во время установки версии 4.19.06 или 4.50.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.51.00.

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

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

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

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

Чтобы обновить конфигурацию с одним узлом до версии 4.51.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. Как обновить интерфейс Edge:
    • Классический интерфейс. Если вы используете классический интерфейс, обновите компонент ui на компьютере 1, как показано в следующем примере:
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    • Новый интерфейс Edge. Если вы установили новый интерфейс Edge, обновите компонент ue на подходящем компьютере (это может быть не компьютер 1):
      /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
  7. (Если вы установили apigee-adminapi) Обновлена утилита apigee-adminapi на компьютере 1:
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. Если вы установили Apigee SSO, обновите Apigee SSO на компьютере 1:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  9. Перезапустите компонент интерфейса:
    • Классический интерфейс. Если вы используете классический интерфейс, перезапустите компонент edge-ui на компьютере 1, как показано в следующем примере:
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • Новый интерфейс Edge. Если вы установили новый интерфейс Edge, перезапустите компонент edge-management-ui на подходящем компьютере (это может быть не компьютер 1):
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

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

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

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

  1. Обновите Cassandra и ZooKeeper на машинах 1, 2 и 3:
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Обновите Qpid на машинах 6 и 7:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. Обновите Postgres на компьютере 8:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Обновите Postgres на компьютере 9:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. Обновите LDAP на компьютере 1:
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Обновите компоненты Edge на машинах 6, 7, 8, 9, 1, 4 и 5 в указанном порядке:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Обновите новый (ue) или классический (ui) интерфейс на компьютере 1:
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  8. Если вы установили утилиту apigee-adminapi, обновите ее apigee-adminapi на компьютере 1:
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. Если вы установили Apigee SSO, обновите Apigee SSO на компьютере 1:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  10. Перезапустите компонент интерфейса:
    • Классический интерфейс. Если вы используете классический интерфейс, перезапустите компонент edge-ui на компьютере 1, как показано в следующем примере:
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • Новый интерфейс Edge. Если вы установили новый интерфейс Edge, перезапустите компонент edge-management-ui на подходящем компьютере (это может быть не компьютер 1):
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

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

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

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

  1. Обновите Cassandra и ZooKeeper на машинах 1, 2 и 3:
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Обновите Qpid на компьютерах 12 и 13:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. Обновите Postgres на компьютере 8:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Обновите Postgres на компьютере 9:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. Обновите LDAP на машинах 4 и 5:
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Обновите компоненты Edge на машинах 12, 13, 8, 9, 6, 7, 10 и 11 в указанном порядке:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Обновите новый (ue) или классический (ui) интерфейс на компьютерах 6 и 7:
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  8. (Если вы установили apigee-adminapi.) Обновите утилиту apigee-adminapi на компьютерах 6 и 7:
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. Если вы установили Apigee SSO, обновите Apigee SSO на машинах 6 и 7:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  10. Перезапустите компонент интерфейса:
    • Классический интерфейс. Если вы используете классический интерфейс, перезапустите компонент edge-ui на машинах 6 и 7, как показано в следующем примере:
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • Новый интерфейс Edge. Если вы установили новый интерфейс Edge, перезапустите компонент edge-management-ui на машинах 6 и 7:
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

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

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

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

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

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