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 dla chmury prywatnej.

Podsumowanie wersji

W tabeli poniżej znajdziesz podsumowanie zmian wprowadzonych 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
○ Wykluczanie transakcji INVALID_TSC (zarabianie)

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 Public 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 for Private Cloud miały miejsce 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

Wraz z wersją 4.19.06 wycofujemy te elementy:

  • 4.18.01: wersja 4.18.01 Apigee Edge dla chmury prywatnej została wycofana.

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

Poprawki błędów

Ta wersja zawiera te 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 poszczególnych poprawkach znajdziesz w sekcji Poprawki błędów.

Znane problemy

Ta wersja zawiera 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 uaktualniania

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średnie uaktualnienie 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 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 działa bardzo dobrze w przypadku większości instalacji, ale w przypadku większych topologii z wieloma procesorami wiadomości mogą wystąpić 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żliwe do podłączenia narzędzia analityczne

Domyślnie dane analityczne zbierane przez procesor komunikatów są przesyłane do Qpid i Postgres w celu przetworzenia. Dane analityczne możesz następnie wyświetlić w interfejsie Edge.

W ramach 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 interfejsu Edge.

Obsługa dostawcy tożsamości LDAP

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

Więcej informacji znajdziesz w artykule Omówienie uwierzytelniania za pomocą zewnętrznego dostawcy tożsamości.

Obsługa IPv6

Domyślnie wszystkie wywołania interfejsu API środowiska wykonawczego do Apigee Edge w chmurze prywatnej używają protokołu IPv4. Możesz dodać obsługę IPv6 do routera za pomocą nowej właściwości.

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 związane z zarabianiem.

Obsługiwane oprogramowanie

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

Dodano pomoc Już nieobsługiwane

Ta wersja dodaje 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 w chmurze prywatnej, które zostały naprawione w tej wersji. Ta wersja zawiera też wszystkie poprawki błędów w interfejsie Edge, zarządzaniu Edge i wersjach Portalu wymienionych w sekcji Dołączone wersje.

Identyfikator problemu Opis
140270474

UseStringDeduplication nie jest ustawiona

UseStringDeduplication nie było ustawiane w przypadku komponentów edge-message-processor w środowiskach produkcyjnych.
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. Działo się tak tylko wtedy, gdy różni użytkownicy nie mogli zobaczyć drugiego serwera proxy.
118851790

Nie można wczytać magazynów kluczy

Gdy w organizacji lub środowisku było ponad 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

Analiza nie powiodła się

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 wykonać kopii zapasowej 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 spowoduje 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 zarabianie 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 generowały przychody, nie będą przetwarzane w ramach zarabiania i nie będą oceniane. Te transakcje będą widoczne tylko w zwykłych 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 komunikatów powoduje, że Edge wczytuje konfigurację z ZooKeeper 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, aż wykorzysta ona wszystkie dostępne zasoby.

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 tworzy kopii zapasowej prawidłowego zestawu plików

Obejście:

Uruchom tworzenie kopii zapasowej po raz drugi. Powinno ono 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 obszarach 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 interfejsu API, w przypadku których procesory wiadomości zgłaszają błąd DataAccessExceptions podczas próby pobrania map kluczy do wartości.

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:

  • 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 za pomocą 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_EMAIL i ADMIN_PW to dane logowania do konta Apigee.
    • MS_IP i MS_PORT to adres IP i numer portu serwera zarządzania.
    • 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 nazwa została zmieniona, więc sprawdź implementację.
    • CASSANDRA_NODE_TYPE to jedna z tych wartości: kms-datastore, dc-datastore i keyvaluemap-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ź ma następujący format:

    {
      "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 dla każdego typu węzła Cassandra: kms-datastore, dc-datastore i keyvaluemap-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 magazynu danych.

68722102

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

Element FormatMessage w zasadach MessageLogging określa format rejestrowanej wiadomości. Gdy 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ę