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 fazer a atualização

A pessoa que executa a atualização precisa ser a mesma que instalou o Edge originalmente ou uma pessoa que executa como root.

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

Quais componentes você precisa atualizar

É necessário atualizar todos os componentes do Edge. O Edge não é compatível com uma configuração que contenha componentes de várias versões.

Atualizar pré-requisitos

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

  • Faça 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á em execução 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 é LeveledCompactionStrategy
    Dependendo da sua versão atual, faça as mudanças necessárias na estratégia de compactação do Cassandra. Siga as etapas abaixo e retorne ao procedimento principal de upgrade:

Quais etapas especiais considerar para o upgrade

Para fazer upgrade para o Edge para nuvem privada 4.52.02, siga etapas específicas para atualizar determinados softwares. As etapas necessárias dependem da sua versão atual. Consulte a tabela abaixo para ver os vários softwares que exigem etapas complementares e siga as instruções detalhadas para cada um deles. Depois de concluir as tarefas necessárias, retorne ao procedimento principal de upgrade para continuar o processo.

Versão atual Software que exige etapas especiais para upgrade para a versão 4.52.02
4.52.01 Cassandra
4.52.00 Zookeeper, Cassandra, Qpid
4.51.00 Zookeeper, Postgres, Cassandra, Qpid

Depois de realizar as etapas necessárias com base na sua versão, volte ao procedimento principal de upgrade para continuar.

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

Se você tiver definido propriedades editando arquivos .properties em /opt/apigee/customer/application, esses valores serão mantidos após a atualização.

Fazer upgrade para o Zookeeper 3.8.3

O Edge para nuvem privada 4.52.02 não inclui uma atualização do Zookeeper. No entanto, se você estiver fazendo upgrade de uma versão anterior à 4.52.01, siga as etapas de upgrade do Zookeeper descritas abaixo.

  • Se você estiver fazendo upgrade das versões 4.51.00 ou 4.52.00 do Edge para nuvem privada, consulte as etapas em Upgrade obrigatório para o Zookeeper 3.8.3.
  • Se você estiver fazendo upgrade da versão 4.52.01 do Edge para nuvem privada, já estará usando a versão 3.8.3 do Zookeeper e não precisará seguir nenhuma etapa especial para fazer upgrade do Zookeeper.

Fazer upgrade para o Postgres 14

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

Fazer upgrade 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, e esse upgrade também inclui atualizações do software de driver em vários componentes de ambiente de execução e gerenciamento usados para consultar e gravar no Cassandra.

Como esse é um upgrade importante, foram necessárias algumas mudanças no modelo de dados da Apigee no Cassandra para garantir o desempenho ideal em versões mais recentes. Embora essas mudanças sejam mínimas, o processo de upgrade interrompe algumas APIs de gerenciamento quando é iniciado. As APIs de gerenciamento específicas que geralmente são interrompidas estão listadas nas seções relevantes abaixo.

Além disso, o processo de upgrade causa interrupção em um conjunto maior de fluxos de proxy de ambiente de execução e APIs de gerenciamento no data center que está sendo atualizado. É fundamental isolar o tráfego de gerenciamento e de tempo de execução do data center que está sendo atualizado para minimizar essa interrupção. Leia as seções sobre data center único e vários data centers abaixo para mais informações.

Portal do desenvolvedor: documentação de APIs

O portal de desenvolvedor do Drupal da Apigee oferece vários recursos para documentar suas APIs. Embora seja recomendável migrar do portal de desenvolvedores baseado no Drupal 7, se você ainda estiver usando esse portal e o recurso SmartDocs, o documento Como usar as APIs SmartDocs se aplica a você. Se você estiver usando versões mais recentes do portal de desenvolvedores, não haverá impacto na documentação da API durante esse upgrade.

