Reverter o Apigee Edge 4.50.00

Caso ocorra um erro durante a atualização para o Edge 4.50.00, você poderá reverter componente que causou o erro e tente atualizar novamente.

É possível reverter o Edge 4.50.00 para as seguintes versões de lançamento de recursos:

  • Versão 4.19.06
  • Versão 4.19.01
  • Versão 4.18.05
.

Há dois cenários em que convém fazer uma reversão:

  1. Reverter para uma versão de recurso anterior. Por exemplo, 4.50.00 a 4.18.05.
  2. Reverter para uma versão de atualização anterior na mesma lançamento. Por exemplo, de 4.19.01.02 a 4.19.01.01.

Para mais informações, consulte a versão do Apigee Edge de análise de dados.

Quem pode executar uma reversão

O usuário que está executando uma reversão precisa ser o mesmo que o usuário que atualizou o Edge originalmente ou uma usuário sendo executado como raiz.

Por padrão, os componentes do Edge são executados como o usuário "apigee". Em alguns casos, é possível executar o Edge componentes como usuários diferentes. Por exemplo, se o roteador precisar acessar portas privilegiadas, como abaixo de 1.000, execute o roteador como raiz ou como usuário com acesso a esses portas. Ou você pode executar um componente como um usuário e outro como outro usuário.

Componentes com código comum

Os seguintes componentes do Edge compartilham um código comum. Portanto, para reverter qualquer uma esses componentes em um nó, é necessário reverter todos os componentes que estão nele.

  • edge-management-server (servidor de gerenciamento)
  • edge-message-processor (processador de mensagens)
  • edge-router (Roteador)
  • edge-postgres-server (servidor do Postgres)
  • edge-qpid-server (servidor Qpid)

Por exemplo, se você tiver o servidor de gerenciamento, o roteador e o processador de mensagens instalados nó, para reverter qualquer um deles, é preciso reverter todos os três.

Reverter para uma versão de recurso anterior

Para reverter para uma versão de recurso anterior, faça o seguinte em cada nó que hospeda o componente:

  1. Faça o download do arquivo bootstrap.sh da versão para a qual você quer acumular voltar:

    • Para reverter para 4.19.06, faça o download de bootstrap_4.19.06.sh:
      curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh 
    • Para reverter para 4.19.01, faça o download de bootstrap_4.19.01.sh:
      curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh 
    • Para reverter para 4.18.05, faça o download de bootstrap_4.18.05.sh:
      curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh 
  2. Pare o componente para reverter:
    1. Para reverter qualquer um dos componentes com código comum no você precisa interrompê-los, conforme o exemplo a seguir:
      /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. Para reverter qualquer outro componente no nó, pare apenas esse componente:
      • /opt/apigee/apigee-service/bin/apigee-service component stop
  3. Se você estiver revertendo a monetização, desinstale-a de todo o servidor de gerenciamento e de mensagens. Nós do processador:
    /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
  4. Desinstale o componente para reverter no nó:
    1. Para reverter qualquer um dos componentes com código comum no você precisa desinstalar todos desinstalando o componente edge-gateway grupo, conforme o exemplo a seguir:
      /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
    2. Para reverter qualquer outro componente do nó, desinstale somente esse componente, pois o exemplo a seguir mostra:
      /opt/apigee/apigee-service/bin/apigee-service component uninstall

      Em que component é o nome do componente.

    3. Para reverter o Edge Router, exclua o conteúdo do /opt/nginx/conf.d, além de desinstalar o Grupo de componentes edge-gateway:
      cd /opt/nginx/conf.d
      rm -rf *
  5. Desinstale a versão 4.50.00 do apigee-setup:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
  6. Instale a versão 4.19.01 ou 4.18.05 do apigee-service e as dependências dele. O exemplo a seguir instala a versão 4.18.05 do apigee-service:
    sudo bash /tmp/bootstrap_4.18.05.sh apigeeuser=uName apigeepassword=pWord

    Em que uName e pWord são o nome de usuário e a senha que você recebeu da Apigee. Se você omitir pWord, será solicitado que a insira.

    Se você receber um erro, verifique se você fez o download do arquivo bootstrap.sh na etapa 1:

  7. Instale apigee-setup:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  8. Instale a versão mais antiga do componente:
    /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

    Em que component é o componente a ser instalado e configFile é o de configuração do Terraform para a versão mais antiga.

  9. Se você estiver revertendo o Qpid, limpe o iptables:
    sudo iptables -F
  10. Repita esse processo para cada nó que hospeda o componente que você está revertendo.

Reverter para uma versão de atualização anterior

Para reverter um componente para uma versão específica de um lançamento, faça o seguinte em cada nó: que hospeda o componente:

  1. Faça o download da versão específica do componente:
    /opt/apigee/apigee-service/bin/apigee-service component_version install

    Em que component_version é o componente e a versão da atualização a ser instalada. Por exemplo:

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

    Se você estiver usando o repositório on-line da Apigee, será possível determinar o componente disponível usando o seguinte comando:

    yum --showduplicates list comp

    Exemplo:

    yum --showduplicates list edge-ui
  2. Use apigee-setup para instalar o componente:
    /opt/apigee/apigee-setup/bin/setup.sh -p comp -f configFile

    Exemplo:

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

    Observe que você especifica apenas o nome do componente ao instalá-lo, não a versão.

  3. Repita esse processo para cada nó que hospeda o componente que você está revertendo.