Versionshinweise zu Edge für Private Cloud 4.19.01

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

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

Workaround:

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.

Sitzungstokens nicht ungültig

Sitzungstokens werden auf dem Server nicht ungültig, wenn der Nutzer auf die Abmeldeschaltfläche von Apigee Edge klickt.

Workaround:

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

Workaround:

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

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

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 ihren Adressen zugeordnet.

Workaround:

Starten Sie die Edge-Benutzeroberflächenkomponente neu, um dieses Problem zu beheben:

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

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

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:

Fehler beim Zurücksetzen des Administratorpassworts

Das Zurücksetzen des Systemadministratorpassworts für den Verwaltungsserver, 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.