Versionshinweise zu 4.50.00 Edge for Private Cloud

Sie lesen gerade die Dokumentation zu Apigee Edge.
Apigee X-Dokumentation aufrufen.
info

In diesem Abschnitt wird die Version 4.50.00 des Edge for Private Cloud-Feature-Release beschrieben.

Zusammenfassung der Version

In der folgenden Tabelle sind die Änderungen in dieser Version zusammengefasst:

Neue Funktionen

Diese Version enthält die folgenden neuen Funktionen:

○ Informationen zur TLS-Verbindung sind jetzt in API-Proxys verfügbar
○ Zookeeper-Upgrade
○ Verfügbarkeit des Drupal 8-Portals und EOL von Drupal 7

Weitere Informationen zu den einzelnen neuen Funktionen finden Sie unter Neue Funktionen.

Abwärtskompatibilität In dieser Version von Apigee Edge for Private Cloud wurden die folgenden Probleme eingeführt, die sich auf die Abwärtskompatibilität auswirken:
     
  • Aufgrund der Korrektur für Problem 132443137 (wie in den Versionshinweisen für die öffentliche Cloud vom 19.03.01 beschrieben) ignorieren Message Processors jetzt Header, die mit X-Apigee-* beginnen. Daher müssen Sie jeden Code, in dem X-Apigee-*-Header verwendet werden, umgestalten und diese Header durch unterstützte Header ersetzen.
  • Der Name der Cassandra-Logdateien hat sich geändert. Jetzt:

    /opt/apigee/var/log/apigee-cassandra/system.log
Enthaltene Releases

Seit dem letzten Edge for Private Cloud-Feature-Release sind die folgenden Releases erfolgt, die in diesem Release enthalten sind:

○ Edge:
   20.04.06 (Laufzeit, API-Verwaltung, Monetarisierungsverwaltung)
   20.03.27 (Benutzeroberfläche)
   20.03.16 (Edge-Analyse)
   20.03.11 (Benutzeroberfläche)
   20.02.27 (API-Monitoring)
   20.02.24 (Benutzeroberfläche)
   20.02.03 (API-Monitoring)
   20.01.29 (Benutzeroberfläche)
   20.01.22 (Benutzeroberfläche)
   20.01.06 (API-Verwaltung/Laufzeit)
○ Edge (Fortsetzung):
   20.01.06 (UI)
   19.11.13 (API Security Reporting)
   19.10.01 (UI)
   19.09.26 (Edge UI/Portal)
   19.08.27 (UI)
   19.08.15 (API Security Reporting)
   19.07.29 (UI)
○ Portal:
   20.05.27.00
   20.04.13.00
   20.03.20.00
   19.12.20.00
   19.11.21.00
   19.09.25.00
Einstellungen Keine
Verworfene Produkte/Funktionen

Mit der Veröffentlichung von Version 4.50.00:

  • 4.18.05::Version 4.18.05 von Apigee Edge for Private Cloud wurde eingestellt.

In dieser Version eingestellte Funktionen:

  • Unterstützung für Node.js-Proxys und Secure Vaults
  • Unterstützung für OAuth v1-Richtlinien
  • Unterstützung für die Richtlinie zur gleichzeitigen Ratenbegrenzung
  • Unterstützung für den Apigee-Adapter für Istio
  • Unterstützung für die Teams-Vorabzugriffsfunktion

Weitere Informationen zu den Einstellungen, einschließlich der Zeitpläne für die Entfernung, finden Sie unter Einstellungen und Außerbetriebnahmen von Apigee.

Fehlerkorrekturen

Diese Version enthält die folgenden Fehlerkorrekturen:

○ Der Message Processor kann Umgebungen nicht laden, wenn Keystores mit ähnlichen Namen oder Aliasen konfiguriert sind. (154428338)
○ QPid-Abhängigkeitskonflikt bei der Installation des Patches (152574421)
○ Cache-Speicherbegrenzung berücksichtigt nicht die maximale L1-Cache-Größe (151449163)
○ Fehler bei Sicherungsskripts (150710952)
○ QPid-Server sendet zusätzliche Log-Nachrichten (148231209)
○ Bei der Sicherung von Postgresql werden keine SSO-Informationen gespeichert (147458330)
○ apigee-nginx-Version wurde nicht aktualisiert. (146872858)
○ Meldung „Neue Benutzeroberfläche ausprobieren“ wird nicht mehr angezeigt (145419621)
○ Apigee SmartDocs API-Sicherheitslücke (145340106)
○ Fehler beim Postgres-Sicherungsskript (145254693)
○ Verschiedene Sicherheitskorrekturen (142150706)
○ Hohe Anzahl von Router-Timeouts für Message Processor (138107618)
○ Fehler beim SSO-Einrichtungsskript (135616498)
○ JMX-Ports (132044907)
○ Zeitweise 404-Fehler für Laufzeittraffic aufgrund von Race-Bedingung (130653816)
○ OpenLDAP-Beschädigung während des Upgrades (120799182)
○ DataAccessException in Konfigurationen mit mehreren Rechenzentren (76087166)
○ FormatMessage auf „false“ in der MessageLogging-Richtlinie funktioniert nicht (68722102)

