Informacje o wersji 4.19.01 Edge dla Private Cloud

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

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

Obejście:

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.

Tokeny sesji nie zostały unieważnione

Tokeny sesji nie są unieważniane na serwerze, gdy użytkownik kliknie przycisk wylogowania z Apigee Edge.

Obejście:

Operacje Cassandra nie działają, gdy włączone jest uwierzytelnianie JMX

Obejście:

Żądania (HEAD) do celów Node.js się zawieszają

Żądania HEAD wysyłane do środowiska docelowego Node.js mogą zawieszać się, przez co połączenia pozostają w stanie oczekiwania.

Obejście:

Aby obejść ten problem, zdefiniuj moduł obsługi żądań HEAD, który będzie zwracał pustą odpowiedź.

Nazwy hostów nie są rozpoznawane

Po zainstalowaniu lub uaktualnieniu Edge for Private Cloud nazwy hostów mogą nie być zgodne z ich adresami.

Obejście:

Aby rozwiązać ten problem, ponownie uruchom komponent interfejsu Edge:

/opt/apigee/apigee-service/bin/apigee-service edge-ui restart

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.

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:

Nie udało się zresetować hasła administratora systemowego

Nie można zresetować systemowego hasła administratora serwera zarządzania, które zawiera znaki specjalne.

Obejście:

Zdefiniuj hasło w pliku danych, który potem przekażesz do punktu końcowego /users w interfejsie API zarządzania Google Analytics. Więcej informacji znajdziesz w artykule Resetowanie hasła administratora systemowego.