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.

Release-Zusammenfassung

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
○ Cassandra-Rack-Unterstützung
○ IPv6-Unterstützung
○ Vereinfachte Installation von New Edge
○ INVALID_TSC-Transaktionen ausschließen (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 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:
   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
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)
○ Sysadmin-Passwort zurücksetzen (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 Upgradepfade für diesen Release 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 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.

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 Messpunkten 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 für die Bereitstellung verwendet wird. Die Aktivierung von HTTP-Bereitstellungen wird jetzt unterstützt.

Weitere Informationen finden Sie unter HTTP-Bereitstellung aktivieren.

Cassandra-Rack-Unterstützung

Apigee bietet jetzt allgemeine Anleitungen für die Skalierung von Cassandra-Vorgängen, indem Cassandra in 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 Analysedaten, die vom Message Processor erhoben werden, zur Verarbeitung in Qpid und Postgres hochgeladen. Anschließend können Sie die Analysedaten 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.

Unterstützung von LDAP-Identitätsanbietern

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 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 dieser Version 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 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
140270474

UseStringDeduplication nicht festgelegt

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

MP-Fehler

Die Message Processors 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 13-Knoten-Installationen 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. Das ist nur dann der Fall, wenn verschiedene Nutzer den anderen Proxy nicht sehen konnten.
118851790

Keystores werden nicht geladen

Wenn es mehr als 100 Schlüsselspeicher für eine Organisation/Umgebung gab, wurde der Bereich „Schlüsselspeicher und Verweis“ in der Edge-Benutzeroberfläche 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/Wiederherstellung ausführen, werden Daten für alle Komponenten gesichert.
65737520

Sysadmin-Passwort zurücksetzen

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

Bekannte Probleme

In der folgenden Tabelle sind die bekannten Probleme in diesem Release aufgeführt:

Problem-ID Beschreibung
141628497

Mint bewertet Transaktionen anfangs nicht

Bei Edge für die Private Cloud werden Transaktionen nicht sofort bewertet, wenn du die Monetarisierung für eine Organisation aktivierst. 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 monetarisiert und nicht bewertet. Diese Transaktionen werden nur in regulären Analysen 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 das Neustarten der Message Processors 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:

  • Fügen Sie am Ende der Datei „metadata.xml“ ein CRLF ein.

    ODER

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

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 Ergebnis ist, 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-Fehler 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 regionsübergreifenden Verbindungen zu Datastore-Komponenten herstellen.

Problemumgehung

Als Workaround können Sie die folgenden Cassandra-Knotentypen im nicht verfügbaren Rechenzentrum abmelden und dann wieder anmelden, 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 den Namen geändert. Ü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 die Registrierung aufgehoben. 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 die Log-Nachricht 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