Esta página foi traduzida pela API Cloud Translation.

Atualizar o Apigee Edge 4.51.00, 4.52.00 ou 4.52.01 para 4.52.02

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

Quem pode realizar a atualização

A pessoa que executa a atualização precisa ser a mesma que instalou o Edge originalmente ou uma pessoa que está executando 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 configurações 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 fazer 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.
Verificar 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 compactação do Cassandra está LeveledCompactionStrategy
Confira se a estratégia de compactação do Cassandra está definida como LeveledCompactionStrategy, conforme descrito em Alterar a estratégia de compactação do Cassandra.

Quais etapas especiais considerar para o upgrade

Para fazer o upgrade para o Edge para a nuvem privada 4.52.02, considere executar etapas específicas para fazer upgrade de determinado software. As etapas necessárias dependem da versão atual. Consulte a tabela abaixo para ver os diversos softwares que exigem etapas complementares. As próximas seções nesta página fornecem discussões detalhadas e etapas exatas para cada software.

Versão atual	Software que requer etapas especiais de upgrade para 4.52.02
4.52.01	Cassandra
4.52.00	Cassandra, zoológico, Qpid
4.51.00	Cassandra, Zookeeper, Qpid e Postgres

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

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

Upgrade necessário para o Cassandra 3.11.16

O Apigee Edge para nuvem privada 4.52.02 inclui um upgrade do Cassandra para a versão 3.11.16. O Cassandra é um componente essencial da Apigee. O upgrade também inclui atualizações do software do driver em vários componentes de ambiente de execução e gerenciamento usados para consultar e gravar no Cassandra.

Como este é um upgrade importante, foram necessárias algumas alterações no modelo de dados da Apigee no Cassandra para garantir o desempenho ideal nas versões mais recentes. Embora essas mudanças sejam mínimas, o processo de upgrade interrompe determinadas APIs de gerenciamento, afetando tanto a interface da Apigee quanto o portal do desenvolvedor. O documento abaixo especifica as APIs exatas que não vão funcionar e descreve as etapas durante o upgrade, quando a interrupção começa e termina. É importante ressaltar que não haverá interrupções no tráfego do ambiente de execução durante o upgrade.

Reversão de alto nível

Aplicar o upgrade do Cassandra em um nó por vez. Assim que um nó é atualizado, certas alterações de esquema entram em vigor que não podem ser revertidas diretamente. Leia toda a seção sobre reversão, porque diferentes técnicas podem ser usadas dependendo de quanto do cluster foi atualizado.

Se você precisar reverter o upgrade após o upgrade de todo o cluster do Cassandra, a única opção será restaurar os backups. Prepare-se para isso e familiarize-se com a restauração de backup do Cassandra. Se for possível restaurar snapshots no nível da VM mais rapidamente do que os backups da Apigee, use snapshots de VM para restaurar as VMs do Cassandra para um estado anterior.

Para mais detalhes, consulte a seção Reverter a atualização do Cassandra 3.11.16.

Como documentar APIs no portal do desenvolvedor

O portal de desenvolvedores da Apigee Drupal oferece vários recursos para documentar suas APIs. Embora seja recomendado fazer a transição do uso do portal do desenvolvedor baseado no Drupal 7, se você ainda o estiver usando e utilizando o recurso SmartDocs, o documento Como usar as APIs SmartDocs se aplica a você. Se você estiver usando versões mais recentes do portal do desenvolvedor, a documentação da API não será afetada durante o upgrade.

Quando você faz o upgrade da Apigee para a versão 4.52.02, todos os modelos de API criados usando o recurso SmartDocs do portal do desenvolvedor Drupal 7 não serão migrados automaticamente para a versão mais recente. É necessário exportar manualmente cada modelo usando o portal do desenvolvedor e importá-lo novamente após a conclusão do upgrade.

Terminologia usada nas seções a seguir

Ambiente de execução:inclui o processamento do tráfego do proxy do ambiente de execução. Ela inclui todas as operações realizadas pelos seus roteadores e processadores de mensagens para processar de forma eficaz uma solicitação de API em tempo de execução para proxies existentes. No entanto, isso não inclui a implantação de novos proxies ou novas revisões de proxies.

