4.52.02.01 - Notas da versão do Edge para nuvem privada

Você está lendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X.
info

Em 6 de dezembro de 2024, lançamos uma nova versão do Apigee Edge para nuvem privada.

Procedimento de atualização

Esta seção descreve como instalar essa versão se você estiver atualizando da versão anterior do Edge para nuvem privada. Se você precisar atualizar de uma versão anterior, consulte Como aplicar várias versões de patch.

A atualização dessa versão vai atualizar os componentes listados abaixo:

  • apigee-cassandra-3.11.16-0.0.2585.noarch.rpm
  • apigee-postgresql-14.5-0.0.2756.noarch.rpm
  • apigee-qpidd-8.0.6-0.0.2533.noarch.rpm
  • edge-analytics-4.52.02-0.0.40121.noarch.rpm
  • edge-gateway-4.52.02-0.0.60260.noarch.rpm
  • edge-management-server-4.52.02-0.0.60260.noarch.rpm
  • edge-message-processor-4.52.02-0.0.60260.noarch.rpm
  • edge-postgres-server-4.52.02-0.0.60260.noarch.rpm
  • edge-qpid-server-4.52.02-0.0.60260.noarch.rpm
  • edge-router-4.52.02-0.0.60260.noarch.rpm
  • edge-mint-gateway-4.52.02-0.0.40465.noarch.rpm
  • edge-mint-management-server-4.52.02-0.0.40465.noarch.rpm
  • edge-mint-message-processor-4.52.02-0.0.40465.noarch.rpm
  • apigee-setup-4.52.02-0.0.1139.noarch.rpm

Você pode verificar as versões do RPM instaladas no momento para saber se elas precisam ser atualizadas inserindo:

apigee-all version

Para atualizar a instalação, siga o procedimento abaixo nos nós do Edge:

  1. Em todos os nós do Edge:

    1. Limpe os repositórios do Yum:
      sudo yum clean all
    2. Faça o download do arquivo mais recente do Edge 4.52.02 bootstrap_4.52.02.sh para /tmp/bootstrap_4.52.02.sh:
      curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
    3. Instale o utilitário apigee-service do Edge 4.52.02 e as dependências:
      sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord

      Em que uName e 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.

    4. Use o comando source para executar o script apigee-service.sh:
      source /etc/profile.d/apigee-service.sh
    5. Atualize o utilitário apigee-setup:
      apigee-service apigee-setup update
  2. Em todos os nós do Cassandra, execute o script update.sh:
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  3. Em todos os nós do Qpid, execute o script update.sh:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. Em todos os nós do Postgres, execute o script update.sh:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. Em todos os nós do Edge, execute o script update.sh para o processo edge (incluindo a monetização):
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Correções de bugs

Esta seção lista os bugs da nuvem privada que foram corrigidos nesta versão.

ID do problema Descrição
372070691 Removeu a biblioteca JNA redundante do Cassandra.
362799717 Corrigiu uma falha na exclusão de dados armazenados em cache.
361792608 Corrigiu um bug em que a presença de esquemas obsoletos, como edgenotification, causava problemas no Cassandra.
361436097 Adicionou verificações de validação ao comando drop_old_tables do Cassandra para evitar a execução se o cluster do Cassandra contiver várias versões de esquema.
370115540 Resolveu uma falha intermitente ao usar o script setup.sh para instalar ou configurar o Cassandra.
375487499 Restaurou a funcionalidade das APIs rebuildIndex.
362909723 Atualizou o driver do Postgres para a versão 42.5.5.
379179891 O Cassandra agora define o fator de replicação das tabelas do sistema para corresponder à topologia do cluster.
381092556 Adicionou validações para verificar a presença de diretórios em scripts em vários componentes.
372068460 Definiu um diretório de dados de propriedade da Apigee como TMPDIR para o Cassandra.
373673550 Melhorou a ação wait_for_ready do QPID.
360376605 Corrigiu um problema que impedia os usuários do Edge para nuvem privada no ambiente da AWS de usar as APIs de monetização.

Problemas de segurança corrigidos

A seguir, confira uma lista de problemas de segurança conhecidos que foram corrigidos nesta versão. Para evitar esses problemas, instale a versão mais recente do Edge para nuvem privada.

ID do problema Descrição
344961470 Aplicou um patch no portal de gerenciamento do QPID para resolver uma vulnerabilidade XSS.

Mudanças no software com suporte

O suporte foi adicionado para o seguinte:

  • Red Hat Enterprise Linux (RHEL) 8.10
  • Oracle Enterprise Linux (OEL) 8.10

Descontinuações e desativações

Não há novas descontinuações ou desativações nesta versão.

Novos recursos

Esta seção lista os novos recursos desta versão.

ID do problema Descrição
352648971 Introduziu um recurso em que o roteador veicula o certificado/chave de fallback configurado em portas SSL não padrão para clientes que não oferecem suporte a SNI. Para ativar esse recurso, defina a configuração conf_load_balancing_load.balancing.driver.nginx.fallback.server.nonstandard.ports.enabled como true nos nós do roteador. Consulte Como usar o SNI com o Edge para mais detalhes.

Problemas conhecidos

Consulte Problemas conhecidos com o Edge para nuvem privada para conferir uma lista completa de problemas conhecidos.

Como aplicar várias versões de patch

Esta seção descreve como aplicar várias versões de patch, caso você esteja atualizando de uma versão do Edge para nuvem privada anterior à versão de lançamento patch anterior.

Cada versão de patch contém atualizações para componentes específicos do Edge para nuvem privada, como edge-management-server. Para aplicar várias versões de patch, é necessário atualizar cada componente do Edge incluído em uma versão de patch posterior à versão instalada no momento. Para encontrar esses componentes, consulte as notas de lançamento do Edge para nuvem privada de todas as versões posteriores à sua e verifique a lista de RPMs dessas versões. Consulte Notas de lançamento da Apigee para conferir links para todas as notas de lançamento do Edge para nuvem privada.

Observação: só é necessário atualizar cada componente uma vez, instalando o RPM da versão mais recente do componente incluído nas versões de patch. Siga as instruções nas notas de lançamento dessa versão para atualizar o componente.

Observação: o upgrade de um componente instala automaticamente a versão de patch mais recente de um componente. Se você quiser fazer upgrade para uma versão de patch que não seja a mais recente, será necessário manter sua própria cópia do tarball do repositório da Apigee usando o espelho da Apigee e usar esse espelho para instalações da Apigee. Para mais informações, consulte Como usar um repositório local do Edge para manter a versão do Edge.