Ao fazer upgrade da Apigee para a versão 4.52.02, os modelos de API criados com o recurso SmartDocs do portal de desenvolvedores do Drupal 7 não serão migrados automaticamente para a versão mais recente. É necessário exportar manualmente cada modelo usando o portal para desenvolvedores e importá-lo novamente após concluir o upgrade.

Terminologia usada abaixo

Tempo de execução:abrange o processamento do tráfego do proxy de tempo de execução. Ele inclui todas as operações realizadas pelos seus roteadores e processadores de mensagens para processar com eficiência uma solicitação de API de ambiente de execução para proxies atuais. No entanto, não inclui a implantação de novos proxies ou novas revisões de proxies.

Gerenciamento:inclui a administração do seu 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 os clientes delas, como a interface da Apigee e o portal do desenvolvedor) estão incluídas nesse escopo.

Durante esse upgrade, o tráfego de tempo de execução e gerenciamento é afetado na região ou no data center (DC) em que a atualização está sendo executada. Independente do data center que está sendo atualizado, há um impacto em algumas APIs de gerenciamento em todos os data centers. Esse impacto é observado após cada etapa.

Em cada etapa abaixo, o estado do tempo de execução e do gerenciamento é descrito à medida que você avança nas várias fases do procedimento de upgrade.

Estratégias de upgrade

Vários data centers

O upgrade precisa ser feito um data center por vez para garantir a continuidade do tráfego e evitar inatividade. Antes de fazer upgrade de um DC, o tráfego precisa ser redirecionado para outros DCs funcionais.

Data center único

Em uma configuração de data center único, o procedimento de upgrade terá um impacto significativo no tráfego do ambiente de execução e em algumas APIs de gerenciamento. As seguintes opções estão disponíveis para uma configuração de data center único.

  • Expanda seu cluster do Edge para nuvem privada para um data center temporário adicionando um data center ao lado do existente para processar o tráfego durante o upgrade e desative um dos data centers após a conclusão do processo de upgrade.
  • Se não for possível expandir para outro data center, prepare-se para a inatividade e programe o upgrade durante períodos de baixo tráfego para minimizar o impacto nas APIs de gerenciamento e no tráfego de ambiente de execução.

Recomendamos expandir para um data center adicional para evitar o impacto no tráfego de tempo de execução e nas APIs de gerenciamento. Durante o upgrade, os impactos no data center incluem, mas não se limitam às seguintes áreas:

  • APIs Runtime atualizando tokens OAuth
  • APIs Runtime usando a política de acesso de entidade
  • APIs de gerenciamento que listam apps de desenvolvedores
  • APIs de gerenciamento que listam produtos

O impacto descrito acima é adicional às APIs de gerenciamento específicas que vão permanecer não funcionais em todos os data centers até que eles sejam atualizados. Essas APIs de gerenciamento estão listadas nas etapas das seções a seguir.

Reversão: visão geral

  • Impacto durante a reversão

    A reversão do Cassandra 3.11.x para 2.1.x afeta o tráfego de ambiente de execução e de gerenciamento no data center (DC) em que a reversão está sendo realizada. Além disso, algumas APIs de gerenciamento podem sofrer interrupções em todos os data centers, independentemente de qual DC está sendo revertido.

  • Seguir a abordagem de reversão de DC por DC

    O rollback precisa ser executado em um data center por vez para manter a continuidade do serviço e evitar o tempo de inatividade. Antes de iniciar a reversão em um data center específico, verifique se o tráfego de aplicativos foi redirecionado para outro data center totalmente operacional.

  • Reverter um cluster parcialmente atualizado

    Se pelo menos um data center permanecer totalmente operacional na versão mais antiga do Cassandra (2.1.22), outros DCs atualizados poderão ser revertidos executando uma recriação do DC do Cassandra 2.1.X totalmente funcional.

  • Reversão em todo o cluster

    Se todo o cluster do Cassandra tiver sido atualizado e for necessário fazer um rollback, ele precisará ser realizado usando backups ou snapshots de VM. Essa abordagem é complexa e provavelmente vai causar inatividade temporária ou perda de dados.

  • Considerações antes do upgrade

    É importante conhecer os procedimentos de reversão antes de tentar fazer o upgrade. É fundamental considerar as nuances do rollback ao fazer upgrade para garantir que os caminhos de rollback adequados estejam disponíveis.

