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

Как обновить Apigee Edge с версии 4.50.00 или 4.51.00 до 4.52.00

Apigee поддерживает обновление Edge для Private Cloud с версии 4.50.00 или 4.51.00 напрямую до версии 4.52.00. В этой статье рассказывается, как выполнить оба типа обновления.

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

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

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

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

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

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

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

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

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

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

Требуется обновление до Zookeeper 3.8.0

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

Прежде чем обновлять Zookeeper, прочитайте руководство по обслуживанию Zookeeper. В большинстве производственных систем Edge используется кластер узлов Zookeeper, распределенный по нескольким центрам обработки данных. Некоторые из этих узлов настроены как голосующие, которые участвуют в выборах лидера Zookeeper, а остальные настроены как наблюдатели. Подробнее о лидерах, последователях, голосующих и наблюдателях… Узлы-избиратели выбирают лидера, после чего сами становятся ведомыми.

Во время обновления может возникнуть кратковременная задержка или сбой записи в Zookeeper, когда узел-лидер отключен. Это может повлиять на операции управления, которые записывают данные в Zookeeper, например на развертывание прокси-сервера, и на изменения инфраструктуры Apigee, например на добавление или удаление Message Processor. Если вы будете следовать приведенной ниже процедуре, обновление Zookeeper не должно повлиять на API среды выполнения Apigee (если только эти API среды выполнения не вызывают Management API).

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

Создайте резервную копию

Создайте резервную копию всех узлов ZooKeeper на случай, если потребуется откат. Обратите внимание, что при откате Zookeeper будет восстановлен до состояния, в котором он находился на момент создания резервной копии. Примечание. Любые развертывания или изменения инфраструктуры в Apigee, выполненные после создания резервной копии (информация о которых хранится в Zookeeper), будут потеряны во время восстановления.

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper backup

Если вы используете виртуальные машины и у вас есть такая возможность, вы также можете сделать снимки или резервные копии виртуальных машин для восстановления или отката (при необходимости).

Определите лидера, последователей и наблюдателей

Примечание. В примерах команд ниже используется утилита nc для отправки данных в Zookeeper. Для отправки данных в Zookeeper можно использовать и другие утилиты.

Если он не установлен на узле ZooKeeper, установите nc:
```
  sudo yum install nc
```
Выполните на узле следующую команду nc, где 2181 – это порт ZooKeeper:
```
  echo stat | nc localhost 2181
```
Вы должны увидеть примерно следующее:
```
  Zookeeper version: 3.8.0-5a02a05eddb59aee6ac762f7ea82e92a68eb9c0f, built on 2022-02-25 08:49 UTC
  Clients:
   /0:0:0:0:0:0:0:1:41246[0](queued=0,recved=1,sent=0)
  
  Latency min/avg/max: 0/0.2518/41
  Received: 647228
  Sent: 647339
  Connections: 4
  Outstanding: 0
  Zxid: 0x400018b15
  Mode: follower
  Node count: 100597
```
В строке Mode выходных данных для узлов вы должны увидеть observer, leader или follower (то есть голосующий узел, который не является лидером) в зависимости от конфигурации узла. Примечание. В автономной установке Edge с одним узлом ZooKeeper для Mode задано значение standalone.
Повторите шаги 1 и 2 на каждом узле ZooKeeper.

Обновите Zookeeper на узлах наблюдателя и подписчика

Обновите Zookeeper на каждом из узлов наблюдателя и подписчика следующим образом:

Скачайте и запустите начальную загрузку Edge для Private Cloud 4.52, как описано в разделе Обновление до версии 4.52.00 на узле с внешним подключением к интернету. Процесс, скорее всего, будет различаться в зависимости от того, есть ли у узла внешнее подключение к интернету или вы выполняете офлайн-установку.
Обновите компонент ZooKeeper:
```
  /opt/apigee/apigee-setup/bin/update.sh -c zk -f <silent-config-file>
```
Примечание. Если на этих узлах установлены другие компоненты (например, Cassandra), вы можете обновить их сейчас (как в случае с профилем cs,zk) или позже. Рекомендуем сначала обновить только Zookeeper и убедиться, что кластер работает правильно, а затем обновить другие компоненты.
Повторите описанные выше шаги для каждого из узлов наблюдателя и подписчика Zookeeper.

Устраните лидера

