4.16.05 – Versionshinweise zu Edge für Private Cloud

Sie sehen die Dokumentation zu Apigee Edge.
Zur Apigee X-Dokumentation weitere Informationen

Am Dienstag, dem 31. Mai 2016, wurde eine neue Version von Apigee Edge für Private Cloud veröffentlicht.

Seit dem vorherigen Feature Release von Edge for Private Cloud (4.16.01) wurden die folgenden Releases veröffentlicht und sind in diesem Feature-Release enthalten:

Unter Releasenummerierung erfahren Sie, wie Sie herausfinden können, ob ein bestimmter Cloud-Release in Ihrer Version von Edge for Private Cloud enthalten ist.

Neue Features und Verbesserungen

Im Folgenden sind die neuen Funktionen und Verbesserungen in dieser Version aufgeführt. Zusätzlich zu den folgenden Verbesserungen enthält diese Version auch zahlreiche Verbesserungen in puncto Nutzerfreundlichkeit, Leistung, Sicherheit und Stabilität.

Weitere Informationen und Anweisungen finden Sie in der Dokumentation zu Edge für Private Cloud.

Installations- und Betriebsanleitungen jetzt online

Sie können jetzt unter Version 4.18.01 auf den Leitfaden zur Installation und Vorgänge von Edge for Private Cloud zugreifen.

Softwareupdates

Die folgenden Softwareupdates sind in diesem Release enthalten:

  • Java JDK 1.8 – Damit Sie die neuesten Java-Funktionen nutzen können, ist diese Version mit Java 1.8 kompatibel. In Ihrer Umgebung ist Oracle JDK 1.8 oder OpenJDK 8 erforderlich.
    Im Rahmen des Updates auf Java 8 sind einige TLS-Chiffren in Oracle JDK 1.8 nicht mehr verfügbar. Eine vollständige Liste finden Sie im Abschnitt "Standardmäßig deaktivierte Cipher Suites" http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.
  • Cassandra 2.1.13 – Aktualisiert von Cassandra 2.0.15.

Installation, Upgrade, Rollback

Im Folgenden finden Sie eine Liste der Änderungen an der Installation, dem Upgrade und den zugehörigen Skripts. Informationen zur Verwendung finden Sie in der Dokumentation zu Edge for Private Cloud.

  • Neuer Prozess zur Aktualisierung von Version 4.16.01: Diese Version ersetzt das Dienstprogramm apigee-migrate durch das Dienstprogramm update.sh, um Ihre Installation von 4.16.01 auf 4.16.05 zu aktualisieren. Siehe Apigee Edge 4.16.01 auf 4.16.05 aktualisieren.
  • Bootstrap
    • bootstrap.sh (Version 4.16.01) ist jetzt bootstrap_4.16.05.sh in 4.16.05.
    • Sie müssen uname:pword nicht mehr angeben, um bootstrap_4.16.05.sh herunterzuladen.
  • Rollback - Für ein Rollback eines Updates auf 4.16.05 deinstallierst du die Version 4.16.05 der Komponente und installierst die vorherige Version neu. Das vorherige rollback.sh-Dienstprogramm wurde entfernt. Siehe 4.16.05 Rollback-Prozess.
  • setup.sh und update.sh können die Logdatei in /tmp schreiben: Standardmäßig schreiben die Dienstprogramme setup.sh und update.sh Loginformationen in /opt/apigee/var/log/apigee-setup. Wenn der Nutzer, der das Dienstprogramm ausführt, keinen Zugriff auf dieses Verzeichnis hat, wird das Log in das Verzeichnis /tmp geschrieben. Wenn der Nutzer keinen Zugriff auf /tmp hat, schlägt das Dienstprogramm fehl.
  • Verfahren für API-BaaS-Aktualisierung: In der Version 4.16.01 mussten Sie API BaaS neu installieren, um sie zu migrieren. Das neue update.sh-Dienstprogramm unterstützt die aktuelle API-BaaS-Aktualisierung. Siehe Apigee Edge 4.16.01 auf 4.16.05 aktualisieren.

Verwaltung

