Versionshinweise zu 4.19.06 Edge für Private Cloud

<ph type="x-smartling-placeholder"></ph> Sie sehen die Dokumentation zu Apigee Edge.
Gehen Sie zur Apigee X-Dokumentation.
Weitere Informationen

In diesem Abschnitt wird die Version 4.19.06 des Release von Edge for Private Cloud 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 bei der HTTP-Bereitstellung
○ Anpassbare Analysen
○ Cassandra-Rack-Unterstützung
○ IPv6-Unterstützung
○ Vereinfachte Installation von New Edge
INVALID_TSC Transaktionen ausschließen (Monetarisierung)

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

Abwärtskompatibilität

In dieser Version wurden die folgenden Probleme mit Auswirkungen auf die Abwärtskompatibilität eingeführt. von Apigee Edge für Private Cloud:

     
  • Aufgrund der Behebung des Problems 132443137 (wie in am 03.01.2019 Cloud-Versionshinweise), ignorieren Message Processor Header, die mit X-Apigee-* Daher müssen Sie jeden Code refaktorieren, der X-Apigee-*-Header und ersetzen Sie diese durch unterstützte Header.

  • Der Name der Cassandra-Protokolldateien hat sich geändert. Jetzt:

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

Seit dem vorherigen Feature Release von Edge für Private Cloud wurden die folgenden Releases und sind in dieser Version enthalten:

○ Edge:
19.07.23 (Benutzeroberfläche)
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
Ruhestand Keine
Verworfene Produkte/Funktionen

In Version 4.19.06 wurde Folgendes eingestellt:

  • 4.18.01: Version 4.18.01 von Apigee Edge for Private Cloud wurde verworfen.

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

Fehlerkorrekturen

Diese Version enthält folgende Fehlerkorrekturen:

○ UseStringDeduplizierung nicht festgelegt (140270474)
○ MP-Fehler (111445518)
○ Cassandra-Fehler mit JMX (113342838)
○ Upgrades mit 13 Knoten (138931337)
○ Proxys mit demselben Namen (119802562)
○ Schlüsselspeicher werden nicht geladen (118851790)
○ Analyse fehlgeschlagen (110988191)
○ Sicherungsfehler (110785400)
HEAD-Anfragen an Node.js (79993247)
○ Apigee-postgres – Sicherung/Wiederherstellung (70291825)
○ Systemadministratorpasswort zurücksetzen (65737520)

Weitere Informationen zu den einzelnen Korrekturen finden Sie unter Fehlerkorrekturen.

Bekannte Probleme

Diese Version enthält die folgenden bekannten Probleme:

○ Mint bewertet Transaktionen anfänglich nicht (141628497)
○ Speicherleck bei Servern mit Mintbewertung (137865184)
○ Metadatendateiformat für Apigee-sso-Installation (135616498)
apigee-monit wird unter Amazon Linux 1 (122370980) nicht unterstützt
○ Die Message Processor-Sicherung sichert nicht den richtigen Satz an Dateien (121095148)
○ DataAccessExceptions bei Konfigurationen mit mehreren Rechenzentren (76087166)
○ MessageLogging-Richtlinie mit zusätzlichen Informationen in der Lognachricht (68722102)

Weitere Informationen zu diesen bekannten Problemen, einschließlich Behelfslösungen, finden Sie unter Bekannte Probleme:

Upgrade-Pfade

In der folgenden Tabelle sind die Upgradepfade für diese Version aufgeführt:

Ab 19.01. Direktes Upgrade von Version 4.19.01 auf 4.19.06
Ab 18.05. Direktes Upgrade von Version 4.18.05 auf 4.19.06
Von 18.04.01 Direktes Upgrade von Version 4.18.01 auf Version 4.19.06

Neue Funktionen

In diesem Abschnitt werden die neuen Funktionen in dieser Version aufgeführt. Darüber hinaus umfasst diese Version alle der Edge-Benutzeroberfläche, Edge-Management- und Portal-Releases, die in Enthaltene Releases.

Zusätzlich zu den folgenden Verbesserungen enthält diese Version auch mehrere Benutzerfreundlichkeit, Leistungs-, Sicherheits- und Stabilitätsverbesserungen.

