Обновите Apigee Edge до версии 4.16.09.

Edge для частного облака v. 4.16.09

Какие версии Edge можно обновить до 4.16.09?

Вы можете обновить Apigee Edge версий 4.16.01.0x и 4.16.05.x до 4.16.09.

Если у вас установлена ​​версия Edge до версии 4.16.01, вам необходимо сначала перейти на версию 4.16.01.x, а затем обновиться до версии 4.16.09.

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

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

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

Требуется обновление до Java JDK версии 8.

Для этого выпуска Edge требуется, чтобы вы установили Java JDK версии 8 на всех узлах обработки Edge. Вы можете установить Oracle JDK 8 или OpenJDK 8. Если Java JDK 8 еще не установлен, сценарий обновления может установить его за вас.

В рамках обновления Java 8 некоторые шифры TLS больше не доступны в Oracle JDK 8. Полный список см. в разделе «Наборы шифров, отключенных по умолчанию» по адресу http://docs.oracle.com/javase/8/ . docs/technotes/guides/security/SunProviders.html .

Понижение версии Zookeeper при обновлении с версии 4.16.01.

Версия RPM Zookeeper в Edge для частного облака 4.16.01 — apigee-zookeeper-3.4.5-1.0.905.noarch.rpm . В последующих версиях Edge версия Zookeeper была изменена обратно на apigee-zookeeper-3.4.5-0.0.94x . Это не позволяет yum обновить Zookeeper до более поздних версий, начиная с 4.16.01. Чтобы исправить эту ситуацию, перед обновлением Zookeeper запустите yum downgrade apigee-zookeeper .

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

> rpm -qa |grep apigee-zookeeper

Если эта команда возвращает версию Zookeeper:

apigee-zookeeper-3.4.5-1.0.905

Тогда вам необходимо выполнить понижение версии.

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

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

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

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

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

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

    > /<inst_root>/apigee/apigee-service/bin/apigee-all status

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

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

Если сбой требует отката обновления до предыдущей версии, дополнительные сведения см. в разделе 4.16.09 «Процесс отката» .

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

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

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

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

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

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

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

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

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

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

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

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

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

  1. На текущем главном сервере Postgres отредактируйте файл /opt/apigee/customer/application/postgresql.properties , чтобы установить следующий токен. Если этот файл не существует, создайте его:

    conf_pg_hba_replication.connection=apigee репликации хоста существующий_slave_ip /32 доверие\ \napigee репликации хоста new_slave_ip /32 доверие

    гдеexist_slave_ip — IP-адрес текущего резервного сервера Postgres, а new_slave_ip — IP-адрес нового резервного узла.
  2. Перезапустите apigee-postgresql на главном сервере Postgres:
    > /opt/apigee/apigee-service/bin/apigee-service перезапуск apigee-postgresql
  3. Убедитесь, что новый резервный узел был добавлен, просмотрев файл /opt/apigee/apigee-postgresql/conf/pg_hba.conf на главном сервере. В этом файле вы должны увидеть следующие строки:
    репликация хоста apigee существующий_slave_ip/32 доверие
    репликация хоста apigee new_slave_ip/32 доверие
  4. Установите новый резервный сервер Postgres:
    1. Отредактируйте файл конфигурации, который вы использовали для установки текущей версии Edge, указав следующее:

      # IP-адрес текущего мастера:
      PG_MASTER=192.168.56.103
      # IP-адрес нового резервного узла
      PG_STANDBY=192.168.56.102
    2. Отключите SELinux, как описано в разделе Установка утилиты Edge apigee-setup .
    3. Загрузите файл Edge bootstrap_4.16.05.sh в /tmp/bootstrap_4.16.05.sh :
      > завиток https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh

      Примечание . Если вы обновляетесь с версии 4.16.01, загрузите файл Edge bootstrap.sh .
    4. Установите утилиту Edge apigee-service и зависимости:
      > sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser= uName apigeepassword= pWord
    5. Используйте apigee-service для установки утилиты apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service установка установки apigee
    6. Установите Постгрес:
      > /opt/apigee/apigee-setup/bin/setup.sh -p ps -f файл конфигурации
    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:пароль http:// <node_IP> :8084/v1/servers/self

    В конце вывода вы должны увидеть UUID узла в форме:
    "тип" : ["postgres-сервер"],
    "uUID": "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
  3. Остановите новый резервный узел, выполнив на новом резервном узле следующую команду:
    > /opt/apigee/apigee-service/bin/apigee-all остановить
  4. На главном узле Postgres отредактируйте /opt/apigee/customer/application/postgresql.properties , чтобы удалить новый резервный узел из conf_pg_hba_replication.connection :
    conf_pg_hba_replication.connection=apigee репликации хоста существующий_slave_ip /32 доверие
  5. Перезапустите apigee-postgresql на главном сервере Postgres:
    > /opt/apigee/apigee-service/bin/apigee-service перезапуск apigee-postgresql
  6. Убедитесь, что новый резервный узел был удален, просмотрев файл /opt/apigee/apigee-postgresql/conf/pg_hba.conf на главном сервере. В этом файле вы должны увидеть только следующую строку:
    репликация хоста apigee существующий_slave_ip /32 доверие
  7. Удалите UUID резервного узла из ZooKeeper, выполнив следующий вызов API управления Edge на узле Management Server:
    > curl -u sysAdminEmail:пароль -X УДАЛИТЬ http:// <ms_IP> :8080/v1/servers/ <new_slave_uuid>

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

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

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

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

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

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

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

