Эта страница переведена с помощью Cloud Translation API.

Обновите Apigee Edge 4.50.00 или 4.51.00 до 4.52.00.

Apigee поддерживает обновление Edge для частного облака с версии 4.50.00 или 4.51.00 непосредственно до версии 4.52.00. На этой странице описано, как выполнить любое обновление.

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

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

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

Какие компоненты необходимо обновить

Вам необходимо обновить все компоненты 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, такие как добавление или удаление обработчика сообщений и т. д. Это не должно влиять на API-интерфейсы времени выполнения Apigee (за исключением случаев, когда эти API-интерфейсы времени выполнения API управления вызовами) во время обновления Zookeeper, следуя приведенной ниже процедуре.

На высоком уровне процесс обновления включает в себя создание резервной копии каждого узла. За этим следует обновление всех наблюдателей и последователей и, наконец, обновление узла-лидера.

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

Сделайте резервную копию всех узлов 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 выходных данных для узлов вы должны увидеть наблюдателя, лидера или последователя (то есть избирателя, который не является лидером) в зависимости от конфигурации узла. Примечание. В автономной установке Edge с одним узлом ZooKeeper для Mode .
Повторите шаги 1 и 2 на каждом узле ZooKeeper.

Обновите Zookeeper на узлах наблюдателя и ведомого.

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

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

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

Если вы используете локальное хранилище данных для своих узлов Postgres , вам необходимо установить новый резервный узел Postgres на время обновления. После завершения обновления вы можете вывести из эксплуатации новый резервный узел Postgres.
Дополнительный резервный узел Postgres потребуется, если вам по какой-либо причине придется откатить обновление. Если вам необходимо выполнить откат обновления, новый резервный узел Postgres после отката станет главным узлом Postgres. Таким образом, когда вы устанавливаете новый резервный узел Postgres, он должен находиться на узле, который соответствует всем аппаратным требованиям сервера Postgres, как определено в требованиях к пограничной установке .
В конфигурации Edge с 1 и 2 узлами, топологии, используемой для прототипирования и тестирования, у вас есть только один узел 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, как описано в разделе Установка утилиты Edge apigee-setup .
3. Если вы сейчас используете Edge 4.51.00:
  1. Загрузите файл Edge bootstrap_4.51.00.sh в /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. Установите Постгрес:
