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

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

Edge for Private Cloud v4.18.01

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

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

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

Вы можете перенести Apigee Edge версии 4.15.07 в версию 4.16.01.
Если у вас версия Edge до 4.15.07, сначала необходимо перейти на версию 4.15.07, а затем на версию 4.16.01.
- Если вы выполняете перенос из Edge версии 4.14.04 или более поздней, перейдите сразу на версию 4.15.07.
- Если вы переносите данные из Edge версии 4.14.01, сначала выполните перенос в версию 4.14.04, а затем – в версию 4.15.07.

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

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

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

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

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

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

> /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 не будет работать.

Требуется обновление до 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.

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

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

Для RedHat/CentOS 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 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 до версии 4.18.01:

IS_EXTERNAL_AUTH="true"

Эта строка настраивает 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.01 или 4.16.05), а не для версии 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. Скачайте файл 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 без отключения.

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

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

Обновите компьютеры в правильном порядке, как описано ниже в разделе "Порядок обновления компьютеров".
Когда придет время обновить маршрутизаторы, выберите любой из них и сделайте его недоступным, как описано в разделе Включение/отключение доступности сервера (процессора сообщений/маршрутизатора).
Обновите выбранный маршрутизатор и все остальные компоненты 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.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:
1. Если вы установили версию 4.16.01, обновив Edge 4.15.07.0x, вам необходимо установить утилиту apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  
  Эта команда устанавливает утилиту update.sh в /opt/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 в /opt/apigee/apigee-setup/bin.
3. Если вы установили версию 4.16.05 напрямую или в результате обновления, вам необходимо обновить утилиту apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  
  Это обновление для apigee-service устанавливает утилиту update.sh в каталог /opt/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.18.01 Процесс отката.

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

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

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

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

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

Если вы используете репликацию Postgres типа "основной-резервный", установите новый резервный узел Postgres, как описано выше в разделе Установка нового резервного узла Postgres.
Создайте локальное хранилище 4.18.01, как описано в разделе "Создание локального хранилища Apigee" статьи Установка утилиты apigee-setup для Edge.
Примечание. Если у вас уже есть хранилище 4.16.01 или 4.16.05, вы можете добавить в него хранилище 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:
1. Если вы установили версию 4.16.01, обновив Edge 4.15.07.0x, вам необходимо установить утилиту apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  
  Эта команда устанавливает утилиту update.sh в /opt/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 в /opt/apigee/apigee-setup/bin.
3. Если вы установили версию 4.16.05 напрямую или путем обновления, вам необходимо обновить утилиту apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  
  Это обновление для apigee-service устанавливает утилиту update.sh в /opt/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.18.01 Процесс отката.

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

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

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