Как обновить Apigee Edge 4.17.05 или 4.17.09 до версии 4.18.05

Edge для частного облака версии 4.18.05

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

  • С 4.17.05 по 4.18.05
  • С 17 апреля 2009 г. по 5 мая 2018 г.

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

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

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

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

Вам необходимо обновить все компоненты 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, как указано в требованиях к установке Edge.

    В установке Edge с одним или двумя узлами, которая используется для прототипирования и тестирования, есть только один узел 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.0x.sh, где x – это 5 (для версии 4.17.05) или 9 (для версии 4.17.09) в /tmp/bootstrap_4.17.0x.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-setup, используйте apigee-service:
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    6. Установите Postgres:
      /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, выполнив следующий вызов Edge Management API на узле сервера управления:
    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.

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

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

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

Что нужно сделать до и после обновления:

  • На комбинированном узле маршрутизатора и обработчика сообщений:
    • Перед обновлением выполните следующие действия:
      1. Сделайте маршрутизатор недоступным.
      2. Сделайте Message Processor недоступным.
    • После обновления выполните следующие действия:
      1. Убедитесь, что Message Processor доступен.
      2. Убедитесь, что маршрутизатор доступен.
  • На одном узле маршрутизатора:
    • Перед обновлением сделайте маршрутизатор недоступным.
    • После обновления убедитесь, что маршрутизатор доступен.
  • На одном узле Message Processor:
    • Перед обновлением сделайте Message Processor недоступным.
    • После обновления сделайте Message Processor доступным.

С помощью файла конфигурации в фоновом режиме

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

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

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

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

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

  2. Если они есть, отключите все задания CRON, настроенные на выполнение операции восстановления в Cassandra, до завершения обновления.
  3. Войдите в узел как root, чтобы установить пакеты RPM Edge.
  4. Установите yum-utils и yum-plugin-priorities:
    sudo yum install yum-utils
    sudo yum install yum-plugin-priorities
  5. Отключите SELinux, как описано в разделе Установка утилиты apigee-setup Edge.
  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 версии 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 = Install OpenJDK 1.8 (Установить OpenJDK 1.8; по умолчанию)
    • C = Продолжить без установки Java
    • Q – выход. В этом случае вам нужно будет установить Java самостоятельно.
  10. Чтобы обновить утилиту apigee-setup, используйте apigee-service:
    /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" = Cassandra
    • e – ElasticSearch.
    • "edge" – все компоненты Edge, кроме интерфейса Edge. Компонент "edge" включает сервер управления, обработчик сообщений, маршрутизатор, сервер QPID и сервер Edge Postgres.
    • "ldap" = OpenLDAP
    • "ps" = postgresql
    • "qpid" = qpidd
    • sso – Edge SSO;
    • "ui" – интерфейс Edge;
    • "zk" – Zookeeper.

    Вы можете запустить update.sh для всех компонентов, задав для параметра component значение "all", но только если у вас установлен профиль Edge all-in-one (aio). Пример:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
  14. Перезапустите компонент Edge UI на всех машинах, на которых он работает, если вы ещё этого не сделали:
    /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 из локального репозитория

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

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

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

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

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

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

  2. Создайте локальный репозиторий 4.18.05, как описано в разделе "Создание локального репозитория Apigee" статьи Установка утилиты apigee-setup для Edge.
  3. Чтобы установить apigee-service из файла .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/repos.

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

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

  4. Чтобы установить apigee-service с помощью веб-сервера 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-setup, используйте apigee-service:
    /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" = Cassandra
    • e – ElasticSearch.
    • "edge" – все компоненты Edge, кроме интерфейса Edge. Компонент "edge" включает сервер управления, обработчик сообщений, маршрутизатор, сервер QPID и сервер Edge Postgres.
    • "ldap" = OpenLDAP
    • "ps" = postgresql
    • "qpid" = qpidd
    • sso – Edge SSO;
    • "ui" – интерфейс Edge;
    • "zk" – Zookeeper.

    Вы можете запустить update.sh для всех компонентов, задав для параметра component значение "all", но только если у вас установлен профиль Edge all-in-one (aio). Пример:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
  9. Перезапустите компонент Edge UI на всех машинах, на которых он работает, если вы ещё этого не сделали:
    /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.
  • Для любого компьютера с несколькими компонентами Edge (сервер управления, обработчик сообщений, маршрутизатор, сервер QPID, но не сервер Postgres) используйте параметр "-c edge", чтобы обновить их все одновременно.
  • Если в шаге указано, что его нужно выполнить на нескольких компьютерах, сделайте это в указанном порядке.
  • Отдельно обновлять монетизацию не нужно. Он обновляется, когда вы указываете параметр "-c edge".

Установка на одном узле

  1. Обновите Cassandra и 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. Обновление postgresql:
    /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, обновите ее:
    /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

Установка на двух узлах

Список топологий 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. Обновление postgresql:
      /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

Установка с пятью узлами

Список топологий 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):
      /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

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

Список топологий 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):
      /-->
      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):
      /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. Обновите Cassandra и ZooKeeper:
    1. На машинах 1, 2 и 3 в центре обработки данных 1:
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    2. На машинах 7, 8 и 9 в центре обработки данных 2
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  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, обновите его:
    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):
      /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. ZooKeeper
  2. Cassandra
  3. qpidd, ps
  4. LDAP
  5. Edge – профиль "-c edge" на всех узлах в следующем порядке: узлы с сервером Qpid, сервером Edge Postgres, сервером управления, Message Processor и маршрутизатором.
  6. Интерфейс Edge
  7. Edge SSO

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