Откатить Apigee Edge 4.19.06

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

Вы можете выполнить откат Edge 4.19.06 до следующих версий выпуска функций:

  • Версия 4.19.01
  • Версия 4.18.05
  • Версия 4.18.01

Существует два сценария, в которых может потребоваться выполнить откат:

  1. Откат к предыдущей версии функции . Например с 19.04.06 по 18.04.05.
  2. Откатитесь к предыдущей версии обновления в том же выпуске . Например, с 19.04.02 по 19.01.01.

Дополнительные сведения см. в разделе Процесс выпуска Apigee Edge .

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

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

По умолчанию компоненты Edge запускаются от имени пользователя «apigee». В некоторых случаях вы можете запускать компоненты Edge от имени разных пользователей. Например, если маршрутизатору необходим доступ к привилегированным портам, например портам ниже 1000, вам необходимо запустить маршрутизатор от имени пользователя root или пользователя, имеющего доступ к этим портам. Или вы можете запустить один компонент от имени одного пользователя, а другой компонент от имени другого пользователя.

Компоненты с общим кодом

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

  • edge-management-server (Сервер управления)
  • edge-message-processor (Процессор сообщений)
  • edge-router (Маршрутизатор)
  • edge-postgres-server (сервер Postgres)
  • edge-qpid-server (Qpid-сервер)

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

Откат к предыдущей версии функции

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

  1. Загрузите файл bootstrap.sh для той версии, до которой вы хотите откатиться:

    • Чтобы откатиться на 4.19.01, скачайте bootstrap_4.19.01.sh : 
      curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
    • Чтобы откатиться на 4.18.05, скачайте bootstrap_4.18.05.sh : 
      curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
    • Для отката на 4.18.01 скачайте bootstrap_4.18.01.sh : 
      curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
  2. Остановите компонент для отката:
    1. Чтобы откатить любой из компонентов с общим кодом на узле, необходимо остановить их все, как показано в следующем примере: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-router stop
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. Чтобы откатить любой другой компонент на узле, остановите только этот компонент:
      • /opt/apigee/apigee-service/bin/apigee-service component stop
  3. Если вы выполняете откат монетизации, удалите ее со всех узлов сервера управления и процессора сообщений: 
    /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
  4. Удалите компонент для отката на узле:
    1. Чтобы выполнить откат любого из компонентов с общим кодом на узле, необходимо удалить их все, удалив группу компонентов edge-gateway , как показано в следующем примере: 
      /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
    2. Чтобы выполнить откат любого другого компонента на узле, удалите только этот компонент, как показано в следующем примере: 
      /opt/apigee/apigee-service/bin/apigee-service component uninstall

      Где component — это имя компонента.

    3. Чтобы выполнить откат Edge Router, необходимо удалить содержимое файла /opt/nginx/conf.d в дополнение к удалению группы компонентов edge-gateway : 
      cd /opt/nginx/conf.d
rm -rf *
  5. Удалите версию apigee-setup 4.19.06: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
  6. Установите версию 4.19.01, 4.18.05 или 4.18.01 утилиты apigee-service и ее зависимости. В следующем примере устанавливается версия 4.18.01 apigee-service : 
    sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord

    Где uName и pWord — это имя пользователя и пароль, которые вы получили от Apigee. Если вы опустите pWord , вам будет предложено ввести его.

    Если вы получили сообщение об ошибке, убедитесь, что вы загрузили файл bootstrap.sh на шаге 1.

  7. Установите apigee-setup : 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  8. Установите старую версию компонента: 
    /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

    Где component — это компонент для установки, а configFile — ваш файл конфигурации для более старой версии.

  9. Если вы откатываете Qpid, очистите iptables: 
    sudo iptables -F
  10. Повторите этот процесс для каждого узла, на котором размещен компонент, откат которого выполняется.

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

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

  1. Загрузите конкретную версию компонента: 
    /opt/apigee/apigee-service/bin/apigee-service component_version install

    Где component_version — это версия компонента и обновления для установки. Например:

    /opt/apigee/apigee-service/bin/apigee-service edge-ui-4.18.01-0.0.3749 install

    Если вы используете онлайн-репозиторий Apigee, вы можете определить доступные версии компонентов с помощью следующей команды: 

    yum --showduplicates list comp

    Например:

    yum --showduplicates list edge-ui
  2. Используйте apigee-setup для установки компонента: 
    /opt/apigee/apigee-setup/bin/setup.sh -p comp -f configFile

    Например:

    /opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile

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

  3. Повторите этот процесс для каждого узла, на котором размещен компонент, откат которого выполняется.