Versionshinweise zu Edge für Private Cloud 4.19.01

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

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

Workaround:

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.

Sitzungstokens werden nicht ungültig gemacht

Sitzungstokens werden auf dem Server nicht ungültig, wenn der Nutzer auf die Schaltfläche „Apigee Edge Logout“ klickt.

Workaround:

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

Workaround:

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

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

Workaround:

Um dieses Problem zu umgehen, definieren Sie einen Handler für HEAD-Anfragen, um explizit eine leere Antwort zurückzugeben.

Hostnamen werden nicht aufgelöst

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

Workaround:

So beheben Sie das Problem:

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

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.

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:

Fehler beim Zurücksetzen des Systemadministratorpassworts

Das Zurücksetzen des Systemadministratorpassworts für den Management Server, der Sonderzeichen enthält, schlägt fehl.

Workaround:

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