4.16.05 – Versionshinweise zu Edge für Private Cloud

Sie lesen gerade die Dokumentation zu Apigee Edge.
Apigee X-Dokumentation aufrufen. info

Am Dienstag, dem 31. Mai 2016, haben wir eine neue Version von Apigee Edge for Private Cloud veröffentlicht.

Seit dem letzten Feature-Release für Edge for Private Cloud (4.16.01) sind die folgenden Releases erfolgt, die in diesem Feature-Release enthalten sind:

Unter Versionsnummerierung erfahren Sie, wie Sie herausfinden können, ob eine bestimmte Cloud-Version in Ihrer Version von Edge for Private Cloud enthalten ist.

Neue Features und Verbesserungen

Im Folgenden sind die neuen Funktionen und Verbesserungen in diesem Release aufgeführt. Zusätzlich zu den folgenden Verbesserungen enthält diese Version auch mehrere Verbesserungen in Bezug auf Benutzerfreundlichkeit, Leistung, Sicherheit und Stabilität.

Weitere Informationen und Anleitungen finden Sie in der Edge for Private Cloud-Dokumentation.

Installations- und Betriebsanleitungen sind jetzt online verfügbar

Sie können jetzt auf die Installations- und Betriebsanleitung für Edge for Private Cloud in Version 4.18.01 zugreifen.

Softwareupdates

Die folgenden Softwareupdates sind im 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 „Default Disabled Cipher Suites“ unter 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

Nachfolgend finden Sie eine Liste der Änderungen an Installations-, Upgrade- und zugehörigen Skripts. Informationen zur Verwendung finden Sie in der Dokumentation zu Edge for Private Cloud.

  • Neuer Prozess für das Update von Version 4.16.01: In dieser Version wird das apigee-migrate-Dienstprogramm durch das update.sh-Dienstprogramm ersetzt, um Ihre Installation von Version 4.16.01 auf Version 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 Version 4.16.05.
    • Sie müssen uname:pword nicht mehr angeben, um bootstrap_4.16.05.sh herunterzuladen.
  • Rollback: Wenn Sie ein Update auf Version 4.16.05 rückgängig machen möchten, deinstallieren Sie die Version 4.16.05 der Komponente und installieren Sie die vorherige Version neu. Das bisherige rollback.sh-Tool wurde entfernt. Siehe 4.16.05 Rollback-Prozess.
  • setup.sh und update.sh können die Protokolldatei in /tmp schreiben. – Standardmäßig schreiben die Dienstprogramme setup.sh und update.sh Protokollinformationen 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.
  • API BaaS-Aktualisierung: In Version 4.16.01 mussten Sie API BaaS neu installieren, um sie zu migrieren. Das neue update.sh-Tool unterstützt die In-Place-Aktualisierung von API BaaS. Siehe Apigee Edge 4.16.01 auf 4.16.05 aktualisieren.

Verwaltung

Im Folgenden finden Sie neue Funktionen für die Verwaltung und Konfiguration von Private Cloud.

  • Installationsvalidierung – Das apigee-validate-Dienstprogramm zum Testen Ihrer Edge Private Cloud-Installation kann jetzt vom Management Server aus ausgeführt werden. Bisher musste das Skript auf dem Message Processor ausgeführt werden. Weitere Informationen finden Sie unter Installation testen.
  • Name der Region: Die Region kann einen beliebigen Namen haben. In früheren Releases hatte der Name das Format „dc-#“, wobei # ein ganzzahliger Wert war.
  • Gateway-Pods: Gateway-Pods können einen beliebigen Namen haben. In früheren Releases musste der Pod „gateway“ heißen.
  • Scriptbasierte Verwaltung: Mit einem neuen apigee-adminapi.sh-Befehlszeilentool können Sie dieselben Edge-Konfigurationsaufgaben ausführen, die Sie durch Aufrufe der Edge Management API ausführen. Weitere Informationen finden Sie unter apigee-adminapi.sh-Dienstprogramm verwenden.
  • Stille SSL-Konfiguration für virtuelle Hosts: Beim Erstellen einer Organisation oder Umgebung können Sie jetzt Eigenschaften übergeben, um SSL für einen virtuellen Host zu konfigurieren. Weitere Informationen finden Sie unter Organisation einrichten.

