19.01.09 – Versionshinweise zu Edge für Private Cloud

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

Am 29. September 2020 haben wir eine neue Version von Apigee Edge for Private Cloud veröffentlicht.

Aktualisierungsvorgang

Durch die Aktualisierung dieses Releases werden die Komponenten in der folgenden Liste von RPMs aktualisiert:

  • edge-gateway-4.19.01-0.0.20095.noarch.rpm
  • edge-management-server-4.19.01-0.0.20095.noarch.rpm
  • edge-message-processor-4.19.01-0.0.20095.noarch.rpm
  • edge-postgres-server-4.19.01-0.0.20095.noarch.rpm
  • edge-qpid-server-4.19.01-0.0.20095.noarch.rpm
  • edge-router-4.19.01-0.0.20095.noarch.rpm
  • apigee-cassandra-2.1.16-0.0.2507.noarch.rpm
  • edge-management-ui-static-4.19.01-0.0.20017.noarch.rpm
  • apigee-setup-4.19.01-0.0.1123.noarch.rpm
  • apigee-mtls-consul-4.19.01-0.0.20129.noarch.rpm
  • apigee-mtls-4.19.01-0.0.20190.noarch.rpm

Sie können die aktuell installierten RPM-Versionen prüfen, um festzustellen, ob sie aktualisiert werden müssen, indem Sie Folgendes eingeben:

apigee-all version

Führen Sie die folgenden Schritte auf den Edge-Knoten aus, um Ihre Installation zu aktualisieren:

  1. Auf allen Edge-Knoten:

    1. Yum-Repositories bereinigen:
      sudo yum clean all
    2. Laden Sie die aktuelle Edge 4.19.01-Datei bootstrap_4.19.01.sh in /tmp/bootstrap_4.19.01.sh herunter:
      curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
    3. Installieren Sie das Edge 4.19.01-apigee-service-Dienstprogramm und die Abhängigkeiten:
      sudo bash /tmp/bootstrap_4.19.01.sh apigeeuser=uName apigeepassword=pWord

      Dabei sind uName:pWord der Nutzername und das Passwort, die Sie von Apigee erhalten haben. Wenn Sie pWord weglassen, werden Sie aufgefordert, sie einzugeben.

    4. Aktualisieren Sie das apigee-setup-Tool:
      sudo /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    5. Führen Sie das apigee-service.sh-Skript mit dem Befehl source aus:
      source /etc/profile.d/apigee-service.sh
  2. Aktualisieren Sie alle Cassandra-Knoten:

    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile

    Dabei gibt configFile die Konfigurationsdatei an, die Sie zum Installieren von Apigee Edge for Private Cloud verwendet haben. Beispiel: /opt/silent.conf.

  3. Führen Sie auf allen Edge-Knoten das update.sh-Skript für den edge-Prozess aus. Führen Sie dazu auf jedem Knoten den folgenden Befehl aus:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  4. Wenn Sie die neue Edge-Benutzeroberfläche verwenden, führen Sie den folgenden Befehl aus:
    /opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
  5. (Nur Apigee mTLS) So aktualisieren Sie Apigee mTLS: Folgen Sie der Anleitung unter Apigee mTLS aktualisieren.

    Weitere Informationen finden Sie unter Einführung in Apigee mTLS.

Unterstützte Software

Keine Änderungen

Einstellung und Außerbetriebnahme

Keine neuen Einstellungen oder Außerbetriebnahmen.

Neue Funktionen

In diesem Abschnitt werden die neuen Funktionen in dieser Version aufgeführt.

JMX-Passwörter verschlüsseln

Sie können jetzt JMX-Passwörter verschlüsseln. Weitere Informationen finden Sie unter JMX-Passwortverschlüsselung aktivieren und JMX-Authentifizierung für Cassandra aktivieren. (150633039)

Fehlerkorrekturen

In der folgenden Tabelle sind die in diesem Release behobenen Fehler aufgeführt:

Problem-ID Beschreibung
159360654

