Versionshinweise zu 4.19.06 Edge für Private Cloud

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

In diesem Abschnitt wird die Version 4.19.06 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:

○ LDAP-Unterstützung für SSO
○ Unterstützung für HTTP-Bereitstellung
○ Einbindbare Analysen
○ Unterstützung für Cassandra-Racks
○ IPv6-Unterstützung
○ Vereinfachte Installation von New Edge
○ Ausschluss von INVALID_TSC-Transaktionen (Monetarisierung)

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:
   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
Einstellungen Keine
Verworfene Produkte/Funktionen

Mit der Veröffentlichung von Version 4.19.06 werden die folgenden Funktionen eingestellt:

  • 4.18.01::Version 4.18.01 von Apigee Edge for Private Cloud ist jetzt veraltet.

Weitere Informationen finden Sie unter Apigee-Einstellungen, ‑Außerbetriebnahmen und ‑CPS-Änderungen.

Fehlerkorrekturen

Diese Version enthält die folgenden Fehlerkorrekturen:

○ UseStringDeduplication nicht festgelegt (140270474)
○ MP-Fehler (111445518)
○ Cassandra-Fehler mit JMX (113342838)
○ Upgrades mit 13 Knoten (138931337)
○ Proxys mit demselben Namen (119802562)
○ Keystores werden nicht geladen (118851790)
○ Analytics-Fehler (110988191)
○ Sicherungsfehler (110785400)
○ HEAD-Anfragen an Node.js (79993247)
○ Sichern/Wiederherstellen von apigee-postgres (70291825)
○ Zurücksetzen des Sysadmin-Passworts (65737520)

Weitere Informationen zu den einzelnen Korrekturen finden Sie unter Fehlerkorrekturen.

Bekannte Probleme

Diese Version weist die folgenden bekannten Probleme auf:

○ Mint bewertet Transaktionen anfangs nicht (141628497)
○ Speicherleck auf Mint-Bewertungsservern (137865184)
○ Metadatendateiformat für die Installation von apigee-sso (135616498)
○ apigee-monit wird unter Amazon Linux 1 nicht unterstützt (122370980)
○ Bei der Sicherung des Message Processor werden nicht die richtigen Dateien gesichert (121095148)
○ DataAccessExceptions in Konfigurationen mit mehreren Rechenzentren (76087166)
○ MessageLogging-Richtlinie mit zusätzlichen Informationen im Logeintrag (68722102)

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 Direktes Upgrade von 4.19.01 auf 4.19.06
Ab 4.18.05 Direktes Upgrade von 4.18.05 auf 4.19.06
Ab 4.18.01 Direktes Upgrade von 4.18.01 auf 4.19.06

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.

Unterstützung für HTTP-Bereitstellung

Standardmäßig verwendet Edge RPC zum Bereitstellen von API-Proxys. Dieser Modus funktioniert für die meisten Installationen sehr gut. Bei größeren Topologien mit vielen MPs kann es jedoch zu Zeitüberschreitungen kommen, wenn eine große Anzahl gleichzeitiger Aufrufe über RPC erfolgt.

Daher empfiehlt Apigee, dass bei größeren Bereitstellungen HTTP anstelle von RPC verwendet wird. HTTP-Bereitstellungen werden jetzt unterstützt.

Weitere Informationen finden Sie unter HTTP-Bereitstellung aktivieren.

Cassandra-Rack-Unterstützung

Apigee bietet jetzt allgemeine Anleitungen zum Skalieren von Cassandra-Vorgängen, indem Cassandra auf Apigee Edge for Private Cloud Rack-fähig gemacht wird.

Weitere Informationen finden Sie unter Cassandra-Rack-Unterstützung.

Plug-in-Analysen

Standardmäßig werden die vom Message Processor erhobenen Analysedaten zur Verarbeitung in Qpid und Postgres hochgeladen. Sie können die Analysedaten dann in der Edge-Benutzeroberfläche ansehen.

Mit dieser neuen Funktion können Sie den Message Processor so konfigurieren, dass Analysedaten auf die Festplatte geschrieben werden. Sie können auch beide Optionen verwenden.

Weitere Informationen finden Sie unter Analysedaten in eine Datei schreiben.

Vereinfachte Installation von New Edge

Die Installation der neuen Edge-Oberfläche wurde durch ein neues Script vereinfacht.

Weitere Informationen finden Sie unter New Edge Experience installieren.

LDAP-IdP-Unterstützung

Die Authentifizierung von Nutzern mit Edge-UI- und Edge-Management-API-Aufrufen unterstützt jetzt neben SAML auch LDAP. Die LDAP-Unterstützung umfasst sowohl direkte als auch indirekte Bindungsmethoden.

