Как обновить 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, настроенных для репликации master-standby. Во время обновления, когда узлы Postgres отключены, данные аналитики по-прежнему записываются на узлы Qpid. После того как узлы Postgres будут обновлены и снова подключены к сети, данные аналитики будут переданы на узлы 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, как описано в разделе Установка утилиты apigee-setup для Edge.
    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-service, чтобы установить утилиту apigee-setup:
      /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. Выполните команду настройки на главном хосте:
    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 для Private Cloud.

Установка Edge UI

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

Обратите внимание, что для Edge UI необходимо отключить базовую аутентификацию и использовать 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 без отключения.

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

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

  1. Обновите компьютеры в правильном порядке, как описано в разделе Порядок обновления компьютеров.
  2. Когда придет время обновить маршрутизаторы, выберите один из них и сделайте его недоступным, как описано в разделе Включение/отключение доступности сервера (Message Processor/Router).
  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, чтобы установить Edge RPM.
  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: Кассандра
      • edge – все компоненты Edge, кроме Edge UI: Management Server, Message Processor, Router, QPID Server, Postgres Server.
      • 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 "все в одном" (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: Кассандра
      • edge: все компоненты Edge, кроме Edge UI: Management Server, Message Processor, Router, QPID Server, Postgres Server.
      • 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 "все в одном" (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 (Management Server, Message Processor, Router, QPID Server, но не Postgres Server) используйте параметр -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

Обновление до 5 узлов

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

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

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

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

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

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

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

Список топологий 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) Обновите 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-management-ui) или классического (edge-ui) интерфейса Edge на компьютерах 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 Server, Management Server, Message Processor и Router.
  6. Edge UI (классический или новый)
  7. apigee-adminapi
  8. Система единого входа Apigee

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