Esta página foi traduzida pela API Cloud Translation.

Reverter o Apigee Edge 4.19.06

Se você encontrar um erro durante uma atualização para o Edge 4.19.06, poderá reverter o componente que causou o erro e tentar a atualização novamente.

É possível reverter o Edge 4.19.06 para as seguintes versões do 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 você pode querer fazer uma reversão:

Reverter para uma versão de recurso anterior. Por exemplo, de 4.19.06 para 4.18.05.
Reverter para uma versão de atualização anterior na mesma versão. Por exemplo, de 4.19.01.02 para 4.19.01.01.

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

Quem pode executar 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 esteja executando como raiz.

Por padrão, os componentes do Edge são executados como o usuário "apigee". Em alguns casos, você pode estar executando componentes do Edge como usuários diferentes. Por exemplo, se o roteador precisar acessar portas privilegiadas, como aquelas abaixo de 1.000, você terá que executá-lo como raiz ou como usuário com acesso a essas 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 um desses componentes em um nó, é necessário reverter todos esses componentes que estão nele.

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ê tem o servidor de gerenciamento, o roteador e o processador de mensagens instalados no nó, para reverter qualquer um deles, é necessário reverter 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 que você quer reverter:
- 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 
```
- Para reverter para a versão 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 
```

Pare o componente para reverter:

Para reverter qualquer um dos componentes com código comum no nó, é necessário interromper todos eles, conforme mostrado no 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
```

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
```
Desinstale o componente para reverter no nó:
1. Para reverter qualquer um dos componentes com código comum no nó, desinstale todos eles desinstalando o grupo de componentes edge-gateway, como mostra 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, conforme mostrado no 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 e desinstale o grupo de componentes edge-gateway:
```
cd /opt/nginx/conf.d
rm -rf *
```

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 utilitário apigee-service e as dependências dele. O exemplo a seguir instala a versão 4.18.01 do apigee-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 você o insira.

Se você receber um erro, verifique se 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 arquivo de configuração 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 anterior da atualização

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:

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 de 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, poderá determinar as versões de componentes disponíveis 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
```
Ao instalar, você especifica apenas o nome do componente, não a versão.
Repita esse processo para cada nó que hospeda o componente que você está revertendo.