Note di rilascio di Edge per Private Cloud 4.19.06

Stai visualizzando la documentazione di Apigee Edge.
Consulta la documentazione di Apigee X.
info

Questa sezione descrive la versione 4.19.06 della release delle funzionalità di Edge per Private Cloud.

Riepilogo della release

La seguente tabella riassume le modifiche apportate a questa release:

Nuove funzionalità

Questa release include le nuove funzionalità seguenti:

○ Supporto LDAP per SSO
○ Supporto per il deployment HTTP
○ Analytics plug-in
○ Supporto rack Cassandra
○ Supporto IPv6
○ Installazione semplificata della nuova esperienza Edge
○ Escludi transazioni INVALID_TSC (monetizzazione)

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

Compatibilità con le versioni precedenti

In questa versione di Apigee Edge for Private Cloud sono stati introdotti i seguenti problemi che influiscono sulla compatibilità con le versioni precedenti:

     
  • A causa della correzione del problema 132443137 (come descritto nelle note di rilascio di Public Cloud 19.03.01), i processori di messaggi ora ignorano le intestazioni che iniziano con X-Apigee-*. Di conseguenza, devi eseguire il refactoring di qualsiasi codice che utilizzi le intestazioni X-Apigee-* e sostituirle con quelle supportate.

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

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

Dall'ultima release delle funzionalità di Edge per il cloud privato, sono state rilasciate le seguenti versioni e sono incluse in questa release:

○ Edge:
   19.07.23 (UI)
   19.03.01
   19.02.19
   19.02.04
   19.01.23
   19.01.14
   18.12.04
   18.08.31
   18.07.31
○ Portal:
   19.07.08
   19.05.23
   19.05.08
   19.04.18
   19.03.20
   19.02.27
   19.02.21
   19.02.04
   19.01.16
Ritiri Nessuno
Ritiri

Con il rilascio della versione 4.19.06, i seguenti elementi sono obsoleti:

  • 4.18.01: la versione 4.18.01 di Apigee Edge for Private Cloud è ora ritirata.

Per saperne di più, consulta la sezione Deprecazioni, ritiri e modifiche di CPS di Apigee.

Correzioni di bug

Questa release include le seguenti correzioni di bug:

○ UseStringDeduplication non impostato (140270474)
○ Errori MP (111445518)
○ Errori di Cassandra con JMX (113342838)
○ Aggiornamenti di 13 nodi (138931337)
○ Proxy con lo stesso nome (119802562)
○ Keystore non caricati (118851790)
○ Errore di Analytics (110988191)
○ Errori di backup (110785400)
○ Richieste HEAD a Node.js (79993247)
○ Backup/ripristino di apigee-postgres (70291825)
○ Reimpostazione della password di sysadmin (65737520)

Per saperne di più su ciascuna di queste correzioni, consulta la sezione Correzioni di bug.

Problemi noti

Questa release include i seguenti problemi noti:

○ Mint non valuta inizialmente le transazioni (141628497)
○ Perdita di memoria dei server di valutazione Mint (137865184)
○ Formato del file di metadati per l'installazione di apigee-sso (135616498)
apigee-monit non supportato su Amazon Linux 1 (122370980)
○ Il backup del processore di messaggi non esegue il backup del set corretto di file (121095148)
○ DataAccessExceptions nelle configurazioni multi data center (76087166)
○ Policy MessageLogging che include informazioni aggiuntive nel messaggio di log (68722102)

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

Percorsi di upgrade

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

A partire dalla versione 4.19.01 Esegui l'upgrade diretto dalla versione 4.19.01 alla 4.19.06
A partire dalla versione 4.18.05 Esegui l'upgrade diretto dalla versione 4.18.05 alla 4.19.06
A partire dalla versione 4.18.01 Esegui l'upgrade diretto dalla versione 4.18.01 alla 4.19.06

Nuove funzionalità

Questa sezione elenca le nuove funzionalità di questa release. Inoltre, questa release include tutte le funzionalità delle release dell'interfaccia utente Edge, di Edge Management e del portale elencate in Release incluse.

Oltre ai seguenti miglioramenti, questa release contiene anche diversi miglioramenti di usabilità, prestazioni, sicurezza e stabilità.

Supporto per il deployment HTTP

Per impostazione predefinita, Edge utilizza 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 subire timeout quando viene effettuato un numero elevato di chiamate simultanee tramite RPC.

Di conseguenza, Apigee consiglia alle implementazioni più grandi di utilizzare HTTP anziché RPC per l'implementazione. L'attivazione dei deployment HTTP è ora supportata.

Per saperne di più, consulta Abilitare il deployment HTTP.

Supporto rack Cassandra

