Versionshinweise zu Edge für Private Cloud 4.19.01

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

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

Workaround:

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.

Sitzungstokens nicht ungültig

Sitzungstokens werden auf dem Server nicht entwertet, wenn der Nutzer auf die Schaltfläche „Abmeldung von Apigee Edge“ klickt.

Workaround:

Cassandra-Vorgänge funktionieren nicht, wenn JMX-Authentifizierung aktiviert ist

Workaround:

HEAD-Anfragen an Node.js-Ziele hängen

HEAD-Anfragen an ein Node.js-Ziel können sich aufhängen, sodass Verbindungen ausstehend sind.

Workaround:

Zur Umgehung dieses Problems definieren Sie einen Handler für HEAD-Anfragen, damit explizit eine leere Antwort zurückgegeben wird.

Hostnamen werden nicht aufgelöst

Nach der Installation oder dem Upgrade von Edge für Private Cloud werden Hostnamen möglicherweise nicht in ihre Adressen aufgelöst.

Workaround:

Starten Sie die Edge-UI-Komponente neu, um dieses Problem zu beheben:

/opt/apigee/apigee-service/bin/apigee-service edge-ui restart

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.

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:

Das Passwort für den Systemadministrator konnte nicht zurückgesetzt werden

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

Workaround:

Definieren Sie das Passwort in einer Datendatei, die Sie dann an den Endpunkt /users in der Management API übergeben. Weitere Informationen finden Sie unter Systemadministratorpasswort zurücksetzen.