Использование файла конфигурации без вывода сообщений

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

Процедура обновления до 4.16.09 на узле с внешним подключением к Интернету

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

  1. Если вы в настоящее время используете репликацию главный-резервный Postgres, установите новый резервный узел Postgres, как описано выше в разделе Установка нового резервного узла Postgres .
  2. Если они присутствуют, отключите все задания CRON, настроенные для выполнения операции восстановления в Cassandra, до завершения обновления.
  3. Войдите на свой узел как root, чтобы установить Edge RPM.
    Примечание . Хотя для установки RPM требуется root-доступ, вы можете выполнить настройку Edge без root-доступа.
  4. Отключите SELinux, как описано в разделе Установка утилиты Edge apigee-setup .
  5. Загрузите файл Edge 4.16.09 bootstrap_4.16.09.sh в /tmp/bootstrap_4.16.09.sh :
    > завиток https://software.apigee.com/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh
  6. Установите утилиту apigee-service Edge 4.16.09 и зависимости:
    > sudo bash /tmp/bootstrap_4.16.09.sh apigeeuser= uName apigeepassword= pWord

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

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

    I = установить OpenJDK 1.8 (по умолчанию)
    C = Продолжить без установки Java
    Вопрос = Выйти. Для этого варианта вам придется установить Java самостоятельно.
  7. Используйте apigee-service для обновления утилиты apigee-setup:
    1. Если вы установили 4.16.01 путем обновления Edge до версии 4.15.07.0x, вам необходимо установить утилиту apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service установка установки apigee

      Эта команда устанавливает утилиту update.sh в <inst_dir>/apigee/apigee-setup/bin .

      Если вы уже установили утилиту apigee-setup , обновите ее:
      > /opt/apigee/apigee-service/bin/apigee-service обновление apigee-setup
    2. Если вы установили 4.16.01 напрямую, то есть не выполняли обновление с 4.15.07.0x, вам необходимо обновить утилиту apigee-setup :
      > /opt/apigee/apigee-service/bin/apigee-service обновление apigee-setup

      Это обновление apigee-service устанавливает утилиту update.sh в <inst_dir>/apigee/apigee-setup/bin .
    3. Если вы установили 4.16.05 напрямую или путем обновления, необходимо обновить утилиту apigee-setup :
      > /opt/apigee/apigee-service/bin/apigee-service обновление apigee-setup

      Это обновление apigee-service устанавливает утилиту update.sh в <inst_dir>/apigee/apigee-setup/bin .
  8. В зависимости от вашей текущей версии Edge вам необходимо либо установить, либо обновить утилиту apigee-validate на сервере управления.
    1. Если вы в настоящее время используете Edge 4.16.05 : обновите утилиту apigee-validate на сервере управления:
      > /opt/apigee/apigee-service/bin/apigee-service обновление apigee-validate
    2. Если вы в настоящее время используете Edge 4.16.01 : установите утилиту apigee-validate на сервере управления:
      > /opt/apigee/apigee-service/bin/apigee-service установка apigee-validate

      Примечание . Если при установке версии 4.16.01 вы установили утилиту apigee-validate на узле процессора сообщений, вы можете обновить ее, используя на этом узле следующую команду:
      > /opt/apigee/apigee-service/bin/apigee-service обновление apigee-validate

      Однако, начиная с версии 4.16.05 и более поздних версий, Apigee рекомендует установить и запустить утилиту apigee-validate на сервере управления.
    3. Если вы обновляетесь с версии 4.16.01 : отредактируйте файл конфигурации, переданный утилите apigee-validate . В выпуске Edge 4.16.01 файл конфигурации, используемый apigee-validate, требовал следующих свойств:
      APIGEE_ADMINPW=sysAdminPword
      MP_POD=шлюз
      РЕГИОН=DC-1


      В этом выпуске для файла конфигурации требуется только свойство APIGEE_ADMINPW . Вы можете удалить два других свойства из файла.
  9. Обновите утилиту apigee-provision :
    > /opt/apigee/apigee-service/bin/apigee-service обновление apigee-provision
  10. Запустите утилиту обновления на своих узлах в порядке, описанном ниже в разделе « Порядок обновления машины » ниже:
    > /opt/apigee/apigee-setup/bin/update.sh -c компонент -f файл конфигурации

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

    Используйте опцию «-c», чтобы указать компонент для обновления. В список возможных компонентов входят:
    ldap = OpenLDAP
    cs = Кассандра
    zk = Смотритель зоопарка
    qpid = qpidd
    пс = PostgreSQL
    Edge = все компоненты Edge, кроме пользовательского интерфейса Edge: сервер управления, процессор сообщений, маршрутизатор, сервер QPID, сервер Postgres.
    ui = Пограничный интерфейс
    all = обновить все компоненты на компьютере (используйте только для профиля установки Edge aio или профиля установки API BaaS asa)
    е = ЭластичныйПоиск
    b = стек API BaaS
    p = API BaaS-портала
    ebp = ElasticSearch, API BaaS Stack и API BaaS Portal на одном узле.
  11. Проверьте обновление, запустив утилиту apigee-validate на сервере управления, как описано в разделе «Проверка установки» .
  12. Если вы установили новый резервный узел Postgres, выведите его из эксплуатации, как описано выше в разделе «Вывод из эксплуатации узла Postgres» .

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