После обновления всех узлов наблюдателей и подписчиков отключите узел лидера. На узле, определенном как лидер, выполните следующую команду:

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

Обратите внимание, что во время этого события, до выбора нового лидера, в Zookeeper могут возникать кратковременные задержки или сбои записи. Это может повлиять на операции, которые записывают данные в Zookeeper, например на развертывание прокси-серверов или изменения инфраструктуры Apigee, такие как добавление или удаление процессоров сообщений и т. д.

Убедитесь, что выбран новый лидер

Выполните действия, описанные в разделе Как определить лидера, последователей и наблюдателей выше, и убедитесь, что после остановки существующего лидера был выбран новый лидер из последователей. Обратите внимание, что лидер мог быть выбран в другом центре обработки данных, отличном от текущего.

Лидер по обновлениям

Выполните те же действия, что и в разделе Обновление Zookeeper на узлах наблюдателя и подписчика выше.

После обновления старого узла-лидера проверьте состояние кластера и убедитесь, что узел-лидер существует.

Откат

Если вам потребуется выполнить откат:

Сначала выполните откат на наблюдателях и подписчиках.
Скачайте и запустите программу начальной загрузки для версии, к которой вы хотите вернуться (4.50 или 4.51). Процесс может различаться в зависимости от того, есть ли у узла внешнее подключение к интернету или вы выполняете офлайн-установку.
Остановите Zookeeper, если он запущен на узле:
```
  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop
```

Удалите существующий ZooKeeper:

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper uninstall

Установите Zookeeper как обычно:

  /opt/apigee/apigee-setup/bin/setup.sh -p zk -f <silent-config-file>

После отката всех ведомых и наблюдающих узлов выполните откат ведущего узла, следуя шагам 2–5 на ведущем узле.

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

Восстановление из резервной копии

Подробнее о том, как восстановить данные из резервной копии… Обратите внимание, что резервные копии Zookeeper, созданные в более ранних версиях Edge для частного облака, например 4.50 и 4.51, должны быть совместимы с версией Zookeeper в Edge для частного облака 4.52.

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

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

Большинство производственных систем 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.50.00 или 4.51.00), а не для версии 4.52.00.

Для установки используйте тот же файл конфигурации, который вы использовали для установки текущей версии 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. Если вы используете Edge 4.51.00:
  1. Скачайте файл bootstrap_4.51.00.sh для Edge в каталог /tmp/bootstrap_4.51.00.sh :
```
curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
```
  2. Установите утилиту Edge apigee-service и зависимости:
```
sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord
```
  Если вы используете Edge 4.50.00:
  1. Скачайте файл начальной загрузки Edge bootstrap_4.50.00.sh в каталог /tmp/bootstrap_4.50.00.sh :
```
curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
```
  2. Установите утилиту Edge apigee-service и зависимости:
```
sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord
```
4. Используйте apigee-service, чтобы установить утилиту apigee-setup:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
```
5. Установите Postgres:
```
/opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
```
6. На новом резервном узле выполните следующую команду:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
```
  Убедитесь, что это резервный экземпляр.

Выполнение обновления Postgres на месте

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

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

Откройте файл $APIGEE_ROOT/customer/application/postgresql.properties.
Удалите конфигурацию, связанную с wal_keep_segments.
Перезапустите Postgres.

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

Предварительный шаг

Прежде чем выполнять обновление Postgres на месте, выполните следующие действия на основном и резервном хостах, чтобы обновить свойство max_locks_per_transaction в apigee-postgresql:

Если файла /opt/apigee/customer/application/postgresql.properties нет, создайте его.
Передать право собственности на этот файл пользователю apigee:
```
sudo chown apigee:apigee /opt/apigee/customer/application/postgresql.properties
```
Добавьте в файл следующее свойство:
```
conf/postgresql.conf+max_locks_per_transaction=30000
```

Настройте apigee-postgresql:

apigee-service apigee-postgresql configure

Перезапустите apigee-postgresql:
```
apigee-service apigee-postgresql restart
```

Выполните обновление на месте

Чтобы выполнить обновление до Postgres 14, сделайте следующее:

Обновите Postgres на главном хосте

/opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf

Выполните команду настройки на главном хосте:
```
apigee-service apigee-postgresql setup -f /opt/silent.conf
```
Выполните команду настройки на главном хосте:
```
apigee-service apigee-postgresql configure
```
Перезапустите главный хост:
```
apigee-service apigee-postgresql restart
```

Настройте его как основное:

apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf

Убедитесь, что основной хост запущен:
```
apigee-service apigee-postgresql wait_for_ready
```
Чтобы отключить режим ожидания:
```
apigee-service apigee-postgresql stop
```
Обновите резервный экземпляр.
Примечание. Если на этом шаге произойдет ошибка, ее можно проигнорировать. update.sh попытается запустить резервный сервер с неправильной конфигурацией. Если Postgres обновлен до версии 14, ошибку можно игнорировать.
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
```
Убедитесь, что резервный сервер остановлен:
```
apigee-service apigee-postgresql stop
```
Удалите старую конфигурацию резервного сервера:
```
rm -rf /opt/apigee/data/apigee-postgresql/
```

Настройте репликацию на резервном сервере:

apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf

Удалите строку conf/postgresql.conf+max_locks_per_transaction=30000 из файла /opt/apigee/customer/application/postgresql.properties на основном и резервном хостах. Эта строка была добавлена на предварительном этапе.

После выполнения этой процедуры резервный сервер запустится.

Вывод узла 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
```

Действия после обновления для Postgres

После крупного обновления Postgres внутренняя статистика Postgres удаляется. Эти статистические данные помогают планировщику запросов Postgres использовать наиболее оптимальные индексы и пути для выполнения запросов.

Postgres может постепенно перестраивать статистику по мере выполнения запросов и работы демона autovacuum. Однако пока статистика не будет перестроена, запросы могут выполняться медленно.

Чтобы устранить эту проблему, выполните команду ANALYZE для всех таблиц в базе данных на главном узле Postgres. Вы также можете выполнить команду ANALYZE для нескольких таблиц одновременно.

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

Новый интерфейс Edge

В этом разделе перечислены соображения, касающиеся пользовательского интерфейса Edge. Дополнительную информацию можно найти в статье Новый интерфейс Edge для Private Cloud.

Установка Edge UI

После завершения первоначальной установки Apigee рекомендует установить Edge UI – улучшенный пользовательский интерфейс для разработчиков и администраторов Apigee Edge для частного облака.

Обратите внимание, что для Edge UI необходимо отключить базовую аутентификацию и использовать IDP, например SAML или LDAP.

Подробнее о том, как установить новый интерфейс Edge…

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

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

С версии 4.51.00 до 4.52.00 (с уже установленным новым интерфейсом Edge): используйте инструкции по обновлению в этом разделе для компонента edge-management-ui.

Обновление с помощью Apigee mTLS

Чтобы обновить Apigee mTLS , выполните следующие действия:

Как откатить обновление

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

Если сбой требует отката обновления до предыдущей версии, см. Откат до версии 4.52.00 для получения подробных инструкций.

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

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

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

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

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

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

Обновление без простоев, или последовательное обновление, позволяет обновить 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.50.00 или 4.51.00.

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

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

Если у вас есть задания cron, настроенные на выполнение операции восстановления в Cassandra, отключите их до завершения обновления.
Войдите в узел как root, чтобы установить Edge RPM.
Примечание. Для установки RPM требуется доступ с правами root, но вы можете настроить Edge без него.
Установите yum-utils и yum-plugin-priorities.
Примечание. Если вы используете операционную систему RHEL 8.0–8.6, пропустите этот шаг.
```
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.51.00:
1. Скачайте файл Edge bootstrap_4.52.00.sh в папку /tmp/bootstrap_4.52.00.sh:
```
curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
```
2. Установите утилиту Edge 4.52.00 apigee-service и зависимости, выполнив следующую команду:
```
sudo bash /tmp/bootstrap_4.52.00.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 самостоятельно.
3. Используйте apigee-service, чтобы обновить утилиту apigee-setup, как показано в примере ниже.
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
```
4. Обновите утилиту apigee-validate на сервере управления, как показано в примере ниже.
```
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
```
5. Обновите утилиту apigee-provision на сервере управления, как показано в примере ниже.
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
```
6. Запустите утилиту update на узлах, выполнив следующую команду:
```
/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
```
  в порядке, описанном в разделе Порядок обновления компьютеров.
  
  Где:
  - component – компонент Edge, который нужно обновить. Некоторые возможные значения:
    - cs: Кассандра
    - edge – все компоненты Edge, кроме Edge UI: Management Server, Message Processor, Router, QPID Server, Postgres Server.
    - ldap: OpenLDAP
    - ps: postgresql
    - qpid: qpidd
    - sso – Apigee SSO (если вы установили SSO).
    - ue: новый интерфейс Edge
    - ui: классический интерфейс Edge
    - zk: смотритель зоопарка
  - configFile – это тот же файл конфигурации, который вы использовали для определения компонентов Edge во время установки версии 4.50.00 или 4.51.00.
  Вы можете запустить update.sh для всех компонентов, установив для component значение "all", но только если у вас есть профиль установки Edge "все в одном" (AIO). Пример:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
