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

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

Edge for Private Cloud 4.19.01

В этом разделе описывается, как выполнить следующие обновления:

С 4.17.09 по 4.19.01

Все пути обновления

В таблице ниже показаны пути обновления для версии 4.19.01.


С версии 4.18.05	Обновление с версии 4.18.05 до 4.19.01
С версии 4.18.01	Обновите версию 4.18.01 до 4.19.01.
С версии 4.17.09	Обновление с версии 4.17.09 до 4.19.01
С версии 4.17.05	Обновите версию 4.17.05 до 4.18.01, а затем обновите версию 4.18.01 до 4.19.01.
С версии 4.17.01	Обновите версию 4.17.01 до 4.18.01, а затем обновите версию 4.18.01 до 4.19.01.
С версии 4.16.09	Обновите версию 4.16.09 до 4.18.01, а затем обновите версию 4.18.01 до 4.19.01.
С версии 4.16.05	Обновите версию 4.16.05 до 4.18.01, а затем обновите версию 4.18.01 до 4.19.01.
Начиная с версии 4.16.01	Обновите версию 4.16.01 до 4.18.01, а затем обновите версию 4.18.01 до 4.19.01.
Начиная с версии 4.15.0x	Обновите версию 4.15.0x до 4.16.01, затем обновите версию 4.16.01 до 4.18.01, а затем обновите версию 4.18.01 до 4.19.01.

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

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

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

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

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

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

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

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

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

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

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

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

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

На текущем главном сервере Postgres измените файл /opt/apigee/customer/application/postgresql.properties, чтобы задать следующий токен. Если такого файла нет, создайте его:
```
conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust
```
где existing_standby_ip – IP-адрес текущего резервного сервера Postgres, а new_standby_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_standby_ip/32 trust
host replication apigee new_standby_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. Скачайте файл bootstrap_4.17.09.sh для Edge в каталог /tmp/bootstrap_4.17.09.sh :
```
curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
```
4. Установите утилиту Edge apigee-service и зависимости:
```
sudo bash /tmp/bootstrap_4.17.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_standby_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_standby_ip/32 trust
```
Удалите UUID резервного узла из ZooKeeper, выполнив следующий вызов Edge Management API на узле сервера управления:
```
curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid
```

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

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

Создайте резервные копии всех узлов
Перед обновлением рекомендуется создать резервные копии всех узлов. Выполните резервное копирование в соответствии с инструкциями для вашей версии Edge.
Это позволит вам иметь запасной план на случай, если обновление до новой версии не будет работать должным образом. Подробнее о резервном копировании и восстановлении…
Убедитесь, что Edge работает
Убедитесь, что Edge работает во время обновления, с помощью следующей команды:
```
/opt/apigee/apigee-service/bin/apigee-all status
```

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

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

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

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

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

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

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

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

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

Обновление без простоя, или последовательное обновление, позволяет обновить конфигурацию Edge без отключения 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.17.09.

Обновите до версии 4.19.01 на узле с внешним подключением к интернету.

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