API-Dienste

Im Folgenden finden Sie neue Funktionen für Edge API Services, die in früheren Cloud-Versionen des Produkts eingeführt wurden.

Präfix mit fester Länge für die Syslog-Nachrichtenprotokollierung (Cloud 16.03.30)

Die Message Logging-Richtlinie hat ein neues <FormatMessage>-Element in der Syslog-Konfiguration. Wenn Sie <FormatMessage>true</FormatMessage> festlegen, beginnen Syslog-Nachrichten mit einer festen Anzahl von Zeichen, sodass Sie von Apigee eingefügte Daten herausfiltern können. Weitere Informationen finden Sie in der Richtlinie für 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 zur Unterstützung neuer Teams erstellen müssen. /**/ ist nicht zulässig. (MGMT-3154)

Verkettung von API-Proxys (Cloud 16.03.02, Cloud 16.03.09 UI)

Edge unterstützt die lokale Verkettung von API-Proxys. Dadurch kann ein API-Proxy einen anderen API-Proxy aufrufen, der in Ihrer Edge-Organisation bereitgestellt wird, ohne dass zusätzlicher Netzwerk-Overhead entsteht. Bisher war für die Verkettung von API-Proxys ein http(s)-Aufruf an einen anderen API-Proxy erforderlich, der die Anfrage über einen Load-Balancer, Router und Message Processor weiterleitete.

Für den TargetEndpoint eines API-Proxys sind neue LocalTargetConnection-Elemente verfügbar. Damit können 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. Die Proxy-Editor-Benutzeroberfläche bietet diese Optionen auch, wenn Sie einen TargetEndpoint hinzufügen oder aktualisieren.

Die Verkettung von Proxys ist auch in ServiceCallout-Richtlinien verfügbar.

Weitere Informationen finden Sie unter API-Proxys kombinieren. Die neuen LocalTargetConnection-Elemente sind auch im XML-Schema aufgeführt: 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 erfolgreich bearbeitet wurden. Sie enthält keine detaillierten Informationen für allgemeine Nutzer.

Edge for Private Cloud 4.16.05

Problem-ID Description
PRC-770 Bei der Installation von Version 16.01 kann der Postgres-Standbyserver nicht in axgroup registriert werden
PRC-758 Nutzer mit der Rolle „Nutzer“ können benutzerdefinierte Berichte bearbeiten
PRC-883 Aktualisierung des Postgres-Servers mit Master-Standby-Konfiguration schlägt fehl

Cloud 16.03.30

Problem-ID Description
SECENG-584 Die Validierungsprüfung für Zeilenumbrüche 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 Bei JavaCallouts können Klassenkonflikte auftreten, die dazu führen, dass der Java-Code eines Kunden fehlschlägt.
MGMT-3185 Fehler beim Hinzufügen von Organisationsadministratoren zu einer Organisation
EDGEUI-127 Unzureichende Berechtigungen mit dem neuen Proxy-Editor
EDGEUI-119 Problem mit Zeitüberschreitung der UI-Sitzung
CORESERV-671 Fehler „No rings configured; Cannot initialize cps service“ (Keine Anrufe konfiguriert; CPS-Dienst kann nicht initialisiert werden)
AXAPP-2345 Problem beim Auflisten benutzerdefinierter AX-Berichte für Kunden, die nicht CPS nutzen
AXAPP-2302 In der täglichen Apigee Analytics-Zusammenfassung wird unter „Entwicklerakzeptanz“ null angezeigt
APIRT-2750 Hohe Anzahl von Traffic-Fehlern in bestimmter Organisation
APIRT-2516 Laufzeitfehler in JavaScript-Callouts geben falsche Zeilennummern an
APIRT-2508 Exit-Fehler beim Aufrufen von Express Listen innerhalb eines Vault-Callbacks
APIRT-2336 Gzip-Problem mit Node.js
APIRT-1975 Maskierungskonfigurationen funktionieren nicht für „message.content“

Cloud 16.03.16-UI

Problem-ID Description
MGMT-3142 Diagramme werden im Dashboard „Fehleranalyse“ nicht geladen (aktualisierte Lösung)

