Como fazer downgrade de componentes da Apigee e do NGINX

Você está vendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X.
informações

Lançamento do patch de março de 2021

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

  • gateway de borda
  • servidor-de-gerenciamento-de-borda
  • processador de mensagens de borda
  • edge-postgres-server
  • servidor-do-qpid-de-borda
  • roteador de borda
  • nginx

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

Verificando se você precisa fazer downgrade

Para ver se você precisa fazer downgrade de componentes da Apigee ou do NGINX, siga um dos procedimentos a seguir, 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 de edge-gateway for:

  • Para menos de 20113, você não precisa fazer mais nada.
  • Igual a 20113, é necessário fazer downgrade dos componentes da Apigee e do NGINX.
  • posterior a 20113, para encontrar sua versão do NGINX, digite o seguinte:
    -- sudo yum list installed apigee-nginx

    Veja 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, você só precisará fazer downgrade 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 de edge-gateway for:

  • Para menos de 20114, você não precisa fazer mais nada.
  • Igual a 20114, é necessário fazer downgrade dos componentes da Apigee e do downgrade do NGINX.
  • posterior a 20114, digite o seguinte para encontrar a versão do NGINX:
    -- sudo yum list installed apigee-nginx

    Veja 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, você só precisará fazer downgrade do NGINX.

    Componentes para downgrade

    Se você tiver instalado qualquer uma das RPMs nas listas a seguir, será necessário fazer downgrade para a versão anterior delas.

    Componentes para fazer downgrade para o Edge para a 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 a 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 essas RPMs estão instaladas, em cada nó onde algum dos componentes da lista acima está instalado, digite o seguinte comando para cada componente:

    -- apigee-service component version

    Fazer downgrade de componentes da Apigee

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

    Em cada nó com qualquer um dos seguintes componentes instalado:

    • gateway de borda
    • servidor-de-gerenciamento-de-borda
    • processador de mensagens de borda
    • edge-postgres-server
    • servidor-do-qpid-de-borda
    • roteador de borda

    Pare o componente inserindo

    --apigee-service component stop

    Em seguida, faça downgrade dos componentes:

    -- sudo yum downgrade 

    Veja alguns exemplos:

    Se o gateway e o processador de mensagens de borda estiverem instalados:

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

    Se o gateway e o roteador de borda estiverem instalados:

    -- sudo yum downgrade edge-gateway edge-router

    Se configurar o AIO:

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

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

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

    A versão correta de 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 de apigee-nginx, siga estas etapas para o roteador de borda, um nó por vez:

    1. Interrompa o roteador.
      --apigee-service edge-router stop
    2. Fazer downgrade de apigee-ngix.
       -- sudo yum downgrade apigee-nginx
      Versão apigee-nginx esperada 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. Ligue o roteador.
      apigee-service edge-router start