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.

Release-Zusammenfassung

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

Neue Funktionen

Diese Version enthält die folgenden neuen Funktionen:

○ TLS-Verbindungsinformationen 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 Public 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. Sie lautet 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:
   06.04.20 (Laufzeit, API-Verwaltung, Monetarisierungsverwaltung)
   27.03.20 (Benutzeroberfläche)
   16.03.20 (Edge-Analyse)
   11.03.20 (Benutzeroberfläche)
   27.02.20 (API-Monitoring)
   24.02.20 (Benutzeroberfläche)
   03.02.20 (API-Monitoring)
   29.01.20 (Benutzeroberfläche)
   22.01.20 (Benutzeroberfläche)
   06.01.20 (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
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 ist jetzt veraltet.

Zu den Funktionen, die in dieser Version eingestellt wurden, gehören:

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

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

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-Speicherbegrenzer berücksichtigt nicht die maximale L1-Cache-Größe (151449163)
○ Fehler bei Sicherungsskripten (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 Zeitüberschreitungen zwischen Router und Message Processor (138107618)
○ Fehler beim SSO-Einrichtungsskript (135616498)
○ JMX-Ports (132044907)
○ Zeitweilige 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 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)
○ Bei der Sicherung des Message Processor werden nicht die richtigen Dateien gesichert (121095148)
○ Erhöhtes Cache-Fehlerratio nach dem Upgrade (160109014)
○ HTTP 408-Antwort für GET-Anfrage mit leerem Text 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 Upgradepfade für diesen Release 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 diesem Release aufgeführt. Außerdem enthält diese Version alle Funktionen der Edge-Benutzeroberfläche, der Edge-Verwaltung und der Portal-Releases, die unter Enthaltene Releases aufgeführt sind.

Zusätzlich zu den folgenden Verbesserungen enthält dieser Release auch mehrere Verbesserungen in Bezug auf Benutzerfreundlichkeit, Leistung, Sicherheit und Stabilität.

TLS-Verbindungsinformationen jetzt in API-Proxys verfügbar

Während einer Anfrage an einen API-Proxy über einen virtuellen Host, der TLS unterstützt, kann Edge Informationen über die 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 langfristige 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 und werden in einer zukünftigen Version entfernt.

Informationen zu den Drupal 8-Modulen, die in Apigee eingebunden 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 dieser Version 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 der Private Cloud aufgeführt, die in diesem Release behoben wurden. Außerdem enthält diese Version alle Fehlerkorrekturen in den Edge-UI-, Edge Management- und Portal-Releases, die unter Enthaltene Releases aufgeführt sind.

Problem-ID Beschreibung
154428338

Message Processor kann Umgebungen nicht 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 die maximale L1-Cache-Größe nicht

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

Fehler bei Sicherungsskripts

Das Sicherungsverfahren wurde auf Grundlage der aktualisierten Sicherungsskripts aktualisiert.
148231209

QPid-Server sendet zusätzliche Protokollnachrichten

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 UI ausprobieren“ wird in der Benutzeroberfläche nicht mehr angezeigt.
145340106

Apigee SmartDocs API-Sicherheitslücke

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 Sicherheitsupdates

Behebung 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 Datei-Schema-URLs dazu führte, dass das SSO-Einrichtungs-Script 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 die bekannten Probleme in diesem Release 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

Beim Sichern des Message Processors werden nicht die richtigen Dateien gesichert

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 einem erhöhten Verhältnis von Cache-Fehlern kommen. Diese Fehler können mit einer erhöhten Anzahl von Fehlermeldungen in den MP-Logs 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 wird sich voraussichtlich 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-Zeitüberschreitungsantwort, 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