```
7. Перезапустите компоненты Edge UI на всех узлах, на которых они запущены, если вы ещё этого не сделали:
```
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
```
8. Протестируйте обновление, запустив утилиту apigee-validate на сервере управления, как описано в разделе Тестирование установки.
Если вы решите откатить обновление, следуйте инструкциям в разделе Откат версии 4.52.00.

Обновление до версии 4.52.00 из локального репозитория

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

После создания локального хранилища Edge у вас есть два варианта обновления Edge из локального хранилища:
- Создайте TAR-файл репозитория, скопируйте его на узел и обновите Edge из этого файла.
- Установите веб-сервер на узел с локальным репозиторием, чтобы другие узлы могли получить к нему доступ. Apigee предоставляет веб-сервер Nginx, но вы можете использовать и собственный.
Чтобы выполнить обновление из локального хранилища 4.52.00:
1. Создайте локальное хранилище версии 4.52.00, как описано в разделе "Создание локального хранилища Apigee" в статье Установка утилиты apigee-setup для Edge.
  Примечание. Если у вас уже есть репозиторий, вы можете добавить в него репозиторий 4.52.00, как описано в разделе "Обновление локального репозитория Apigee" в статье Установка утилиты apigee-setup для Edge.
2. Чтобы установить apigee-service из TAR-файла, выполните следующие действия:
  1. На узле с локальным хранилищем используйте следующую команду, чтобы упаковать локальное хранилище в один файл .tar с именем /opt/apigee/data/apigee-mirror/apigee-4.52.00.tar.gz:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
```
  2. Скопируйте TAR-файл на узел, на котором вы хотите обновить Edge. Например, скопируйте его в каталог /tmp на новом узле.
  3. На новом узле распакуйте файл в каталог /tmp:
```
tar -xzf apigee-4.52.00.tar.gz
```
    Эта команда создает новый каталог с названием repos в каталоге, содержащем файл TAR. Пример: /tmp/repos.
  4. Установите утилиту Edge apigee-service и зависимости из /tmp/repos:
```
sudo bash /tmp/repos/bootstrap_4.52.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
```
    Обратите внимание, что в этой команде вы указываете путь к каталогу repos.
3. Чтобы установить apigee-service с помощью веб-сервера Nginx:
  1. Настройте веб-сервер Nginx, как описано в разделе "Установка из репозитория с помощью веб-сервера Nginx" в статье Как установить утилиту apigee-setup для Edge.
  2. На удаленном узле скачайте файл Edge bootstrap_4.52.00.sh в каталог /tmp/bootstrap_4.52.00.sh:
```
/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.sh
```
    где uName:pWord – имя пользователя и пароль, которые вы ранее задали для хранилища, а remoteRepo – IP-адрес или DNS-имя узла хранилища.
  3. На удаленном узле установите утилиту Edge apigee-setup и зависимости:
```
sudo bash /tmp/bootstrap_4.52.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
```
    где uName:pWord – имя пользователя и пароль для доступа к репозиторию.
