Как выполнить откат Apigee Edge 4.19.06

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

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

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

Откат может потребоваться в двух случаях:

  1. Откат к предыдущему выпуску нововведений Например, с 4.19.06 на 4.18.05.
  2. Откатитесь до предыдущей версии обновления в том же выпуске. Например, с 4.19.01.02 до 4.19.01.01.

Дополнительную информацию можно найти в статье Процесс выпуска Apigee Edge.

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

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

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

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

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

  • edge-management-server (сервер управления)
  • edge-message-processor (Message Processor)
  • edge-router (маршрутизатор)
  • edge-postgres-server (сервер Postgres)
  • edge-qpid-server (сервер Qpid)

Например, если на узле установлены Management Server, Router и Message Processor, то для отката любого из них необходимо выполнить откат всех трех.

Как выполнить откат к предыдущему выпуску нововведений

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

  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. Если вы выполняете откат Монетизации, удалите ее со всех узлов Management Server и Message Processor: 
    /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. Удалите версию 4.19.06 приложения apigee-setup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
  6. Установите утилиту apigee-service версии 4.19.01, 4.18.05 или 4.18.01 и ее зависимости. В следующем примере устанавливается версия 4.18.01 apigee-service: 
    sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord

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

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

  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. Повторите эту процедуру для каждого узла, на котором размещен компонент, для которого выполняется откат.