Note di rilascio di Edge per Private Cloud 4.19.06

Stai visualizzando la documentazione di Apigee Edge.
Vai alla sezione Documentazione di Apigee X.
Informazioni

Questa sezione descrive la versione 4.19.06 della release delle funzionalità di Edge per il 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 per l'implementazione HTTP
○ Analisi integrabili
○ Supporto rack Cassandra
○ Supporto IPv6
○ Installazione semplificata della nuova esperienza Edge
○ Escludi INVALID_TSC transazioni (monetizzazione)

Per ulteriori informazioni su ciascuna di queste nuove funzionalità, vedi Nuove funzionalità.

Compatibilità con le versioni precedenti

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

     
  • A causa della correzione del problema 132443137 (come descritto il pubblico del 19/03/01 Cloud Storage), i processori di messaggi ora ignorano le intestazioni che iniziano con X-Apigee-*. Di conseguenza, è necessario eseguire il refactoring di qualsiasi codice che utilizza X-Apigee-* e sostituiscile con quelle supportate.

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

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

Dalla precedente release delle funzionalità Edge per il cloud privato, le seguenti release si sono verificati e sono inclusi 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
○ Portale:
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
Pensioni Nessuno
Deprecazioni

Con la versione 4.19.06, i seguenti elementi sono stati deprecati:

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

Per ulteriori informazioni, vedi Ritiri, ritiri e CPS di Apigee modifiche.

Correzioni di bug

Questa release include le seguenti correzioni di bug:

○ UseStringDe deduplicazione non impostata (140270474)
○ Errori MP (111445518)
○ Errori di Cassandra con JMX (113342838)
○ Upgrade di 13 nodi (138931337)
○ Proxy con lo stesso nome (119802562)
○ Gli archivi chiavi non vengono caricati (118851790)
○ Analisi non riuscita (110988191)
○ Errori di backup (110785400)
○ Richieste HEAD a Node.js (79993247)
○ apigee-postgres backup/restore (70291825)
○ Reimpostazione della password di amministratore di sistema (65737520)

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

Problemi noti

Questa release include i seguenti problemi noti:

○ Transazioni iniziali senza valutazione (141628497)
○ Perdita di memoria dei server di classificazione Ment (137865184)
○ Formato file di metadati per installazione apigee-sso (135616498)
apigee-monit non supportato su Amazon Linux 1 (122370980)
○ Il backup del processore di messaggi non esegue il backup del set di file corretto (121095148)
○ DataAccessEccezioni nelle configurazioni di più data center (76087166)
○ Criterio MessageLogging, incluse 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:

Dal 19/04/01 Upgrade diretto dal 19/04/01 → 19/04/06
Dal 18/04/05 Upgrade diretto dal 18/04/05 → 19/04/06
Dal 18.4.01 Upgrade diretto dal 18/04/01 → 19/04/06

Nuove funzionalità

In questa sezione sono elencate le nuove funzioni di questa release. Inoltre, questa release include tutti dell'interfaccia utente di Edge, di Edge Management e delle release del portale elencate in Release incluse.

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

Supporto deployment HTTP

Per impostazione predefinita, Edge utilizza RPC per il deployment dei proxy API. Questa modalità funziona molto bene per la maggior parte di grandi dimensioni, le topologie più grandi con molti MP potrebbero subire timeout le chiamate simultanee vengono effettuate tramite RPC.

Di conseguenza, Apigee consiglia di utilizzare HTTP anziché RPC per i deployment più grandi e deployment continuo. Ora è supportata l'abilitazione dei deployment HTTP.

Per ulteriori informazioni, consulta Abilitare HTTP deployment.

Supporto rack Cassandra

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

Per ulteriori informazioni, vedi Supporto rack Cassandra.

Analisi collegabile

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

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

Per ulteriori informazioni, vedi Scrittura di dati di analisi in un file.

Installazione semplificata della nuova esperienza Edge

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

Per ulteriori informazioni, vedi Installare la nuova esperienza Edge.

Supporto IdP LDAP

L'autenticazione degli utenti con le chiamate alla UI perimetrale e all'API di gestione perimetrale ora supporta LDAP in oltre a SAML. Il supporto LDAP include i metodi di associazione diretta e indiretta.

Per ulteriori informazioni, consulta la Panoramica delle Autenticazione IdP.

Supporto IPv6

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

Per ulteriori informazioni, consulta la sezione Utilizzare IPv6 sulla il router.

Escludi INVALID_TSC transazioni (monetizzazione)

Ora puoi escludere INVALID_TSC transazioni dall'aggiunta a Postgres quando si utilizza la monetizzazione.