Gerenciamento: o gerenciamento inclui a administração do sistema Apigee Edge. Isso inclui, entre outros, implantações, modificações de apps, produtos, servidores de destino, keystores etc. Todas as APIs de gerenciamento (e seus clientes, como a interface da Apigee e o portal do desenvolvedor) estão incluídas neste escopo.

Em cada etapa abaixo, o estado do ambiente de execução e do gerenciamento é descrito conforme você avança pelos vários estágios do procedimento de upgrade. Não há impacto no tráfego do ambiente de execução durante o upgrade. No entanto, um pequeno subconjunto de APIs de gerenciamento e a funcionalidade do portal do desenvolvedor estão sendo interrompidos.

Etapa 0: estado inicial

Cassandra na Apigee em execução com a versão 2.1.22.
Edge para componentes da nuvem privada 4.52.02:

Comunicação do servidor de gerenciamento com o Cassandra por meio do protocolo thrift mais antigo.
Servidores de ambiente de execução (processadores de mensagem e roteadores) que se comunicam com o Cassandra por meio do protocolo thrift mais antigo.

Estado do ambiente de execução nesta etapa	Estado de gerenciamento nesta etapa
Ambiente de execução totalmente funcional	Gerenciamento totalmente funcional

Etapa 1: preparar para o upgrade

As etapas abaixo são adicionais aos arquivos padrão que você costuma criar, como o arquivo de configuração padrão da Apigee para ativar upgrades de componentes.

Mudar o Cassandra para usar a LeveledCompactionStrategy.
Fazer backup do Cassandra usando a Apigee.
Crie snapshots de VM dos nós do Cassandra (se possível).
Crie um arquivo de configuração de upgrade do Cassandra em cada nó do Cassandra em /opt/apigee/apigee-cassandra/cass_upgrade.conf com o seguinte conteúdo:
```
# IP Address of node
HOSTIP=10.0.0.1

# Username for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
CASS_USERNAME=<cassuser>

# Password for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
CASS_PASSWORD=<casspass>

# Port for connecting to Cassandra via thrift. Optional. Defaults to 9160 if skipped.
CASS_PORT=9160

# Port for connecting to Cassandra via CQL. Optional. Defaults to 9042 if skipped.
CASS_CQL_PORT=9042

# Directory to be used by Cassandra upgrade scripts. Optional. Defaults to /tmp/cass_upgrade_scripts if skipped.
# Note that if upgrade is successful, this directory is deleted via root user - so provide a directory accordingly.
CASS_TMP_DIR=/tmp/cass_upgrade_scripts
    
```
Se o arquivo não puder ser criado em /opt/apigee/apigee-cassandra/cass_upgrade.conf, crie o arquivo /opt/silent.conf com o mesmo conteúdo em cada nó do Cassandra.
Cuidado: o instalador de upgrade da Apigee vai procurar o arquivo nos locais listados acima. Se o arquivo não estiver presente em nenhum dos locais listados acima, o upgrade falhará com uma mensagem como esta:
```
could not read env location: '/opt/apigee/apigee-cassandra/cass_upgrade.conf'
file does not exist or cannot be sourced
could not read env location: '/opt/silent.conf'
file does not exist or cannot be sourced
```
Se isso acontecer, o upgrade falhará, mas o serviço do Cassandra no nó provavelmente estará em estado interrompido. Inicie o serviço Cassandra como de costume e tente fazer upgrade novamente colocando o arquivo de configuração em qualquer um dos locais esperados. Além disso, se o arquivo for encontrado, mas as configurações fornecidas estiverem incorretas (por exemplo, credenciais do Cassandra estão incorretas), o upgrade falhará com um erro como este:
```
Error in PREIN scriptlet in rpm package apigee-cassandra-X.XX.XX-X.X.XXXX.noarch
```
Nesse caso, da mesma forma, inicie o serviço do Cassandra se ele for interrompido quando o upgrade falhar e tente fazer o upgrade novamente após corrigir as configurações no arquivo.

