Versionshinweise zu 4.19.06 Edge für Private Cloud

Sie sehen die Dokumentation zu Apigee Edge.
Zur Apigee X-Dokumentation
weitere Informationen

In diesem Abschnitt wird Version 4.19.06 von Edge for Private Cloud Feature Release beschrieben.

Release-Zusammenfassung

In der folgenden Tabelle sind die Änderungen in diesem Release zusammengefasst:

Neue Funktionen

Diese Version enthält die folgenden neuen Funktionen:

○ LDAP-Unterstützung für SSO
○ Unterstützung für HTTP-Bereitstellungen
○ Anpassbare Analysen
○ Cassandra-Rack-Unterstützung
○ IPv6-Unterstützung
○ Vereinfachte Installation von New Edge Experience
○ Ausschluss von INVALID_TSC-Transaktionen (Monetarisierung)

Weitere Informationen zu diesen neuen Funktionen finden Sie unter Neue Funktionen.

Abwärtskompatibilität

Die folgenden Probleme, die sich auf die Abwärtskompatibilität auswirken, wurden in dieser Version von Apigee Edge for Private Cloud eingeführt:

     
  • Aufgrund der Korrektur des Problems 132443137 (wie in den Versionshinweisen zur öffentlichen Cloud 19.03.01 beschrieben) ignorieren Message Processor jetzt Header, die mit X-Apigee-* beginnen. Daher müssen Sie jeden Code, der X-Apigee-*-Header verwendet, refaktorieren und diese Header durch unterstützte ersetzen.

  • Der Name der Cassandra-Protokolldateien hat sich geändert. Es ist jetzt:

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

Seit dem vorherigen Feature-Release von Edge for Private Cloud wurden die folgenden Releases veröffentlicht und sind in diesem Release enthalten:

○ Edge:
   19.07.23 (Benutzeroberfläche)
   19.03.01
   19.02.19
   19.02.04
   19.01.23
{11.1.
19.01.1418.12.0418.08.3118.07.31
○ Portal:
   19.07.08
   19.05.23
   19.05.08
   19.04.18
   19.03.20
1. 2.5
1.27
1.27
1.27
1.27
19.05.08 19.05.02.19.02.2719.02.2119.02.0419.01.16
Ruhestand Keine
Einstellung von Produkten und Funktionen

Mit dem Release von 4.19.06 wurden folgende Elemente eingestellt:

  • 4.18.01: Version 4.18.01 von Apigee Edge für Private Cloud ist jetzt veraltet.

Weitere Informationen finden Sie unter Einstellung und Einstellung von Apigee sowie CPS-Änderungen.

Fehlerkorrekturen

Diese Version umfasst die folgenden Fehlerbehebungen:

○ UseStringDeDuplizierung nicht festgelegt (140270474)
7 – 8 n und 1 oder 13 (138.0474)
7 – 1 - 8, 7 - 1 - 8, 7,








HEAD

Weitere Informationen zu den einzelnen Korrekturen finden Sie unter Fehlerkorrekturen.

Bekannte Probleme

Diese Version umfasst die folgenden bekannten Probleme:

○ Mint keine Transaktionen anfänglich bewertet (141628497)
○ Mint Rating Server-Speicherleck (137865184)
○ Metadaten-Dateiformat für die Apigee-Installation (135616498)
apigee-monit Nachricht wird unter Amazon Linux 1 nicht unterstützt (12237098)



Weitere Informationen zu jedem dieser bekannten Probleme, einschließlich Problemumgehungen, finden Sie unter Bekannte Probleme.

Upgrade-Pfade

Die folgende Tabelle zeigt die Upgradepfade für diese Version:

From 4.19.01 Direktes Upgrade von 4.19.01 → 4.19.06
Von 18.04.05 Direkt von 4.18.05 auf 4.19.06 upgraden
Von 18.04.01 Direktes Upgrade von 4.18.01 → 4.19.06

Neue Funktionen

In diesem Abschnitt werden die neuen Funktionen in dieser Version aufgeführt. Darüber hinaus enthält dieser Release alle Features in den Edge-UI-, Edge-Management- und Portal-Releases, die unter Enthaltene Releases aufgeführt sind.

Zusätzlich zu den folgenden Verbesserungen enthält diese Version auch mehrere Verbesserungen in puncto Nutzerfreundlichkeit, Leistung, Sicherheit und Stabilität.

Unterstützung bei der HTTP-Bereitstellung

Standardmäßig verwendet Edge RPC zum Bereitstellen von API-Proxys. Dieser Modus funktioniert bei den meisten Installationen sehr gut. Bei größeren Topologien mit vielen MPs kann es jedoch bei einer großen Anzahl gleichzeitiger Aufrufe über RPC zu Zeitüberschreitungen kommen.

Daher empfiehlt Apigee, dass größere Bereitstellungen HTTP anstelle von RPC für die Bereitstellung verwenden. Das Aktivieren von HTTP-Bereitstellungen wird jetzt unterstützt.

Weitere Informationen finden Sie unter HTTP-Bereitstellung aktivieren.

Cassandra-Rack-Unterstützung

Apigee bietet jetzt eine allgemeine Anleitung für Skalierungsvorgänge von Cassandra, indem Cassandra auf Apigee Edge für Private Cloud-Rack aktiviert wird.

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

Anpassbare Analyse

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

Mit diesem Feature Release können Sie den Message Processor so konfigurieren, dass Analysedaten auf die Festplatte geschrieben werden, oder Sie können beide Optionen verwenden.

Weitere Informationen finden Sie unter Analysedaten in eine Datei schreiben.

Vereinfachte Installation von New Edge

Die Installation von New Edge wurde mit einem neuen Skript 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 externe IdP-Authentifizierung.

IPv6-Unterstützung

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

Weitere Informationen finden Sie unter IPv6 auf dem Router verwenden.

INVALID_TSC Transaktionen ausschließen (Monetarisierung)

Sie können jetzt verhindern, dass INVALID_TSC-Transaktionen der Postgres-Datenbank hinzugefügt werden, wenn Sie die Monetarisierung verwenden.

Weitere Informationen findest du unter Servereigenschaften für die Monetarisierung.

Unterstützte Software

Diese Version umfasst die folgenden Änderungen an der unterstützten Software:

Support hinzugefügt Wird nicht mehr unterstützt

In diesem Release werden folgende Plattformen unterstützt:

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

Die folgenden Plattformen werden in 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 werden die Private Cloud-Fehler aufgeführt, die in diesem Release behoben wurden. Darüber hinaus enthält diese Version alle Fehlerkorrekturen in den Edge-UI-, Edge Management- und Portal-Releases, die unter Enthaltene Releases angezeigt werden.

Fehler-ID Beschreibung
140270474

UseStringDeDuplizierung ist nicht festgelegt

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

MP-Fehler

Message Processors hat alle fünf 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

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

Upgrades mit 13 Knoten

Upgrades von Installationen mit 13 Knoten von 17.09, 18.01 und 18.05 schlugen fehl.
119802562

Proxys mit demselben Namen

Wenn zwei Nutzer in derselben Organisation Proxys mit demselben Namen erstellen, würde der zweite erstellte Proxys den ersten überschreiben. Dies trat nur auf, wenn verschiedene Nutzer den anderen Proxy nicht sehen konnten.
118851790

Schlüsselspeicher werden nicht geladen

Wenn für eine Organisation/Umgebung mehr als 100 Schlüsselspeicher vorhanden waren, wurde der Schlüsselspeicher und der Referenzabschnitt in der Edge-Benutzeroberfläche nicht geladen. Stattdessen wurde in der UI der Fehler Internal Error (Error Fetching Keystores) angezeigt.
110988191

Analyse fehlgeschlagen

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

Sicherungsfehler

ZooKeeper, Cassandra und OpenLDAP konnten ihre Daten mit dem folgenden Fehler ab und zu nicht ordnungsgemäß sichern: File changed as we read it.
79993247

HEAD-Anfragen an Node.js

HEAD-Anfragen an ein Node.js-Ziel konnten sich aufhängen. Dadurch waren Verbindungen ausstehend.
70291825

Apigee-Postgres-Sicherung/-Wiederherstellung

Durch die Ausführung einer Apigee-Postgres-Sicherung/-Wiederherstellung werden jetzt Daten für alle Komponenten gesichert.
65737520

Sysadmin-Passwort zurücksetzen

Das Zurücksetzen des Systemadministratorpassworts für den Verwaltungsserver, das Sonderzeichen enthält, schlägt fehl.

Bekannte Probleme

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

Fehler-ID Beschreibung
141628497

Schreiben Sie zuerst keine Transaktionen ein.

Edge für die Private Cloud bewertet Transaktionen anfangs nicht, wenn Sie die Monetarisierung für eine Organisation zum ersten Mal aktivieren. Dies gilt für neue und bestehende Organisationen.

Die Monetarisierungsaktivierungs-API antwortet mit der Auftrags-ID. Nach Abschluss zeigt der Status des Auftrags an, dass er erfolgreich war. Anfänglich durchgeführte monetarisierte API-Aufrufe werden jedoch nicht von der Monetarisierung verarbeitet und nicht bewertet. Diese Transaktionen werden nur in regulären Analysen angezeigt.

Workaround:

Starten Sie alle Message Processors (MPs) neu. Dazu gehen Sie so vor:
apigee-service edge-message-processor restart

Nachdem die Monetarisierung aktiviert wurde, führt ein Neustart der MPs dazu, dass Edge beim Start die Konfiguration aus ZooKeeper lädt. Das passiert bei jedem Neustart, d. h. das Problem tritt erst am Anfang auf.

137865184

Speicherleck bei Server mit Mint-Bewertung

Wenn eine neue Qpid-Instanz in einer MX-Gruppe registriert wird, werden die Warteschlangen ohne Nutzer erstellt. Dadurch nimmt die Warteschlangentiefe zu, bis alle verfügbaren Ressourcen aufgebraucht sind.

Workaround:

Keine.
135616498

Metadatendateiformat für Apigee-sso-Installation

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

Workaround:

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

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

    ODER

  • URL-basierten Speicherort für Metadaten verwenden
122370980

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

Workaround:

Keine.
121095148

Die Message Processor-Sicherung sichert nicht den richtigen Dateisatz

Workaround:

Führen Sie die Sicherung ein zweites Mal aus. Die korrekten Dateien sollten nun gesichert werden.

76087166

DataAccessException in mehreren Rechenzentrumskonfigurationen

Wenn ein Datenspeicher bei mehreren Rechenzentrumskonfigurationen nicht mehr verfügbar ist, wird möglicherweise der folgende Fehler angezeigt:

DataAccessException: Error while accessing datastore;
Please retry later

Dies führt dazu, dass der Management Server möglicherweise nicht startet, da er versucht, eine Verbindung zu den Cassandra-Knoten sowohl in dc-1 als auch in dc-2 herzustellen. Der DataAccessExceptions tritt auf, wenn ein Cassandra-Knoten ausgefallen ist. Dies kann auch zu einer Unterbrechung des API-Datenverkehrs führen, bei der Message Processors DataAccessExceptions melden, während sie versuchen, KVMs abzurufen.

Der erwartete Status ist, dass der Management Server keine regionsübergreifende Verbindung zu Datenspeicherkomponenten herstellt.

Problemumgehung

Die Problemumgehung besteht darin, die Registrierung der folgenden Cassandra-Knotentypen im nicht verfügbaren Rechenzentrum aufzuheben und sie dann neu zu registrieren, sobald 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 für Ihr Apigee-Konto.
    • MS_IP und MS_PORT sind die IP-Adresse und Portnummer des Verwaltungsservers.
    • REGION ist der Name des Rechenzentrums, in dem sich der Verwaltungsserver befindet.
    • GATEWAY_POD ist der Pod-Name, standardmäßig "gateway". Möglicherweise haben Sie den Namen jedoch in einen anderen Namen geändert. Prüfen Sie daher Ihre Implementierung.
    • CASSANDRA_NODE_TYPE ist entweder 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"
    }

    Beachten Sie die Werte des Felds uUID in der Antwort. Damit wird die Registrierung der Knoten aufgehoben.

  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 folgendem 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 noch einmal:
    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

Bei diesen Vorgängen werden Knoten von Zookeeper registriert bzw. deren 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 in der Lognachricht

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

  • Priorität
  • 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