Informacje o wersji 4.19.06 Edge dla Private Cloud

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

W tej sekcji opisujemy wersję 4.19.06 funkcji Edge for Private Cloud.

Podsumowanie wersji

W tabeli poniżej znajdziesz podsumowanie zmian w tej wersji:

Nowe funkcje

Ta wersja zawiera te nowe funkcje:

○ Obsługa LDAP w przypadku SSO
○ Obsługa wdrażania HTTP
○ Wtykowe usługi analityczne
○ Obsługa szaf Cassandra
○ Obsługa IPv6
○ Uproszczona instalacja New Edge Experience
○ Wykluczanie transakcji INVALID_TSC (Monetyzacja)

Więcej informacji o każdej z tych nowych funkcji znajdziesz w sekcji Nowe funkcje.

Zgodność wsteczna

W tej wersji Apigee Edge Private Cloud wprowadzono te problemy wpływające na zgodność wsteczną:

     
  • W związku z rozwiązaniem problemu 132443137 (opisanym w informacjach o wersji 19.03.01 Cloud) procesory wiadomości ignorują teraz nagłówki zaczynające się od znaku X-Apigee-*. W związku z tym musisz zmodyfikować każdy kod, który używa nagłówków X-Apigee-*, i zastąpić je obsługiwanymi nagłówkami.

  • Nazwy plików dziennika Cassandra zostały zmienione. Obecnie jest to:

    /opt/apigee/var/log/apigee-cassandra/system.log
Uwzględnione wersje

Od poprzedniej wersji funkcji Edge dla chmury prywatnej pojawiły się te wersje:

○ Edge:
   19.07.23 (UI)
   19.03.01
   19.02.19
   19.02.04
   19.01.23
   19.01.14
   18.12.04
   18.08.31
   18.07.31
○ Portal:
   19.07.08
   19.05.23
   19.05.08
   19.04.18
   19.03.20
   19.02.27
   19.02.21
   19.02.04
   19.01.16
Wycofania Brak
Elementy wycofane

W wersji 4.19.06 wycofujemy te elementy:

  • 4.18.01: wersja 4.18.01 Apigee Edge for Private Cloud została wycofana.

Więcej informacji znajdziesz w artykule Wycofania, wyłączenia i zmiany w usłudze Apigee CPS.

Poprawki błędów

Ta wersja zawiera następujące poprawki błędów:

○ UseStringDeduplication not set (140270474)
○ MP errors (111445518)
○ Cassandra failures with JMX (113342838)
○ 13-node upgrades (138931337)
○ Proxies with the same name (119802562)
○ Keystores not loading (118851790)
○ Analytics failed (110988191)
○ Backup failures (110785400)
HEAD requests to Node.js (79993247)
○ apigee-postgres backup/restore (70291825)
○ Resetting sysadmin password (65737520)

Więcej informacji o każdej z tych poprawek znajdziesz w sekcji Poprawki błędów.

Znane problemy

W tej wersji występują te znane problemy:

○ Mint nie ocenia początkowo transakcji (141628497)
○ Wyciek pamięci na serwerach oceny Mint (137865184)
○ Format pliku metadanych do instalacji apigee-sso (135616498)
○ apigee-monit nie jest obsługiwany w systemie Amazon Linux 1 (122370980)
○ Kopia zapasowa procesora wiadomości nie tworzy kopii zapasowej prawidłowego zestawu plików (121095148)
○ DataAccessExceptions w konfiguracjach z wieloma centrami danych (76087166)
○ Zasady MessageLogging zawierające dodatkowe informacje w wiadomości dziennika (68722102)

Więcej informacji o każdym z tych znanych problemów, w tym o sposobach ich obejścia, znajdziesz w sekcji Znane problemy.

Ścieżki uaktualnienia

W tabeli poniżej znajdziesz ścieżki przejścia na wyższą wersję w przypadku tej wersji:

Od wersji 4.19.01 Bezpośrednie uaktualnienie z wersji 4.19.01 do 4.19.06
Od 18.05 Bezpośrednie uaktualnienie z wersji 4.18.05 do 4.19.06
Od 4.18.01 Bezpośrednia aktualizacja z wersji 4.18.01 do 4.19.06

Nowe funkcje

W tej sekcji znajdziesz listę nowych funkcji w tej wersji. Ta wersja zawiera też wszystkie funkcje z wersji interfejsu Edge, zarządzania Edge i portalu wymienione w sekcji Dołączone wersje.

