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

Você está vendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X.
informações

Em 23 de setembro de 2021, lançamos uma nova versão do Apigee Edge para nuvem privada.

Procedimento de atualização

Atualizar esta versão atualizará os componentes na seguinte lista de RPMs:

  • Edge-analytics-4.50.00-0.0.40046.noarch.rpm
  • apigee-sso-4.50.00-0.0.21034.noarch.rpm
  • apigee-tomcat-8.5.64-0.0.917.noarch.rpm
  • apigee-machinekey-1.1.0-0.0.20008.noarch.rpm
  • apigee-lib-4.50.00-0.0.1019.noarch.rpm
  • apigee-cassandra-2.1.22-0.0.2527.noarch.rpm
  • apigee-cassandra-client-2.1.22-0.0.2512.noarch.rpm
  • apigee-setup-4.50.00-0.0.1128.noarch.rpm
  • apigee-service-4.50.00-0.0.1428.noarch.rpm
  • apigee-configutil-4.50.00-0.0.613.noarch.rpm
  • Edge-gateway-4.50.00-0.0.20140.noarch.rpm
  • Edge-management-server-4.50.00-0.0.20140.noarch.rpm
  • Edge-message-processor-4.50.00-0.0.20140.noarch.rpm
  • Edge-postgres-server-4.50.00-0.0.20140.noarch.rpm
  • Edge-qpid-server-4.50.00-0.0.20140.noarch.rpm
  • Edge-router-4.50.00-0.0.20140.noarch.rpm
  • Edge-mint-gateway-4.50.00-0.0.30233.noarch.rpm
  • Edge-mint-management-server-4.50.00-0.0.30233.noarch.rpm
  • Edge-mint-message-processor-4.50.00-0.0.30233.noarch.rpm
  • Edge-management-ui-4.50.00-0.0.20020.noarch.rpm
  • Edge-ui-4.50.00-0.0.20198.noarch.rpm
  • Edge-management-ui-static-4.50.00-0.0.20033.noarch.rpm
  • apigee-validate-4.50.00-0.0.624.noarch.rpm
  • apigee-mtls-4.50.00-0.0.20224.noarch.rpm
  • apigee-adminapi-4.50.00-0.0.607.noarch.rpm

É possível verificar as versões de RPM instaladas atualmente e confirmar se elas precisam ser atualizadas digitando:

apigee-all version

Para atualizar a instalação, execute o seguinte procedimento nos nós de borda:

  1. Em todos os nós de borda:

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

      uName:pWord é o nome de usuário e a senha que você recebeu da Apigee. Se você omitir pWord, será necessário inseri-lo.

    4. Atualize o utilitário apigee-setup:
      sudo /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    5. Atualize o utilitário apigee-lib:
      sudo /opt/apigee/apigee-service/bin/apigee-service apigee-lib update
    6. Use o comando source para executar o script apigee-service.sh:
      source /etc/profile.d/apigee-service.sh
  2. Atualize o utilitário apigee-validate no servidor de gerenciamento:
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  3. Atualize o utilitário apigee-adminapi:
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  4. Atualização do utilitário apigee-machinekey:
    /opt/apigee/apigee-service/bin/apigee-service apigee-machinekey update
  5. Atualizar utilitário de apigee-config:
    /opt/apigee/apigee-service/bin/apigee-service apigee-configutil update
  6. Atualize todos os nós do Cassandra:
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile

    em que configFile especifica o arquivo de configuração usado para instalar o Apigee Edge para nuvem privada. Por exemplo, /opt/silent.conf.

  7. Em todos os nós de borda, execute o script update.sh para o processo de borda:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. Execute o script update.sh para SSO em todos os nós:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile
  9. Execute o script update.sh para a IU em todos os nós:
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  10. Se você estiver usando a nova experiência do Edge, execute o seguinte comando:
    /opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
  11. Se você estiver usando o mTLS da Apigee, siga o procedimento descrito em Fazer upgrade do mTLS da Apigee. Para mais informações, consulte Introdução ao mTLS da Apigee.

Mudanças no software compatível

Não há alterações no software compatível nesta versão.

Descontinuações e suspensões

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

Novos recursos

Esta versão introduz os seguintes novos recursos:

Novo wrapper ao redor da ferramenta de reparo do nodetool

O wrapper faz uma verificação de integridade no espaço em disco (onde o Cassandra está montado) antes de executar o reparo do nodetool. O wrapper também aceita a autenticação JMX e as configurações relacionadas a SSL sobre JMX.

Adicionado suporte à política LDAP para substituição de string dinâmica para o elemento <BaseDN>.

O elemento <BaseDN> da política de LDAP especifica o nível base do LDAP em que todos os dados estão. Nesta versão, adicionamos um atributo ref ao elemento, que pode ser usado para especificar uma variável de fluxo que contém o valor <BaseDN>, como apigee.baseDN. ref tem precedência sobre um valor BaseDN explícito. Se você especificar ref e o valor, ref terá prioridade. Se ref não for resolvido no momento da execução, o valor será usado.