Если вы используете репликацию Postgres в режиме "основной-резервный" с локальным хранилищем, установите новый резервный узел 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.19.01 bootstrap_4.19.01.sh в каталог /tmp/bootstrap_4.19.01.sh:
```
curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
```
Установите утилиту Edge 4.19.01 apigee-service и зависимости:
```
sudo bash /tmp/bootstrap_4.19.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-setup, используйте apigee-service:
```
/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. Список возможных компонентов:
- "cs" – Cassandra;
- edge – все компоненты Edge, кроме Edge UI. Компонент edge включает Management Server, Message Processor, Router, QPID Server и Edge Postgres Server.
- "ldap" – OpenLDAP;
- "ps" – PostgreSQL;
- "qpid" = qpidd
- "sso" – система единого входа Edge;
- "ui" – Edge UI;
- zk – Zookeeper;
Вы можете запустить update.sh для всех компонентов, установив для component значение "all", но только если у вас есть профиль конфигурации Edge "все в одном" (AIO). Пример:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
```
Перезапустите компонент Edge UI на всех компьютерах, на которых он запущен, если вы ещё этого не сделали:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
Протестируйте обновление, запустив утилиту apigee-validate на сервере управления, как описано в разделе Тестирование установки.
Если вы установили новый резервный узел Postgres, выведите его из эксплуатации, как описано в разделе Вывод из эксплуатации узла Postgres.
Если вы используете сетевое хранилище, устанавливать новый узел не нужно. Подробнее об обязательном обновлении до Postgres 9.6…

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

Обновление до версии 4.19.01 из локального хранилища

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

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

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

Чтобы выполнить обновление из локального хранилища 4.19.01:

Если вы используете репликацию Postgres master-standby, установите новый резервный узел Postgres, как описано в разделе Установка нового резервного узла Postgres.
Если вы используете сетевое хранилище, устанавливать новый узел не нужно. Вместо этого сделайте снимок сети хранилища данных, используемого Postgres. Подробнее об обязательном обновлении до Postgres 9.6…
Создайте локальное хранилище 4.19.01, как описано в разделе "Создание локального хранилища Apigee" статьи Установка утилиты apigee-setup для Edge.

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

Запустите утилиту update на узлах в порядке, описанном в разделе Порядок обновления компьютеров.
```
/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
```
Единственное требование к файлу конфигурации – он должен быть доступен или доступен для чтения пользователю apigee.

Чтобы указать компонент, который нужно обновить, используйте параметр -c. Список возможных компонентов:
- "cs" – Cassandra;
- edge – все компоненты Edge, кроме Edge UI. Компонент edge включает Management Server, Message Processor, Router, QPID Server и Edge Postgres Server.
- "ldap" – OpenLDAP;
- "ps" – PostgreSQL;
- "qpid" = qpidd
- "sso" – система единого входа Edge;
- "ui" – Edge UI;
- zk – Zookeeper;
Вы можете запустить update.sh для всех компонентов, установив для component значение "all", но только если у вас есть профиль конфигурации Edge "все в одном" (AIO). Пример:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
```
Перезапустите компонент Edge UI на всех компьютерах, на которых он запущен, если вы ещё этого не сделали:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
Протестируйте обновление, запустив утилиту apigee-validate на сервере управления, как описано в разделе Тестирование установки.
Если вы установили новый резервный узел Postgres, выведите его из эксплуатации, как описано в разделе Вывод из эксплуатации узла Postgres.
Если вы используете сетевое хранилище, устанавливать новый узел не нужно. Подробнее об обязательном обновлении до Postgres 9.6…

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

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

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

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

Обновление отдельного узла

Обновите 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

Обновите остальные компоненты Edge:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

Обновление интерфейса Edge:

/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

(Если вы установили apigee-adminapi) Обновлена утилита apigee-adminapi:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(Если вы установили Edge SSO) Обновите Edge SSO:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
где sso_config_file – файл конфигурации, созданный при установке SSO.

Перезапустите компонент Edge UI:

/opt/apigee/apigee-service/bin/apigee-service edge-ui restart

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

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

Список топологий Edge и номеров узлов приведен в разделе Топологии установки.

Обновите Cassandra и ZooKeeper на компьютере 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```

Обновите Qpid на машине 2:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Обновите LDAP на компьютере 1:

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

Обновите компоненты Edge на компьютере 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
Обновите интерфейс на компьютере 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
```
(Если вы установили apigee-adminapi) Обновите утилиту apigee-adminapi на компьютере 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(Если вы установили Edge SSO) Обновите Edge SSO на компьютере 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
где sso_config_file – файл конфигурации, созданный при установке SSO.

Обновите PostgreSQL на компьютере 2:

Остановите серверы 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

Обновите компоненты Edge на компьютере 2:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