4. Используйте apigee-service, чтобы обновить утилиту apigee-setup, как показано в примере ниже.
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update 
```
5. Обновите утилиту apigee-validate на сервере управления, как показано в примере ниже.
```
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
```
6. Обновите утилиту apigee-provision на сервере управления, как показано в примере ниже.
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
```
7. Запустите утилиту update на узлах в порядке, описанном в разделе Порядок обновления компьютеров.
```
/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
```
  Где:
  - component – компонент Edge, который нужно обновить. Обычно обновляются следующие компоненты:
    - cs: Кассандра
    - edge: все компоненты Edge, кроме Edge UI: Management Server, Message Processor, Router, QPID Server, Postgres Server.
    - ldap: OpenLDAP
    - ps: postgresql
    - qpid: qpidd
    - sso – Apigee SSO (если вы установили SSO).
    - ue Новый интерфейс Edge
    - ui: классический интерфейс Edge
    - zk: смотритель зоопарка
  - configFile – это тот же файл конфигурации, который вы использовали для определения компонентов Edge во время установки версии 4.50.00 или 4.51.00.
    Примечание. Файл конфигурации должен быть доступен для чтения пользователю apigee. Чтобы изменить владельца, используйте следующую команду:
    chown apigee:apigee configFile
  Вы можете запустить update.sh для всех компонентов, установив для component значение "all", но только если у вас есть профиль установки Edge "все в одном" (AIO). Пример:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
```
8. Перезапустите компоненты пользовательского интерфейса на всех узлах, на которых они запущены, если вы ещё этого не сделали:
```
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
```
9. Протестируйте обновление, запустив утилиту apigee-validate на сервере управления, как описано в разделе Тестирование установки.
Если вы решите откатить обновление, следуйте инструкциям в разделе Откат версии 4.52.00.

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

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

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

Чтобы обновить автономную конфигурацию с одним узлом до версии 4.52.00, выполните следующие действия:
1. Обновление всех компонентов:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
```
2. (Если вы установили apigee-adminapi) Обновлена утилита apigee-adminapi:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
Обновление автономного кластера с двумя узлами

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

Список топологий Edge и номеров узлов приведен в разделе Топологии установки.
1. Обновите Cassandra и ZooKeeper на компьютере 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
2. Обновите Qpid и Postgres на компьютере 2:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
```
3. Обновите LDAP на компьютере 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
4. Обновите компоненты Edge на компьютерах 2 и 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
5. Обновите интерфейс на компьютере 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
```
6. (Если вы установили apigee-adminapi) Обновите утилиту apigee-adminapi на компьютере 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
7. (Если вы установили Apigee SSO) Обновите Apigee SSO на компьютере 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
  где sso_config_file – файл конфигурации, созданный при установке SSO.
8. Перезапустите компонент Edge UI на компьютере 1:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
Обновление до 5 узлов

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

Список топологий Edge и номеров узлов приведен в разделе Топологии установки.
1. Обновите Cassandra и ZooKeeper на компьютерах 1, 2 и 3:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
2. Обновите Qpid и Postgres на компьютере 4:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
```
3. Обновите Qpid и Postgres на компьютере 5:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
```
4. Обновите LDAP на компьютере 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
5. Обновите компоненты Edge на компьютерах 4, 5, 1, 2, 3:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
6. Обновите интерфейс Edge:
  - Классический интерфейс. Если вы используете классический интерфейс, обновите компонент ui на компьютере 1, как показано в примере ниже.
```
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
```
  - Новый интерфейс Edge. Если вы установили новый интерфейс Edge, обновите компонент ue на соответствующем компьютере (это может быть не компьютер 1):
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
```
7. (Если вы установили apigee-adminapi) Обновите утилиту apigee-adminapi на компьютере 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
8. (Если вы установили Apigee SSO) Обновите Apigee SSO на компьютере 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
  где sso_config_file – файл конфигурации, созданный при установке SSO.
9. Перезапустите компонент интерфейса:
  - Классический интерфейс. Если вы используете классический интерфейс, перезапустите компонент edge-ui на компьютере 1, как показано в примере ниже.
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
  - Новый интерфейс Edge. Если вы установили новый интерфейс Edge, перезапустите компонент edge-management-ui на соответствующем компьютере (это может быть не компьютер 1):
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```
Обновление кластера из 9 узлов

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

Список топологий Edge и номеров узлов приведен в разделе Топологии установки.
1. Обновите Cassandra и ZooKeeper на компьютерах 1, 2 и 3:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
2. Обновите Qpid на компьютерах 6 и 7:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
3. Обновите Postgres на компьютере 8:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
4. Обновите Postgres на компьютере 9:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
5. Обновите LDAP на компьютере 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
6. Обновите компоненты Edge на компьютерах 6, 7, 8, 9, 1, 4 и 5 в указанном порядке:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
7. Обновите новый (ue) или классический (ui) интерфейс на компьютере 1.
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
8. (Если вы установили apigee-adminapi) Обновите утилиту apigee-adminapi на компьютере 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
9. (Если вы установили Apigee SSO) Обновите Apigee SSO на компьютере 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
  где sso_config_file – файл конфигурации, созданный при установке SSO.