```
/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 параметр конфигурации Postgres wal_keep_segments больше не поддерживается. Если вы добавили или изменили этот параметр Postgres, вам необходимо удалить его перед выполнением обновления Postgres. Для этого:

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

Обратитесь к документации 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, выполнив следующий вызов API управления Edge на узле Management Server:
```
curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid
```

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

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

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

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

ПРИМЕЧАНИЕ. Выполнение ANALYZE может занять много времени, но для этого требуется только блокировка чтения таблицы, позволяющая другим операциям в Postgres продолжать выполнение во время работы ANALYZE .

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

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

Установите пользовательский интерфейс Edge

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

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

Дополнительные сведения см. в разделе Установка нового пользовательского интерфейса Edge .

Обновите пользовательский интерфейс Edge

Чтобы обновить компонент пользовательского интерфейса Edge, рассмотрите версию 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 без отключения Edge.

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

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

Обновите компьютеры в порядке, соответствующем вашей установке, как описано в разделе «Порядок обновления компьютеров» .
Когда придет время обновить маршрутизаторы, выберите любой маршрутизатор и сделайте его недоступным, как описано в разделе «Включение/отключение доступности сервера (процессора сообщений/маршрутизатора)» .
Обновите выбранный маршрутизатор и все другие компоненты Edge на том же компьютере, что и маршрутизатор. Во всех конфигурациях Edge маршрутизатор и процессор сообщений расположены на одном узле.
Снова сделайте маршрутизатор доступным.
Повторите шаги 2–4 для остальных маршрутизаторов.
Продолжите обновление для всех оставшихся компьютеров в вашей установке.

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

На объединенном узле маршрутизатора и процессора сообщений:
- Перед обновлением выполните следующее:
  1. Сделайте маршрутизатор недоступным.
  2. Сделайте процессор сообщений недоступным.
- После обновления – выполните следующее:
  1. Сделайте процессор сообщений доступным.
  2. Сделайте маршрутизатор доступным.
На отдельных узлах маршрутизатора:
- Перед обновлением сделайте маршрутизатор недоступным .
- После обновления сделайте маршрутизатор доступным .
На отдельных узлах процессора сообщений:
- Перед обновлением сделайте процессор сообщений недоступным .
- После обновления сделайте процессор сообщений доступным .

Используйте тихий файл конфигурации

Вы должны передать файл конфигурации в автоматическом режиме команде обновления. Файл автоматической конфигурации должен быть тем же, который вы использовали для установки Edge 4.50.00 или 4.51.00.

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

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

Если они есть, отключите все задания cron , настроенные для выполнения операции восстановления в Cassandra, до завершения обновления.
Войдите на свой узел как root, чтобы установить Edge RPM.
ПРИМЕЧАНИЕ. Хотя для установки RPM требуется root-доступ, вы можете выполнить настройку Edge без root-доступа.
Установите yum-utils и yum-plugin-priorities :
Примечание. Если ваша операционная система RHEL 8.0–8.6, пропустите этот шаг.
```
sudo yum install yum-utils
sudo yum install yum-plugin-priorities
```
Отключите SELinux, как описано в разделе Установка утилиты Edge apigee-setup .
Если вы устанавливаете 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. Установите утилиту apigee-service Edge 4.52.00 и зависимости, выполнив следующую команду:
```
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: сервер управления, процессор сообщений, маршрутизатор, сервер QPID, сервер Postgres.
    - ldap : OpenLDAP
    - ps : постгреск
    - qpid : qpidd
    - sso : Apigee SSO (если вы установили SSO)
    - ue : новый интерфейс Edge
    - ui : Классический интерфейс Edge.
    - zk : Смотритель зоопарка
  - configFile — это тот же файл конфигурации, который вы использовали для определения компонентов Edge во время установки 4.50.00 или 4.51.00.
  Вы можете запустить update.sh для всех компонентов, задав для component значение «все», но только если у вас есть профиль установки Edge «все в одном» (AIO). Например:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
```
7. Перезапустите компоненты пользовательского интерфейса Edge на всех узлах, на которых они выполняются, если вы еще этого не сделали:
```
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
```
8. Проверьте обновление, запустив утилиту apigee-validate на сервере управления, как описано в разделе «Проверка установки» .
Если позже вы решите откатить обновление, воспользуйтесь процедурой, описанной в разделе «Откат 4.52.00» .
Обновление до 4.52.00 из локального репозитория.
Если ваши пограничные узлы находятся за брандмауэром или каким-либо другим образом им запрещен доступ к репозиторию Apigee через Интернет, вы можете выполнить обновление из локального репозитория или зеркала репозитория Apigee.
После создания локального репозитория Edge у вас есть два варианта обновления Edge из локального репозитория:
- Создайте файл .tar репозитория, скопируйте файл .tar на узел, а затем обновите Edge из файла .tar.
- Установите веб-сервер на узле с локальным репозиторием, чтобы другие узлы могли получить к нему доступ. Apigee предоставляет вам веб-сервер Nginx, или вы можете использовать свой собственный веб-сервер.
Чтобы обновиться из локального репозитория 4.52.00:
1. Создайте локальный репозиторий 4.52.00, как описано в разделе «Создание локального репозитория Apigee» в разделе «Установка утилиты Edge apigee-setup» .
  ПРИМЕЧАНИЕ. Если у вас уже есть существующий репозиторий, вы можете добавить к нему репозиторий 4.52.00, как описано в разделе «Обновление локального репозитория Apigee» в разделе «Установка утилиты Edge apigee-setup» .
2. Чтобы установить сервис apigee из файла .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
```
    Обратите внимание, что в эту команду вы включаете путь к каталогу репозитория.
