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

Edge for Private Cloud версии 4.17.09

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

Вы можете обновить Apigee Edge версии 4.16.09.0x до 4.17.09, используя эту процедуру.

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

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

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

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

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

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

Требуется обновление до Qpid 1.35

В этой версии содержится обязательное обновление до Qpid 1.35. При обновлении узла Qpid необходимо:

  • Временно запретите маршрутизаторам и обработчикам сообщений выполнять запись в узел Qpid, заблокировав порт 5672 на узле Qpid. Чтобы заблокировать этот порт на узле Qpid, используйте следующую команду:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  • Дождитесь, пока очередь Qpid не будет пуста. Это означает, что узел Qpid обработал все сообщения перед обновлением. Чтобы убедиться, что очередь сообщений Qpid пуста, используйте следующую команду:
    > qpid-stat -q
  • Обновите узел Qpid.
  • Разблокируйте порт 5672 на узле Qpid, чтобы разрешить доступ от маршрутизаторов и процессоров сообщений. Чтобы разблокировать этот порт, выполните следующую команду:
    > sudo iptables -F

    Если вы используете iptables для других правил, то можете отменить определенное изменение с помощью параметра -D:
    > sudo iptables -D INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP

Ниже подробно описан этот процесс для каждой топологии Edge.

Требуется для включения репозитория EPEL

Чтобы установить или обновить Edge, необходимо включить Extra Packages for Enterprise Linux (EPEL). Команда зависит от версии RedHat/CentOS:

  • Для RedHat/CentOS/Oracle 7.x:
    > wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; rpm -ivh epel-release-latest-7.noarch.rpm
  • Для RedHat/CentOS/Oracle 6.x:
    wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; rpm -ivh epel-release-latest-6.noarch.rpm

Необходимо добавить параметр конфигурации SMTPMAILFROM.

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

В API BaaS версии 4.17.09 также добавлена поддержка свойства SMTPMAILFROM. При обновлении API BaaS необходимо задать параметр SMTPMAILFROM в файле конфигурации.

Этот параметр имеет следующий формат:

SMTPMAILFROM="My Company <myco@company.com>"

Обязательно, если обновление выполняется при использовании внешней аутентификации.

Вы можете интегрировать внешнюю службу каталогов в существующую установку Apigee Edge Private Cloud. Эта функция совместима с любой службой каталогов, поддерживающей LDAP, например Active Directory, OpenLDAP и т. д. Внешнее решение LDAP позволяет системным администраторам управлять учетными данными пользователей из централизованной службы управления каталогами, внешней по отношению к системам, которые их используют, например Apigee Edge.

Подробнее о настройке внешней аутентификации…

Когда внешняя аутентификация включена, большинство клиентов используют поле имени аккаунта Active Directory SAM в качестве имени пользователя для аутентификации вместо адреса электронной почты, который используется сервером Edge OpenLDAP.

Если вы интегрировали Edge с внешней службой каталогов, то при обновлении Edge до версии 4.17.09 добавьте в файл конфигурации следующую строку:

IS_EXTERNAL_AUTH="true"

Эта строка настраивает Edge на поддержку имени аккаунта, а не адреса электронной почты, в качестве имени пользователя.

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

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

Обновление предварительных требований

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

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

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

    > /opt/apigee/apigee-service/bin/apigee-all status

Что делать, если обновление не удалось

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

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

Запись информации об обновлении

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

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

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

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

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

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

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

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

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