Oprócz poniższych ulepszeń ta wersja zawiera też wiele ulepszeń dotyczących użyteczności, wydajności, bezpieczeństwa i stabilności.

Obsługa wdrożeń HTTP

Domyślnie Edge używa RPC do wdrażania proxy interfejsu API. Ten tryb sprawdza się w większości instalacji, ale w przypadku większych topologii z wieloma procesorami wiadomości mogą występować przekroczenia limitu czasu, gdy przez RPC jest wykonywana duża liczba wywołań równoczesnych.

Dlatego w przypadku większych wdrożeń Apigee zaleca używanie protokołu HTTP zamiast RPC. Włączanie wdrożeń HTTP jest teraz obsługiwane.

Więcej informacji znajdziesz w artykule Włączanie wdrażania HTTP.

Obsługa szaf Cassandra

Apigee udostępnia teraz ogólne wskazówki dotyczące skalowania operacji Cassandra, dzięki czemu Cassandra w Apigee Edge Private Cloud jest świadoma regałów.

Więcej informacji znajdziesz w artykule Obsługa szaf Cassandra.

Możliwość podłączenia narzędzi analitycznych

Domyślnie dane analityczne zebrane przez procesor komunikatów są przesyłane do Qpid i Postgres w celu przetworzenia. Dane analityczne możesz potem wyświetlać w interfejsie Edge.

W tej wersji funkcji możesz skonfigurować procesor komunikatów tak, aby zapisywał dane analityczne na dysku, lub możesz używać obu opcji.

Więcej informacji znajdziesz w artykule Zapisywanie danych analitycznych w pliku.

Uproszczona instalacja nowej wersji Edge

Instalacja nowej wersji Edge została uproszczona dzięki nowemu skryptowi.

Więcej informacji znajdziesz w artykule Instalowanie nowego środowiska Edge.

Obsługa dostawcy tożsamości LDAP

Uwierzytelnianie użytkowników za pomocą interfejsu Edge UI i wywołań interfejsu API zarządzania Edge obsługuje teraz LDAP oprócz SAML. Obsługa LDAP obejmuje zarówno metody wiązania bezpośredniego, jak i pośredniego.

Więcej informacji znajdziesz w omówieniu uwierzytelniania zewnętrznego dostawcy tożsamości.

Obsługa IPv6

Domyślnie wszystkie wywołania interfejsu API środowiska wykonawczego do Apigee Edge dla chmury prywatnej używają protokołu IPv4. Możesz dodać obsługę IPv6 do routera za pomocą nowej usługi.

Więcej informacji znajdziesz w artykule Korzystanie z IPv6 na routerze.

Wyklucz transakcje INVALID_TSC (zarabianie)

Możesz teraz wykluczać transakcje INVALID_TSC z dodawania do bazy danych Postgres podczas korzystania z funkcji zarabiania.

Więcej informacji znajdziesz w artykule Właściwości serwera do zarabiania.

Obsługiwane oprogramowanie

Ta wersja zawiera następujące zmiany w obsługiwanym oprogramowaniu:

Dodano pomoc Już nieobsługiwane

W tej wersji dodaliśmy obsługę tych platform:

  • Red Hat Enterprise Linux (RHEL) 6.10
  • CentOS 6.10
  • Oracle Linux 6.9

W tej wersji nie są już obsługiwane te platformy:

  • Red Hat Enterprise Linux (RHEL) 6.9
  • CentOS 6.9
  • Oracle 6.8

Pełną listę obsługiwanych platform znajdziesz w artykule Obsługiwane oprogramowanie i wersje.

Poprawki błędów

W tej sekcji znajdziesz listę błędów chmury prywatnej, które zostały poprawione w tej wersji. Dodatkowo ta wersja zawiera wszystkie poprawki błędów w wersjach interfejsu Edge, zarządzania Edge i portalu wymienionych w sekcji Dołączone wersje.

Identyfikator problemu Opis
140270474

UseStringDeduplication nie jest ustawione

W przypadku komponentów edge-message-processor w środowiskach produkcyjnych nie ustawiano wartości UseStringDeduplication.
111445518

Błędy MP

