Se você encontrar um erro durante uma atualização para o Edge 4.52.01, reverta o 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 convém realizar uma reversão:
- Reverter para uma versão principal ou secundária anterior. Por exemplo, de 4.52.01 a 4.52.00.
- Reverter para uma versão de patch anterior na mesma versão. Por exemplo, de 4.52.00.02 a 4.52.00.01.
Para mais informações, consulte o processo de lançamento do Apigee Edge.
Quem pode realizar uma reversão
O usuário que executa uma reversão precisa ser o mesmo que atualizou o Edge ou executando como raiz.
Por padrão, os componentes do Edge são executados como o usuário "apigee". Em alguns casos, você pode executar componentes do Edge como usuários diferentes. Por exemplo, se o roteador tiver que acessar portas privilegiadas, como as que estão abaixo de 1.000, execute o Roteador como raiz ou como um usuário com acesso a essas portas. Ou é possível executar um componente como usuário e outro componente como usuário.
Componentes com código comum
Os componentes do Edge a seguir compartilham um código comum. Portanto, para reverter qualquer um desses componentes em um nó, é preciso 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 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.
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 que 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
- Para reverter para a versão 4.51.00, faça o download de
- Pare o componente para reversão:
- Para reverter qualquer um dos componentes com código comum no
nó, é necessário interrompê-los, 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 outro componente no nó, interrompa apenas esse componente:
/opt/apigee/apigee-service/bin/apigee-service component stop
- Para reverter qualquer um dos componentes com código comum no
nó, é necessário interrompê-los, como mostra o exemplo a seguir:
- 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 o nó:
- Para reverter qualquer um dos componentes com código comum no nó, você precisa 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
- 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.
- Para reverter o roteador de borda, exclua o conteúdo do arquivo
/opt/nginx/conf.d
, além de desinstalar o grupo de componentesedge-gateway
:cd /opt/nginx/conf.d
rm -rf *
- Para reverter qualquer um dos componentes com código comum no nó, você precisa desinstalar todos eles desinstalando o grupo de componentes
- Desinstale a versão 4.52.01 de
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 doapigee-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á necessário inserir esse valor.
Se ocorrer um erro, verifique se você fez o download do arquivo
bootstrap.sh
na etapa 1. - Instalar
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 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 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
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 4.52.01, é 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á 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 que a instalação anterior do Edge.
- Registre os novos nós mestre e de espera com os grupos de análise e de consumidor.
Quando a reversão terminar, o nó mestre antigo não será mais necessário. Então, será possível desativar o antigo nó mestre.
- Verifique se o novo nó do Postgres em espera está em execução:
/opt/apigee/apigee-service/bin/apigee-all status
Inicie o Postgres se ele não estiver em execução:
/opt/apigee/apigee-service/bin/apigee-all start
- Verifique se o Postgres está interrompido 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 antigo nó de espera:
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
- Promova o novo nó de espera como mestre do Postgres:
- Promova o novo nó de espera para novo mestre:
apigee-service apigee-postgresql promote-standby-to-master new_standby_IP
Se for solicitado, insira a senha do Postgres para o usuário "apigee", que tem como padrão "postgres".
- Edite o arquivo de configuração usado para instalar a versão atual do Edge para especificar:
# IP address of the new master: PG_MASTER=new_standby_IP # IP address of the old standby node PG_STANDBY=old_standby_IP
- Configure o novo mestre:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-master -f configFile
- Promova o novo nó de espera para novo mestre:
- Se você já fez upgrade do antigo nó de espera para a versão mais recente, primeiro é necessário
fazer downgrade do software da Apigee no antigo nó de espera. Se você ainda tiver a versão mais antiga no antigo nó de espera, pule esta etapa e continue com a etapa 6.
- Interrompa o Postgres no antigo nó de espera:
apigee-service apigee-postgresql stop apigee-service edge-postgres-server stop
- Desinstale o Postgres do antigo nó de espera:
apigee-service apigee-postgresql uninstall apigee-service edge-postgres-server uninstall
- Exclua o diretório de dados do Postgres do antigo nó de espera:
cd /opt/apigee/data/apigee-postgresql/pgdata > rm -rf *
- Faça o download e execute a versão de inicialização mais antiga (para a versão da Apigee que está sendo revertida) no antigo nó de espera. As etapas exatas podem variar dependendo se você está usando a instalação pela Internet ou off-line. Quando você executa a versão mais antiga do bootstrap da Apigee, os repositórios do yum são configurados com os dados da Apigee de versão mais antiga.
- Configure os componentes do Postgres no antigo nó de espera:
/opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
- Verifique se os componentes do Postgres no antigo nó de espera
foram revertidos para a versão mais antiga:
apigee-service apigee-postgresql version apigee-service edge-postgres-server version
- Interrompa o Postgres no antigo nó de espera:
- Recrie o nó de espera antigo:
- Edite o arquivo de configuração usado para instalar a versão atual do Edge para especificar:
# 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 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 antigo nó de espera:
/opt/apigee/apigee-service/bin/apigee-all status
Inicie o Postgres se ele não estiver em execução:
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
- Edite o arquivo de configuração usado para instalar a versão atual do Edge para especificar:
- Verifique se o novo nó de espera foi adicionado visualizando o arquivo
/opt/apigee/apigee-postgresql/conf/pg_hba.conf
no novo mestre. - Visualize 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 camponame
emconsumer-groups
. Ela também retorna os UUIDs dos nós mestres e de espera antigos do Postgres nos campospostgres-server
edatastores
. Você verá a 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ó deve aparecer no final da saída, no seguinte formato:
"type" : [ "postgres-server" ], "uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
- Repita a etapa anterior para conseguir os endereços IP do antigo nó de espera 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 grupos de análises e consumidores. masterUUID,standbyUUID estão na mesma ordem em que apareceram acima quando você visualizou as informações atuais do grupo de consumidores e análise acima. Talvez seja necessário especificá-los como standbyUUID,masterUUID.
A propriedade
datastores
paraconsumer-groups
agora deve 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
emuuids
agora estará vazia. - Registre os novos nós mestres e de espera da PG com os grupos de análise e consumidor:
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ê 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 scripts a seguir 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 antigo nó de espera:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
Verifique se é o modo 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.
Como alternativa, você pode desinstalar o Qpid do mestre antigo e instalar o Qpid no novo nó mestre. Depois de desinstalar o Qpid, desative o nó mestre antigo.
Reverter mTLS
Para reverter a atualização mTLS, siga estas etapas em todos os hosts:
- Interromper a Apigee:
apigee-all stop
- Parar mTLS:
apigee-service apigee-mtls uninstall
- Reinstale o mTLS:
apigee-service apigee-mtls install
apigee-service apigee-mtls setup -f /opt/silent.conf