Note di rilascio di Edge per Private Cloud 4.19.06

Stai visualizzando la documentazione di Apigee Edge.
Vai alla documentazione di Apigee X.
informazioni

Questa sezione descrive la versione 4.19.06 del rilascio delle funzionalità Edge per Cloud privato.

Riepilogo della release

La tabella riportata di seguito riassume le modifiche apportate a questa release:

Nuove funzionalità

Questa release include le nuove funzioni seguenti:

○ Supporto LDAP per SSO
○ Supporto del deployment HTTP
○ Analisi modulare
○ Supporto del rack Cassandra
○ Supporto IPv6
○ Installazione dell'esperienza New Edge semplificata
○ Escludi transazioni INVALID_TSC (monetizzazione)

Per maggiori informazioni su ciascuna di queste nuove funzionalità, consulta la sezione Nuove funzionalità.

Compatibilità con le versioni precedenti

In questa versione di Apigee Edge per Private Cloud sono stati introdotti i seguenti problemi relativi alla compatibilità con le versioni precedenti:

     
  • A causa della correzione del problema 132443137 (come descritto nelle note di rilascio del cloud pubblico 19.03.01), i processori di messaggi ora ignorano le intestazioni che iniziano con X-Apigee-*. Di conseguenza, devi refactoring di qualsiasi codice che utilizza le intestazioni X-Apigee-* e sostituire queste intestazioni con altre supportate.

  • Il nome dei file di log Cassandra è stato modificato. Ora è:

    /opt/apigee/var/log/apigee-cassandra/system.log
Release incluse

Dalla versione precedente della funzionalità Edge for Private Cloud, sono state apportate le seguenti release che sono incluse in questa release:

○ 1.1.1.1.1:
   19.07.23 (UI)
   19.03.01
   19.02.19
   19.02.04
   19.01.23
   19.01.1418.12.0418.08.3118.07.31
○ Portale:
   19.07.08
   19.05.23
   19.05.08
   19.04.18
   19.03.20
   19.02.2719.02.2119.02.0419.01.16
Pensionati Nessuno
Deprecazioni

Con la release 4.19.06, sono deprecate le seguenti funzionalità:

  • 4.18.01: la versione 4.18.01 di Apigee Edge per il cloud privato è ora deprecata.

Per ulteriori informazioni, consulta la pagina relativa a ritiri, ritiri e modifiche al CPS di Apigee.

Correzioni di bug

Questa release include le seguenti correzioni di bug:

○ Errori di UseStringDeduplicate con JMX (140270474) (140270474)
○ Errori di MP (111445518)
○ Errori di Cassandra con JMX (113342838)
○ Errori di backup a 13 nodi (138931337) (138931337)
○ Prox1 con lo stesso






HEAD

Per ulteriori informazioni su ciascuna di queste correzioni, vedi Correzioni di bug.

Problemi noti

Questa release include i seguenti problemi noti:

○ Le transazioni di backup di mint non vengono valutate inizialmente (141628497)
○ Perdita di memoria dei server di valutazione mint (137865184) (137865184)
○ Formato file di metadati per l'installazione apigee-sso (135616498)
apigee-monit non supportato su Amazon Linux 1 (122370980)



Per ulteriori informazioni su ciascuno di questi problemi noti, incluse le soluzioni alternative, consulta la pagina Problemi noti.

Percorsi di upgrade

La tabella seguente mostra i percorsi di upgrade per questa release:

From 4.19.01 Direttamente eseguito l'upgrade dal 19.4.01 → 4.19.06
Dal 18.4.05 Direttamente eseguito l'upgrade dal 18.4.05 → 4.19.06
Dal 18.4.01 Direttamente eseguito l'upgrade dal 18.4.01 → 4.19.06

Nuove funzionalità

In questa sezione sono elencate le nuove funzionalità presenti in questa release. Inoltre, questa release include tutte le funzionalità delle release per UI Edge, Edge Management e Portal elencate nella sezione Release incluse.

Oltre ai miglioramenti riportati di seguito, questa release contiene anche diversi miglioramenti a livello di usabilità, prestazioni, sicurezza e stabilità.

Supporto per il deployment HTTP

Per impostazione predefinita, Edge utilizza la RPC per il deployment dei proxy API. Sebbene questa modalità funzioni molto bene per la maggior parte delle installazioni, le topologie più grandi con molti MP potrebbero riscontrare timeout quando un numero elevato di chiamate simultanee viene effettuato tramite RPC.

Di conseguenza, Apigee consiglia ai deployment di dimensioni maggiori di utilizzare HTTP anziché RPC per il deployment. Ora è supportata l'abilitazione dei deployment HTTP.

Per maggiori informazioni, consulta Abilitare il deployment HTTP.

Supporto del rack Cassandra

Apigee ora fornisce indicazioni generali per le operazioni di scalabilità di Cassandra rendendo quest'ultima su Apigee Edge per il rack cloud privato.

Per maggiori informazioni, consulta la pagina Supporto rack Cassandra.

Analisi modulare

Per impostazione predefinita, i dati di analisi raccolti dal processore di messaggi vengono caricati in Qpid e Postgres per l'elaborazione. Potrai quindi visualizzare i dati di analisi nell'interfaccia utente Edge.

Con questa release di funzionalità, puoi configurare il processore di messaggi in modo che scriva i dati di analisi su disco oppure puoi scegliere di utilizzare entrambe le opzioni.

Per maggiori informazioni, consulta Scrittura di dati di analisi in un file.

Installazione semplificata dell'esperienza New Edge

L'installazione dell'esperienza New Edge è stata semplificata con un nuovo script.

