Обновите Apigee Edge 4.17.05 или 4.17.09 до 4.18.05.

Edge для частного облака v4.18.05

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

  • С 17.04.05 по 18.04.05
  • С 17.04.09 по 18.04.05

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

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

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

Какие компоненты необходимо обновить

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

Поддерживать совместимость

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

Свойство Расположение Описание
conf_load_balancing_load.balancing.
driver.nginx.server.retry		 router.properties Удалите это свойство из файла router.properties . Чтобы установить параметры повтора в 4.18.05, используйте свойства конфигурации виртуального хоста .

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

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

Требуется добавление параметра конфигурации SMTPMAILFROM.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    Где existing_slave_ip — это IP-адрес текущего резервного сервера Postgres, а new_slave_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_slave_ip/32 trust
host replication apigee new_slave_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 bootstrap_4.17.0 x .sh, где x равно 5 (для 4.17.05) или 9 (для 4.17.09), в /tmp/bootstrap_4.17.0 x .sh : 
      curl https://software.apigee.com/bootstrap_4.17.0x.sh -o /tmp/bootstrap_4.17.0x.sh
    4. Установите утилиту Edge apigee-service и зависимости: 
      sudo bash /tmp/bootstrap_4.17.0x.sh apigeeuser=uName apigeepassword=pWord
    5. Используйте apigee-service для установки утилиты apigee-setup : 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    6. Установите Постгрес: 
      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    7. На новом резервном узле выполните следующую команду: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

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

Вывод из эксплуатации узла 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_slave_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_slave_ip/32 trust
  7. Удалите UUID резервного узла из ZooKeeper, выполнив следующий вызов API управления Edge на узле сервера управления: 
    curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_slave_uuid

Обновить необходимые условия

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

  • Резервное копирование всех узлов
    Перед обновлением рекомендуется выполнить полное резервное копирование всех узлов в целях безопасности. Используйте процедуру для вашей текущей версии Edge для выполнения резервного копирования.

    Это позволяет вам иметь запасной план на случай, если обновление до новой версии не будет работать должным образом. Дополнительную информацию о резервном копировании см. в разделе Резервное копирование и восстановление .

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

Обработка неудачного обновления

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

Если сбой требует отката обновления до предыдущей версии, дополнительные сведения см. в разделе Откат 4.18.05 .

Регистрация информации об обновлении

По умолчанию утилита update.sh записывает информацию журнала в:

/opt/apigee/var/log/apigee-setup/update.log

Если пользователь, запускающий утилиту update.sh не имеет доступа к этому каталогу, он записывает журнал в каталог /tmp в виде файла с именем update_username.log .

Если у пользователя нет доступа к /tmp , утилита update.sh завершится сбоем.

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

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

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

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

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

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

  • На объединенном узле маршрутизатора и процессора сообщений:
    • Перед обновлением выполните следующее:
      1. Сделайте маршрутизатор недоступным.
      2. Сделайте процессор сообщений недоступным.
    • После обновления - выполните следующее:
      1. Сделайте процессор сообщений доступным.
      2. Сделайте маршрутизатор доступным.
  • На одном узле маршрутизатора:
    • Перед обновлением сделайте роутер недоступным.
    • После обновления сделайте маршрутизатор доступным.
  • На одном узле процессора сообщений:
    • Перед обновлением сделайте процессор сообщений недоступным.
    • После обновления сделайте процессор сообщений доступным.

Использование тихого файла конфигурации

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

