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

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

Edge for Private Cloud v4.18.01

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

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

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

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

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

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

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

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

Поддерживайте совместимость

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

Свойство	Местоположение	Описание
`conf_load_balancing_load.balancing. driver.nginx.server.retry`	`router.properties`	Удалите это свойство из файла `router.properties`. Чтобы задать параметры повторных попыток в версии 4.18.01, используйте свойства конфигурации виртуального хоста.

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

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

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

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

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

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

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

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

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

Большинство производственных систем Edge используют два узла Postgres, настроенных для репликации master-standby. Во время обновления, когда узлы Postgres отключены, данные аналитики по-прежнему записываются на узлы Qpid. После того как узлы Postgres будут обновлены и снова подключены к сети, данные аналитики будут переданы на узлы Postgres.

Способ обновления Postgres зависит от того, как вы настроили хранилище данных для узлов Postgres:

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

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

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

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

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

Эта процедура создает резервный сервер Postgres на новом узле. Убедитесь, что вы устанавливаете новый резервный сервер Postgres для существующей версии Edge (4.17.0x), а не для версии 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-адрес нового резервного узла.

Если файла postgresql.properties нет, создайте его и используйте команду chown, чтобы предоставить пользователю apigee доступ к нему, как показано в примере ниже.
```
chown apigee:apigee /opt/apigee/customer/application/postgresql.properties
```
Перезапустите 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 address of the current master:
PG_MASTER=192.168.56.103
# IP address of the new standby node
PG_STANDBY=192.168.56.102 
```
2. Отключите SELinux, как описано в разделе Установка утилиты apigee-setup для Edge.
3. Скачайте файл Edge bootstrap_4.17.0x.sh (где 4.17.0x – это 4.17.01, 4.17.05 или 4.17.09) в каталог /tmp/bootstrap_4.17.0x.sh :
```
curl https://software.apigee.com/bootstrap_4.17.0x.sh -o /tmp/bootstrap_4.17.0x.sh
```
4. Установите утилиту Edge apigee-service и зависимости:
```
sudo bash /tmp/bootstrap_4.17.0x.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>

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

Прежде чем обновлять 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.17.0x.

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

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

Если вы используете репликацию Postgres master-standby с локальным хранилищем, установите новый резервный узел Postgres, как описано выше в разделе Установка нового резервного узла Postgres.

Если вы используете сетевое хранилище, устанавливать новый узел не нужно. Вместо этого сделайте сетевой снимок хранилища данных, используемого Postgres. Подробнее об обязательном обновлении до Postgres 9.6…
Если у вас есть задания 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.
Если вы устанавливаете приложение на 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 из эксплуатации.

Если вы используете сетевое хранилище, устанавливать новый узел не нужно. Подробнее об обязательном обновлении до Postgres 9.6…

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

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

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

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

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

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

Если вы используете репликацию Postgres типа "основной-резервный", установите новый резервный узел Postgres, как описано выше в разделе Установка нового резервного узла Postgres.

Если вы используете сетевое хранилище, устанавливать новый узел не нужно. Вместо этого сделайте сетевой снимок хранилища данных, используемого Postgres. Подробнее об обязательном обновлении до Postgres 9.6…
Создайте локальное хранилище 4.18.01, как описано в разделе "Создание локального хранилища Apigee" статьи Установка утилиты apigee-setup для Edge.
Примечание. Если у вас уже есть хранилище 4.17.0x, вы можете добавить в него хранилище 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 из эксплуатации.

Если вы используете сетевое хранилище, устанавливать новый узел не нужно. Подробнее об обязательном обновлении до Postgres 9.6…

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

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

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

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

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

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

Если вы обновляете версию 4.17.01, задайте значение SMTPMAILFROM в файле конфигурации, если вы включили SMTP в Edge. Этот параметр имеет следующий вид:
SMTPMAILFROM="My Company <myco@company.com>"
Обновите Cassandra и ZooKeeper:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
Обновите Qpid:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
Обновите LDAP:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
Остановите сервер Postgres, сервер Qpid и PostgreSQL:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
Обновите postgresql:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
Обновите базу данных Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
Обновите остальные компоненты Edge:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Обновите Edge UI:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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