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 a partir da versão 4.50.00 ou a versão 4.51.00 diretamente versão 4.52.00. Nesta página, descrevemos como realizar um desses upgrades.

Quem pode realizar a atualização

A pessoa que está executando a atualização deve ser a mesma que instalou o Edge originalmente ou um pessoa executando-a como raiz.

Depois de instalar os RPMs do Edge, qualquer pessoa poderá configurá-los.

Quais componentes você precisa atualizar

É necessário atualizar todos os componentes do Edge. O Edge não oferece suporte a uma configuração que contém componentes de várias versões.

Atualizar pré-requisitos

Verifique se você atende aos seguintes pré-requisitos antes de fazer upgrade do Apigee Edge:

Fazer backup de todos os nós
Antes da atualização, recomendamos que você faça um backup completo de todos os nós por motivos de segurança motivos. 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 para funcionar corretamente. Para mais informações sobre backup, consulte Backup e restaurar.
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 compensação do Cassandra está LeveledCompactionStrategy
Verificar se a estratégia de compatibilidade do Cassandra está definida como LeveledCompactionStrategy, conforme descrito nas Altere o Estratégia de compactação do Cassandra.

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

Se você definiu propriedades editando os arquivos .properties no /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 for Private Cloudes inclui um upgrade para o Zookeeper 3.8.0. Como parte do após a atualização, todos os dados do Zookeeper serão migrados para o Zookeeper 3.8.0.

Antes de fazer o upgrade do Zookeeper, leia toda a Zookeeper guia de manutenção do app. A maioria dos sistemas de produção do Edge usa um cluster de nós do Zookeeper espalhados em vários data centers. Alguns desses nós são configurados como eleitores que participam na eleição de líder do Zookeeper, e o restante está configurado como observadores. Consulte Confira mais detalhes sobre líderes, seguidores, eleitores e observadores. Os eleitores elegem um líder, após o qual os próprios nós de eleitor se tornam seguidores.

Durante o processo de atualização, pode haver um atraso momentâneo ou falha de gravação no Zookeeper quando o nó líder é encerrado. Isso pode afetar as operações de gerenciamento que fazem gravações Zookeeper, como 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 no tempo de execução APIs de a Apigee (a menos que essas APIs de ambiente de execução chamem APIs de gerenciamento) durante o upgrade do Zookeeper enquanto seguindo o procedimento abaixo.

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

Fazer um backup

Faça um backup de todos os nós do Zookeeper para uso caso uma reversão seja necessária. Observe que uma reversão vai restaurar o Zookeeper para o estado em que o backup foi feito. Observação: As implantações mudanças na infraestrutura da Apigee desde que o backup foi feito, com informações armazenadas em tratador) serão perdidos durante a restauração.

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

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

Identificar líder, seguidores e observadores

Observação: os exemplos de comandos abaixo usam a utilitário nc para enviar dados ao Zookeeper. Você pode usar utilitários alternativos também para enviar dados ao Zookeeper.

Se 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 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 dos nós, devem aparecer o observador, o 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 independente.
Repita as etapas 1 e 2 em cada nó do ZooKeeper.

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

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

Faça o download e execute o bootstrap do Edge para nuvem privada 4.52, conforme descrito em Atualize para 4.52.00 em um nó com uma conexão externa de Internet. O processo provavelmente vai dependem de um nó ter uma conexão externa com a Internet ou 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), você poderá fazer upgrade (como com o perfil cs,zk) ou fazer upgrade dos outros componentes mais tarde. Apigee recomenda que você só faça o upgrade do Zookeeper primeiro e verifique se o cluster está funcionando corretamente antes de fazer upgrade de outros componentes.
Repita as etapas acima em cada nó observador e seguidor do Zookeeper.

Encerrar o líder

Depois que todos os nós observador e seguidor tiverem sido atualizados, encerre o líder. No nó identificado como líder, execute o comando abaixo:

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

Durante esse evento, antes que um novo líder seja eleito, pode haver atrasos momentâneos ou de gravação no Zookeeper. Isso pode afetar as operações que gravam 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