Im Folgenden finden Sie neue Features für die Verwaltung und Konfiguration der Private Cloud.

  • Installationsprüfung – Das Dienstprogramm apigee-validate, das zum Testen Ihrer Edge Private Cloud-Installation verwendet wird, kann jetzt über den Verwaltungsserver ausgeführt werden. Bisher musste das Skript auf dem Message Processor ausgeführt werden. Siehe Installation testen.
  • Name der Region: Die Region kann ein beliebiger Name sein. In früheren Versionen hatte der Name die Form "dc-#", wobei # eine Ganzzahl war.
  • Gateway-Pods – Gateway-Pods können einen beliebigen Namen haben. In früheren Releases musste der Pod „gateway“ genannt werden.
  • Skriptbasierte Verwaltung: Mit einem neuen apigee-adminapi.sh-Befehlszeilendienstprogramm können Sie dieselben Edge-Konfigurationsaufgaben ausführen wie durch Aufrufe an die Edge Management API. Siehe Dienstprogramm apigee-adminapi.sh verwenden.
  • Lautlose SSL-Konfiguration für virtuelle Hosts – Beim Erstellen einer Organisation oder Umgebung können Sie jetzt Attribute übergeben, um SSL auf einem virtuellen Host zu konfigurieren. Weitere Informationen finden Sie unter Eine Organisation in das Programm aufnehmen.

API-Dienste

Im Folgenden finden Sie neue Features für Edge API-Dienste, die in früheren Cloud-Versionen des Produkts bereitgestellt wurden.

Präfix mit fester Länge für das Syslog-Nachrichten-Logging (Cloud 16.03.30)

Die Syslog-Konfiguration enthält ein neues <FormatMessage>-Element der Nachrichtenprotokollierungsrichtlinie. Wenn Sie <FormatMessage>true</FormatMessage> festlegen, beginnen Syslog-Nachrichten mit einer festen Anzahl von Zeichen, mit der Sie von Apigee eingefügte Daten herausfiltern können. Weitere Informationen finden Sie unter Richtlinie für das Nachrichten-Logging. (APIRT-1398)

Platzhalter im API-Proxy-Basispfad (Cloud 16.03.09-UI)

Die Verwaltungs-UI unterstützt die Verwendung eines oder mehrerer /*/-Platzhalter in API-Proxy-Basispfaden. Mit dem Basispfad /team/*/members können Clients beispielsweise Ihren Proxy mit https://[host]/team/blue/members oder https://[host]/team/green/members aufrufen, ohne dass Sie einen neuen Proxy erstellen müssen, um neue Teams zu unterstützen. /**/ ist nicht zulässig. (MGMT-3154)

API-Proxy-Verkettung (Cloud 16.03.02, Cloud 16.03.09 UI)

Edge unterstützt die lokale API-Proxy-Verkettung. Dadurch kann ein API-Proxy einen anderen in Ihrer Edge-Organisation bereitgestellten API-Proxy ohne zusätzlichen Netzwerkaufwand aufrufen. Bisher war für die API-Proxy-Verkettung ein HTTP(s)-Aufruf an einen anderen API-Proxy erforderlich, der die Anfrage über einen Load-Balancer, Router und Message Processor weiterleitete.

Auf dem TargetEndpoint eines API-Proxys sind neue LocalTargetConnection-Elemente verfügbar, mit denen Sie einen API-Proxy-Namen, den Namen eines bestimmten ProxyEndpoint innerhalb eines API-Proxys oder einfach den Basispfad zu einer lokalen API-Proxy-Ressource (z. B. /v1/myresource) angeben können. Die Proxy-Editor-UI bietet diese Optionen auch, wenn Sie einen TargetEndpoint hinzufügen oder aktualisieren.

Proxy-Verkettungen sind auch in Service-Callout-Richtlinien verfügbar.

Weitere Informationen finden Sie unter API-Proxys verketten. Die neuen LocalTargetConnection-Elemente sind auch im folgenden XML-Schema aufgelistet: https://github.com/apigee/api-platform-samples/blob/master/schemas/configuration/configuration_schemas.xsd. (MGMT-3049, MGMT-3050)

Fehlerkorrekturen