Перезапустите компонент Edge UI на компьютере 1:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```

Обновление до 5 узлов

Список топологий Edge и номеров узлов приведен в разделе Топологии установки.

Убедитесь, что вы установили новый резервный узел Postgres, как описано в разделе Установка нового резервного узла Postgres.
Если вы используете сетевое хранилище, устанавливать новый узел не нужно. Вместо этого сделайте снимок сети хранилища данных, используемого Postgres. Подробнее об обязательном обновлении до Postgres 9.6…
Обновите Cassandra и ZooKeeper на компьютерах 1, 2 и 3:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```

Обновите Qpid на компьютерах 4 и 5:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Обновите LDAP на компьютере 1:

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

Обновите компоненты Edge на компьютерах 1, 2 и 3:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
Обновите интерфейс на компьютере 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
```
(Если вы установили apigee-adminapi) Обновите утилиту apigee-adminapi на компьютере 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(Если вы установили Edge SSO) Обновите Edge SSO на компьютере 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
где sso_config_file – файл конфигурации, созданный при установке SSO.
Обновите компьютеры 4 и 5:
1. Остановите серверы Postgres и Qpid на компьютере 4:
```
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
```
2. Остановите сервер Postgres, сервер Qpid и postgresql на машине 5:
```
/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
```
3. Если они установлены, остановите сервер Postgres и postgresql на новом резервном узле, который вы добавили для отката:
```
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
```
4. Обновите postgresql на компьютерах 4:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
5. Обновите postgresql на компьютерах 5:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
6. Запустите сервер Postgres и сервер Qpid на компьютерах 4 и 5:
```
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
```
7. Настройте Postgres в качестве резервного узла, выполнив следующие команды на компьютере 5:
```
cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
```
8. Проверьте статус репликации, выполнив следующие скрипты на обоих серверах. Чтобы репликация прошла успешно, система должна показать одинаковые результаты на обоих серверах:
  - На компьютере 4 (главный узел) выполните следующую команду:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
```
    Убедитесь, что он является основным.
  - На компьютере 5 (резервный узел):
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
```
    Убедитесь, что он указан как резервный.
Обновите компоненты Edge на компьютерах 4 и 5:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
Выведите из эксплуатации новый резервный узел, как описано в разделе Вывод из эксплуатации узла Postgres.
Если вы используете сетевое хранилище, устанавливать новый узел не нужно. Подробнее об обязательном обновлении до Postgres 9.6…
Перезапустите компонент Edge UI на компьютере 1:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```

Обновление кластера из 9 узлов

Список топологий Edge и номеров узлов приведен в разделе Топологии установки.

Убедитесь, что вы установили новый резервный узел Postgres, как описано в разделе Установка нового резервного узла Postgres.
Если вы используете сетевое хранилище, устанавливать новый узел не нужно. Вместо этого сделайте снимок сети хранилища данных, используемого Postgres. Подробнее об обязательном обновлении до Postgres 9.6…
Обновите Cassandra и ZooKeeper на компьютерах 1, 2 и 3:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```

Обновите Qpid на компьютерах 6 и 7:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Обновите LDAP на компьютере 1:

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

Обновите компоненты Edge на компьютерах 6, 7, 1, 4 и 5 в указанном порядке:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
Обновите интерфейс на компьютере 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
```
(Если вы установили apigee-adminapi) Обновите утилиту apigee-adminapi на компьютере 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(Если вы установили Edge SSO) Обновите Edge SSO на компьютере 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
где sso_config_file – файл конфигурации, созданный при установке SSO.
Обновите компьютеры 8 и 9:
1. Остановите сервер Postgres на компьютере 8:
```
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
```
2. Остановите сервер Postgres и postgresql на машине 9:
```
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
```
3. Остановите сервер Qpid на компьютерах 6 и 7:
```
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
```
4. Если они установлены, остановите сервер Postgres и postgresql на новом резервном узле, который вы добавили для отката:
```
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
```
5. Обновите postgresql на компьютерах 8:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
6. Обновите postgresql на компьютерах 9:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
7. Запустите сервер Postgres на компьютерах 8 и 9:
```
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
```
8. Запустите сервер Qpid на компьютерах 6 и 7:
```
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
```
9. Настройте Postgres в качестве резервного узла, выполнив следующие команды на компьютере 9:
```
cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
```
10. Проверьте статус репликации, выполнив следующие скрипты на обоих серверах. Чтобы репликация прошла успешно, система должна показать одинаковые результаты на обоих серверах:
  - На компьютере 8 (главный узел) выполните следующую команду:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
