Atualizar o Apigee Edge 4.52.02 para 4.53.00

O Apigee oferece suporte ao upgrade do Edge para nuvem privada diretamente da versão 4.52.02 para a versão 4.53.00. Esta página descreve como realizar esses upgrades.

Para uma visão geral dos caminhos de upgrade compatíveis, consulte a matriz de compatibilidade de upgrade para versões do Edge para nuvem privada.

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

Depois de instalar os RPMs do Edge, qualquer pessoa pode fazer a configuração.

Quais componentes você precisa atualizar

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

Atualizar pré-requisitos

Verifique se você atende aos pré-requisitos a seguir 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
    Confira se o Edge está em execução durante o processo de atualização usando o comando: 
    /opt/apigee/apigee-service/bin/apigee-all status
  • Verificar os pré-requisitos do Cassandra
    Se você fez upgrade de uma versão anterior do Edge para nuvem particular para a versão 4.52.02 e agora planeja fazer upgrade para a versão 4.53.00, verifique se você concluiu as etapas pós-upgrade necessárias para o Cassandra. Essas etapas estão descritas na documentação de upgrade da versão 4.52.02 em Etapas após o upgrade. Se você não tiver certeza se essas etapas foram concluídas durante o upgrade anterior, conclua-as novamente antes de prosseguir com o upgrade para a versão 4.53.00.
  • Requisitos do Python
    Verifique se todos os nós, incluindo os do Cassandra, têm o Python 3 instalado antes de tentar o upgrade.

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 pela atualização.

Upgrade necessário para o Cassandra 4.0.13

O Apigee Edge for Private Cloud 4.53.00 inclui um upgrade do Cassandra para a versão 4.0.13.

Upgrades e reversão

  • O upgrade do Cassandra 3.11.X para o Cassandra 4.0.X é um processo tranquilo. O Cassandra 4.0.X, lançado com o Edge para nuvem privada 4.53.00, é compatível com os componentes de execução e gerenciamento da nuvem privada 4.52.02.
  • Não é possível fazer a reversão direta no local do Cassandra 4.0.X para o 3.11.X. O reversão usando réplicas ou backups é um procedimento complexo e pode envolver inatividade e/ou perda de dados. É preferível resolver problemas e fazer upgrade para o Cassandra 4.0.X do que reverter.
  • É importante conhecer os procedimentos de reversão antes de tentar o upgrade. É fundamental considerar as nuances da reversão durante o upgrade para garantir que os caminhos de reversão adequados estejam disponíveis.

Data center único

O upgrade do Cassandra da versão 3.11.X para a 4.0.X em um único data center é simples, mas o rollback é complexo e pode resultar em inatividade e perda de dados. Para cargas de trabalho de produção, é altamente recomendável adicionar um novo data center com pelo menos nós do Cassandra disponíveis antes de iniciar o upgrade. Isso vai permitir a reversão do Cassandra sem perda de dados ou interrupção do tráfego da API. Esse data center extra pode ser desativado quando o upgrade for concluído ou o segundo ponto de verificação for alcançado.

Se a adição de um novo data center não for viável, mas o recurso de reversão ainda for desejado, os backups serão necessários para restaurar o Cassandra 3.11.X. No entanto, esse método provavelmente envolve inatividade e perda de dados.

Vários data centers

Operar vários data centers com o Edge para nuvem privada 4.52.02 oferece mais flexibilidade para rollbacks durante a atualização para o Edge para nuvem privada 4.53.00.

  • As revisões dependem de pelo menos um data center executando a versão mais antiga do Cassandra (3.11.X).
  • Se todo o cluster do Cassandra for atualizado para a versão 4.0.X, não será possível reverter para o Cassandra 3.11.X. É necessário continuar usando a versão mais recente do Cassandra com os outros componentes da Private Cloud 4.53.00 ou 4.52.02.
  1. Fazer upgrade de um data center do Cassandra por vez:comece fazendo upgrade dos nós do Cassandra individualmente em um único data center. Conclua os upgrades de todos os nós do Cassandra em um data center antes de prosseguir para o próximo.
  2. Pausar e validar:depois de fazer upgrade de um data center, faça uma pausa para garantir que o cluster de nuvem particular, especialmente o data center atualizado, esteja funcionando corretamente.
  3. Lembrete:só é possível reverter para a versão anterior do Cassandra se você tiver pelo menos um data center ainda executando a versão mais antiga.
  4. Sensível ao tempo:embora seja possível pausar por um curto período (algumas horas é recomendado) para validar a funcionalidade, não é possível permanecer em um estado de versão mista por tempo indeterminado. Isso ocorre porque um cluster do Cassandra não uniforme (com nós em versões diferentes) tem limitações operacionais.
  5. Testes completos:a Apigee recomenda fortemente testes abrangentes de desempenho e funcionalidade antes de fazer upgrade do próximo data center. Depois que todos os data centers forem atualizados, não será possível reverter para a versão anterior.