Se você usa o recurso SmartDocs do portal do desenvolvedor da Apigee Drupal 7, faça uma exportação de cada um dos modelos fazendo o download deles no formato JSON na interface do portal do desenvolvedor. Esses modelos precisarão ser importados de volta para a Apigee depois da atualização dos servidores de gerenciamento.
Verifique se as portas 9160 e 9042 podem ser acessadas de todos os componentes do Edge para a nuvem privada 4.52.02 e os nós do Cassandra, se ainda não estiverem presentes. Consulte Requisitos de porta para mais informações.

Etapa 2: fazer upgrade de todos os nós do Cassandra

Fazer upgrade de todos os nós do Cassandra em todas as regiões, um por um. Execute os seguintes comandos em cada nó:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
```
Depois que um nó for atualizado, execute o seguinte comando nele para executar algumas validações antes de prosseguir:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile
```

A saída acima será algo ao longo das linhas de:

Cassandra version is verified - [cqlsh 5.0.1 | Cassandra 3.11.16 | CQL spec 3.4.4 | Native protocol v3] Metadata is verified

Estado do ambiente de execução nesta etapa	Estado de gerenciamento nesta etapa
Ambiente de execução totalmente funcional	A seguinte função de gerenciamento é degradada após o upgrade do Cassandra: API Management para criar um produto de API com ambiente API Management para atualizar um produto de API com ambiente API Management para excluir uma organização

Observação:se você estiver fazendo upgrade do Edge Private Cloud 4.51.00 ou 4.52.00, também será necessário seguir outras etapas para fazer upgrade do Zookeeper. Embora o Zookeeper e o Cassandra possam estar localizados nos mesmos nós, é recomendável atualizar o Zookeeper e o Cassandra separadamente.

Use o seguinte comando em um nó para fazer upgrade do Zookeeper:

/opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile

O comando a seguir pode ser usado em um nó para fazer upgrade do Cassandra:

/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile

Se você estiver fazendo upgrade da versão 4.52.01 da Edge Private Cloud para a versão 4.52.02, a atualização do Zookeeper é pequena e pode ser feita junto com o Cassandra. Para fazer upgrade do Cassandra e do Zookeeper com um único comando nos nós em que estão colocalizados, use o comando abaixo. Recomenda-se fazer isso apenas se você já estiver executando o Zookeeper versão 3.8.3 na nuvem privada versão 4.52.01:

/opt/apigee/apigee-setup/bin/update.sh -c zk,cs -f configFile

Etapa 3: fazer upgrade de todos os nós de gerenciamento

Faça upgrade de todos os nós de gerenciamento em todas as regiões, um por um:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Estado do ambiente de execução	Estado de gerenciamento
Ambiente de execução totalmente funcional	API de gerenciamento degradada: O recurso SmartDocs do portal do desenvolvedor Drupal 7 não mostra dados

Etapa 3a: [opcional] importar SmartDocs que foram exportados anteriormente

Depois que todos os servidores de gerenciamento forem atualizados, será possível importar os modelos do SmartDocs que você exportou na Etapa 1. Você também pode fazer isso mais tarde.

Estado do ambiente de execução	Estado de gerenciamento
Ambiente de execução totalmente funcional	Gerenciamento totalmente funcional

Etapa 4: fazer upgrade de todos os nós do ambiente de execução

Faça upgrade de todos os roteadores e nós do processador de mensagens em todas as regiões, um por um:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Estado do ambiente de execução	Estado de gerenciamento
Ambiente de execução totalmente funcional	Gerenciamento totalmente funcional

Etapa 5: fazer upgrade de todos os componentes restantes do Edge para a nuvem privada 4.52.02

Faça upgrade de todos os nós edge-qpid-server e edge-postgres-server restantes em todas as regiões, um por um.

Nesta etapa, se você estiver fazendo upgrade de versões anteriores ao Edge para a nuvem privada 4.52.01 e estiver seguindo outras etapas para fazer upgrade do Qpid ou do Postgres, siga as respectivas etapas para fazer o upgrade.

Estado do ambiente de execução	Estado de gerenciamento
Ambiente de execução totalmente funcional	Gerenciamento totalmente funcional