Procesory wiadomości co 5 minut rejestrowały ten komunikat o błędzie:
2019-06-29 00:02:05,775 Apigee-Timer-6 ERROR CMgmt -
  ConnectorServiceImpl.refreshToken() : Connector Management API auth token
  generation failed: 0 null
113342838

Błędy Cassandra z JMX

Operacje Cassandra nie działały, gdy włączone było uwierzytelnianie JMX
138931337

Uaktualnienia 13 węzłów

Uaktualnienia instalacji 13-węzłowych z wersji 17.09, 18.01 i 18.05 kończyły się niepowodzeniem.
119802562

Serwery proxy o tej samej nazwie

Jeśli 2 użytkowników w tej samej organizacji utworzyło proxy o tych samych nazwach, drugie utworzone proxy zastąpi pierwsze. Dzieje się tak tylko wtedy, gdy różni użytkownicy nie widzą drugiego serwera proxy.
118851790

Nie można wczytać magazynów kluczy

Gdy organizacja lub środowisko miało więcej niż 100 magazynów kluczy, sekcja magazynu kluczy i odwołań w interfejsie Edge nie wczytywała się. Zamiast tego w interfejsie wyświetlił się błąd Internal Error (Error Fetching Keystores).
110988191

Analytics failed

Analytics nie działał w środowisku, do którego dostarczono dane z mikrobrany ustawione na datę w przyszłości.
110785400

Błędy tworzenia kopii zapasowej

Usługi ZooKeeper, Cassandra i OpenLDAP okresowo nie mogły prawidłowo tworzyć kopii zapasowych danych z powodu tego błędu: File changed as we read it.
79993247

HEAD żądania do Node.js

HEAD żądania kierowane do miejsca docelowego Node.js mogły się zawieszać, co powodowało, że połączenia pozostawały w stanie oczekiwania.
70291825

apigee-postgres backup/restore

Wykonanie kopii zapasowej lub przywrócenie apigee-postgres powoduje teraz utworzenie kopii zapasowej danych wszystkich komponentów.
65737520

Resetowanie hasła administratora systemu

Resetowanie hasła administratora systemu na serwerze zarządzania, które zawierało znaki specjalne, nie powiodło się.

Znane problemy

W tej wersji występują te znane problemy:

Identyfikator problemu Opis
141628497

Mint nie ocenia początkowo transakcji

Gdy po raz pierwszy włączysz monetyzację w organizacji, Edge for the Private Cloud nie będzie początkowo oceniać transakcji. Dotyczy to nowych i istniejących organizacji.

Interfejs API włączania zarabiania odpowiada identyfikatorem zadania, a po zakończeniu zadania jego stan będzie wskazywać powodzenie. Jednak wywołania interfejsu API, które początkowo były objęte zarabianiem, nie będą przetwarzane w ramach zarabiania i nie będą oceniane. Te transakcje będą widoczne tylko w standardowych statystykach.

Obejście:

Uruchom ponownie wszystkie procesory wiadomości, wykonując te czynności:
apigee-service edge-message-processor restart

Po włączeniu zarabiania ponowne uruchomienie procesorów wiadomości powoduje, że Edge wczytuje konfigurację z ZooKeepera podczas uruchamiania. Dzieje się tak przy każdym ponownym uruchomieniu, co oznacza, że problem występuje tylko na początku.

137865184

Wyciek pamięci na serwerach ocen Mint

Gdy w grupie mxgroup zostanie zarejestrowana nowa instancja Qpid, kolejki będą się tworzyć bez odbiorców, co spowoduje wzrost głębokości kolejki, dopóki nie wykorzysta ona wszystkich dostępnych zasobów.

Obejście:

Brak.
135616498

Format pliku metadanych na potrzeby instalacji apigee-sso

Podczas instalowania apigee-sso i używania pliku metadata.xml zamiast adresu URL, jeśli plik metadata.xml nie zawiera na końcu znaku nowego wiersza (CRLF), nie jest on w całości odczytywany.

Obejście:

Aby obejść ten problem, możesz wykonać jedną z tych czynności:

  • Dodaj znak CRLF na końcu pliku metadata.xml.

    LUB

  • Użyj lokalizacji metadanych opartej na adresie URL.
122370980

apigee-monit nie jest obsługiwany w systemie Amazon Linux 1

Obejście:

Brak.
121095148

Kopia zapasowa procesora komunikatów nie zawiera prawidłowego zestawu plików

Obejście:

Uruchom kopię zapasową po raz drugi. Powinna ona utworzyć kopię zapasową prawidłowego zestawu plików.

76087166

DataAccessException w konfiguracjach z wieloma centrami danych

W konfiguracjach z wieloma centrami danych, jeśli jeden magazyn danych stanie się niedostępny, może pojawić się ten błąd:

DataAccessException: Error while accessing datastore;
Please retry later

W rezultacie serwer zarządzający może się nie uruchomić, ponieważ próbuje połączyć się z węzłami Cassandry w obu centrach danych (dc-1 i dc-2). Symbol DataAccessExceptions pojawia się, gdy węzeł Cassandra jest niedostępny. Może to również spowodować zakłócenia w ruchu API, w przypadku których procesory wiadomości zgłaszają błędy DataAccessExceptions podczas próby pobrania map klucz-wartość.

Pamiętaj, że oczekiwany stan to brak połączenia serwera zarządzania z komponentami magazynu danych w różnych regionach.

Obejście

Obejście polega na wyrejestrowaniu w niedostępnym centrum danych tych typów węzłów Cassandra, a następnie ponownym zarejestrowaniu ich po ponownym udostępnieniu węzłów Cassandra:

  • kms-datastore
  • dc-datastore
  • keyvaluemap-datastore

Aby wyrejestrować i ponownie zarejestrować te typy węzłów Cassandra:

  1. Pobierz identyfikatory UUID węzłów Cassandra, używając tego polecenia curl:
    curl -u ADMIN_EMAIL:ADMIN_PW \
      "http://MS_IP:MS_PORT/v1/servers?region=REGION&pod=GATEWAY_POD \
      &type=CASSANDRA_NODE_TYPE"

    Gdzie:

    • ADMIN_EMAILADMIN_PW to dane logowania do konta Apigee.
    • MS_IPMS_PORT to adres IP i numer portu serwera zarządzającego.
    • REGION to nazwa centrum danych, w którym znajduje się serwer zarządzający.
    • GATEWAY_POD to nazwa poda, która domyślnie ma wartość „gateway”. Możliwe jednak, że została zmieniona na inną nazwę, więc sprawdź implementację.
    • CASSANDRA_NODE_TYPE to jedna z tych wartości: kms-datastore, dc-datastorekeyvaluemap-datastore.

    Na przykład:

    curl -u nickdanger@google.com:myP@$$w0rD
      "http://192.168.0.1:8080/v1/servers?region=dc-1&pod=gateway&type=dc-datastore"

    Odpowiedź jest w tym formacie:

    {
      "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"
    }

    Na przykład:

    {
      "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"
    }

    Zwróć uwagę na wartości pola uUID w odpowiedzi. Użyjesz ich do wyrejestrowania węzłów.

  2. Powtórz krok 1 w przypadku każdego typu węzła Cassandra: kms-datastore, dc-datastorekeyvaluemap-datastore. Zapisz zwrócone identyfikatory UUID.
  3. Wyrejestruj węzły za pomocą tego polecenia:
    curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers/UUID" -X DELETE

    gdzie UUID to identyfikator UUID zwrócony w odpowiedzi na poprzednie polecenie.

  4. Powtórz krok 3 w przypadku każdego identyfikatora UUID zebranego w krokach 1 i 2.
  5. Ponownie zarejestruj węzły za pomocą tego polecenia:
    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

Pamiętaj, że te operacje rejestrują i wyrejestrowują węzły z Zookeepera i nie mają wpływu na klaster Cassandra. Więcej informacji o tych poleceniach znajdziesz w artykule Aktualizowanie rejestracji baz danych.

68722102

Zasady MessageLogging, które zawierają dodatkowe informacje w komunikacie logu

Element FormatMessage zasady MessageLogging określa format rejestrowanej wiadomości. Gdy wartość to FormatMessage=false, zalogowana wiadomość nie powinna zawierać żadnych informacji wygenerowanych przez Apigee. Nawet jeśli ustawisz wartość FormatMessage=false, komunikat logu będzie zawierać te informacje:

  • Wynik priorytetu
  • Sygnatura czasowa

Obejście:

Brak.

Następny krok

Aby rozpocząć korzystanie z Edge for Private Cloud 4.19.06, skorzystaj z tych linków:

Nowe instalacje:
Omówienie nowych instalacji
Istniejące instalacje:
Ścieżki przejścia na wyższą wersję