Процедура обновления до 4.16.09 из локального репозитория

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

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

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

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

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

      Эта команда создает новый каталог с именем repos в каталоге, содержащем файл .tar. Например /tmp/репозитории.
    4. Установите утилиту Edge apigee-service и зависимости из /tmp/repos:
      > sudo bash /tmp/repos/bootstrap_4.16.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

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

      где uName:pWord — это имя пользователя и пароль, которые вы установили выше для репозитория, а RemoteRepo — это IP-адрес или DNS-имя узла репо.
    3. На удаленном узле установите утилиту Edge apigee-service и зависимости:
      > sudo bash /tmp/bootstrap_4.16.09.sh apigeerepohost= RemoteRepo :3939 apigeeuser= uName apigeepassword= pWord apigeeprotocol=http://

      где uName:pWord — имя пользователя и пароль репозитория.
  5. Используйте apigee-service для обновления утилиты apigee-setup:
    1. Если вы установили 4.16.01 путем обновления Edge до версии 4.15.07.0x, вам необходимо установить утилиту apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service установка установки apigee

      Эта команда устанавливает утилиту update.sh в <inst_dir>/apigee/apigee-setup/bin .

      Если вы уже установили утилиту apigee-setup , обновите ее:
      > /opt/apigee/apigee-service/bin/apigee-service обновление apigee-setup
    2. Если вы установили 4.16.01 напрямую, то есть вы не выполняли обновление с 4.15.07.0x, вам необходимо обновить утилиту apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service обновление apigee-setup

      Это обновление apigee-service устанавливает утилиту update.sh в <inst_dir>/apigee/apigee-setup/bin .
    3. Если вы установили 4.16.05 напрямую или путем обновления, необходимо обновить утилиту apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service обновление apigee-setup

      Это обновление apigee-service устанавливает утилиту update.sh в <inst_dir>/apigee/apigee-setup/bin .
  6. В зависимости от вашей текущей версии Edge вам необходимо либо установить, либо обновить утилиту apigee-validate на сервере управления.
    1. Если вы в настоящее время используете Edge 4.16.05 : обновите утилиту apigee-validate на сервере управления:
      > /opt/apigee/apigee-service/bin/apigee-service обновление apigee-validate
    2. Если вы в настоящее время используете Edge 4.16.01 : установите утилиту apigee-validate на сервере управления:
      > /opt/apigee/apigee-service/bin/apigee-service установка apigee-validate

      Примечание . Если при установке версии 4.16.01 вы установили утилиту apigee-validate на узле процессора сообщений, вы можете обновить ее, используя на этом узле следующую команду:
      > /opt/apigee/apigee-service/bin/apigee-service обновление apigee-validate

      Однако, начиная с версии 4.16.05 и более поздних версий, Apigee рекомендует установить и запустить утилиту apigee-validate на сервере управления.
    3. Если вы обновляетесь с версии 4.16.01 : отредактируйте файл конфигурации, переданный утилите apigee-validate . В выпуске Edge 4.16.01 файл конфигурации, используемый apigee-validate, требовал следующих свойств:
      APIGEE_ADMINPW=sysAdminPword
      MP_POD=шлюз
      РЕГИОН=DC-1


      В этом выпуске для файла конфигурации требуется только свойство APIGEE_ADMINPW . Вы можете удалить два других свойства из файла.
  7. Обновите утилиту apigee-provision :
    > /opt/apigee/apigee-service/bin/apigee-service обновление apigee-provision
  8. Запустите утилиту обновления на своих узлах в порядке, описанном ниже в разделе «Порядок обновления машины» ниже:
    > /opt/apigee/apigee-setup/bin/update.sh -c компонент -f файл конфигурации

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

    Используйте опцию «-c», чтобы указать компонент для обновления. В список возможных компонентов входят:
    ldap = OpenLDAP
    cs = Кассандра
    zk = Смотритель зоопарка
    qpid = qpidd
    пс = PostgreSQL
    Edge = все компоненты Edge, кроме пользовательского интерфейса Edge: сервер управления, процессор сообщений, маршрутизатор, сервер QPID, сервер Postgres.
    ui = Пограничный интерфейс
    all = обновить все компоненты на компьютере (используйте только для профиля установки Edge aio или профиля установки API BaaS asa)
    е = ЭластичныйПоиск
    b = стек API BaaS
    p = API BaaS-портала
    ebp = ElasticSearch, API BaaS Stack и API BaaS Portal на одном узле.
  9. Проверьте обновление, запустив утилиту apigee-validate на сервере управления, как описано в разделе «Проверка установки» .
  10. Если вы установили новый резервный узел Postgres, выведите его из эксплуатации, как описано выше в разделе «Вывод из эксплуатации узла Postgres» .

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

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

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

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