Обновление до 4.18.05 на узле с внешним подключением к Интернету

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

  1. Если вы в настоящее время используете репликацию главный-резервный Postgres с локальным хранилищем, установите новый резервный узел Postgres, как описано в разделе Установка нового резервного узла Postgres .

    Если вы используете сетевое хранилище, вам не нужно устанавливать новый узел. Вместо этого сделайте сетевой снимок хранилища данных, используемого Postgres. Дополнительную информацию см. в разделе «Необходимое обновление до Postgres 9.6» .

  2. Если они есть, отключите все задания CRON, настроенные для выполнения операции восстановления в Cassandra, до завершения обновления.
  3. Войдите на свой узел как root, чтобы установить Edge RPM.
  4. Установите yum-utils и yum-plugin-priorities : 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  5. Отключите SELinux, как описано в разделе Установка утилиты Edge apigee-setup .
  6. Если вы устанавливаете Oracle 7.x , выполните следующую команду: 
    sudo yum-config-manager --enable ol7_optional_latest
  7. Если вы выполняете установку на 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
  8. Загрузите файл Edge 4.18.05 bootstrap_4.18.05.sh в /tmp/bootstrap_4.18.05.sh : 
    curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
  9. Установите утилиту apigee-service Edge 4.18.05 и зависимости: 
    sudo bash /tmp/bootstrap_4.18.05.sh apigeeuser=uName apigeepassword=pWord

    Где uName:pWord — имя пользователя и пароль, которые вы получили от Apigee. Если вы опустите pWord , вам будет предложено ввести его.

    По умолчанию программа установки проверяет, установлена ​​ли у вас Java 1.8. Если вы этого не сделаете, он установит его за вас. Используйте опцию JAVA_FIX , чтобы указать, как обрабатывать установку Java. JAVA_FIX принимает следующие значения:

    • I = установить OpenJDK 1.8 (по умолчанию)
    • C = Продолжить без установки Java
    • Вопрос = Выйти. Для этого варианта вам придется установить Java самостоятельно.
  10. Используйте apigee-service для обновления утилиты apigee-setup : 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  11. Обновите утилиту apigee-validate на сервере управления: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  12. Обновите утилиту apigee-provision : 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  13. Запустите утилиту обновления на своих узлах в порядке, описанном в разделе «Порядок обновления компьютера» : 
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    Единственное требование к файлу конфигурации — файл конфигурации должен быть доступен или доступен для чтения пользователю «apigee».

    Используйте опцию -c , чтобы указать компонент для обновления. В список возможных компонентов входят:

    • "cs" = Кассандра
    • "е" = ЭластичныйПоиск
    • «edge» = Все компоненты Edge, кроме пользовательского интерфейса Edge. «Периферийный» компонент включает в себя сервер управления, процессор сообщений, маршрутизатор, сервер QPID, пограничный сервер Postgres.
    • "ldap" = OpenLDAP
    • "пс" = постгреск
    • "qpid" = qpidd
    • «sso» = Edge SSO
    • «ui» = пограничный интерфейс
    • "zk" = смотритель зоопарка

    Вы можете запустить update.sh для всех компонентов, задав для component значение «все», но только если у вас есть профиль установки Edge «все в одном» (aio). Например:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
  14. Перезапустите компонент пользовательского интерфейса Edge на всех компьютерах, на которых он запущен, если вы еще этого не сделали: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  15. Проверьте обновление, запустив утилиту apigee-validate на сервере управления, как описано в разделе «Проверка установки» .
  16. Если вы установили новый резервный узел Postgres, выведите его из эксплуатации, как описано в разделе Вывод из эксплуатации узла Postgres .

    Если вы используете сетевое хранилище, вам не нужно устанавливать новый узел. Дополнительную информацию см. в разделе «Необходимое обновление до Postgres 9.6» .

