Informacje o wersji 4.19.06 Edge dla Private Cloud

Przeglądasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X.
Informacje

W tej sekcji opisano wersję 4.19.06 funkcji Edge dla chmury prywatnej.

Podsumowanie wersji

Tabela poniżej zawiera podsumowanie zmian wprowadzonych w tej wersji:

Nowe funkcje

Ta wersja zawiera następujące nowe funkcje:

○ Obsługa LDAP dla SSO
○ Obsługa wdrażania HTTP
○ Wtyczkowanych narzędzi analitycznych
○ Obsługa stojaków Cassandra
○ Obsługa IPv6
○ Uproszczona instalacja nowego środowiska Edge
○ Wyklucz INVALID_TSC transakcji (generowanie przychodu)

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

Zgodność wsteczna

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

     
  • Ze względu na rozwiązanie problemu 132443137 (jak opisano w informacjach o wersji publicznej Cloud 19.03.01) firmy obsługujące wiadomości ignorują teraz nagłówki zaczynające się od X-Apigee-*. W związku z tym musisz refaktoryzować kod, który używa nagłówków X-Apigee-*, i zastąpić te nagłówki obsługiwanymi.

  • Nazwa plików dziennika Cassandra uległa zmianie. Teraz to:

    /opt/apigee/var/log/apigee-cassandra/system.log
Dołączone wersje

Od poprzedniej wersji funkcji Edge dla chmury prywatnej wystąpiły następujące wersje, które są uwzględnione w tej wersji:

○ Edge:
   19.07.23 (UI)
   19.03.01
   19.02.19
   19.02.04
   19.01.23
{18.19.0}{1.02.


19.01.1418.12.0418.08.3118.07.31
○ Portal:
   19.07.08
   19.05.23
   19.05.08
   19.04.18
   19.03.20
   19.02.2719.02.2119.02.0419.01.16
Emerytury Brak
Elementy wycofane

W wersji 4.19.06 te elementy zostały wycofane:

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

Więcej informacji znajdziesz w artykule o wycofywaniu i wycofaniu Apigee oraz zmianach w CPS.

Poprawki błędów

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

○UseStringDeduplication not set (140270474) (140270474) (140270474) (140270474) (140270474) (140270474) (140270474) (nie ustawiono metody z kodem IP18) (140270474)
8 błędów MP (111445518)
○ Niepowodzenia Cassandra z JMX (113342838)
○ 13-węzeł-13-węzeł1
uaktualnienie hasła w tej samej nazwie Pro13
8 uaktualnienie 13 węzłów w ramach tej samej nazwy Pro1

138931337



HEAD

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

Znane problemy

W tej wersji występują następujące znane problemy:

○ ○ Mint not Assessment transakcji wstępnie (141628497) (141628497) (141628497)
○ Procesor w systemie Linux 6 (w przypadku wycieku informacji z serwera min. – wyciek pamięci)
○ Format pliku metadanych na potrzeby instalacji apigee-sso (135616498)
apigee-monit nieobsługiwany w systemie Amazon 1 (12237098) (135616498) 135616498 (135616498)



Więcej informacji na temat każdego z tych problemów oraz sposobów ich obejścia znajdziesz w artykule Znane problemy.

Ścieżki uaktualnienia

Poniższa tabela przedstawia ścieżki uaktualnienia tej wersji:

From 4.19.01 Bezpośrednio uaktualnić z wersji 4.19.01 → 4.19.06
Od 18.05.2005 Bezpośrednio uaktualnić wersję z wersji 4.18.05 → 4.19.06
Od 18.01.2001 Bezpośrednio uaktualnić wersję z wersji 4.18.01 → 4.19.06

Nowe funkcje

Ta sekcja zawiera listę nowych funkcji dostępnych w tej wersji. Dodatkowo ta wersja obejmuje wszystkie funkcje interfejsu Edge, zarządzania Edge i portalu wymienione na stronie Dołączone wersje.

Oprócz poniższych ulepszeń ta wersja zawiera też wiele ulepszeń w zakresie łatwości obsługi, wydajności, bezpieczeństwa i stabilności.

Obsługa wdrażania HTTP

Domyślnie Edge używa RPC do wdrażania serwerów proxy interfejsu API. Ten tryb działa bardzo dobrze w przypadku większości instalacji, ale w przypadku większych topologii z wieloma MTB mogą wystąpić przekroczenia limitu czasu, gdy za pomocą RPC jest wiele równoczesnych wywołań.

W związku z tym Apigee zaleca, aby w większych wdrożeniach używać protokołu HTTP, a nie RPC. Obsługiwane jest teraz włączanie wdrożeń HTTP.

Więcej informacji znajdziesz w artykule o włączaniu wdrażania HTTP.

Obsługa stojaka Cassandra

Apigee udostępnia teraz ogólne wskazówki dotyczące skalowania operacji Cassandra, zgłaszając Cassandra w Apigee Edge dla Private Cloud.

Więcej informacji znajdziesz w artykule o pomocy dotyczącej stojaków Cassandra.

Podłączone narzędzia analityczne

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

W tej wersji funkcji możesz skonfigurować procesor wiadomości do zapisywania danych analitycznych na dysku. Możesz też korzystać z obu opcji.

Więcej informacji znajdziesz w artykule o zapisywaniu danych analitycznych w pliku.

Uproszczona instalacja nowego środowiska Edge

Instalacja nowej wersji Edge została uproszczona za pomocą nowego skryptu.

Więcej informacji znajdziesz w artykule na temat instalowania nowego środowiska Edge.

Obsługa dostawcy tożsamości LDAP

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

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

Obsługa IPv6

Domyślnie wszystkie wywołania interfejsu API w środowisku wykonawczym kierowane do Apigee Edge dla chmury 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 o korzystaniu z protokołu IPv6 w routerze.

Wyklucz INVALID_TSC transakcji (zarabianie)

Podczas korzystania z funkcji Monetization możesz teraz wykluczyć INVALID_TSC transakcję z dodawania do bazy danych Postgres.

Więcej informacji znajdziesz w artykule o usługach serwera zarabiania.

Obsługiwane oprogramowanie

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

Dodano pomoc Nieobsługiwana

Ta wersja dodaje obsługę następujących platform:

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

Te platformy nie są już obsługiwane w tej wersji:

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

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

Poprawki błędów

Ta sekcja zawiera listę błędów w Private Cloud, które zostały naprawione w tej wersji. Dodatkowo ta wersja zawiera wszystkie poprawki błędów w wersjach interfejsu Edge, zarządzania Edge i portalu widocznych w dołączonych wersjach.

Identyfikator problemu Opis
140270474

Nie ustawiono wartości UseStringDeduplication

Zasób UseStringDeduplication nie był ustawiany dla komponentów edge-message-processor w środowiskach produkcyjnych.
111445518

Błędy MP

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

Awarie Cassandra z JMX

Gdy uwierzytelnianie JMX było włączone, operacje Cassandra nie działały
138931337

Uaktualnienia 13 węzłów

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

Serwery proxy o tej samej nazwie

Jeśli 2 użytkowników w tej samej organizacji utworzy serwery proxy o tych samych nazwach, utworzony drugi użytkownik zastąpi pierwszy. Problem ten występował tylko wtedy, gdy różni użytkownicy nie widzieli drugiego serwera proxy.
118851790

magazyny kluczy się nie ładują

Gdy w organizacji lub środowisku było więcej niż 100 magazynów kluczy, magazyn kluczy i sekcja odwołań w interfejsie Edge nie były wczytywane. Zamiast tego w interfejsie wyświetlany był błąd Internal Error (Error Fetching Keystores).
110988191

Nie udało się przeanalizować

W przypadku dostarczenia danych z mikrobramy, które było ustawione na datę w przyszłości, nie udało się przeanalizować środowiska.
110785400

Niepowodzenia kopii zapasowej

ZooKeeper, Cassandra i OpenLDAP nie mogły prawidłowo utworzyć kopii zapasowej swoich danych. Wystąpił ten błąd: File changed as we read it.
79993247

HEAD żądań do Node.js

Żądania do środowiska docelowego Node.js (HEAD) mogły się zawiesić, co pozostawiło oczekujące połączenia.
70291825

apigee-postgres – kopia zapasowa/przywracanie

Wykonanie tworzenia/przywracania kopii zapasowej apigee-postgres powoduje teraz utworzenie kopii zapasowej danych dla wszystkich komponentów.
65737520

Resetowanie hasła sysadmin

Zresetowanie hasła administratora systemu dla serwera zarządzania, który zawierał znaki specjalne, zakończy się niepowodzeniem.

Znane problemy

Poniższa tabela zawiera listę znanych problemów występujących w tej wersji:

Identyfikator problemu Opis
141628497

Nie oceniaj transakcji na początku

Edge dla chmury Private Cloud początkowo nie ocenia transakcji, gdy po raz pierwszy włączysz zarabianie dla organizacji. Dotyczy to nowych i istniejących organizacji.

Interfejs API do włączania zarabiania w odpowiedzi przekazuje identyfikator zadania, a po jego zakończeniu stan zadania wskazuje na jego realizację. Jednak pierwsze wywołania interfejsu API umożliwiające generowanie przychodu nie będą przetwarzane przez funkcję generowania przychodu i nie będą oceniane. Te transakcje będą widoczne tylko w regularnych statystykach.

Obejście:

Ponownie uruchom wszystkie procesory wiadomości (MP), można wykonać te czynności:
apigee-service edge-message-processor restart

Po włączeniu zarabiania ponowne uruchomienie odtwarzaczy sprawia, że Edge wczytuje konfigurację z ZooKeeper. Dzieje się tak przy każdym ponownym uruchomieniu, co oznacza, że problem występuje tylko na początku.

137865184

Wyciek pamięci serwerów oceny wersji Mint

Gdy nowa instancja Qpid jest zarejestrowana w grupie mxgroup, kolejki tworzą się bez klientów, co skutkuje wzrostem głębokości kolejki do momentu wykorzystania wszystkich dostępnych zasobów.

Obejście:

Brak.
135616498

Format pliku metadanych na potrzeby instalacji apigee-sso

Jeśli instalujesz program apigee-sso i używasz pliku metadanych.xml zamiast adresu URL, a plik metadanych.xml nie zawiera na końcu nowego wiersza (CRLF), plik metadanych.xml nie jest odczytywany w całości.

Obejście:

Aby obejść ten problem, wykonaj jedną z tych czynności:

  • Dodaj CRLF na końcu plikumetadata.xml

    LUB

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

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

Obejście:

Brak.
121095148

Kopia zapasowa procesora wiadomości nie tworzy kopii zapasowej prawidłowego zestawu plików

Obejście:

Ponownie uruchom kopię zapasową, aby utworzyć kopię zapasową prawidłowego zestawu plików.

76087166

DataAccessWyjątek w wielu konfiguracjach centrów danych

Jeśli w wielu konfiguracjach centrów danych 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ądzania może się nie uruchomić, ponieważ próbuje połączyć się z węzłami Cassandra w dc-1 i dc-2. DataAccessExceptions występuje, gdy węzeł Cassandra jest niedostępny. Może to też spowodować zakłócenia w ruchu w interfejsie API, ponieważ procesory wiadomości zgłaszają DataAccessExceptions podczas próby pobrania KVM.

Oczekiwany stan oznacza, że serwer zarządzania nie będzie mógł łączyć się z komponentami magazynu danych w różnych regionach.

Obejście

Obejściem tego problemu jest wyrejestrowanie następujących typów węzłów Cassandra w niedostępnym centrum danych, a następnie ponowne zarejestrowanie ich, gdy węzły Cassandra będą ponownie dostępne:

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

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

  1. Uzyskaj 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 Twojego 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ądzania.
    • GATEWAY_POD to nazwa poda, która jest domyślnie „bramą”. Być może została ona jednak zmieniona na inną, więc sprawdź implementację.
    • CASSANDRA_NODE_TYPE jest jedną z wartości kms-datastore, dc-datastore i keyvaluemap-datastore.

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

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

    Zapisz wartości w polu 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. Pamiętaj, aby zanotować zwracane 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 w poprzednim poleceniu.

  4. Powtórz krok 3 dla każdego identyfikatora UUID zebranego w krokach 1 i 2.
  5. Zarejestruj węzły ponownie 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

Te operacje rejestrują i usuwają węzły z Zookeeper i nie mają żadnego wpływu na klaster Cassandra. Więcej informacji o tych poleceniach znajdziesz w artykule o aktualizowaniu rejestracji w magazynie danych.

68722102

Zasada MessageLogging zawierająca dodatkowe informacje w komunikacie logu

Element FormatMessage zasady MessageLogging określa format zarejestrowanej wiadomości. Gdy ustawiona jest zasada FormatMessage=false, zarejestrowany komunikat nie powinien zawierać żadnych informacji wygenerowanych przez Apigee. Nawet jeśli skonfigurujesz zasadę FormatMessage=false, komunikat dziennika nadal będzie zawierać te informacje:

  • Priorytet
  • sygnaturę czasową;

Obejście:

Brak.

Następny krok

Aby zacząć korzystać z Edge for Private Cloud w wersji 4.19.06, użyj tych linków:

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