Для автономной установки на 1 хост

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

Для автономной установки на 2 хоста

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

  1. Если вы обновляетесь с версии 4.16.01 , понизьте версию Zookeeper на компьютере 1:
    > ням, понизить версию apigee-zookeeper
  2. Обновите Cassandra и ZooKeeper на машине 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Обновите qpidd на машине 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f файл конфигурации
  4. Обновите LDAP на машине 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f файл конфигурации
  5. Обновите компоненты Edge на компьютере 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f файл конфигурации
  6. Обновите пользовательский интерфейс на компьютере 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f файл конфигурации
  7. Обновите postgresql на машине 2:
    1. Остановите сервер Postgres, сервер Qpid и postgresql:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server остановка
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server остановка
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql остановить
    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 и 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f файл конфигурации
  8. Обновите компоненты Edge на машине 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f файл конфигурации

Для кластерной установки из 5 хостов

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

  1. Убедитесь, что вы установили новый резервный узел Postgres, как описано выше в разделе Установка нового резервного узла Postgres .
  2. Если вы обновляетесь с версии 4.16.01 , понизьте версию Zookeeper на машинах 1, 2 и 3:
    > ням, понизить версию apigee-zookeeper
  3. Обновите Cassandra и ZooKeeper на машинах 1, 2 и 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Обновите qpidd на машинах 4 и 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f файл конфигурации
  5. Обновите LDAP на машине 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f файл конфигурации
  6. Обновите компоненты Edge на компьютере 1, 2, 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f файл конфигурации
  7. Обновите пользовательский интерфейс на компьютере 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f файл конфигурации
  8. Обновите машины 4 и 5:
    1. Остановите сервер Postgres и сервер Qpid на машине 4:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server остановка
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server остановка
    2. Остановите сервер Postgres, сервер Qpid и postgresql на машине 5:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server остановка
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server остановка
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql остановить
    3. Остановите сервер Postgres и postgresql на новом резервном узле, который вы добавили для отката:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server остановка
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql остановить
    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
      > РМ -РФ *
      > /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 файл конфигурации
  10. Убедитесь, что вы вывели из эксплуатации новый резервный узел, выполнив процедуру, описанную выше в разделе «Вывод из эксплуатации узла Postgres» .