Unterstützung bei der HTTP-Bereitstellung

Standardmäßig verwendet Edge RPC, um API-Proxys bereitzustellen. Dieser Modus ist für die meisten Bei größeren Topologien mit vielen MP kann es zu Zeitüberschreitungen kommen, wenn eine große Anzahl von gleichzeitige Aufrufe erfolgen über RPC.

Daher empfiehlt Apigee, bei größeren Bereitstellungen HTTP statt RPC für die Bereitstellung. Das Aktivieren von HTTP-Bereitstellungen wird jetzt unterstützt.

Weitere Informationen finden Sie unter HTTP aktivieren Bereitstellung.

Cassandra-Rack-Unterstützung

Apigee bietet jetzt eine allgemeine Anleitung für die Skalierung von Cassandra-Vorgängen. auf Apigee Edge für Private Cloud-Rack-Aware.

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

Pluggable Analytics

Standardmäßig werden vom Message Processor erfasste Analysedaten in Qpid und Postgres hochgeladen. zu verarbeiten. Sie können dann die Analysedaten in der Edge-Benutzeroberfläche anzeigen.

Mit diesem Feature Release können Sie den Message Processor so konfigurieren, dass Analysedaten in Laufwerk 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 durch ein neues Skript vereinfacht.

Weitere Informationen finden Sie unter Install the New Edge Experience (Neue Edge-Umgebung installieren).

LDAP-IdP-Unterstützung

Die Authentifizierung von Benutzern mit Edge-Benutzeroberfläche- und Edge-Management-API-Aufrufen unterstützt jetzt LDAP in zu SAML hinzufügen. LDAP unterstützt sowohl direkte als auch indirekte Bindungsmethoden.

Weitere Informationen finden Sie unter Übersicht über externe IdP-Authentifizierung

IPv6-Unterstützung

Standardmäßig verwenden alle API-Laufzeitaufrufe an Apigee Edge für Private Cloud IPv4. Sie können IPv6 -Unterstützung für den Router mit einer neuen Eigenschaft.

Weitere Informationen finden Sie unter Verwenden von IPv6 auf der Router.

INVALID_TSC Transaktionen ausschließen (Monetarisierung)

Sie können jetzt festlegen, dass INVALID_TSC Transaktionen nicht zu Postgres hinzugefügt werden wenn Sie die Monetarisierung nutzen.

Weitere Informationen zur Monetarisierung Servereigenschaften.

Unterstützte Software

In dieser Version wurden die folgenden Änderungen an unterstützter Software vorgenommen:

Support hinzugefügt Wird nicht mehr unterstützt

In dieser Version 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 aufgelistet, die in diesem Release behoben wurden. Außerdem enthält alle Fehlerkorrekturen in der Edge-Benutzeroberfläche, Edge Management und Portal-Releases, die in Enthaltene Releases.

Problem-ID Beschreibung
140270474

UseStringDeduplizierung nicht festgelegt

UseStringDeduplication war nicht Vorbereitung für die edge-message-processor-Komponenten in der Produktion Umgebungen.
111445518

MP-Fehler

Message Processor protokolliert kontinuierlich alle 5 Minuten die folgende Fehlermeldung:
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-Ausfälle mit JMX

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

Upgrades mit 13 Knoten

Upgrades von Installationen mit 13 Knoten aus den Versionen 17.09, 18.01 und 18.05 schlagen fehl.
119802562

Proxys mit demselben Namen

Wenn zwei Nutzer in derselben Organisation Proxys erstellt haben mit denselben Namen hat, wird die erste überschrieben. 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 sind, Referenzabschnitt in der Edge-Benutzeroberfläche wurde nicht geladen. Stattdessen wurde in der Benutzeroberfläche der Fehler Internal Error (Error Fetching Keystores) angezeigt.
110988191

Analyse fehlgeschlagen

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

Sicherungsfehler

ZooKeeper, Cassandra und OpenLDAP konnten zeitweise nicht ausgeführt werden ihre Daten mit folgendem Fehler sichern: File changed as we read it.
79993247

HEAD-Anfragen an Node.js

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

Apigee-postgres-Sicherung/-Wiederherstellung

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

Passwort für Systemadministrator zurücksetzen