Weitere Informationen zu den einzelnen Korrekturen finden Sie unter Fehlerkorrekturen.

Bekannte Probleme

Diese Version weist die folgenden bekannten Probleme auf:

○ JWT-Validierung fehlgeschlagen (159788170)
○ Speicherleck auf Mint-Bewertungsservern (137865184)
○ apigee-monit wird unter Amazon Linux 1 nicht unterstützt (122370980)
○ Beim Sichern des Message Processor werden nicht die richtigen Dateien gesichert (121095148)
○ Erhöhte Cache-Fehlerrate nach dem Upgrade (160109014)
○ HTTP 408-Antwort für GET-Anfrage mit leerem Body und Content-Encoding: gzip. (159858015)

Weitere Informationen zu den einzelnen bekannten Problemen, einschließlich Problemumgehungen, finden Sie unter Bekannte Probleme.

Upgrade-Pfade

In der folgenden Tabelle sind die Upgrade-Pfade für diese Version aufgeführt:

Ab Version 4.19.01 oder 4.19.06 Direktes Upgrade von 4.19.01/4.19.06 auf 4.50.00
Ab 4.18.05 Direktes Upgrade von 4.18.05 auf 4.50.00

Neue Funktionen

In diesem Abschnitt werden die neuen Funktionen in dieser Version aufgeführt. Außerdem enthält diese Version alle Funktionen der Edge-Benutzeroberfläche, von Edge Management und von Portal-Releases, die unter Enthaltene Releases aufgeführt sind.

Neben den folgenden Verbesserungen enthält diese Version auch zahlreiche Verbesserungen in Bezug auf Benutzerfreundlichkeit, Leistung, Sicherheit und Stabilität.

TLS-Verbindungsinformationen jetzt in API-Proxys verfügbar

Bei einer Anfrage an einen API-Proxy über einen virtuellen Host, der TLS unterstützt, kann Edge Informationen zur TLS-Verbindung erfassen. Ihr API-Proxy kann jetzt über Ablaufvariablen auf diese Informationen zugreifen, um zusätzliche Analysen und Validierungen durchzuführen. Weitere Informationen finden Sie unter Zugriff auf TLS-Verbindungsinformationen in einem API-Proxy.

Zookeeper-Upgrade

Diese Version enthält Zookeeper 3.4.14.

Verfügbarkeit des Drupal 8-Portals und EOL von Drupal 7

Drupal 8 hat Drupal 7 als von Apigee empfohlenes Entwicklerportal für Private Cloud abgelöst. Da der Langzeit-Support für Drupal 7 im November 2021 endet, werden die Apigee-Module für Drupal 7 ab November 2021 nicht mehr unterstützt. Die Installations-/Upgradeskripts für Drupal 7 sind zwar noch verfügbar, sollten aber nicht mehr verwendet werden. Sie werden in einer zukünftigen Version entfernt.

Informationen zu den Drupal 8-Modulen, die in Apigee integriert werden, finden Sie unter Portal mit Drupal 8 erstellen.

Unterstützte Software

Diese Version enthält die folgenden Änderungen an der unterstützten Software:

Unterstützung hinzugefügt Nicht mehr unterstützt

In dieser Version werden die folgenden Plattformen unterstützt:

  • Red Hat Enterprise Linux (RHEL) 7.8
  • CentOS 7.8
  • Oracle Linux 7.8

Die folgenden Plattformen werden mit diesem Release nicht mehr unterstützt:

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

Eine vollständige Liste der unterstützten Plattformen finden Sie unter Unterstützte Software und unterstützte Versionen.

Fehlerkorrekturen

In diesem Abschnitt sind die Fehler in Private Cloud aufgeführt, die in diesem Release behoben wurden. Außerdem enthält diese Version alle Fehlerkorrekturen in den Versionen der Edge-Benutzeroberfläche, Edge Management und des Portals, die unter Enthaltene Versionen aufgeführt sind.

Problem-ID Beschreibung
154428338

Message Processor kann keine Umgebungen laden, wenn Keystores mit ähnlichen Namen oder Aliasen konfiguriert sind.

Wir haben einen Konflikt bei der Suche mit regulären Ausdrücken behoben, der beim Laden von Keystores mit ähnlicher Namenskonvention aufgetreten ist. Dadurch konnte der Message Processor keine Umgebungen laden, die mit dem Keystore verknüpft sind, oder nicht starten, wenn bei der Suche mehrere in Konflikt stehende Keystores zurückgegeben wurden.
152574421

QPid-Abhängigkeitskonflikt bei der Installation des Patches

Die richtige Version von QPid ist jetzt installiert.
151449163

Cache-Speicherbegrenzer berücksichtigt nicht die maximale L1-Cache-Größe

Der Cache-Speicherbegrenzer berücksichtigt jetzt die maximale L1-Cachegröße.
150710952

Fehler bei Sicherungsskripten

Das Sicherungsverfahren wurde auf Grundlage der aktualisierten Sicherungsskripts aktualisiert.
148231209