```
    Убедитесь, что он является основным.
  - На компьютере 9 (резервный узел):
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
```
    Убедитесь, что он указан как резервный.
Обновите компоненты Edge на компьютерах 8 и 9:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
Выведите из эксплуатации новый резервный узел, как описано в разделе Вывод из эксплуатации узла Postgres.
Если вы используете сетевое хранилище, устанавливать новый узел не нужно. Подробнее об обязательном обновлении до Postgres 9.6…
Перезапустите компонент Edge UI на компьютере 1:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```

Обновление кластера из 13 узлов

Список топологий Edge и номеров узлов приведен в разделе Топологии установки.

Убедитесь, что вы установили новый резервный узел Postgres, как описано в разделе Установка нового резервного узла Postgres.
Если вы используете сетевое хранилище, устанавливать новый узел не нужно. Вместо этого сделайте снимок сети хранилища данных, используемого Postgres. Подробнее об обязательном обновлении до Postgres 9.6…
Обновите Cassandra и ZooKeeper на компьютерах 1, 2 и 3:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```

Обновите Qpid на компьютерах 12 и 13:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Обновите LDAP на компьютерах 4 и 5:

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

Обновите компоненты Edge на компьютерах 12, 13, 6, 7, 10 и 11 в указанном порядке:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
Обновите интерфейс на машинах 6 и 7:
```
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
```
(Если вы установили apigee-adminapi) Обновите утилиту apigee-adminapi на компьютерах 6 и 7:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(Если вы установили Edge SSO) Обновите Edge SSO на компьютерах 6 и 7:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
где sso_config_file – файл конфигурации, созданный при установке SSO.
Обновите компьютеры 8 и 9:
1. Остановите сервер Postgres на компьютере 8:
```
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
```
2. Остановите сервер Postgres и postgresql на машине 9:
```
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
```
3. Остановите сервер Qpid на компьютерах 12 и 13:
```
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
```
4. Если они установлены, остановите сервер Postgres и postgresql на новом резервном узле, который вы добавили для отката:
```
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
```
5. Обновите postgresql на компьютерах 8:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
6. Обновите postgresql на компьютерах 9:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
7. Запустите сервер Postgres на компьютерах 8 и 9:
```
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
```
8. Запустите сервер Qpid на компьютерах 12 и 13:
```
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
```
9. Настройте Postgres в качестве резервного узла, выполнив следующие команды на компьютере 9:
```
cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
```
10. Проверьте статус репликации, выполнив следующие скрипты на обоих серверах. Чтобы репликация прошла успешно, система должна показать одинаковые результаты на обоих серверах:
  - На компьютере 8 (главный узел) выполните следующую команду:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
```
    Убедитесь, что он является основным.
  - На компьютере 9 (резервный узел):
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
```
    Убедитесь, что он указан как резервный.