Для кластерной установки из 9 хостов

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

  1. Убедитесь, что вы установили новый резервный узел Postgres, как описано выше в разделе Установка нового резервного узла Postgres .
  2. Если вы обновляетесь с версии 4.16.01 , понизьте версию Zookeeper на машинах 1, 2 и 3:
    > ням, понизить версию apigee-zookeeper
  3. Обновите Cassandra и ZooKeeper на машинах 1, 2 и 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Обновите qpidd на машинах 6 и 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f файл конфигурации
  5. Обновите LDAP на машине 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f файл конфигурации
  6. Обновите компоненты Edge на компьютерах 6, 7, 1, 4 и 5 в следующем порядке:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f файл конфигурации
  7. Обновите пользовательский интерфейс на компьютере 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f файл конфигурации
  8. Обновите машины 8 и 9:
    1. Остановите сервер Postgres на машине 8:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server остановка
    2. Остановите сервер Postgres и postgresql на машине 9:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server остановка
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql остановить
    3. Остановите сервер Qpid на машинах 6 и 7:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server остановка
    4. Остановите сервер Postgres и postgresql на новом резервном узле, который вы добавили для отката:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server остановка
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql остановить
    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
      > РМ -РФ *
      > /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 файл конфигурации
  10. Убедитесь, что вы вывели из эксплуатации новый резервный узел, выполнив процедуру, описанную выше в разделе «Вывод из эксплуатации узла Postgres» .

Для кластерной установки из 13 хостов

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

  1. Убедитесь, что вы установили новый резервный узел Postgres, как описано выше в разделе Установка нового резервного узла Postgres .
  2. Если вы обновляетесь с версии 4.16.01 , понизьте версию Zookeeper на машинах 1, 2 и 3:
    > ням, понизить версию apigee-zookeeper
  3. Обновите Cassandra и ZooKeeper на машинах 1, 2 и 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Обновите qpidd на машинах 12 и 13:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f файл конфигурации
  5. Обновите LDAP на машинах 4 и 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f файл конфигурации
  6. Обновите компоненты Edge на машинах 12, 13, 6, 7, 10 и 11 в следующем порядке:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f файл конфигурации
  7. Обновите пользовательский интерфейс на машинах 6 и 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f файл конфигурации
  8. Обновите машины 8 и 9:
    1. Остановите сервер Postgres на машине 8:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server остановка
    2. Остановите сервер Postgres и postgresql на машине 9:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server остановка
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql остановить
    3. Остановите сервер Qpid на машинах 12 и 13:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server остановка
    4. Остановите сервер Postgres и postgresql на новом резервном узле, который вы добавили для отката:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server остановка
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql остановить
    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
      > РМ -РФ *
      > /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 файл конфигурации
  10. Убедитесь, что вы вывели из эксплуатации новый резервный узел, выполнив процедуру, описанную выше в разделе «Вывод из эксплуатации узла Postgres» .