Etapa 6: após o upgrade

Execute o seguinte comando em cada nó do Cassandra, um por um, após a conclusão do upgrade:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade

Execute o comando a seguir para descartar tabelas antigas não usadas do cluster do Cassandra. Até que ele seja executado, não será possível usar determinados recursos do Cassandra (como a configuração de novas autenticações; os mecanismos de autenticação antigos continuarão funcionando). Este comando só pode ser executado em um nó no cluster:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra drop_old_tables -f configFile

Conclua a etapa 3a, se ainda não tiver feito isso.

Estado do ambiente de execução	Estado de gerenciamento
Ambiente de execução totalmente funcional	Gerenciamento totalmente funcional

Atualização necessária para o Zookeeper 3.8.3

Embora o Edge para a nuvem privada 4.52.02 não inclua um upgrade para o Zookeeper, se você estiver fazendo upgrade das versões anteriores à 4.52.01, siga as etapas para fazer o upgrade do Zookeeper.

Se você estiver fazendo upgrade do Edge para as versões 4.51.00 ou 4.52.00 da nuvem privada, consulte as etapas em Upgrade obrigatório para o Zookeeper 3.8.3 para fazer upgrade do Zookeeper.
Se você estiver fazendo upgrade do Edge para a versão 4.52.01 da nuvem privada, já deve estar usando o Zookeeper na versão 3.8.3 e não é necessário seguir etapas especiais para fazer o upgrade do Zookeeper.

Upgrade necessário para o Postgres 14

Se você estiver fazendo upgrade do Edge para a nuvem privada 4.51.00 para o 4.52.02, siga as etapas para fazer o upgrade do Postgres, mesmo que o Edge para a nuvem privada 4.52.02 não inclua um upgrade do Postgres. O upgrade do Edge para a nuvem privada 4.51.00 para a 4.52.02 requer etapas adicionais de upgrade do Postgres. Consulte a seção Upgrade obrigatório para o Postgres 14.
Se você estiver fazendo upgrade do Edge para a nuvem privada 4.52.00 ou 4.52.01 para 4.52.02, não é necessário realizar outras etapas de upgrade do Postgres.

Upgrade necessário para o Qpid J-Broker

Embora o Edge for Private Cloud 4.52.02 não inclua um upgrade para o QPID, se você estiver fazendo upgrade das versões anteriores à 4.52.01, vai precisar seguir as etapas para fazer upgrade do QPID.

Se você estiver fazendo upgrade do Edge para a nuvem privada 4.51.00 ou 4.52.00 para 4.52.02, será necessário seguir outras etapas de upgrade do QPID. Consulte a seção Fazer upgrade do Qpid se você estiver fazendo upgrade da versão 4.51.00 ou 4.52.00 para a 4.52.02.
Se você estiver fazendo upgrade do Edge para a nuvem privada versão 4.52.01 para 4.52.02, já deve estar usando a versão mais recente do Qpid Broker, e nenhuma outra etapa de upgrade do QPID é necessária.

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 IU 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 um 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 IU do Edge, considere a versão do Edge para a nuvem privada de onde 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 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 executar update.sh novamente. É possível executar a atualização várias vezes e ela continuará de onde parou.

Se a falha exigir que você reverta a atualização para a versão anterior, consulte Reverter 4.52.00 para 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 estiver executando o utilitário update.sh não tiver acesso a esse diretório, ela 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 desativar o Edge.

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

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

Atualize as máquinas na ordem correta para sua instalação, conforme descrito em 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 descrito em Como ativar/desativar a acessibilidade do 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 únicos do processador de mensagens:
- 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 precisa ser o mesmo usado para instalar o Edge 4.50.00 ou 4.51.00.

