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

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

Edge for Private Cloud версии 4.16.05

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

Вы можете обновить только Apigee Edge версии 4.16.01.x до 4.16.05.

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

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

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

Предупреждение. Эта версия Edge не поддерживает JDK 7. Если вы используете JDK 7, вам необходимо перейти на JDK 8. Если вы откатите установку Edge 4.16.05, вы можете при необходимости перенастроить Edge для использования Java JDK 7.

Понижение уровня смотрителя зоопарка

Версия 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.948. Это предотвратит обновление Zookeeper до более поздних версий, начиная с 4.16.01. Чтобы исправить эту ситуацию, перед обновлением Zookeeper выполните команду yum downgrade apigee-zookeeper.

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

> rpm -qa |grep apigee-zookeeper

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

apigee-zookeeper-3.4.5-1.0.905

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

Требования к свободному месту на диске для обновления

Перед обновлением убедитесь, что на диске есть не менее 1 ГБ свободного места.

Автоматическое распространение настроек ресурсов из версии 4.16.01.x

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

Обновление утилиты apigee-validate

В версии 4.16.01 вы установили и запустили утилиту apigee-validate на узле Message Processor. В версии 4.16.05 утилита apigee-validate была обновлена для запуска на узле сервера управления.

При обновлении до версии 4.16.05 у вас есть два варианта обновления утилиты apigee-validate:

Рекомендуемый Apigee способ. Установите и запустите утилиту apigee-validate на узле сервера управления.

При необходимости вы можете удалить утилиту apigee-validate из узлов Message Processor. Если вы оставите его на узле Message Processor, обновите его до версии 4.16.05.
Вы также можете обновить утилиту apigee-validate на узле Message Processor и запустить ее оттуда. Однако Apigee рекомендует устанавливать и запускать его с сервера управления.

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

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

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

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

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

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

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

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

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

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

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

Если у пользователя, запустившего утилиту update.sh, нет доступа к этому каталогу, журнал записывается в каталог /tmp в виде файла с именем update_имя_пользователя.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.01.

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

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

Если у вас есть задания CRON, настроенные на восстановление Cassandra, отключите их до завершения обновления.
Войдите в узел как пользователь root, чтобы установить RPM-пакеты Edge.
Примечание. Для установки RPM-пакетов требуется доступ с правами root, но настроить Edge можно и без него.
Отключите SELinux, как описано в разделе Установка утилиты apigee-setup для Edge.
Скачайте файл Edge 4.16.05 bootstrap_4.16.05.sh в каталог /tmp/bootstrap_4.16.05.sh:
> curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
Установите утилиту Edge 4.16.05 apigee-service и зависимости:
> sudo bash /tmp/bootstrap_4.16.05.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.
Установите утилиту apigee-validate на сервере управления:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
Примечание. Если вы установили утилиту apigee-validate на узле Message Processor, вы можете обновить ее, выполнив на этом узле следующую команду:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
Однако для версии 4.16.05 Apigee рекомендует установить и запустить утилиту apigee-validate на сервере управления.
Измените файл конфигурации, переданный утилите apigee-validate. В предыдущей версии Edge файл конфигурации, используемый apigee-validate, требовал следующих свойств:
APIGEE_ADMINPW=sysAdminPword
MP_POD=gateway
REGION=dc-1
В этой версии файлу конфигурации требуется только свойство APIGEE_ADMINPW. Два других свойства можно удалить из файла.
Запустите утилиту обновления на узлах в порядке, описанном ниже в разделе "Порядок обновления компьютеров":
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
Единственное требование к файлу конфигурации – он должен быть доступен или доступен для чтения пользователю apigee. Например, поместите файл в каталог /tmp на узле.
Используйте параметр -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.
- ebp – ElasticSearch, API BaaS Stack и API BaaS Portal на одном узле.
Протестируйте обновление, запустив утилиту apigee-validate на сервере управления, как описано в разделе Тестирование установки.

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

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

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

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

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

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

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

> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
Однако для версии 4.16.05 Apigee рекомендует установить и запустить утилиту apigee-validate на сервере управления.
Измените файл конфигурации, переданный утилите apigee-validate. В предыдущей версии Edge файл конфигурации, используемый apigee-validate, требовал следующих свойств:
APIGEE_ADMINPW=sysAdminPword
MP_POD=gateway
REGION=dc-1
В этой версии файлу конфигурации требуется только свойство APIGEE_ADMINPW. Два других свойства можно удалить из файла.
Запустите утилиту обновления на узлах в порядке, описанном ниже в разделе "Порядок обновления компьютеров":
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
Единственное требование к файлу конфигурации – он должен быть доступен или доступен для чтения пользователю apigee. Например, поместите файл в каталог /tmp на узле.
Используйте параметр -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.
- ebp – ElasticSearch, API BaaS Stack и API BaaS Portal на одном узле.
Протестируйте обновление, запустив утилиту apigee-validate на сервере управления, как описано в разделе Тестирование установки.

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

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

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

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