Weitere Informationen finden Sie unter Übersicht über die Authentifizierung mit externen Identitätsanbietern.

IPv6-Unterstützung

Standardmäßig wird für alle Laufzeit-API-Aufrufe an Apigee Edge for Private Cloud IPv4 verwendet. Sie können dem Router mit einer neuen Property IPv6-Unterstützung hinzufügen.

Weitere Informationen finden Sie unter IPv6 auf dem Router verwenden.

INVALID_TSC-Transaktionen ausschließen (Monetarisierung)

Sie können jetzt INVALID_TSC-Transaktionen ausschließen, damit sie bei der Verwendung von Monetarisierung nicht der Postgres-Datenbank hinzugefügt werden.

Weitere Informationen finden Sie unter Monetarisierungsserver-Properties.

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) 6.10
  • CentOS 6.10
  • Oracle Linux 6.9

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

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

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
140270474

UseStringDeduplication nicht festgelegt

UseStringDeduplication wurde für die edge-message-processor-Komponenten in Produktionsumgebungen nicht festgelegt.
111445518

MP-Fehler

Die Nachrichtenprozessoren haben alle 5 Minuten die folgende Fehlermeldung protokolliert:
2019-06-29 00:02:05,775 Apigee-Timer-6 ERROR CMgmt -
  ConnectorServiceImpl.refreshToken() : Connector Management API auth token
  generation failed: 0 null
113342838

Cassandra-Fehler mit JMX

Cassandra-Vorgänge funktionierten nicht, wenn die JMX-Authentifizierung aktiviert war
138931337

Upgrades für 13 Knoten

Upgrades von Installationen mit 13 Knoten von Version 17.09, 18.01 und 18.05 sind fehlgeschlagen.
119802562

Proxys mit demselben Namen

Wenn zwei Nutzer in derselben Organisation Proxys mit denselben Namen erstellt haben, wurde der erste Proxy durch den zweiten überschrieben. Dies trat nur auf, wenn verschiedene Nutzer den anderen Proxy nicht sehen konnten.
118851790

Schlüsselspeicher werden nicht geladen

Wenn es mehr als 100 Schlüsselspeicher für eine Organisation/Umgebung gab, wurde der Abschnitt „Schlüsselspeicher und Referenz“ in der Edge-UI nicht geladen. Stattdessen wurde auf der Benutzeroberfläche der Fehler Internal Error (Error Fetching Keystores) angezeigt.
110988191

Analyse fehlgeschlagen

Die Analyse für eine Umgebung ist fehlgeschlagen, als Daten vom Microgateway bereitgestellt wurden, die auf ein Datum in der Zukunft festgelegt waren.
110785400

Fehler bei der Sicherung

Bei ZooKeeper, Cassandra und OpenLDAP ist es zeitweise zu Fehlern bei der Datensicherung gekommen. Der folgende Fehler wurde angezeigt: File changed as we read it.
79993247

HEAD-Anfragen an Node.js

HEAD-Anfragen an ein Node.js-Ziel konnten hängen bleiben, wodurch Verbindungen ausstehend blieben.
70291825

Apigee-Postgres-Sicherung/Wiederherstellung

Wenn Sie jetzt eine apigee-postgres-Sicherung oder ‑Wiederherstellung ausführen, werden Daten für alle Komponenten gesichert.
65737520

Sysadmin-Passwort zurücksetzen

Das Zurücksetzen des Systemadministratorpassworts für den Management Server, der Sonderzeichen enthielt, schlug fehl.

Bekannte Probleme

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

Problem-ID Beschreibung
141628497

Mint bewertet Transaktionen anfangs nicht

Bei Edge for the Private Cloud werden Transaktionen nicht sofort bewertet, wenn Sie die Monetarisierung für eine Organisation aktivieren. Das gilt für neue und bestehende Organisationen.

Die Monetarisierungs-Aktivierungs-API antwortet mit der Job-ID. Nach Abschluss des Jobs wird der Status „Erfolgreich“ angezeigt. Monetarisierte API-Aufrufe, die ursprünglich ausgeführt wurden, werden jedoch nicht von der Monetarisierung verarbeitet und nicht bewertet. Diese Transaktionen werden nur in der regulären Analyse angezeigt.

Workaround:

Starten Sie alle Message Processors (MPs) neu. Das geht so:
apigee-service edge-message-processor restart

Nachdem die Monetarisierung aktiviert wurde, wird durch einen Neustart der MPs die Konfiguration beim Start von Edge aus ZooKeeper geladen. Das passiert bei jedem Neustart. Das Problem tritt also nur am Anfang auf.

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.
135616498

Metadatendateiformat für die Installation von apigee-sso

