Note di rilascio di Edge per Private Cloud 4.19.01

Formato del file di metadati per l'installazione di 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 del file, il file metadata.xml non viene letto interamente.

Soluzione temporanea:

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

• Aggiungi un CRLF alla fine del file metadata.xml

  OPPURE

• Utilizzare una posizione basata sull'URL per i metadati

apigee-monit non supportato su Amazon Linux 1

Soluzione temporanea:

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

Soluzione temporanea:

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

Token di sessione non invalidati

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

Soluzione temporanea:

Le operazioni di Cassandra non funzionano quando l'autenticazione JMX è attivata

Soluzione temporanea:

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 temporanea:

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

Nomi host non risolvibili

Dopo aver installato o eseguito l'upgrade di Edge per Private Cloud, i nomi host potrebbero non essere risolti nei relativi indirizzi.

Soluzione temporanea:

Per risolvere il problema, riavvia il componente dell'interfaccia utente Edge:

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

DataAccessException in configurazioni di più data center

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

DataAccessException: Error while accessing datastore;
Please retry later

Il risultato è che Management Server potrebbe non avviarsi perché sta tentando di connettersi ai nodi Cassandra sia in dc-1 che in dc-2. L'errore DataAccessExceptions si verifica se un nodo Cassandra è inattivo. Ciò potrebbe anche causare un'interruzione del traffico API, in cui i processori di messaggi segnalano DataAccessExceptions durante il tentativo di recuperare le KVM.

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

Soluzione temporanea

La soluzione alternativa consiste nell'annullare la registrazione dei seguenti tipi di nodi Cassandra nel data center non disponibile e poi registrarli di nuovo dopo che i nodi Cassandra sono di nuovo disponibili:

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

Per annullare la registrazione e registrarli di nuovo:

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". Potresti averlo rinominato, quindi controlla l'implementazione.
   • CASSANDRA_NODE_TYPE è uno dei valori 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 ulteriori informazioni su questi comandi, consulta Aggiorna le registrazioni del 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 deve includere informazioni generate da Apigee. Tuttavia, anche se imposti FormatMessage=false, il messaggio di log include comunque le seguenti informazioni:

• Il punteggio di priorità
• Il timestamp

Soluzione temporanea:

Reimpostazione della password di amministratore di sistema non riuscita

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

Soluzione temporanea:

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