Esta página foi traduzida pela API Cloud Translation.

Atualize o Apigee Edge 4.50.00 ou 4.51.00 para 4.52.00

A Apigee oferece suporte ao upgrade do Edge para nuvem privada da versão 4.50.00 ou 4.51.00 diretamente para a versão 4.52.00. Nesta página, descrevemos como fazer upgrade.

Quem pode realizar a atualização

A pessoa que executa a atualização deve ser a mesma que instalou originalmente o Edge ou uma pessoa executando como raiz.

Qualquer pessoa pode configurar as RPMs de borda depois que elas são instaladas.

Quais componentes você precisa atualizar

Todos os componentes do Edge precisam ser atualizados. O Edge não oferece suporte a uma configuração que contém componentes de várias versões.

Atualizar pré-requisitos

Verifique os seguintes pré-requisitos antes de fazer upgrade do Apigee Edge:

Fazer backup de todos os nós
Antes de atualizar, recomendamos que você faça um backup completo de todos os nós por motivos de segurança. Use o procedimento da sua versão atual do Edge para fazer o backup.
Isso permite que você tenha um plano de backup, caso a atualização para uma nova versão não funcione corretamente. Para mais informações sobre backup, consulte Backup e restauração.
Verifique se o Edge está em execução
Verifique se o Edge está funcionando durante o processo de atualização usando o comando:
```
/opt/apigee/apigee-service/bin/apigee-all status
```
Verifique se a estratégia de compatibilidade do Cassandra está LeveledCompactionStrategy
Verifique se a estratégia de compatibilidade do Cassandra está definida como LeveledCompactionStrategy, conforme descrito em Mudar a estratégia de compactação do Cassandra.

Propagação automática das configurações da propriedade

Se você tiver definido alguma propriedade editando arquivos .properties em /opt/apigee/customer/application, esses valores serão retidos pela atualização.

Atualização necessária para o Zookeeper 3.8.0

Esta versão do Edge para nuvens privadas inclui um upgrade para o Zookeeper 3.8.0. Como parte dessa atualização, todos os dados do Zookeeper serão migrados para o Zookeeper 3.8.0.

Antes de fazer upgrade do Zookeeper, leia o guia de manutenção do Zookeeper. A maioria dos sistemas de produção de borda usa um cluster de nós do Zookeeper espalhados por vários data centers. Alguns desses nós são configurados como eleitores que participam da eleição de líder do Zookeeper, e o restante é configurado como observadores. Consulte Sobre líderes, seguidores, eleitores e observadores para mais detalhes. Os nós de eleitores elevam um líder depois que os próprios nós de eleitores se tornam seguidores.

Durante o processo de atualização, pode haver um atraso momentâneo ou uma falha de gravação no Zookeeper quando o nó líder é encerrado. Isso pode afetar as operações de gerenciamento gravadas no Zookeeper, como a operação de implantação de um proxy e alterações na infraestrutura da Apigee, como adição ou remoção de um processador de mensagens etc. Não haverá impacto nas APIs de ambiente de execução da Apigee (a menos que essas APIs de gerenciamento de chamadas das APIs de ambiente de execução) durante o upgrade do Zookeeper durante o procedimento abaixo.

De modo geral, o processo de upgrade envolve fazer um backup de cada nó. Em seguida, é feito o upgrade de todos os observadores e seguidores e, por fim, do upgrade do nó líder.

Fazer um backup

Faça um backup de todos os nós do Zookeeper para usar caso uma reversão seja necessária. Observe que uma reversão restaura o Zookeeper para o estado em que o backup foi feito. Observação: todas as implantações ou alterações de infraestrutura na Apigee desde que o backup foi feito (as informações armazenadas no Zookeeper) serão perdidas durante a restauração.

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper backup

Se você estiver usando máquinas virtuais e tiver os recursos, também é possível criar snapshots ou backups de VMs para restauração ou reversão (se necessário).

Identifique o líder, os seguidores e os observadores

Observação: os comandos de amostra abaixo usam o utilitário nc para enviar dados ao Zookeeper. Também é possível usar utilitários alternativos para enviar dados ao Zookeeper.

Se ele não estiver instalado no nó ZooKeeper, instale o nc:
```
  sudo yum install nc
```
Execute o seguinte comando nc no nó, em que 2181 é a porta do ZooKeeper:
```
  echo stat | nc localhost 2181
```
O resultado será assim:
```
  Zookeeper version: 3.8.0-5a02a05eddb59aee6ac762f7ea82e92a68eb9c0f, built on 2022-02-25 08:49 UTC
  Clients:
   /0:0:0:0:0:0:0:1:41246[0](queued=0,recved=1,sent=0)
  
  Latency min/avg/max: 0/0.2518/41
  Received: 647228
  Sent: 647339
  Connections: 4
  Outstanding: 0
  Zxid: 0x400018b15
  Mode: follower
  Node count: 100597
```
Na linha Mode da saída para os nós, você verá observador, líder ou seguidor (ou seja, um eleitor que não é o líder), dependendo da configuração do nó. Observação:em uma instalação autônoma do Edge com um único nó do ZooKeeper, o Mode é definido como autônomo.
Repita as etapas 1 e 2 em cada nó do ZooKeeper.

