Esta página foi traduzida pela API Cloud Translation.

18.4.01 Processo de reversão

Edge para nuvem privada v4.18.01

Caso ocorra um erro durante uma atualização para o Edge 4.18.01, você poderá reverter o componente que causou o erro e tente atualizar novamente. Por exemplo, se a atualização para o Postgres 9.6 falhar, reverta apenas os nós do Postgres e tente atualizar novamente.

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

Reverter para uma versão mais antiga. Por exemplo, de 4.18.01 a 4.17.01.
reverter para uma versão mais antiga na mesma versão.

Use o procedimento abaixo para executar uma reversão nos dois cenários.

Quem pode executar a reversão

O usuário que está realizando a reversão precisa ser o mesmo que originalmente atualizou o Edge, ou um usuário executando 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.

Quais componentes podem ser revertidos

Esteja ciente das seguintes condições ao fazer uma reversão:

Os cinco componentes do Edge listados abaixo compartilham um código comum. Portanto, para reverter qualquer uma os cinco componentes de um nó, é preciso reverter qualquer um dos cinco instalados no nó. Para 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.

Os cinco componentes que compartilham código são:
- Servidor de gerenciamento
- Roteador
- processador de mensagens
- Servidor Qpid
- Servidor Postgres
Se você estiver atualizando do Edge 4.16.01, não reverta o Cassandra. Isso versão do Edge contém uma versão atualizada do Cassandra. Se você reverter algum componente, deixe Cassandra na versão 4.18.01.

Revertendo 18/04/01

Nesta seção, você verá o procedimento para reverter o Edge 4.18.01 para uma versão anterior. Isso é dividida em duas partes:

Reverter a atualização do Postgres
A parte final de cada procedimento de atualização é atualizar os nós do Postgres para a versão 9.6. Se isso a atualização falhar, use este procedimento para revertê-la.
Reverter todos os outros componentes do Edge
Use este procedimento para reverter quaisquer outros componentes do Edge.

Para reverter a atualização do Postgres 9.6

Para reverter a atualização do Postgres ao atualizar o Postgres em uma configuração de mestre em espera, você:

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" usuário, 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
```

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ó de espera para ser um nó de espera 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 ele 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 no nó mestre:
```
> 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 ser 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 obter os endereços IP do nó de espera antigo 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

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

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 mostrar 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
```
Confira se ele diz que é o mestre. No nó de espera antigo:
```
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
```
Confira se ele diz que é 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 Atualizar o Apigee Edge 4.16.01/4.16.05 a 4.17.09.
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 mestre , conforme descrito abaixo. Após desinstalar o Qpid, você pode desativar o mestre antigo nó.

Desinstale o Qpid do mestre antigo e instale o Qpid no novo mestre

Use o procedimento a seguir para desinstalar o Qpid do mestre antigo e instalá-lo no novo mestre:

Bloqueia o acesso à porta Qpid 5672 no mestre antigo do acesso de processadores de mensagens. executando o seguinte comando em todos os processadores de mensagens:
```
> iptables -A OUTPUT -p tcp -d 10.233.147.20 --dport 5672 -j DROP
```
Para verificar se a fila de mensagens Qpid está vazia, execute o comando a seguir. Não é possível desinstale o Qpid até que ele tenha processado todas as mensagens pendentes:
```
> qpid-stat -q
```
Esse comando exibe uma tabela que contém uma contagem para msg, msgIn, and msgOut. Todas as mensagens serão processadas quando msg=0, e msgIn=msgOut.
Determine o UUID do servidor Qpid no mestre antigo executando o seguinte comando no do mestre antigo. Salve essas informações para usar depois no procedimento:
```
> curl -u sysAdminEmail:password http://node_IP::8083/v1/servers/self
```

Pare o Qpid no mestre antigo:

> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd stop

Desinstale o servidor Qpid:

> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server uninstall
> /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd uninstall

Remova o servidor Qpid antigo dos grupos de análises e consumidores:

> curl -u sysAdminEmail:password -X DELETE -H "Content-Type: application/json" -d ''
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/consumers/qpid_UUID" -v
> curl -u sysAdminEmail:password -X DELETE
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=qpid_UUID&type=qpid-server" -v

Remova o servidor Qpid antigo do Zookeeper:

> curl -u sysAdminEmail:password -X DELETE
  http://ms_IP:8080/v1/servers/qpid_UUID

Instale o Qpid no novo mestre:

> /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile

Determine o UUID do servidor Qpid no novo mestre executando o seguinte comando em para o novo mestre. Salve essas informações para usar depois no procedimento:
```
> curl -u sysAdminEmail:password
  http://node_IP::8083/v1/servers/self