Перед обновлением или после него выполните следующие действия:

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

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

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

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

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

  1. Если у вас есть задания CRON, настроенные на восстановление Cassandra, отключите их до завершения обновления.
  2. Войдите в узел как root, чтобы установить Edge RPM.
    Примечание. Для установки RPM требуются права root, но для настройки Edge они не нужны.
  3. Установите yum-utils и yum-plugin-priorities:
    > sudo yum install yum-utils
    > sudo yum install yum-plugin-priorities
  4. Отключите SELinux, как описано в разделе Установка утилиты apigee-setup для Edge.
  5. Включите репозиторий EPEL, как описано выше.
  6. Если вы устанавливаете приложение на AWS, выполните следующую команду yum-configure-manager:
    > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  7. Скачайте файл Edge 4.17.09 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
  8. Установите утилиту Edge 4.17.09 apigee-service и зависимости:
    > sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord

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

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

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

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

    Чтобы указать компонент, который нужно обновить, используйте параметр -c. Список возможных компонентов:
    ldap = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge =все компоненты Edge, кроме Edge UI: Management Server, Message Processor, Router, QPID Server, Postgres Server
    ui = Edge UI
    all = обновить все компоненты на компьютере (используйте только для профиля установки Edge aio или API BaaS asa)
    e = ElasticSearch
    b = API BaaS Stack
    p = API BaaS Portal
    ebp = ElasticSearch, API BaaS Stack и API BaaS Portal на одном узле
  13. Протестируйте обновление, запустив утилиту apigee-validate на сервере управления, как описано в разделе Тестирование установки.

Чтобы откатить обновление, следуйте инструкциям в разделе 4.17.09 Процесс отката.

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

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

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

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