Zurücksetzen des System-Admin-Passworts für den Verwaltungsserver, der spezielle Zeichen scheitern.

Bekannte Probleme

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

Problem-ID Beschreibung
141628497

Mint bewertet Transaktionen anfänglich nicht

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 Job-ID. Nach Abschluss zeigt der Status des Jobs an, dass der Vorgang erfolgreich war. Anfänglich monetarisierte API-Aufrufe werden jedoch nicht von der Monetarisierung verarbeitet und nicht bewertet. Diese Transaktionen werden nur in normalen Analysen angezeigt.

Workaround:

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

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

137865184

Speicherleck bei Servern mit Mint-Bewertung

Wenn eine neue Qpid-Instanz in einer mxgroup registriert ist, werden die Warteschlangen ohne Nutzer erstellt, was dazu führt, dass die Warteschlangentiefe zunimmt, bis alle verfügbaren Ressourcen belegt sind.

Workaround:

Keine.
135616498

Metadatendateiformat für die Installation von Apigee-sso

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

Workaround:

Sie können dieses Problem umgehen, indem Sie einen der folgenden Schritte ausführen:

  • Fügen Sie am Ende der Datei metadata.xml einen CRLF hinzu.

    ODER

  • URL-basierten Speicherort für Metadaten verwenden
122370980

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

Workaround:

Keine.
121095148

Message Processor-Sicherung sichert nicht den richtigen Satz Dateien

Workaround:

Führen Sie die Sicherung ein zweites Mal aus. Es sollte dann der richtige Satz von Dateien gesichert werden.

76087166

DataAccessException in mehreren Rechenzentrumskonfigurationen

Wenn bei mehreren Rechenzentrumskonfigurationen ein Datenspeicher nicht mehr verfügbar ist, folgenden Fehler:

DataAccessException: Error while accessing datastore;
Please retry later

Das Ergebnis ist, dass Management Server möglicherweise nicht gestartet wird, weil er versucht, eine Verbindung zu Cassandra herzustellen. in dc-1 und dc-2. DataAccessExceptions tritt auf, wenn ein Cassandra-Knoten Dies kann auch zu einer Unterbrechung des API-Datenverkehrs führen, wenn DataAccessExceptions beim Abrufen von KVMs.

Beachten Sie, dass der erwartete Status lautet, dass der Verwaltungsserver keine Verbindung zu Datenspeicherkomponenten herstellen darf. in verschiedenen Regionen.

Problemumgehung

Als Problemumgehung wird die Registrierung der folgenden Cassandra-Knotentypen im nicht verfügbaren Rechenzentrum aufgehoben und registrieren Sie sie neu, 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 noch einmal:

  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 Ihren Apigee Konto.
    • MS_IP und MS_PORT sind die IP-Adresse und der Port des Verwaltungsservers Nummer.
    • REGION ist der Name des Rechenzentrums, in dem sich der Verwaltungsserver befindet befindet.
    • GATEWAY_POD ist der Name des Pods, der standardmäßig „gateway“ lautet. Möglicherweise haben Sie in einen anderen Namen umbenannt. Überprüfen Sie daher Ihre Implementierung.
    • CASSANDRA_NODE_TYPE entspricht einem der folgenden Werte: kms-datastore, dc-datastore, und 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 nutzen sie, um die Registrierung der Knoten aufheben.

  2. Wiederholen Sie Schritt 1 für jeden Cassandra-Knotentyp: kms-datastore, dc-datastore und keyvaluemap-datastore. Beachten Sie die Zurückgegebene 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

Beachten Sie, dass durch diese Vorgänge Knoten von Zookeeper registriert und abgemeldet werden und keine auf den Cassandra-Cluster auswirken. 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, sollte die protokollierte Nachricht keine von Apigee generierten Informationen enthalten. Aber auch wenn Sie FormatMessage=false festlegen, enthält die Lognachricht weiterhin die folgenden Informationen:

  • Die Prioritätsstufe
  • Der Zeitstempel

Workaround:

Keine.

Nächster Schritt

Verwenden Sie die folgenden Links, um mit Edge für Private Cloud 4.19.06 zu beginnen:

Neuinstallationen:
Neuinstallation – Übersicht
Vorhandene Installationen:
Upgradepfade