Atualização da Apigee Edge 4.51.00 ou 4.52.00 para 4.52.01

A Apigee é compatível com o upgrade do Edge para nuvem privada da versão 4.51.00 ou 4.52.00 diretamente para a 4.52.01. Nesta página, descrevemos como fazer os dois 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 raiz.

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

Quais componentes você precisa atualizar

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

Pré-requisitos de atualização

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

  • Fazer backup de todos os nós
    Antes de atualizar, recomendamos que você faça um backup completo de todos os nós por motivos de segurança. Use o procedimento da sua versão atual do Edge para realizar 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
    Verifique 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.

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

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

Upgrade obrigatório para o Zookeeper 3.8.3

Esta versão do Edge para nuvem privada inclui um upgrade para o Zookeeper 3.8.3. Como parte desse upgrade, todos os dados do Zookeeper serão migrados para o Zookeeper 3.8.3.

Antes de fazer upgrade do Zookeeper, leia o guia de manutenção do Zookeeper. A maioria dos sistemas de produção do Edge usa um cluster de nós do ZooKeeper espalhados por vários data centers. Alguns desses nós são configurados como eleitores que participam da eleição de líder do Zookeeper, e os demais são configurados como observadores. Consulte Sobre líderes, seguidores, eleitores e observadores para mais detalhes. Os nós de votação elegem um líder e, em seguida, se tornam seguidores.

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

Em um nível alto, o processo de upgrade envolve fazer um backup de cada nó. Em seguida, todos os observadores e seguidores são atualizados e, por fim, o nó líder é atualizado.

Fazer um backup

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

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

Se você estiver usando máquinas virtuais e tiver a capacidade, também poderá fazer snapshots ou backups de VM para restauração ou reversão (se necessário).

Identificar líder, seguidores e observadores

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

  1. Se ele não estiver instalado no nó do ZooKeeper, instale o nc:
      sudo yum install nc
  2. Execute o seguinte comando nc no nó, em que 2181 é a porta do ZooKeeper:
      echo stat | nc localhost 2181

    O resultado será assim:

      Zookeeper version: 3.8.3-5a02a05eddb59aee6ac762f7ea82e92a68eb9c0f, built on 2022-02-25 08:49 UTC
      Clients:
       /0:0:0:0:0:0:0:1:41246[0](queued=0,recved=1,sent=0)
      
      Latency min/avg/max: 0/0.2518/41
      Received: 647228
      Sent: 647339
      Connections: 4
      Outstanding: 0
      Zxid: 0x400018b15
      Mode: follower
      Node count: 100597

    Na linha Mode da saída dos nós, você verá observador, líder ou seguidor (ou seja, um eleitor que não é o líder), dependendo da configuração do nó. Observação: em uma instalação independente do Edge com um único nó do ZooKeeper, o Mode é definido como independente.

  3. Repita as etapas 1 e 2 em cada nó do ZooKeeper.

Fazer upgrade do Zookeeper nos nós observador e seguidor

Faça upgrade do ZooKeeper em cada um dos nós observadores e seguidores da seguinte maneira:

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

Desativar o líder

Depois que todos os nós observadores e seguidores forem atualizados, encerre o líder. No nó identificado como líder, execute o comando abaixo:

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

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

Verificar se o novo líder foi eleito

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

Líder de upgrade

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

Depois que o nó líder antigo também for atualizado, verifique a integridade do cluster e confirme se há um nó líder.

Reverter

Caso seja necessário fazer uma reversão:

  1. Primeiro, execute as etapas de reversão em observadores e seguidores.
  2. Faça o download e execute a inicialização da versão para a qual você está revertendo: 4.50 ou 4.51. O processo provavelmente vai variar dependendo se o nó tem uma conexão de Internet externa ou se você está seguindo a instalação off-line.
  3. Interrompa o Zookeeper se ele estiver em execução no nó:
      /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop
  4. Desinstale o ZooKeeper atual:
      /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper uninstall
  5. Instale o Zookeeper normalmente:
      /opt/apigee/apigee-setup/bin/setup.sh -p zk -f <silent-config-file>
  6. Depois que todos os seguidores e observadores forem revertidos, reverta o nó líder seguindo as etapas de 2 a 5 no nó líder.
  7. Depois que todos os nós forem revertidos, verifique a integridade do cluster e se há um nó líder no cluster.