Fazer upgrade do Zookeeper nos nós do observador e do seguidor

Faça upgrade do Zookeeper em cada um dos nós do observador e do seguidor da seguinte maneira:

Faça o download e execute o bootstrap do Edge para nuvem privada 4.52, conforme descrito em Atualizar para a versão 4.52.00 em um nó com uma conexão de Internet externa. O processo provavelmente variará se o nó tiver uma conexão de Internet externa ou se você estiver executando uma instalação off-line.
Faça upgrade do componente Zookeeper:
```
  /opt/apigee/apigee-setup/bin/update.sh -c zk -f <silent-config-file>
```
Observação:se esses nós tiverem outros componentes instalados, como o Cassandra,será possível fazer o upgrade deles agora (como no perfil cs e zk) ou fazer o upgrade dos outros componentes mais tarde. A Apigee recomenda que você faça o upgrade do Zookeeper apenas primeiro e verifique se o cluster está funcionando corretamente antes de fazer upgrade de outros componentes.
Repita as etapas acima em cada nó do observador e seguidor do Zookeeper.

Encerrar o líder

Depois de fazer upgrade de todos os nós de observadores e seguidores, encerre o líder. No nó identificado como líder, execute o comando abaixo:

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

Observe que, durante esse evento, antes da escolha de um novo líder, pode haver atrasos momentâneos ou falhas de gravação no Zookeeper. Isso pode afetar operações gravadas no Zookeeper, como ação de implantação de proxies ou alterações na infraestrutura da Apigee, como adição ou remoção de processadores de mensagens etc.

Verificar se o novo líder foi eleito

Usando as etapas na seção Identificar líder, seguidores e observadores acima, verifique se um novo líder foi eleito entre os seguidores, assim que o líder atual for interrompido. O líder pode ter sido eleito em um data center diferente do líder atual.

Líder do upgrade

Siga as mesmas etapas apresentadas em Como fazer upgrade do Zookeeper nos nós do observador e do seguidor acima.

Após o upgrade do nó líder anterior também, verifique a integridade do cluster e confirme se há um nó líder.

Reverter

Caso uma reversão seja necessária:

Primeiro, execute as etapas de reversão nos observadores e seguidores.
Faça o download e execute o bootstrap da versão que está sendo revertida: 4.50 ou 4.51. O processo provavelmente variará se o nó tiver uma conexão de Internet externa ou se você estiver seguindo a instalação off-line.

Interrompa o Zookeeper se ele estiver em execução no nó:

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

Desinstalar o Zookeeper já existente:

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper uninstall

Instale o Zookeeper normalmente:

  /opt/apigee/apigee-setup/bin/setup.sh -p zk -f <silent-config-file>

Depois que todos os seguidores e observadores tiverem sido revertidos, reverta o nó líder seguindo as etapas 2 a 5 no nó líder.

Depois que todos os nós forem revertidos, verifique a integridade do cluster e confira se há um nó líder no cluster.

Restaurar backup

Consulte Restaurar de um backup. Observe que os backups do Zookeeper extraídos de versões anteriores do Edge para nuvem privada, como 4.50 e 4.51, precisam ser compatíveis com a versão do Zookeeper no Edge para nuvem privada 4.52.

Upgrade obrigatório para o Postgres 14

Esta versão do Edge inclui um upgrade para o Postgres 14. Como parte desse upgrade, todos os dados do Postgres são migrados para o Postgres 14.

A maioria dos sistemas de produção de borda usa dois nós do Postgres configurados para replicação mestre em espera. Durante o processo de atualização, enquanto os nós do Postgres estão desativados para atualização, os dados de análise ainda são gravados nos nós do Qpid. Depois que os nós do Postgres são atualizados e ficam on-line novamente, os dados de análise são enviados para eles.

A maneira de executar a atualização do Postgres depende de como você configurou o armazenamento de dados para os nós do Postgres:

Se você usar armazenamento de dados local para os nós do Postgres, precisará instalar um novo nó de espera do Postgres durante o upgrade. Após a conclusão do upgrade, será possível desativar o novo nó de espera do Postgres.
O nó de espera adicional do Postgres será necessário se você precisar reverter a atualização por qualquer motivo. Se você precisar reverter a atualização, o novo nó de espera do Postgres se tornará o nó mestre do Postgres após a reversão. Portanto, quando você instala o novo nó de espera do Postgres, ele precisa estar em um nó que atenda a todos os requisitos de hardware de um servidor Postgres, conforme definido nos Requisitos de instalação do Edge.

