Edge для частного облака v4.18.01
Какие версии Edge можно обновить до 4.18.01
Вы можете обновить Apigee Edge версий 4.16.01.0x и 4.16.05.x до 4.18.01, используя эту процедуру.
Если у вас установлена версия Edge, предшествующая версии 4.16.01, вам необходимо сначала перейти на версию 4.16.01, а затем обновиться до версии 4.18.01.
- Вы можете перенести Apigee Edge версии 4.15.07 на 4.16.01.
- Если у вас установлена версия Edge до версии 4.15.07, вам необходимо сначала перейти на версию 4.15.07, а затем на версию 4.16.01.
- Если вы переходите с Edge версии 4.14.04 или более поздней: выполните непосредственный переход на версию 4.15.07.
- Если вы переходите с версии Edge 4.14.01: сначала необходимо перейти на версию 4.14.04, а затем перейти на версию 4.15.07.
Кто может выполнить обновление
Пользователь, запускающий обновление, должен быть тем же пользователем, который первоначально установил Edge, или пользователем, работающим под учетной записью root.
После установки Edge RPM их сможет настроить любой пользователь.
Какие компоненты необходимо обновить
Вам необходимо обновить все компоненты Edge. Edge не поддерживает установку, содержащую компоненты из нескольких версий.
Понижение версии Zookeeper при обновлении с версии 4.16.01.
Версия RPM Zookeeper в Edge для частного облака 4.16.01 — apigee-zookeeper-3.4.5-1.0.905.noarch.rpm . В последующих версиях Edge версия Zookeeper была изменена обратно на apigee-zookeeper-3.4.5-0.0.94x . Это не позволяет yum обновить Zookeeper до более поздних версий, начиная с 4.16.01. Чтобы исправить эту ситуацию, перед обновлением Zookeeper запустите yum downgrade apigee-zookeeper .
Вы можете проверить версию Zookeeper, используя следующую команду:
> rpm -qa |grep apigee-zookeeper
Если эта команда возвращает версию Zookeeper:
apigee-zookeeper-3.4.5-1.0.905
Тогда вам необходимо выполнить понижение версии.
Автоматическое распространение настроек свойств
Если вы установили какие-либо свойства, отредактировав файлы .properties в /opt/apigee/customer/application , эти значения сохраняются при обновлении.
Обновить необходимые условия
Перед обновлением Apigee Edge позаботьтесь о следующих предварительных условиях:
- Резервное копирование всех узлов
Перед обновлением рекомендуется выполнить полное резервное копирование всех узлов в целях безопасности. Используйте процедуру для вашей текущей версии Edge для выполнения резервного копирования.
Это позволяет вам иметь запасной план на случай, если обновление до новой версии не будет работать должным образом. Дополнительную информацию о резервном копировании см. в разделе Резервное копирование и восстановление . - Убедитесь, что Edge работает
Убедитесь, что Edge запущен и работает во время процесса обновления, используя команду:
> /opt/apigee/apigee-service/bin/apigee-all status
Обработка неудачного обновления
В случае сбоя обновления вы можете попытаться исправить проблему, а затем снова запустить update.sh. Вы можете запускать обновление несколько раз, и оно продолжится с того места, где оно было остановлено в последний раз.
Если сбой требует отката обновления до предыдущей версии, дополнительные сведения см. в разделе 4.18.01 «Процесс отката» .
Регистрация информации об обновлении
По умолчанию утилита update.sh записывает информацию журнала в:
/opt/apigee/var/log/apigee-setup/update.log
Если пользователь, запускающий утилиту update.sh, не имеет доступа к этому каталогу, он записывает журнал в каталог /tmp в виде файла с именем update_username.log .
Если у пользователя нет доступа к /tmp , утилита update.sh завершится сбоем.
Требуется обновление до Java JDK версии 8.
Для этого выпуска Edge требуется, чтобы вы установили Java JDK версии 8 на всех узлах обработки Edge. Вы можете установить Oracle JDK 8 или OpenJDK 8. Если Java JDK 8 еще не установлен, сценарий обновления может установить его за вас.
В рамках обновления Java 8 некоторые шифры TLS больше не доступны в Oracle JDK 8. Полный список см. в разделе «Наборы шифров, отключенных по умолчанию» по адресу http://docs.oracle.com/javase/8/. docs/technotes/guides/security/SunProviders.html .
Требуется для включения репозитория EPEL
Для установки или обновления Edge необходимо включить дополнительные пакеты для Enterprise Linux (или EPEL) . Используемая вами команда зависит от вашей версии RedHat/CentOS:
- Для RedHat/CentOS 7.x:
> wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; об/мин -ivh epel-release-latest-7.noarch.rpm - Для RedHat/CentOS 6.x:
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; об/мин -ivh epel-release-latest-6.noarch.rpm
Требуется добавление параметра конфигурации SMTPMAILFROM.
В Edge 4.17.05 добавлен новый обязательный параметр в файл конфигурации, используемый при включении SMTP-сервера. Если вы обновляетесь с 4.17.01, то при включении SMTP-сервера необходимо установить SMTPMAILFROM в файле конфигурации.
В API BaaS версии 4.17.09 также добавлена поддержка свойства SMTPMAILFROM . При обновлении API BaaS необходимо установить SMTPMAILFROM в файле конфигурации.
Этот параметр имеет вид:
SMTPMAILFROM="My Company <myco@company.com>"
Требуется при обновлении при использовании внешней аутентификации.
Вы можете интегрировать внешнюю службу каталогов в существующую установку частного облака Apigee Edge. Эта функция предназначена для работы с любой службой каталогов, поддерживающей LDAP, например Active Directory, OpenLDAP и другими. Внешнее решение LDAP позволяет системным администраторам управлять учетными данными пользователей из централизованной службы управления каталогами, внешней по отношению к таким системам, как Apigee Edge, которые их используют.
Дополнительную информацию см. в разделе Настройка внешней аутентификации .
Когда внешняя аутентификация включена, большинство клиентов используют поле имени учетной записи SAM Active Directory в качестве имени пользователя для аутентификации вместо адреса электронной почты, который используется сервером Edge OpenLDAP.
Если вы интегрировались с внешней службой каталогов, добавьте следующую строку в свой файл конфигурации при обновлении Edge до 4.18.01:
IS_EXTERNAL_AUTH="true"
Эта строка настраивает Edge для поддержки имени учетной записи, а не адреса электронной почты в качестве имени пользователя.
Требуется обновление до Qpid 1.35.
Этот выпуск содержит необходимое обновление Qpid 1.35. В рамках обновления узла Qpid вам необходимо:
- Временно запретите маршрутизаторам и процессорам сообщений выполнять запись на узел Qpid, заблокировав порт 5672 на узле Qpid. Вы можете использовать следующую команду, чтобы заблокировать этот порт на узле Qpid:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `имя_хоста` -i eth0 -j DROP - Подождите, пока очередь Qpid освободится от сообщений, чтобы убедиться, что узел Qpid обработал все сообщения перед обновлением. Используйте следующую команду, чтобы убедиться, что очередь сообщений Qpid пуста:
> qpid-stat -q - Обновите узел Qpid.
- Разблокируйте порт 5672 на узле Qpid, чтобы разрешить доступ со стороны маршрутизаторов и процессоров сообщений. Вы можете использовать следующую команду, чтобы разблокировать этот порт:
> судо iptables -F
Обратите внимание: если вы используете iptables для других правил, вы можете использовать опцию -D, чтобы отменить конкретное изменение:
> sudo iptables -D INPUT -p tcp --порт назначения 5672 ! -s `имя_хоста` -i eth0 -j DROP
Этот процесс подробно описан ниже для каждой топологии Edge.
Требуется обновление до Postgres 9.6.
Этот выпуск Edge включает обновление до Postgres 9.6. В рамках этого обновления все данные Postgres переносятся в Postgres 9.6.
Во время процесса обновления, хотя узлы Postgres недоступны для обновления, аналитические данные по-прежнему записываются на узлы Qpid. После того как узлы Postgres обновляются и снова подключаются к сети, аналитические данные передаются на узлы Postgres.
Дополнительный резервный узел Postgres потребуется, если вам по какой-либо причине придется откатить обновление. Если вам необходимо выполнить откат обновления, новый резервный узел Postgres после отката станет главным узлом Postgres. Таким образом, когда вы устанавливаете новый резервный узел Postgres, он должен находиться на узле, который соответствует всем аппаратным требованиям сервера Postgres, как определено в Требованиях к пограничной установке .
Установка нового резервного узла Postgres
Эта процедура создает резервный сервер Postgres на новом узле. Убедитесь, что вы установили новый резервный сервер Postgres для существующей версии Edge (4.16.01 или 4.16.05), а не для версии 4.18.01.
Для установки используйте тот же файл конфигурации, который вы использовали для установки текущей версии Edge.
Чтобы создать новый резервный узел Postgres:
- На текущем главном сервере Postgres отредактируйте файл /opt/apigee/customer/application/postgresql.properties , чтобы установить следующий токен. Если этот файл не существует, создайте его:
conf_pg_hba_replication.connection=apigee репликации хоста существующий_slave_ip /32 доверие\ \napigee репликации хоста new_slave_ip /32 доверие
гдеexist_slave_ip — IP-адрес текущего резервного сервера Postgres, а new_slave_ip — IP-адрес нового резервного узла. - Перезапустите apigee-postgresql на главном сервере Postgres:
> /opt/apigee/apigee-service/bin/apigee-service перезапуск apigee-postgresql - Убедитесь, что новый резервный узел был добавлен, просмотрев файл /opt/apigee/apigee-postgresql/conf/pg_hba.conf на главном сервере. В этом файле вы должны увидеть следующие строки:
репликация хоста apigee существующий_slave_ip/32 доверие
репликация хоста apigee new_slave_ip/32 доверие - Установите новый резервный сервер Postgres:
- Отредактируйте файл конфигурации, который вы использовали для установки текущей версии Edge, указав следующее:
# IP-адрес текущего мастера:
PG_MASTER=192.168.56.103
# IP-адрес нового резервного узла
PG_STANDBY=192.168.56.102 - Отключите SELinux, как описано в разделе Установка утилиты Edge apigee-setup .
- Загрузите файл Edge bootstrap_4.16.05.sh в /tmp/bootstrap_4.16.05.sh :
> завиток https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
Примечание . Если вы обновляетесь с версии 4.16.01, загрузите файл Edge bootstrap.sh . - Установите утилиту Edge apigee-service и зависимости:
> sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser= uName apigeepassword= pWord - Используйте apigee-service для установки утилиты apigee-setup :
> /opt/apigee/apigee-service/bin/apigee-service установка установки apigee - Установите Постгрес:
> /opt/apigee/apigee-setup/bin/setup.sh -p ps -f файл конфигурации - На новом резервном узле выполните следующую команду:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
Убедитесь, что он говорит, что это режим ожидания.
- Отредактируйте файл конфигурации, который вы использовали для установки текущей версии Edge, указав следующее:
Вывод из эксплуатации узла Postgres
После завершения обновления выведите из эксплуатации новый резервный узел:
- Убедитесь, что Postgres запущен:
> /opt/apigee/apigee-service/bin/apigee-all status
Если Postgres не запущен, запустите его:
> /opt/apigee/apigee-service/bin/apigee-all start - Получите UUID нового резервного узла, выполнив следующую команду cURL на новом резервном узле:
> curl -u sysAdminEmail:пароль http:// <node_IP> :8084/v1/servers/self
В конце вывода вы должны увидеть UUID узла в форме:
"тип" : ["postgres-сервер"],
"uUID": "599e8ebf-5d69-4ae4-aa71-154970a8ec75" - Остановите новый резервный узел, выполнив на нем следующую команду:
> /opt/apigee/apigee-service/bin/apigee-all остановить - На главном узле Postgres отредактируйте /opt/apigee/customer/application/postgresql.properties , чтобы удалить новый резервный узел из conf_pg_hba_replication.connection :
conf_pg_hba_replication.connection=apigee репликации хоста существующий_slave_ip /32 доверие - Перезапустите apigee-postgresql на главном сервере Postgres:
> /opt/apigee/apigee-service/bin/apigee-service перезапуск apigee-postgresql - Убедитесь, что новый резервный узел был удален, просмотрев файл /opt/apigee/apigee-postgresql/conf/pg_hba.conf на главном сервере. В этом файле вы должны увидеть только следующую строку:
репликация хоста apigee существующий_slave_ip /32 доверие - Удалите UUID резервного узла из ZooKeeper, выполнив следующий вызов API управления Edge на узле Management Server:
> curl -u sysAdminEmail:пароль -X УДАЛИТЬ http:// <ms_IP> :8080/v1/servers/ <new_slave_uuid>
Обновление без простоев
Обновление с нулевым временем простоя или чередующееся обновление позволяет обновить установку Edge без отключения Edge.
Обновление с нулевым временем простоя возможно только в конфигурации с 5 узлами и более.
Ключом к обновлению без простоев является удаление каждого маршрутизатора по одному из балансировщика нагрузки. Затем вы обновляете Маршрутизатор и любые другие компоненты на том же компьютере, что и Маршрутизатор, а затем добавляете Маршрутизатор обратно в балансировщик нагрузки.
- Обновите компьютеры в порядке, соответствующем вашей установке, как описано ниже в разделе «Порядок обновления компьютеров».
- Когда придет время обновить маршрутизаторы, выберите любой маршрутизатор и сделайте его недоступным, как описано в разделе «Включение/выключение доступности сервера (процессора сообщений/маршрутизатора)» .
- Обновите выбранный маршрутизатор и все другие компоненты Edge на том же компьютере, что и маршрутизатор. Во всех конфигурациях Edge маршрутизатор и процессор сообщений расположены на одном узле.
- Снова сделайте маршрутизатор доступным.
- Повторите шаги 2–4 для остальных маршрутизаторов.
- Продолжите обновление для всех оставшихся компьютеров в вашей установке.
Позаботьтесь о следующем до/после обновления:
- На объединенном узле маршрутизатора и процессора сообщений:
- Перед обновлением выполните следующее:
- Сделайте маршрутизатор недоступным.
- Сделайте процессор сообщений недоступным.
- После обновления - выполните следующее:
- Сделайте процессор сообщений доступным.
- Сделайте маршрутизатор доступным.
- Перед обновлением выполните следующее:
- На одном узле маршрутизатора:
- Перед обновлением сделайте Роутер недоступным.
- После обновления сделайте маршрутизатор доступным.
- На одном узле процессора сообщений:
- Перед обновлением сделайте процессор сообщений недоступным.
- После обновления сделайте процессор сообщений доступным.
Использование тихого файла конфигурации
Вы должны передать файл конфигурации в автоматическом режиме команде обновления. Файл автоматической конфигурации должен быть тем же, который вы использовали для установки Edge 4.16.01 или 4.16.05.
Процедура обновления до 4.18.01 на узле с внешним подключением к Интернету
Используйте следующую процедуру для обновления компонентов Edge на узле:
- Если вы в настоящее время используете репликацию главный-резервный Postgres, установите новый резервный узел Postgres, как описано выше в разделе Установка нового резервного узла Postgres .
- Если они присутствуют, отключите все задания CRON, настроенные для выполнения операции восстановления в Cassandra, до завершения обновления.
- Войдите на свой узел как root, чтобы установить Edge RPM.
Примечание . Хотя для установки RPM требуется root-доступ, вы можете выполнить настройку Edge без root-доступа. - Установите yum-utils и yum-plugin-priorities :
> sudo yum установить yum-utils
> sudo yum install yum-plugin-priorities - Отключите SELinux, как описано в разделе Установка утилиты Edge apigee-setup .
- Включите репозиторий EPEL, как описано выше.
- Если вы устанавливаете Oracle 7.x , выполните следующую команду:
> sudo yum-config-manager --enable ol7_optional_latest - Если вы выполняете установку на AWS , выполните следующие команды yum-configure-manager :
> ням обновить rh-amazon-rhui-client.noarch
> sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional - Загрузите файл Edge 4.18.01 bootstrap_4.18.01.sh в /tmp/bootstrap_4.18.01.sh :
> завиток https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh - Установите утилиту apigee-service Edge 4.18.01 и зависимости:
> sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser= uName apigeepassword= pWord
где uName:pWord — имя пользователя и пароль, полученные вами от Apigee. Если вы опустите pWord , вам будет предложено ввести его.
По умолчанию программа установки проверяет, установлена ли у вас Java 1.8. Если вы этого не сделаете, он установит его за вас. Используйте опцию JAVA_FIX , чтобы указать, как обрабатывать установку Java. JAVA_FIX принимает следующие значения:
I = установить OpenJDK 1.8 (по умолчанию)
C = Продолжить без установки Java
Вопрос = Выйти. Для этого варианта вам придется установить Java самостоятельно. - Используйте apigee-service для обновления утилиты apigee-setup:
- Если вы установили версию 4.16.01 путем обновления Edge до версии 4.15.07.0x, вам необходимо установить утилиту apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service установка установки apigee
Эта команда устанавливает утилиту update.sh в /opt/apigee/apigee-setup/bin .
Если вы уже установили утилиту apigee-setup , обновите ее:
> /opt/apigee/apigee-service/bin/apigee-service обновление apigee-setup - Если вы установили 4.16.01 напрямую, то есть не выполняли обновление с 4.15.07.0x, вам необходимо обновить утилиту apigee-setup :
> /opt/apigee/apigee-service/bin/apigee-service обновление apigee-setup
Это обновление apigee-service устанавливает утилиту update.sh в /opt/apigee/apigee-setup/bin . - Если вы установили 4.16.05 напрямую или путем обновления, необходимо обновить утилиту apigee-setup :
> /opt/apigee/apigee-service/bin/apigee-service обновление apigee-setup
Это обновление apigee-service устанавливает утилиту update.sh в /opt/apigee/apigee-setup/bin .
- Если вы установили версию 4.16.01 путем обновления Edge до версии 4.15.07.0x, вам необходимо установить утилиту apigee-setup:
- В зависимости от вашей текущей версии Edge вам необходимо либо установить, либо обновить утилиту apigee-validate на сервере управления.
- Если вы в настоящее время используете Edge 4.16.05 : обновите утилиту apigee-validate на сервере управления:
> /opt/apigee/apigee-service/bin/apigee-service обновление apigee-validate - Если вы в настоящее время используете Edge 4.16.01 : установите утилиту apigee-validate на сервере управления:
> /opt/apigee/apigee-service/bin/apigee-service установка apigee-validate
Примечание . Если вы установили утилиту apigee-validate на узле процессора сообщений при установке 4.16.01, вы можете обновить ее, используя на этом узле следующую команду:
> /opt/apigee/apigee-service/bin/apigee-service обновление apigee-validate
Однако, начиная с версии 4.16.05 и более поздних версий, Apigee рекомендует установить и запустить утилиту apigee-validate на сервере управления. - Если вы обновляетесь с версии 4.16.01 : отредактируйте файл конфигурации, переданный утилите apigee-validate . В выпуске Edge 4.16.01 файл конфигурации, используемый apigee-validate, требовал следующих свойств:
APIGEE_ADMINPW=sysAdminPword
MP_POD=шлюз
РЕГИОН=DC-1
В этом выпуске для файла конфигурации требуется только свойство APIGEE_ADMINPW . Вы можете удалить два других свойства из файла.
- Если вы в настоящее время используете Edge 4.16.05 : обновите утилиту apigee-validate на сервере управления:
- Обновите утилиту apigee-provision :
> /opt/apigee/apigee-service/bin/apigee-service обновление apigee-provision - Запустите утилиту обновления на своих узлах в порядке, описанном ниже в разделе « Порядок обновления машины » ниже:
> /opt/apigee/apigee-setup/bin/update.sh -c компонент -f файл конфигурации
Единственное требование к файлу конфигурации состоит в том, что файл конфигурации должен быть доступен или доступен для чтения пользователю «apigee».
Используйте опцию «-c», чтобы указать компонент для обновления. В список возможных компонентов входят:
ldap = OpenLDAP
cs = Кассандра
zk = Смотритель зоопарка
qpid = qpidd
пс = PostgreSQL
Edge = все компоненты Edge, кроме пользовательского интерфейса Edge: сервер управления, процессор сообщений, маршрутизатор, сервер QPID, сервер Postgres.
ui = Пограничный интерфейс
all = обновить все компоненты на компьютере (используйте только для профиля установки Edge aio или профиля установки API BaaS asa)
е = ЭластичныйПоиск
b = стек API BaaS
p = API BaaS-портала
ebp = ElasticSearch, API BaaS Stack и API BaaS Portal на одном узле. - Проверьте обновление, запустив утилиту apigee-validate на сервере управления, как описано в разделе «Проверка установки» .
- Если вы установили новый резервный узел Postgres, выведите его из эксплуатации, как описано выше в разделе «Вывод из эксплуатации узла Postgres» .
Чтобы позднее выполнить откат обновления, используйте процедуру, описанную в разделе 4.18.01 «Процесс отката» .
Процедура обновления до 4.18.01 из локального репозитория
Если ваши пограничные узлы находятся за брандмауэром или каким-либо другим образом им запрещен доступ к репозиторию Apigee через Интернет, вы можете выполнить обновление из локального репозитория или зеркала репозитория Apigee.
После создания локального репозитория Edge у вас есть два варианта обновления Edge из локального репозитория:
- Создайте файл .tar репозитория, скопируйте файл .tar на узел, а затем обновите Edge из файла .tar.
- Установите веб-сервер на узле с локальным репозиторием, чтобы другие узлы могли получить к нему доступ. Apigee предоставляет вам веб-сервер Nginx, или вы можете использовать свой собственный веб-сервер.
Чтобы обновиться из локального репозитория 4.18.01:
- Если вы в настоящее время используете репликацию главный-резервный Postgres, установите новый резервный узел Postgres, как описано выше в разделе Установка нового резервного узла Postgres .
- Создайте локальный репозиторий 4.18.01, как описано в разделе «Создание локального репозитория Apigee» в разделе «Установка утилиты Edge apigee-setup» .
Примечание . Если у вас уже есть существующий репозиторий 4.16.01 или 4.16.05, вы можете добавить к нему репозиторий 4.18.01, как описано в разделе «Обновление локального репозитория Apigee» в разделе «Установка утилиты Edge apigee-setup» . - Чтобы установить сервис apigee из файла .tar :
- На узле с локальным репозиторием используйте следующую команду, чтобы упаковать локальный репозиторий в один файл .tar с именем /opt/apigee/data/apigee-mirror/apigee-4.18.01.tar.gz :
> /opt/apigee/apigee-service/bin/apigee-service пакет apigee-mirror - Скопируйте файл .tar на узел, где вы хотите обновить Edge. Например, скопируйте его в каталог /tmp на новом узле.
- На новом узле распакуйте файл в каталог /tmp:
> tar -xzf apigee-4.18.01.tar.gz
Эта команда создает новый каталог с именем repos в каталоге, содержащем файл .tar. Например /tmp/репозитории. - Установите утилиту Edge apigee-service и зависимости из /tmp/repos:
> sudo bash /tmp/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
Обратите внимание, что в эту команду вы включаете путь к каталогу репозитория.
- На узле с локальным репозиторием используйте следующую команду, чтобы упаковать локальный репозиторий в один файл .tar с именем /opt/apigee/data/apigee-mirror/apigee-4.18.01.tar.gz :
- Чтобы установить сервис apigee с помощью веб-сервера Nginx:
- Настройте веб-сервер Nginx, как описано в разделе «Установка из репозитория с помощью веб-сервера Nginx» в разделе «Установка утилиты Edge apigee-setup» .
- На удаленном узле загрузите файл Edge bootstrap_4.18.01.sh в /tmp/bootstrap_4.18.01.sh :
> /usr/bin/curl http:// uName: pWord @ RemoteRepo :3939/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
где uName:pWord — это имя пользователя и пароль, которые вы установили выше для репозитория, а RemoteRepo — это IP-адрес или DNS-имя узла репо. - На удаленном узле установите утилиту Edge apigee-service и зависимости:
> sudo bash /tmp/bootstrap_4.18.01.sh apigeerepohost= RemoteRepo :3939 apigeeuser= uName apigeepassword= pWord apigeeprotocol=http://
где uName:pWord — имя пользователя и пароль репозитория.
- Используйте apigee-service для обновления утилиты apigee-setup:
- Если вы установили версию 4.16.01 путем обновления Edge до версии 4.15.07.0x, вам необходимо установить утилиту apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service установка установки apigee
Эта команда устанавливает утилиту update.sh в /opt/apigee/apigee-setup/bin .
Если вы уже установили утилиту apigee-setup , обновите ее:
> /opt/apigee/apigee-service/bin/apigee-service обновление apigee-setup - Если вы установили 4.16.01 напрямую, то есть вы не выполняли обновление с 4.15.07.0x, вам необходимо обновить утилиту apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service обновление apigee-setup
Это обновление apigee-service устанавливает утилиту update.sh в /opt/apigee/apigee-setup/bin . - Если вы установили 4.16.05 напрямую или путем обновления, необходимо обновить утилиту apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service обновление apigee-setup
Это обновление apigee-service устанавливает утилиту update.sh в /opt/apigee/apigee-setup/bin .
- Если вы установили версию 4.16.01 путем обновления Edge до версии 4.15.07.0x, вам необходимо установить утилиту apigee-setup:
- В зависимости от вашей текущей версии Edge вам необходимо либо установить, либо обновить утилиту apigee-validate на сервере управления.
- Если вы в настоящее время используете Edge 4.16.05 : обновите утилиту apigee-validate на сервере управления:
> /opt/apigee/apigee-service/bin/apigee-service обновление apigee-validate - Если вы в настоящее время используете Edge 4.16.01 : установите утилиту apigee-validate на сервере управления:
> /opt/apigee/apigee-service/bin/apigee-service установка apigee-validate
Примечание . Если вы установили утилиту apigee-validate на узле процессора сообщений при установке 4.16.01, вы можете обновить ее, используя на этом узле следующую команду:
> /opt/apigee/apigee-service/bin/apigee-service обновление apigee-validate
Однако, начиная с версии 4.16.05 и более поздних версий, Apigee рекомендует установить и запустить утилиту apigee-validate на сервере управления. - Если вы обновляетесь с версии 4.16.01 : отредактируйте файл конфигурации, переданный утилите apigee-validate . В выпуске Edge 4.16.01 файл конфигурации, используемый apigee-validate, требовал следующих свойств:
APIGEE_ADMINPW=sysAdminPword
MP_POD=шлюз
РЕГИОН=DC-1
В этом выпуске для файла конфигурации требуется только свойство APIGEE_ADMINPW . Вы можете удалить два других свойства из файла.
- Если вы в настоящее время используете Edge 4.16.05 : обновите утилиту apigee-validate на сервере управления:
- Обновите утилиту apigee-provision :
> /opt/apigee/apigee-service/bin/apigee-service обновление apigee-provision - Запустите утилиту обновления на своих узлах в порядке, описанном ниже в разделе «Порядок обновления машины» ниже:
> /opt/apigee/apigee-setup/bin/update.sh -c компонент -f файл конфигурации
Единственное требование к файлу конфигурации состоит в том, что файл конфигурации должен быть доступен или доступен для чтения пользователю «apigee».
Используйте опцию «-c», чтобы указать компонент для обновления. В список возможных компонентов входят:
ldap = OpenLDAP
cs = Кассандра
zk = Смотритель зоопарка
qpid = qpidd
пс = PostgreSQL
Edge = все компоненты Edge, кроме пользовательского интерфейса Edge: сервер управления, процессор сообщений, маршрутизатор, сервер QPID, сервер Postgres.
ui = Пограничный интерфейс
all = обновить все компоненты на компьютере (используйте только для профиля установки Edge aio или профиля установки API BaaS asa)
е = ЭластичныйПоиск
b = стек API BaaS
p = API BaaS-портала
ebp = ElasticSearch, API BaaS Stack и API BaaS Portal на одном узле. - Проверьте обновление, запустив утилиту apigee-validate на сервере управления, как описано в разделе «Проверка установки» .
- Если вы установили новый резервный узел Postgres, выведите его из эксплуатации, как описано выше в разделе «Вывод из эксплуатации узла Postgres» .
Чтобы позднее выполнить откат обновления, используйте процедуру, описанную в разделе 4.18.01 «Процесс отката» .
Порядок обновления машины
Порядок обновления компьютеров при установке Edge важен. Наиболее важные соображения по поводу обновления:
- Вы должны обновить все узлы Cassandra и ZooKeeper, прежде чем обновлять любые другие узлы.
- Для любого компьютера с несколькими пограничными компонентами (сервер управления, процессор сообщений, маршрутизатор, сервер QPID, но не сервер Postgres) используйте параметр «-c Edge», чтобы обновить их все одновременно.
- Если для шага указано, что его следует выполнить на нескольких компьютерах, выполните его в указанном порядке компьютеров.
- Отдельного шага по обновлению монетизации не требуется. Он обновляется, когда вы указываете опцию «-c Edge».
Для автономной установки на 1 хост
- Установите SMTPMAILFROM в файле конфигурации, если вы включили SMTP в Edge. Этот параметр имеет вид:
SMTPMAILFROM="Моя компания <myco@company.com>" - При обновлении с 4.16.01 понизьте Zookeeper:
> ням, понизить версию apigee-zookeeper - Обновите Кассандру и ZooKeeper:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile - Установите следующее правило iptables:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `имя_хоста` -i eth0 -j DROP - Проверьте очередь сообщений Qpid:
> qpid-stat -q
Продолжайте проверять очередь до тех пор, пока счетчик в столбце «msg» не станет равным 0. Вы не сможете обновить Qpid, пока он не обработает все сообщения. - Обновить qpidd :
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f файл конфигурации - Очистить iptables:
> судо iptables -F - Обновить LDAP:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f файл конфигурации - Остановите сервер Postgres, сервер Qpid и PostgreSQL:
> /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server остановить
> /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server остановка
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql остановить - Обновить постгреск:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Обновите базу данных Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade - Обновите оставшиеся компоненты Edge:
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f файл конфигурации - Обновите пользовательский интерфейс Edge:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f файл конфигурации
Для автономной установки на 2 хоста
Список топологий Edge и номеров узлов см. в разделе «Топологии установки» .
- Установите SMTPMAILFROM в файле конфигурации, если вы включили SMTP в Edge. Этот параметр имеет вид:
SMTPMAILFROM="Моя компания <myco@company.com>" - При обновлении с версии 4.16.01 понизьте версию Zookeeper на компьютере 1:
> ням, понизить версию apigee-zookeeper - Обновите Cassandra и ZooKeeper на машине 1:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f файл конфигурации - Установите следующее правило iptables на компьютере 2:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `имя_хоста` -i eth0 -j DROP - Проверьте очередь сообщений Qpid на машине 2:
> qpid-stat -q
Продолжайте проверять очередь до тех пор, пока счетчик в столбце «msg» не станет равным 0. Вы не сможете обновить Qpid, пока он не обработает все сообщения. - Обновите qpidd на машине 2:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f файл конфигурации - Очистите iptables на машине 2:
> судо iptables -F - Обновите LDAP на машине 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f файл конфигурации - Обновите компоненты Edge на компьютере 1:
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f файл конфигурации - Обновите пользовательский интерфейс на компьютере 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f файл конфигурации - Обновите postgresql на машине 2:
- Остановите сервер Postgres, сервер Qpid и postgresql:
> /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server остановка
> /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server остановка
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql остановить - Обновить постгреск:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Обновите базу данных Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade - Обновите компоненты Edge на машине 2:
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f файл конфигурации
- Остановите сервер Postgres, сервер Qpid и postgresql:
Для кластерной установки из 5 хостов
Список топологий Edge и номеров узлов см. в разделе «Топологии установки» .
- Установите SMTPMAILFROM в файле конфигурации, если вы включили SMTP в Edge. Этот параметр имеет вид:
SMTPMAILFROM="Моя компания <myco@company.com>" - Убедитесь, что вы установили новый резервный узел Postgres, как описано выше в разделе Установка нового резервного узла Postgres .
- При обновлении с версии 4.16.01 понизьте версию Zookeeper на машинах 1, 2 и 3:
> ням, понизить версию apigee-zookeeper - Обновите Cassandra и ZooKeeper на машинах 1, 2 и 3:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f файл конфигурации - Установите следующее правило iptables на компьютере 4:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `имя_хоста` -i eth0 -j DROP - Проверьте очередь сообщений Qpid на машине 4:
> qpid-stat -q
Продолжайте проверять очередь до тех пор, пока счетчик в столбце «msg» не станет равным 0. Вы не сможете обновить Qpid, пока он не обработает все сообщения. - Обновите qpidd на машине 4:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f файл конфигурации - Очистите iptables на машине 4:
> судо iptables -F - Повторите шаги с 5 по 8 на машине 5.
- Обновите LDAP на машине 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f файл конфигурации - Обновите компоненты Edge на компьютере 1, 2, 3:
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f файл конфигурации - Обновите пользовательский интерфейс на компьютере 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f файл конфигурации - Обновите машины 4 и 5:
- Остановите сервер Postgres и сервер Qpid на машине 4:
> /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server остановить
> /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server остановка - Остановите сервер Postgres, сервер Qpid и postgresql на машине 5:
> /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server остановить
> /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server остановка
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql остановить - Остановите сервер Postgres и postgresql на новом резервном узле, который вы добавили для отката:
> /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server остановить
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql остановить - Обновите postgresql на машинах 4:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Обновите базу данных Postgres на компьютере 4 (только Postgres master):
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade - Обновите postgresql на машинах 5:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Запустите сервер Postgres и сервер Qpid на машинах 4 и 5:
> /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start
> /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start - Настройте Postgres в качестве резервного узла, выполнив на машине 5 следующие команды:
> cd /opt/apigee/data/apigee-postgresql/pgdata
> РМ -РФ *
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile - Проверьте состояние репликации, выполнив следующие сценарии на обоих серверах. Система должна отображать одинаковые результаты на обоих серверах, чтобы гарантировать успешную репликацию:
На машине 4, главном узле, запустите:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
Убедитесь, что он говорит, что он является мастером.
На машине 5 резервный узел:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
Убедитесь, что он говорит, что это режим ожидания.
- Остановите сервер Postgres и сервер Qpid на машине 4:
- Обновите компоненты Edge на машинах 4, 5:
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f файл конфигурации - Убедитесь, что вы вывели из эксплуатации новый резервный узел, выполнив процедуру, описанную выше в разделе «Вывод из эксплуатации узла Postgres» .
Для кластерной установки из 9 хостов
Список топологий Edge и номеров узлов см. в разделе «Топологии установки» .
- Установите SMTPMAILFROM в файле конфигурации, если вы включили SMTP в Edge. Этот параметр имеет вид:
SMTPMAILFROM="Моя компания <myco@company.com>" - Убедитесь, что вы установили новый резервный узел Postgres, как описано выше в разделе Установка нового резервного узла Postgres .
- При обновлении с версии 4.16.01 понизьте версию Zookeeper на компьютерах 1, 2 и 3:
> ням, понизить версию apigee-zookeeper - Обновите Cassandra и ZooKeeper на машинах 1, 2 и 3:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile - Установите следующее правило iptables на компьютере 6:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `имя_хоста` -i eth0 -j DROP - Проверьте очередь сообщений Qpid на машине 6:
> qpid-stat -q
Продолжайте проверять очередь до тех пор, пока счетчик в столбце «msg» не станет равным 0. Вы не сможете обновить Qpid, пока он не обработает все сообщения. - Обновите qpidd на машине 6:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f файл конфигурации - Очистите iptables на машине 6:
> судо iptables -F - Повторите шаги с 5 по 8 на машине 7.
- Обновите LDAP на машине 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f файл конфигурации - Обновите компоненты Edge на компьютерах 6, 7, 1, 4 и 5 в следующем порядке:
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f файл конфигурации - Обновите пользовательский интерфейс на компьютере 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f файл конфигурации - Обновите машины 8 и 9:
- Остановите сервер Postgres на машине 8:
> /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server остановка - Остановите сервер Postgres и postgresql на машине 9:
> /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server остановка
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql остановить - Остановите сервер Qpid на машинах 6 и 7:
> /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server остановка - Остановите сервер Postgres и postgresql на новом резервном узле, который вы добавили для отката:
> /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server остановка
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql остановить - Обновите postgresql на машинах 8:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Обновите базу данных Postgres на компьютере 8 (только Postgres master):
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade - Обновите postgresql на машинах 9:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Запустите сервер Postgres на машинах 8 и 9:
> /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start - Запустите сервер Qpid на машинах 6 и 7:
> /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start - Настройте Postgres в качестве резервного узла, выполнив на машине 9 следующие команды:
> cd /opt/apigee/data/apigee-postgresql/pgdata
> РМ -РФ *
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile - Проверьте состояние репликации, выполнив следующие сценарии на обоих серверах. Система должна отображать одинаковые результаты на обоих серверах, чтобы гарантировать успешную репликацию:
На машине 8, главном узле, запустите:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
Убедитесь, что он говорит, что он является мастером.
На машине 9 резервный узел:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
Убедитесь, что он говорит, что это режим ожидания.
- Остановите сервер Postgres на машине 8:
- Обновите компоненты Edge на машинах 8 и 9:
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f файл конфигурации - Убедитесь, что вы вывели из эксплуатации новый резервный узел, выполнив процедуру, описанную выше в разделе «Вывод из эксплуатации узла Postgres» .
Для кластерной установки из 13 хостов
Список топологий Edge и номеров узлов см. в разделе «Топологии установки» .
- Установите SMTPMAILFROM в файле конфигурации, если вы включили SMTP в Edge. Этот параметр имеет вид:
SMTPMAILFROM="Моя компания <myco@company.com>" - Убедитесь, что вы установили новый резервный узел Postgres, как описано выше в разделе Установка нового резервного узла Postgres .
- При обновлении с версии 4.16.01 понизьте версию Zookeeper на компьютерах 1, 2 и 3:
> ням, понизить версию apigee-zookeeper - Обновите Cassandra и ZooKeeper на машинах 1, 2 и 3:
> /opt/apigee/apigee-setup/bin/update.sh -c CS, zk -f configfile - Установите следующее правило iptables на машине 12:
> sudo iptables -a вход -p tcp -destination -port 5672! -s `hostname` -i eth0 -j drop - Проверьте очередь сообщений QPID на машине 12:
> qpid -stat -q
Продолжайте проверять очередь до тех пор, пока количество в столбце «MSG» не станет 0. Вы не можете обновить QPID, пока не обработает все сообщения. - Обновите QPIDD на машине 12:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configfile - Промывать iptables на машине 12:
> sudo iptables -f - Повторите шаги с 5 по 8 на машине 13.
- Обновите LDAP на машинах 4 и 5:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configfile - Обновлять края компонентов на машине 12, 13, 6, 7, 10 и 11 в этом порядке:
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile - Обновить пользовательский интерфейс на машине 6 и 7:
> /opt/apigee/apigee-setup/bin/update.sh -c UI -f configFile - Обновление машин 8 и 9:
- Остановить сервер Postgres на машине 8:
>/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server - Остановить сервер Postgres и PostgreSQL на машине 9:
>/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server
>/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql - Остановите QPID -сервер на машинах 12 и 13:
>/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server - Остановить сервер Postgres и PostgreSQL в новом резервном узле, который вы добавили для отката:
>/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server
>/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql - Обновление PostgreSQL на машинах 8:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configfile - Обновите базу данных Postgres на машине 8 (только Master Postgres):
>/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade - Обновление PostgreSQL на машинах 9:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configfile - Начать сервер Postgres на машинах 8 и 9:
>/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server - Запустите сервер QPID Server на машинах 12 и 13:
>/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server - Настройте Postgres как резервный узел, выполнив следующие команды на машине 9:
> cd/opt/apigee/data/apigee-postgresql/pgdata
> rm -rf *
>/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configfile - Проверьте статус репликации, выпустив следующие сценарии на обоих серверах. Система должна отображать идентичные результаты на обоих серверах, чтобы обеспечить успешную репликацию:
На машине 8, мастер -узел, запустите:
>/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-ceck-master
Утвердите, что он говорит, что это мастер.
На машине 9, резервный узел:
>/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-standby
Убедитесь, что он говорит, что это резервное положение.
- Остановить сервер Postgres на машине 8:
- Обновление компонентов Edge на машине 8 и 9:
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile - Убедитесь, что вы выводите из эксплуатации нового резервного узла, используя приведенную выше процедуру при выводе из эксплуатации постгровского узла .
Для кластерной установки с 12 хостами
См. Топологии установки для списка топологий края и номеров узлов.
- Установите smtpmailfrom в вашем файле конфигурации, если вы включили SMTP на краю. Этот параметр имеет форму:
Smtpmailfrom = "Моя компания <myco@company.com>" - Убедитесь, что вы установили новый резервный узел Postgres, как описано выше, при установке нового резервного узла Postgres .
- Обновите Кассандру и ZooKeeper:
- Если обновление с 4.16.01 , понизить Zookeeper на Macine 1, 2 и 3 в центре обработки данных 1:
> yum понижать Apigee-Zookeeper - На компьютерах 1, 2 и 3 в центре обработки данных 1:
> /opt/apigee/apigee-setup/bin/update.sh -c CS, zk -f configfile - Если обновление с 4.16.01 , понизить Zookeeper на Macine 7, 8 и 9 в центре обработки данных 2:
> yum понижать Apigee-Zookeeper - На компьютерах 7, 8 и 9 в дата-центре 2.
> /opt/apigee/apigee-setup/bin/update.sh -c CS, zk -f configfile
- Если обновление с 4.16.01 , понизить Zookeeper на Macine 1, 2 и 3 в центре обработки данных 1:
- Обновить qpidd:
- Машины 4, 5 в дата-центре 1
- Установите следующее правило iptables на машине 4:
> sudo iptables -a вход -p tcp -destination -port 5672! -s `hostname` -i eth0 -j drop - Проверьте очередь сообщений QPID на машине 4:
> qpid -stat -q
Продолжайте проверять очередь до тех пор, пока количество в столбце «MSG» не станет 0. Вы не можете обновить QPID, пока не обработает все сообщения. - Обновите qpidd на машине 4:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configfile - Промывать iptables на машине 4:
> sudo iptables -f - Повторите шаги с 1 по 4 на машине 5.
- Установите следующее правило iptables на машине 4:
- Машины 10, 11 в ЦОД 2
- Установите следующее правило iptables на машине 10:
> sudo iptables -a вход -p tcp -destination -port 5672! -s `hostname` -i eth0 -j drop - Проверьте очередь сообщений QPID на машине 10:
> qpid -stat -q
Продолжайте проверять очередь до тех пор, пока количество в столбце «MSG» не станет 0. Вы не можете обновить QPID, пока не обработает все сообщения. - Обновите qpidd на машине 10:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configfile - Промывать iptables на машине 10:
> sudo iptables -f - Повторите шаги с 1 по 4 на машине 11.
- Установите следующее правило iptables на машине 10:
- Машины 4, 5 в дата-центре 1
- Обновить LDAP:
- Машины 1 в центре обработки данных 1
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configfile - Машины 7 в центре обработки данных 2
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configfile
- Машины 1 в центре обработки данных 1
- Обновите компоненты Edge:
- Машины 4, 5, 1, 2, 3 в центре обработки данных 1
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile - Машины 10, 11, 7, 8, 9 в центре обработки данных 2
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
- Машины 4, 5, 1, 2, 3 в центре обработки данных 1
- Обновить пользовательский интерфейс:
- Машина 1 в дата-центре 1:
> /opt/apigee/apigee-setup/bin/update.sh -c UI -f configFile - Машина 7 в дата-центре 2:
> /opt/apigee/apigee-setup/bin/update.sh -c UI -f configFile
- Машина 1 в дата-центре 1:
- Обновить машину 6 в центре обработки данных 1 и 12 в центре обработки данных 2:
- Остановить сервер Postgres на машине 6:
>/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server - Остановить сервер Postgres и PostgreSQL на машине 12:
>/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server
>/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql - Остановите QPID -сервер на машинах 4, 5, 10 и 11:
>/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server - Остановить сервер Postgres и PostgreSQL в новом резервном узле, который вы добавили для отката:
>/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server
>/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql - Обновление PostgreSQL на машинах 6:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configfile - Обновите базу данных Postgres на машине 6 (только в Postgres Master):
>/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade - Обновление PostgreSQL на машинах 12:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configfile - Начать сервер Postgres Server на машинах 6 и 12:
>/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server - Запустите сервер QPID Server на машинах 4, 5, 10 и 11:
>/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server - Настройте Postgres как резервный узел, выполнив следующие команды на машине 12:
> cd/opt/apigee/data/apigee-postgresql/pgdata
> rm -rf *
>/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configfile - Проверьте статус репликации, выпустив следующие сценарии на обоих серверах. Система должна отображать идентичные результаты на обоих серверах, чтобы обеспечить успешную репликацию:
На машине 6, мастер -узел, запустите:
>/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-ceck-master
Утвердите, что он говорит, что это мастер.
На машине 12, резервный узел:
>/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-standby
Убедитесь, что он говорит, что это резервное положение.
- Остановить сервер Postgres на машине 6:
- Обновления Edge Components на машине 6 и 12:
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile - Убедитесь, что вы выводите из эксплуатации нового резервного узла, используя приведенную выше процедуру при выводе из эксплуатации постгровского узла .
Для установки API BAAS с 7 хостами или 10 хост
Для нестандартной установки
Если у вас нестандартная установка, то обновляйте компоненты края в следующем порядке:
- смотритель зоопарка
- Кассандра
- qpidd
- ЛДАП
- Edge, что означает профиль «-c Edge» на всех узлах в порядке: узлы с QPID-сервером, но не на сервере Postgres, сервере управления, процессоре сообщений и маршрутизаторе.
ПРИМЕЧАНИЕ . Если узел установлен как QPID-сервер, так и сервер Postgres, запустите шаг профиля «-c Edge» как часть шага 8. - Пограничный интерфейс
- Postgresql на Postgres Master, включая обновление.
- Postgresql в режиме ожидания Postgres.
- Edge, что означает профиль «-c Edge» на всех комбинированных узлах QPID и Postgres или на любых автономных постгресских узлах.
Edge для частного облака v4.18.01
Какие версии Edge вы можете обновить до 4.18.01
Вы можете обновить версию Apigee Edge 4.16.01.0x и 4.16.05.x до 4.18.01, используя эту процедуру.
Если у вас есть версия Edge до версии 4.16.01, то сначала необходимо перейти на версию 4.16.01, а затем обновить версию 4.18.01.
- Вы можете мигрировать версию Apigee Edge 4.15.07 на 4.16.01.
- Если у вас есть версия Edge до версии 4.15.07, то сначала необходимо перейти на версию 4.15.07, а затем в версию 4.16.01.
- Если вы мигрируете из Edge версии 4.14.04 или более поздней версии: непосредственно мигрируйте в версию 4.15.07.
- Если вы мигрируете из Edge версии 4.14.01: сначала необходимо перейти на версию 4.14.04, а затем перейти на версию 4.15.07.
Кто может выполнить обновление
Пользователь, запускающий обновление, должен быть тем же пользователем, который первоначально установил Edge, или пользователем, работающим под учетной записью root.
После установки Edge RPM их сможет настроить любой пользователь.
Какие компоненты необходимо обновить
Вам необходимо обновить все компоненты Edge. Edge не поддерживает установку, содержащую компоненты из нескольких версий.
Понижение Zookeeper при обновлении с 4.16.01
Версия Zookeeper RPM в Edge для частного облака 4.16.01- Apigee-Zookeeper-3.4.5-1.0.905.noarch.rpm . В последующих версиях Edge версия Zookeeper была изменена на Apigee-Zookeeper-3.4.5-0.0.94x . Это мешает YUM модернизировать Zookeeper до более поздних версий с 4.16.01. Способ исправить эту ситуацию состоит в том, чтобы запустить yum понижать Apigee-Zookeeper, прежде чем обновлять Zookeeper.
Вы можете проверить свою версию Zookeeper, используя следующую команду:
> rpm -qa |grep apigee-zookeeper
Если эта команда возвращает версию Zookeeper:
apigee-zookeeper-3.4.5-1.0.905
Тогда вы должны сделать понижение.
Автоматическое распространение настроек свойств
Если вы установили какие-либо свойства, отредактировав файлы .properties в /opt/apigee/customer/application , эти значения сохраняются при обновлении.
Обновить необходимые условия
Перед обновлением Apigee Edge позаботьтесь о следующих предварительных условиях:
- Резервное копирование всех узлов
Перед обновлением рекомендуется выполнить полное резервное копирование всех узлов в целях безопасности. Используйте процедуру для вашей текущей версии Edge для выполнения резервного копирования.
Это позволяет вам иметь запасной план на случай, если обновление до новой версии не будет работать должным образом. Для получения дополнительной информации о резервном копировании см. Резервное копирование и восстановить . - Убедитесь, что Edge работает
Убедитесь, что Edge запущен и работает во время процесса обновления, используя команду:
> /opt/apigee/apigee-service/bin/apigee-all status
Обработка неудачного обновления
В случае сбоя обновления вы можете попытаться исправить проблему, а затем снова запустить update.sh. Вы можете запускать обновление несколько раз, и оно продолжится с того места, где оно было остановлено в последний раз.
Если сбой требует, чтобы вы отказались от обновления к своей предыдущей версии, для получения дополнительной информации см. 4.18.01 процесс отката .
Регистрация информации об обновлении
По умолчанию утилита update.sh записывает информацию журнала в:
/opt/apigee/var/log/apigee-setup/update.log
Если пользователь, запускающий утилиту update.sh, не имеет доступа к этому каталогу, он записывает журнал в каталог /tmp в виде файла с именем update_username.log .
Если у пользователя нет доступа к /tmp , утилита update.sh завершится сбоем.
Требуется обновление до Java JDK версии 8
Этот выпуск Edge требует, чтобы вы установили JAVA JDK версию 8 на все узлы обработки края. Вы можете установить Oracle JDK 8 или OpenJDK 8. Если Java JDK 8 еще не установлен, сценарий обновления может установить его для вас.
В рамках обновления на Java 8 некоторые шифры TLS больше не доступны в Oracle JDK 8. Для полного списка см. В разделе «По умолчанию отключенные коэффициенты шифра» по адресу http://docs.oracle.com/javase/8//8/ Docs/Technotes/Guides/Security/SunProviders.html .
Необходимо для включения Epel Repo
Вы должны включить дополнительные пакеты для Enterprise Linux (или Epel) для установки или обновления края. Используемая вами команда зависит от вашей версии RedHat/CentOS:
- Для Redhat/Centos 7.x:
> wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; RPM -IVH EPEL-RELEASE-LATSTEST-7.NOARCH.RPM - Для Redhat/Centos 6.x:
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; rpm -ivh epel-release-latest-6.noarch.rpm
Требуемое добавление параметра конфигурации SMTPMAIL от конфигурации
Edge 4.17.05 Добавлен новый необходимый параметр в файл конфигурации, используемый при включении SMTP -сервера. Если вы обновляетесь с 4.17.01, то необходимо установить SMTPMAILF в файле конфигурации при включении SMTP -сервера.
API BAAS Версия 4.17.09 также добавила поддержку свойства SMTPMAILFFROM . При обновлении API BAAS необходимо установить SMTPMAILFFROM в файле конфигурации.
Этот параметр имеет форму:
SMTPMAILFROM="My Company <myco@company.com>"
Требуется при обновлении при использовании внешней аутентификации
Вы можете интегрировать службу внешнего каталога в существующую установку частного облака Apigee Edge. Эта функция предназначена для работы с любой службой каталогов, которая поддерживает LDAP, такой как Active Directory, OpenLDAP и другие. Внешнее решение LDAP позволяет системным администраторам управлять учетными данными пользователей из централизованного службы управления каталогами, внешних по отношению к таким системам, как Apigee Edge, которые их используют.
См. Конфигурацию внешней аутентификации для получения дополнительной информации.
Когда внешняя аутентификация включена, большинство клиентов используют поле «Имя учетной записи SAM Active Directory» в качестве имени пользователя для аутентификации, вместо адреса электронной почты, который используется сервером Edge OpenLDAP.
Если вы интегрированы с службой внешней каталогов, добавьте следующую строку в файл конфигурации при обновлении Edge до 4.18.01:
IS_EXTERNAL_AUTH="true"
Эта строка настраивает Edge, чтобы поддержать имя учетной записи, а не адрес электронной почты, как имя пользователя.
Требуется обновление до QPID 1.35
Этот релиз содержит необходимое обновление для QPID 1.35. Как часть обновления узла QPID, вы должны:
- Временно предотвращайте написание маршрутизаторов и процессоров сообщений в узел QPID, блокируя порт 5672 на узле QPID. Вы можете использовать следующую команду, чтобы заблокировать этот порт на узле QPID:
> sudo iptables -a вход -p tcp -destination -port 5672! -s `hostname` -i eth0 -j drop - Подождите, пока очередь QPID будет опустошена от сообщений, чтобы убедиться, что узел QPID обрабатывал все сообщения до обновления. Используйте следующую команду, чтобы убедиться, что очередь сообщений QPID пуста:
> qpid -stat -q - Обновите узел QPID.
- Unblock Port 5672 на узле QPID, чтобы разрешить доступ с маршрутизаторов и процессоров сообщений. Вы можете использовать следующую команду, чтобы разблокировать этот порт:
> sudo iptables -f
Обратите внимание, что если вы используете iptables для других правил, вы можете использовать опцию -d, чтобы отменить конкретное изменение:
> sudo iptables -d input -p tcp -destination -port 5672! -s `hostname` -i eth0 -j drop
Этот процесс подробно описан ниже для каждой топологии края.
Требуется обновление до Postgres 9.6
Этот выпуск Edge включает в себя обновление до Postgres 9.6. В рамках этого обновления все данные Postgres мигрируются в Postgres 9.6.
Во время процесса обновления, в то время как узлы Postgres недовольны обновлением, аналитические данные по -прежнему записываются в узлы QPID. После того, как узлы Postgres обновляются и возвращаются в Интернете, аналитические данные затем подталкиваются к узлам Postgres.
Дополнительный резервный узел Postgres требуется, если вам нужно откатить обновление по любой причине. Если вам нужно отказаться от обновления, новый резервный узел Postgres становится главным узлом Postgres после отката. Поэтому, когда вы устанавливаете новый режим ожидания Postgres, он должен находиться на узле, который соответствует всем требованиям аппаратного обеспечения сервера Postgres, как определено в требованиях к установке края.
Установка нового резервного узла Postgres
Эта процедура создает резервный сервер Postgres на новом узле. Убедитесь, что вы установите новый Stenby Server Postgres для вашей существующей версии Edge (4.16.01 или 4.16.05), а не для версии 4.18.01.
Чтобы выполнить установку, используйте тот же файл конфигурации, который вы использовали для установки текущей версии Edge.
Чтобы создать новый резервный узел Postgres:
- На текущем мастере Postgres отредактируйте файл /opt/apigee/ customer/application/postgresql.properties, чтобы установить следующий токен. Если этот файл не существует, создайте его:
conf_pg_hba_replication.connection = репликация хоста apigee существует
где существующий_слав_ип является IP -адресом текущего режима STEDBY Server, а New_Slave_IP - это IP -адрес нового резервного узла. - Перезапустите Apigee-Postgresql на Postgres Master:
>/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql перезапуск - Убедитесь, что новый резервный узел был добавлен путем просмотра файла /opt/apigee/apigee -postgresql/conf/pg_hba.conf на мастере. Вы должны увидеть следующие строки в этом файле:
Репликация хоста Apigee существует
Репликация хоста apigee new_slave_ip/32 доверие - Установите новый Stenby Server Postgres:
- Измените файл конфигурации, который вы использовали для установки текущей версии Edge, чтобы указать следующее:
# IP -адрес текущего мастера:
Pg_master = 192.168.56.103
# IP -адрес нового резервного узла
Pg_standby = 192.168.56.102 - Отключите Selinux, как описано при установке утилиты Edge Apigee-Setup .
- Загрузите файл Edge Bootstrap_4.16.05.sh в файл /tmp/bootstrap_4.16.05.sh :
> curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
Примечание . Если вы обновляете с 4.16.01, загрузите файл Edge Bootstrap.sh . - Установите утилиту Edge apigee-service и зависимости:
> sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser = uname apigeepassword = pword - Используйте apigee-service для установки утилиты apigee-setup :
>/opt/apigee/apigee-service/bin/apigee-service apigee-setup установка - Установить Postgres:
> /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configfile - На новом резервном узле запустите следующую команду:
>/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-standby
Убедитесь, что он говорит, что это резервное положение.
- Измените файл конфигурации, который вы использовали для установки текущей версии Edge, чтобы указать следующее:
Вывод из эксплуатации узел Postgres
После завершения обновления выводят из эксплуатации новый режим ожидания:
- Убедитесь, что Postgres работает:
> /opt/apigee/apigee-service/bin/apigee-all status
Если Postgres не работает, запустите:
>/opt/apigee/apigee-service/bin/apigee-all Start - Получите UUID нового резервного узла, выполнив следующую команду Curl в новом резервном узле:
> curl -u sysadminemail: пароль http: // <node_ip> : 8084/v1/servers/self
Вы должны увидеть UUID узла в конце вывода в форме:
"Тип": ["Postgres-Server"],
"UUID": "599EBF-5D69-4AE4-AA71-154970A8EC75" - Остановите новый резервный узел, выполнив следующую команду на новом резервном узле:
>/opt/apigee/apigee-service/bin/apigee-all - На главном узле Postgres, редактируйте /opt/apigee/ customer/application/postgresql.properties, чтобы удалить новый резервный узел из conf_pg_hba_replication.connection :
conf_pg_hba_replication.connection = репликация хоста apigee существует - Перезапустите Apigee-Postgresql на Postgres Master:
>/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql перезапуск - Убедитесь, что новый резервный узел был удален путем просмотра файла /opt/apigee/apigee -postgresql/conf/pg_hba.conf на мастере. Вы должны увидеть только следующую строку в этом файле:
Репликация хоста Apigee существует - Удалить UUID резервного узла из Zookeeper, сделав следующий вызов API управления Edge на узле сервера управления:
> curl -u sysadminemail: пароль -x delete http: // <ss_ip> : 8080/v1/servers/ <new_slave_uuid>
Обновление без простоев
Обновление с нулевым временем простоя или чередующееся обновление позволяет обновить установку Edge без отключения Edge.
Обновление с нулевым временем простоя возможно только в конфигурации с 5 узлами и более.
Ключом к обновлению без простоев является удаление каждого маршрутизатора по одному из балансировщика нагрузки. Затем вы обновляете Маршрутизатор и любые другие компоненты на том же компьютере, что и Маршрутизатор, а затем добавляете Маршрутизатор обратно в балансировщик нагрузки.
- Обновите машины в правильном порядке для вашей установки, как описано ниже в «Порядок обновления машины».
- Когда придет время обновить маршрутизаторы, выберите любой маршрутизатор и сделайте его недоступным, как описано в разделе «Включение/выключение доступности сервера (процессора сообщений/маршрутизатора)» .
- Обновите выбранный маршрутизатор и все другие компоненты Edge на том же компьютере, что и маршрутизатор. Во всех конфигурациях Edge маршрутизатор и процессор сообщений расположены на одном узле.
- Снова сделайте маршрутизатор доступным.
- Повторите шаги 2–4 для остальных маршрутизаторов.
- Продолжите обновление для всех оставшихся компьютеров в вашей установке.
Позаботьтесь о следующем до/после обновления:
- На объединенном узле маршрутизатора и процессора сообщений:
- Перед обновлением выполните следующее:
- Сделайте маршрутизатор недоступным.
- Сделайте процессор сообщений недоступным.
- После обновления - выполните следующее:
- Сделайте процессор сообщений доступным.
- Сделайте маршрутизатор доступным.
- Перед обновлением выполните следующее:
- На одном узле маршрутизатора:
- Перед обновлением сделайте Роутер недоступным.
- После обновления сделайте маршрутизатор доступным.
- На одном узле процессора сообщений:
- Перед обновлением сделайте процессор сообщений недоступным.
- После обновления сделайте процессор сообщений доступным.
Использование тихого файла конфигурации
Вы должны передать файл конфигурации в автоматическом режиме команде обновления. Тихой конфигурационный файл должен быть тем же, который вы использовали для установки Edge 4.16.01 или 4.16.05.
Процедура обновления до 4.18.01 на узле с внешним подключением к Интернету
Используйте следующую процедуру для обновления компонентов Edge на узле:
- Если вы в настоящее время используете репликацию Postgres Master-Standby, установите новый резервный узел Postgres, как описано выше, при установке нового резервного узла Postgres .
- Если они присутствуют, отключите все задания CRON, настроенные для выполнения операции восстановления в Cassandra, до завершения обновления.
- Войдите на свой узел как root, чтобы установить Edge RPM.
ПРИМЕЧАНИЕ . В то время как установка RPM требует доступа к корнеу, вы можете выполнить конфигурацию края без доступа к корнеу. - Установите yum-utils и yum-plugin-priorities :
> Sudo Yum установить Yum-UTILS
> Sudo yum установить yum-plugin-priority - Отключите SELinux, как описано в разделе Установка утилиты Edge apigee-setup .
- Включить Epel Repo, как описано выше.
- Если вы устанавливаете Oracle 7.x , выполните следующую команду:
> sudo yum-config-manager-ol7_optional_latest - Если вы выполняете установку на AWS , выполните следующие команды yum-configure-manager :
> yum update rh-amazon-rhui-client.noarch
> Sudo yum-config-manager-rhui-region-rhel-server-extras rhui-region-rhel-server-optional - Загрузите Edge 4.18.01 bootstrap_4.18.01.sh файл в /тмп /bootstrap_4.18.01.sh :
> curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh - Установите Edge 4.18.01 Утилита и зависимости Apigee-Service :
> sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser = uname apigeepassword = pword
где uName:pWord — имя пользователя и пароль, полученные вами от Apigee. Если вы опустите pWord , вам будет предложено ввести его.
По умолчанию программа установки проверяет, установлена ли у вас Java 1.8. Если вы этого не сделаете, он установит его за вас. Используйте опцию JAVA_FIX , чтобы указать, как обрабатывать установку Java. JAVA_FIX принимает следующие значения:
I = установить OpenJDK 1.8 (по умолчанию)
C = продолжить без установки Java
Q = уйти. Для этого варианта вам придется установить Java самостоятельно. - Используйте apigee-service для обновления утилиты apigee-setup:
- Если вы установили 4.16.01 с помощью обновления Edge версии 4.15.07.0x, вы должны установить утилиту Apigee-Setup:
>/opt/apigee/apigee-service/bin/apigee-service apigee-setup установка
Эта команда устанавливает утилиту Update.sh в /Opt/Apigee/Apigee-Setup/Bin .
Если вы уже установили утилиту Apigee-Setup , то обновите ее:
>/opt/apigee/apigee-service/bin/apigee-service apigee-setup - Если вы установили 4.16.01 напрямую, то есть вы не выполнили обновление с 4.15.07.0x, вы должны обновить утилиту Apigee-Setup :
>/opt/apigee/apigee-service/bin/apigee-service apigee-setup
Это обновление на Apigee-Service устанавливает утилиту Update.sh в /Opt/Apigee/Apigee-Setup/Bin . - Если вы установили 4.16.05 напрямую или по обновлению, вы должны обновить утилиту Apigee-Setup :
>/opt/apigee/apigee-service/bin/apigee-service apigee-setup
Это обновление на Apigee-Service устанавливает утилиту Update.sh в /Opt/Apigee/Apigee-Setup/Bin .
- Если вы установили 4.16.01 с помощью обновления Edge версии 4.15.07.0x, вы должны установить утилиту Apigee-Setup:
- В зависимости от вашей текущей версии Edge, вы должны либо установить, либо обновить утилиту Apigee-Validate на сервере управления.
- Если вы в настоящее время используете Edge 4.16.05 : обновите утилиту Apigee-Validate на сервере управления:
>/opt/apigee/apigee-service/bin/apigee-service-валидат - Если вы в настоящее время используете Edge 4.16.01 : Установите утилиту Apigee-Validate на сервере управления:
>/opt/apigee/apigee-service/bin/apigee-service-validate install
Примечание . Если вы установили утилиту Apigee-Validate на узле процессора сообщений при установке 4.16.01, вы можете обновить ее, используя следующую команду на этом узле:
>/opt/apigee/apigee-service/bin/apigee-service-валидат
Однако по состоянию на 4.16.05 и позже Apigee рекомендует установить и запустить утилиту Apigee-Validate на сервере управления. - Если вы обновляетесь с 4.16.01 : отредактируйте файл конфигурации, переданный в утилиту Apigee-Validate . В выпуске Edge 4.16.01 файл конфигурации, используемый Apigee-Validate, требовал следующих свойств:
Apigee_adminpw = sysadminpword
Mp_pod = gateway
Область = dc-1
В этом выпуске файл конфигурации требует только свойства APIGEE_ADMINPW . Вы можете удалить два других свойства из файла.
- Если вы в настоящее время используете Edge 4.16.05 : обновите утилиту Apigee-Validate на сервере управления:
- Обновите утилиту Apigee-Provision :
>/opt/apigee/apigee-service/bin/apigee-service apigee-provision - Запустите утилиту Update на ваших узлах в порядке, описанном ниже в « Порядок обновления машины » ниже:
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configfile
Единственное требование к файлу конфигурации состоит в том, что файл конфигурации должен быть доступен или доступен для чтения пользователю «apigee».
Используйте опцию «-c», чтобы указать компонент для обновления. Список возможных компонентов включает в себя:
ldap = openldap
CS = Cassandra
zk = Zookeeper
qpid = qpidd
PS = PostgreSQL
Edge = все компоненты Edge, кроме Edge UI: сервер управления, процессор сообщений, маршрутизатор, QPID -сервер, Postgres Server
UI = Edge UI
All = Обновить все компоненты на машине (используйте только для профиля установки AIO или профиля установки API BAAS ASA)
E = Elasticsearch
b = стек API BAAS
P = портал API BAAS
EBP = Elasticsearch, API BAAS Stack и Portal API BAAS на том же узле - Проверьте обновление, запустив утилиту apigee-validate на сервере управления, как описано в разделе «Проверка установки» .
- Если вы установили новый резервный узел Postgres, выводя из эксплуатации узел, как описано выше, при из эксплуатации постгресс -узла .
Чтобы позднее откатить от обновления, используйте процедуру, описанную в процессе отката 4.18.01 .
Процедура обновления до 4.18.01 из локального репо
Если ваши пограничные узлы находятся за брандмауэром или каким-либо другим образом им запрещен доступ к репозиторию Apigee через Интернет, вы можете выполнить обновление из локального репозитория или зеркала репозитория Apigee.
После создания локального репозитория Edge у вас есть два варианта обновления Edge из локального репозитория:
- Создайте файл .tar репозитория, скопируйте файл .tar на узел, а затем обновите Edge из файла .tar.
- Установите веб-сервер на узле с локальным репозиторием, чтобы другие узлы могли получить к нему доступ. Apigee предоставляет вам веб-сервер Nginx, или вы можете использовать свой собственный веб-сервер.
Обновить из локального репо 4.18.01:
- Если вы в настоящее время используете репликацию Postgres Master-Standby, установите новый резервный узел Postgres, как описано выше, при установке нового резервного узла Postgres .
- Создайте локальный репо 4.18.01, как описано в «Создать локальный репозиторий Apigee» в установке утилиты Edge Apigee-Setup .
Примечание . Если у вас уже есть существующий репо 4.16.01 или 4.16.05, вы можете добавить к нему 4.18.01, как описано в «Обновление локального репозитория Apigee» при установке утилиты Apigee Setup . - Чтобы установить сервис apigee из файла .tar :
- На узле с локальным репо, используйте следующую команду, чтобы упаковать локальный репо в один файл .tar с именем /opt/apigee/data/ apigee-mirror/apigee-4.18.01.tar.gz:
>/opt/apigee/apigee-service/bin/apigee-service-mirror package - Скопируйте файл .tar на узел, где вы хотите обновить Edge. Например, скопируйте его в каталог /tmp на новом узле.
- На новом узле распакуйте файл в каталог /tmp:
> tar -xzf apigee -4.18.01.tar.gz
Эта команда создает новый каталог с именем repos в каталоге, содержащем файл .tar. Например /tmp/репозитории. - Установите утилиту и зависимости Edge Apigee-Service от /tmp /Repos:
> sudo bash /tmp/repos/bootstrap_4.18.01.sh apigeeprotocol = "file: //" apigeerepobasepath =/tmp/repos
Обратите внимание, что в эту команду вы включаете путь к каталогу репозитория.
- На узле с локальным репо, используйте следующую команду, чтобы упаковать локальный репо в один файл .tar с именем /opt/apigee/data/ apigee-mirror/apigee-4.18.01.tar.gz:
- Чтобы установить сервис apigee с помощью веб-сервера Nginx:
- Настройте веб-сервер Nginx, как описано в разделе «Установка из репозитория с помощью веб-сервера Nginx» в разделе «Установка утилиты Edge apigee-setup» .
- На удаленном узле загрузите файл Edge Bootstrap_4.18.01.sh в файл /tmp/bootstrap_4.18.01.sh :
>/usr/bin/curl http: // uname: pword @ remoterepo : 3939/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
где uName:pWord — это имя пользователя и пароль, которые вы установили выше для репозитория, а RemoteRepo — это IP-адрес или DNS-имя узла репо. - На удаленном узле установите утилиту Edge apigee-service и зависимости:
> sudo bash /tmp/bootstrap_4.18.01.sh apigeerepohost = remoteRepo : 3939 apigeeuser = uname apigeepassword = pword apigeeprotocol = http: //
где uName:pWord — имя пользователя и пароль репозитория.
- Используйте apigee-service для обновления утилиты apigee-setup:
- Если вы установили 4.16.01 с помощью обновления Edge версии 4.15.07.0x, вы должны установить утилиту Apigee-Setup:
>/opt/apigee/apigee-service/bin/apigee-service apigee-setup установка
Эта команда устанавливает утилиту Update.sh в /Opt/Apigee/Apigee-Setup/Bin .
Если вы уже установили утилиту Apigee-Setup , то обновите ее:
>/opt/apigee/apigee-service/bin/apigee-service apigee-setup - Если вы установили 4.16.01 напрямую, то есть вы не выполнили обновление с 4.15.07.0x, вы должны обновить утилиту Apigee-Setup:
>/opt/apigee/apigee-service/bin/apigee-service apigee-setup
Это обновление на Apigee-Service устанавливает утилиту Update.sh в /Opt/Apigee/Apigee-Setup/Bin . - Если вы установили 4.16.05 напрямую или по обновлению, вы должны обновить утилиту Apigee-Setup:
>/opt/apigee/apigee-service/bin/apigee-service apigee-setup
Это обновление на Apigee-Service устанавливает утилиту Update.sh в /Opt/Apigee/Apigee-Setup/Bin .
- Если вы установили 4.16.01 с помощью обновления Edge версии 4.15.07.0x, вы должны установить утилиту Apigee-Setup:
- В зависимости от вашей текущей версии Edge, вы должны либо установить, либо обновить утилиту Apigee-Validate на сервере управления.
- Если вы в настоящее время используете Edge 4.16.05 : обновите утилиту Apigee-Validate на сервере управления:
>/opt/apigee/apigee-service/bin/apigee-service-валидат - Если вы в настоящее время используете Edge 4.16.01 : Установите утилиту Apigee-Validate на сервере управления:
>/opt/apigee/apigee-service/bin/apigee-service-validate install
Примечание . Если вы установили утилиту Apigee-Validate на узле процессора сообщений при установке 4.16.01, вы можете обновить ее, используя следующую команду на этом узле:
>/opt/apigee/apigee-service/bin/apigee-service-валидат
Однако по состоянию на 4.16.05 и позже Apigee рекомендует установить и запустить утилиту Apigee-Validate на сервере управления. - Если вы обновляетесь с 4.16.01 : отредактируйте файл конфигурации, переданный в утилиту Apigee-Validate . В выпуске Edge 4.16.01 файл конфигурации, используемый Apigee-Validate, требовал следующих свойств:
Apigee_adminpw = sysadminpword
Mp_pod = gateway
Область = dc-1
В этом выпуске файл конфигурации требует только свойства APIGEE_ADMINPW . Вы можете удалить два других свойства из файла.
- Если вы в настоящее время используете Edge 4.16.05 : обновите утилиту Apigee-Validate на сервере управления:
- Обновите утилиту Apigee-Provision :
>/opt/apigee/apigee-service/bin/apigee-service apigee-provision - Запустите утилиту Update на ваших узлах в порядке, описанном ниже в «Порядок обновления машины» ниже:
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configfile
Единственное требование к файлу конфигурации состоит в том, что файл конфигурации должен быть доступен или доступен для чтения пользователю «apigee».
Используйте опцию «-c», чтобы указать компонент для обновления. Список возможных компонентов включает в себя:
ldap = openldap
CS = Cassandra
zk = Zookeeper
qpid = qpidd
PS = PostgreSQL
Edge = все компоненты Edge, кроме Edge UI: сервер управления, процессор сообщений, маршрутизатор, QPID -сервер, Postgres Server
UI = Edge UI
All = Обновить все компоненты на машине (используйте только для профиля установки AIO или профиля установки API BAAS ASA)
E = Elasticsearch
b = стек API BAAS
P = портал API BAAS
EBP = Elasticsearch, API BAAS Stack и Portal API BAAS на том же узле - Проверьте обновление, запустив утилиту apigee-validate на сервере управления, как описано в разделе «Проверка установки» .
- Если вы установили новый резервный узел Postgres, выводя из эксплуатации узел, как описано выше, при из эксплуатации постгресс -узла .
Чтобы позднее откатить от обновления, используйте процедуру, описанную в процессе отката 4.18.01 .
Порядок обновления машины
Порядок, который вы обновляете машины в установке края, важен. Наиболее важными соображениями для обновления являются:
- Вы должны обновить все узлы Cassandra и ZooKeeper, прежде чем обновлять любые другие узлы.
- Для любой машины с несколькими краевыми компонентами (сервер управления, процессор сообщений, маршрутизатор, QPID-сервер, но не сервер Postgres), используйте параметр «-C Edge», чтобы обновить их все одновременно.
- Если для шага указано, что его следует выполнить на нескольких компьютерах, выполните его в указанном порядке компьютеров.
- Отдельного шага по обновлению монетизации не требуется. Он обновляется, когда вы указываете опцию «-C Edge».
Для автономной установки 1 хост
- Установите smtpmailfrom в вашем файле конфигурации, если вы включили SMTP на краю. Этот параметр имеет форму:
Smtpmailfrom = "Моя компания <myco@company.com>" - Если обновление с 4.16.01 , понизить Zookeeper:
> yum понижать Apigee-Zookeeper - Обновите Кассандру и ZooKeeper:
> /opt/apigee/apigee-setup/bin/update.sh -c CS, zk -f configfile - Установите следующее правило iptables:
> sudo iptables -a вход -p tcp -destination -port 5672! -s `hostname` -i eth0 -j drop - Проверьте очередь сообщения QPID:
> qpid -stat -q
Продолжайте проверять очередь до тех пор, пока количество в столбце «MSG» не станет 0. Вы не можете обновить QPID, пока не обработает все сообщения. - Обновление QPIDD :
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configfile - Flush Iptables:
> sudo iptables -f - Обновить LDAP:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configfile - Остановить сервер Postgres, QPID Server и PostgreSQL:
>/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server
>/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server
>/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql - Обновление PostgreSQL:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configfile - Обновите базу данных Postgres:
>/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade - Обновите оставшиеся компоненты края:
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile - Обновление Edge UI:
> /opt/apigee/apigee-setup/bin/update.sh -c UI -f configFile
Для автономной установки на 2 хоста
См. Топологии установки для списка топологий края и номеров узлов.
- Установите smtpmailfrom в вашем файле конфигурации, если вы включили SMTP на краю. Этот параметр имеет форму:
Smtpmailfrom = "Моя компания <myco@company.com>" - Если обновление с 4.16.01 , понизить Zookeeper на машине 1:
> yum понижать Apigee-Zookeeper - Обновите Cassandra и ZooKeeper на машине 1:
> /opt/apigee/apigee-setup/bin/update.sh -c CS, zk -f configfile - Установите следующее правило iptables на машине 2:
> sudo iptables -a вход -p tcp -destination -port 5672! -s `hostname` -i eth0 -j drop - Проверьте очередь сообщений QPID на машине 2:
> qpid -stat -q
Продолжайте проверять очередь до тех пор, пока количество в столбце «MSG» не станет 0. Вы не можете обновить QPID, пока не обработает все сообщения. - Обновите QPIDD на машине 2:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - Flush iptables on machine 2:
> sudo iptables -F - Обновите LDAP на машине 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile - Update Edge components on machine 1:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - Обновите пользовательский интерфейс на компьютере 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile - Update postgresql on machine 2:
- Stop Postgres Server, Qpid server, and postgresql:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - Update postgresql:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Update the Postgres database:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade - Update Edge components on machine 2:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Stop Postgres Server, Qpid server, and postgresql:
For a 5-host clustered installation
See Installation Topologies for the list of Edge topologies and node numbers.
- Set SMTPMAILFROM in your configuration file if you have enabled SMTP on Edge. This parameter has the form:
SMTPMAILFROM="My Company <myco@company.com>" - Ensure that you have installed a new Postgres standby node as described above in Installing a new Postgres standby node .
- If updating from 4.16.01 , downgrade Zookeeper on machine 1, 2, and 3:
> yum downgrade apigee-zookeeper - Обновите Cassandra и ZooKeeper на машинах 1, 2 и 3:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile - Set the following iptables rule on machine 4:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP - Check the Qpid message queue on machine 4:
> qpid-stat -q
Continue to check the queue until the count in the "msg" column is 0. You cannot upgrade Qpid until it has processed all messages. - Обновите qpidd на машине 4:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - Flush iptables on machine 4:
> sudo iptables -F - Repeat steps 5 through 8 on machine 5.
- Обновите LDAP на машине 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile - Update Edge components on machine 1, 2, 3:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - Обновите пользовательский интерфейс на компьютере 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile - Update machines 4 and 5:
- Stop Postgres server and Qpid server on machine 4:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop - Stop Postgres server, Qpid server, and postgresql on machine 5:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - Stop Postgres server and postgresql on the new standby node that you added for rollback:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - Update postgresql on machines 4:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Update the Postgres database on machine 4 (Postgres master only):
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade - Update postgresql on machines 5:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Start Postgres server and Qpid server on machines 4 and 5:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start - Configure Postgres as a standby node by running the following commands on machine 5:
> cd /opt/apigee/data/apigee-postgresql/pgdata
> rm -rf *
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile - Verify the replication status by issuing the following scripts on both servers. The system should display identical results on both servers to ensure a successful replication:
On the machine 4, the master node, run:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
Validate that it says it is the master.
On machine 5, the standby node:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
Validate that it says it is the standby.
- Stop Postgres server and Qpid server on machine 4:
- Update Edge components on machine 4, 5:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - Ensure that you decommission the new standby node by using the procedure above in Decommissioning a Postgres node .
For a 9-host clustered installation
See Installation Topologies for the list of Edge topologies and node numbers.
- Set SMTPMAILFROM in your configuration file if you have enabled SMTP on Edge. This parameter has the form:
SMTPMAILFROM="My Company <myco@company.com>" - Ensure that you have installed a new Postgres standby node as described above in Installing a new Postgres standby node .
- If updating from 4.16.01 , downgrade Zookeeper on macine 1, 2, and 3:
> yum downgrade apigee-zookeeper - Обновите Cassandra и ZooKeeper на машинах 1, 2 и 3:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile - Set the following iptables rule on machine 6:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP - Check the Qpid message queue on machine 6:
> qpid-stat -q
Continue to check the queue until the count in the "msg" column is 0. You cannot upgrade Qpid until it has processed all messages. - Update qpidd on machine 6:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - Flush iptables on machine 6:
> sudo iptables -F - Repeat steps 5 through 8 on machine 7.
- Обновите LDAP на машине 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile - Update Edge components on machine 6, 7, 1, 4, and 5 in that order:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - Обновите пользовательский интерфейс на компьютере 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile - Update machines 8 and 9:
- Stop Postgres server on machine 8:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop - Stop Postgres server and postgresql on machine 9:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - Stop Qpid server on machines 6 and 7:
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop - Stop Postgres server and postgresql on the new standby node that you added for rollback:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - Update postgresql on machines 8:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Update the Postgres database on machine 8 (Postgres master only):
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade - Update postgresql on machines 9:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Start Postgres server server on machines 8 and 9:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start - Start Qpid server server on machines 6 and 7:
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start - Configure Postgres as a standby node by running the following commands on machine 9:
> cd /opt/apigee/data/apigee-postgresql/pgdata
> rm -rf *
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile - Verify the replication status by issuing the following scripts on both servers. The system should display identical results on both servers to ensure a successful replication:
On the machine 8, the master node, run:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
Validate that it says it is the master.
On machine 9, the standby node:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
Validate that it says it is the standby.
- Stop Postgres server on machine 8:
- Update Edge components on machine 8 and 9:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - Ensure that you decommission the new standby node by using the procedure above in Decommissioning a Postgres node .
For a 13-host clustered installation
See Installation Topologies for the list of Edge topologies and node numbers.
- Set SMTPMAILFROM in your configuration file if you have enabled SMTP on Edge. This parameter has the form:
SMTPMAILFROM="My Company <myco@company.com>" - Ensure that you have installed a new Postgres standby node as described above in Installing a new Postgres standby node .
- If updating from 4.16.01 , downgrade Zookeeper on macine 1, 2, and 3:
> yum downgrade apigee-zookeeper - Обновите Cassandra и ZooKeeper на машинах 1, 2 и 3:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile - Set the following iptables rule on machine 12:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP - Check the Qpid message queue on machine 12:
> qpid-stat -q
Continue to check the queue until the count in the "msg" column is 0. You cannot upgrade Qpid until it has processed all messages. - Update qpidd on machine 12:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - Flush iptables on machine 12:
> sudo iptables -F - Repeat steps 5 through 8 on machine 13.
- Обновите LDAP на машинах 4 и 5:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile - Update Edge components on machine 12, 13, 6, 7, 10, and 11 in that order:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - Update UI on machine 6 and 7:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile - Update machines 8 and 9:
- Stop Postgres server on machine 8:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop - Stop Postgres server and postgresql on machine 9:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - Stop Qpid server on machines 12 and 13:
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop - Stop Postgres server and postgresql on the new standby node that you added for rollback:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - Update postgresql on machines 8:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Update the Postgres database on machine 8 (Postgres master only):
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade - Update postgresql on machines 9:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Start Postgres server on machines 8 and 9:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start - Start Qpid server server on machines 12 and 13:
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start - Configure Postgres as a standby node by running the following commands on machine 9:
> cd /opt/apigee/data/apigee-postgresql/pgdata
> rm -rf *
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile - Verify the replication status by issuing the following scripts on both servers. The system should display identical results on both servers to ensure a successful replication:
On the machine 8, the master node, run:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
Validate that it says it is the master.
On machine 9, the standby node:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
Validate that it says it is the standby.
- Stop Postgres server on machine 8:
- Update Edge components on machine 8 and 9:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - Ensure that you decommission the new standby node by using the procedure above in Decommissioning a Postgres node .
For a 12-host clustered installation
See Installation Topologies for the list of Edge topologies and node numbers.
- Set SMTPMAILFROM in your configuration file if you have enabled SMTP on Edge. This parameter has the form:
SMTPMAILFROM="My Company <myco@company.com>" - Ensure that you have installed a new Postgres standby node as described above in Installing a new Postgres standby node .
- Обновите Кассандру и ZooKeeper:
- If updating from 4.16.01 , downgrade Zookeeper on macine 1, 2, and 3 in Data Center 1:
> yum downgrade apigee-zookeeper - На компьютерах 1, 2 и 3 в центре обработки данных 1:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile - If updating from 4.16.01 , downgrade Zookeeper on macine 7, 8, and 9 in Data Center 2:
> yum downgrade apigee-zookeeper - На компьютерах 7, 8 и 9 в дата-центре 2.
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- If updating from 4.16.01 , downgrade Zookeeper on macine 1, 2, and 3 in Data Center 1:
- Обновить qpidd:
- Машины 4, 5 в дата-центре 1
- Set the following iptables rule on machine 4:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP - Check the Qpid message queue on machine 4:
> qpid-stat -q
Continue to check the queue until the count in the "msg" column is 0. You cannot upgrade Qpid until it has processed all messages. - Обновите qpidd на машине 4:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - Flush iptables on machine 4:
> sudo iptables -F - Repeat steps 1 through 4 on machine 5.
- Set the following iptables rule on machine 4:
- Машины 10, 11 в ЦОД 2
- Set the following iptables rule on machine 10:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP - Check the Qpid message queue on machine 10:
> qpid-stat -q
Continue to check the queue until the count in the "msg" column is 0. You cannot upgrade Qpid until it has processed all messages. - Обновите qpidd на машине 10:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - Flush iptables on machine 10:
> sudo iptables -F - Repeat steps 1 through 4 on machine 11.
- Set the following iptables rule on machine 10:
- Машины 4, 5 в дата-центре 1
- Обновить LDAP:
- Machines 1 in Data Center 1
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile - Machines 7 in Data Center 2
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Machines 1 in Data Center 1
- Обновите компоненты Edge:
- Machines 4, 5, 1, 2, 3 in Data Center 1
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - Machines 10, 11, 7, 8, 9 in Data Center 2
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Machines 4, 5, 1, 2, 3 in Data Center 1
- Обновить пользовательский интерфейс:
- Машина 1 в дата-центре 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile - Машина 7 в дата-центре 2:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- Машина 1 в дата-центре 1:
- Update machine 6 in Data Center 1 and 12 in Data Center 2:
- Stop Postgres server on machine 6:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop - Stop Postgres server and postgresql on machine 12:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - Stop Qpid server on machines 4, 5, 10, and 11:
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop - Stop Postgres server and postgresql on the new standby node that you added for rollback:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - Update postgresql on machines 6:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Update the Postgres database on machine 6 (Postgres master only):
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade - Update postgresql on machines 12:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Start Postgres server server on machines 6 and 12:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start - Start Qpid server server on machines 4, 5, 10, and 11:
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start - Configure Postgres as a standby node by running the following commands on machine 12:
> cd /opt/apigee/data/apigee-postgresql/pgdata
> rm -rf *
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile - Verify the replication status by issuing the following scripts on both servers. The system should display identical results on both servers to ensure a successful replication:
On the machine 6, the master node, run:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
Validate that it says it is the master.
On machine 12, the standby node:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
Validate that it says it is the standby.
- Stop Postgres server on machine 6:
- Update Edge components on machine 6 and 12:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - Ensure that you decommission the new standby node by using the procedure above in Decommissioning a Postgres node .
For a 7-host or 10-host API BaaS installation
For a non-standard installation
If you have a non-standard installation, then update Edge components in the following order:
- смотритель зоопарка
- Кассандра
- qpidd
- ЛДАП
- Edge, meaning the "-c edge" profile on all nodes in the order: nodes with Qpid server but not the Postgres server, Management Server, Message Processor, and Router.
Note : If the node has both Qpid server and Postgres server installed, run the "-c edge" profile step as part of step 8. - Пограничный интерфейс
- postgresql on the Postgres master, including upgrade.
- postgresql on the Postgres standby.
- Edge, meaning the "-c edge" profile on all combined Qpid and Postgres nodes, or on any standalone Postgres nodes.
Edge для частного облака v4.18.01
Which Edge versions can you update to 4.18.01
You can update Apigee Edge version 4.16.01.0x and 4.16.05.x to 4.18.01 using this procedure.
If you have a version of Edge previous to version 4.16.01, then you must first migrate to version 4.16.01 and then update to version 4.18.01.
- You can migrate Apigee Edge version 4.15.07 to 4.16.01.
- If you have a version of Edge previous to version 4.15.07, then you must first migrate to version 4.15.07 and then to version 4.16.01.
- If you are migrating from Edge version 4.14.04 or later: Directly migrate to version 4.15.07.
- If you are migrating from Edge version 4.14.01: You must first migrate to version 4.14.04, and then migrate to version 4.15.07.
Кто может выполнить обновление
Пользователь, запускающий обновление, должен быть тем же пользователем, который первоначально установил Edge, или пользователем, работающим под учетной записью root.
После установки Edge RPM их сможет настроить любой пользователь.
Какие компоненты необходимо обновить
Вам необходимо обновить все компоненты Edge. Edge не поддерживает установку, содержащую компоненты из нескольких версий.
Downgrading Zookeeper if updating from 4.16.01
The version of the Zookeeper RPM in Edge for Private Cloud 4.16.01 is apigee-zookeeper-3.4.5-1.0.905.noarch.rpm . In subsequent versions of Edge, the Zookeeper version was changed back to apigee-zookeeper-3.4.5-0.0.94x . This prevents yum from upgrading Zookeeper to a later versions from 4.16.01. The way to correct this situation is to run yum downgrade apigee-zookeeper before updating Zookeeper.
You can check your Zookeeper version by using the following command:
> rpm -qa |grep apigee-zookeeper
If this command returns Zookeeper version:
apigee-zookeeper-3.4.5-1.0.905
Then you must do the downgrade.
Автоматическое распространение настроек свойств
Если вы установили какие-либо свойства, отредактировав файлы .properties в /opt/apigee/customer/application , эти значения сохраняются при обновлении.
Обновить необходимые условия
Перед обновлением Apigee Edge позаботьтесь о следующих предварительных условиях:
- Резервное копирование всех узлов
Перед обновлением рекомендуется выполнить полное резервное копирование всех узлов в целях безопасности. Используйте процедуру для вашей текущей версии Edge для выполнения резервного копирования.
Это позволяет вам иметь запасной план на случай, если обновление до новой версии не будет работать должным образом. For more information on backup, see Backup and Restore . - Убедитесь, что Edge работает
Убедитесь, что Edge запущен и работает во время процесса обновления, используя команду:
> /opt/apigee/apigee-service/bin/apigee-all status
Обработка неудачного обновления
В случае сбоя обновления вы можете попытаться исправить проблему, а затем снова запустить update.sh. Вы можете запускать обновление несколько раз, и оно продолжится с того места, где оно было остановлено в последний раз.
If the failure requires that you roll back the update to your previous version, see 4.18.01 Rollback Process for more.
Регистрация информации об обновлении
По умолчанию утилита update.sh записывает информацию журнала в:
/opt/apigee/var/log/apigee-setup/update.log
Если пользователь, запускающий утилиту update.sh, не имеет доступа к этому каталогу, он записывает журнал в каталог /tmp в виде файла с именем update_username.log .
Если у пользователя нет доступа к /tmp , утилита update.sh завершится сбоем.
Required upgrade to Java JDK Version 8
This release of Edge requires that you have installed Java JDK version 8 on all Edge processing nodes. You can install the Oracle JDK 8 or OpenJDK 8. If Java JDK 8 is not installed already, the update script can install it for you.
As part of the update to Java 8, some TLS ciphers are no longer available in Oracle JDK 8. For the complete list, see the section "Default Disabled Cipher Suites" at http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html .
Required to enable EPEL repo
You must enable Extra Packages for Enterprise Linux (or EPEL) to install or update Edge. Используемая вами команда зависит от вашей версии RedHat/CentOS:
- For RedHat/CentOS 7.x:
> wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; rpm -ivh epel-release-latest-7.noarch.rpm - For RedHat/CentOS 6.x:
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; rpm -ivh epel-release-latest-6.noarch.rpm
Required addition of SMTPMAILFROM configuration parameter
Edge 4.17.05 added a new required parameter to the configuration file used when you enable an SMTP server. If you are updating from 4.17.01, then you must set SMTPMAILFROM in the configuration file when enabling the SMTP server.
API BaaS version 4.17.09 also added support for the SMTPMAILFROM property. When updating API BaaS, you must set SMTPMAILFROM in the configuration file.
This parameter has the form:
SMTPMAILFROM="My Company <myco@company.com>"
Required if updating when using external authentication
You can integrate an external directory service into an existing Apigee Edge Private Cloud installation. This feature is designed to work with any directory service that supports LDAP, such as Active Directory, OpenLDAP, and others. An external LDAP solution allows system administrators to manage user credentials from a centralized directory management service, external to systems like Apigee Edge that use them.
See External Authentication Configuration for more.
When external authentication is enabled, most customers use the Active Directory SAM account name field as the username for authentication, instead of an email address which is used by the Edge OpenLDAP server.
If you have integrated with an external directory service, then add the following line to your config file when updating Edge to 4.18.01:
IS_EXTERNAL_AUTH="true"
This line configures Edge to support an account name, rather than an email address, as the username.
Required upgrade to Qpid 1.35
This release contains a required update to Qpid 1.35. As part of updating a Qpid node, you have to:
- Temporarily prevent Routers and Message Processors from writing to the Qpid node by blocking port 5672 on the Qpid node. You can use the following command to block this port on the Qpid node:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP - Wait for the Qpid queue to empty of messages to ensure that the Qpid node has processed all messages before the update. Use the following command to ensure that the Qpid message queue is empty:
> qpid-stat -q - Update the Qpid node.
- Unblock port 5672 on the Qpid node to allows access from Routers and Message Processors. You can use the following command to unblock this port:
> sudo iptables -F
Note that if you are using iptables for other rules, you can use the -D option to reverse the specific change:
> sudo iptables -D INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
This process is described in detail below for each Edge topology.
Required upgrade to Postgres 9.6
This release of Edge includes an upgrade to Postgres 9.6. As part of that upgrade, all Postgres data is migrated to the Postgres 9.6.
During the update process, while the Postgres nodes are down for update, analytics data is still written to the Qpid nodes. After the Postgres nodes are updated and back online, analytics data is then pushed to the Postgres nodes.
The additional Postgres standby node is required if you have to roll back the update for any reason. If you have to roll back the update, the new Postgres standby node becomes the master Postgres node after the rollback. Therefore, when you install the new Postgres standby node, it should be on a node that meets all the hardware requirements of a Postgres server, as defined in the Edge Installation Requirements .
Installing a new Postgres standby node
This procedure creates a Postgres standby server on a new node. Ensure that you install a new Postgres standby server for your existing version of Edge (4.16.01 or 4.16.05), not for version 4.18.01.
To perform the install, use the same config file that you used to install your current version of Edge.
To create a new Postgres standby node:
- On the current Postgres master, edit the /opt/apigee/customer/application/postgresql.properties file to set the following token. Если этот файл не существует, создайте его:
conf_pg_hba_replication.connection=host replication apigee existing_slave_ip /32 trust\ \nhost replication apigee new_slave_ip /32 trust
where existing_slave_ip is the IP address of the current Postgres standby server and new_slave_ip is the IP address of the new standby node. - Restart apigee-postgresql on the Postgres master:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart - Verify that the new standby node was added by viewing the /opt/apigee/apigee-postgresql/conf/pg_hba.conf file on the master. You should see the following lines in that file:
host replication apigee existing_slave_ip/32 trust
host replication apigee new_slave_ip/32 trust - Install the new Postgres standby server:
- Edit the config file that you used to install your current version of Edge to specify the following:
# 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 - Disable SELinux as described at Install the Edge apigee-setup utility .
- Download the Edge bootstrap_4.16.05.sh file to /tmp/bootstrap_4.16.05.sh :
> curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
Note : If you are updating from 4.16.01, download the Edge bootstrap.sh file. - Установите утилиту Edge apigee-service и зависимости:
> sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser= uName apigeepassword= pWord - Используйте apigee-service для установки утилиты apigee-setup :
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install - Install Postgres:
> /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile - On the new standby node run the following command:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
Validate that it says it is the standby.
- Edit the config file that you used to install your current version of Edge to specify the following:
Decommissioning a Postgres node
After the update completes, decommission the new standby node:
- Make sure Postgres is running:
> /opt/apigee/apigee-service/bin/apigee-all status
If Postgres is not running, start it:
> /opt/apigee/apigee-service/bin/apigee-all start - Get the UUID of the new standby node by running the following cURL command on the new standby node:
> curl -u sysAdminEmail:password http:// <node_IP> :8084/v1/servers/self
You should see the UUID of the node at the end of the output, in the form:
"type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75" - Stop the new standby node by running the following command on the new standby node:
> /opt/apigee/apigee-service/bin/apigee-all stop - On the Postgres master node, edit /opt/apigee/customer/application/postgresql.properties to remove the new standby node from conf_pg_hba_replication.connection :
conf_pg_hba_replication.connection=host replication apigee existing_slave_ip /32 trust - Restart apigee-postgresql on the Postgres master:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart - Verify that the new standby node was removed by viewing the /opt/apigee/apigee-postgresql/conf/pg_hba.conf file on the master. You should see only the following line in that file:
host replication apigee existing_slave_ip /32 trust - Delete the UUID of the standby node from ZooKeeper by making the following Edge management API call on the Management Server node:
> curl -u sysAdminEmail:password -X DELETE http:// <ms_IP> :8080/v1/servers/ <new_slave_uuid>
Обновление без простоев
Обновление с нулевым временем простоя или чередующееся обновление позволяет обновить установку Edge без отключения Edge.
Обновление с нулевым временем простоя возможно только в конфигурации с 5 узлами и более.
Ключом к обновлению без простоев является удаление каждого маршрутизатора по одному из балансировщика нагрузки. Затем вы обновляете Маршрутизатор и любые другие компоненты на том же компьютере, что и Маршрутизатор, а затем добавляете Маршрутизатор обратно в балансировщик нагрузки.
- Update the machines in the correct order for your installation as described below in "Order of machine update".
- Когда придет время обновить маршрутизаторы, выберите любой маршрутизатор и сделайте его недоступным, как описано в разделе «Включение/выключение доступности сервера (процессора сообщений/маршрутизатора)» .
- Обновите выбранный маршрутизатор и все другие компоненты Edge на том же компьютере, что и маршрутизатор. Во всех конфигурациях Edge маршрутизатор и процессор сообщений расположены на одном узле.
- Снова сделайте маршрутизатор доступным.
- Повторите шаги 2–4 для остальных маршрутизаторов.
- Продолжите обновление для всех оставшихся компьютеров в вашей установке.
Позаботьтесь о следующем до/после обновления:
- На объединенном узле маршрутизатора и процессора сообщений:
- Перед обновлением выполните следующее:
- Сделайте маршрутизатор недоступным.
- Сделайте процессор сообщений недоступным.
- После обновления - выполните следующее:
- Сделайте процессор сообщений доступным.
- Сделайте маршрутизатор доступным.
- Перед обновлением выполните следующее:
- На одном узле маршрутизатора:
- Перед обновлением сделайте Роутер недоступным.
- После обновления сделайте маршрутизатор доступным.
- На одном узле процессора сообщений:
- Перед обновлением сделайте процессор сообщений недоступным.
- После обновления сделайте процессор сообщений доступным.
Использование тихого файла конфигурации
Вы должны передать файл конфигурации в автоматическом режиме команде обновления. The silent configuration file should be the same one you used to install Edge 4.16.01 or 4.16.05.
Procedure for updating to 4.18.01 on a node with an external internet connection
Используйте следующую процедуру для обновления компонентов Edge на узле:
- If you are currently using Postgres master-standby replication, install a new Postgres standby node as described above in Installing a new Postgres standby node .
- Если они присутствуют, отключите все задания CRON, настроенные для выполнения операции восстановления в Cassandra, до завершения обновления.
- Войдите на свой узел как root, чтобы установить Edge RPM.
Note : While RPM installation requires root access, you can perform Edge configuration without root access. - Установите yum-utils и yum-plugin-priorities :
> sudo yum install yum-utils
> sudo yum install yum-plugin-priorities - Отключите SELinux, как описано в разделе Установка утилиты Edge apigee-setup .
- Enable EPEL repo as described above.
- Если вы устанавливаете 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 - Download the Edge 4.18.01 bootstrap_4.18.01.sh file to /tmp/bootstrap_4.18.01.sh :
> curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh - Install the Edge 4.18.01 apigee-service utility and dependencies:
> sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser= uName apigeepassword= pWord
где uName:pWord — имя пользователя и пароль, полученные вами от Apigee. Если вы опустите pWord , вам будет предложено ввести его.
По умолчанию программа установки проверяет, установлена ли у вас Java 1.8. Если вы этого не сделаете, он установит его за вас. Используйте опцию JAVA_FIX , чтобы указать, как обрабатывать установку Java. JAVA_FIX принимает следующие значения:
I = Install OpenJDK 1.8 (default)
C = Continue without installing Java
Q = Quit. Для этого варианта вам придется установить Java самостоятельно. - Используйте apigee-service для обновления утилиты apigee-setup:
- If you installed 4.16.01 by upgrading Edge version 4.15.07.0x, you must install the apigee-setup utility:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
This command installs the update.sh utility in /opt/apigee/apigee-setup/bin .
If you already installed the apigee-setup utility, then update it:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update - If you installed 4.16.01 directly, meaning you did not perform an upgrade from 4.15.07.0x, you must update the apigee-setup utility :
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
This update to apigee-service installs the update.sh utility in /opt/apigee/apigee-setup/bin . - If you installed 4.16.05 directly or by update, you must update the apigee-setup utility :
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
This update to apigee-service installs the update.sh utility in /opt/apigee/apigee-setup/bin .
- If you installed 4.16.01 by upgrading Edge version 4.15.07.0x, you must install the apigee-setup utility:
- Depending on your current version of Edge, you must either install or update the apigee-validate utility on the Management Server.
- If you are currently using Edge 4.16.05 : update the apigee-validate utility on the Management Server:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update - If you are currently using Edge 4.16.01 : install the apigee-validate utility on the Management Server:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
Note : If you have installed the apigee-validate utility on a Message Processor node when installing 4.16.01, you can update it by using the following command on that node:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
However, as of 4.16.05 and later, Apigee recommends that you install and run the apigee-validate utility on the Management Server. - If you are upgrading from 4.16.01 : Edit the config file passed to the apigee-validate utility. In the 4.16.01 Edge release, the config file used by apigee-validate required the following properties:
APIGEE_ADMINPW=sysAdminPword
MP_POD=gateway
REGION=dc-1
In this release, the config file only requires the APIGEE_ADMINPW property. You can remove the other two properties from the file.
- If you are currently using Edge 4.16.05 : update the apigee-validate utility on the Management Server:
- Update the apigee-provision utility:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update - Run the update utility on your nodes in the order described below in " Order of machine update " below:
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
Единственное требование к файлу конфигурации состоит в том, что файл конфигурации должен быть доступен или доступен для чтения пользователю «apigee».
Use the “-c” option to specify the component to update. The list of possible components includes:
ldap = OpenLDAP
cs = Cassandra
zk = Zookeeper
qpid = qpidd
ps = postgresql
edge =All Edge components except Edge UI: Management Server, Message Processor, Router, QPID Server, Postgres Server
ui = Edge UI
all = update all components on machine (only use for an Edge aio installation profile or an API BaaS asa installation profile)
e = ElasticSearch
b = API BaaS Stack
p = API BaaS Portal
ebp = ElasticSearch, API BaaS Stack, and API BaaS Portal on the same node - Проверьте обновление, запустив утилиту apigee-validate на сервере управления, как описано в разделе «Проверка установки» .
- If you installed a new Postgres standby node, decommission the node as described above in Decommissioning a Postgres node .
To later rollback the update, use the procedure described in 4.18.01 Rollback Process .
Procedure for updating to 4.18.01 from a local repo
Если ваши пограничные узлы находятся за брандмауэром или каким-либо другим образом им запрещен доступ к репозиторию Apigee через Интернет, вы можете выполнить обновление из локального репозитория или зеркала репозитория Apigee.
После создания локального репозитория Edge у вас есть два варианта обновления Edge из локального репозитория:
- Создайте файл .tar репозитория, скопируйте файл .tar на узел, а затем обновите Edge из файла .tar.
- Установите веб-сервер на узле с локальным репозиторием, чтобы другие узлы могли получить к нему доступ. Apigee предоставляет вам веб-сервер Nginx, или вы можете использовать свой собственный веб-сервер.
To update from a local 4.18.01 repo:
- If you are currently using Postgres master-standby replication, install a new Postgres standby node as described above in Installing a new Postgres standby node .
- Create a local 4.18.01 repo as described in "Create a local Apigee repository" at Install the Edge apigee-setup utility .
Note : If you already have an existing 4.16.01 or 4.16.05 repo, you can add the 4.18.01 repo to it as described in "Update a local Apigee repository" at Install the Edge apigee-setup utility . - Чтобы установить сервис apigee из файла .tar :
- On the node with the local repo, use the following command to package the local repo into a single .tar file named /opt/apigee/data/apigee-mirror/apigee-4.18.01.tar.gz :
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package - Скопируйте файл .tar на узел, где вы хотите обновить Edge. Например, скопируйте его в каталог /tmp на новом узле.
- На новом узле распакуйте файл в каталог /tmp:
> tar -xzf apigee-4.18.01.tar.gz
Эта команда создает новый каталог с именем repos в каталоге, содержащем файл .tar. Например /tmp/репозитории. - Install the Edge apigee-service utility and dependencies from /tmp/repos:
> sudo bash /tmp/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
Обратите внимание, что в эту команду вы включаете путь к каталогу репозитория.
- On the node with the local repo, use the following command to package the local repo into a single .tar file named /opt/apigee/data/apigee-mirror/apigee-4.18.01.tar.gz :
- Чтобы установить сервис apigee с помощью веб-сервера Nginx:
- Настройте веб-сервер Nginx, как описано в разделе «Установка из репозитория с помощью веб-сервера Nginx» в разделе «Установка утилиты Edge apigee-setup» .
- On the remote node, download the Edge bootstrap_4.18.01.sh file to /tmp/bootstrap_4.18.01.sh :
> /usr/bin/curl http:// uName: pWord @ remoteRepo :3939/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
где uName:pWord — это имя пользователя и пароль, которые вы установили выше для репозитория, а RemoteRepo — это IP-адрес или DNS-имя узла репо. - На удаленном узле установите утилиту Edge apigee-service и зависимости:
> sudo bash /tmp/bootstrap_4.18.01.sh apigeerepohost= remoteRepo :3939 apigeeuser= uName apigeepassword= pWord apigeeprotocol=http://
где uName:pWord — имя пользователя и пароль репозитория.
- Используйте apigee-service для обновления утилиты apigee-setup:
- If you installed 4.16.01 by upgrading Edge version 4.15.07.0x, you must install the apigee-setup utility:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
This command installs the update.sh utility in /opt/apigee/apigee-setup/bin .
If you already installed the apigee-setup utility, then update it:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update - If you installed 4.16.01 directly, meaning you did not perform an upgrade from 4.15.07.0x, you must update the apigee-setup utility:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
This update to apigee-service installs the update.sh utility in /opt/apigee/apigee-setup/bin . - If you installed 4.16.05 directly or by update, you must update the apigee-setup utility:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
This update to apigee-service installs the update.sh utility in /opt/apigee/apigee-setup/bin .
- If you installed 4.16.01 by upgrading Edge version 4.15.07.0x, you must install the apigee-setup utility:
- Depending on your current version of Edge, you must either install or update the apigee-validate utility on the Management Server.
- If you are currently using Edge 4.16.05 : update the apigee-validate utility on the Management Server:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update - If you are currently using Edge 4.16.01 : install the apigee-validate utility on the Management Server:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
Note : If you have installed the apigee-validate utility on a Message Processor node when installing 4.16.01, you can update it by using the following command on that node:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
However, as of 4.16.05 and later, Apigee recommends that you install and run the apigee-validate utility on the Management Server. - If you are upgrading from 4.16.01 : Edit the config file passed to the apigee-validate utility. In the 4.16.01 Edge release, the config file used by apigee-validate required the following properties:
APIGEE_ADMINPW=sysAdminPword
MP_POD=gateway
REGION=dc-1
In this release, the config file only requires the APIGEE_ADMINPW property. You can remove the other two properties from the file.
- If you are currently using Edge 4.16.05 : update the apigee-validate utility on the Management Server:
- Update the apigee-provision utility:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update - Run the update utility on your nodes in the order described below in "Order of machine update" below:
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
Единственное требование к файлу конфигурации состоит в том, что файл конфигурации должен быть доступен или доступен для чтения пользователю «apigee».
Use the “-c” option to specify the component to update. The list of possible components includes:
ldap = OpenLDAP
cs = Cassandra
zk = Zookeeper
qpid = qpidd
ps = postgresql
edge =All Edge components except Edge UI: Management Server, Message Processor, Router, QPID Server, Postgres Server
ui = Edge UI
all = update all components on machine (only use for an Edge aio installation profile or an API BaaS asa installation profile)
e = ElasticSearch
b = API BaaS Stack
p = API BaaS Portal
ebp = ElasticSearch, API BaaS Stack, and API BaaS Portal on the same node - Проверьте обновление, запустив утилиту apigee-validate на сервере управления, как описано в разделе «Проверка установки» .
- If you installed a new Postgres standby node, decommission the node as described above in Decommissioning a Postgres node .
To later rollback the update, use the procedure described in 4.18.01 Rollback Process .
Порядок обновления машины
The order that you update the machines in an Edge installation is important. The most important considerations to an update are:
- Вы должны обновить все узлы Cassandra и ZooKeeper, прежде чем обновлять любые другие узлы.
- For any machine with multiple Edge components (Management Server, Message Processor, Router, QPID Server but not Postgres Server), use the "-c edge" option to update them all at the same time.
- Если для шага указано, что его следует выполнить на нескольких компьютерах, выполните его в указанном порядке компьютеров.
- Отдельного шага по обновлению монетизации не требуется. It is updated when you specify the "-c edge" option.
For a 1-host standalone installation
- Set SMTPMAILFROM in your configuration file if you have enabled SMTP on Edge. This parameter has the form:
SMTPMAILFROM="My Company <myco@company.com>" - If updating from 4.16.01 , downgrade Zookeeper:
> yum downgrade apigee-zookeeper - Обновите Кассандру и ZooKeeper:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile - Set the following iptables rule:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP - Check the Qpid message queue:
> qpid-stat -q
Continue to check the queue until the count in the "msg" column is 0. You cannot upgrade Qpid until it has processed all messages. - Update qpidd :
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - Flush iptables:
> sudo iptables -F - Обновить LDAP:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile - Stop Postgres Server, Qpid server, and PostgreSQL:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - Update postgresql:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Update the Postgres database:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade - Update the remaining Edge components:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - Update Edge UI:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
For a 2-host standalone installation
See Installation Topologies for the list of Edge topologies and node numbers.
- Set SMTPMAILFROM in your configuration file if you have enabled SMTP on Edge. This parameter has the form:
SMTPMAILFROM="My Company <myco@company.com>" - If updating from 4.16.01 , downgrade Zookeeper on machine 1:
> yum downgrade apigee-zookeeper - Обновите Cassandra и ZooKeeper на машине 1:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile - Set the following iptables rule on machine 2:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP - Check the Qpid message queue on machine 2:
> qpid-stat -q
Continue to check the queue until the count in the "msg" column is 0. You cannot upgrade Qpid until it has processed all messages. - Update qpidd on machine 2:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - Flush iptables on machine 2:
> sudo iptables -F - Обновите LDAP на машине 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile - Update Edge components on machine 1:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - Обновите пользовательский интерфейс на компьютере 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile - Update postgresql on machine 2:
- Stop Postgres Server, Qpid server, and postgresql:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - Update postgresql:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Update the Postgres database:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade - Update Edge components on machine 2:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Stop Postgres Server, Qpid server, and postgresql:
For a 5-host clustered installation
See Installation Topologies for the list of Edge topologies and node numbers.
- Set SMTPMAILFROM in your configuration file if you have enabled SMTP on Edge. This parameter has the form:
SMTPMAILFROM="My Company <myco@company.com>" - Ensure that you have installed a new Postgres standby node as described above in Installing a new Postgres standby node .
- If updating from 4.16.01 , downgrade Zookeeper on machine 1, 2, and 3:
> yum downgrade apigee-zookeeper - Обновите Cassandra и ZooKeeper на машинах 1, 2 и 3:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile - Set the following iptables rule on machine 4:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP - Check the Qpid message queue on machine 4:
> qpid-stat -q
Continue to check the queue until the count in the "msg" column is 0. You cannot upgrade Qpid until it has processed all messages. - Обновите qpidd на машине 4:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - Flush iptables on machine 4:
> sudo iptables -F - Repeat steps 5 through 8 on machine 5.
- Обновите LDAP на машине 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile - Update Edge components on machine 1, 2, 3:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - Обновите пользовательский интерфейс на компьютере 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile - Update machines 4 and 5:
- Stop Postgres server and Qpid server on machine 4:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop - Stop Postgres server, Qpid server, and postgresql on machine 5:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - Stop Postgres server and postgresql on the new standby node that you added for rollback:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - Update postgresql on machines 4:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Update the Postgres database on machine 4 (Postgres master only):
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade - Update postgresql on machines 5:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Start Postgres server and Qpid server on machines 4 and 5:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start - Configure Postgres as a standby node by running the following commands on machine 5:
> cd /opt/apigee/data/apigee-postgresql/pgdata
> rm -rf *
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile - Verify the replication status by issuing the following scripts on both servers. The system should display identical results on both servers to ensure a successful replication:
On the machine 4, the master node, run:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
Validate that it says it is the master.
On machine 5, the standby node:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
Validate that it says it is the standby.
- Stop Postgres server and Qpid server on machine 4:
- Update Edge components on machine 4, 5:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - Ensure that you decommission the new standby node by using the procedure above in Decommissioning a Postgres node .
For a 9-host clustered installation
See Installation Topologies for the list of Edge topologies and node numbers.
- Set SMTPMAILFROM in your configuration file if you have enabled SMTP on Edge. This parameter has the form:
SMTPMAILFROM="My Company <myco@company.com>" - Ensure that you have installed a new Postgres standby node as described above in Installing a new Postgres standby node .
- If updating from 4.16.01 , downgrade Zookeeper on macine 1, 2, and 3:
> yum downgrade apigee-zookeeper - Обновите Cassandra и ZooKeeper на машинах 1, 2 и 3:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile - Set the following iptables rule on machine 6:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP - Check the Qpid message queue on machine 6:
> qpid-stat -q
Continue to check the queue until the count in the "msg" column is 0. You cannot upgrade Qpid until it has processed all messages. - Update qpidd on machine 6:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - Flush iptables on machine 6:
> sudo iptables -F - Repeat steps 5 through 8 on machine 7.
- Обновите LDAP на машине 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile - Update Edge components on machine 6, 7, 1, 4, and 5 in that order:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - Обновите пользовательский интерфейс на компьютере 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile - Update machines 8 and 9:
- Stop Postgres server on machine 8:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop - Stop Postgres server and postgresql on machine 9:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - Stop Qpid server on machines 6 and 7:
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop - Stop Postgres server and postgresql on the new standby node that you added for rollback:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - Update postgresql on machines 8:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Update the Postgres database on machine 8 (Postgres master only):
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade - Update postgresql on machines 9:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Start Postgres server server on machines 8 and 9:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start - Start Qpid server server on machines 6 and 7:
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start - Configure Postgres as a standby node by running the following commands on machine 9:
> cd /opt/apigee/data/apigee-postgresql/pgdata
> rm -rf *
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile - Verify the replication status by issuing the following scripts on both servers. The system should display identical results on both servers to ensure a successful replication:
On the machine 8, the master node, run:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
Validate that it says it is the master.
On machine 9, the standby node:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
Validate that it says it is the standby.
- Stop Postgres server on machine 8:
- Update Edge components on machine 8 and 9:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - Ensure that you decommission the new standby node by using the procedure above in Decommissioning a Postgres node .
For a 13-host clustered installation
See Installation Topologies for the list of Edge topologies and node numbers.
- Set SMTPMAILFROM in your configuration file if you have enabled SMTP on Edge. This parameter has the form:
SMTPMAILFROM="My Company <myco@company.com>" - Ensure that you have installed a new Postgres standby node as described above in Installing a new Postgres standby node .
- If updating from 4.16.01 , downgrade Zookeeper on macine 1, 2, and 3:
> yum downgrade apigee-zookeeper - Обновите Cassandra и ZooKeeper на машинах 1, 2 и 3:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile - Set the following iptables rule on machine 12:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP - Check the Qpid message queue on machine 12:
> qpid-stat -q
Continue to check the queue until the count in the "msg" column is 0. You cannot upgrade Qpid until it has processed all messages. - Update qpidd on machine 12:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - Flush iptables on machine 12:
> sudo iptables -F - Repeat steps 5 through 8 on machine 13.
- Обновите LDAP на машинах 4 и 5:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile - Update Edge components on machine 12, 13, 6, 7, 10, and 11 in that order:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - Update UI on machine 6 and 7:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile - Update machines 8 and 9:
- Stop Postgres server on machine 8:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop - Stop Postgres server and postgresql on machine 9:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - Stop Qpid server on machines 12 and 13:
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop - Stop Postgres server and postgresql on the new standby node that you added for rollback:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - Update postgresql on machines 8:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Update the Postgres database on machine 8 (Postgres master only):
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade - Update postgresql on machines 9:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Start Postgres server on machines 8 and 9:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start - Start Qpid server server on machines 12 and 13:
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start - Configure Postgres as a standby node by running the following commands on machine 9:
> cd /opt/apigee/data/apigee-postgresql/pgdata
> rm -rf *
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile - Verify the replication status by issuing the following scripts on both servers. The system should display identical results on both servers to ensure a successful replication:
On the machine 8, the master node, run:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
Validate that it says it is the master.
On machine 9, the standby node:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
Validate that it says it is the standby.
- Stop Postgres server on machine 8:
- Update Edge components on machine 8 and 9:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - Ensure that you decommission the new standby node by using the procedure above in Decommissioning a Postgres node .
For a 12-host clustered installation
See Installation Topologies for the list of Edge topologies and node numbers.
- Set SMTPMAILFROM in your configuration file if you have enabled SMTP on Edge. This parameter has the form:
SMTPMAILFROM="My Company <myco@company.com>" - Ensure that you have installed a new Postgres standby node as described above in Installing a new Postgres standby node .
- Обновите Кассандру и ZooKeeper:
- If updating from 4.16.01 , downgrade Zookeeper on macine 1, 2, and 3 in Data Center 1:
> yum downgrade apigee-zookeeper - На компьютерах 1, 2 и 3 в центре обработки данных 1:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile - If updating from 4.16.01 , downgrade Zookeeper on macine 7, 8, and 9 in Data Center 2:
> yum downgrade apigee-zookeeper - На компьютерах 7, 8 и 9 в дата-центре 2.
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- If updating from 4.16.01 , downgrade Zookeeper on macine 1, 2, and 3 in Data Center 1:
- Обновить qpidd:
- Машины 4, 5 в дата-центре 1
- Set the following iptables rule on machine 4:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP - Check the Qpid message queue on machine 4:
> qpid-stat -q
Continue to check the queue until the count in the "msg" column is 0. You cannot upgrade Qpid until it has processed all messages. - Обновите qpidd на машине 4:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - Flush iptables on machine 4:
> sudo iptables -F - Repeat steps 1 through 4 on machine 5.
- Set the following iptables rule on machine 4:
- Машины 10, 11 в ЦОД 2
- Set the following iptables rule on machine 10:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP - Check the Qpid message queue on machine 10:
> qpid-stat -q
Continue to check the queue until the count in the "msg" column is 0. You cannot upgrade Qpid until it has processed all messages. - Обновите qpidd на машине 10:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - Flush iptables on machine 10:
> sudo iptables -F - Repeat steps 1 through 4 on machine 11.
- Set the following iptables rule on machine 10:
- Машины 4, 5 в дата-центре 1
- Обновить LDAP:
- Machines 1 in Data Center 1
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile - Machines 7 in Data Center 2
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Machines 1 in Data Center 1
- Обновите компоненты Edge:
- Machines 4, 5, 1, 2, 3 in Data Center 1
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - Machines 10, 11, 7, 8, 9 in Data Center 2
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Machines 4, 5, 1, 2, 3 in Data Center 1
- Обновить пользовательский интерфейс:
- Машина 1 в дата-центре 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile - Машина 7 в дата-центре 2:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- Машина 1 в дата-центре 1:
- Update machine 6 in Data Center 1 and 12 in Data Center 2:
- Stop Postgres server on machine 6:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop - Stop Postgres server and postgresql on machine 12:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - Stop Qpid server on machines 4, 5, 10, and 11:
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop - Stop Postgres server and postgresql on the new standby node that you added for rollback:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - Update postgresql on machines 6:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Update the Postgres database on machine 6 (Postgres master only):
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade - Update postgresql on machines 12:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Start Postgres server server on machines 6 and 12:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start - Start Qpid server server on machines 4, 5, 10, and 11:
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start - Configure Postgres as a standby node by running the following commands on machine 12:
> cd /opt/apigee/data/apigee-postgresql/pgdata
> rm -rf *
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile - Verify the replication status by issuing the following scripts on both servers. The system should display identical results on both servers to ensure a successful replication:
On the machine 6, the master node, run:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
Validate that it says it is the master.
On machine 12, the standby node:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
Validate that it says it is the standby.
- Stop Postgres server on machine 6:
- Update Edge components on machine 6 and 12:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - Ensure that you decommission the new standby node by using the procedure above in Decommissioning a Postgres node .
For a 7-host or 10-host API BaaS installation
For a non-standard installation
If you have a non-standard installation, then update Edge components in the following order:
- смотритель зоопарка
- Кассандра
- qpidd
- ЛДАП
- Edge, meaning the "-c edge" profile on all nodes in the order: nodes with Qpid server but not the Postgres server, Management Server, Message Processor, and Router.
Note : If the node has both Qpid server and Postgres server installed, run the "-c edge" profile step as part of step 8. - Пограничный интерфейс
- postgresql on the Postgres master, including upgrade.
- postgresql on the Postgres standby.
- Edge, meaning the "-c edge" profile on all combined Qpid and Postgres nodes, or on any standalone Postgres nodes.