apigee-mtls-Zertifikate waren nur 30 Tage lang gültig.

Neue Zertifikate sind jetzt ein Jahr lang gültig. Informationen zum Aktualisieren eines alten 30‑Tage-Zertifikats mit einem neuen Zertifikat, das ein Jahr lang gültig ist, finden Sie unter Apigee-mTLS aktualisieren.

160890634

Beim Neustart von Message-Prozessoren wurden einige Proxys nicht bereitgestellt.

130416715

Potenzielle Sicherheitslücke aufgrund des „True-Client-IP“-Headers

In diesem Release wird ein neues Access Control Policy-Element eingeführt, IgnoreTrueClientIPHeader, mit dem das Problem behoben wird. Weitere Informationen finden Sie unter IgnoreTrueClientIPHeader-Element.

132654321

In den Audit-Logs wurden Nutzer, deren Rollen aktualisiert wurden, nicht angezeigt.

Nachdem Sie Rollen für vorhandene Nutzer geändert oder einen vorhandenen Nutzer einer Organisation hinzugefügt haben, wurde im Audit-Log „Update user undefined“ angezeigt. Dadurch konnten Sie nicht sehen, für wen die Aktion ausgeführt wurde.

160951701

Die mTLS-Installation ist aufgrund einer veralteten Consul-Binärversion fehlgeschlagen.

Die Consul-Binärdatei wurde von Version 1.6.2 auf die aktuelle stabile Version 1.8.0 aktualisiert.

160916451

Die mTLS-Installation schlug fehl, weil ein Eintrag für das Feld „Consul“ bindaddr fehlte.

apigee-mtls verarbeitet jetzt Server mit mehreren Netzwerkschnittstellen und Adressen korrekt.

133145969

Dokumentation zum Deaktivieren von Protokollen in der Benutzeroberfläche fehlte

Die neue Dokumentation finden Sie unter TLS-Protokolle deaktivieren.

Bekannte Probleme

In der folgenden Tabelle sind bekannte Probleme in dieser Version aufgeführt:

Problem-ID Beschreibung
149245401

Problem mit dem Verbindungspooling für die LDAP-Richtlinie

LDAP-Verbindungspool-Properties, die mit der LDAP-Ressource angegeben werden, werden nicht berücksichtigt. Daher werden Verbindungen jedes Mal für die einmalige Verwendung geöffnet und geschlossen, was zu einer großen Anzahl von Verbindungen pro Stunde zum LDAP-Server führt.

Workaround:

Wenn Sie die Eigenschaften des LDAP-Verbindungspools ändern möchten, führen Sie die folgenden Schritte aus, um eine globale Änderung für alle LDAP-Richtlinien festzulegen.

  1. Erstellen Sie eine Konfigurationsattributdatei, falls sie noch nicht vorhanden ist:
    /opt/apigee/customer/application/message-processor.properties
  2. Fügen Sie der Datei Folgendes hinzu (ersetzen Sie die Werte der JNDI-Attribute (Java Naming and Directory Interface) entsprechend den Anforderungen Ihrer LDAP-Ressourcenkonfiguration).
    bin_setenv_ext_jvm_opts="-Dcom.sun.jndi.ldap.connect.pool.maxsize=20
    -Dcom.sun.jndi.ldap.connect.pool.prefsize=2
    -Dcom.sun.jndi.ldap.connect.pool.initsize=2
    -Dcom.sun.jndi.ldap.connect.pool.timeout=120000
    -Dcom.sun.jndi.ldap.connect.pool.protocol=ssl"
  3. Achten Sie darauf, dass die Datei /opt/apigee/customer/application/message-processor.properties dem Nutzer „apigee:apigee“ gehört.
  4. Starten Sie jeden Message Processor neu.

Wenn Sie prüfen möchten, ob die JNDI-Eigenschaften Ihres Verbindungspools wirksam werden, können Sie einen tcpdump durchführen, um das Verhalten des LDAP-Verbindungspools im Zeitverlauf zu beobachten.