Обновите Apigee Edge с 4.17.09 до 4.19.01.

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

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

• С 17.04.09 по 19.04.01

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

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

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

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

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

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

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

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

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

Требуется обновление до 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.09), а не для версии 4.19.01.

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

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

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

   conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust

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

2. Перезапустите apigee-postgresql на главном сервере Postgres:

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart

3. Убедитесь, что новый резервный узел был добавлен, просмотрев файл /opt/apigee/apigee-postgresql/conf/pg_hba.conf на главном сервере. В этом файле вы должны увидеть следующие строки:

   host replication apigee existing_standby_ip/32 trust
   host replication apigee new_standby_ip/32 trust

4. Установите новый резервный сервер Postgres:
   1. Отредактируйте файл конфигурации, который вы использовали для установки текущей версии Edge, указав следующее:

      # IP address of the current master:
      PG_MASTER=192.168.56.103
      # IP address of the new standby node
      PG_STANDBY=192.168.56.102

   2. Отключите SELinux, как описано в разделе Установка утилиты Edge apigee-setup .
   3. Загрузите файл Edge bootstrap_4.17.09.sh в /tmp/bootstrap_4.17.09.sh :

      curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh

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

      sudo bash /tmp/bootstrap_4.17.09.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_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, выполнив следующий вызов API управления Edge на узле Management Server:

   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

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

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

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

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

По умолчанию утилита 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.09.

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

Используйте следующую процедуру для обновления компонентов 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.19.01 bootstrap_4.19.01.sh в /tmp/bootstrap_4.19.01.sh :

   curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh

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

   sudo bash /tmp/bootstrap_4.19.01.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.19.01» .

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

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

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

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

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

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

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

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

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

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

      tar -xzf apigee-4.19.01tar.gz

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

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

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

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

4. Чтобы установить сервис apigee с помощью веб-сервера Nginx:
   1. Настройте веб-сервер Nginx, как описано в разделе «Установка из репозитория с помощью веб-сервера Nginx» в разделе «Установка утилиты Edge apigee-setup .
   2. На удаленном узле загрузите файл Edge bootstrap_4.19.01.sh в /tmp/bootstrap_4.19.01.sh :

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

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

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

      sudo bash /tmp/bootstrap_4.19.01.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.19.01» .

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

Порядок обновления компьютеров в конфигурации 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. Обновите оставшиеся компоненты Edge:

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

7. Обновите пользовательский интерфейс Edge:

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

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

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

9. (Если вы установили Edge SSO) Обновите Edge SSO:

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

10. Перезапустите компонент Edge UI:

    /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. (Если вы установили apigee-adminapi ) Обновлена ​​утилита apigee-adminapi на компьютере 1:

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

7. (Если вы установили Edge SSO) Обновите Edge SSO на компьютере 1:

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

8. Обновите 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. Обновите компоненты Edge на машине 2:

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

9. Перезапустите компонент 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. (Если вы установили apigee-adminapi ) Обновлена ​​утилита apigee-adminapi на компьютере 1:

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

8. (Если вы установили Edge SSO) Обновите Edge SSO на компьютере 1:

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

9. Обновите машины 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. Обновите postgresql на машинах 5:

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

   6. Запустите сервер 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

   7. Настройте 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

   8. Проверьте состояние репликации, выполнив следующие сценарии на обоих серверах. Система должна отображать одинаковые результаты на обоих серверах, чтобы гарантировать успешную репликацию:
      • На машине 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

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

10. Обновите компоненты Edge на машинах 4, 5:

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

11. Убедитесь, что вы вывели из эксплуатации новый резервный узел, как описано в разделе «Вывод из эксплуатации узла Postgres» .

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

12. Перезапустите компонент 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. (Если вы установили apigee-adminapi ) Обновлена ​​утилита apigee-adminapi на компьютере 1:

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

8. (Если вы установили Edge SSO) Обновите Edge SSO на компьютере 1:

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

9. Обновите машины 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. Обновите postgresql на машинах 9:

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

   7. Запустите сервер Postgres на машинах 8 и 9:

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start

   8. Запустите сервер Qpid на машинах 6 и 7:

      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start

   9. Настройте 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

   10. Проверьте состояние репликации, выполнив следующие сценарии на обоих серверах. Система должна отображать одинаковые результаты на обоих серверах, чтобы гарантировать успешную репликацию:
       • На машине 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

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

10. Обновите компоненты Edge на машинах 8 и 9:

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

11. Убедитесь, что вы вывели из эксплуатации новый резервный узел, как описано в разделе «Вывод из эксплуатации узла Postgres» .

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

12. Перезапустите компонент 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. (Если вы установили apigee-adminapi ) Обновлена ​​утилита apigee-adminapi на машинах 6 и 7:

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

8. (Если вы установили Edge SSO) Обновите Edge SSO на компьютерах 6 и 7:

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

9. Обновите машины 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. Обновите postgresql на машинах 9:

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

   7. Запустите сервер Postgres на машинах 8 и 9:

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start

   8. Запустите сервер Qpid на машинах 12 и 13:

      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start

   9. Настройте 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

   10. Проверьте состояние репликации, выполнив следующие сценарии на обоих серверах. Система должна отображать одинаковые результаты на обоих серверах, чтобы гарантировать успешную репликацию:
       • На машине 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

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

10. Обновите компоненты Edge на машинах 8 и 9:

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

11. Убедитесь, что вы вывели из эксплуатации новый резервный узел, как описано в разделе «Вывод из эксплуатации узла Postgres» .

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

12. Перезапустите компонент 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. (Если вы установили 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. (Если вы установили 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

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

9. Обновите компьютер 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. Обновите postgresql на машинах 12:

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

   7. Запустите сервер Postgres на машинах 6 и 12:

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start

   8. Запустите сервер Qpid на машинах 4, 5, 10 и 11:

      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start

   9. Настройте 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

   10. Проверьте состояние репликации, выполнив следующие сценарии на обоих серверах. Система должна отображать одинаковые результаты на обоих серверах, чтобы гарантировать успешную репликацию:

       На машине 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

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

10. Обновите компоненты Edge на машинах 6 и 12:

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

11. Убедитесь, что вы вывели из эксплуатации новый резервный узел, как описано в разделе «Вывод из эксплуатации узла Postgres» .

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

12. Перезапустите компонент 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. apigee-adminapi
8. Пограничный единый вход

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