Em uma configuração de um e dois nós do Edge, as topologias usadas para prototipagem e testes, você tem apenas um único nó do Postgres. É possível atualizar esses nós do Postgres diretamente, sem precisar criar um novo nó do Postgres.
Se você usa armazenamento de rede para os nós do Postgres, conforme recomendado pela Apigee, não é necessário instalar um novo nó do Postgres. Nos procedimentos abaixo, pule as etapas que especificam a instalação e a desativação de um novo nó de espera do Postgres.
Antes de iniciar o processo de atualização, faça um snapshot da rede do repositório de dados usado pelo Postgres. Em seguida, se ocorrer um erro durante a atualização e você precisar fazer uma reversão, poderá restaurar o nó do Postgres desse snapshot.

Como instalar um novo nó de espera do Postgres

Este procedimento cria um servidor em espera do Postgres em um novo nó. Instale um novo servidor de espera do Postgres para a versão atual do Edge (4.50.00 ou 4.51.00), e não para a 4.52.00.

Para executar a instalação, use o mesmo arquivo de configuração usado para instalar a versão atual do Edge.

Para criar um novo nó de espera do Postgres:

No mestre atual do Postgres, edite o arquivo /opt/apigee/customer/application/postgresql.properties para definir o token a seguir. Se esse arquivo não existir, crie-o:
```
conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust
```
Em que existing_standby_ip é o endereço IP do servidor em espera atual do Postgres e new_standby_ip é o endereço IP do novo nó de espera.

Reinicie o apigee-postgresql no mestre do Postgres:

/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart

Visualize o arquivo /opt/apigee/apigee-postgresql/conf/pg_hba.conf no mestre para verificar se o novo nó de espera foi adicionado. Você verá as seguintes linhas nesse arquivo:
```
host replication apigee existing_standby_ip/32 trust
host replication apigee new_standby_ip/32 trust
```
Instale o novo servidor em espera do Postgres:
1. Edite o arquivo de configuração usado para instalar a versão atual do Edge para especificar:
```
# IP address of the current master:
PG_MASTER=192.168.56.103
# IP address of the new standby node
PG_STANDBY=192.168.56.102
```
2. Desative o SELinux conforme descrito em Instalar o utilitário de configuração da Apigee do Edge.
3. Se você estiver no Edge 4.51.00:
  1. Faça o download do arquivo Edge bootstrap_4.51.00.sh em /tmp/bootstrap_4.51.00.sh :
```
curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
```
  2. Instale o utilitário apigee-service e as dependências do Edge:
```
sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord
```
  Se você estiver no Edge 4.50.00:
  1. Faça o download do arquivo Edge bootstrap_4.50.00.sh em /tmp/bootstrap_4.50.00.sh :
```
curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
```
  2. Instale o utilitário apigee-service e as dependências do Edge:
```
sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord
```
4. Use apigee-service para instalar o utilitário apigee-setup:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
```
5. Instale o Postgres:
```
/opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
```
6. No novo nó de espera, execute o seguinte comando:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
```
  Verifique se é o modo de espera.

Como fazer um upgrade no local do Postgres

Observação:você precisa seguir a etapa preliminar a seguir antes de fazer um upgrade do Postgres no local.

Observação:com o Postgres 14, o parâmetro de configuração wal_keep_segments do Postgres não é mais compatível. Se você adicionou ou modificou esse parâmetro do Postgres, precisará removê-lo antes de fazer o upgrade. Para fazer isso:

Abra o arquivo $APIGEE_ROOT/customer/application/postgresql.properties.
Remova a configuração relacionada a wal_keep_segments.
Reinicie o Postgres.

Etapa preliminar

Antes de realizar um upgrade no local para o Postgres, siga as etapas a seguir no host mestre e no modo de espera para atualizar a propriedade max_locks_per_transaction em apigee-postgresql:

Se ele não estiver presente, crie o arquivo /opt/apigee/customer/application/postgresql.properties.

Mude a propriedade deste arquivo para apigee:

sudo chown apigee:apigee /opt/apigee/customer/application/postgresql.properties

Adicione a seguinte propriedade ao arquivo:

conf/postgresql.conf+max_locks_per_transaction=30000

Configurar apigee-postgresql:

apigee-service apigee-postgresql configure

Reiniciar apigee-postgresql:

apigee-service apigee-postgresql restart

Realizar o upgrade no local

Para fazer um upgrade no local para o Postgres 14, siga estas etapas:

Faça upgrade do postgres no host mestre

/opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf

Execute o comando de configuração no host mestre:

apigee-service apigee-postgresql setup -f /opt/silent.conf

Execute o comando de configuração no host mestre:
```
apigee-service apigee-postgresql configure
```

Reinicie o host mestre:

apigee-service apigee-postgresql restart

Configure-o como principal:

apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf

Verifique se o host mestre foi iniciado:

apigee-service apigee-postgresql wait_for_ready

Parar o modo de espera:
```
apigee-service apigee-postgresql stop
```
Atualizar o modo de espera.
Observação:se esta etapa apresentar erros/falhar, ela poderá ser ignorada. update.sh tentará iniciar o servidor em espera com uma configuração incorreta. Se a instalação do Postgres for atualizada para a versão 14, o erro poderá ser ignorado.
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
```
Verifique se o modo de espera está interrompido:
```
apigee-service apigee-postgresql stop
```

Remova a configuração de espera antiga:

rm -rf /opt/apigee/data/apigee-postgresql/

Configure a replicação no servidor em espera:

apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf

Remova a linha conf/postgresql.conf+max_locks_per_transaction=30000 do arquivo /opt/apigee/customer/application/postgresql.properties no host mestre e em espera. Essa linha foi adicionada na etapa preliminar.

Após concluir este procedimento, o modo de espera será iniciado.

Como desativar um nó do Postgres

Após a conclusão da atualização, desative o novo nó de espera:

Verifique se o Postgres está sendo executado:
```
/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
```
Receba o UUID do novo nó de espera executando o seguinte comando curl no novo nó de espera:
```
curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self
```
Você verá o UUID do nó no final da saída, no seguinte formato:
```
"type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
```
Pare o novo nó de espera executando o seguinte comando no novo nó de espera:
```
/opt/apigee/apigee-service/bin/apigee-all stop
```
No nó mestre do Postgres, edite /opt/apigee/customer/application/postgresql.properties para remover o novo nó de espera de conf_pg_hba_replication.connection:
```
conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust
```

Reinicie o apigee-postgresql no mestre do Postgres:

/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart

Verifique se o novo nó de espera foi removido visualizando o arquivo /opt/apigee/apigee-postgresql/conf/pg_hba.conf no mestre. Você verá apenas a seguinte linha nesse arquivo:
```
host replication apigee existing_standby_ip/32 trust
```
Exclua o UUID do nó de espera do ZooKeeper fazendo a seguinte chamada de API de gerenciamento de borda no nó do servidor de gerenciamento:
```
curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid
```

Nova interface do Edge

Nesta seção, listamos considerações sobre a interface do Edge. Para mais informações, acesse A nova interface do Edge para nuvem privada.

Instalar a interface do Edge

Depois de concluir a instalação inicial, a Apigee recomenda instalar a interface do Edge, que é uma interface do usuário aprimorada para desenvolvedores e administradores do Apigee Edge para nuvem privada.

Observe que a IU do Edge exige que você desative a autenticação básica e use um IdP, como SAML ou LDAP.

Para mais informações, consulte Instalar a nova interface do Edge.

Atualizar a interface do Edge

Para atualizar o componente de interface do Edge, considere a versão do Edge para a nuvem privada da qual você está fazendo upgrade:

De 4.51.00 a 4.52.00 (com a nova interface do Edge já instalada): use as instruções de upgrade nesta seção para o componente edge-management-ui.

Atualizar com o mTLS da Apigee

Para atualizar o mTLS da Apigee , siga estas etapas:

Como reverter uma atualização

No caso de uma falha na atualização, tente corrigir o problema e execute update.sh novamente. Você pode executar a atualização várias vezes e ela continua de onde parou.

Se a falha exigir que você reverta a atualização para a versão anterior, consulte Reverter 4.52.00 para ver instruções detalhadas.

Informações de atualização do Logging

Por padrão, o utilitário update.sh grava informações de registro em:

/opt/apigee/var/log/apigee-setup/update.log

Se a pessoa que está executando o utilitário update.sh não tiver acesso a esse diretório, ele gravará o registro no diretório /tmp como um arquivo chamado update_username.log.

Se a pessoa não tiver acesso ao /tmp, o utilitário update.sh falhará.

Atualização sem inatividade

Uma atualização sem inatividade, ou atualização gradual, permite atualizar a instalação do Edge sem encerrar o serviço.

A atualização sem inatividade só é possível com uma configuração de cinco nós ou mais.

A chave para o upgrade sem inatividade é remover um roteador de cada vez do balanceador de carga. Em seguida, você atualiza o roteador e todos os outros componentes na mesma máquina que o roteador e, em seguida, adiciona o roteador de volta ao balanceador de carga.

Atualize as máquinas na ordem correta da instalação, conforme descrito Ordem de atualização da máquina.
Quando chegar a hora de atualizar os roteadores, selecione um deles e torne-o inacessível, conforme descrito em Como ativar/desativar a acessibilidade do servidor (processador de mensagens/roteador).
Atualize o roteador selecionado e todos os outros componentes do Edge na mesma máquina que o roteador. Todas as configurações de borda mostram um roteador e um processador de mensagens no mesmo nó.
Deixe o roteador acessível novamente.
Repita as etapas 2 a 4 para os outros roteadores.
Continue a atualização para as máquinas restantes na instalação.

Tome cuidado ao fazer o seguinte antes e depois da atualização:

No nó do roteador e do processador de mensagens combinados:
- Antes da atualização, faça o seguinte:
  1. Deixe o roteador inacessível.
  2. Torna o processador de mensagens inacessível.
- Após a atualização, faça o seguinte:
  1. Torne o processador de mensagens acessível.
  2. Deixe o roteador acessível.
Em nós de roteador únicos:
- Antes da atualização, deixe o roteador inacessível.
- Após a atualização, torne o roteador acessível.
Em nós únicos do processador de mensagens:
- Antes da atualização, deixe o processador de mensagens inacessível.
- Após a atualização, torne o processador de mensagens acessível.

Usar um arquivo de configuração silencioso

Você deve passar um arquivo de configuração silencioso para o comando de atualização. O arquivo de configuração silenciosa precisa ser o mesmo usado para instalar o Edge 4.50.00 ou 4.51.00.

Atualize para a versão 4.52.00 em um nó com uma conexão de Internet externa

Use o procedimento a seguir para atualizar os componentes do Edge em um nó:

Se presente, desative todos os jobs cron configurados para executar uma operação de reparo no Cassandra até que a atualização seja concluída.
Faça login no nó como raiz para instalar as RPMs de borda.
OBSERVAÇÃO:embora a instalação da RPM exija acesso à raiz, é possível realizar a configuração do Edge sem esse acesso.
Instale yum-utils e yum-plugin-priorities:
Observação:se seu sistema operacional for RHEL 8.0 - 8.6, pule esta etapa.
```
sudo yum install yum-utils
sudo yum install yum-plugin-priorities
```
Desative o SELinux conforme descrito em Instalar o utilitário de configuração da Apigee do Edge.
Se você estiver instalando no Oracle 7.x, execute o seguinte comando:
```
sudo yum-config-manager --enable ol7_optional_latest
```

Se você estiver instalando na AWS, execute os seguintes comandos yum-configure-manager:

yum update rh-amazon-rhui-client.noarch
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

Se você estiver no Edge 4.51.00:
1. Faça o download do arquivo bootstrap_4.52.00.sh do Edge em /tmp/bootstrap_4.52.00.sh:
```
curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
```
2. Execute o comando a seguir para instalar o utilitário apigee-service do Edge 4.52.00 e as dependências:
```
sudo bash /tmp/bootstrap_4.52.00.sh apigeeuser=uName apigeepassword=pWord
```
  Em que uName:pWord é o nome de usuário e a senha que você recebeu da Apigee. Se você omitir pWord, será solicitado que o insira.
  
  Por padrão, o instalador verifica se você tem o Java 1.8 instalado. Caso contrário, o instalador vai instalar o app para você.
  
  Use a opção JAVA_FIX para especificar como lidar com a instalação do Java. JAVA_FIX assume os seguintes valores:
  - I: instala o OpenJDK 1.8 (padrão).
  - C: continua sem instalar o Java.
  - Q: sair. Para usar essa opção, você precisa instalar o Java por conta própria.
3. Use apigee-service para atualizar o utilitário apigee-setup, como o exemplo a seguir mostra:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
```
4. Atualize o utilitário apigee-validate no servidor de gerenciamento, conforme o exemplo a seguir:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
```
5. Atualize o utilitário apigee-provision no servidor de gerenciamento, conforme o exemplo a seguir:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
```
6. Execute o seguinte comando para executar o utilitário update nos nós:
```
/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
```
  Faça isso na ordem descrita em Ordem de atualização da máquina.
  
  Em que:
  - component é o componente Edge a ser atualizado. Os valores possíveis incluem:
    - cs: Cassandra
    - edge: todos os componentes do Edge, exceto a IU do Edge: servidor de gerenciamento, processador de mensagens, roteador, servidor QPID, servidor Postgres
    - ldap: OpenLDAP
    - ps: postgresql
    - qpid: qpidd
    - sso: SSO da Apigee (se você tiver instalado o SSO)
    - ue: nova interface do Edge
    - ui: interface clássica do Edge
    - zk: tratador
  - configFile é o mesmo arquivo de configuração usado para definir os componentes do Edge durante a instalação da versão 4.50.00 ou 4.51.00.
  É possível executar update.sh em todos os componentes configurando component como "todos", mas somente se você tiver um perfil de instalação all-in-one (AIO) do Edge. Exemplo:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