Per maggiori informazioni, vedi Installare la nuova esperienza Edge.

Supporto dell'IdP LDAP

L'autenticazione degli utenti con chiamate Edge UI e API Edge Management ora supporta LDAP oltre a SAML. Il supporto LDAP include metodi di associazione diretta e indiretta.

Per maggiori informazioni, consulta la pagina Panoramica dell'autenticazione IdP esterna.

Supporto IPv6

Per impostazione predefinita, tutte le chiamate API di runtime ad Apigee Edge per il cloud privato utilizzano IPv4. Puoi aggiungere il supporto IPv6 al router con una nuova proprietà.

Per maggiori informazioni, consulta Utilizzare IPv6 sul router.

Escludi transazioni INVALID_TSC (monetizzazione)

Ora puoi escludere l'aggiunta di transazioni INVALID_TSC al database Postgres quando utilizzi la monetizzazione.

Per maggiori informazioni, consulta la sezione Proprietà del server di monetizzazione.

Software supportato

Questa release include le seguenti modifiche al software supportato:

Supporto aggiunto Non più supportato

In questa release è stato aggiunto il supporto delle seguenti piattaforme:

  • Red Hat Enterprise Linux (RHEL) 6.10
  • CentOS 6.10
  • Oracle Linux 6.9

Le seguenti piattaforme non sono più supportate con questa release:

  • Red Hat Enterprise Linux (RHEL) 6.9
  • CentOS 6.9
  • Oracle 6.8

Per un elenco completo delle piattaforme supportate, vedi Software supportato e versioni supportate.

Correzioni di bug

In questa sezione sono elencati i bug del cloud privato risolti in questa release. Inoltre, questa release include tutte le correzioni di bug relative alle versioni Edge UI, Edge Management e Portal mostrate in Release incluse.

ID problema Descrizione
140270474

UseStringDeduplicate non impostato

Impossibile impostare UseStringDeduplication per i componenti edge-message-processor negli ambienti di produzione.
111445518

Errori MP

I processori di messaggi hanno registrato continuamente il seguente messaggio di errore ogni 5 minuti:
2019-06-29 00:02:05,775 Apigee-Timer-6 ERROR CMgmt -
  ConnectorServiceImpl.refreshToken() : Connector Management API auth token
  generation failed: 0 null
113342838

Errori di Cassandra con JMX

Le operazioni Cassandra non funzionavano quando l'autenticazione JMX era abilitata
138931337

Upgrade per 13 nodi

Gli aggiornamenti delle installazioni a 13 nodi dalla versione 17.09, 18.01 e 18.05 non riuscivano.
119802562

proxy con lo stesso nome

Se due utenti della stessa organizzazione hanno creato proxy con gli stessi nomi, il secondo creato sovrascriverà il primo. Questo si è verificato solo quando utenti diversi non potevano vedere l'altro proxy.
118851790

Gli archivi chiavi non vengono caricati

Se per un'organizzazione/un ambiente erano presenti più di 100 archivi chiavi, l'archivio chiavi e la sezione di riferimento nella UI Edge non venivano caricati. L'interfaccia utente mostrava invece un errore Internal Error (Error Fetching Keystores).
110988191

Analisi non riuscita

L'analisi non è riuscita per un ambiente quando viene fornito con dati dal Microgateway che erano impostati su una data futura.
110785400

Errori di backup

ZooKeeper, Cassandra e OpenLDAP a intermittenza non sono riusciti a eseguire correttamente il backup dei loro dati con il seguente errore: File changed as we read it.
79993247

Richieste di HEAD a Node.js

HEAD richieste a una destinazione Node.js potrebbero bloccarsi, il che lasciava le connessioni in attesa.
70291825

Backup/ripristino di Apigee-postgres

L'esecuzione di un backup/ripristino apigee-postgres ora esegue il backup dei dati di tutti i componenti.
65737520

Reimpostazione della password dell'amministratore di sistema

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

Problemi noti

Nella tabella seguente sono elencati i problemi noti di questa release:

ID problema Descrizione
141628497

Iniziale a non valutare le transazioni

Edge per il cloud privato non valuta le transazioni inizialmente quando abiliti la monetizzazione per la prima volta per un'organizzazione. Questo vale sia per le organizzazioni nuove che per quelle esistenti.

L'API di abilitazione della monetizzazione risponde con l'ID job e, al completamento, lo stato del job indicherà l'esito positivo. Tuttavia, tutte le chiamate API monetizzate effettuate all'inizio non verranno elaborate dalla monetizzazione e non saranno valutate. Queste transazioni verranno visualizzate solo nelle normali analisi.

Soluzione:

Riavvia eventuali processori di messaggi (MP). Puoi procedere come segue:
apigee-service edge-message-processor restart

Dopo aver abilitato la monetizzazione, il riavvio dei file MP fa sì che Edge carichi la configurazione da ZooKeeper all'avvio. Questo accade a ogni riavvio, il che significa che il problema si applica solo all'inizio.

137865184

Mint di perdita di memoria dei server di valutazione

Quando una nuova istanza Qpid viene registrata in un mxgroup, le code vengono create senza consumer, il che fa aumentare la profondità della coda fino a quando non utilizza tutte le risorse disponibili.

Soluzione:

Nessuna.
135616498

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
122370980

apigee-monit non supportato su Amazon Linux 1

Soluzione:

Nessuna.
121095148

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.

76087166

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.

68722102

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:

Nessuna.

Passaggio successivo

Per iniziare a utilizzare Edge per Private Cloud 4.19.06, utilizza i link seguenti:

Nuove installazioni:
Panoramica della nuova installazione
Installazioni esistenti:
Percorsi di upgrade