Чтобы позднее выполнить откат обновления, используйте процедуру, описанную в разделе «Откат 4.18.05» .

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

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

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

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

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

  1. Если вы в настоящее время используете репликацию главный-резервный Postgres, установите новый резервный узел Postgres, как описано в разделе Установка нового резервного узла Postgres .

    Если вы используете сетевое хранилище, вам не нужно устанавливать новый узел. Вместо этого сделайте сетевой снимок хранилища данных, используемого Postgres. Дополнительную информацию см. в разделе «Необходимое обновление до Postgres 9.6» .

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

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

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

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

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

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

    3. На удаленном узле установите утилиту Edge apigee-service и зависимости: 
      sudo bash /tmp/bootstrap_4.18.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      Где uName:pWord — имя пользователя и пароль репозитория.

  5. Используйте apigee-service для обновления утилиты apigee-setup : 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  6. Обновите утилиту apigee-validate на сервере управления: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  7. Обновите утилиту apigee-provision : 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  8. Запустите утилиту update на своих узлах в порядке, описанном в разделе «Порядок обновления компьютера» : 
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    Единственное требование к файлу конфигурации — файл конфигурации должен быть доступен или доступен для чтения пользователю «apigee».

    Используйте опцию -c , чтобы указать компонент для обновления. В список возможных компонентов входят:

    • "cs" = Кассандра
    • "е" = ЭластичныйПоиск
    • «edge» = Все компоненты Edge, кроме пользовательского интерфейса Edge. «Периферийный» компонент включает в себя сервер управления, процессор сообщений, маршрутизатор, сервер QPID, пограничный сервер Postgres.
    • "ldap" = OpenLDAP
    • "пс" = постгреск
    • "qpid" = qpidd
    • «sso» = Edge SSO
    • «ui» = пограничный интерфейс
    • "zk" = смотритель зоопарка

    Вы можете запустить update.sh для всех компонентов, задав для component значение «все», но только если у вас есть профиль установки Edge «все в одном» (aio). Например:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
  9. Перезапустите компонент пользовательского интерфейса Edge на всех компьютерах, на которых он работает, если вы еще этого не сделали: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  10. Проверьте обновление, запустив утилиту apigee-validate на сервере управления, как описано в разделе «Проверка установки» .
  11. Если вы установили новый резервный узел Postgres, выведите его из эксплуатации, как описано в разделе Вывод из эксплуатации узла Postgres .

    Если вы используете сетевое хранилище, вам не нужно устанавливать новый узел. Дополнительную информацию см. в разделе «Необходимое обновление до Postgres 9.6» .

Чтобы позже выполнить откат обновления, используйте процедуру, описанную в разделе «Откат 4.18.05» .

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

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

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

Автономная установка на 1 узел

  1. Обновление Кассандры и ZooKeeper: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Обновить Qpid: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. Обновить LDAP: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. Остановите сервер Postgres, сервер Qpid и PostgreSQL: 
    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
  5. Обновить постгреск: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  6. Обновите базу данных Postgres: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
  7. Обновите оставшиеся компоненты Edge: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. Обновите пользовательский интерфейс Edge: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  9. (Если вы установили Edge SSO) Обновите Edge SSO: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  10. Перезапустите компонент пользовательского интерфейса Edge: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

2-узловая автономная установка

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

  1. Обновите Cassandra и ZooKeeper на машине 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Обновите Qpid на машине 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. Обновите LDAP на машине 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. Обновите компоненты Edge на компьютере 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. (Если вы установили Edge SSO) Обновите Edge SSO на компьютере 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  7. Обновите postgresql на машине 2:
    1. Остановите сервер Postgres, сервер Qpid и postgresql:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    2. Обновить постгреск: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    3. Обновите базу данных Postgres: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    4. Обновите компоненты Edge на машине 2: 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. Перезапустите компонент Edge UI на компьютере 1: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