Reverter clusters com um único data center

O upgrade do Cassandra da versão 2.1.x para a 3.11.x pode afetar significativamente o tráfego de tempo de execução e determinadas APIs de gerenciamento. Esses impactos também se aplicam durante o rollback e podem resultar em inatividade ou perda de dados.

Para cargas de trabalho de produção, é altamente recomendável provisionar um novo data center antes do upgrade. Isso permite um caminho de rollback mais seguro, sem perda de dados ou interrupção do tráfego da API. O data center adicional pode ser desativado após a conclusão do upgrade.

Se não for possível adicionar um novo data center, mas ainda for necessário ter a capacidade de rollback, faça backups confiáveis antes do upgrade. É possível restaurar o Cassandra 2.1.x de backups, mas essa abordagem pode envolver tempo de inatividade do serviço e possível perda de dados.

Reverter clusters com vários data centers

A reversão de vários data centers segue uma abordagem de data center por data center (DC por DC). Nessa abordagem, o tráfego do data center sendo revertido é redirecionado para outros data centers funcionais, garantindo um processo de rollback controlado e isolado para Cassandra, servidor de gerenciamento e nós de ambiente de execução para evitar interrupções no tráfego.

Consulte a seção Reverter a atualização do Cassandra 3.11.16 para mais detalhes.

Etapa 0: estado inicial

  • Os componentes Zookeeper, Postgres e LDAP já foram atualizados para as versões 4.52.02. O cluster do Edge para uma nuvem privada está estável e funcionando. Se for necessário, o cluster será revertido para esse estado.
  • O Cassandra na Apigee está sendo executado com a versão 2.1.22.
  • Componentes de borda:
    • Servidor de gerenciamento se comunicando com o Cassandra usando um protocolo thrift mais antigo.
    • Servidores de ambiente de execução (processadores de mensagens e roteadores) se comunicando com o Cassandra pelo 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ê normalmente cria, como o arquivo de configuração padrão da Apigee para ativar upgrades de componentes.

  1. Mude o Cassandra para usar LeveledCompactionStrategy.
  2. Fazer backup do Cassandra usando o Apigee.
  3. Faça snapshots de VM dos nós do Cassandra (se possível).
  4. 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.
  5. Se você usa o recurso SmartDocs do portal de desenvolvedores do Drupal 7 da Apigee, faça uma exportação de cada um dos seus modelos baixando-os no formato JSON da interface do portal de desenvolvedores. Esses modelos precisam ser importados de volta para a Apigee depois que os servidores de gerenciamento forem atualizados.
  6. Verifique se as portas 9160 e 9042 estão acessíveis de todos os componentes do Edge para os nós do Cassandra, caso ainda não estejam. Consulte Requisitos de porta para mais informações.

Etapa 2: redirecionar o tráfego para fora do primeiro data center

  1. Bloqueie o tráfego de gerenciamento e de tempo de execução do primeiro data center.
  2. Redirecione todo o tráfego de tempo de execução e as APIs de gerenciamento para os outros data centers funcionais.
  3. Valide se o tráfego de gerenciamento e de tempo de execução está sendo processado corretamente pelos outros DCs.

Etapa 3: fazer upgrade de todos os nós do Cassandra no primeiro data center

  1. Faça upgrade de todos os nós do Cassandra no data center 1 um por um. Execute os comandos a seguir em cada nó, um por vez: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. Depois que um nó for atualizado, execute o comando a seguir nele para fazer algumas validações antes de continuar: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile
     O comando acima vai gerar algo como: 
    Cassandra version is verified - [cqlsh 5.0.1 | Cassandra 3.11.16 | CQL spec 3.4.4 | Native protocol v3] Metadata is verified
  3. Execute o seguinte comando post_upgrade em cada nó do Cassandra, um por um, depois que o upgrade for concluído: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade
Estado do ambiente de execução nesta etapa Estado de gerenciamento nesta etapa
  • Tráfego de tempo de execução bloqueado em data centers que estão sendo atualizados
  • O ambiente de execução está totalmente funcional em outros data centers

Etapa 4: fazer upgrade de todos os nós de gerenciamento no primeiro data center

Faça upgrade de todos os nós de gerenciamento no data center:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Estado do ambiente de execução nesta etapa Estado de gerenciamento nesta etapa
  • Tráfego de tempo de execução bloqueado em data centers que estão sendo atualizados
  • Ambiente de execução totalmente funcional

Etapa 5: fazer upgrade de todos os nós de execução no primeiro data center

Faça upgrade de todos os nós de roteadores e processadores de mensagens no data center um por um:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Estado do ambiente de execução nesta etapa Estado de gerenciamento nesta etapa
  • Tráfego de tempo de execução bloqueado em data centers que estão sendo atualizados
  • O ambiente de execução está totalmente funcional em outros data centers

Etapa 6: redirecionar o tráfego de volta para o primeiro data center

  • Depois que o primeiro data center for atualizado com o Cassandra, os componentes de ambiente de execução e o servidor de gerenciamento, reative o tráfego de ambiente de execução e gerenciamento para o primeiro data center.
  • Verifique se o tráfego de gerenciamento e de tempo de execução está funcionando bem em todos os data centers.

Etapa 7: fazer upgrade de outros data centers

Repita as etapas de 1 a 6 nos data centers restantes, um de cada vez, redirecionando o tráfego para fora deles, atualizando o software do Apigee e reativando o tráfego nesses data centers.

Etapa 8: execute novamente a etapa de upgrade em todos os nós de gerenciamento

Execute novamente o seguinte comando de upgrade em todos os nós de gerenciamento nos data centers:

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

Etapa 9: [opcional] importar smartdocs exportados anteriormente

Depois que todos os servidores de gerenciamento forem atualizados, importe os modelos de documentos inteligentes que você exportou na etapa 1. Você pode fazer isso depois.

Só é necessário fazer isso se você usa o portal do desenvolvedor baseado no Drupal 7 e o recurso SmartDocs.

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

Etapa 10: descartar tabelas não usadas

Execute o comando a seguir para descartar tabelas antigas não utilizadas do cluster do Cassandra. Até que isso seja executado, não será possível usar determinados recursos do Cassandra, como configurar uma nova autenticação. Os mecanismos de autenticação antigos vão continuar funcionando. Esse comando só pode ser executado em um nó do cluster.

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

Etapa 11: fazer upgrade de todos os componentes restantes do Edge e de outros componentes 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 nuvem privada 4.52.01, siga as etapas abaixo para fazer upgrade do Qpid e do Postgres, respectivamente, e faça upgrade dos componentes restantes de acordo com estas etapas.

Fazer upgrade para o Qpid J-Broker

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

  • Se você estiver fazendo upgrade do Edge para 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 nuvem privada 4.52.01 para 4.52.02, já estará usando a versão mais recente do Qpid Broker, e nenhuma etapa adicional de upgrade do Qpid será necessária.

Nova interface do Edge

Esta seção lista 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.

A interface 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 da interface do Edge, considere a versão do Edge para nuvem privada de que você está fazendo upgrade:

Atualização com mTLS da Apigee

Para atualizar o mTLS do Apigee , siga estas etapas:

Como reverter uma atualização

Em caso de falha na atualização, tente corrigir o problema e execute update.sh novamente. É possível 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 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 esse diretório, o registro será gravado no diretório /tmp como um arquivo chamado update_username.log.

Se você não tiver acesso a /tmp, o utilitário update.sh vai falhar.

Atualização sem inatividade

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

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

