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:

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

  ODER

• URL-basierten Speicherort für die Metadaten verwenden

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

Workaround:

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.

Sitzungstokens werden nicht ungültig gemacht

Sitzungstokens werden auf dem Server nicht ungültig gemacht, 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, der explizit eine leere Antwort zurückgibt.

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 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.

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:

Das Zurücksetzen des Systemadministratorpassworts schlägt fehl

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 /users-Endpunkt in der Management API übergeben. Weitere Informationen finden Sie unter Systemadministratorpasswort zurücksetzen.