Informacje o wersji 4.19.06 Edge dla Private Cloud

Przeglądasz dokumentację Apigee Edge.
Przejdź do Dokumentacja Apigee X.
informacje.

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

Podsumowanie wersji

W tej tabeli znajdziesz podsumowanie zmian wprowadzonych w tej wersji:

Nowe funkcje

Ta wersja zawiera następujące nowe funkcje:

○ Obsługa LDAP do logowania jednokrotnego
○ Obsługa wdrażania HTTP
○ Gotowe narzędzia analityczne
○ Obsługa stelażu Cassandra
○ Obsługa IPv6
○ Uproszczona instalacja nowej Edge
○ Wyklucz INVALID_TSC transakcji (zarabianie)

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

Zgodność wsteczna

W tej wersji pojawiły się podane niżej problemy mające wpływ na zgodność wsteczną Apigee Edge dla Private Cloud:

     
  • Z powodu poprawki problemu 132443137 (jak opisano w 19.03.01 Public informacje o wersji Cloud), firmy przetwarzające wiadomości ignorują teraz nagłówki zaczynające się od X-Apigee-* Musisz więc zmodyfikować każdy kod, który korzysta X-Apigee-* i zastąp je obsługiwanymi.

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

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

Od poprzedniej wersji funkcji Edge dla Private Cloud w kolejnych wersjach które wystąpiły i są uwzględnione w tej wersji:

○ Krawędź:
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
Emerytura Brak
Elementy wycofane

W wersji 4.19.06 wycofaliśmy te elementy:

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

Więcej informacji: Wycofanie i wycofanie Apigee oraz CPS zmian.

Poprawki błędów

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

○ Nie ustawiono wartości UseStringDeduplikacja (140270474)
○ Błędy MP (111445518)
○ Awaria Cassandra z JMX (113342838)
○ Uaktualnienia 13 węzłów (138931337)
○ Serwery proxy o tej samej nazwie (119802562)
○ Magazyny kluczy się nie ładują (118851790)
○ Analytics – błąd (110988191)
○ Błędy tworzenia kopii zapasowej (110785400)
○ Żądania do Node.js: HEAD (79993247)
○ tworzenie/przywracanie kopii zapasowej apigee-postgres (70291825)
○ Resetowanie hasła sysadmin (65737520)

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:

○ Początkowo brak oceny transakcji (141628497)
○ Wyciek pamięci serwerów oceny min. (137865184)
○ Format pliku metadanych 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 właściwego zestawu plików (121095148)
○ Wyjątki DataAccessException w konfiguracjach wielu centrów danych (76087166)
○ Zasady MessageLogging, w tym dodatkowe informacje w komunikacie logu (68722102)

Więcej informacji na temat każdego z tych znanych problemów, w tym sposoby ich obejścia, znajdziesz pod adresem Znane problemy.

Ścieżki uaktualnienia

W tej tabeli znajdziesz ścieżki uaktualnienia tej wersji:

Od 19.04.01 Bezpośrednio przejść z wersji 4.19.01 → 19.06.
Od 18.04.05 Bezpośrednio przejść z wersji 4.18.05 → 19.06.
Od 18.04.2018 Bezpośrednio przejdź na wersję 4.18.01 → 19.06.

Nowe funkcje

W tej sekcji znajdziesz nowe funkcje dostępne w tej wersji. Dodatkowo ta wersja zawiera wszystkie w interfejsie Edge oraz wersjach zarządzania brzegiem i portalach wymienionych w Uwzględnione wydania.

Oprócz wprowadzenia opisanych poniżej ulepszeń wersja ta zawiera również wiele funkcji: zwiększanie wydajności, bezpieczeństwa i stabilności systemu.

Obsługa wdrażania HTTP

Domyślnie Edge używa RPC do wdrażania serwerów proxy API. Ten tryb działa bardzo dobrze w większości przypadków, instalacji, w przypadku większych topologii z wieloma MP może wystąpić czas oczekiwania, gdy równoczesne wywołania są wykonywane przez RPC.

W związku z tym Apigee zaleca, aby dla większych wdrożeń wykorzystywała protokół HTTP, a nie RPC lub wdrożenia. Obsługa wdrożeń HTTP jest teraz obsługiwana.