A chave para o upgrade sem tempo de inatividade é remover cada roteador, um de cada vez, do balanceador de carga. Em seguida, atualize o roteador e todos os outros componentes na mesma máquina que ele e adicione o roteador de volta ao balanceador de carga.

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

Antes e depois da atualização, faça o seguinte:

Usar um arquivo de configuração silenciosa

É necessário transmitir um arquivo de configuração silenciosa para o comando de atualização. O arquivo de configuração silencioso precisa ser o mesmo usado para instalar o Edge 4.50.00 ou 4.51.00.

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

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

  1. Se houver, desative todos os jobs cron configurados para realizar uma operação de reparo no Cassandra até que a atualização seja concluída.
  2. Faça login no nó como raiz para instalar os RPMs do Edge.
  3. Instale yum-utils e yum-plugin-priorities: 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  4. Desative o SELinux conforme descrito em Instalar o utilitário apigee-setup do Edge.
  5. Se você estiver instalando no Oracle 7.x, execute o seguinte comando: 
    sudo yum-config-manager --enable ol7_optional_latest
  6. 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

  7. Se você estiver usando o Edge 4.51.00:

    1. Faça o download do arquivo bootstrap_4.52.02.sh do Edge em /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 a inserir esse valor.

      Por padrão, o instalador verifica se você tem o Java 1.8 instalado. Caso contrário, o instalador fará isso para você.

      Use a opção JAVA_FIX para especificar como lidar com a instalação do Java. JAVA_FIX usa os seguintes valores:

      • I: instale o OpenJDK 1.8 (padrão).
      • C: continue sem instalar o Java.
      • Q: sair. Para essa opção, você precisa instalar o Java.
    3. Use apigee-service para atualizar o utilitário apigee-setup, como mostra o 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 com 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 do Edge a ser atualizado. Os valores possíveis são:
        • 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: Apigee SSO (se você instalou o SSO)
        • ue: nova interface do Edge
        • ui: interface clássica do Edge
        • zk: Zookeeper
      • 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.

      Você pode executar update.sh em todos os componentes definindo component como "all", mas apenas se tiver um perfil de instalação do Edge tudo em um (AIO). Exemplo:

      /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
    7. Reinicie os componentes da interface do Edge 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
    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 mais tarde, use o procedimento descrito em Reverter para a versão 4.52.02.

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

Se os nós de borda estiverem protegidos por um firewall ou não puderem acessar o repositório do Apigee pela Internet, faça a atualização de um repositório local ou de um espelho do repositório do Apigee.#heading

Depois de criar um repositório local do Edge, você tem duas opções para atualizar o Edge no repositório local:

  • Crie um arquivo .tar do repositório, copie-o para 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 para você usar, ou você pode usar seu próprio servidor da Web.

Para atualizar de um repositório local 4.52.02:

  1. Crie um repositório local 4.52.02 conforme descrito em "Criar um repositório local da Apigee" em Instalar o utilitário apigee-setup do Edge.
  2. Para instalar o apigee-service de um arquivo .tar:
    1. No nó com o repositório local, use o comando a seguir 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 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 apigee-service do Edge e as dependências de /tmp/repos: 
      sudo bash /tmp/repos/bootstrap_4.52.02.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      Observe que você inclui 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 do repositório usando o servidor da Web Nginx" em Instalar o utilitário apigee-setup do 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 são o nome de usuário e a senha definidos anteriormente para o repositório, e remoteRepo é o endereço IP ou o nome DNS do nó do repositório.

    3. No nó remoto, instale o utilitário e as dependências do Edge apigee-setup: 
      sudo bash /tmp/bootstrap_4.52.02.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 mostra o exemplo a seguir: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  5. 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
  6. 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
  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 do Edge a ser atualizado. Normalmente, você atualiza os seguintes componentes:
      • 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: Apigee SSO (se você instalou o SSO)
      • ue Nova interface do Edge
      • ui: interface clássica do Edge
      • zk: Zookeeper
    • configFile é o mesmo arquivo de configuração usado para definir os componentes do Edge durante a instalação das versões 4.50.00 ou 4.51.00.

    Você pode executar update.sh em todos os componentes definindo component como "all", mas apenas se tiver um perfil de instalação do Edge tudo em um (AIO). 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 a 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 mais tarde, use o procedimento descrito em Reverter para a versão 4.52.02.

