4.19.01 Note di rilascio Edge per cloud privato

Formato file di metadati per l'installazione di Apigee Apigee

Quando installi apigee-sso e utilizzi un file metadata.xml invece di un URL, se il file metadata.xml non include una nuova riga (CRLF) alla fine del file, il file metadata.xml non viene letto del tutto.

Soluzione:

Per risolvere il problema, puoi procedere in uno dei seguenti modi:

• Aggiungi un elenco CRLF alla fine del file metadata.xml

  OPPURE

• Utilizza un percorso basato su URL per i metadati

apigee-monit non supportato su Amazon Linux 1

Soluzione:

Il backup del processore di messaggi non esegue il backup del set di file corretto

Soluzione:

Esegui il backup una seconda volta e dovrebbe eseguire il backup del set di file corretto.

Token di sessione non invalidati

I token di sessione non vengono invalidati sul server quando l'utente fa clic sul pulsante di disconnessione di Apigee Edge.

Soluzione:

Le operazioni Cassandra non funzionano se è abilitata l'autenticazione JMX

Soluzione:

HEAD richieste per le destinazioni Node.js bloccate

Le richieste HEAD a una destinazione Node.js possono essere sospese, lasciando le connessioni in attesa.

Soluzione:

Per risolvere il problema, definisci un gestore per le richieste HEAD in modo che restituiscano esplicitamente una risposta vuota.

I nomi host non vengono risolti

Dopo aver installato o eseguito l'upgrade di Edge per il cloud privato, i nomi host potrebbero non risolversi con i loro indirizzi.

Soluzione:

Per risolvere il problema, riavvia il componente UI di Edge:

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

DataAccessException in più configurazioni di data center

In più configurazioni di data center, se un datastore non è disponibile, potresti visualizzare il seguente errore:

DataAccessException: Error while accessing datastore;
Please retry later

Il risultato è che il server di gestione potrebbe non iniziare perché sta tentando di connettersi ai nodi Cassandra sia in dc-1 che in dc-2. DataAccessExceptions si verifica se un nodo Cassandra non è attivo. Questo potrebbe anche causare un'interruzione del traffico dell'API, in cui i processori di messaggi segnalano DataAccessExceptions mentre tentano di recuperare le KVM.

Tieni presente che lo stato previsto è che il server di gestione non si connetta ai componenti del datastore in tutte le regioni.

Soluzione

La soluzione alternativa è annullare la registrazione dei seguenti tipi di nodi Cassandra nel data center non disponibile e registrarli nuovamente quando i nodi Cassandra saranno di nuovo disponibili:

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

Per annullare la registrazione e registrare nuovamente questi tipi di nodi Cassandra:

1. Recupera gli UUID dei nodi Cassandra utilizzando il seguente comando curl:

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

   Dove:

   • ADMIN_EMAIL e ADMIN_PW sono le credenziali del tuo account Apigee.
   • MS_IP e MS_PORT sono l'indirizzo IP e il numero di porta del server di gestione.
   • REGION è il nome del data center in cui si trova il server di gestione.
   • GATEWAY_POD è il nome del pod, che per impostazione predefinita è "gateway". Tuttavia, potresti averlo rinominato in un altro aspetto, quindi controlla la tua implementazione.
   • CASSANDRA_NODE_TYPE è uno di kms-datastore, dc-datastore e keyvaluemap-datastore.

   Ad esempio:

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

   La risposta utilizza il seguente 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"
   }

   Ad esempio:

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

   Prendi nota dei valori del campo uUID nella risposta. Li utilizzerai per annullare la registrazione dei nodi.

2. Ripeti il primo passaggio per ogni tipo di nodo Cassandra: kms-datastore, dc-datastore e keyvaluemap-datastore. Assicurati di prendere nota degli UUID restituiti.
3. Annulla la registrazione dei nodi utilizzando il comando seguente:

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

   Dove UUID è l'UUID restituito nella risposta del comando precedente.

4. Ripeti il passaggio 3 per ogni UUID raccolto nei passaggi 1 e 2.
5. Registra nuovamente i nodi utilizzando il seguente 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

Tieni presente che queste operazioni registrano e annullano i nodi da Zookeeper e non hanno alcun impatto sul cluster Cassandra. Per ulteriori informazioni su questi comandi, consulta Aggiornare le registrazioni del datastore.

Criterio di MessageLogging che include informazioni aggiuntive nel messaggio di log

L'elemento FormatMessage del criterio MessageLogging controlla il formato del messaggio registrato. Quando FormatMessage=false, il messaggio registrato non dovrebbe includere informazioni generate da Apigee. Tuttavia, anche se imposti FormatMessage=false, il messaggio di log includerà comunque le seguenti informazioni:

• Il punteggio di priorità
• Timestamp

Soluzione:

La reimpostazione della password di amministratore di sistema non riesce

La reimpostazione della password di amministratore di sistema per il server di gestione che contiene caratteri speciali non andrà a buon fine.

Soluzione:

Definisci la password in un file di dati che passi all'endpoint /users nell'API di gestione. Per saperne di più, vedi Reimpostazione della password di amministratore di sistema.