Reverter o Apigee Edge 4.50.00

Se você encontrar um erro durante uma atualização para o Edge 4.50.00, reverta o 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 do recurso:

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

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

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

Para mais informações, consulte o processo de lançamento do Apigee Edge.

Quem pode realizar uma reversão

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

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

Componentes com código comum

Os componentes do Edge a seguir compartilham um código comum. Portanto, para reverter qualquer um desses componentes em um nó, é preciso reverter todos os componentes que estão nesse nó.

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

Por exemplo, se você tiver o servidor de gerenciamento, o roteador e o processador de mensagens instalados no nó, será necessário reverter os três para reverter qualquer um deles.

Reverter para uma versão anterior de um recurso

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

  1. Faça o download do arquivo bootstrap.sh para a versão que você quer reverter:

    • Para reverter para a versão 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 a versão 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 a versão 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. Interrompa o componente para a reversão:
    1. Para reverter qualquer um dos componentes com código comum no nó, é preciso interromper todos eles, como mostra 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 outro componente no nó, interrompa apenas esse componente:
      • /opt/apigee/apigee-service/bin/apigee-service component stop
  3. Se você estiver revertendo a monetização, desinstale-a de todos os nós do servidor de gerenciamento e do processador de mensagens:
    /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
  4. Desinstale o componente para reverter o nó:
    1. Para reverter qualquer um dos componentes com código comum no nó, desinstale todos eles desinstalando o grupo de componentes edge-gateway, conforme o exemplo a seguir:
      /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
    2. Para reverter qualquer outro componente no nó, desinstale apenas esse componente, como mostra o exemplo a seguir:
      /opt/apigee/apigee-service/bin/apigee-service component uninstall

      Em que component é o nome do componente.

    3. Para reverter o roteador de borda, exclua o conteúdo do arquivo /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 de 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 utilitário apigee-service e as dependências dele. O exemplo a seguir instala a versão 4.18.05 da 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 o campo pWord, será necessário inseri-lo.

    Se você receber um erro, faça 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 arquivo de configuração 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 uma versão, faça o seguinte em cada nó que hospeda o componente:

  1. Faça o download da versão do componente específico:
    /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, poderá determinar as versões dos componentes disponíveis 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ê só especifica 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.