Ordem de atualização da máquina: upgrade da versão 4.51.00 ou 4.52.00 ou 4.52.01

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

  • É necessário atualizar todos os nós do ZooKeeper nos data centers antes de fazer upgrade de todos os outros componentes. Se você estiver fazendo upgrade da nuvem privada do Edge 4.51.00 ou 4.52.00, também será necessário seguir outras etapas para fazer upgrade do Zookeeper.
  • É necessário atualizar o PostgreSQL em todos os data centers. Se você estiver fazendo upgrade da nuvem privada do Edge 4.51.00, também será necessário seguir outras etapas para fazer upgrade do postgres.
  • É necessário atualizar os nós do LDAP em todos os data centers.
  • Atualize todos os nós do Cassandra, do servidor de gerenciamento, do processador de mensagens e do roteador, um data center por vez, até que todos sejam atualizados.
  • É necessário atualizar os componentes edge-qpid-server e edge-postgres-server em todos os data centers.
  • É necessário fazer upgrade dos nós do Qpid em todos os data centers. Se você estiver fazendo upgrade do Edge Private Cloud 4.51.00 ou 4.52.00, também precisará seguir outras etapas para fazer upgrade do Qpid.
  • Atualize a interface do usuário do Edge e a nova interface do usuário do Edge, nós de SSO em todos os data centers.
  • Não há uma etapa separada para atualizar a monetização. Ele é atualizado quando você especifica a opção de borda -c.

Upgrade separado de um nó

Para fazer upgrade de uma configuração independente de um nó para a versão 4.52.02:
  1. Atualize todos os componentes: 
    /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
  2. (Se você instalou a apigee-adminapi) Atualize o utilitário apigee-adminapi: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

Upgrade separado de 2 nós

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

Consulte Topologias de instalação para ver a lista de topologias de Edge e números de nós.

  1. Atualize o Zookeeper na máquina 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. Atualize o Postgres na máquina 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Atualize o LDAP na máquina 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. Atualize o Cassandra na máquina 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  5. Atualize os componentes do Edge nas máquinas 1 e 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Atualize o Qpid na máquina 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Atualize a interface na máquina 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -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 Apigee SSO) Atualize o Apigee SSO 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 instalar o SSO.

  10. Reinicie o componente da interface do Edge na máquina 1: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Upgrade de cinco nós

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