Seguindo as etapas do exercício Identificar líder, seção "Seguidores e observadores" acima, verifique se um novo líder foi eleito entre os seguidores, quando o líder atual for interrompido. Observe que o líder poderia ter sido eleito em um um data center diferente do atual líder.

Líder de upgrade

Siga as mesmas etapas descritas em Atualização do Zookeeper nos nós de observador e seguidor acima.

Assim que o nó líder antigo também for atualizado, verifique a integridade do cluster e para garantir que haja um nó líder.

Reversão

Se uma reversão for necessária:

Primeiro, execute as etapas de reversão nos observadores e seguidores.
Faça o download e execute o bootstrap da versão para a qual você está revertendo (4.50 ou 4.51). O processo provavelmente vai variar dependendo de o nó ter ou não uma conexão externa de Internet ou 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

Desinstale o zoológicokeeper existente:

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

Instale o Zookeeper como de costume:

  /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 da seguinte forma: as etapas 2 a 5 no nó líder.

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

Restaurar backup

Consulte Restaurar usando um backup. Os backups do Zookeeper feitos em versões anteriores do Edge para nuvem privada, como 4.50 e 4.51, precisam ser compatível com a versão do Zookeeper no Edge para a nuvem privada 4.52.

Upgrade necessário para o Postgres 14

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

A maioria dos sistemas de produção do Edge usa dois nós do Postgres configurados para replicação do 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 Qpid. Depois que os nós do Postgres são atualizados e ficam on-line novamente, os dados de análise é enviada para os nós do Postgres.

A maneira de fazer a atualização do Postgres depende de como você configurou o armazenamento de dados para seu Nós do Postgres:

Se você usa o armazenamento de dados local para seus nós do Postgres, é necessário instalar um novo nó de espera do Postgres durante o upgrade. Após o o upgrade for concluído, desative 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 torna o nó mestre do Postgres após a reversão. Portanto, quando você instala novo nó de espera do Postgres, ele precisa estar em um nó que atenda a todos os requisitos de um servidor Postgres, conforme definido no Requisitos de instalação.

Em uma configuração de um e dois nós do Edge, as topologias usadas para prototipagem e testes, você ter apenas um nó do Postgres. É possível atualizar esses nós do Postgres diretamente sem precisar para criar um novo nó do Postgres.
Se você usa armazenamento de rede para os nós do Postgres, siga as instruções abaixo. recomendado pela Apigee, não será preciso instalar um novo nó do Postgres. Na procedimentos abaixo, ignore as etapas que especificam a instalação e desativação posterior 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 Então, se ocorrer algum erro durante a atualização e você for forçado a executar uma reversão, é possível restaurar o nó do Postgres a partir desse snapshot.

Como instalar um novo Postgres nó de espera

Este procedimento cria um servidor Postgres em espera em um novo nó. Instale um novo Servidor em espera Postgres para a versão atual do Edge (4.50.00 ou 4.51.00), não para a versão 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 Postgres atual, edite o /opt/apigee/customer/application/postgresql.properties para definir o seguinte token. 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 Postgres atual. servidor em espera 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

Verifique se o novo nó de espera foi adicionado visualizando o /opt/apigee/apigee-postgresql/conf/pg_hba.conf no mestre. Aparecerá 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 Postgres em espera:
1. Edite o arquivo de configuração usado para instalar a versão atual do Edge para especificar o seguinte:
```
# 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 Instale o utilitário de configuração da Apigee Apigee.
3. Se você estiver no Edge 4.51.00:
  1. Baixe o arquivo Edge bootstrap_4.51.00.sh para /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 Edge apigee-service e as dependências:
```
sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord
```
  Se você estiver no Edge 4.50.00:
  1. Baixe o arquivo Edge bootstrap_4.50.00.sh para /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 Edge apigee-service e as dependências:
```
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 ele é o modo de espera.

Como fazer um upgrade do Postgres no local

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

Observação:com o Postgres 14, o parâmetro de configuração do Postgres wal_keep_segments não é mais compatível. Se você adicionou ou modificou esse parâmetro do Postgres, ele precisa ser removido. antes de fazer o upgrade do Postgres. Basta seguir estas etapas:

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