Apigee ora fornisce indicazioni generali per le operazioni di scalabilità di Cassandra rendendo Cassandra su Apigee Edge for Private Cloud consapevole del rack.

Per saperne di più, vedi Supporto rack Cassandra.

Analisi modulare

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

Con questa release della funzionalità, puoi configurare il processore di messaggi per scrivere i dati di analisi su disco oppure puoi scegliere di utilizzare entrambe le opzioni.

Per saperne di più, consulta Scrivere i dati di analisi in un file.

Installazione semplificata della nuova esperienza Edge

L'installazione della nuova esperienza Edge è stata semplificata con un nuovo script.

Per saperne di più, consulta Installare la nuova esperienza Edge.

Supporto IdP LDAP

L'autenticazione degli utenti con l'interfaccia utente Edge e le chiamate API di gestione Edge ora supporta LDAP oltre a SAML. Il supporto LDAP include metodi di binding diretto e indiretto.

Per saperne di più, consulta Panoramica dell'autenticazione IDP esterno.

Supporto IPv6

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

Per saperne di più, consulta Utilizzare IPv6 sul router.

Escludi transazioni INVALID_TSC (monetizzazione)

Ora puoi escludere le transazioni INVALID_TSC dall'aggiunta al database Postgres quando utilizzi la monetizzazione.

Per saperne di più, consulta Proprietà del server di monetizzazione.

Software supportati

Questa release include le seguenti modifiche al software supportato:

Supporto aggiunto Non più supportato

Questa release aggiunge il supporto per le 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, consulta Software e versioni supportati.

Correzioni di bug

Questa sezione elenca i bug di Private Cloud corretti in questa release. Inoltre, questa release include tutte le correzioni di bug nelle release dell'interfaccia utente Edge, di Edge Management e del portale mostrate in Release incluse.

ID problema Descrizione
140270474

UseStringDeduplication non impostato

UseStringDeduplication non veniva impostato 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 attivata
138931337

Upgrade di 13 nodi

Gli upgrade delle installazioni a 13 nodi dalle versioni 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. Ciò si verificava solo quando utenti diversi non riuscivano a vedere l'altro proxy.
118851790

Keystore non caricati

Quando erano presenti più di 100 keystore per un'organizzazione/un ambiente, la sezione keystore e riferimenti nell'interfaccia utente Edge non veniva caricata. L'interfaccia utente ha invece visualizzato un errore Internal Error (Error Fetching Keystores).
110988191

Analytics non riuscito

Analytics non è riuscito a elaborare i dati per un ambiente quando sono stati forniti dati di Microgateway impostati su una data futura.
110785400

Errori di backup

ZooKeeper, Cassandra e OpenLDAP non sono riusciti a eseguire il backup dei dati in modo intermittente a causa del seguente errore: File changed as we read it.
79993247

Richieste HEAD a Node.js

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

apigee-postgres backup/restore

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

Reimpostazione della password dell'amministratore di sistema

Il ripristino della password dell'amministratore di sistema per il server di gestione che conteneva caratteri speciali non andrebbe a buon fine.

Problemi noti

La tabella seguente elenca i problemi noti in questa release:

ID problema Descrizione
141628497

Mint non valuta inizialmente le transazioni

Edge for Private Cloud non valuta inizialmente le transazioni quando abiliti per la prima volta la monetizzazione per un'organizzazione. Questo vale per le organizzazioni nuove ed esistenti.

L'API per l'attivazione della monetizzazione risponde con l'ID job e, al termine, lo stato del job indicherà l'esito positivo. Tuttavia, le chiamate API monetizzate effettuate inizialmente non verranno elaborate dalla monetizzazione e non verranno valutate. Queste transazioni verranno visualizzate solo nelle analisi regolari.

Soluzione temporanea:

Riavvia tutti i Message Processor (MP), che possono essere riavviati con il seguente comando:
apigee-service edge-message-processor restart

Una volta attivata la monetizzazione, il riavvio dei processori di messaggi fa sì che Edge carichi la configurazione da ZooKeeper all'avvio. Questo si verifica a ogni riavvio, il che significa che il problema si applica solo inizialmente.

137865184

Perdita di memoria dei server di valutazione Mint

Quando una nuova istanza Qpid viene registrata in un gruppo mx, le code vengono create senza consumer, il che comporta un aumento della profondità della coda fino a quando non vengono utilizzate tutte le risorse disponibili.

Soluzione temporanea:

Nessuno.
135616498

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
122370980

apigee-monit non supportato su Amazon Linux 1

Soluzione temporanea:

Nessuno.
121095148

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.

76087166

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.

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

Nessuno.

Passaggio successivo

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

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