Per ulteriori informazioni, consulta la sezione Monetizzazione proprietà del server.

Software supportato

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, vedi Software supportati e versioni supportate.

Correzioni di bug

In questa sezione sono elencati i bug del cloud privato risolti in questa release. Inoltre, questo include tutte le correzioni di bug nell'UI di Edge, in Edge Management e nelle release del portale mostrate in Release incluse.

ID problema Descrizione
140270474

UseStringDeDuplicazione non impostato

UseStringDeduplication non era preparazione dei componenti edge-message-processor in produzione ambienti cloud-native.
111445518

Errori MP

I processori di messaggi registrano 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 di Cassandra non funzionavano quando era abilitata l'autenticazione JMX
138931337

Upgrade a 13 nodi

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

Proxy con lo stesso nome

Se due utenti della stessa organizzazione hanno creato proxy con gli stessi nomi, il secondo creato sovrascriverebbe il primo. Ciò si è verificato solo quando diversi utenti non sono riusciti a vedere l'altro proxy.
118851790

Gli archivi chiavi non vengono caricati

Se per un'organizzazione/ambiente erano più di 100 gli archivi chiavi, nella UI di Edge non veniva caricata. Invece, la UI mostrava un errore Internal Error (Error Fetching Keystores).
110988191

Analisi non riuscita

L'analisi non è riuscita per un ambiente quando viene fornito con i dati del Microgateway che era impostata su una data futura.
110785400

Errori di backup

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

Richieste HEAD a Node.js

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

Backup/restore Apigee-postgres

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

Reimpostazione della password di sysadmin

Reimpostazione della password dell'amministratore di sistema per il server di gestione che conteneva una password speciale non riuscirebbero.

Problemi noti

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

ID problema Descrizione
141628497

Inizialmente senza effettuare valutazioni sulle transazioni

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

L'API di abilitazione della monetizzazione risponde con l'ID job e, al termine, lo stato del job indicherà che l'operazione è riuscita. Tuttavia, le chiamate API monetizzate effettuate inizialmente non saranno elaborate dalla monetizzazione e non saranno valutate. Queste transazioni verranno visualizzate solo nelle analisi standard.

Soluzione:

Riavvia gli eventuali processori di messaggi (MP), procedendo nel seguente modo:
apigee-service edge-message-processor restart

Una volta attivata la monetizzazione, il riavvio del 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

Perdita di memoria dei server di valutazione mint

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

Soluzione:

Nessuno.
135616498

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

Soluzione:

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

  • Aggiungi un CRLF alla fine del file metadata.xml

    OPPURE

  • Utilizza una posizione basata su URL per i metadati
122370980

apigee-monit non supportato su Amazon Linux 1

Soluzione:

Nessuno.
121095148

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

Soluzione:

Esegui il backup una seconda volta. Il backup dovrebbe essere del set di file corretto.

76087166

DataAccessException in più configurazioni di data center

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

DataAccessException: Error while accessing datastore;
Please retry later

Il risultato è che il server di gestione potrebbe non avviarsi perché sta tentando di connettersi a Cassandra in dc-1 e dc-2. DataAccessExceptions si verifica se un nodo Cassandra è verso il basso. Ciò potrebbe causare un'interruzione del traffico delle API, per le quali i processori di messaggi segnalano DataAccessExceptions durante il tentativo di recuperare le KVM.

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

Soluzione alternativa

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

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

Per annullare la registrazione e ripetere la registrazione di questi tipi di nodi Cassandra:

  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 della tua piattaforma Apigee .
    • MS_IP e MS_PORT sono l'indirizzo IP e la porta del server di gestione numero.
    • REGION è il nome del data center in cui si trova il server di gestione individuarlo.
    • GATEWAY_POD è il nome del pod, che per impostazione predefinita è "gateway". Potresti avere è stato rinominato diversamente, quindi controlla l'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. Le utilizzerai per annullare la registrazione dei nodi.

  2. Ripeti il primo passaggio per ciascun tipo di nodo Cassandra: kms-datastore. dc-datastore e keyvaluemap-datastore. Prendi nota delle 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 di nuovo i nodi utilizzando il comando seguente:
    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 un impatto sul cluster Cassandra. Per ulteriori informazioni su questi comandi, vedi Aggiorna le registrazioni dei datastore.

68722102

Criterio MessageLogging, incluse 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 include comunque le seguenti informazioni:

  • Il punteggio di priorità
  • Il timestamp

Soluzione:

Nessuno.

Passaggio successivo

Per iniziare a utilizzare Edge per il cloud privato 4.19.06, usa i seguenti link:

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