3. Чтобы установить сервис apigee с помощью веб-сервера Nginx:
  1. Настройте веб-сервер Nginx, как описано в разделе «Установка из репозитория с помощью веб-сервера Nginx» в разделе «Установка утилиты Edge apigee-setup» .
  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: сервер управления, процессор сообщений, маршрутизатор, сервер QPID, сервер Postgres.
    - ldap : OpenLDAP
    - ps : постгреск
    - 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 значение «все», но только если у вас есть профиль установки 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, прежде чем обновлять любые другие узлы.
- Для любого компьютера с несколькими пограничными компонентами (сервер управления, процессор сообщений, маршрутизатор, сервер QPID, но не сервер Postgres) используйте параметр -c edge , чтобы обновить их все одновременно.
- Если для шага указано, что его следует выполнить на нескольких компьютерах, выполните его в указанном порядке компьютеров.
- Отдельного шага по обновлению монетизации не требуется. Он обновляется, когда вы указываете опцию -c edge .
ПРИМЕЧАНИЕ. После обновления компонента пользовательского интерфейса Edge необходимо перезапустить службу пользовательского интерфейса Edge, как описано в инструкциях по установке обновления.
Автономное обновление на 1 узел
Чтобы обновить автономную конфигурацию с 1 узлом до версии 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
```
2-узловое автономное обновление
Обновите следующие компоненты для автономной установки с двумя узлами:
Список топологий 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-узловое обновление
Обновите следующие компоненты для установки с 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-узловое кластерное обновление
Обновите следующие компоненты для кластерной установки из 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. Обновите Кассандру и 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. Обновить Постгрес:
  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 UI ( edge-management-ui ) или классический Edge UI ( edge-ui ) на машинах 1 и 7:
```
/opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart
```
Для нестандартной конфигурации
Если у вас есть нестандартная конфигурация, то обновляйте компоненты края в следующем порядке:
1. Зокепер
2. Кассандра
3. qpidd, ps
4. LDAP
5. EDGE, что означает профиль «-c Edge» на всех узлах в порядке: узлы с сервером QPID, сервером Edge Postgres, сервером управления, процессором сообщений и маршрутизатором.
  Примечание. Если узел установлен как QPID-сервер, так и сервер Edge Postgres, запустите шаг профиля «-c Edge».
6. Edge UI (классический или новый)
7. apigee-adminapi
8. Apigee SSO
После того, как вы закончите обновление, обязательно перезагрузите компонент пользовательского интерфейса Edge на всех машинах, использующих его.
,
Apigee поддерживает обновление Edge для частного облака из версии 4.50.00 или версии 4.51.00 непосредственно до версии 4.52.00. На этой странице описывается, как выполнить обновление.
Осторожно: если вам нужно добавить центр обработки данных, а также обновить Edge Apigee, вы должны выполнить эти действия в отдельных процедурах. Завершите одну процедуру, прежде чем начать другую.
Кто может выполнить обновление
Человек, управляющий обновлением, должен быть таким же, как человек, который первоначально установил Edge, или человека, работающего в качестве корня.
После установки оборотов Edge любой может их настроить.
Какие компоненты вы должны обновить
Вы должны обновить все компоненты Edge. Edge не поддерживает настройку, которая содержит компоненты из нескольких версий.
Примечание. Если вы установили Apigee на Red Hat Enterprise Linux (RHEL) 6.10, вам сначала необходимо обновить RHEL до одной из следующих версий: 7,5, 7,6, 7,7, 7,8, 7,9, 8,0, 8,1, 8,2, 8,3, 8,4, 8,5 , или 8,6. См . Обновление Red Hat Enterprise Linux .
Обновить предпосылки
Убедитесь, что в следующих предпосылках перед модернизацией Apigee Edge:
- Резервное копирование всех узлов
  Перед тем, как обновить, мы рекомендуем вам выполнить полное резервное копирование всех узлов по соображениям безопасности. Используйте процедуру для вашей текущей версии Edge, чтобы выполнить резервную копию.
  Это позволяет вам иметь план резервного копирования, если обновление новой версии не работает должным образом. Для получения дополнительной информации о резервном копировании см. Резервное копирование и восстановить .
- Убедитесь, что Edge работает
  Убедитесь, что Edge работает и работает во время процесса обновления, используя команду:
```
/opt/apigee/apigee-service/bin/apigee-all status
```
- Убедитесь, что стратегия Cassandra Comptification 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 . Большинство систем производства краев используют кластер узлов зооучели, распределенные по нескольким центрам обработки данных. Некоторые из этих узлов настроены как избиратели, которые участвуют в выборах лидера Zookeeper, а остальные настроены как наблюдатели. Смотрите о лидерах, последователях, избирателях и наблюдателях для получения более подробной информации. Узлы избирателей выбирают лидера, после чего сами избиратели сами становятся последователями.
Во время процесса обновления может быть мгновенная задержка или сбой записи в Zookeeper, когда узел лидера выключается. Это может повлиять на операции управления, которые записываются в Zookeeper, такие как операция развертывания прокси и изменения инфраструктуры Apigee, такие как добавление или удаление процессора сообщений и т. Д. API -интерфейсы управления вызовом) во время обновления Zookeeper, выполняя процедуру ниже.
На высоком уровне процесс обновления включает в себя резервную копию каждого узла. За этим следует модернизация всех наблюдателей и последователей и, наконец, модернизация лидера.
Возьмите резервную копию
Возьмите резервную копию всех узлов Zookeeper для использования в случае, если требуется откат. Обратите внимание, что откат восстановит Zookeeper в штат, когда была взята резервная копия. Примечание. Любые развертывания или изменения инфраструктуры в Apigee, так как резервная копия была взята (чья информация хранится в Zookeeper), будут потеряны во время восстановления.
```
  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper backup