Restaurar backup

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

Upgrade obrigatório para o Postgres 14

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

  • Se você estiver fazendo upgrade do Edge para nuvem privada 4.51.00 para 4.52.01, será necessário seguir outras etapas de upgrade do Postgres. Consulte a seção Upgrade obrigatório para o Postgres 14 se você estiver fazendo upgrade da versão 4.51.00 para a 4.52.01.
  • Se você estiver fazendo upgrade do Edge para nuvem privada 4.52.00 para 4.52.01, não será necessário seguir outras etapas de upgrade do Postgres.

Fazer upgrade do Qpid

Esta versão do Edge para nuvem privada inclui um upgrade para o Qpid J-Broker.

Recomendamos que você selecione um dos seguintes métodos para realizar o upgrade do Qpid:

Upgrade no local sem inatividade

Esse método garante que não haja inatividade no ambiente de execução do Edge e minimiza a perda de dados de ambiente de execução, se houver, adquiridos para análise.

Para realizar um upgrade no local sem inatividade para o Qpid:

  1. Escolha um nó do Qpid para começar.
  2. Interrompa o agente Qpid no nó:
    apigee-service apigee-qpidd stop
  3. Bloqueie o tráfego de entrada na porta 5672 do agente de todos os processadores de mensagens aplicando um firewall. É possível aplicar esse firewall no nível da instância do nó do Qpid ou em algum outro componente de firewall/rede externo.

    Recomendamos que você faça o mesmo para todos os endereços IP do processador de mensagens. Por exemplo, para descartar solicitações provenientes de endereços IP do processador de mensagens para o nó do Qpid na porta 5672 usando IPTables, use um comando como este:

    iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
  4. Inicie o agente do Qpid novamente para drenar as mensagens atuais, se houver:
    apigee-service apigee-qpidd start
  5. Verifique se as filas atuais estão vazias:
    qpid-stat -q

    Se as mensagens estiverem presas na fila de mensagens mortas (DLQ, na sigla em inglês) (ax-q-axgroup-001-consumer-group-001-dl), drene a fila usando as etapas para resolver os dados de análise presos na fila de mensagens mortas.

  6. Depois de verificar se as filas foram drenadas no nó antigo, interrompa o apigee-qpidd:
    apigee-service apigee-qpidd stop
  7. Faça upgrade do Qpid no nó:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Restart edge-qpid-server:
    apigee-service edge-qpid-server restart
  9. Remova a regra de firewall aplicada na Etapa 3.

    Execute a mesma etapa de remoção para todos os endereços IP do processador de mensagens em que o firewall foi aplicado. Depois que os firewalls forem removidos, as solicitações provenientes de endereços IP do processador de mensagens para o nó do Qpid na porta 5672 serão aceitas. Se você usou iptables para adicionar o firewall, para removê-lo e listar as configurações atuais, use comandos como os seguintes:

    iptables -F
      iptables -L
  10. Use o monitoramento da Web para verificar se as filas do Qpid estão recebendo mensagens:
    http://QPID_NODE_IP:8090
  11. Repita as etapas de 1 a 9 para cada nó do Qpid.

Como comissionar um novo nó do Qpid

