Esta página foi traduzida pela API Cloud Translation.

Reverter o Apigee Edge 4.52.01

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

É possível reverter o Edge 4.52.01 para as seguintes versões principais:

Versão 4.52.00
Versão 4.51.00

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

Reverter para uma versão principal ou secundária anterior. Por exemplo, 4.52.01 a 4.52.00.
Reverta para uma versão de patch anterior na mesma lançamento. Por exemplo, de 4.52.00.02 a 4.52.00.01.

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

Quem pode fazer 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 principal ou secundária anterior

Para reverter para uma versão principal ou secundária 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 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 
```

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
```

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ó:
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 *
```

Desinstale a versão 4.52.01 do apigee-setup:

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

Instalar a versão 4.51.00 do 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 a insira.

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

Instale o 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 patch anterior

Para reverter um componente para uma versão de patch específica, 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 é a versão do componente e do patch 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, 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.

Reverter a atualização do Postgres 10.17

Se você fez upgrade da versão 4.50.00 ou 4.51.00 para a versão 4.52.01, é necessário reverter 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 do mestre em espera:

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

Quando a reversão for concluída, o nó mestre antigo não será mais necessário. Você pode e desativar o nó mestre antigo.

Verifique se o novo nó do Postgres em espera 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 e no nó de espera antigos:

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

Interrompa o Postgres em execução se ele estiver em execuçã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 antigo nó de espera hospedar 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 a novo mestre:
```
apigee-service apigee-postgresql promote-standby-to-master new_standby_IP
```
  Se solicitado, insira a senha do Postgres para a "apigee" que tem como padrão "postgres".
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á fez upgrade do nó de espera antigo para a versão mais recente, primeiro é necessário fazer downgrade do software Apigee no antigo nó de espera. Se você ainda tiver a versão mais antiga no antigo nó de espera, pode pular esta etapa e continuar com a etapa 6.
1. Pare 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ó de 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 do Apigee para a qual você está revertendo) no nó de espera antigo. As etapas exatas podem variar se você estiver usando baseada na Internet ou off-line. Executar a versão mais antiga de inicialização da Apigee vai Configurar os repositórios yum com versões mais antigas de dados 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. Verificar se os componentes do Postgres no nó de espera antigo foram revertidos para a versão mais antiga:
```
apigee-service apigee-postgresql version
apigee-service edge-postgres-server version
```

Recrie o antigo nó de espera:

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 do nó de espera antigo:

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

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

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

Verifique se o Postgres está sendo executado 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 /opt/apigee/apigee-postgresql/conf/pg_hba.conf no novo mestre.

Execute o comando a seguir para visualizar as análises atuais e as informações do grupo de consumidores. 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. Ela também retorna os UUIDs dos nós mestres e de espera do Postgres antigos na postgres-server e no campo datastores. Aparecerá 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" : {
  }
}

Encontre o endereço UUID do mestre antigo executando o seguinte comando curl em do nó mestre antigo:
```
curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self
```
Você verá o UUID do nó 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 em execução. Se o servidor Postgres não estiver em execução, execute o seguinte comando no Management Server 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 Postres.
Repita a etapa anterior para receber os endereços IP do antigo nó de reserva e do novo mestre.
Remova os nós mestres 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 de análise de dados e grupos de consumidores. masterUUID,standbyUUID estão na mesma ordem apareceu acima quando você visualizou as informações atuais de análise e grupo de consumidores acima. Você talvez seja necessário especificá-los como standbyUUID,masterUUID.

A propriedade datastores para consumer-groups agora deve ser vazio.

Remova os nós mestres 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 os novos nós da PG principais e de espera nos 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
```
Os UUIDs dos novos nós mestre e reserva vão aparecer listados no grupo de análise e no grupo de consumidor.

Reinicie o Edge Management Server:

/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 do Postgres:

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

Verifique o status da replicação emitindo os scripts a seguir nos dois servidores. O sistema deve 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 ele é o modo de espera.
Repita a etapa anterior depois de fazer várias solicitações de API para garantir que os nós estejam nos sincronização
Desative o mestre Postgres antigo usando o procedimento em Desativação de um Nó do Postgres.
Observação: se o nó mestre antigo estava executando Qpid, será possível 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, você pode desinstalar o Qpid do mestre antigo e instalar o Qpid no novo nó mestre. Após desinstalar o Qpid, você pode desativar o nó mestre antigo.

Reverter mTLS

Para reverter a atualização do 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