Atualize para a versão 4.52.02 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 estiver 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 seu nó como raiz para instalar os RPMs do Edge.
OBSERVAÇÃO: embora a instalação do RPM exija acesso raiz, é possível executar a configuração do Edge sem esse tipo de acesso.
Instale yum-utils e yum-plugin-priorities:
Observação:se o 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 do Edge apigee.
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.02.sh do Edge para /tmp/bootstrap_4.52.02.sh:
```
curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
```
2. Instale o utilitário apigee-service e as dependências do Edge 4.52.02 executando o seguinte comando:
```
sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord
```
  Em que uName:pWord são 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 o instalará para você.
  
  Use a opção JAVA_FIX para especificar como processar 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 essa opção, você precisa instalar o Java por conta própria.
3. Use apigee-service para atualizar o utilitário apigee-setup, como no exemplo a seguir:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
```
4. Atualize o utilitário apigee-validate no servidor de gerenciamento, como mostra 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, como mostra o exemplo a seguir:
```
/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 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 de borda, exceto a interface de borda: servidor de gerenciamento, processador de mensagens, roteador, servidor QPID, servidor do 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 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 definindo component como "todos", mas somente 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 Edge UI 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 mais tarde você decidir reverter a atualização, use o procedimento descrito em Reverter 4.52.02.

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

Se os nós do Edge estiverem protegidos por firewall ou, de alguma outra forma, forem proibidos de acessar o repositório da Apigee pela Internet, será possível executar a atualização de 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 em um nó e atualize o Edge com ele.
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, mas também é possível usar seu próprio servidor da Web.

Para atualizar de um repositório 4.52.02 local:

Crie um repositório 4.52.02 local conforme descrito em "Criar um repositório da Apigee local" em Instalar o utilitário de configuração do Edge apigee-setup.
OBSERVAÇÃO: se você já tiver um repositório, adicione o repositório 4.52.02 a ele, conforme descrito em "Atualizar um repositório da Apigee local" em Instalar o utilitário de configuração da Apigee do Edge.
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.02.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 no diretório /tmp:
```
tar -xzf apigee-4.52.02.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 Edge apigee-service e as dependências de /tmp/repos:
```
sudo bash /tmp/repos/bootstrap_4.52.02.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
```
  Inclua o caminho para o diretório repos nesse comando.
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 o servidor da Web Nginx" em Instalar o utilitário de configuração da Apigee no Edge.
2. No nó remoto, faça o download do arquivo bootstrap_4.52.02.sh do Edge para /tmp/bootstrap_4.52.02.sh:
```
/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.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 repo.
3. No nó remoto, instale o utilitário Edge apigee-setup e as dependências:
```
sudo bash /tmp/bootstrap_4.52.02.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.
Use apigee-service para atualizar o utilitário apigee-setup, como no exemplo a seguir:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update 
```
Atualize o utilitário apigee-validate no servidor de gerenciamento, como mostra o exemplo a seguir:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
```
Atualize o utilitário apigee-provision no servidor de gerenciamento, como mostra o exemplo a seguir:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
```
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. Normalmente, os seguintes componentes são atualizados:
  - cs: Cassandra
  - edge: todos os componentes de borda, exceto a interface de borda: servidor de gerenciamento, processador de mensagens, roteador, servidor QPID, servidor do 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 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 para o usuário da "apigee". Para alterar o proprietário, use o seguinte comando:
```
chown apigee:apigee configFile
```
É possível executar update.sh em todos os componentes definindo component como "todos", mas somente 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
```
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
```
Teste a atualização executando o utilitário apigee-validate no servidor de gerenciamento, conforme descrito em Testar a instalação.

Se mais tarde você decidir reverter a atualização, use o procedimento descrito em Reverter 4.52.02.

Ordem de atualização da máquina

A ordem em que você atualiza as máquinas em uma instalação do Edge é importante:

Você precisa atualizar todos os nós do Cassandra e do ZooKeeper antes de atualizar qualquer outro.
Para qualquer máquina com vários componentes de borda (servidor de gerenciamento, processador de mensagens, roteador, servidor QPID, mas não o servidor Postgres), use a opção -c edge para atualizá-los ao mesmo tempo.
Se uma etapa especificar que ela precisa ser realizada em várias máquinas, faça isso na ordem especificada da máquina.
Não há uma etapa separada para atualizar a monetização. Ele é atualizado quando você especifica a opção -c edge.

Upgrade independente de um nó