Обновите компоненты Edge на компьютерах 8 и 9:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
Выведите из эксплуатации новый резервный узел, как описано в разделе Вывод из эксплуатации узла Postgres.
Если вы используете сетевое хранилище, устанавливать новый узел не нужно. Подробнее об обязательном обновлении до Postgres 9.6…
Перезапустите компонент Edge UI на компьютерах 6 и 7:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```

Обновление кластера из 12 узлов

Список топологий Edge и номеров узлов приведен в разделе Топологии установки.

Убедитесь, что вы установили новый резервный узел Postgres, как описано в разделе Установка нового резервного узла Postgres.
Если вы используете сетевое хранилище, устанавливать новый узел не нужно. Вместо этого сделайте снимок сети хранилища данных, используемого Postgres. Подробнее об обязательном обновлении до Postgres 9.6…
Обновите Cassandra и ZooKeeper:
1. На машинах 1, 2 и 3 в центре обработки данных 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
2. На машинах 7, 8 и 9 в центре обработки данных 2
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
Обновите qpidd:
1. Машины 4 и 5 в центре обработки данных 1
  1. Обновите qpidd на компьютере 4:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
  2. Повторите шаг 1 на компьютере 5.
2. Машины 10 и 11 в центре обработки данных 2
  1. Обновление qpidd на компьютере 10:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
  2. Повторите шаг 1 на компьютере 11.
Обновление LDAP:
1. Машины 1 в центре обработки данных 1
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
2. Машины 7 в центре обработки данных 2
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
Обновите компоненты Edge:
1. Машины 4, 5, 1, 2, 3 в центре обработки данных 1
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
2. Машины 10, 11, 7, 8, 9 в центре обработки данных 2
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
Обновление интерфейса:
1. Компьютер 1 в центре обработки данных 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
```
2. Компьютер 7 в центре обработки данных 2:
```
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
```
(Если вы установили apigee-adminapi) Обновлена утилита apigee-adminapi:
1. Компьютер 1 в центре обработки данных 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
2. Компьютер 7 в центре обработки данных 2:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(Если вы установили Edge SSO) Обновите Edge SSO:
1. Компьютер 1 в центре обработки данных 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
2. Компьютер 7 в центре обработки данных 2:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
Обновите машину 6 в центре обработки данных 1 и машину 12 в центре обработки данных 2:
1. Остановите сервер Postgres на компьютере 6:
```
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
```
2. Остановите сервер Postgres и postgresql на машине 12:
```
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
```
3. Остановите сервер Qpid на компьютерах 4, 5, 10 и 11:
```
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
```
4. Если они установлены, остановите сервер Postgres и postgresql на новом резервном узле, который вы добавили для отката:
```
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
```
5. Обновите postgresql на машинах 6:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
6. Обновите postgresql на машинах 12:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
7. Запустите сервер Postgres на компьютерах 6 и 12:
```
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
```
8. Запустите сервер Qpid на компьютерах 4, 5, 10 и 11:
```
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
```
9. Настройте Postgres в качестве резервного узла, выполнив следующие команды на компьютере 12:
```
cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
```
10. Проверьте статус репликации, выполнив следующие скрипты на обоих серверах. Чтобы репликация прошла успешно, система должна показать одинаковые результаты на обоих серверах:
  На компьютере 6 (главном узле) выполните следующую команду:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
```
  Убедитесь, что он является основным.
  
  На компьютере 12 (резервный узел):
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
```
  Убедитесь, что он указан как резервный.
Обновите компоненты Edge на компьютерах 6 и 12:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
Выведите из эксплуатации новый резервный узел, как описано в разделе Вывод из эксплуатации узла Postgres.
Если вы используете сетевое хранилище, устанавливать новый узел не нужно. Подробнее об обязательном обновлении до Postgres 9.6…
Перезапустите компонент Edge UI на компьютерах 1 и 7:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```

Для нестандартного обновления

Если у вас нестандартная конфигурация, обновите компоненты Edge в следующем порядке:

ZooKeeper
Cassandra
qpidd, ps
LDAP
Edge, то есть профиль "-c edge" на всех узлах в следующем порядке: узлы с сервером Qpid, Edge Postgres Server, Management Server, Message Processor и Router.
Примечание. Если на узле установлены серверы Qpid и Postgres, выполните шаг профиля -c edge.
Интерфейс Edge
apigee-adminapi
Система единого входа Edge

После завершения обновления обязательно перезапустите компонент Edge UI на всех машинах, на которых он запущен.