Reversão como um processo de dois pontos de verificação
  1. Ponto de verificação 1:o estado inicial, com todos os componentes na versão 4.52.02. A reversão completa é possível, desde que pelo menos um data center do Cassandra permaneça na versão mais antiga.
  2. Ponto de verificação 2:depois que todos os nós do Cassandra em todos os data centers forem atualizados. É possível reverter para esse estado, mas não para o Ponto de controle 1.
Exemplo

Considere um cluster de dois data centers (DCs):

  1. Estado inicial:os nós do Cassandra nos dois DCs estão na versão 3.11.X. Todos os outros nós estão na versão 4.52.02 do Edge para nuvem privada. Considere três nós do Cassandra por DC.
  2. Upgrade do DC-1:faça upgrade dos três nós do Cassandra no DC-1 um por um.
  3. Pausar e validar:pausar para garantir que o cluster, principalmente o DC-1, esteja funcionando corretamente (verifique o desempenho e a funcionalidade). É possível reverter para o estado inicial usando os nós do Cassandra no DC-2. Essa pausa precisa ser temporária devido às limitações de um cluster do Cassandra com versões misturadas.
  4. Fazer upgrade do DC-2:faça upgrade dos três nós restantes do Cassandra no DC-2. Esse será seu novo ponto de reversão.
  5. Fazer upgrade de outros componentes:faça upgrade dos nós de gerenciamento, execução e análise como de costume em todos os data centers, um nó e um data center por vez. Se surgirem problemas, você pode reverter para o estado da etapa 4.

Pré-requisitos para upgrade do Cassandra

Você precisa executar o Cassandra 3.11.16 com o Edge para nuvem privada 4.52.02 e garantir o seguinte:
  • O cluster inteiro está operacional e totalmente funcional com o Cassandra 3.11.16.
  • A estratégia de compactação está definida como LeveledCompactionStrategy, um pré-requisito para o upgrade para a versão 4.52.02.
  • Todas as etapas pós-upgrade do upgrade inicial para o Cassandra 3.11.16 como parte do upgrade 4.52.02 foram concluídas. Caso contrário, repita estas etapas. Isso se aplica apenas se você fez upgrade para a versão 4.52.02 da Nuvem particular a partir de uma versão mais antiga.

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. Faça backup do Cassandra usando o Apigee.
  2. Faça snapshots de VM dos nós do Cassandra (se possível).
  3. Verifique se a porta 9042 é acessível de todos os componentes do Edge para nuvem privada, incluindo o servidor de gerenciamento, o processador de mensagens, o roteador, o Qpid e o Postgres, para os nós do Cassandra, se ainda não estiver configurado. Consulte os requisitos de porta para mais informações.

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

Todos os nós do Cassandra precisam ser atualizados um por um em cada data center. Entre os upgrades de nós em um data center, aguarde alguns minutos para garantir que um nó atualizado tenha sido totalmente iniciado e tenha ingressado no cluster antes de prosseguir com o upgrade de outro nó no mesmo data center.

Após atualizar todos os nós do Cassandra em um data center, aguarde um tempo (30 minutos a algumas horas) antes de prosseguir com os nós no próximo data center. Durante esse período, revise cuidadosamente o data center atualizado e verifique se as métricas de funcionalidade e desempenho do cluster da Apigee estão intactas. Essa etapa é crucial para garantir a estabilidade do data center em que o Cassandra foi atualizado para a versão 4.0.X, enquanto o restante dos componentes da Apigee permanece na versão 4.52.02.

  1. Para fazer upgrade de um nó do Cassandra, execute o seguinte comando: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. Depois que um nó for atualizado, execute o comando abaixo nele para realizar algumas validações antes de prosseguir: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile
  3. O código acima vai gerar algo como: 
    Cassandra version is verified - [cqlsh 6.0.0 | Cassandra 4.0.13 | CQL spec 3.4.5 | Native protocol v5] 