Wenn Sie apigee-sso installieren und anstelle einer URL eine metadata.xml-Datei verwenden, wird die metadata.xml-Datei nicht vollständig gelesen, wenn sie am Ende keine neue Zeile (CRLF) enthält.

Workaround:

Sie haben folgende Möglichkeiten, dieses Problem zu umgehen:

  • CRLF am Ende der Datei „metadata.xml“ hinzufügen

    ODER

  • URL-basierten Speicherort für die Metadaten verwenden
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.

76087166

DataAccessException in Konfigurationen mit mehreren Rechenzentren

Wenn in Konfigurationen mit mehreren Rechenzentren ein Datenspeicher nicht mehr verfügbar ist, wird möglicherweise der folgende Fehler angezeigt:

DataAccessException: Error while accessing datastore;
Please retry later

Das hat zur Folge, dass der Management Server möglicherweise nicht gestartet wird, da er versucht, eine Verbindung zu Cassandra-Knoten in dc-1 und dc-2 herzustellen. Der DataAccessExceptions tritt auf, wenn ein Cassandra-Knoten nicht verfügbar ist. Dies kann auch zu Unterbrechungen des API-Traffics führen, wenn Message Processors beim Abrufen von KVMs DataAccessExceptions melden.

Der Management Server sollte keine Verbindung zu Datenspeicherkomponenten in anderen Regionen herstellen.

Problemumgehung

Die Problemumgehung besteht darin, die folgenden Cassandra-Knotentypen im nicht verfügbaren Rechenzentrum abzumelden und sie dann wieder zu registrieren, wenn die Cassandra-Knoten wieder verfügbar sind:

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

So heben Sie die Registrierung dieser Cassandra-Knotentypen auf und registrieren sie neu:

  1. Rufen Sie die UUIDs der Cassandra-Knoten mit dem folgenden curl-Befehl ab:
    curl -u ADMIN_EMAIL:ADMIN_PW \
      "http://MS_IP:MS_PORT/v1/servers?region=REGION&pod=GATEWAY_POD \
      &type=CASSANDRA_NODE_TYPE"

    Wobei:

    • ADMIN_EMAIL und ADMIN_PW sind die Anmeldedaten Ihres Apigee-Kontos.
    • MS_IP und MS_PORT sind die IP-Adresse und die Portnummer des Management-Servers.
    • REGION ist der Name des Rechenzentrums, in dem sich der Management Server befindet.
    • GATEWAY_POD ist der Pod-Name, der standardmäßig „gateway“ lautet. Möglicherweise haben Sie sie aber auch umbenannt. Überprüfen Sie daher Ihre Implementierung.
    • CASSANDRA_NODE_TYPE ist wahlweise kms-datastore, dc-datastore oder keyvaluemap-datastore.

    Beispiel:

    curl -u nickdanger@google.com:myP@$$w0rD
      "http://192.168.0.1:8080/v1/servers?region=dc-1&pod=gateway&type=dc-datastore"

    Die Antwort hat das folgende Format:

    {
      "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"
    }

    Beispiel:

    {
      "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"
    }

    Notieren Sie sich die Werte des Felds uUID in der Antwort. Sie verwenden diese, um die Registrierung der Knoten aufzuheben.

  2. Wiederholen Sie Schritt 1 für jeden Cassandra-Knotentyp: kms-datastore, dc-datastore und keyvaluemap-datastore. Notieren Sie sich die zurückgegebenen UUIDs.
  3. Heben Sie die Registrierung der Knoten mit dem folgenden Befehl auf:
    curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers/UUID" -X DELETE

    Dabei ist UUID die UUID, die in der Antwort des vorherigen Befehls zurückgegeben wurde.

  4. Wiederholen Sie Schritt 3 für jede UUID, die Sie in den Schritten 1 und 2 erfasst haben.
  5. Registrieren Sie die Knoten mit dem folgenden Befehl neu:
    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

Mit diesen Vorgängen werden Knoten bei Zookeeper registriert und abgemeldet. Sie haben keine Auswirkungen auf den Cassandra-Cluster. Weitere Informationen zu diesen Befehlen finden Sie unter Datenspeicherregistrierungen aktualisieren.

68722102

MessageLogging-Richtlinie mit zusätzlichen Informationen im Logeintrag

Das Element FormatMessage der MessageLogging-Richtlinie steuert das Format der protokollierten Nachricht. Wenn FormatMessage=false, darf die protokollierte Nachricht keine von Apigee generierten Informationen enthalten. Selbst wenn Sie FormatMessage=false festlegen, enthält der Logeintrag weiterhin die folgenden Informationen:

  • Der Prioritätswert
  • Der Zeitstempel

Workaround:

Keine.

Nächster Schritt

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

Neuinstallationen:
Neuinstallation – Übersicht
Vorhandene Installationen:
Upgradepfade