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

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

Edge for Private Cloud v4.18.01

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

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

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

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

Пользователь, выполняющий обновление, должен быть тем же пользователем, который изначально установил 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.

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

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

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

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

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

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

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

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

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

На текущем главном сервере 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-адрес нового резервного узла.
Перезапустите apigee-postgresql на основном узле Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
Убедитесь, что новый резервный узел был добавлен, просмотрев файл /opt/apigee/apigee-postgresql/conf/pg_hba.conf на главном узле. В файле должны быть следующие строки:
host replication apigee existing_slave_ip/32 trust
host replication apigee new_slave_ip/32 trust
Установите новый резервный сервер Postgres:
1. Отредактируйте файл конфигурации, который вы использовали для установки текущей версии Edge, указав следующее:
  
  # IP-адрес текущего головного экземпляра:
  PG_MASTER=192.168.56.103
  # IP-адрес нового резервного узла
  PG_STANDBY=192.168.56.102
2. Отключите SELinux, как описано в статье Как установить утилиту apigee-setup для Edge.
3. Скачайте файл Edge bootstrap_4.16.09.sh в каталог /tmp/bootstrap_4.16.09.sh:
  > curl https://software.apigee.com/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh
4. Установите утилиту Edge apigee-service и зависимости:
  > sudo bash /tmp/bootstrap_4.16.09.sh apigeeuser=uName apigeepassword=pWord
5. Используйте apigee-service, чтобы установить утилиту apigee-setup:
  > /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 из эксплуатации

После завершения обновления выведите из эксплуатации новый резервный узел:

Убедитесь, что Postgres работает:
> /opt/apigee/apigee-service/bin/apigee-all status

Если Postgres не работает, запустите его:
> /opt/apigee/apigee-service/bin/apigee-all start
Получите UUID нового резервного узла, выполнив на нем следующую команду cURL:
> curl -u sysAdminEmail:password http://<node_IP>:8084/v1/servers/self

В конце выходных данных вы увидите UUID узла в следующем формате:
"type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
Остановите новый резервный узел, выполнив на нем следующую команду:
> /opt/apigee/apigee-service/bin/apigee-all stop
На главном узле 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
Перезапустите apigee-postgresql на основном узле Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
Убедитесь, что новый резервный узел удален. Для этого проверьте файл /opt/apigee/apigee-postgresql/conf/pg_hba.conf на главном узле. В этом файле должна быть только следующая строка:
host replication apigee existing_slave_ip/32 trust
Удалите UUID резервного узла из ZooKeeper, выполнив следующий вызов Edge Management API на узле сервера управления:
> curl -u sysAdminEmail:password -X DELETE http://<ms_IP>:8080/v1/servers/<new_slave_uuid>

Требуется для включения репозитория 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.18.01.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Если вы используете репликацию Postgres типа "основной-резервный", установите новый резервный узел Postgres, как описано выше в разделе Установка нового резервного узла Postgres.
Если у вас есть задания CRON, настроенные на восстановление Cassandra, отключите их до завершения обновления.
Войдите в узел как root, чтобы установить Edge RPM.
Примечание. Для установки RPM требуются права root, но для настройки Edge они не нужны.
Установите yum-utils и yum-plugin-priorities:
> sudo yum install yum-utils
> sudo yum install yum-plugin-priorities
Отключите SELinux, как описано в разделе Установка утилиты apigee-setup для Edge.
Включите репозиторий EPEL, как описано выше.
Если вы устанавливаете приложение на Oracle 7.x, выполните следующую команду:
> sudo yum-config-manager --enable ol7_optional_latest
Если вы устанавливаете инструмент на 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
Скачайте файл Edge 4.18.01 bootstrap_4.18.01.sh в /tmp/bootstrap_4.18.01.sh:
> curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
Установите утилиту apigee-service для Edge 4.18.01 и зависимости:
> sudo bash /tmp/bootstrap_4.18.01.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 самостоятельно.
Используйте apigee-service, чтобы обновить утилиту apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
Обновите утилиту apigee-validate на сервере управления:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
Обновите утилиту apigee-provision:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
Запустите утилиту обновления на узлах в порядке, описанном ниже в разделе Порядок обновления компьютеров:
> /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 на одном узле
Протестируйте обновление, запустив утилиту apigee-validate на сервере управления, как описано в разделе Тестирование установки.
Если вы установили новый резервный узел Postgres, выведите его из эксплуатации, как описано выше в разделе Вывод из эксплуатации узла Postgres.

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

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

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

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

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

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

Если вы используете репликацию Postgres master-standby, установите новый резервный узел Postgres, как описано в разделе Установка нового резервного узла Postgres.
Создайте локальное хранилище 4.18.01, как описано в разделе "Создание локального хранилища Apigee" статьи Установка утилиты apigee-setup для Edge.
Примечание. Если у вас уже есть хранилище версии 4.16.09, вы можете добавить в него хранилище версии 4.18.01, как описано в разделе "Обновление локального хранилища Apigee" статьи Установка утилиты apigee-setup для Edge.
Чтобы установить apigee-service из файла TAR, выполните следующие действия:
1. На узле с локальным хранилищем используйте следующую команду, чтобы упаковать локальное хранилище в один TAR-файл с названием /opt/apigee/data/apigee-mirror/apigee-4.18.01.tar.gz:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
2. Скопируйте TAR-файл на узел, на котором вы хотите обновить Edge. Например, скопируйте его в каталог /tmp на новом узле.
3. На новом узле распакуйте файл в каталог /tmp:
  > tar -xzf apigee-4.18.01.tar.gz
  
  Эта команда создает новый каталог с именем repos в каталоге, содержащем TAR-файл. Например, /tmp/repos.
4. Установите утилиту apigee-service для Edge и зависимости из каталога /tmp/repos:
  > sudo bash /tmp/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  
  Обратите внимание, что в этой команде вы указываете путь к каталогу repos.
Чтобы установить apigee-service с помощью веб-сервера Nginx, выполните следующие действия:
1. Настройте веб-сервер Nginx, как описано в разделе "Установка из репозитория с помощью веб-сервера Nginx" статьи Установка утилиты apigee-setup для Edge.
2. На удаленном узле скачайте файл Edge bootstrap_4.18.01.sh в каталог /tmp/bootstrap_4.18.01.sh:
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
  
  где uName:pWord – имя пользователя и пароль, заданные выше для хранилища, а remoteRepo – IP-адрес или DNS-имя узла хранилища.
3. На удаленном узле установите утилиту apigee-service и зависимости:
  > sudo bash /tmp/bootstrap_4.18.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
  
  где uName:pWord – имя пользователя и пароль хранилища.
Используйте apigee-service, чтобы обновить утилиту apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
Обновите утилиту apigee-validate на сервере управления.
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
Обновите утилиту apigee-provision:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
Запустите утилиту обновления на узлах в порядке, описанном ниже в разделе "Порядок обновления компьютеров":
> /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 на одном узле
Протестируйте обновление, запустив утилиту apigee-validate на сервере управления, как описано в разделе Тестирование установки.
Если вы установили новый резервный узел Postgres, выведите его из эксплуатации, как описано выше в разделе Вывод узла Postgres из эксплуатации.

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

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

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

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