Metadata is verified

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

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

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

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

Etapa 5: faça upgrade de todos os componentes restantes do Edge para nuvem privada 4.53.00

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

Etapa 6: etapas após o upgrade

Execute o comando a seguir 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

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

Após a conclusão da instalação inicial, a Apigee recomenda instalar a interface do Edge, que é uma interface do usuário aprimorada para desenvolvedores e administradores do Apigee Edge para nuvem privada.

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 com o mTLS da Apigee

Para atualizar o Apigee mTLS , siga estas etapas:

Como reverter uma atualização

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

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

Informações de atualização de registro

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 a pessoa 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 inatividade só é possível com uma configuração de cinco nós ou mais.

A chave para upgrade sem tempo de inatividade é remover cada roteador, um por vez, do balanceador de carga. Em seguida, atualize o roteador e todos os outros componentes na mesma máquina que o roteador 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 chegar a hora de atualizar os roteadores, selecione um e torne-o inacessível, conforme descrito em Ativar/desativar a acessibilidade do servidor (roteador/processador de mensagens).
  3. Atualiza o roteador selecionado e todos os outros componentes do Edge na mesma máquina que o roteador. Todas as configurações de borda mostram um roteador e um processador de mensagens no mesmo nó.
  4. Torne o roteador acessível novamente.
  5. Repita as etapas 2 a 4 para os roteadores restantes.
  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 para nuvem privada 4.52.02.

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

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

  1. Se houver, desative todos os jobs cron configurados para executar 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. Desative o SELinux conforme descrito em Instalar o utilitário apigee-setup do Edge.
  4. 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ê decidir reverter a atualização, use o procedimento descrito em Reverter a versão 4.53.00.

Atualizar para 4.53.00 usando um repositório local

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

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 arquivo .tar para um nó e atualize o Edge usando o arquivo .tar.
  • Instale um servidor da Web no nó com o repositório local para que outros nós possam acessá-lo. A Apigee fornece o servidor da Web Nginx para você usar ou você pode usar seu próprio servidor da Web.

