4.19.01.09 – Informacje o wersji Edge dla Private Cloud

Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. info

29 września 2020 r. udostępniliśmy nową wersję Apigee Edge for Private Cloud.

Procedura aktualizacji

Aktualizacja tej wersji spowoduje zaktualizowanie komponentów z tej listy pakietów RPM:

  • 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

Aby sprawdzić, czy zainstalowane wersje pakietów RPM wymagają aktualizacji, wpisz:

apigee-all version

Aby zaktualizować instalację, wykonaj te czynności na węzłach brzegowych:

  1. Na wszystkich węzłach brzegowych:

    1. Wyczyść repozytoria Yum: 
      sudo yum clean all
    2. Pobierz najnowszy plik Edge 4.19.01 bootstrap_4.19.01.sh, aby /tmp/bootstrap_4.19.01.sh: 
      curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
    3. Zainstaluj narzędzie Edge 4.19.01 apigee-service i zależności: 
      sudo bash /tmp/bootstrap_4.19.01.sh apigeeuser=uName apigeepassword=pWord

      gdzie uName:pWord to nazwa użytkownika i hasło otrzymane od Apigee. Jeśli pominiesz pWord, pojawi się prośba o jego wpisanie.

    4. Zaktualizuj narzędzie apigee-setup: 
      sudo /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    5. Użyj polecenia source, aby wykonać skrypt apigee-service.sh: 
      source /etc/profile.d/apigee-service.sh

  2. Zaktualizuj wszystkie węzły Cassandra:

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

    gdzie configFile określa plik konfiguracji użyty do zainstalowania Apigee Edge na potrzeby chmury prywatnej. Na przykład: /opt/silent.conf.

  3. Na wszystkich węzłach brzegowych wykonaj skrypt update.sh dla procesu edge. Aby to zrobić, uruchom na każdym węźle to polecenie: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  4. Jeśli korzystasz z nowej wersji Edge, uruchom to polecenie: 
    /opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
  5. (Tylko Apigee mTLS) Aby zaktualizować Apigee mTLS: wykonaj procedurę opisaną w artykule Uaktualnianie Apigee mTLS.

    Więcej informacji znajdziesz w artykule Wprowadzenie do wzajemnego uwierzytelniania TLS w Apigee.

Obsługiwane oprogramowanie

Bez zmian.

Wycofania i zakończenia

Brak nowych wycofań ani zakończeń obsługi.

Nowe funkcje

W tej sekcji znajdziesz listę nowych funkcji w tej wersji.

Szyfrowanie haseł JMX

Możesz teraz szyfrować hasła JMX. Więcej informacji znajdziesz w artykułach Włączanie szyfrowania haseł JMX i Włączanie uwierzytelniania JMX w przypadku Cassandry. (150633039)

Poprawione błędy

W tej wersji naprawiliśmy te błędy:

Identyfikator problemu Opis
159360654

Certyfikaty apigee-mtls były ważne tylko przez 30 dni.

Nowe certyfikaty są teraz ważne przez rok. Aby zastąpić stary 30-dniowy certyfikat nowym certyfikatem ważnym przez rok, zapoznaj się z artykułem Uaktualnianie MTLS Apigee.
160890634

Po ponownym uruchomieniu procesorów wiadomości niektóre serwery proxy nie zostały wdrożone.
130416715

Potencjalna luka w zabezpieczeniach z powodu nagłówka „True-Client-IP”

W tej wersji wprowadziliśmy nowy element zasad kontroli dostępu, IgnoreTrueClientIPHeader, który rozwiązuje ten problem. Zobacz element IgnoreTrueClientIPHeader.
132654321

W dziennikach audytu nie byli widoczni użytkownicy, których role zostały zaktualizowane.

Po wprowadzeniu zmian w rolach obecnych użytkowników lub dodaniu obecnego użytkownika do organizacji w dzienniku kontrolnym pojawiał się komunikat „Update user undefined” (Zaktualizowano niezdefiniowanego użytkownika), który uniemożliwiał sprawdzenie, którego użytkownika dotyczyło działanie.
160951701

Instalacja mTLS nie powiodła się z powodu nieaktualnej wersji binarnej Consul.

Plik binarny Consul został uaktualniony z wersji 1.6.2 do najnowszej stabilnej wersji 1.8.0.
160916451

Instalacja mTLS nie powiodła się z powodu braku wpisu w polu Consulbindaddr.

apigee-mtls prawidłowo obsługuje teraz serwery z wieloma interfejsami sieciowymi i adresami.
133145969

Brakowało dokumentacji dotyczącej wyłączania protokołów w interfejsie

Nową dokumentację znajdziesz w artykule wyłączanie protokołów TLS.

Znane problemy

W tej wersji występują te znane problemy:

Identyfikator problemu Opis
149245401

Problem z puli połączeń w zasadach LDAP

Właściwości puli połączeń LDAP określone za pomocą zasobu LDAP nie działają. W rezultacie połączenia są otwierane i zamykane za każdym razem do jednorazowego użytku, co powoduje dużą liczbę połączeń z serwerem LDAP w ciągu godziny.

Obejście:

Aby zmienić właściwości puli połączeń LDAP, wykonaj te czynności, aby wprowadzić globalną zmianę we wszystkich zasadach LDAP.

  1. Utwórz plik właściwości konfiguracji, jeśli jeszcze nie istnieje: 
    /opt/apigee/customer/application/message-processor.properties
  2. Dodaj do pliku te wiersze (zastąp wartości właściwości Java Naming and Directory Interface (JNDI) zgodnie z wymaganiami konfiguracji zasobu LDAP). 
    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. Upewnij się, że plik /opt/apigee/customer/application/message-processor.properties należy do użytkownika apigee:apigee.
  4. Uruchom ponownie każdy procesor wiadomości.

Aby sprawdzić, czy właściwości JNDI puli połączeń działają, możesz wykonać tcpdump, aby obserwować zachowanie puli połączeń LDAP w czasie.