```
Если вы используете виртуальные машины и имеете возможность, моментальные снимки или резервные копии VM также могут быть приняты для восстановления или отката (при необходимости).
Определите лидера, последователей и наблюдателей
ПРИМЕЧАНИЕ. Приведенные ниже команды используют утилиту NC для отправки данных в Zookeeper. Вы также можете использовать альтернативные утилиты для отправки данных в Zookeeper.
1. Если он не установлен на узле Zookeeper, установите NC:
```
  sudo yum install nc
```
2. Запустите следующую команду 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 вывода для узлов вы должны увидеть наблюдателя, лидера или последователя (то есть избиратель, который не является лидером) в зависимости от конфигурации узла. ПРИМЕЧАНИЕ. В автономной установке Edge с одним узлом зоокета Mode установлен в автономном отношении.
3. Повторите шаги 1 и 2 на каждом узле Zookeeper.
Обновление Zookeeper на узлах наблюдателя и последователей
Обновите Zookeeper на каждом из узлов наблюдателя и последователей следующим образом:
1. Загрузите и запустите начальную загрузку Edge для частного облака 4.52, как описано в обновлении до 4.52.00 на узле с внешним подключением к Интернету . Процесс, вероятно, будет варьироваться в зависимости от того, имеет ли узел внешнее подключение к Интернету или вы выполняете автономную установку.
2. Обновите компонент Zookeeper:
```
  /opt/apigee/apigee-setup/bin/update.sh -c zk -f <silent-config-file>
```
  Примечание. Если в этих узлах установлены другие компоненты (такие как Cassandra), вы также можете обновить их сейчас (например, с CS, ZK Profile), или вы можете обновить другие компоненты позже. Apigee рекомендует сначала обновить Zookeeper и убедиться, что ваш кластер работает должным образом перед модернизацией других компонентов.
3. Повторите выше шаги на каждом из узлов наблюдателя Zookeeper и последователей.
Закрыть лидера
Как только все узлы наблюдателей и последователей были обновлены, остановите лидера. На узле, идентифицированном как лидер, запустите команду ниже:
```
  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop
```
Обратите внимание, что во время этого события, прежде чем избрать новый лидер, в Zookeeper могут быть мгновенные задержки или сбои писать. Это может повлиять на операции, которые записываются в Zookeeper, такие как действие развертывания прокси или изменений инфраструктуры Apigee, таких как добавление или удаление процессоров сообщений и т. Д.
Убедитесь, что новый лидер избран
Используя шаги в разделе идентификации лидера, последователей и наблюдателей выше, убедитесь, что у подписчиков был избран новый лидер, как только существующий лидер остановлен. Обратите внимание, что лидер мог быть избран в другом центре обработки данных, чем текущий лидер.
Обновление лидера
Следуйте тем же шагам, что и при обновлении Zookeeper на узлах наблюдателя и последователей выше.
После того, как старый лидер обновляется, проверьте здоровье кластера и убедитесь, что есть узел лидера.
Откат
В случае, если требуется откат:
1. Сначала выполните оперативные шаги на наблюдателей и подписчиках.
2. Загрузите и выполните начальную загрузку версии, на которую вы возвращаетесь - либо 4.50, либо 4.51. Процесс, вероятно, будет варьироваться в зависимости от того, имеет ли узел внешнее подключение к Интернету или вы следите за автономной установкой.
3. Остановите Zookeeper, если он работает на узле:
```
  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop
```
4. Удалить существующий 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.

Требуется обновление до 14 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 1-node и 2-node топологий, используемых для прототипирования и тестирования, у вас есть только один узел Postgres. Вы можете обновить эти узлы Postgres напрямую без необходимости создавать новый узел Postgres.
Если вы используете сетевое хранилище для своих узлов Postgres , как рекомендовано Apigee, вам не нужно устанавливать новый узел Postgres. В приведенных ниже процедурах вы можете пропустить шаги, которые указывают на установку, а затем выводят из эксплуатации новый режим ожидания Postgres.
Прежде чем начать процесс обновления, сделайте сетевой снимок хранилища данных, используемых Postgres. Затем, если во время обновления возникают какие -либо ошибки, и вы вынуждены выполнить откат, вы можете восстановить узел Postgres из этого снимка.

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

Эта процедура создает резервный сервер Postgres на новом узле. Убедитесь, что вы установите новый STEDSBY Server Postgres для вашей существующей версии Edge (4.50.00 или 4.51.00), а не для версии 4.52.00.

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

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

На текущем мастере Postgres отредактируйте файл /opt/apigee/customer/application/postgresql.properties 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 Master:

/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart

Убедитесь, что новый резервный узел был добавлен путем просмотра файла /opt/apigee/apigee-postgresql/conf/pg_hba.conf pg_hba.conf на мастере. Вы должны увидеть следующие строки в этом файле:
```
host replication apigee existing_standby_ip/32 trust
host replication apigee new_standby_ip/32 trust
```
Установите новый Stenby Server 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, как описано в установке Edge Apigee-Setup утилита .
3. Если вы в настоящее время на грани 4.51.00:
  1. Загрузите файл Edge Bootstrap_4.51.00.sh в файл /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
```
  Если вы в настоящее время на грани 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 параметр конфигурации Postgres wal_keep_segments больше не поддерживается. Если вы добавили или изменили этот параметр Postgres, вы должны удалить его перед выполнением обновления Postgres. Для этого:

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

Обратитесь к документации 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
```

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

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

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

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

Запустите команду Setup на главном хосте:
```
apigee-service apigee-postgresql setup -f /opt/silent.conf
```
Запустите команду Configure на главном хосте:
```
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 Master:

/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart

Убедитесь, что новый резервный узел был удален путем просмотра файла /opt/apigee/apigee-postgresql/conf/pg_hba.conf pg_hba.conf на мастере. Вы должны увидеть только следующую строку в этом файле:
```
host replication apigee existing_standby_ip/32 trust
```
Удалить UUID резервного узла из Zookeeper, сделав следующий вызов API управления Edge на узле сервера управления:
```
curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid
```

Шаги после обновления для Postgres

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

Postgres может постепенно перестроить свою статистику с течением времени по мере выполнения запросов и когда работает Daemon Autovacuum. Однако до тех пор, пока статистика не будет перестроена, ваши запросы могут быть медленными.

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

ПРИМЕЧАНИЕ. ANALYZE может занять много времени, но он требует только блокировки чтения на таблице, что позволяет другим операциям на Postgres продолжать выполнять во время работы ANALYZE .

Новый Edge UI

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

