Informacje o wersji 4.19.01 Edge dla Private Cloud

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.

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

Obejście:

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.

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:

HEAD żądania do miejsc docelowych Node.js zawieszają się

Żądania HEAD kierowane do miejsca docelowego Node.js mogą się zawieszać, pozostawiając połączenia w stanie oczekiwania.

Obejście:

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

Nie można rozpoznać nazw hostów

Po zainstalowaniu lub uaktualnieniu Edge for Private Cloud nazwy hostów mogą nie rozwiązywać się na adresy.

Obejście:

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

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

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_EMAIL i ADMIN_PW to dane logowania do konta Apigee.
   • MS_IP i MS_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-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ź 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-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 baz danych.

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:

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

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

Obejście:

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