Esse método configura e instala apigee-qpidd e edge-qpid-server em um novo nó.

  1. Adicione um novo nó do Qpid. Esta etapa configura um nó Qpid com o J-broker. Para ver as etapas detalhadas, consulte Adicionar um servidor Qpid.
  2. Escolha um nó do Qpid (um nó da versão que você está atualizando).
  3. Interrompa o agente Qpid no nó:
    apigee-service apigee-qpidd stop
  4. Bloqueie o tráfego de entrada na porta 5672 do agente de todos os processadores de mensagens aplicando um firewall. É possível aplicar esse firewall no nível da instância do nó do Qpid ou em algum outro componente de firewall/rede externo.

    Recomendamos que você faça o mesmo para todos os endereços IP do processador de mensagens. Por exemplo, para descartar solicitações provenientes de endereços IP do processador de mensagens para o nó do Qpid na porta 5672 usando IPTables, use um comando como este:

    iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
  5. Inicie o agente Qpid novamente para drenar as mensagens atuais, se houver:
    apigee-service apigee-qpidd start
  6. Verifique se as filas atuais estão vazias:
    qpid-stat -q

    Se as mensagens estiverem travadas na fila de mensagens inativas (DLQ) (ax-q-axgroup-001-consumer-group-001-dl), drene a fila seguindo as etapas no tópico de solução de problemas Dados do Analytics travados na fila de mensagens inativas do Qpidd.

  7. Depois de verificar se as filas foram drenadas no nó antigo, interrompa o apigee-qpidd.
    apigee-service apigee-qpidd stop
  8. Cancele o registro do nó antigo do Qpid seguindo as etapas em Remover um servidor Qpid.
  9. Continue adicionando um novo nó e removendo um antigo, um de cada vez, até que todos os nós do Qpid tenham sido atualizados.

Reverter

Para reverter para uma versão de recurso anterior, faça o download do arquivo bootstrap.sh da versão para a qual você quer reverter. Para voltar para a v 4.52.00, faça o download de bootstrap_4.52.00.sh.

Para reverter o Qpid, siga estas etapas em todos os hosts do Qpid:

  1. Interromper o agente Qpid atual
    apigee-service apigee-qpidd stop
  2. Bloqueie o tráfego de entrada na porta 5672 do agente de todos os processadores de mensagens aplicando um firewall. É possível aplicar esse firewall no nível da instância do nó do Qpid ou em algum outro componente de firewall/rede externo.

    Recomendamos que você faça o mesmo para todos os endereços IP do processador de mensagens. Por exemplo, para descartar solicitações provenientes de endereços IP do processador de mensagens para o nó do Qpid na porta 5672 usando IPTables, use um comando como este:

    iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
  3. Inicie o agente qpid novamente para drenar as mensagens atuais, se houver:
    apigee-service apigee-qpidd start
  4. Verifique se as filas atuais estão vazias. Para verificar, faça login no portal de gerenciamento do Qpid:
    http://QPID_NODE_IP:8090
    Observação: se a porta 8090 no nó do QPID não estiver acessível, use mecanismos alternativos, como o encaminhamento de portas SSH, para acessar esse URL.
  5. Depois de verificar se as filas foram esvaziadas, interrompa e desinstale o Qpid:
    apigee-service apigee-apidd uninstall
  6. Exclua o diretório de dados do Qpid:
    rm -r APIGEE_ROOT/data/apigee-qpidd
  7. Reinstale o agente do Qpid:
    /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  8. Depois que o agente do Qpid for reinstalado, remova as configurações de firewall e liste as configurações atuais usando os seguintes comandos:
    iptables -F
    iptables -L

Nova interface do Edge

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

Instalar a IU 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 que você está atualizando:

Atualizar com mTLS da Apigee

Para atualizar a mTLS da Apigee, siga estas etapas:

Como reverter uma atualização

No caso de uma falha de atualização, tente corrigir o problema e execute update.sh novamente. É possível executar a atualização várias vezes, e ela vai 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 executa o utilitário update.sh não tiver acesso a esse diretório, ele gravará o registro no diretório /tmp como um arquivo chamado update_username.log.

Se a pessoa não tiver acesso 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 desativar o Edge.

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

A chave para o upgrade sem inatividade é remover 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 a instalação, conforme descrito em Ordem de atualização da máquina.
  2. Quando for hora de atualizar os roteadores, selecione qualquer roteador e torne-o inacessível, conforme descrito em Como 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. Torne o roteador acessível novamente.
  5. Repita as etapas de 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 silenciosa precisa ser o mesmo que você usou para instalar o Edge 4.50.00 ou 4.51.00.

Atualizar para 4.52.01 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.01.sh do Edge para /tmp/bootstrap_4.52.01.sh:
      curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh
    2. Instale o utilitário apigee-service do Edge 4.52.01 e as dependências executando o seguinte comando:
      sudo bash /tmp/bootstrap_4.52.01.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 você o insira.

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

      Use a opção JAVA_FIX para especificar como lidar com a instalação do Java. JAVA_FIX usa 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 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 os seguintes:
        • 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 da versã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 completo (AIO) do Edge. 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, se ainda não tiver 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, use o procedimento descrito em Reverter 4.52.01.

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

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