Установите интерфейс Edge

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

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

Для получения дополнительной информации см. Установите новый интерфейс Edge .

Обновите пользовательский интерфейс Edge

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

От 4,51,00 до 4,52,00 (с уже установленным пользовательским интерфейсом Edge): используйте инструкции по обновлению в этом разделе для компонента edge-management-ui .

Обновление с Apigee MTLS

Чтобы обновить Apigee MTLS , сделайте следующие шаги:

Отказ от обновления

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

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

Информация об обновлении журнала

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

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

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

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

Обновление нулевого времени

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

Обновление с нулевым временем возможно только с 5-узловой конфигурацией и больше.

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

Обновите машины в правильном порядке для вашей установки, как описано порядок обновления машины .
Когда пришло время обновлять маршрутизаторы, выберите любой маршрутизатор и сделайте его недоступным, как описано при включении/отключении сервера (процессор сообщений/маршрутизатора) .
Обновите выбранный маршрутизатор и все другие компоненты края на той же машине, что и маршрутизатор. Все конфигурации Edge показывают маршрутизатор и процессор сообщений на одном узле.
Сделайте маршрутизатор снова доступным снова.
Повторите шаги с 2 по 4 для оставшихся маршрутизаторов.
Продолжайте обновление для любых оставшихся машин в вашей установке.

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

На узле комбинированного маршрутизатора и процессора сообщений:
- Перед обновлением - выполните следующее:
  1. Сделайте маршрутизатор недоступным.
  2. Сделайте процессор сообщений недоступным.
- После обновления - выполните следующее:
  1. Сделайте процессор сообщений доступным.
  2. Сделайте маршрутизатор доступным.
На одном маршрутизаторе узлы:
- Перед обновлением, сделайте маршрутизатор недоступным .
- После обновления, сделайте маршрутизатор доступным .
На узлах процессора отдельных сообщений:
- Перед обновлением, сделайте процессор сообщений недоступным .
- После обновления, сделайте процессор сообщений доступным .

Используйте тихий файл конфигурации

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

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

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

Если присутствовать, отключите любые задания cron , настроенные для выполнения операции по ремонту на Cassandra до тех пор, пока не завершится обновление.
Войдите в свой узел как root, чтобы установить края обороты.
ПРИМЕЧАНИЕ. В то время как установка RPM требует доступа к корнеу, вы можете выполнить конфигурацию края без доступа к корнеу.
Установите yum-utils и yum-plugin-priorities :
Примечание. Если ваша операционная система - RHEL 8.0 - 8.6, пропустите этот шаг.
```
sudo yum install yum-utils
sudo yum install yum-plugin-priorities
```
Отключите Selinux, как описано в установке Edge Apigee-Setup утилита .
Если вы устанавливаете на 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

Если вы в настоящее время на грани 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 является краевым компонентом для обновления. Возможные значения включают:
    - cs : Кассандра
    - edge : Все компоненты края, кроме Edge UI: сервер управления, процессор сообщений, маршрутизатор, сервер QPID, Postgres Server
    - ldap : OpenLDAP
    - ps : Postgresql
    - qpid : QPIDD
    - sso : Apigee SSO (если вы установили SSO)
    - ue : New Edge UI
    - ui : классический интерфейс Edge
    - zk : Zookeeper
  - configFile - это тот же файл конфигурации, который вы использовали для определения ваших краевых компонентов во время установки 4.50.00 или 4.51.00.
  Вы можете запустить update.sh против всех компонентов, установив component на «All», но только если у вас есть профиль установки All-In-One (AIO). Например:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