Więcej informacji znajdziesz w sekcji Włączanie HTTP wdrożenia.

Obsługa stelażu systemu Cassandra

Apigee udostępnia teraz ogólne wskazówki dotyczące skalowania operacji Cassandra przez ustawienie Cassandra w Apigee Edge na potrzeby wykrywania stojaka w chmurze prywatnej.

Więcej informacji: Obsługa szaf serwerowych Cassandra.

Wygodne narzędzia analityczne

Domyślnie dane analityczne zebrane przez procesor wiadomości są przesyłane do Qpid i Postgres do przetworzenia. Dzięki temu możesz wyświetlać dane analityczne w interfejsie Edge.

Dzięki tej wersji funkcji możesz skonfigurować procesor wiadomości tak, aby zapisywał dane analityczne w dysku. Możesz też skorzystać z obu opcji.

Więcej informacji: Zapisywanie danych analitycznych w pliku.

Uproszczona instalacja nowej Edge

Instalacja nowego skryptu została uproszczona za pomocą nowego skryptu.

Więcej informacji znajdziesz w artykule Instalowanie nowej wersji Edge.

Obsługa dostawcy tożsamości LDAP

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

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

Obsługa IPv6

Domyślnie wszystkie wywołania interfejsu API środowiska wykonawczego do Apigee Edge dla chmury prywatnej korzystają z protokołu IPv4. Możesz dodać adres IPv6 routera za pomocą nowej właściwości.

Więcej informacji znajdziesz w sekcji Korzystanie z protokołu IPv6 Router

Wyklucz INVALID_TSC transakcje (zarabianie)

Możesz teraz wykluczyć INVALID_TSC transakcji z dodawania do Postgres w bazie danych w ramach funkcji zarabiania.

Więcej informacji znajdziesz w artykule Zarabianie. właściwości serwera.

Obsługiwane oprogramowanie

W tej wersji wprowadzono następujące zmiany w obsługiwanym oprogramowaniu:

Dodano pomoc Już nieobsługiwane

Ta wersja obsługuje te platformy:

  • 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 na stronie Obsługiwane oprogramowanie i obsługiwane wersje

Poprawki błędów

Ta sekcja zawiera błędy Private Cloud, które zostały naprawione w tej wersji. Dodatkowo zawiera wszystkie poprawki błędów w interfejsie Edge UI, Edge Management oraz wersjach portalu Uwzględnione wydania.

Identyfikator problemu Opis
140270474

Nie ustawiono wartości UseStringDeduplication

UseStringDeduplication – nie przygotowywanie dla edge-message-processor komponentów w środowisku produkcyjnym w różnych środowiskach.
111445518

Błędy MP

Procesory wiadomości stale logował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

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

Uaktualnianie 13 węzłów

Uaktualnianie instalacji 13-węzłów w wersjach 17.09, 18.01 i 18.05 nie powiodło się.
119802562

Serwery proxy o tej samej nazwie

Jeśli 2 użytkowników w tej samej organizacji utworzyło serwery proxy o takich samych nazwach spowoduje zastąpienie pierwszego elementu. Dzieje się tak tylko wtedy, gdy różni użytkownicy nie widzą drugiego serwera proxy.
118851790

Magazyny kluczy się nie ładują

Gdy dla organizacji/środowiska było ponad 100 magazynów kluczy, magazyn kluczy nie udało się wczytać sekcji odniesienia w interfejsie Edge. Zamiast tego w interfejsie pojawił się błąd Internal Error (Error Fetching Keystores).
110988191

Niepowodzenie analizy

Nie udało się przeprowadzić analizy w środowisku, gdy użyto danych z Microgateway, które ustaw datę w przyszłości.
110785400

Błędy tworzenia kopii zapasowej

Z kolei w usługach ZooKeeper, Cassandra i OpenLDAP prawidłowo utworzyć kopię zapasową danych z tym błędem: File changed as we read it.
79993247

Żądania do Node.js: HEAD

Żądania HEAD do celu Node.js mogły zostać zawieszone, przez co połączenia pozostały w stanie oczekiwania.
70291825