Чтобы выполнить обновление из локального хранилища версии 4.17.09:

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

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

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

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

      где uName:pWord – имя пользователя и пароль для доступа к хранилищу.
  4. Используйте apigee-service, чтобы обновить утилиту apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  5. Обновите утилиту apigee-validate на сервере управления.
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  6. Обновите утилиту apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  7. Запустите утилиту обновления на узлах в порядке, описанном ниже в разделе "Порядок обновления компьютеров":
    > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

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

    Чтобы указать компонент, который нужно обновить, используйте параметр -c. Список возможных компонентов:
    ldap = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge =все компоненты Edge, кроме Edge UI: Management Server, Message Processor, Router, QPID Server, Postgres Server
    ui = Edge UI
    all = обновить все компоненты на компьютере (используйте только для профиля установки Edge aio или API BaaS asa)
    e = ElasticSearch
    b = API BaaS Stack
    p = API BaaS Portal
    ebp = ElasticSearch, API BaaS Stack и API BaaS Portal на одном узле
  8. Протестируйте обновление, запустив утилиту apigee-validate на сервере управления, как описано в разделе Тестирование установки.

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

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

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

  • Прежде чем обновлять другие узлы, необходимо обновить все узлы Cassandra и ZooKeeper.
  • Для любого компьютера с несколькими компонентами Edge (Management Server, Message Processor, Router, QPID Server, но не Postgres Server) используйте параметр -c edge, чтобы обновить их все одновременно.
  • Если в инструкции указано, что действие нужно выполнить на нескольких компьютерах, делайте это в заданном порядке.
  • Отдельного шага для обновления монетизации нет. Он обновляется, если вы указываете параметр -c edge.

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

  1. Если вы включили SMTP на Edge, задайте параметр SMTPMAILFROM в файле конфигурации. Этот параметр имеет следующий вид:
    SMTPMAILFROM="My Company <myco@company.com>"
  2. Обновите Cassandra и ZooKeeper:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Задайте следующее правило iptables:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  4. Проверьте очередь сообщений Qpid:
    > qpid-stat -q

    Проверяйте очередь, пока в столбце msg не появится 0. Вы не сможете обновить Qpid, пока он не обработает все сообщения.
  5. Обновите qpidd:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. Очистите iptables:
    > sudo iptables -F
  7. Обновите postgresql:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  8. Запустите postgresql:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  9. Обновите LDAP:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  10. Обновите остальные компоненты Edge:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. Обновите Edge UI:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

  1. Если вы включили SMTP на Edge, задайте параметр SMTPMAILFROM в файле конфигурации. Этот параметр имеет следующий вид:
    SMTPMAILFROM="My Company <myco@company.com>"
  2. Обновите Cassandra и ZooKeeper на компьютере 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Настройте следующее правило iptables на компьютере 2:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  4. Проверьте очередь сообщений Qpid на компьютере 2:
    > qpid-stat -q

    Проверяйте очередь, пока в столбце msg не появится 0. Вы не сможете обновить Qpid, пока он не обработает все сообщения.
  5. Обновите qpidd на компьютере 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. Очистите iptables на компьютере 2:
    > sudo iptables -F
  7. Обновите postgresql на компьютере 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  8. Запустите postgresql на компьютере 2:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  9. Обновите LDAP на компьютере 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  10. Обновите компоненты Edge на компьютерах 2 и 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. Обновите пользовательский интерфейс на компьютере 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Для кластерной установки с пятью хостами

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

  1. Если вы включили SMTP на Edge, задайте параметр SMTPMAILFROM в файле конфигурации. Этот параметр имеет следующий вид:
    SMTPMAILFROM="My Company <myco@company.com>"
  2. Обновите Cassandra и ZooKeeper на компьютерах 1, 2 и 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Настройте следующее правило iptables на компьютере 4:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  4. Проверьте очередь сообщений Qpid на компьютере 4:
    > qpid-stat -q

    Проверяйте очередь, пока в столбце msg не появится 0. Вы не сможете обновить Qpid, пока он не обработает все сообщения.
  5. Обновите qpidd на компьютере 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. Очистите iptables на компьютере 4:
    > sudo iptables -F
  7. Повторите шаги 3–6 на компьютере 5.
  8. Обновите postgresql на компьютере 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  9. Запустите postgresql на компьютере 4:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  10. Повторите шаги 8 и 9 на компьютере 5.
  11. Обновите LDAP на компьютере 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  12. Обновите компоненты Edge на компьютерах 4, 5, 1, 2, 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  13. Обновите пользовательский интерфейс на компьютере 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

  1. Если вы включили SMTP на Edge, задайте параметр SMTPMAILFROM в файле конфигурации. Этот параметр имеет следующий вид:
    SMTPMAILFROM="My Company <myco@company.com>"
  2. Обновите Cassandra и ZooKeeper на компьютерах 1, 2 и 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Настройте следующее правило iptables на компьютере 6:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  4. Проверьте очередь сообщений Qpid на компьютере 6:
    > qpid-stat -q

    Проверяйте очередь, пока в столбце msg не появится 0. Вы не сможете обновить Qpid, пока он не обработает все сообщения.
  5. Обновите qpidd на компьютере 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. Очистите iptables на компьютере 6:
    > sudo iptables -F
  7. Повторите шаги 3–6 на компьютере 7.
  8. Обновите postgresql на компьютере 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  9. Запустите postgresql на компьютере 6:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  10. Повторите шаги 8 и 9 на компьютере 7.
  11. Обновите LDAP на компьютере 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  12. Обновите компоненты Edge на компьютерах 6, 7, 8, 9, 1, 4 и 5 в указанном порядке:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  13. Обновите пользовательский интерфейс на компьютере 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

  1. Если вы включили SMTP на Edge, задайте параметр SMTPMAILFROM в файле конфигурации. Этот параметр имеет следующий вид:
    SMTPMAILFROM="My Company <myco@company.com>"
  2. Обновите Cassandra и ZooKeeper на компьютерах 1, 2 и 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Задайте следующее правило iptables на компьютере 12:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  4. Проверьте очередь сообщений Qpid на компьютере 12:
    > qpid-stat -q

    Проверяйте очередь, пока в столбце msg не появится 0. Вы не сможете обновить Qpid, пока он не обработает все сообщения.
  5. Обновите qpidd на компьютере 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. Очистите iptables на компьютере 12:
    > sudo iptables -F
  7. Повторите шаги 3–6 на компьютере 13.
  8. Обновите postgresql на компьютере 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  9. Запустите postgresql на компьютере 12:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  10. Повторите шаги 8 и 9 на компьютере 13.
  11. Обновите LDAP на компьютерах 4 и 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  12. Обновите компоненты Edge на компьютерах 12, 13, 8, 9, 6, 7, 10 и 11 в указанном порядке:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  13. Обновите пользовательский интерфейс на компьютерах 6 и 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

  1. Если вы включили SMTP на Edge, задайте параметр SMTPMAILFROM в файле конфигурации. Этот параметр имеет следующий вид:
    SMTPMAILFROM="My Company <myco@company.com>"
  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. Задайте следующее правило iptables на компьютере 4:
        > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
      2. Проверьте очередь сообщений Qpid на компьютере 4:
        > qpid-stat -q

        Проверяйте очередь, пока в столбце msg не появится 0. Вы не сможете обновить Qpid, пока не будут обработаны все сообщения.
      3. Обновите qpidd на компьютере 4:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. Очистите iptables на компьютере 4:
        > sudo iptables -F
      5. Повторите шаги 1–4 на компьютере 5.
    2. Машины 10, 11 в центре обработки данных 2
      1. Задайте следующее правило iptables на компьютере 10:
        > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
      2. Проверьте очередь сообщений Qpid на компьютере 10:
        > qpid-stat -q

        Проверяйте очередь, пока в столбце msg не появится 0. Вы не сможете обновить Qpid, пока не будут обработаны все сообщения.
      3. Обновите qpidd на компьютере 10:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. Очистите iptables на компьютере 10:
        > sudo iptables -F
      5. Повторите шаги 1–4 на компьютере 11.
  4. Обновите postgresql:
    1. Машина 6 в центре обработки данных 1
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
    2. Машины 12 в центре обработки данных 2
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  5. Обновите 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
  6. Обновите компоненты Edge:
    1. Машины 4, 5, 6, 1, 2, 3 в центре обработки данных 1
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. Машины 10, 11, 12, 7, 8, 9 в центре обработки данных 2
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Обновление интерфейса:
    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

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

