Informacje o wersji 4.19.01 Edge dla Private Cloud

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

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

Obejście:

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.

Tokeny sesji nie zostały unieważnione

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

Obejście:

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

Obejście:

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

Żądania HEAD wysyłane do środowiska docelowego Node.js mogą zawieszać się, pozostawiając oczekujące połączenia.

Obejście:

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

Nazwy hostów nie są rozpoznawane

Po zainstalowaniu lub uaktualnieniu Edge dla Private Cloud nazwy hostów mogą nie rozpoznawać swoich adresów.

Obejście:

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

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

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.

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:

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

Nie uda się zresetować hasła administratora systemu dla serwera zarządzania, które zawiera znaki specjalne.

Obejście:

Zdefiniuj hasło w pliku danych, który następnie przekazujesz do punktu końcowego /users w interfejsie Management API. Więcej informacji znajdziesz w artykule Resetowanie hasła administratora systemu.