Folgende Fehler wurden in diesem Release behoben. Diese Liste ist hauptsächlich für Nutzer gedacht, die prüfen möchten, ob ihre Support-Tickets behoben wurden. Sie ist nicht darauf ausgelegt, detaillierte Informationen für alle Nutzer bereitzustellen.

Edge für Private Cloud 4.16.05

Fehler-ID Beschreibung
PRC-770 16.01-Installationsprogramm kann den Postgres-Standby-Server nicht in axgroup registrieren
PRC-758 Nutzer mit der Nutzerrolle können benutzerdefinierte Berichte bearbeiten
PRC-883 Update auf dem Postgres-Server mit Master-Standby-Konfiguration schlägt fehl

Cloud 16.03.30

Fehler-ID Beschreibung
SECENG-584 Validierungsprüfung für Zeilenumbruch zwischen Zertifikaten in einer Zertifikatskette verursacht Probleme mit einigen Zertifikaten in der Produktion
MGMT-3217 Management API-Aufrufe schlagen fehl, wenn der KVMap-Name auf „keys“ endet
MGMT-3214 Klassenkonflikte können während JavaCallouts auftreten, wodurch der Java-Code eines Kunden fehlschlägt.
MGMT-3185 Fehler beim Hinzufügen von orgadmins-Administratoren zu einer Organisation
EDGEUI-127 Unzureichende Berechtigungen mit neuem Proxy-Editor erhalten
EDGEUI-119 Problem mit Zeitüberschreitung bei UI-Sitzung
CORESERV-671 Fehlermeldung „Keine Ringe konfiguriert; CPS-Dienst kann nicht initialisiert werden“
AXAPP-2345 Problem beim Auflisten benutzerdefinierter AX-Berichte für Kunden ohne CPS
AXAPP-2302 Die tägliche Apigee Analytics-Zusammenfassung zeigt, dass die Entwicklung nicht von den Entwicklern angenommen wird.
APIRT-2750 Viele Traffic-Fehler in einer bestimmten Organisation
APIRT-2516 Laufzeitfehler in JavaScript-Callouts enthalten falsche Zeilennummern
APIRT-2508 Exit-Fehler beim Aufrufen von Express Listen in einem Vault-Callback
APIRT-2336 Gzip-Problem mit Node.js
APIRT-1975 Maskenkonfigurationen funktionieren nicht für message.content

Cloud 16.03.16-UI

Fehler-ID Beschreibung
MGMT-3142 Grafiken werden im Dashboard für die Fehleranalyse nicht geladen (aktualisierte Korrektur)

Cloud 16.03.09-UI

Fehler-ID Beschreibung
MGMT-3158 Unzureichende Berechtigungen in der UI, wenn RBAC für einzelne Proxys über die API festgelegt ist
MGMT-3142 Diagramme werden im Dashboard für die Fehleranalyse nicht geladen
MGMT-3118 Die Benutzeroberfläche zeigt eine falsche Konfiguration des virtuellen SSL-Hosts für den Parameter „clientAuthEnabled“ an
DEVRT-2344 Definitionen für Einzeltagesberichte laden keine Transaktionen in die UI

Cloud 16.03.02

Fehler-ID Beschreibung
MGMT-3083 Automatische Aktualisierung von Node.js-Logs ist zu ausführlich mit Logmeldungen
DEVRT-2275 Preispläne für benutzerdefinierte Attribute zeigen nur 5 Attribute anstelle der zulässigen 10 Attribute an.
DEVRT-1275 Im Drop-down-Menü „Preisplan“ werden nicht alle Entwickler angezeigt
DEVRT-1074 Prepaid-Entwickler mit null Guthaben wirft NullpointerException ab, wenn Guthaben angewendet wird

Cloud 16.02.17

Fehler-ID Beschreibung
MGMT-3083 Automatische Aktualisierung von Node.js-Logs ist zu ausführlich mit Logmeldungen
MGMT-3077 Die UI generiert ein ungültiges Proxy-Bundle aus einer WSDL, die den Standard-Namespace verwendet
MGMT-1642 In der benutzerdefinierten Nutzerrolle fehlt die Get-Berechtigung für Entwickler-Apps

