4.19.01 Notas de lançamento do Edge para nuvem privada

Formato do arquivo de metadados para instalação do apigee-sso

Ao instalar o apigee-sso e usar um arquivo metadata.xml em vez de um URL, se o arquivo metadata.xml não incluir uma nova linha (CRLF) no final, esse arquivo não será lido totalmente.

Alternativa:

Para contornar esse problema, siga um destes procedimentos:

• Adicionar um CRLF ao final do arquivo metadata.xml

  OU

• Usar um local com base em URL para os metadados

apigee-monit não é compatível com o Amazon Linux 1

Alternativa:

O backup do processador de mensagens não está fazendo backup do conjunto correto de arquivos

Alternativa:

Execute o backup uma segunda vez para conseguir o conjunto correto de arquivos.

Tokens de sessão não invalidados

Os tokens de sessão não são invalidados no servidor quando o usuário clica no botão "Sair do Apigee Edge".

Alternativa:

As operações do Cassandra não funcionam quando a autenticação JMX está ativada

Alternativa:

As solicitações HEAD para destinos do Node.js vão travar

As solicitações HEAD para um destino Node.js podem travar, deixando as conexões pendentes.

Alternativa:

Para contornar esse problema, defina um gerenciador para que solicitações HEAD retornem explicitamente uma resposta vazia.

Os nomes de host não estão resolvendo

Depois de instalar ou fazer upgrade do Edge para nuvem privada, os nomes do host podem não ser resolvidos para os endereços deles.

Alternativa:

Para resolver esse problema, reinicie o componente de interface do Edge:

/opt/apigee/apigee-service/bin/apigee-service edge-ui restart

DataAccessException em várias configurações de data center

Em várias configurações de data center, se um repositório de dados ficar indisponível, você poderá ver o erro a seguir:

DataAccessException: Error while accessing datastore;
Please retry later

O resultado é que o servidor de gerenciamento pode não ser iniciado porque está tentando se conectar aos nós do Cassandra em dc-1 e dc-2. O DataAccessExceptions ocorre se um nó do Cassandra estiver inativo. Isso também pode resultar na interrupção do tráfego da API, em que os processadores de mensagens relatam DataAccessExceptions ao tentar recuperar as KVMs.

Observe que o estado esperado é que o servidor de gerenciamento não se conecte a componentes do armazenamento de dados entre regiões.

Alternativa

A solução alternativa é cancelar o registro dos seguintes tipos de nó do Cassandra no data center indisponível e registrá-los novamente depois que os nós do Cassandra estiverem disponíveis novamente:

• kms-datastore
• dc-datastore
• keyvaluemap-datastore

Para cancelar e registrar novamente esses tipos de nó do Cassandra:

1. Consiga os UUIDs dos nós do Cassandra usando o seguinte comando curl:

   curl -u ADMIN_EMAIL:ADMIN_PW \
     "http://MS_IP:MS_PORT/v1/servers?region=REGION&pod=GATEWAY_POD \
     &type=CASSANDRA_NODE_TYPE"

   Em que:

   • ADMIN_EMAIL e ADMIN_PW são as credenciais da sua conta da Apigee.
   • MS_IP e MS_PORT são o endereço IP e o número da porta do servidor de gerenciamento.
   • REGION é o nome do data center em que o servidor de gerenciamento está localizado.
   • GATEWAY_POD é o nome do pod, que é, por padrão, "gateway". Talvez você tenha renomeado para outra coisa, então verifique sua implementação.
   • CASSANDRA_NODE_TYPE é uma destas opções: kms-datastore, dc-datastore ou keyvaluemap-datastore.

   Por exemplo:

   curl -u nickdanger@google.com:myP@$$w0rD
     "http://192.168.0.1:8080/v1/servers?region=dc-1&pod=gateway&type=dc-datastore"

   A resposta usa o seguinte formato:

   {
     "internalIP" : "POD_IP_ADDRESS",
     "isUp" : [true|false],
     "pod" : "GATEWAY_POD",
     "reachable" : [true|false],
     "region" : "dc-1",
     "tags" : {
       "property" : [ ]
     },
     "type" : [ "kms-datastore", "dc-datastore", "keyvaluemap-datastore" ],
       "uUID" : "POD_UUID"
   }

   Por exemplo:

   {
     "internalIP" : "192.168.1.11",
     "isUp" : false,
     "pod" : "gateway",
     "reachable" : false,
     "region" : "dc-1",
     "tags" : {
       "property" : [ ]
     },
     "type" : "dc-datastore",
     "uUID" : "13cee956-d3a7-4577-8f0f-1694564179e4"
   }

   Observe os valores do campo uUID na resposta. Elas serão usadas para cancelar o registro dos nós.

2. Repita a etapa um para cada tipo de nó do Cassandra: kms-datastore, dc-datastore e keyvaluemap-datastore. Anote os UUIDs retornados.
3. Cancele o registro dos nós usando o seguinte comando:

   curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers/UUID" -X DELETE

   em que UUID é o UUID retornado na resposta do comando anterior.

4. Repita a etapa 3 para cada UUID coletado nas etapas 1 e 2.
5. Registre novamente os nós usando o seguinte comando:

   curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers -d \
     "Type=kms-datastore&Type=dc-datastore&Type=keyvaluemap-datastore& \
     Type=counter-datastore&Type=cache-datastore&InternalIP=POD_IP_ADDRESS& \
     region=REGION&pod=GATEWAY_POD" -H \
     'content-type: application/x-www-form-urlencoded' -X POST

Observe que essas operações registram e cancelam o registro de nós do Zookeeper e não têm nenhum impacto no cluster do Cassandra. Para mais informações sobre esses comandos, consulte Atualizar registros do repositório de dados.

Política MessageLogging, incluindo informações extras na mensagem de registro

O elemento FormatMessage da política MessageLogging controla o formato da mensagem registrada. Quando for FormatMessage=false, a mensagem registrada não poderá incluir informações geradas pela Apigee. No entanto, mesmo que você defina FormatMessage=false, a mensagem de registro ainda vai incluir estas informações:

• A pontuação de prioridade.
• O carimbo de data/hora

Alternativa:

Falha ao redefinir a senha do administrador do sistema

Falha ao redefinir a senha do administrador do sistema do Servidor de Gerenciamento que contém caracteres especiais.

Alternativa:

Defina a senha em um arquivo de dados que você transmite para o endpoint /users na API Management. Veja mais informações em Redefinir a senha do administrador do sistema.