```
7. Перезапустите компоненты пользовательского интерфейса Edge на всех узлах, управляющих их, если вы еще этого не сделали:
```
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
```
8. Проверьте обновление, запустив утилиту apigee-validate на сервере управления, как описано при тестировании установки .
Если вы позже решите отменить обновление, используйте процедуру, описанную в Roll Back 4.52.00 .
Обновление до 4.52.00 от локального репо
Если ваши краевые узлы находятся за брандмауэром, или каким -то другим способом запрещается получить доступ к репозиторию Apigee через Интернет, то вы можете выполнить обновление из локального репозитория или зеркала, из Apigee Repo.
После создания локального репозитория Edge у вас есть два варианта обновления Edge от Local Repo:
- Создайте файл .tar репо, скопируйте файл .tar в узле, а затем обновите край из файла .tar.
- Установите веб -сервер на узле с локальным репо, чтобы другие узлы могли получить к нему доступ. Apigee предоставляет Nginx Webserver для использования, или вы можете использовать свой собственный веб -сервер.
Обновить из локального репо 4.52.00:
1. Создайте локальный репо 4.52.00, как описано в «Создайте локальный репозиторий Apigee», в установке Edge Apigee-Setup утилита .
  Примечание. Если у вас уже есть существующий репо, вы можете добавить к нему 4.52.00 репо, как описано в «Обновление локального репозитория Apigee» при установке утилиты Apigee-Setup .
2. Чтобы установить Apigee-Service из файла .tar :
  1. На узле с локальным репо, используйте следующую команду, чтобы упаковать локальный репо в один файл .tar с именем /opt/apigee/data/apigee-mirror/apigee-4.52.00.tar.gz -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 Webserver:
  1. Настройте веб-сервер NGINX, как описано в «Утилита« Установить из репо с использованием NGINX Webserver », на установке Edge Apigee-Setup .
  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 является краевым компонентом для обновления. Вы обычно обновляете следующие компоненты:
    - cs : Кассандра
    - edge : Все компоненты края, кроме Edge UI: сервер управления, процессор сообщений, маршрутизатор, сервер QPID, Postgres Server
    - ldap : OpenLDAP
    - ps : Postgresql
    - qpid : QPIDD
    - sso : Apigee SSO (если вы установили SSO)
    - ue New Edge UI
    - ui : классический интерфейс Edge
    - zk : Zookeeper
  - configFile - это тот же файл конфигурации, который вы использовали для определения ваших краевых компонентов во время установки 4.50.00 или 4.51.00.
    ПРИМЕЧАНИЕ. Файл конфигурации должен быть читаемым пользователем «Apigee». Чтобы изменить владельца, используйте следующую команду:
    chown apigee:apigee configFile
  Вы можете запустить update.sh против всех компонентов, установив component на «All», но только если у вас есть профиль установки All-In-One (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 на сервере управления, как описано при тестировании установки .
Если вы позже решите отменить обновление, используйте процедуру, описанную в Roll Back 4.52.00 .
Порядок обновления машины
Порядок, который вы обновляете машины в установке края, важен:
- Вы должны обновить все узлы Cassandra и Zookeeper, прежде чем обновлять любые другие узлы.
- Для любой машины с несколькими краевыми компонентами (сервер управления, процессор сообщений, маршрутизатор, QPID -сервер, но не сервер Postgres), используйте параметр -c edge , чтобы обновить их все одновременно.
- Если на шаге указывается, что его следует выполнять на нескольких машинах, выполните его в указанном порядке машины.
- Нет отдельного шага для обновления монетизации. Он обновляется, когда вы указываете опцию -c edge .
ПРИМЕЧАНИЕ. После обновления компонента пользовательского интерфейса Edge вы должны перезапустить сервис пользовательского интерфейса Edge, как описано в инструкциях по установке обновления.
1-узловое автономное обновление
Чтобы обновить 1-узлу автономную конфигурацию до 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
```
2-узловое автономное обновление
Обновите следующие компоненты для автономной установки с 2 узлами:
См. Топологии установки для списка топологий края и номеров узлов.
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. Обновлять компоненты края на машине 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 на машине 1:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
5-узловое обновление
Обновите следующие компоненты для 5-узловой установки:
См. Топологии установки для списка топологий края и номеров узлов.
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. Обновления края компонентов на машине 4, 5, 1, 2, 3:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
6. Обновите пользовательский интерфейс:
  - Классический пользовательский интерфейс: если вы используете классический пользовательский интерфейс, то обновите компонент ui на машине 1, как показано в следующем примере:
```
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
```
  - New Edge UI: если вы установили новый Edge UI, то обновите компонент 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
```
  - New Edge UI: если вы установили новый Edge UI, перезапустите компонент edge-management-ui на соответствующей машине (не может быть машиной 1):
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```
9-узловая кластерная обновление
Обновите следующие компоненты для 9-узловой кластерной установки:
См. Топологии установки для списка топологий края и номеров узлов.
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. Обновлять края компонентов на машине 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
```
  - New Edge UI: если вы установили новый Edge UI, перезапустите компонент edge-management-ui на соответствующей машине (не может быть машиной 1):
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```
13-узловая кластерная обновление
Обновите следующие компоненты для 13-узловой кластерной установки:
См. Топологии установки для списка топологий края и номеров узлов.
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. Обновления края компонентов на машинах 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
```
  - New Edge UI: если вы установили новый Edge UI, перезапустите компонент edge-management-ui на машинах 6 и 7:
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```
12-узловая кластерная обновление
Обновите следующие компоненты для 12-узловой кластерной установки:
См. Топологии установки для списка топологий края и номеров узлов.
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. Machine 6 in Data Center 1
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
  2. Machine 12 in Data Center 2
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
4. Update LDAP:
  1. Machine 1 in Data Center 1
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
  2. Machine 7 in Data Center 2
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
5. Update Edge components:
  1. Machines 4, 5, 6, 1, 2, 3 in Data Center 1
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
  2. Machines 10, 11, 12, 7, 8, 9 in Data Center 2
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
6. Update either the new UI ( ue ) or classic UI ( ui ):
  1. Machine 1 in Data Center 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
  2. Machine 7 in Data Center 2:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
7. (If you installed apigee-adminapi ) Updated the apigee-adminapi utility:
  1. Machine 1 in Data Center 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
  2. Machine 7 in Data Center 2:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
8. (If you installed Apigee SSO) Update Apigee SSO:
  1. Machine 1 in Data Center 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
  2. Machine 7 in Data Center 2:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
9. Restart the new Edge UI ( edge-management-ui ) or classic Edge UI ( edge-ui ) component on machines 1 and 7:
```
/opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart
```
For a non-standard configuration
If you have a non-standard configuration, then update Edge components in the following order:
1. Зокепер
2. Кассандра
3. qpidd, ps
4. LDAP
5. Edge, meaning the "-c edge" profile on all nodes in the order: nodes with Qpid server, Edge Postgres Server, Management Server, Message Processor, and Router.
  NOTE: If a node has both Qpid server and Edge Postgres Server installed, run the "-c edge" profile step.
6. Edge UI (either classic or new)
7. apigee-adminapi
8. Apigee SSO
After you finish updating, be sure to restart the Edge UI component on all machines running it.

Обновите Apigee Edge 4.50.00 или 4.51.00 до 4.52.00.

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

Какие компоненты необходимо обновить

Обновить необходимые условия

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

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

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

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

Обновите Zookeeper на узлах наблюдателя и ведомого.

Выключение лидера

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

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

Откат

Восстановить резервную копию

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

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

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

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

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

Вывод из эксплуатации узла Postgres

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

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

Установите пользовательский интерфейс Edge

Обновите пользовательский интерфейс Edge

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

Откат обновления

Регистрация информации об обновлении

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

Используйте тихий файл конфигурации

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

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

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

Автономное обновление на 1 узел

2-узловое автономное обновление

5-узловое обновление

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

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

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

Для нестандартной конфигурации

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

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

Обновить предпосылки

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

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

Возьмите резервную копию

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

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

Закрыть лидера

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

Обновление лидера

Откат

Восстановить резервную копию

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

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

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

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

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

Вывод из эксплуатации узел Postgres

Шаги после обновления для Postgres

Новый Edge UI

Установите интерфейс Edge

Обновите пользовательский интерфейс Edge

Обновление с Apigee MTLS

Отказ от обновления

Информация об обновлении журнала

Обновление нулевого времени

Используйте тихий файл конфигурации

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

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

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

1-узловое автономное обновление

2-узловое автономное обновление

5-узловое обновление

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

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

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

For a non-standard configuration