```
7. Reinicie o componente de interface do Edge em todos os nós que o executam, caso ainda não tenha feito isso:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
8. Teste a atualização executando o utilitário apigee-validate no servidor de gerenciamento, conforme descrito em Testar a instalação.
Se você decidir reverter a atualização, use o procedimento descrito em Reverter 4.52.00.

Atualização para a versão 4.52.00 de um repositório local

Se os nós do Edge estiverem protegidos por um firewall ou, de alguma outra forma, forem proibidos de acessar o repositório da Apigee pela Internet, será possível realizar a atualização em um repositório local ou espelho do repositório da Apigee.

Depois de criar um repositório local do Edge, você tem duas opções para atualizar o Edge a partir do repositório local:
- Crie um arquivo .tar do repositório, copie o arquivo .tar para um nó e atualize o Edge a partir do arquivo .tar.
- Instale um servidor da Web no nó com o repositório local para que outros nós possam acessá-lo. A Apigee fornece o servidor da Web Nginx para você usar. Também é possível usar seu próprio servidor da Web.
Para atualizar de um repositório 4.52.00 local:
1. Crie um repositório 4.52.00 local, conforme descrito em "Criar um repositório local da Apigee" em Instalar o utilitário apigee-setup do Edge.
  OBSERVAÇÃO: se você já tiver um repositório, poderá adicionar o repositório 4.52.00 a ele, conforme descrito em "Atualizar um repositório local da Apigee" em Instalar o utilitário apigee-setup do Edge (em inglês).
2. Para instalar o Apigee-service de um arquivo .tar, faça o seguinte:
  1. No nó com o repositório local, use o seguinte comando para empacotar o repositório local em um único arquivo .tar chamado /opt/apigee/data/apigee-mirror/apigee-4.52.00.tar.gz:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
```
  2. Copie o arquivo .tar para o nó em que você quer atualizar o Edge. Por exemplo, copie-o para o diretório /tmp no novo nó.
  3. No novo nó, descompacte o arquivo para o diretório /tmp:
```
tar -xzf apigee-4.52.00.tar.gz
```
    Esse comando cria um novo diretório, chamado repos, no diretório que contém o arquivo .tar. Por exemplo, /tmp/repos.
  4. Instale o utilitário apigee-service do Edge e as dependências do /tmp/repos:
```
sudo bash /tmp/repos/bootstrap_4.52.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
```
    Nesse comando, inclua o caminho para o diretório dos repositórios.
3. Para instalar o serviço da Apigee usando o servidor da Web Nginx:
  1. Configure o servidor da Web Nginx conforme descrito em "Instalar do repositório usando o servidor da Web Nginx" em Instalar o utilitário de configuração da Apigee do Edge.
  2. No nó remoto, faça o download do arquivo bootstrap_4.52.00.sh do Edge em /tmp/bootstrap_4.52.00.sh:
```
/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.sh
```
    Em que uName:pWord é o nome de usuário e a senha que você definiu anteriormente para o repositório, e remoteRepo é o endereço IP ou nome DNS do nó do repositório.
  3. No nó remoto, instale o utilitário apigee-setup e as dependências do Edge:
```
sudo bash /tmp/bootstrap_4.52.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
```
    Em que uName:pWord são o nome de usuário e a senha do repositório.
4. Use apigee-service para atualizar o utilitário apigee-setup, como o exemplo a seguir mostra:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update 
```
5. Atualize o utilitário apigee-validate no servidor de gerenciamento, conforme o exemplo a seguir:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
```
6. Atualize o utilitário apigee-provision no servidor de gerenciamento, conforme o exemplo a seguir:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
```
7. Execute o utilitário update nos nós na ordem descrita em Ordem de atualização da máquina:
```
/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
```
  Em que:
  - component é o componente Edge a ser atualizado. Geralmente, os seguintes componentes são atualizados:
    - cs: Cassandra
    - edge: todos os componentes do Edge, exceto a interface do Edge: servidor de gerenciamento, processador de mensagens, roteador, servidor QPID, servidor Postgres
    - ldap: OpenLDAP
    - ps: postgresql
    - qpid: qpidd
    - sso: SSO da Apigee (se você tiver instalado o SSO)
    - ue Nova interface do Edge
    - ui: interface clássica do Edge
    - zk: tratador
  - configFile é o mesmo arquivo de configuração usado para definir os componentes do Edge durante a instalação da versão 4.50.00 ou 4.51.00.
    OBSERVAÇÃO: o arquivo de configuração precisa ser legível pelo usuário "apigee". Para alterar o proprietário, use este comando:
```
chown apigee:apigee configFile
```
  É possível executar update.sh em todos os componentes configurando component como "todos", mas somente se você tiver um perfil de instalação all-in-one (AIO) do Edge. Exemplo:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
```
8. Reinicie os componentes da interface em todos os nós que os executam, caso ainda não tenha feito isso:
```
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
```
9. Teste a atualização executando o utilitário apigee-validate no servidor de gerenciamento, conforme descrito em Testar a instalação.
Se você decidir reverter a atualização, use o procedimento descrito em Reverter 4.52.00.