Etapa preliminar

Antes de fazer um upgrade no local para o Postgres, siga estas etapas no mestre host e em espera, para atualizar Propriedade max_locks_per_transaction em apigee-postgresql:

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

Altere 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

Configure o apigee-postgresql:

apigee-service apigee-postgresql configure

Reinicie o 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:

Fazer 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 "configure" no host mestre:
```
apigee-service apigee-postgresql configure
```

Reinicie o host mestre:

apigee-service apigee-postgresql restart

Configure-o como mestre:

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

Pare o modo de espera:
```
apigee-service apigee-postgresql stop
```
Faça upgrade do modo de espera.
Observação:ignore a etapa de erros/falhas. update.sh vai tentar para iniciar o servidor em espera com uma configuração incorreta. Fornecido o 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 foi 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 de do arquivo /opt/apigee/customer/application/postgresql.properties em ambos entre o host mestre e o de espera. Essa linha foi adicionados na etapa preliminar.

Depois de 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á 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

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 formato:
```
"type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
```
Interrompa o novo nó de espera executando o seguinte comando nele:
```
/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 /opt/apigee/apigee-postgresql/conf/pg_hba.conf no mestre. Aparecerá somente a seguinte linha nesse arquivo:
```
host replication apigee existing_standby_ip/32 trust
```
Exclua o UUID do nó de espera do ZooKeeper tornando o seguinte gerenciamento do Edge chamada de API no nó do servidor de gerenciamento:
```
curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid
```

Etapas pós-upgrade para o Postgres

Após um grande upgrade do Postgres, as estatísticas internas dele são apagadas. Essas estatísticas ajudam o planejador de consultas do Postgres a utilizar os índices e caminhos ideais para executar consultas.

O Postgres pode recriar gradualmente as estatísticas ao longo do tempo à medida que as consultas são executadas e o daemon de autovacuum é executado. No entanto, até que as estatísticas sejam reconstruídas, as consultas podem ficar lentas.

Para resolver esse problema, execute ANALYZE em todas as tabelas do banco de dados no nó mestre do Postgres. Como alternativa, você pode executar ANALYZE para algumas tabelas por vez.

OBSERVAÇÃO : a execução de ANALYZE pode levar muito tempo, mas é preciso apenas um bloqueio de leitura na tabela, permitindo que outras operações no Postgres continuem sendo executadas enquanto ANALYZE está em execução.

Nova interface do Edge

Esta seção lista as considerações sobre a interface do Edge. Para mais informações, consulte A nova interface do Edge para nuvem privada.

Instalar a interface do Edge

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

Observe que a interface do usuário do Edge exige que você desative a autenticação básica e use uma IDP, como SAML ou LDAP.

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

Atualizar a interface do Edge

Para atualizar o componente da interface do Edge, considere a versão do Edge para a nuvem privada que você estão sendo atualizados de:

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

Atualizar com o mTLS da Apigee

Para atualizar o mTLS da Apigee , faça o seguinte: 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 continuará a atualização de onde parou.

Se a falha exigir que você reverta a atualização para a versão anterior, consulte Reverta a versão 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 executa o utilitário update.sh não tiver acesso a nesse diretório, ele grava 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 derrubando o Edge.

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

O segredo para fazer upgrade com zero inatividade é remover cada roteador do sistema de carga, um de cada vez. de carga. Depois, você atualiza o roteador e outros componentes na mesma máquina que ele. e adicione o roteador de volta ao balanceador de carga.

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

Faça o seguinte antes e depois da atualização:

No nó combinado de roteador e processador de mensagens:
- Antes da atualização, faça o seguinte:
  1. Torne o roteador inacessível.
  2. Tornar o processador de mensagens inacessível.
- Após a atualização, faça o seguinte:
  1. Torne o processador de mensagens acessível.
  2. Torne o roteador acessível.
Em nós de roteador únicos:
- Antes da atualização, torne o roteador inacessível.
- Após a atualização, torne o roteador acessível.
Em nós de processadores de mensagens únicos:
- Antes da atualização, torne 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ê precisa passar um arquivo de configuração silencioso para o comando de atualização. O arquivo de configuração silenciosa deve ser o mesmo usado para instalar o Edge 4.50.00 ou 4.51.00.

Atualizar para 4.52.00 em um nó com uma conexão externa de Internet

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é a conclusão da atualização.
Faça login no seu nó como raiz para instalar os RPMs do Edge.
OBSERVAÇÃO: embora a instalação do RPM exija acesso raiz, você pode realizar a configuração do Edge sem acesso à raiz.
Instale yum-utils e yum-plugin-priorities:
Observação:se o sistema operacional for RHEL 8.0 a 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 o seguinte 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. Baixe o 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. Instale o utilitário apigee-service e as dependências do Edge 4.52.00 execute o seguinte comando:
```
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, você será solicitado a inseri-lo.
  
  Por padrão, o instalador verifica se você tem o Java 1.8 instalado. Caso contrário, o o instalador vai instalá-lo para você.
  
  Use a opção JAVA_FIX para especificar 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 essa opção, você precisa instalar o Java por conta própria.
