O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Reverter o Apigee Edge 4.52.00

Se você encontrar um erro durante uma atualização para o Edge 4.52.00, reverta o componente que causou o erro e tente atualizar novamente.

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

Versão 4.51.00

Há dois cenários em que você pode querer realizar uma reversão:

Reverter para uma versão de recurso anterior. Por exemplo, de 4.52.00 para 4.51.00.
Reverter para uma versão de atualização anterior na mesma versão. Por exemplo, de 4.52.00.02 para 4.52.00.01.

Para mais informações, consulte Processo de lançamento da Apigee Edge.

Quem pode realizar uma reversão

O usuário que realiza 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, é possível que você esteja executando componentes do Edge como usuários diferentes. Por exemplo, se o roteador precisar acessar portas privilegiadas, como as abaixo de 1000, será necessário executá-lo 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 seguintes componentes do Edge compartilham código comum. Portanto, para reverter qualquer um desses componentes em um nó, é necessário 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ó, para reverter qualquer um deles, será 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 para a qual você quer reverter:
- Para reverter para a versão 4.51.00, faça o download de bootstrap_4.51.00.sh:
```
curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh 
```

Interrompa o componente para reverter:

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

Para reverter qualquer outro componente no nó, interrompa 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ó, é necessário desinstalar 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, 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 do Edge, 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.52.00 do apigee-setup:

/opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall

Instale a versão 4.51.00 do utilitário apigee-service e as dependências dele. O exemplo a seguir instala a versão 4.51.00 do apigee-service:
```
sudo bash /tmp/bootstrap_4.51.00.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 da versão mais antiga.
Se você estiver revertendo o Qpid, limpe as 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 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.51.05-0.0.3749 install
```
Se você estiver usando o repositório on-line da Apigee, determine 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 o componente, especifique apenas o nome dele, não a versão.
Repita esse processo para cada nó que hospeda o componente que você está revertendo.

Reverter a atualização do Postgres 10.17

Se você fez upgrade para a versão 4.52.00 da versão 4.50.00 ou 4.51.00, será necessário reverter a atualização do Postgres, além dos componentes do Edge.

Para reverter a atualização do Postgres ao atualizar o Postgres em uma configuração mestre-em espera:

Promova o novo nó de espera para se tornar o mestre do Postgres. O novo mestre do Postgres será da mesma versão da instalação anterior do Edge.
Configure o nó em espera antigo para ser um nó em espera do novo mestre. O nó de espera antigo será da mesma versão da instalação anterior do Edge.
Registre os novos nós mestre e em espera com os grupos de análise e de consumidores.

Quando você terminar a reversão, o nó mestre antigo não será mais necessário. Em seguida, desative o nó mestre antigo.

Verifique se o novo nó de espera do Postgres está em execução:
```
/opt/apigee/apigee-service/bin/apigee-all status
```
Se o Postgres não estiver em execução, inicie-o:
```
/opt/apigee/apigee-service/bin/apigee-all start
```

Verifique se o Postgres está parado no nó mestre antigo e no nó de espera antigo:

/opt/apigee/apigee-service/bin/apigee-all status

Se o Postgres estiver em execução, interrompa-o:

/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop

Se instalado, inicie o Qpid no nó de espera antigo:
```
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
```
Observação: em muitas configurações, o nó em espera antigo hospeda apenas o Postgres, mas não o Qpid.
Promova o novo nó de espera como mestre do Postgres:
1. Promova o novo nó de espera para ser o novo mestre:
```
apigee-service apigee-postgresql promote-standby-to-master new_standby_IP
```
  Se solicitado, digite a senha do Postgres para o usuário "apigee", que é "postgres" por padrão.