Kopia zapasowa/przywracanie apigee-postgres

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

Resetowanie hasła administratora Sysadmin

Resetowanie hasła administratora systemowego serwera zarządzania, które zawierało specjalne nie powiodło się.

Znane problemy

Poniższa tabela zawiera znane problemy występujące w tej wersji:

Identyfikator problemu Opis
141628497

Początkowo nie można oceniać transakcji

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

Interfejs API do włączania zarabiania przekazuje w odpowiedzi identyfikator zadania, a po zakończeniu – stan zadania wskazujący na powodzenie. Jednak żadne wygenerowane wcześniej wywołania interfejsu API nie będą jednak uwzględniane w funkcji zarabiania i nie będą oceniane. Te transakcje będą widoczne tylko w regularnych statystykach.

Obejście:

Ponownie uruchom wszystkie procesory wiadomości (MP), których można użyć w ten sposób:
apigee-service edge-message-processor restart

Po włączeniu zarabiania ponowne uruchomienie MP spowoduje, że Edge wczyta 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 są kompilowane bez konsumentów, co powoduje zwiększenie głębokości kolejki do momentu wykorzystania wszystkich dostępnych zasobów.

Obejście:

Brak.
135616498

Format pliku metadanych do instalacji apigee-sso

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

Obejście:

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

  • Dodaj listę CRLF na końcu pliku metadata.xml.

    LUB

  • Użyj lokalizacji na podstawie adresu URL dla 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 właściwego zestawu plików

Obejście:

Ponowne uruchomienie kopii zapasowej powinno spowodować utworzenie kopii zapasowej właściwego zestawu plików.

76087166

DataAccessException w wielu konfiguracjach centrów danych

W wielu konfiguracjach centrów danych, jeśli jeden magazyn danych stanie się niedostępny, możesz 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 Cassandra węzłów dc-1 i dc-2. DataAccessExceptions występuje, jeśli węzeł Cassandra to w dół. Może to również spowodować zakłócenia w ruchu przez interfejsy API, o których decydują firmy przetwarzające wiadomości DataAccessExceptions podczas próby pobrania maszyn KVM.

Pamiętaj, że oczekiwanym stanem jest to, aby serwer zarządzania nie łączył się z komponentami magazynu danych w różnych regionach.

Obejście

Rozwiązaniem jest wyrejestrowanie następujących typów węzłów Cassandra z niedostępnych centrum danych i zarejestruj je ponownie, 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. Aby uzyskać identyfikatory UUID węzłów Cassandra, użyj 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 Apigee koncie.
    • MS_IP i MS_PORT to adres IP i port serwera zarządzania numer.
    • REGION to nazwa centrum danych, w którym znajduje się serwer zarządzania z siedzibą firmy.
    • GATEWAY_POD to nazwa poda, która jest domyślnie „bramą”. Być może masz nazwa została zmieniona na inną, więc sprawdź swoją implementację.
    • CASSANDRA_NODE_TYPE należy do 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 taki 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. Będziesz ich używać do: wyrejestrować węzły.

  2. Powtórz krok 1 dla każdego typu węzła Cassandra: kms-datastore, dc-datastore i keyvaluemap-datastore. Pamiętaj o poniższych 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 poprzedniego polecenia.

  4. Powtórz krok 3 dla 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

Zwróć uwagę, że te operacje rejestrują i wyrejestrowują węzły z Zookeeper i nie mają żadnych na gromadę Cassandra. Więcej informacji o tych poleceniach znajdziesz w sekcji Aktualizuj rejestracje w magazynie danych.

68722102

Zasady MessageLogging, w tym dodatkowe informacje w komunikacie logu

Element FormatMessage zasady MessageLogging kontroluje format zarejestrowanej wiadomości. Gdy FormatMessage=false, zalogowany komunikat nie powinien zawierać żadnych informacji wygenerowanych przez Apigee. Jednak nawet jeśli ustawisz FormatMessage=false, komunikat logu nadal będzie zawierał te informacje:

  • Wynik priorytetu
  • sygnatura czasowa,

Obejście:

Brak.

Następny krok

Aby zacząć korzystać 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ę