Ordem de atualização da máquina

A ordem de atualização das máquinas em uma instalação do Edge é importante:
- É preciso atualizar todos os nós do Cassandra e do ZooKeeper antes de atualizar os outros nós.
- Para qualquer máquina com vários componentes de borda (servidor de gerenciamento, processador de mensagens, roteador, servidor QPID, mas não servidor Postgres), use a opção -c edge para atualizar todos ao mesmo tempo.
- Se uma etapa especificar que ela precisa ser executada em várias máquinas, execute-a na ordem especificada.
- Não há uma etapa separada para atualizar a monetização. Ele é atualizado quando você especifica a opção -c edge.
OBSERVAÇÃO: depois de atualizar o componente da interface do Edge, você precisará reiniciar o serviço da interface do Edge, conforme descrito nas instruções de instalação da atualização.

Upgrade independente com um nó

Para fazer upgrade de uma configuração autônoma de um nó para a versão 4.52.00:
1. Atualizar todos os componentes:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
```
2. (Se você instalou apigee-adminapi) Atualização do utilitário apigee-adminapi:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
Upgrade independente de dois nós

Atualize os seguintes componentes para uma instalação autônoma de dois nós:

Consulte Topologias de instalação para acessar a lista de topologias de borda e números de nós.
1. Atualize o Cassandra e o ZooKeeper na máquina 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
2. Atualize o Qpid e Postgres na máquina 2:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
```
3. Atualize o LDAP na máquina 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
4. Atualize os componentes do Edge nas máquinas 2 e 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
5. Atualize a interface na máquina 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
```
6. (Se você instalou apigee-adminapi) O utilitário apigee-adminapi foi atualizado na máquina 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
7. (Se você instalou o SSO da Apigee) Atualize o SSO da Apigee na máquina 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
  Em que sso_config_file é o arquivo de configuração que você criou quando instalou o SSO.
8. Reinicie o componente de IU do Edge na máquina 1:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
Upgrade de cinco nós

Atualize os componentes a seguir para uma instalação de cinco nós:

Consulte Topologias de instalação para acessar a lista de topologias de borda e números de nós.
1. Atualize o Cassandra e o ZooKeeper nas máquinas 1, 2 e 3:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
2. Atualize o Qpid e Postgres na máquina 4:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
```
3. Atualize o Qpid e Postgres na máquina 5:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
```
4. Atualize o LDAP na máquina 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
5. Atualize os componentes do Edge nas máquinas 4, 5, 1, 2 e 3:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
6. Atualize a interface do Edge:
  - IU clássica:se você estiver usando a interface clássica, atualize o componente ui na máquina 1, conforme mostrado no exemplo a seguir:
```
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
```
  - Nova interface do Edge:se você instalou a nova interface do Edge, atualize o componente ue na máquina apropriada (pode não ser a máquina 1):
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
```
7. (Se você instalou apigee-adminapi) O utilitário apigee-adminapi foi atualizado na máquina 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
8. (Se você instalou o SSO da Apigee) Atualize o SSO da Apigee na máquina 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
  Em que sso_config_file é o arquivo de configuração que você criou quando instalou o SSO.
9. Reinicie o componente de IU:
  - IU clássica:se você estiver usando a interface clássica, reinicie o componente edge-ui na máquina 1, como mostra o exemplo a seguir:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
  - Nova interface do Edge:se você instalou a nova interface do Edge, reinicie o componente edge-management-ui na máquina apropriada (pode não ser a máquina 1):
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```
Upgrade em cluster com nove nós

Atualize os componentes a seguir para uma instalação em cluster com nove nós:

Consulte Topologias de instalação para acessar a lista de topologias de borda e números de nós.
1. Atualize o Cassandra e o ZooKeeper nas máquinas 1, 2 e 3:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
2. Atualize o Qpid nas máquinas 6 e 7:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
3. Atualize o Postgres na máquina 8:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
4. Atualize o Postgres na máquina 9:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
5. Atualize o LDAP na máquina 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
6. Atualize os componentes do Edge nas máquinas 6, 7, 8, 9, 1, 4 e 5 nesta ordem:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
7. Atualize a nova interface (ue) ou a clássica (ui) na máquina 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
8. (Se você instalou apigee-adminapi) Atualize o utilitário apigee-adminapi na máquina 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
9. (Se você instalou o SSO da Apigee) Atualize o SSO da Apigee na máquina 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
  Em que sso_config_file é o arquivo de configuração que você criou quando instalou o SSO.
10. Reinicie o componente de IU:
  - IU clássica:se você estiver usando a interface clássica, reinicie o componente edge-ui na máquina 1, como mostra o exemplo a seguir:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
  - Nova interface do Edge:se você instalou a nova interface do Edge, reinicie o componente edge-management-ui na máquina apropriada (pode não ser a máquina 1):
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```
Upgrade em cluster de 13 nós

Atualize os componentes a seguir para uma instalação em cluster de 13 nós:

Consulte Topologias de instalação para acessar a lista de topologias de borda e números de nós.
1. Atualize o Cassandra e o ZooKeeper nas máquinas 1, 2 e 3:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
2. Atualize o Qpid nas máquinas 12 e 13:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
3. Atualize o Postgres na máquina 8:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
4. Atualize o Postgres na máquina 9:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
5. Atualize o LDAP nas máquinas 4 e 5:
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
6. Atualize os componentes do Edge nas máquinas 12, 13, 8, 9, 6, 7, 10 e 11 nesta ordem:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
7. Atualize a nova IU (ue) ou a clássica (ui) nas máquinas 6 e 7:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
8. (Se você instalou apigee-adminapi) O utilitário apigee-adminapi foi atualizado nas máquinas 6 e 7:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
9. (Se você instalou o SSO da Apigee) Atualize o SSO da Apigee nas máquinas 6 e 7:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
  Em que sso_config_file é o arquivo de configuração que você criou quando instalou o SSO.
10. Reinicie o componente de IU:
  - IU clássica:se você estiver usando a IU clássica, reinicie o componente edge-ui nas máquinas 6 e 7, conforme mostrado no exemplo a seguir:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
  - Nova interface do Edge:se você instalou a nova interface do Edge, reinicie o componente edge-management-ui nas máquinas 6 e 7:
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```
Upgrade em cluster de 12 nós

Atualize os componentes a seguir para uma instalação em cluster de 12 nós:

Consulte Topologias de instalação para acessar a lista de topologias de borda e números de nós.
1. Atualize o Cassandra e o ZooKeeper:
  1. Nas máquinas 1, 2 e 3 do data center 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
  2. Nas máquinas 7, 8 e 9 no data center 2
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
2. Atualize o qpidd:
  1. Máquinas 4, 5 no data center 1
    1. Atualize qpidd na máquina 4:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
    2. Atualize qpidd na máquina 5:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
  2. Máquinas 10, 11 no data center 2
    1. Atualize qpidd na máquina 10:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
    2. Atualize qpidd na máquina 11:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
3. Atualize o Postgres:
  1. Máquina 6 no data center 1
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
  2. Máquina 12 no data center 2
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
4. Atualize o LDAP:
  1. Máquina 1 no data center 1
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
  2. Máquina 7 no data center 2
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
5. Atualize os componentes do Edge:
  1. Máquinas 4, 5, 6, 1, 2, 3 no data center 1
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
  2. Máquinas 10, 11, 12, 7, 8, 9 no data center 2
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
6. Atualize a nova interface (ue) ou a clássica (ui):
  1. Máquina 1 no data center 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
  2. Máquina 7 no data center 2:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
7. (Se você instalou apigee-adminapi) O utilitário apigee-adminapi foi atualizado:
  1. Máquina 1 no data center 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
  2. Máquina 7 no data center 2:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
8. (Se você instalou o SSO da Apigee) Atualize o SSO da Apigee:
  1. Máquina 1 no data center 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
  2. Máquina 7 no data center 2:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
9. Reinicie a nova interface do Edge (edge-management-ui) ou o componente da interface clássica do Edge (edge-ui) nas máquinas 1 e 7:
```
/opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart
```
Para uma configuração não padrão

Se você tiver uma configuração não padrão, atualize os componentes do Edge na seguinte ordem:
1. ZooKeeper
2. Cassandra
3. qpidd, ps
4. LDAP
5. Edge, que significa o perfil "-c borda" em todos os nós na ordem: nós com servidor Qpid, servidor Edge Postgres, servidor de gerenciamento, processador de mensagens e roteador.
  OBSERVAÇÃO: se um nó tiver o servidor Qpid e o Edge Postgres Server instalados, execute a etapa do perfil "-c Edge".
6. interface do Edge (clássica ou nova)
7. apigee-adminapi
8. SSO da Apigee
Depois de concluir a atualização, reinicie o componente de IU do Edge em todas as máquinas que o executam.