2. Edite o arquivo de configuração usado para instalar a versão atual do Edge para especificar o seguinte:
```
# IP address of the new master:
PG_MASTER=new_standby_IP
# IP address of the old standby node
PG_STANDBY=old_standby_IP
```
3. Configure o novo mestre:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-master -f configFile
```
Se você já tiver feito upgrade do nó de espera antigo para a versão mais recente, primeiro faça downgrade do software da Apigee no nó de espera antigo. Se você ainda tiver a versão mais antiga no nó de espera antigo, pule esta etapa e continue com a etapa 6.
1. Interrompa o Postgres no nó de espera antigo:
```
apigee-service apigee-postgresql stop
apigee-service edge-postgres-server stop
```
2. Desinstale o Postgres do nó de espera antigo:
```
apigee-service apigee-postgresql uninstall
apigee-service edge-postgres-server uninstall
```
3. Exclua o diretório de dados do Postgres do nó em espera antigo:
```
cd /opt/apigee/data/apigee-postgresql/pgdata > rm -rf *
```
4. Faça o download e execute o bootstrap da versão mais antiga (para a versão da Apigee que você está revertendo) no nó de espera antigo. As etapas exatas podem variar dependendo se você está usando a instalação baseada na Internet ou off-line. A execução da inicialização da versão mais antiga da Apigee vai configurar os repositórios yum com dados da versão mais antiga da Apigee.
5. Configure os componentes do Postgres no nó de espera antigo:
```
/opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
```
6. Verifique se os componentes do Postgres no nó de espera antigo foram revertidos para a versão anterior:
```
apigee-service apigee-postgresql version
apigee-service edge-postgres-server version
```

Recrie o nó em espera antigo:

Edite o arquivo de configuração usado para instalar a versão atual do Edge para especificar o seguinte:

# IP address of the new master:
PG_MASTER=new_standby_IP
# IP address of the old standby node
PG_STANDBY=old_standby_IP

Remova o diretório de dados no nó de espera antigo:

cd /opt/apigee/data/apigee-postgresql/pgdata > rm -rf *

Reconfigure o nó em espera antigo para ser um nó em espera do novo mestre:

/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile

Verifique se o Postgres está em execução no nó de espera antigo:

/opt/apigee/apigee-service/bin/apigee-all status

Se o Postgres não estiver em execução, inicie-o:

/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start

Verifique se o novo nó de espera foi adicionado visualizando o arquivo /opt/apigee/apigee-postgresql/conf/pg_hba.conf no novo mestre.

Veja as informações atuais de análise e do grupo de consumidores executando o seguinte comando no servidor de gerenciamento:

curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax

Esse comando retorna o nome do grupo de análise no campo name e o nome do grupo de consumidores no campo name em consumer-groups. Ele também retorna os UUIDs dos nós mestre e de espera antigos do Postgres no campo postgres-server e no campo datastores. Você verá uma saída no formato:

{
  "name" : "axgroup-001",
  "properties" : {
  },
  "scopes" : [ "VALIDATE~test", "sgilson~prod" ],
  "uuids" : {
    "qpid-server" : [ "8381a053-433f-4382-bd2a-100fd37a1592", "4b6856ec-ef05-498f-bac6-ef5f0d5f6521" ],
    "postgres-server" : [
      "ab1158bd-1d59-4e2a-9c95-24cc2cfa6edc:27f90844-efab-4b32-8a23-8f85cdc9a256"
    ]
  },
  "consumer-groups" : [ {
    "name" : "consumer-group-001",
    "consumers" : [ "8381a053-433f-4382-bd2a-100fd37a1592", "4b6856ec-ef05-498f-bac6-ef5f0d5f6521" ],
    "datastores" :
      [ "ab1158bd-1d59-4e2a-9c95-24cc2cfa6edc:27f90844-efab-4b32-8a23-8f85cdc9a256" ],
      "properties" : {     }
    }
  ],
  "data-processors" : {
  }
}

Consiga o endereço UUID do mestre antigo executando o seguinte comando curl no nó mestre antigo:
```
curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self
```
O UUID do nó vai aparecer no final da saída, no formato:
```
"type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
```
Observação: o serviço edge-postgres-server precisa estar em execução. Se o servidor Postgres não estiver em execução, execute o seguinte comando no servidor de gerenciamento para determinar o UUID:
```
curl -u sysAdminEmail:password http://ms_IP:8080/v1/servers?pod=analytics
```
A saída desse comando lista o UUID do endereço IP de cada nó do Postgres.
Repita a etapa anterior para receber os endereços IP do nó de espera antigo e do novo mestre.
Remova os nós mestre e de espera antigos do grupo de consumidores:
```
curl -u sysAdminEmail:password -X DELETE \
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/datastores/masterUUID,standbyUUID" -v
```
Em que axgroup-001 e consumer-group-001 são os nomes padrão dos grupos de análise e de consumidores. masterUUID,standbyUUID estão na mesma ordem em que apareceram acima quando você visualizou as informações atuais de análise e do grupo de consumidores. Talvez seja necessário especificá-los como standbyUUID,masterUUID.

A propriedade datastores de consumer-groups agora precisa estar vazia.

Remova os nós mestre e de espera antigos do grupo de análise:

curl -u sysAdminEmail:password -X DELETE \
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=masterUUID,standbyUUID&type=postgres-server" -v

A propriedade postgres-server em uuids agora deve estar vazia.

Registre novos nós mestre e em espera do PG com os grupos de análise e de consumidores:

curl -u sysAdminEmail:password -X POST -H "Content-Type: application/json" -d ''
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=masterUUID,standbyUUID&type=postgres-server" -v
curl -u sysAdminEmail:password -X POST -H "Content-Type:application/json" -d ''
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/datastores?uuid=masterUUID,standbyUUID" -v

Valide o grupo de análise:
```
curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax
```
Você verá os UUIDs dos novos nós mestre e de espera listados no grupo de análise e no grupo de consumidores.

Reinicie o servidor de gerenciamento do Edge:

/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart

Reinicie todos os servidores Qpid:

/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart

Reinicie todos os servidores Postgres:

/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart

Verifique o status da replicação emitindo os seguintes scripts nos dois servidores. O sistema precisa exibir resultados idênticos nos dois servidores para garantir uma replicação bem-sucedida:
No novo mestre, execute:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
```
Verifique se ele é o mestre. No nó de espera antigo:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
```
Verifique se é o de espera.
Repita a etapa anterior depois de fazer várias solicitações de API para garantir que os nós estejam sincronizados.
Desative o mestre antigo do Postgres usando o procedimento em Como desativar um nó do Postgres.
Observação: se o nó mestre antigo estava executando o Qpid, é possível deixar esse servidor ativo para executar o Qpid. Verifique se ele está em execução. Caso contrário, inicie-o:
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-server start
```
Como alternativa, é possível desinstalar o Qpid do mestre antigo e instalá-lo no novo nó mestre. Depois de desinstalar o Qpid, é possível desativar o nó mestre antigo.

Reverter mTLS

Para reverter a atualização de mTLS, siga estas etapas em todos os hosts:

Interrompa a Apigee:
```
apigee-all stop
```
Interrompa o mTLS:
```
apigee-service apigee-mtls uninstall
```

Reinstale o mTLS:

apigee-service apigee-mtls install
apigee-service apigee-mtls setup -f /opt/silent.conf