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 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.

Tokeny sesji nie zostały unieważnione

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

Obejście:

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

Obejście:

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

Żądania HEAD 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, ponownie uruchom 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 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.

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:

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

Resetowanie hasła administratora systemu na serwerze zarządzania zawierającym 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.