Depois de criar um repositório local do Edge, você tem duas opções para atualizar o Edge 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.52.01:

  1. Crie um repositório local 4.52.01, 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 seguinte comando para empacotar o repositório local em um único arquivo .tar chamado /opt/apigee/data/apigee-mirror/apigee-4.52.01.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.01.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.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      Observe que você inclui o caminho para o diretório de repositórios 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.01.sh do Edge para /tmp/bootstrap_4.52.01.sh:
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.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 do Edge e as dependências:
      sudo bash /tmp/bootstrap_4.52.01.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: 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 da versã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 completo (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. Teste a atualização executando o utilitário apigee-validate no servidor de gerenciamento, conforme descrito em Testar a instalação.

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

Ordem de atualização da máquina

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

  • É necessário atualizar todos os nós do Cassandra e do ZooKeeper antes de atualizar qualquer outro nó.
  • Para qualquer máquina com vários componentes do Edge (servidor de gerenciamento, processador de mensagens, roteador, servidor QPID, mas não servidor Postgres), use a opção -c edge para atualizar todos ao mesmo tempo.
  • Se uma etapa especificar que deve ser realizada em várias máquinas, faça isso 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 separado de 1 nó

Para fazer upgrade de uma configuração independente de um nó para a versão 4.52.01:

  1. Atualize todos os componentes:
    /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
  2. (Se você instalou o apigee-adminapi) Atualização do 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 do Edge e números de nós.

  1. Atualize o Cassandra e o ZooKeeper na máquina 1:
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Atualize o 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 da Apigee) Atualize o SSO da Apigee na máquina 1:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Em que sso_config_file é o arquivo de configuração que você criou ao 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ós.

  1. Atualize o Cassandra e o ZooKeeper nas máquinas 1, 2 e 3:
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Atualize o 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 IU 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 IU do Edge: se você instalou a nova IU 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 da Apigee) Atualize o SSO da Apigee na máquina 1:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  11. 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 9 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 do Edge e números de nós.

  1. Atualize o Cassandra e o ZooKeeper nas máquinas 1, 2 e 3:
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Atualize o 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 os componentes do Edge nas máquinas 6, 7, 8, 9, 1, 4 e 5, nessa ordem:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Atualize o 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 interface clássica (ui) na máquina 1:
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  8. (Se você instalou apigee-adminapi) Atualize o utilitário apigee-adminapi na máquina 1:
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (Se você instalou o SSO da Apigee) Atualize o SSO da Apigee na máquina 1:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

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

  1. Atualize o Cassandra e o ZooKeeper nas máquinas 1, 2 e 3:
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Atualize o 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 os componentes do Edge nas máquinas 12, 13, 8, 9, 6, 7, 10 e 11, nessa ordem:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Atualize o 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 interface clássica (ui) nas máquinas 6 e 7:
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  8. (Se você instalou o apigee-adminapi) Atualizou 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 da Apigee) Atualize o SSO da Apigee nas máquinas 6 e 7:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Em que sso_config_file é o arquivo de configuração que você criou ao 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, como mostra o exemplo a seguir:
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • Nova IU do Edge: se você instalou a nova IU 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 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ós.

  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. Atualize o Postgres:
    1. Máquina 6 no data center 1
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    2. Máquina 12 no data center 2
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Atualizar LDAP:
    1. Máquina 1 no data center 1
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. Máquina 7 no data center 2
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. Atualize os componentes do Edge:
    1. Máquinas 4, 5, 6, 1, 2, 3 no data center 1
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. Máquinas 10, 11, 12, 7, 8, 9 no data center 2
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. Atualize o qpidd:
    1. Máquinas 4 e 5 no data center 1
      1. Atualize qpidd na máquina 4:
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Atualize qpidd na máquina 5:
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. Máquinas 10 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 o qpidd na máquina 11:
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. Atualize a nova interface (ue) ou a interface 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) Atualizamos 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 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
    3. Em que sso_config_file é o arquivo de configuração que você criou quando instalou 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 na seguinte 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.