Note di rilascio di Edge per Private Cloud 4.19.01

Formato file di metadati per l'installazione apigee-sso

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

Soluzione:

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

• Aggiungi un CRLF alla fine del file metadata.xml

  OPPURE

• Utilizza una posizione basata sull'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; dovrebbe essere eseguito il backup dell'insieme 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 da Apigee Edge.

Soluzione:

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

Soluzione:

Le richieste HEAD alle destinazioni Node.js si bloccano

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

Soluzione:

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

I nomi host non risolvono il problema

Dopo l'installazione o l'upgrade di Edge per il cloud privato, i nomi host potrebbero non essere risolti nei loro indirizzi.

Soluzione:

Per risolvere il problema, riavvia il componente Edge UI:

/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 è più disponibile, potrebbe essere visualizzato il seguente errore:

DataAccessException: Error while accessing datastore;
Please retry later

Di conseguenza, il server di gestione potrebbe non avviarsi 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. Ciò potrebbe anche causare l'interruzione del traffico delle API, in cui i processori di messaggi segnalano DataAccessExceptions durante il tentativo di recupero dei 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 consiste nell'annullare la registrazione dei seguenti tipi di nodo Cassandra nei data center non disponibili, quindi registrarli di nuovo quando i nodi Cassandra saranno di nuovo disponibili:

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

Per annullare la registrazione di questi tipi di nodi Cassandra e registrarli di nuovo:

1. Ottieni 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 con qualcos'altro, quindi controlla l'implementazione.
   • CASSANDRA_NODE_TYPE è uno tra 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 passaggio 1 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 seguente comando:

   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 di nuovo 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 la registrazione dei nodi da Zookeeper e non hanno alcun impatto sul cluster Cassandra. Per maggiori informazioni su questi comandi, consulta la pagina relativa all'aggiornamento delle registrazioni dei datastore.

Criterio 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à
• Il timestamp

Soluzione:

La reimpostazione della password dell'amministratore di sistema non va a buon fine

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

Soluzione:

Definisci la password in un file di dati che poi passi all'endpoint /users nell'API di gestione. Per maggiori informazioni, vedi Reimpostazione della password dell'amministratore di sistema.