```

Registre o novo servidor Qpid 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=qpid_UUID&type=qpid-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/consumers?uuid=qpid_UUID" -v

Reinicie todos os processadores de mensagens:

> /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart

Execute o seguinte comando no novo servidor Qpid para verificar se as filas foram criadas:
```
> qpid-stat -q
```
Verifique se msg, msgIn e msgOut estão sendo atualizados como o servidor Qpid. processa mensagens.

Para reverter componentes individuais 4.18.01

Para executar a reversão, faça o download do arquivo bootstrap.sh para versão atual do Edge:

Para reverter para a versão 4.17.09, faça o download de bootstrap_4.17.09.sh
Para reverter para a versão 4.17.05, faça o download de bootstrap_4.17.05.sh
Para reverter para a versão 4.17.01, faça o download de bootstrap_4.17.01.sh
Para reverter para a versão 4.16.09, faça o download de bootstrap_4.16.09.sh
Para reverter para a versão 4.16.05, faça o download de bootstrap_4.16.05.sh
Para reverter para a versão 4.16.01, faça o download de bootstrap.sh

Para cada nó que hospeda um componente para reversão:

Interrompa o componente para reversão:
1. Se você estiver revertendo qualquer um dos seguintes componentes no nó, será preciso interrompê-los: servidor de gerenciamento, roteador, processador de mensagens, Qpid Server ou Postgres Servidor:
  - ```
  > apigee-service edge-management-server stop
```
- ```
> apigee-service edge-router stop
```
  - ```
  > apigee-service edge-message-processor stop
```
- ```
> apigee-service edge-qpid-server stop
```
  - ```
  > apigee-service edge-postgres-server stop
```
2. Se você estiver revertendo qualquer outro componente no nó, pare apenas isso componente:
  - ```
  > apigee-service comp stop
```
Se você estiver revertendo a monetização, desinstale-a de todo o servidor de gerenciamento e de mensagens. Nós do processador:
```
> apigee-service edge-mint-gateway uninstall
```
Desinstale o componente para reverter no nó:
1. Se você estiver revertendo qualquer um dos seguintes componentes no nó, desinstale todos: servidor de gerenciamento, roteador, processador de mensagens, Qpid Server ou Postgres Servidor:
```
> apigee-service edge-gateway uninstall
```
2. Se você estiver revertendo qualquer outro componente no nó, desinstale apenas esse componente:
```
> apigee-service comp uninstall
```
3. Se você estiver revertendo o roteador, precisará excluir o conteúdos de /opt/nginx/conf.d:
```
> cd /opt/nginx/conf.d
> rm -rf *
```
Para reverter o componente:
1. Desinstale a versão 4.18.01 do apigee-setup:
```
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
```
2. Faça o download de bootstrap.sh para a versão desejada: por exemplo, para 4.16.09:
```
> curl https://software.apigee.com/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh 
```
3. Instale o utilitário apigee-service 4.16.01, 4.16.05 ou 4.16.09 e dependências. Por exemplo, para 4.16.09:
```
> sudo bash /tmp/bootstrap_4.16.09.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á necessário inserir reimplantá-lo.
4. Instale apigee-setup:
```
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
```
5. Instale a versão desejada do componente:
```
> /opt/apigee/apigee-setup/bin/setup.sh -p comp -f configFile
```
  em que comp é o componente a ser instalado e configFile é o de configuração do Terraform para a versão desejada.
6. Se você estiver revertendo o Qpid, limpe o iptables:
```
> sudo iptables -F
```
Para reverter o componente para uma versão específica da versão 4.18.01:
1. Faça o download da versão específica do componente:
```
> /opt/apigee/apigee-service/bin/apigee-service comp-version install
```
  em que comp-version é o componente e a versão a serem instalados. Exemplo:
```
> /opt/apigee/apigee-service/bin/apigee-service edge-ui-4.17.09-0.0.3749 install
```
  Se você estiver usando o repositório on-line da Apigee, será possível 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 como você só especifica o nome do componente ao fazer a instalação.

Entre em contato com o suporte do Apigee Edge se tiver problemas ao fazer a reversão.