5-узловая установка

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

  1. Убедитесь, что вы установили новый резервный узел Postgres, как описано в разделе Установка нового резервного узла Postgres .

    Если вы используете сетевое хранилище, вам не нужно устанавливать новый узел. Вместо этого сделайте сетевой снимок хранилища данных, используемого Postgres. Дополнительную информацию см. в разделе «Необходимое обновление до Postgres 9.6» .

  2. Обновите Cassandra и ZooKeeper на машинах 1, 2 и 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Обновите Qpid на машинах 4 и 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. Обновите LDAP на машине 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Обновите компоненты Edge на компьютере 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. (Если вы установили Edge SSO) Обновите Edge SSO на компьютере 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  8. Обновите машины 4 и 5:
    1. Остановите сервер Postgres и сервер Qpid на машине 4:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    2. Остановите сервер Postgres, сервер Qpid и postgresql на машине 5: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Если они установлены , остановите сервер Postgres и postgresql на новом резервном узле, который вы добавили для отката: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    4. Обновите postgresql на машинах 4: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    5. Обновите базу данных Postgres на компьютере 4 (только Postgres master): 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    6. Обновите postgresql на машинах 5: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    7. Запустите сервер Postgres и сервер Qpid на машинах 4 и 5: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    8. Настройте Postgres в качестве резервного узла, выполнив на машине 5 следующие команды: 
      cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    9. Проверьте состояние репликации, выполнив следующие сценарии на обоих серверах. Система должна отображать одинаковые результаты на обоих серверах, чтобы гарантировать успешную репликацию:
      • На машине 4, главном узле, запустите: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

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

      • На машине 5 резервный узел: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

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

  9. Обновите компоненты Edge на машинах 4, 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. Убедитесь, что вы вывели из эксплуатации новый резервный узел, как описано в разделе «Вывод из эксплуатации узла Postgres» .

    Если вы используете сетевое хранилище, вам не нужно устанавливать новый узел. Дополнительную информацию см. в разделе «Необходимое обновление до Postgres 9.6» .

  11. Перезапустите компонент Edge UI на компьютере 1: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Кластерная установка из 9 узлов

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

  1. Убедитесь, что вы установили новый резервный узел Postgres, как описано в разделе Установка нового резервного узла Postgres .

    Если вы используете сетевое хранилище, вам не нужно устанавливать новый узел. Вместо этого сделайте сетевой снимок хранилища данных, используемого Postgres. Дополнительную информацию см. в разделе «Необходимое обновление до Postgres 9.6» .

  2. Обновите Cassandra и ZooKeeper на машинах 1, 2 и 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Обновите Qpid на машинах 6 и 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. Обновите LDAP на машине 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Обновите компоненты Edge на машинах 6, 7, 1, 4 и 5 в следующем порядке: 
    /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. (Если вы установили Edge SSO) Обновите Edge SSO на компьютере 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  8. Обновите машины 8 и 9:
    1. Остановите сервер Postgres на машине 8: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. Остановите сервер Postgres и postgresql на машине 9: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Остановите сервер Qpid на машинах 6 и 7: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. Если они установлены , остановите сервер Postgres и postgresql на новом резервном узле, который вы добавили для отката: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. Обновите postgresql на машинах 8: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Обновите базу данных Postgres на компьютере 8 (только Postgres master): 
      /-->
opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. Обновите postgresql на машинах 9: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. Запустите сервер Postgres на машинах 8 и 9: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. Запустите сервер Qpid на машинах 6 и 7: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. Настройте Postgres в качестве резервного узла, выполнив на машине 9 следующие команды: 
      cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    11. Проверьте состояние репликации, выполнив следующие сценарии на обоих серверах. Система должна отображать одинаковые результаты на обоих серверах, чтобы гарантировать успешную репликацию:
      • На машине 8, главном узле, запустите: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

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

      • На машине 9 резервный узел: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

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

  9. Обновите компоненты Edge на машинах 8 и 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. Убедитесь, что вы вывели из эксплуатации новый резервный узел, как описано в разделе «Вывод из эксплуатации узла Postgres» .

    Если вы используете сетевое хранилище, вам не нужно устанавливать новый узел. Дополнительную информацию см. в разделе «Необходимое обновление до Postgres 9.6» .

  11. Перезапустите компонент Edge UI на компьютере 1: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Кластерная установка на 13 узлов

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

  1. Убедитесь, что вы установили новый резервный узел Postgres, как описано в разделе Установка нового резервного узла Postgres .

    Если вы используете сетевое хранилище, вам не нужно устанавливать новый узел. Вместо этого сделайте сетевой снимок хранилища данных, используемого Postgres. Дополнительную информацию см. в разделе «Необходимое обновление до Postgres 9.6» .

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

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

  8. Обновите машины 8 и 9:
    1. Остановите сервер Postgres на машине 8: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. Остановите сервер Postgres и postgresql на машине 9: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Остановите сервер Qpid на машинах 12 и 13: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. Если они установлены , остановите сервер Postgres и postgresql на новом резервном узле, который вы добавили для отката: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. Обновите postgresql на машинах 8: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Обновите базу данных Postgres на компьютере 8 (только Postgres master): 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. Обновите postgresql на машинах 9: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. Запустите сервер Postgres на машинах 8 и 9: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. Запустите сервер Qpid на машинах 12 и 13: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. Настройте Postgres в качестве резервного узла, выполнив на машине 9 следующие команды: 
      cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    11. Проверьте состояние репликации, выполнив следующие сценарии на обоих серверах. Система должна отображать одинаковые результаты на обоих серверах, чтобы гарантировать успешную репликацию:
      • На машине 8, главном узле, запустите: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

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

      • На машине 9 резервный узел: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

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

  9. Обновите компоненты Edge на машинах 8 и 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. Убедитесь, что вы вывели из эксплуатации новый резервный узел, как описано в разделе «Вывод из эксплуатации узла Postgres» .

    Если вы используете сетевое хранилище, вам не нужно устанавливать новый узел. Дополнительную информацию см. в разделе «Необходимое обновление до Postgres 9.6» .

  11. Перезапустите компонент Edge UI на компьютерах 6 и 7: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Кластерная установка на 12 узлов

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

  1. Убедитесь, что вы установили новый резервный узел Postgres, как описано в разделе Установка нового резервного узла Postgres .

    Если вы используете сетевое хранилище, вам не нужно устанавливать новый узел. Вместо этого сделайте сетевой снимок хранилища данных, используемого Postgres. Дополнительную информацию см. в разделе «Необходимое обновление до Postgres 9.6» .

  2. Обновление Кассандры и 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
  3. Обновить qpidd:
    1. Машины 4, 5 в дата-центре 1
      1. Обновите qpidd на машине 4: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Повторите шаг 1 на машине 5.
    2. Машины 10, 11 в ЦОД 2
      1. Обновите qpidd на машине 10: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Повторите шаг 1 на машине 11.
  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, 1, 2, 3 в дата-центре 1 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. Машины 10, 11, 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
  7. (Если вы установили Edge SSO) Обновите Edge 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 .

  8. Обновите компьютер 6 в центре обработки данных 1 и компьютер 12 в центре обработки данных 2:
    1. Остановите сервер Postgres на машине 6: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. Остановите сервер Postgres и postgresql на машине 12: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Остановите сервер Qpid на машинах 4, 5, 10 и 11: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. Если они установлены , остановите сервер Postgres и postgresql на новом резервном узле, который вы добавили для отката: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. Обновите postgresql на машинах 6: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Обновите базу данных Postgres на компьютере 6 (только Postgres master): 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. Обновите postgresql на машинах 12: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. Запустите сервер Postgres на машинах 6 и 12: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. Запустите сервер Qpid на машинах 4, 5, 10 и 11: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. Настройте Postgres в качестве резервного узла, выполнив следующие команды на машине 12: 
      cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    11. Проверьте состояние репликации, выполнив следующие сценарии на обоих серверах. Система должна отображать одинаковые результаты на обоих серверах, чтобы гарантировать успешную репликацию:

      На машине 6, главном узле, запустите:

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

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

      На машине 12 резервный узел:

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

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

  9. Обновите компоненты Edge на машинах 6 и 12: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. Убедитесь, что вы вывели из эксплуатации новый резервный узел, как описано в разделе «Вывод из эксплуатации узла Postgres» .

    Если вы используете сетевое хранилище, вам не нужно устанавливать новый узел. Дополнительную информацию см. в разделе «Необходимое обновление до Postgres 9.6» .

  11. Перезапустите компонент Edge UI на компьютерах 1 и 7: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Для нестандартной установки

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

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

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