QPid-Server sendet zusätzliche Protokollmeldungen

Der QPid-Server sendet keine zusätzlichen Log-Nachrichten mehr.
147458330

Bei der Sicherung von Postgresql werden keine SSO-Informationen gespeichert

In Postgresql-Sicherungen werden jetzt SSO-Informationen gespeichert.
146872858

Die apigee-nginx-Version wurde nicht aktualisiert.

Die apigee-nginx-Version wurde jetzt korrekt aktualisiert.
145419621

Meldung „Neue UI ausprobieren“ wird nicht mehr angezeigt

Die Meldung „Neue Benutzeroberfläche ausprobieren“ wird in der Benutzeroberfläche nicht mehr angezeigt.
145340106

Apigee SmartDocs API Vulnerability

Der Apigee SmartDocs-Proxy wurde aktualisiert, um eine Sicherheitslücke zu schließen. Weitere Informationen und erforderliche Schritte finden Sie in der SmartDocs-Installationsanleitung.
145254693

Postgres-Sicherungsscript schlägt fehl

Das Postgres-Sicherungsskript funktioniert jetzt richtig.
142150706

Verschiedene Sicherheitskorrekturen

Behebungen von Sicherheitsproblemen, einschließlich #111390246.
138107618

Hohe Rate von Zeitüberschreitungen bei der Kommunikation zwischen Router und Message Processor

Der Fehler wurde bereits behoben.
135616498

Fehler beim Setupscript für SSO

Ein Problem wurde behoben, bei dem die Verwendung von file-scheme-URLs dazu führte, dass das SSO-Einrichtungsskript fehlschlug.
132044907

JMX-Ports

JMX-Ports sollten nicht für den externen Zugriff, sondern nur für interne Server geöffnet sein.
130653816

Zeitweise 404-Fehler für Laufzeittraffic aufgrund von Race-Bedingung

Es wurde ein Race Condition-Problem während des MP-Bootstrapping behoben, das dazu führte, dass einige Proxys nicht richtig bereitgestellt wurden.
120799182

OpenLDAP-Beschädigung während des Upgrades

Der Fehler wurde bereits behoben.
76087166

DataAccessException in Konfigurationen mit mehreren Rechenzentren

Wenn in Konfigurationen mit mehreren Rechenzentren ein Datenspeicher nicht mehr verfügbar ist, wird der Fehler „DataAccessException“ nicht mehr angezeigt.
68722102

„FormatMessage“ in der MessageLogging-Richtlinie auf „false“ gesetzt, funktioniert nicht

Sie können „FormatMessage“ jetzt in der MessageLogging-Richtlinie auf „false“ setzen.

Bekannte Probleme

In der folgenden Tabelle sind bekannte Probleme in dieser Version aufgeführt:

Problem-ID Beschreibung
159788170

JWT-Validierung schlägt fehl

Die JWT-Validierung schlägt für RSA-Schlüssel fehl, die kleiner als 2.048 Bit sind.

Workaround:

Ihre Schlüssel müssen mindestens 2.048 Bit lang sein.
137865184

Speicherleck auf Mint-Bewertungsservern

Wenn eine neue Qpid-Instanz in einer mxgroup registriert wird, werden die Warteschlangen ohne Verbraucher erstellt. Dadurch wächst die Warteschlangentiefe, bis alle verfügbaren Ressourcen genutzt werden.

Workaround:

Keine.
122370980

apigee-monit wird unter Amazon Linux 1 nicht unterstützt

Workaround:

Keine.
121095148

Backup des Message Processors sichert nicht den richtigen Satz von Dateien.

Workaround:

Führen Sie die Sicherung ein zweites Mal aus. Es sollten dann die richtigen Dateien gesichert werden.

160109014

Höhere Cache-Fehlerrate nach dem Upgrade

Nach dem Upgrade auf Version 4.50.00 kann es bei Proxys zu einer erhöhten Cache-Fehlerrate kommen. Diese Auslassungen können mit vermehrten Fehlermeldungen in den MP-Protokollen einhergehen, die etwa so aussehen:

InvalidClassException when fetching cps cache entry from second level - com.apigee.jsonparser.LinkedJSONObject; local class incompatible: stream classdesc serialVersionUID = -8575741446425131573, local class serialVersionUID = 752634431212433936. Considering it as cache miss.

Workaround:

Keine. Die Cache-Trefferquote sollte sich im Laufe der Zeit stabilisieren.

159858015

HTTP 408-Antwort für GET-Anfrage mit leerem Text und Content-Encoding: gzip.

Ein API-Client erhält eine 408-Timeout-Antwort, wenn er eine GET-Anfrage mit dem Header Content-Encoding: gzip und einem leeren Anfragebody sendet.

Workaround:

Lassen Sie den Content-Encoding-Header bei GET-Anfragen mit einem leeren Textkörper weg.

Nächster Schritt

Verwenden Sie die folgenden Links, um mit Edge for Private Cloud 4.50.00 zu beginnen:

Neuinstallationen:
Neuinstallation – Übersicht
Vorhandene Installationen:
Upgradepfade