Para fazer upgrade de uma configuração autônoma de um nó para a versão 4.52.02:

Atualize todos os componentes:

/opt/apigee/apigee-setup/bin/update.sh -c all -f configFile

(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ó.

Atualize o Cassandra e o ZooKeeper na máquina 1:

/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

Atualize o Postgres na máquina 2:

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

Atualizar LDAP na máquina 1:

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

Atualize os componentes do Edge nas máquinas 2 e 1:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Atualizar Qpid na máquina 2:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Atualize a interface na máquina 1:

/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

(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
```
(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 criado quando você instalou o SSO.

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ó.

Atualize o Cassandra e o ZooKeeper na máquina 1, 2 e 3:

/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

Atualize o Postgres na máquina 4:

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

Atualize o Postgres na máquina 5:

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

Atualizar LDAP na máquina 1:

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

Atualize os componentes do Edge na máquina 4, 5, 1, 2, 3:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Atualizar o Qpid na máquina 4:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Atualize o Qpid na máquina 5:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Atualize a interface do Edge:
- IU clássica:se você estiver usando a IU clássica, atualize o componente 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
```
(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
```
(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 criado quando você instalou o SSO.
Reinicie o componente da interface:
- IU clássica:se você estiver usando a IU 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 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ó.

Atualize o Cassandra e o ZooKeeper na máquina 1, 2 e 3:

/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

Atualize o Postgres na máquina 8:

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

Atualize o Postgres na máquina 9:

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

Atualizar LDAP na máquina 1:

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

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
```

Atualize o Qpid nas máquinas 6 e 7:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

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
```
(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
```
(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 criado quando você instalou o SSO.
Reinicie o componente da interface:
- IU clássica:se você estiver usando a IU 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 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ó.

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

Atualize o Postgres na máquina 8:

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

Atualize o Postgres na máquina 9:

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

Atualize o LDAP nas máquinas 4 e 5:

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

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
```

Atualize o Qpid nas máquinas 12 e 13:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Atualize a nova interface (ue) ou a IU clássica (ui) nas máquinas 6 e 7:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
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
```
(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 criado quando você instalou o SSO.
Reinicie o componente da interface:
- IU clássica:se você estiver usando a IU clássica, reinicie o componente 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ó.

Atualize o Cassandra e o ZooKeeper:

Nas máquinas 1, 2 e 3 no data center 1:

/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

Nas máquinas 7, 8 e 9 no data center 2

/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

Atualize o Postgres:

Máquina 6 no data center 1

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

Máquina 12 no data center 2

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

Atualize o LDAP:

Máquina 1 no data center 1

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

Máquina 7 no data center 2

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

Atualize os componentes do Edge:

Máquinas 4, 5, 6, 1, 2, 3 no data center 1

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Máquinas 10, 11, 12, 7, 8, 9 no data center 2

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Atualize o qpidd:

Máquinas 4 e 5 no data center 1

Atualize qpidd na máquina 4:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Atualize qpidd na máquina 5:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Máquinas 10 e 11 no data center 2

Atualize qpidd na máquina 10:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Atualize qpidd na máquina 11:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Atualize a nova interface (ue) ou a IU clássica (ui):

Máquina 1 no data center 1:

/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

Máquina 7 no data center 2:

/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

(Se você instalou o apigee-adminapi) O utilitário apigee-adminapi foi atualizado:

Máquina 1 no data center 1:

/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

Máquina 7 no data center 2:

/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

(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
```
Reinicie o novo componente da interface do Edge (edge-management-ui) ou 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:

ZooKeeper
Cassandra
ps
LDAP
Borda, que significa o perfil "-c borda" em todos os nós na ordem: nós com o servidor Qpid, o servidor do Edge Postgres, o servidor de gerenciamento, o processador de mensagens e o roteador.
OBSERVAÇÃO: se um nó tiver o servidor Qpid e o servidor Edge Postgres instalados, execute a etapa do perfil "-c Edge".
Qpidd
Interface do Edge (clássica ou nova)
apigee-adminapi
SSO da Apigee

Depois de concluir a atualização, reinicie o componente de IU do Edge em todas as máquinas que o executam.