Para atualizar de um repositório local 4.53.00:

  1. Crie um repositório local 4.53.00 conforme descrito em "Criar um repositório local do Apigee" em Instalar o utilitário apigee-setup do Edge.
  2. Para instalar o apigee-service em um arquivo .tar:
    1. No nó com o repositório local, use o comando abaixo para empacotar o repositório local em um único arquivo .tar chamado /opt/apigee/data/apigee-mirror/apigee-4.53.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 para o diretório /tmp no novo nó.
    3. No novo nó, descompacte o arquivo para o diretório /tmp: 
      tar -xzf apigee-4.53.00.tar.gz

      Esse comando cria um novo diretório, chamado repos, no diretório que contém o arquivo .tar. Por exemplo, /tmp/repos.

    4. Instale o utilitário apigee-service do Edge e as dependências do /tmp/repos: 
      sudo bash /tmp/repos/bootstrap_4.53.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      Observe que você inclui o caminho para o diretório de repositórios neste 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.53.00.sh do Edge para /tmp/bootstrap_4.53.00.sh: 
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.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 o nome DNS do nó do repositório.

    3. No nó remoto, instale o utilitário apigee-setup e as dependências do Edge: 
      sudo bash /tmp/bootstrap_4.53.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      Onde 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 abaixo: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  5. Atualize o utilitário apigee-validate no servidor de gerenciamento, conforme o exemplo abaixo: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  6. Atualize o utilitário apigee-provision no servidor de gerenciamento, conforme o exemplo abaixo: 
    /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: SSO da Apigee (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 4.50.00 ou 4.51.00.

    É possível executar update.sh em todos os componentes definindo component como "all", mas somente se você tiver um perfil de instalação tudo-em-um (AIO) do Edge. Exemplo:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
  8. Reinicie os componentes da interface em todos os nós que os executam, se ainda não tiver feito isso: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
  9. Para testar a atualização, execute o utilitário apigee-validate no servidor de gerenciamento, conforme descrito em Testar a instalação.

Se você decidir reverter a atualização, use o procedimento descrito em Reverter a versão 4.53.00.

Ordem de atualização da máquina

A ordem em que você atualiza as máquinas em uma instalação de borda é 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 do Edge (servidor de gerenciamento, processador de mensagens, roteador, 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 precisa ser realizada em várias máquinas, realize-a na ordem especificada.
  • Não há uma etapa separada para atualizar a monetização. Ele é atualizado quando você especifica a opção -c edge.

Upgrade independente de 1 nó

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

  1. Atualize todos os componentes: 
    /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
  2. (Se você instalou o apigee-adminapi) Atualize o utilitário apigee-adminapi: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

Upgrade independente de dois nós

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

Consulte Topologias de instalação para ver a lista de topologias do Edge 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 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 os componentes do Edge nas máquinas 2 e 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. Atualize o Qpid na Máquina 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. Atualize a interface na máquina 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. (Se você instalou o apigee-adminapi) Atualizou o utilitário apigee-adminapi na máquina 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (Se você instalou o SSO do Apigee) Atualize o SSO do 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 instalar o SSO.

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

Upgrade de 5 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 do Edge 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 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 os componentes do Edge nas máquinas 4, 5, 1, 2 e 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Atualize o Qpid na máquina 4: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Atualize o Qpid na máquina 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Atualize a interface do Edge:
    • Interface clássica:se você estiver usando a interface clássica, atualize o componente ui na máquina 1, conforme mostrado no exemplo a seguir: 
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    • Nova interface do Edge:se você instalou a nova interface do Edge, atualize o componente ue na máquina apropriada (pode não ser a máquina 1): 
      /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
  9. (Se você instalou o apigee-adminapi) Atualizou o utilitário apigee-adminapi na máquina 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  10. (Se você instalou o SSO do Apigee) Atualize o SSO do 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 instalar o SSO.

  11. Reinicie o componente da interface:
    • 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 9 nós

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

Consulte Topologias de instalação para ver a lista de topologias do Edge 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 Postgres na máquina 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Atualizar 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 os componentes de borda nas máquinas 6, 7, 8, 9, 1, 4 e 5 nesta ordem: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Atualização do Qpid nas máquinas 6 e 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Atualize a nova interface (ue) ou a clássica (ui) na máquina 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  8. (Se você instalou 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 do Apigee) Atualize o SSO do 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 instalar o SSO.

  10. Reinicie o componente da interface:
    • 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 do Edge 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 Postgres na máquina 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Atualizar 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 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
  6. Atualização do Qpid nas máquinas 12 e 13: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Atualize a nova interface (ue) ou a clássica (ui) nas máquinas 6 e 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  8. (Se você instalou o apigee-adminapi) Atualizamos o utilitário apigee-adminapi nas máquinas 6 e 7: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (Se você instalou o SSO do Apigee) Atualize o SSO do 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 instalar o SSO.

  10. Reinicie o componente da interface:
    • 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 do Edge e números de nó.

  1. Atualize o Cassandra e o ZooKeeper:
    1. Nas máquinas 1, 2 e 3 no 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. Atualizar 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
  3. Atualizar o LDAP:
    1. Máquina 1 no data center 1 
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. Máquina 7 no data center 2 
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. Atualize os componentes do Edge:
    1. Máquinas 4, 5, 6, 1, 2 e 3 no data center 1 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. Máquinas 10, 11, 12, 7, 8 e 9 no data center 2 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. Atualização do qpidd:
    1. Máquinas 4 e 5 no data center 1
      1. Atualizar 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 e 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
  6. Atualize a nova interface (ue) ou a clássica (ui):
    1. Máquina 1 no data center 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
    2. Máquina 7 no data center 2: 
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  7. (Se você instalou o apigee-adminapi) Atualizou o utilitário apigee-adminapi:
    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 Apigee SSO) Atualize o Apigee SSO:
    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

      3. em que sso_config_file é o arquivo de configuração que você criou ao instalar o SSO.

  9. Reinicie o componente da nova 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 nesta ordem:

  1. ZooKeeper
  2. Cassandra
  3. ps
  4. LDAP
  5. "Edge", ou seja, o perfil "-c edge" em todos os nós na ordem: nós com servidor Qpid, servidor Edge Postgres, servidor de gerenciamento, processador de mensagens e roteador.
  6. qpidd
  7. Interface do Edge (clássica ou nova)
  8. apigee-adminapi
  9. SSO da Apigee

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