Como fazer downgrade de componentes da Apigee e do NGINX

Você está lendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X.
info

Versão de patch de março de 2021

Os RPMs da versão de patch de março de 2021 do Edge para nuvem privada, que foram enviados ao repositório de produção da Apigee, tinham uma atualização de dependência não intencional para apigee-nginx-1.18. Como resultado, removemos os RPMs do repositório e os substituímos por RPMs corretos. Os RPMs inválidos estavam no repositório em 25 de março de 2021, das 8h45 às 15h45 (horário do Pacífico). Se você fez o download e instalou os RPMs do Edge nessa data, talvez seja necessário fazer downgrade dos seguintes componentes da Apigee para versões anteriores:

  • edge-gateway
  • edge-management-server
  • edge-message-processor
  • edge-postgres-server
  • edge-qpid-server
  • edge-router
  • nginx

As seções a seguir descrevem como verificar se é necessário fazer downgrade e como fazer downgrade dos componentes da Apigee, se necessário.

Verificar se é necessário fazer downgrade

Para saber se é necessário fazer downgrade dos componentes da Apigee ou do NGINX, siga um destes procedimentos, dependendo se você está usando o Edge para nuvem privada 4.50.00 ou 4.19.06.

Procedimento para o Edge 4.50.00

Em cada nó, digite o seguinte para encontrar a versão do gateway:

-- apigee-service edge-gateway version

Se o número da versão do edge-gateway for:

  • Menor que 20113, não é necessário fazer mais nada.
  • Igual a 20113, é necessário fazer downgrade dos componentes da Apigee e do NGINX.
  • Maior que 20113, encontre a versão do NGINX digitando o seguinte:
    -- sudo yum list installed apigee-nginx

    Confira um exemplo de saída do comando:

    Installed Packages
    apigee-nginx.x86_64 1.18.0-1.el7
    @apigee-thirdparty

    Se a versão do NGINX for apigee-nginx.x86_64 1.18.0-XXX, será necessário fazer downgrade apenas do NGINX.

Procedimento para o Edge 4.19.06

Em cada nó, digite o seguinte para encontrar a versão do gateway:

-- apigee-service edge-gateway version

Se o número da versão do edge-gateway for:

  • Menor que 20114, não é necessário fazer mais nada.
  • Igual a 20114, é necessário fazer downgrade dos componentes da Apigee e downgrade do NGINX.
  • Maior que 20114, encontre a versão do NGINX digitando o seguinte:
    -- sudo yum list installed apigee-nginx

    Confira um exemplo de saída do comando:

    Installed Packages
    apigee-nginx.x86_64 1.18.0-1.el7
    @apigee-thirdparty

    Se a versão do NGINX for apigee-nginx.x86_64 1.18.0-XXX, será necessário fazer downgrade apenas do NGINX.

    Componentes para fazer downgrade

    Se você instalou algum dos RPMs nas listas a seguir, será necessário fazer downgrade para a versão anterior desses RPMs.

    Componentes para fazer downgrade do Edge para nuvem privada 4.50.00

    edge-gateway-4.50.00-0.0.20113.noarch.rpm
    edge-management-server-4.50.00-0.0.20113.noarch.rpm
    edge-message-processor-4.50.00-0.0.20113.noarch.rpm
    edge-postgres-server-4.50.00-0.0.20113.noarch.rpm
    edge-qpid-server-4.50.00-0.0.20113.noarch.rpm
    edge-router-4.50.00-0.0.20113.noarch.rpm

    Componentes para fazer downgrade do Edge para nuvem privada 4.19.06

    edge-gateway-4.19.06-0.0.20114.noarch.rpm
    edge-management-server-4.19.06-0.0.20114.noarch.rpm
    edge-message-processor-4.19.06-0.0.20114.noarch.rpm
    edge-postgres-server-4.19.06-0.0.20114.noarch.rpm
    edge-qpid-server-4.19.06-0.0.20114.noarch.rpm
    edge-router-4.19.06-0.0.20114.noarch.rpm

    Para verificar se esses RPMs estão instalados, em cada nó em que algum dos componentes da lista acima está instalado, digite o seguinte comando para cada componente:

    -- apigee-service component version

    Fazer downgrade dos componentes da Apigee

    Para fazer downgrade dos componentes da Apigee, use o procedimento a seguir.

    Em cada nó que tiver algum dos seguintes componentes instalados:

    • edge-gateway
    • edge-management-server
    • edge-message-processor
    • edge-postgres-server
    • edge-qpid-server
    • edge-router

    Interrompa o componente digitando

    --apigee-service component stop

    Em seguida, faça downgrade dos componentes:

    -- sudo yum downgrade 

    Veja alguns exemplos:

    Se o gateway e o edge-message-processor estiverem instalados:

    -- sudo yum downgrade edge-gateway edge-message-processor

    Se o gateway e o edge-router estiverem instalados:

    -- sudo yum downgrade edge-gateway edge-router

    Se a configuração do AIO :

    -- sudo yum downgrade edge-gateway edge-postgres-server edge-router edge-management-server edge-message-processor edge-qpid-server

    Depois de fazer o downgrade, execute configure para cada componente e reinicie-o.

    --apigee-service  component configure
    --apigee-service  component start

    A versão correta dos RPMs que você teria após o downgrade é mostrada abaixo.

    Edge para nuvem privada 4.50.00

    edge-gateway-4.50.00-0.0.20110
    Edge-management-server-4.50.00-0.0.20110
    edge-message-processor-4.50.00-0.0.20110
    edge-postgres-server-4.50.00-0.0.20110
    edge-qpid-server-4.50.00-0.0.20110
    edge-router-4.50.00-0.0.20110

    Edge para nuvem privada 4.19.06

    edge-gateway-4.19.06-0.0.20112
    Edge-management-server-4.19.06-0.0.20112
    edge-message-processor-4.19.06-0.0.20112
    edge-postgres-server-4.19.06-0.0.20112
    edge-qpid-server-4.19.06-0.0.20112
    edge-router-4.19.06-0.0.20112

    Fazer downgrade do NGINX

    Para fazer downgrade do apigee-nginx, siga estas etapas para o roteador do Edge, um nó por vez:

    1. Interrompa o roteador.
      --apigee-service edge-router stop
    2. Faça downgrade do apigee-ngix.
       -- sudo yum downgrade apigee-nginx
      Versão esperada do apigee-nginx após o downgrade:
      -- yum list installed apigee-nginx
      apigee-nginx.x86_64 -1.16.1-6.el7
    3. Configure o roteador.
      apigee-service edge-router configure
    4. Inicie o roteador.
      apigee-service edge-router start