Bekannte Probleme

In dieser Version gibt es die folgenden bekannten Probleme.

Fehler-ID Beschreibung
APIRT-2978

Router startet nicht Nginx oder Router kann nicht gestartet werden

Wenn der Edge Router Nginx nicht oder überhaupt nicht starten kann, wie in der Datei /opt/apigee/var/log/edge-router/logs/system.log gezeigt, löschen Sie alle Dateien im Verzeichnis /opt/nginx/conf.d und starten Sie den Router neu:

> rm -f /opt/nginx/conf.d/*
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart
APIRT-3364

Nachrichtenprozessor führt DNS-Lookups für IPv4 und IPv6

Wenn Sie NSCD (Name Service Cache Daemon) installiert und aktiviert haben, stellen Sie möglicherweise fest, dass Nachrichtenprozessoren zwei DNS-Lookups ausführen: eine für IPv4 und eine für IPv6.

So deaktivieren Sie den DNS-Lookup für IPv6:

  1. Bearbeiten Sie auf jedem Message Processor-Knoten /etc/nscd.conf.
  2. Legen Sie das folgende Attribut fest:

    enable-cache-hosts no
PRC-1118

Fehler beim Ausführen des Befehls „apigee-service apigee-postgresql pg-data-purge“

Wenn Sie den Befehl „apigee-service apigee-postgresql pg-data-purge“ ausführen und erhalten Sie einen Fehler im folgenden Format:

FEHLER: muss Inhaber der Beziehung sein

Bearbeiten Sie /opt/apigee/apigee-postgresql-4.16.05-0.0.894/lib/actions/pg-data-purge und setzen Sie das folgende Attribut auf „apigee“:

POSTGRES_USER=apigee
DOC-1687 Aufgrund eines bekannten Konflikts aufgrund einer Paketabhängigkeit wird der in Satellite Server 6 verwendete Katello-Agent auf Apigee Edge-Hosts, auf denen der Qpid-Daemon ausgeführt wird, nicht ordnungsgemäß installiert.

JSON-Nutzlasten in den Richtlinien zum Zuweisen von Nachrichten, Java-Callouts und zum Auslösen von Fehlern

Mit den Richtlinien „Zuweisen von Nachrichten“, „Java-Callout“ und „Fehler ausgeben“ können Sie mit dem Element <Set><Payload> Nachrichteninhalte generieren. Dazu können Sie Variablen einbeziehen, deren Werte zur Laufzeit automatisch ausgefüllt werden. Wenn Sie beispielsweise das Datum aus dem HTTP-Header ausgeben möchten, können Sie {message.header.date} in Ihre Nachricht einfügen.

Im JSON-Format sieht die Nachricht in etwa so aus:

{"The date is: " : "{message.header.date}"}

Wie Sie sehen, ist dies jedoch ein fehlerhaftes JSON-Format. Sie haben zwei Möglichkeiten, dieses Problem zu umgehen:

  • Verwenden Sie zur Maskierung der öffnenden geschweiften Klammer einen umgekehrten Schrägstrich: 
    \{"The date is: " : "{message.header.date}"}
  • Verwenden Sie in der Konfiguration des Nutzlastelements die Attribute variablePrefix und variableSuffix, um eine Variable in einer JSON-Nutzlast anzugeben. Beispiel:
    <Payload contentType="application/json" variablePrefix="#" variableSuffix="%">{"The date is: " : "#message.header.date%"}</Payload>

Im nächsten Feature Release von Edge for Private Cloud können Sie geschweifte Klammern für Variablen in JSON-Nachrichten ohne Probleme verwenden. (APIRT-1160)

Router startet nicht Nginx oder Router kann nicht gestartet werden

Wenn der Edge Router Nginx nicht oder überhaupt nicht starten kann, wie in der Datei /opt/apigee/var/log/edge-router/logs/system.log gezeigt, löschen Sie alle Dateien im Verzeichnis /opt/nginx/conf.d und starten Sie den Router neu:

> rm -f /opt/nginx/conf.d/*
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart
Zurück
4.16.05.01
Weiter
4.16.01.08