10. Перезапустите компонент интерфейса:
  - Классический интерфейс. Если вы используете классический интерфейс, перезапустите компонент edge-ui на компьютере 1, как показано в примере ниже.
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
  - Новый интерфейс Edge. Если вы установили новый интерфейс Edge, перезапустите компонент edge-management-ui на соответствующем компьютере (это может быть не компьютер 1):
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```
Обновление кластера из 13 узлов

Обновите следующие компоненты для кластерной установки с 13 узлами:

Список топологий Edge и номеров узлов приведен в разделе Топологии установки.
1. Обновите Cassandra и ZooKeeper на компьютерах 1, 2 и 3:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
2. Обновите Qpid на компьютерах 12 и 13:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
3. Обновите Postgres на компьютере 8:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
4. Обновите Postgres на компьютере 9:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
5. Обновите LDAP на компьютерах 4 и 5:
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
6. Обновите компоненты Edge на машинах 12, 13, 8, 9, 6, 7, 10 и 11 в указанном порядке:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
7. Обновите новый (ue) или классический (ui) интерфейс на компьютерах 6 и 7.
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
8. (Если вы установили apigee-adminapi) Обновите утилиту apigee-adminapi на компьютерах 6 и 7:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
9. (Если вы установили Apigee SSO) Обновите Apigee SSO на компьютерах 6 и 7:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
  где sso_config_file – файл конфигурации, созданный при установке SSO.
10. Перезапустите компонент интерфейса:
  - Классический интерфейс. Если вы используете классический интерфейс, перезапустите компонент edge-ui на компьютерах 6 и 7, как показано в примере ниже.
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
  - Новый пользовательский интерфейс Edge. Если вы установили новый пользовательский интерфейс Edge, перезапустите компонент edge-management-ui на компьютерах 6 и 7:
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```
Обновление кластера из 12 узлов

Обновите следующие компоненты для кластерной установки с 12 узлами:

Список топологий Edge и номеров узлов приведен в разделе Топологии установки.
1. Обновите 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
```
2. Обновите qpidd:
  1. Машины 4 и 5 в центре обработки данных 1
    1. Обновите qpidd на компьютере 4:
      /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. Обновите qpidd на компьютере 5:
      /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  2. Машины 10 и 11 в центре обработки данных 2
    1. Обновление qpidd на компьютере 10:
      /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. Обновление qpidd на компьютере 11:
      /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
3. Обновите Postgres:
  1. Машина 6 в центре обработки данных 1
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
  2. Компьютер 12 в центре обработки данных 2
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
4. Обновление 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
```
5. Обновите компоненты Edge:
  1. Машины 4, 5, 6, 1, 2, 3 в центре обработки данных 1
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
  2. Машины 10, 11, 12, 7, 8, 9 в центре обработки данных 2
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
6. Обновите новый (ue) или классический (ui) интерфейс:
  1. Компьютер 1 в центре обработки данных 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
  2. Компьютер 7 в центре обработки данных 2:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
7. (Если вы установили 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
```
8. (Если вы установили Apigee SSO) Обновите Apigee 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
```
9. Перезапустите компонент нового (edge-management-ui) или классического (edge-ui) интерфейса Edge на компьютерах 1 и 7.
```
/opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart
```
Нестандартная конфигурация

Если у вас нестандартная конфигурация, обновите компоненты Edge в следующем порядке:
1. ZooKeeper
2. Cassandra
3. qpidd, ps
4. LDAP
5. Edge, то есть профиль "-c edge" на всех узлах в следующем порядке: узлы с сервером Qpid, Edge Postgres Server, Management Server, Message Processor и Router.
  Примечание. Если на узле установлены и сервер Qpid, и сервер Edge Postgres, выполните шаг профиля "-c edge".
6. Edge UI (классический или новый)
7. apigee-adminapi
8. Система единого входа Apigee
После завершения обновления обязательно перезапустите компонент Edge UI на всех машинах, на которых он запущен.