Cloud 16.03.09-Benutzeroberfläche

Problem-ID Description
MGMT-3158 Unzureichende Berechtigungen in der Benutzeroberfläche, wenn RBAC für einzelne Proxys über die API festgelegt wird
MGMT-3142 Diagramme werden im Fehleranalyse-Dashboard nicht geladen
MGMT-3118 In der Benutzeroberfläche wird die falsche SSL-Konfiguration für den virtuellen Host für den Parameter „clientAuthEnabled“ angezeigt.
DEVRT-2344 Transaktionen werden in der Benutzeroberfläche nicht geladen, wenn Berichtsdefinitionen nur einen Tag umfassen

Cloud 16.03.02

Problem-ID Description
MGMT-3083 Das automatische Aktualisieren von Node.js-Logs ist zu ausführlich mit Logmeldungen.
DEVRT-2275 Bei Ratenplänen mit benutzerdefinierten Attributen werden nur 5 Attribute anstelle der zulässigen 10 Attribute angezeigt
DEVRT-1275 Nicht alle Entwickler werden im Drop-down-Menü „Tarif“ angezeigt
DEVRT-1074 Prepaid-Entwickler mit einem Guthaben von null löst beim Anwenden von Guthaben eine NullPointerException aus

Cloud 16.02.17

Problem-ID Description
MGMT-3083 Das automatische Aktualisieren von Node.js-Logs ist zu ausführlich mit Logmeldungen.
MGMT-3077 Die Benutzeroberfläche generiert ein ungültiges Proxy-Bundle aus einer WSDL, die den Standard-Namespace verwendet.
MGMT-1642 Benutzerdefinierte Nutzerrolle hat keine „get“-Berechtigung für Entwickler-Apps

Bekannte Probleme

Dieser Release weist die folgenden bekannten Probleme auf.

Problem-ID Description
APIRT-2978

Router startet Nginx nicht oder Router startet nicht

Wenn der Edge-Router Nginx nicht starten kann oder überhaupt nicht startet, wie in der Datei /opt/apigee/var/log/edge-router/logs/system.log zu sehen ist, 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

Message Processor führt DNS-Lookup für IPv4 und IPv6 durch

Wenn Sie NSCD (Name Service Cache Daemon) installiert und aktiviert haben, führen Message Processors möglicherweise zwei DNS-Lookups durch: einen für IPv4 und einen für IPv6.

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

  1. Bearbeiten Sie auf jedem Message Processor-Knoten die Datei /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 ein Fehler im folgenden Format angezeigt wird:

FEHLER: muss Inhaber der Beziehung sein

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

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

JSON-Nutzlasten in den Richtlinien „Nachricht zuweisen“, „Java Callout“ und „Fehler auslösen“

Mit den Richtlinien „Nachricht zuweisen“, „Java Callout“ und „Raise Fault“ können Sie Nachrichteninhalte mit dem <Set><Payload>-Element generieren. In diesen Nachrichten können Sie Variablen einfügen, deren Werte zur Laufzeit automatisch eingefügt werden. Wenn Sie beispielsweise das Datum aus dem HTTP-Header ausgeben möchten, können Sie {message.header.date} in Ihre Nachricht einfügen.

Wenn das Nachrichtenformat JSON ist, sieht es etwa so aus:

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

Sie können jedoch sehen, dass es sich um fehlerhaftes JSON handelt. Sie haben zwei Möglichkeiten, dieses Problem zu umgehen:

  • Maskieren Sie die öffnende geschweifte Klammer mit einem umgekehrten Schrägstrich: 
    \{"The date is: " : "{message.header.date}"}
  • Verwenden Sie in der Konfiguration des Nutzlast-Elements 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 Edge for Private Cloud Feature Release können Sie geschweifte Klammern für Variablen in JSON-Nachrichten problemlos verwenden. (APIRT-1160)

Router kann Nginx nicht starten oder Router kann nicht gestartet werden

Wenn der Edge-Router Nginx nicht starten kann oder überhaupt nicht startet, wie in der Datei /opt/apigee/var/log/edge-router/logs/system.log zu sehen ist, 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
16.05.01
Weiter
16.04.2008