3. Use apigee-service para atualizar o utilitário apigee-setup, que é o 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 da seguinte forma: exemplo mostra:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
```
5. Atualize o utilitário apigee-provision no servidor de gerenciamento da seguinte forma: exemplo mostra:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
```
6. Execute o utilitário update nos nós executando o seguinte comando:
```
/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
```
  Faça isso na ordem descrita em Ordem do computador atualizar.
  
  Em que:
  - component é o componente Edge a ser atualizado. Os valores possíveis incluem:
    - cs: Cassandra
    - edge: todos os componentes de borda, exceto a interface de usuário de borda: servidor de gerenciamento, mensagem Processador, roteador, servidor QPID, servidor Postgres
    - ldap: OpenLDAP
    - ps: postgresql.
    - qpid: qpidd
    - sso: SSO da Apigee (se você instalou o SSO)
    - ue: nova interface do Edge
    - ui: interface clássica do Edge
    - zk: zelador
  - configFile é o mesmo arquivo de configuração que você usou para defina seu Edge componentes durante a instalação das versões 4.50.00 ou 4.51.00.
  Para executar update.sh em todos os componentes, defina component. como "todos", mas apenas se você tiver um perfil de instalação do Edge all-in-one (AIO). Exemplo:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
```
7. Reinicie o componente de IU 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 console do Cloud Server, conforme descrito em Testar a instalação.
Se mais tarde você decidir reverter a atualização, use o procedimento descrito em Reverter para a versão 4.52.00.

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

Se os nós de borda estiverem protegidos por firewall ou, de alguma outra forma, for proibido acessar repositório da Apigee na Internet, faça 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 pelo repositório local:
- Crie um arquivo .tar do repositório, copie o arquivo .tar em um nó e atualize o Edge pelo 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, ou você pode usar seu próprio servidor da Web.
Para atualizar de um repositório local 4.52.00:
1. Crie um repositório local 4.52.00 conforme descrito em "Criar um repositório da Apigee local" em Instale o utilitário de configuração da Apigee Apigee.
  OBSERVAÇÃO: se você já tem um repositório, pode adicionar o repositório 4.52.00 a ele, conforme descrito em "Atualizar um repositório da Apigee local" em Instale o utilitário de configuração da Apigee Apigee.
2. Para instalar o apigee-service usando um arquivo .tar:
  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 diretório /tmp no novo nó.
  3. No novo nó, descompacte o arquivo no 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 Edge e as dependências da /tmp/repos:
```
sudo bash /tmp/repos/bootstrap_4.52.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
```
    Inclua o caminho para o diretório repos nesse comando.
3. Para instalar o apigee-service usando o servidor da Web Nginx:
  1. Configure o servidor da Web Nginx conforme descrito em "Instalar a partir do repositório usando a linguagem Nginx" webserver" em Instalar o Edge utilitário apigee-setup.
  2. No nó remoto, faça o download do arquivo bootstrap_4.52.00.sh do Edge para /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 são 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 repo.
  3. No nó remoto, instale o utilitário Edge apigee-setup e as dependências:
```
sudo bash /tmp/bootstrap_4.52.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
```
    Em que uName:pWord é o nome de usuário e a senha do repositório.
4. Use apigee-service para atualizar o utilitário apigee-setup, que é o 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 da seguinte forma: exemplo mostra:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
```
6. Atualize o utilitário apigee-provision no servidor de gerenciamento da seguinte forma: exemplo mostra:
```
/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
```
  Onde:
  - component é o componente Edge a ser atualizado. Você normalmente atualiza o componentes:
    - cs: Cassandra
    - edge: todos os componentes de borda, exceto a interface de usuário de borda: servidor de gerenciamento, processador de mensagens, roteador, Servidor QPID, Servidor Postgres
    - ldap: OpenLDAP
    - ps: postgresql.
    - qpid: qpidd
    - sso: SSO da Apigee (se você instalou o SSO)
    - ue Nova interface do Edge
    - ui: interface clássica do Edge
    - zk: zelador
  - configFile é o mesmo arquivo de configuração que você usou para definir os componentes do Edge durante a instalação nas versões 4.50.00 ou 4.51.00.
    OBSERVAÇÃO: o arquivo de configuração precisa ser legível pelo "apigee" usuário. Para alterar o proprietário, use o seguinte comando:
```
chown apigee:apigee configFile
```
  Para executar update.sh em todos os componentes, defina component. como "todos", mas apenas se você tiver um perfil de instalação do Edge all-in-one (AIO). Exemplo:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
```
8. Reinicie os componentes da IU 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 console do Cloud Server, conforme descrito em Testar a instalação.
Se mais tarde você decidir reverter a atualização, use o procedimento descrito em Reverter para a versão 4.52.00.

Ordem de atualização da máquina

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

Upgrade independente de um nó

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

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

Consulte Topologias de instalação para ver a lista de topologias de borda e números de nó.
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 o 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 o 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 ao instalado o SSO.
8. Reinicie o componente Edge UI 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 ver a lista de topologias de borda e números de nó.
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 o Postgres na máquina 4:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
```
3. Atualize o Qpid e o 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 na máquina 4, 5, 1, 2, 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 IU clássica, atualize o ui na máquina 1, como mostra o 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 o 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 ao instalado o SSO.
9. Reinicie o componente de interface:
  - IU clássica:se você estiver usando a IU clássica, reinicie o 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 adequada (pode não ser de máquina) 1):
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```
Upgrade em cluster de nove nós

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

Consulte Topologias de instalação para ver a lista de topologias de borda e números de nó.
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 na máquina 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 IU clássica (ui) na máquina 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
8. Se você instalou o 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 ao instalado o SSO.
10. Reinicie o componente de interface:
  - IU clássica:se você estiver usando a IU clássica, reinicie o 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 adequada (pode não ser de máquina) 1):
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```
Upgrade em cluster de 13 nós

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

Consulte Topologias de instalação para ver a lista de topologias de borda e números de nó.
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 interface (ue) ou a interface 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 ao instalado o SSO.
10. Reinicie o componente de interface:
  - IU clássica:se você estiver usando a IU clássica, reinicie o edge-ui nas máquinas 6 e 7, 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 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 ver a lista de topologias de borda e números de nó.
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. Atualizar 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 IU 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 o 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. Reiniciar a nova interface do Edge (edge-management-ui) ou a 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 que não é padrão, atualize os componentes do Edge da seguinte maneira: ordem:
1. ZooKeeper
2. Cassandra
3. qpidd, ps
4. LDAP
5. Edge, que significa "borda -c" em todos os nós na ordem: nós com o servidor Qpid, Servidor do Edge Postgres, servidor de gerenciamento, processador de mensagens e roteador.
  OBSERVAÇÃO: se um nó tiver o servidor Qpid e o Edge Postgres Servidor instalado, execute "-c Edge" etapa de perfil.
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 em execução reimplantá-lo.