# For a single data center, specify the same value as BAAS_CASS_LOCALDC.
BAAS_CASS_DC_LIST="dc-1"

# Defines the initial contact points for members of the BaaS cluster. 
# Specify the IP address of no more than two Stack nodes. 
BAAS_CLUSTER_SEEDS="dc-1:$IP4,dc-1:$IP5"

# Specify the from address of generated emails.
SMTPMAILFROM="My Company <myco@company.com>"

Полный пример файла конфигурации можно найти в статье Установка API BaaS.

Также убедитесь, что на всех узлах Stack открыт порт 2551 для доступа со всех остальных узлов Stack.

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

  1. Обновите Cassandra на компьютерах 5, 6 и 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile

  2. Обновите ElasticSearch и API BaaS Stack на компьютерах 1, 2 и 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c e,b -f configFile

  3. Обновите портал API BaaS на компьютере 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

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

# For a single data center, specify the same value as BAAS_CASS_LOCALDC.
BAAS_CASS_DC_LIST="dc-1"

# Defines the initial contact points for members of the BaaS cluster. 
# Specify the IP address of no more than two Stack nodes. 
BAAS_CLUSTER_SEEDS="dc-1:$IP4,dc-1:$IP5"

# Specify the from address of generated emails.
SMTPMAILFROM="My Company <myco@company.com>"

Полный пример файла конфигурации можно найти в статье Установка API BaaS.

Также убедитесь, что на всех узлах Stack открыт порт 2551 для доступа со всех остальных узлов Stack.

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

  1. Обновите Cassandra на компьютерах 8, 9 и 10:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. Обновите ElasticSearch на компьютерах 1, 2 и 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  3. Обновите стек API BaaS на компьютерах 4, 5 и 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  4. Обновите портал API BaaS на компьютере 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

Нестандартная установка

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

  1. ZooKeeper
  2. Cassandra
  3. qpidd, ps
  4. LDAP
  5. Edge, то есть профиль "-c edge" на всех узлах в следующем порядке: узлы с сервером Qpid, сервером Postgres, сервером управления, Message Processor и маршрутизатором.
    Примечание. Если на узле установлены серверы Qpid и Postgres, выполните шаг профиля "-c edge".
  6. Интерфейс Edge