Correções de bugs

Nesta seção, listamos os bugs da nuvem privada que foram corrigidos nesta versão.

Id do problema Descrição
197513151

Foi corrigido o caminho do script jQuery inconsistente na IU clássica

151852439

A geração de registros aprimorada da IU falhou devido a uma configuração incorreta do arquivo .properties

Isso foi corrigido.
194875545

Erro 404 ao acessar um desenvolvedor na página de apps do desenvolvedor

Isso foi corrigido.
179769806

As empresas não apareciam na IU do Edge

Isso foi corrigido.
188039112

Problemas de confiança de certificados autoassinados na IU do Edge

Isso foi corrigido.
195932618

console.log() estava causando geração de registros excessiva

Isso foi corrigido.
193216745

Houve um pequeno bug na forma como os nomes dos data centers são classificados nos scripts de configuração do Cassandra.

Isso foi corrigido.
1195932115

O SSO da Apigee retornava incorretamente stack traces nas respostas.

Isso foi corrigido. Os stack traces ainda são registrados.
79591934

apigee-validate falhava com uma mensagem obscura (link em inglês)

Isso foi corrigido. O registro de erros do script de validação da Apigee foi aprimorado.
174732169

As mensagens syslog foram descartadas incorretamente

Isso foi corrigido.
193239069

As chaves legadas foram removidas dos componentes de gateway e chave de máquina

197760258

Uma falha na API de permissões estava causando problemas de compatibilidade entre a IU do Edge e o gateway

Esse problema, que ocorria quando a autenticação LDAP externa estava ativada, foi corrigido.
194485178

Remoção dos espaços à direita e à esquerda de todas as propriedades de limite de solicitação e resposta HTTP

193918953

Algumas configurações não usadas foram removidas dos componentes de gateway

112262604

O servidor de gerenciamento do Mint precisa ser atualizado quando o failover do Postgres é realizado

Um script aprimorado foi criado para alterar os detalhes de conexão do Postgres para o servidor de gerenciamento do Mint. Consulte Como lidar com um failover de banco de dados PostgresSQL.
197301743

Uma grande mensagem de handshake de SSL estava causando problemas no Java 1.8.0_3XX

Isso foi corrigido.
188526117

O comando ip não foi prefixado com o caminho absoluto

Isso foi corrigido. Os scripts da Apigee agora qualificam totalmente o caminho dos comandos.
171240470

A atualização de gerenciamento falhava quando a autenticação ou o SSL do Cassandra JMX estava ativado

Adição de recurso para fornecer a autenticação do Cassandra JMX e as configurações de SSL ao executar a configuração ou atualização no servidor de gerenciamento.
193564174

Os painéis do Edge UI Analytics não conseguiram buscar dados

Corrigimos um bug em que as consultas do Google Analytics falhavam para ambientes com um ponto no nome.
167960487

Palavras-chave reservadas E/OU no texto das dimensões estavam causando falha nos relatórios do Google Analytics.

Isso foi corrigido.
132402519

O espaço em branco extra na lista de endereços IP de router.properties estava impedindo a exibição dos roteadores

Isso foi corrigido. O espaço em branco extra foi removido.
184573211

O Java Management Extensions (JMX) não está mais ativado por padrão para o módulo SSO da Apigee.

Problemas de segurança corrigidos

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

Id do problema Descrição
N/A

As senhas eram registradas no Edge para a nuvem privada devido ao registro normal de alterações delta do arquivo de configuração. É possível evitar a geração de registros de alterações de configuração da seguinte maneira:

  • Se um componente do Edge já estiver instalado, siga uma destas etapas:
    • Defina LOGGER_PRINT_CONFIG_DELTA=false como uma variável de ambiente. Isso interrompe a geração de registros delta de configuração para todos os componentes nesse nó.
    • Para interromper a geração de registros delta de configuração para componentes específicos, adicione logger.print.config.delta=false ao arquivo de configuração específico do cliente para esse componente. Isso interrompe o registro de alterações de configuração desse componente. Consulte Como configurar o Edge para mais informações.
  • Se você estiver instalando um componente do Edge, adicione a seguinte entrada ao arquivo silent.conf para impedir a geração de registros de mudanças de configuração:
    CONFIG_DELTA_LOG=n

    Isso configura o componente para não registrar as alterações de configuração.

N/A Maior segurança de senhas e dados relacionados armazenados na plataforma.
CVE-2015-9251 (em inglês) O scripting em vários locais (XSS) é corrigido quando uma solicitação Ajax de vários domínios é realizada sem a opção dataType no jQuery.
N/A Foram adicionadas mais proteções contra ataques de repetição de declaração SAML.

Problemas conhecidos

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