Esta página foi traduzida pela API Cloud Translation.

17.4.09 Processo de reversão

Edge para nuvem privada v. 4.17.09

No caso de um erro durante uma atualização para o Edge 4.17.09, é possível reverter o componente que causou o erro e tentar fazer a atualização novamente. Por exemplo, se a atualização para o Postgres 9.4 falhar, reverta apenas os nós do Postgres e tente atualizar novamente.

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

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

Use o procedimento abaixo para realizar uma reversão para os dois cenários.

Quem pode realizar a reversão

O usuário que executa a reversão precisa ser o mesmo que atualizou o Edge ou um usuário que está executando como raiz.

Por padrão, os componentes do Edge são executados como o usuário "apigee". Em alguns casos, é possível executar componentes do Edge como usuários diferentes. Por exemplo, se o roteador tiver que acessar portas privilegiadas, como as abaixo de 1.000, execute o roteador 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.

Quais componentes podem ser revertidos

Você precisa estar ciente das seguintes condições ao realizar uma reversão:

Os cinco componentes do Edge listados abaixo compartilham um código comum. Portanto, para reverter qualquer um dos cinco componentes em um nó, é preciso reverter qualquer um dos cinco instalados no nó. Por exemplo, se o servidor de gerenciamento, o roteador e o processador de mensagens estiverem instalados no nó, será necessário reverter os três para reverter qualquer um deles.
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. Esta versão do Edge contém uma versão atualizada do Cassandra. Se você reverter algum componente, deixe o Cassandra na versão 4.17.09.

Reversão 4.17.09

Esta seção contém o procedimento para reverter o Edge 4.17.09 para uma versão anterior. Esta seção é dividida em duas partes:

Se você estiver atualizando somente a versão 4.16.01 ou 4.16.05, reverta a atualização do Postgres para a versão 9.4
A parte final de cada procedimento de atualização das versões 4.16.01 ou 4.16.05 é atualizar os nós do Postgres para a versão 9.4. Se essa atualização falhar, use este procedimento para revertê-la.
Como reverter todos os outros componentes do Edge
Use este procedimento para reverter outros componentes do Edge.

Para reverter a atualização do Postgres 9.4

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

Promova o novo nó de espera para se tornar o mestre do Postgres. O novo mestre do Postgres terá 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 será a mesma da instalação anterior do Edge.
Registre os novos nós mestre e de espera com os grupos de análise e consumidor.

Quando a reversão for concluída, o nó mestre antigo não será mais necessário. Em seguida, desative o nó mestre antigo.

Verifique se o novo nó do Postgres em espera está em execução:
> /opt/apigee/apigee-service/bin/apigee-all

Se o Postgres não estiver em execução, inicie-o:
> /opt/apigee/apigee-service/bin/apigee-all start
Verifique se o Postgres está interrompido no nó mestre e no nó de espera antigo:
> > status /opt/apigee/apigee-service/bin/apigee-all"

Se o Postgres estiver em execução, pare-o:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop do antigo nó
> apigee/opt/apigee-servicesql/apigee-apigee/apigee-apigee-apigee-sql (apigee-apigee/apigee-apigee-sql), como apigee/apigee-apigee-service, como:
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/apigee/apigee-apigee-sql
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 vai 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 para novo mestre:
  > apigee-service apigee-postgresqlpromote-standby-to-master new_standby_IP
  
  Se for solicitado, digite a senha do Postgres para o usuário "apigee", que tem o padrão "postgres".
2. Edite o arquivo de configuração usado para instalar a versão atual do Edge para especificar o seguinte:
  # endereço IP do novo mestre:
  PG_MASTER=new_standby_IP
  # endereço IP do nó antigo nó
  PG_STANDBY=old_standby_IP
3. Configurar o novo mestre:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-master -f configFile
Recrie o antigo nó de espera:
1. Edite o arquivo de configuração usado para instalar a versão atual do Edge para especificar o seguinte:
  # endereço IP do novo mestre:
  PG_MASTER=new_standby_IP
  # endereço IP do nó antigo nó
  PG_STANDBY=old_standby_IP
2. Remova o diretório de dados do nó de espera antigo:
  > cd /opt/apigee/data/apigee-postgresql/pgdata
  > rm -rf *
3. 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
4. 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-serviceedge-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 análises atuais e as informações 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 consumer-groups. Ela também retorna os UUIDs dos nós mestres e de espera antigos do Postgres nos campos postgres-server e datastores. você
Consiga o endereço UUID do mestre antigo executando o comando cURL a seguir no 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:

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 Postres.
Repita a etapa anterior para conseguir os endereços IP do antigo nó de espera 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/datastore UUID-group analytics e padrão de consumo consumer-group-001/datastore-UUID-group and

masterUUID,standbyUUID estão na mesma ordem em que apareceram acima quando você visualizou as informações atuais de análise e grupo de consumidores acima. Talvez seja necessário especificá-los como standbyUUID,masterUUID.

A propriedade datastores para 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,postu-server agora em
Registre os novos nós mestre e de espera da PG com os grupos de análise e de consumidor:
> curl -u sysAdminEmail:password -X POST -H "Content-Type: application/json" -d '' "http://<ms_IP>:8080/v1/analytics/groups/ax/axgroup-consumer-password
Valide o grupo de análise:
> curl -u sysAdminEmail:password http://<ms_IP>:8080/v1/analytics/groups/ax

Você vai 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 de Borda:
> /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 mostrar resultados idênticos nos dois servidores para garantir a replicação:

Na nova instância mestre, execute:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

Valide se a instância é a mestre.

No antigo nó de espera:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

Confirme que o status está em 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 Atualizar o Apigee Edge 4.16.01/4.16.05 para 4.17.09.

Observação: se o nó mestre antigo estava executando o Qpid, deixe esse servidor aberto 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 da instância mestre antiga e instalar o Qpid no novo nó mestre, conforme descrito abaixo. Depois de desinstalar o Qpid, você poderá desativar o antigo nó mestre.

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:

Execute o seguinte comando em todos os processadores de mensagens para bloquear o acesso à porta Qpid 5672 no mestre antigo:
> iptables -A OUTPUT -p tcp -d 10.233.147.20 --dport 5672 -j DROP
Execute o comando a seguir para verificar se a fila de mensagens do Qpid está vazia. Não é possível desinstalar o Qpid até que ele tenha processado todas as mensagens pendentes:
> qpid-stat -q

Esse comando exibe uma tabela com uma contagem de msg, msgIn e msgOut. Todas as mensagens terão sido processadas quando msg=0 e msgIn=msgOut.
Determine o UUID do servidor Qpid no mestre antigo executando o comando a seguir nele. Salve estas informações para mais tarde 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-serviceedge-qpid-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd stop
Desinstale o servidor Qpid:
> /opt/apigee/apigee-service/bin/apigee-serviceqpid-server desinstalar
> /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd desinstalação
Remova o antigo servidor Qpid dos grupos de análise e consumidor:
> curl -u sysAdminEmail:password -X DELETE -H "Content-Type: application/json" -d '' "http://<ms_IP>:8080/v1/analytics/groups/ax/axaxgroup-consumer-1"axaxgroup-consumer-1
Remova o antigo servidor Qpid 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 comando a seguir nele. Salve estas informações para mais tarde no procedimento:
> curl -u sysAdminEmail:password http://<node_IP>::8083/v1/servers/self
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 são atualizados enquanto o servidor Qpid processa mensagens.

Para reverter componentes individuais da versão 4.17.09

Como parte da reversão, você precisa fazer o download do arquivo bootstrap.sh da versão atual do Edge:

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 fazer reversão para cada nó que hospeda um componente, faça o seguinte:

Interrompa a reversão do componente:
1. Se você estiver revertendo qualquer um dos seguintes componentes no nó, precisará interromper todos eles: servidor de gerenciamento, roteador, processador de mensagens, servidor Qpid ou servidor Postgres:
  - > parada do servidor de gerenciamento de borda do serviço da Apigee
  - > Parada do roteador de borda do serviço da Apigee
  - > O serviço Edge-message-processor foi interrompido do apigee-service
  - > apigee-service borda-qpid-server parada
  - > Parada do apigee-service Edge-postgres-server
2. Se você estiver revertendo qualquer outro componente no nó, interrompa apenas esse componente:
  - > apigee-service comp parada
Se você estiver revertendo a monetização, desinstale-a de todos os nós do servidor de gerenciamento e do processador de mensagens:
> apigee-service edge-mint-gateway desinstalar
Desinstale o componente para reverter no nó:
1. Se você estiver revertendo qualquer um destes componentes no nó, desinstale todos eles: Servidor de gerenciamento, roteador, processador de mensagens, servidor Qpid ou servidor Postgres:
  > desinstalação do gateway de borda do serviço da Apigee
2. Se você estiver revertendo qualquer outro componente no nó, desinstale apenas esse componente:
  > apigee-service comp desinstalar
3. Se você estiver revertendo o roteador, será necessário excluir o conteúdo de /opt/nginx/conf.d:
  > cd /opt/nginx/conf.d
  > rm -rf *
Para reverter o componente:
1. Desinstale a versão 4.17.09 do apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup desinstalação.
2. Faça o download de bootstrap.sh para a versão 4.16.01, 4.16.05, 4.16.09, 4.17.01 ou 4.17.05:
  
  Por exemplo, para a versão 4.16.09:
  > curl https://software.apigee_com/boots0.tmp_4.
3. Instale o utilitário e as dependências 4.16.01, 4.16.05 ou 4.16.09 do apigee-service.
  
  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 o pWord, será necessário inseri-lo.
4. Instale a versão 4.16.01, 4.16.05, 4.16.09, 4.17.01 ou 4.17.05 da apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
5. Instale a versão 4.16.01, 4.16.05, 4.16.09, 4.17.01 ou 4.17.05 do:
  > /opt/apigee/apigee-setup/bin/setup.sh -p comp -ff.f.Arquivo, .config.
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.17.09 :
1. Faça o download da versão do componente específico:
  > /opt/apigee/apigee-service/bin/apigee-service comp-version instalar
  
  em que comp-version é o componente e a versão a ser instalado. Por 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, determine as versões disponíveis dos componentes usando este comando:
  > yum --show duplicates list compyum --
  Por exemplo:
2. Use apigee-setup para instalar o componente:
  > /opt/apigee/apigee-setup/bin/setup.sh -p comp -f configFile
  
  Por exemplo:
  > /opt/apigee/apigee-setup/bin/setup.sh -p ui -f setup.sh -p comp -f configFile
  
  Por exemplo:
  > /opt/apigee/apigee-setup/bin/setup.sh -p ui -f especificando apenas como você instala o componente
  Note como você faz a instalação do componente.

Entre em contato com o suporte da Apigee se você encontrar problemas ao reverter.