Se você encontrar um erro durante uma atualização para o Edge 4.19.06, poderá reverter o componente que causou o erro e tente atualizar novamente.
É possível reverter o Edge 4.19.06 para as seguintes versões de lançamento de recursos:
- Versão 4.19.01
- Versão 4.18.05
- Versão 4.18.01
Há dois cenários em que convém fazer uma reversão:
- Reverter para uma versão de recurso anterior. Por exemplo, 4.19.06 a 4.18.05.
- 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:
-
Faça o download do arquivo
bootstrap.sh
da versão para a qual você quer acumular voltar:- 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
- Para reverter para 4.18.01, faça o download de
bootstrap_4.18.01.sh
:curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
- Para reverter para 4.19.01, faça o download de
- Pare o componente para reverter:
- 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
- Para reverter qualquer outro componente no nó, pare apenas esse componente:
/opt/apigee/apigee-service/bin/apigee-service component stop
- Para reverter qualquer um dos componentes com código comum no
você precisa interrompê-los, conforme o exemplo a seguir:
- 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
- Desinstale o componente para reverter no nó:
- 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
- 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.
- Para reverter o Edge Router, exclua o conteúdo do
/opt/nginx/conf.d
, além de desinstalar o Grupo de componentesedge-gateway
:cd /opt/nginx/conf.d
rm -rf *
- Para reverter qualquer um dos componentes com código comum no
você precisa desinstalar todos desinstalando o componente
- Desinstale a versão 4.19.06 do
apigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
- Instale a versão 4.19.01, 4.18.05 ou 4.18.01 do
apigee-service
e as dependências dele. O exemplo a seguir instala a versão 4.18.01 daapigee-service
:sudo bash /tmp/bootstrap_4.18.01.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: - Instale
apigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- 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.
- Se você estiver revertendo o Qpid, limpe o iptables:
sudo iptables -F
- 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:
- 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.01-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
- 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.
- Repita esse processo para cada nó que hospeda o componente que você está revertendo.