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

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

Edge for Private Cloud v. 4.16.09

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

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

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

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

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

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

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

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

В рамках обновления до Java 8 некоторые шифры TLS больше не доступны в Oracle JDK 8. Полный список можно найти в разделе Default Disabled Cipher Suites на странице http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.

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

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

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

> rpm -qa |grep apigee-zookeeper

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

apigee-zookeeper-3.4.5-1.0.905

Затем вы должны выполнить переход на версию с ограниченной функциональностью.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Для установки используйте тот же файл конфигурации, который вы использовали для установки текущей версии 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. Скачайте файл bootstrap_4.16.05.sh для Edge в каталог /tmp/bootstrap_4.16.05.sh:
  > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
  
  Примечание. Если вы обновляете версию 4.16.01, скачайте файл bootstrap.sh для Edge.
4. Установите утилиту Edge apigee-service и зависимости:
  > sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord
5. Используйте apigee-service, чтобы установить утилиту apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-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>

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

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

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

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

Обновите компьютеры в правильном порядке, как описано ниже в разделе "Порядок обновления компьютеров".
Когда придет время обновить маршрутизаторы, выберите любой из них и сделайте его недоступным, как описано в разделе Включение/отключение доступности сервера (Message Processor/Router).
Обновите выбранный маршрутизатор и все остальные компоненты 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.01 или 4.16.05.

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

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

Если вы используете репликацию Postgres master-standby, установите новый резервный узел Postgres, как описано выше в разделе Установка нового резервного узла Postgres.
Если у вас есть задания CRON, настроенные на восстановление Cassandra, отключите их до завершения обновления.
Войдите в узел как root, чтобы установить Edge RPM.
Примечание. Для установки RPM требуются права root, но для настройки Edge они не нужны.
Отключите SELinux, как описано в разделе Установка утилиты apigee-setup для Edge.
Скачайте файл Edge 4.16.09 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
Установите утилиту apigee-service Edge 4.16.09 и зависимости:
> sudo bash /tmp/bootstrap_4.16.09.sh apigeeuser=uName apigeepassword=pWord

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

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

I – установить OpenJDK 1.8 (по умолчанию);
C – продолжить без установки Java;
Q – выйти. В этом случае вам нужно будет установить Java самостоятельно.
Используйте apigee-service, чтобы обновить утилиту apigee-setup:
1. Если вы установили версию 4.16.01, обновив Edge 4.15.07.0x, вам необходимо установить утилиту apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  
  Эта команда устанавливает утилиту update.sh в каталог <inst_dir>/apigee/apigee-setup/bin.
  
  Если вы уже установили утилиту apigee-setup, обновите ее:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
2. Если вы установили версию 4.16.01 напрямую, то есть не выполняли обновление с версии 4.15.07.0x, вам необходимо обновить утилиту apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  
  Это обновление для apigee-service устанавливает утилиту update.sh в каталог <inst_dir>/apigee/apigee-setup/bin.
3. Если вы установили версию 4.16.05 напрямую или в результате обновления, вам необходимо обновить утилиту apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  
  Это обновление для apigee-service устанавливает утилиту update.sh в каталог <inst_dir>/apigee/apigee-setup/bin.
В зависимости от текущей версии Edge вам необходимо установить или обновить утилиту apigee-validate на сервере управления.
1. Если вы используете Edge 4.16.05, обновите утилиту apigee-validate на сервере управления:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
2. Если вы используете Edge 4.16.01, установите утилиту apigee-validate на сервере управления:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
  
  Примечание. Если вы установили утилиту apigee-validate на узле Message Processor при установке версии 4.16.01, вы можете обновить ее, выполнив на этом узле следующую команду:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  
  Однако начиная с версии 4.16.05 Apigee рекомендует устанавливать и запускать утилиту apigee-validate на сервере управления.
3. Если вы обновляете версию 4.16.01, отредактируйте файл конфигурации, переданный утилите apigee-validate. В версии Edge 4.16.01 файл конфигурации, используемый apigee-validate, требовал следующих свойств:
  APIGEE_ADMINPW=sysAdminPword
  MP_POD=gateway
  REGION=dc-1
  
  В этой версии файлу конфигурации требуется только свойство APIGEE_ADMINPW. Два других свойства можно удалить из файла.
Обновите утилиту 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.16.09 Процесс отката.

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

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

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

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

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

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

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

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

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