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, ele não será lido por completo.

Alternativa:

Para contornar esse problema, siga um destes procedimentos:

• Adicione um CRLF ao final do arquivo metadata.xml

  OU

• Usar um local baseado em URL para os metadados

apigee-monit não disponível no 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 fazer backup do 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 ficam pendentes

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

Alternativa:

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

Nomes de host não resolvidos

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

Alternativa:

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

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

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

Em configurações com vários data centers, se um repositório de dados ficar indisponível, talvez você veja o seguinte erro:

DataAccessException: Error while accessing datastore;
Please retry later

O resultado é que o Management Server pode não iniciar 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 em interrupção do tráfego da API, em que os processadores de mensagens informam DataAccessExceptions ao tentar recuperar KVMs.

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

Alternativa

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

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

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

1. Use o seguinte comando curl para receber os UUIDs dos nós do Cassandra:

   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". Você pode ter renomeado para outra coisa, então verifique sua implementação.
   • CASSANDRA_NODE_TYPE é um dos campos kms-datastore, dc-datastore e keyvaluemap-datastore.

   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"
   }

   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"
   }

   Anote os valores do campo uUID na resposta. Você vai usar esses comandos para cancelar o registro dos nós.

2. Repita a etapa 1 para cada tipo de nó do Cassandra: kms-datastore, dc-datastore e keyvaluemap-datastore. Anote os UUIDs retornados.
3. Remova 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 os nós novamente 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

Essas operações registram e cancelam o registro de nós do Zookeeper e não têm impacto no cluster do Cassandra. Para mais informações sobre esses comandos, consulte Atualizar registros de datastore.

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 FormatMessage=false, a mensagem registrada não deve incluir informações geradas pela Apigee. No entanto, mesmo que você defina FormatMessage=false, a mensagem de registro ainda vai incluir as seguintes informações:

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

Alternativa:

Falha ao redefinir a senha de administrador do sistema

A redefinição da senha de administrador do sistema para o servidor de gerenciamento que contém caracteres especiais vai falhar.

Alternativa:

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