Для кластерной установки из 12 хостов

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

  1. Убедитесь, что вы установили новый резервный узел Postgres, как описано выше в разделе Установка нового резервного узла Postgres .
  2. Обновите Кассандру и ZooKeeper:
    1. Если вы обновляетесь с версии 4.16.01 , понизьте версию Zookeeper на компьютерах 1, 2 и 3 в центре обработки данных 1:
      > ням, понизить версию apigee-zookeeper
    2. На компьютерах 1, 2 и 3 в центре обработки данных 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    3. Если вы обновляетесь с версии 4.16.01 , понизьте версию Zookeeper на компьютерах 7, 8 и 9 в Data Center 2:
      > ням, понизить версию apigee-zookeeper
    4. На компьютерах 7, 8 и 9 в дата-центре 2.
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Обновить qpidd:
    1. Машины 4, 5 в дата-центре 1
      > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f файл конфигурации
    2. Машины 10, 11 в ЦОД 2
      > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f файл конфигурации
  4. Обновить LDAP:
    1. Машины 1 в дата-центре 1
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f файл конфигурации
    2. Машины 7 в дата-центре 2
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f файл конфигурации
  5. Обновите компоненты Edge:
    1. Машины 4, 5, 1, 2, 3 в дата-центре 1
      > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f файл конфигурации
    2. Машины 10, 11, 7, 8, 9 в дата-центре 2
      > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f файл конфигурации
  6. Обновить пользовательский интерфейс:
    1. Машина 1 в дата-центре 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c ui -f файл конфигурации
    2. Машина 7 в дата-центре 2:
      > /opt/apigee/apigee-setup/bin/update.sh -c ui -f файл конфигурации
  7. Обновите компьютер 6 в центре обработки данных 1 и компьютер 12 в центре обработки данных 2:
    1. Остановите сервер Postgres на машине 6:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server остановка
    2. Остановите сервер Postgres и postgresql на машине 12:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server остановка
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql остановить
    3. Остановите сервер Qpid на машинах 4, 5, 10 и 11:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server остановка
    4. Остановите сервер Postgres и postgresql на новом резервном узле, который вы добавили для отката:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server остановка
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql остановить
    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
      > РМ -РФ *
      > /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

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

Для установки API BaaS на 7 хостов

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

  1. Обновите Cassandra на машинах 5, 6 и 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f файл конфигурации
  2. Обновите стек ElasticSearch и API BaaS на машинах 1, 2 и 3:
    > /opt/apigee/apigee-setup/bin/update.sh -ce,b -f файл конфигурации
  3. Обновите API BaaS Portal на компьютере 4:
    > /opt/apigee/apigee-setup/bin/update.sh -cp -f файл конфигурации

Для установки API BaaS на 10 хостов

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

  1. Обновите Cassandra на машинах 8, 9 и 10:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f файл конфигурации
  2. Обновите ElasticSearch на машинах 1, 2 и 3:
    > /opt/apigee/apigee-setup/bin/update.sh -ce -f файл конфигурации
  3. Обновите стек API BaaS на машинах 4, 5 и 6:
    > /opt/apigee/apigee-setup/bin/update.sh -cb -f файл конфигурации
  4. Обновите портал API BaaS на компьютере 7:
    > /opt/apigee/apigee-setup/bin/update.sh -cp -f файл конфигурации

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

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

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