Consulte Topologias de instalação para ver a lista de topologias de Edge e números de nós.

  1. Atualize o ZooKeeper nas máquinas 1, 2 e 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. Atualize o Postgres na máquina 4: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Atualize o Postgres na máquina 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Atualize o LDAP na máquina 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Atualize o Cassandra nas máquinas 1, 2 e 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  6. Atualize os componentes do Edge nas máquinas 1, 2, 3, 4 e 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Atualize o Qpid na máquina 4: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Atualizar o Qpid na máquina 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  9. Atualize a interface do Edge:
    • Interface clássica:se você estiver usando a interface 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
  10. (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
  11. (Se você instalou o Apigee SSO) Atualize o Apigee SSO 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 instalar o SSO.

  12. Reinicie o componente de UI:
    • Interface clássica:se você estiver usando a interface clássica, reinicie o componente edge-ui na máquina 1, 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 na máquina apropriada (pode não ser a máquina 1): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Upgrade de cluster de nove nós

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

Consulte Topologias de instalação para ver a lista de topologias de Edge e números de nós.

  1. Atualize o ZooKeeper nas máquinas 1, 2 e 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. Atualize o Postgres na máquina 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Atualize o Postgres na máquina 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Atualize o LDAP na máquina 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Atualize o Cassandra nas máquinas 1, 2 e 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  6. Atualize os componentes do Edge nas máquinas 1, 4, 5, 6, 7, 8 e 9 nessa ordem: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Atualize o Qpid nas máquinas 6 e 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Atualize a nova interface (ue) ou a interface clássica (ui) na máquina 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  9. (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
  10. (Se você instalou o Apigee SSO) Atualize o Apigee SSO 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 instalar o SSO.

  11. Reinicie o componente de UI:
    • Interface clássica:se você estiver usando a interface clássica, reinicie o componente edge-ui na máquina 1, 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 na máquina apropriada (pode não ser a máquina 1): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Upgrade de cluster de 13 nós

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

Consulte Topologias de instalação para ver a lista de topologias de Edge e números de nós.

  1. Atualize o ZooKeeper nas máquinas 1, 2 e 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. Atualize o Postgres na máquina 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Atualize o Postgres na máquina 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Atualize o LDAP nas máquinas 4 e 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Atualize o Cassandra nas máquinas 1, 2 e 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  6. Atualize os componentes do Edge nas máquinas 6, 7, 10, 11, 12, 13, 8 e 9 nessa ordem: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Atualize o Qpid nas máquinas 12 e 13: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. 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
  9. (Se você instalou o apigee-adminapi) Atualize o utilitário apigee-adminapi nas máquinas 6 e 7: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  10. (Se você instalou o Apigee SSO) Atualize o Apigee SSO 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 instalar o SSO.

  11. Reinicie o componente de UI:
    • Interface clássica:se você estiver usando a interface 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 de cluster de 12 nós

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

Consulte Topologias de instalação para ver a lista de topologias de Edge e números de nós.

  1. Atualize o ZooKeeper nas máquinas 1, 2, 3, 7, 8 e 9 nos dois DCs:

    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. Atualize o Postgres nas máquinas 6 e 12 nos dois DCs: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Atualize o LDAP nas máquinas 1 e 7 nos dois DCs: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

  4. Bloqueie o tráfego em DC-1 e verifique se todo o tráfego foi redirecionado para outro DC-2.

  5. Atualize o Cassandra nas máquinas 1, 2 e 3 em DC-1: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  6. Atualize o servidor de gerenciamento na máquina 1 em DC-1: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Atualize o roteador e o processador de mensagens nas máquinas 2 e 3 no DC-1: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. Desbloqueie o tráfego em DC-1 e valide o DC-1. Em seguida, bloqueie o tráfego em DC-2 e redirecione-o para DC-1.
  9. Atualize o Cassandra nas máquinas 7, 8 e 9 no DC-2: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  10. Atualize o servidor de gerenciamento na máquina 7 em DC-2: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. Atualize o roteador e o processador de mensagens nas máquinas 8 e 9 em DC-2: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. Desbloqueie o tráfego no DC-2. Agora, os dois DCs vão processar o tráfego.
  13. Execute o comando de atualização novamente em todos os servidores de gerenciamento nos DCs nas máquinas 1 e 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  14. Atualize edge-qpid-server e edge-postgres-server nas máquinas 4, 5, 6, 10, 11 e 12 nos dois DCs: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  15. Atualize o Qpid nas máquinas 4, 5, 10 e 11 nos dois DCs: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  16. Atualize a nova UI (ue) ou a UI clássica (ui) nos dois DCs: 
    /opt/apigee/apigee-setup/bin/update.sh -c  [ui|ue] -f configFile
  17. Se você instalou o apigee-adminapi, atualize-o nos dois DCs: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  18. (Se você instalou o SSO da Apigee) Atualize os nós do SSO da Apigee nos dois DCs: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile
  19. Reinicie o novo componente da interface do Edge (edge-management-ui) ou da interface clássica do Edge (edge-ui) nos dois DCs: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart