4.19.01 Примечания к выпуску Edge для частного облака

Формат файла метаданных для установки apigee-sso

При установке apigee-sso и использовании файла метаданных.xml вместо URL-адреса, если файл метаданных.xml не содержит новую строку (CRLF) в конце файла, файл метаданных.xml не читается полностью.

Обходной путь:

Чтобы обойти эту проблему, вы можете выполнить одно из следующих действий:

• Добавьте CRLF в конец файла метаданных.xml.

  ИЛИ

• Используйте местоположение метаданных на основе URL-адреса.

apigee-monit не поддерживается в Amazon Linux 1

Обходной путь:

При резервном копировании процессора сообщений не создается резервная копия правильного набора файлов.

Обходной путь:

Запустите резервное копирование второй раз, и он должен создать резервную копию правильного набора файлов.

Токены сеанса не признаны недействительными

Токены сеанса не становятся недействительными на сервере, когда пользователь нажимает кнопку выхода из Apigee Edge.

Обходной путь:

Операции Cassandra не работают, когда включена аутентификация JMX

Обходной путь:

Запросы HEAD к целям Node.js зависают

Запросы HEAD к цели Node.js могут зависать, оставляя соединения ожидающими.

Обходной путь:

Чтобы обойти эту проблему, определите обработчик запросов HEAD , который будет явно возвращать пустой ответ.

Имена хостов не разрешаются

После установки или обновления Edge для частного облака имена хостов могут не соответствовать своим адресам.

Обходной путь:

Чтобы решить эту проблему, перезапустите компонент пользовательского интерфейса Edge:

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

DataAccessException в нескольких конфигурациях центров обработки данных

Если в конфигурациях с несколькими центрами обработки данных одно хранилище данных становится недоступным, вы можете увидеть следующую ошибку:

DataAccessException: Error while accessing datastore;
Please retry later

В результате сервер управления может не запуститься, поскольку он пытается подключиться к узлам Cassandra как в DC-1, так и в DC-2. DataAccessExceptions возникает, если узел Cassandra не работает. Это также может привести к нарушению трафика API, когда процессоры сообщений сообщают DataAccessExceptions при попытке получить KVM.

Обратите внимание, что ожидаемое состояние — сервер управления не будет подключаться к компонентам хранилища данных в разных регионах.

Обходной путь

Обходной путь — отменить регистрацию следующих типов узлов Cassandra в недоступном центре обработки данных, а затем перерегистрировать их после того, как узлы Cassandra снова станут доступны:

• kms-datastore
• dc-datastore
• keyvaluemap-datastore

Чтобы отменить регистрацию и перерегистрацию этих типов узлов Cassandra:

1. Получите UUID узлов Cassandra, используя следующую команду curl :

   curl -u ADMIN_EMAIL:ADMIN_PW \
     "http://MS_IP:MS_PORT/v1/servers?region=REGION&pod=GATEWAY_POD \
     &type=CASSANDRA_NODE_TYPE"

   Где:

   • ADMIN_EMAIL и ADMIN_PW — это учетные данные вашей учетной записи Apigee.
   • MS_IP и MS_PORT — это IP-адрес и номер порта Сервера управления.
   • REGION — название дата-центра, в котором расположен Сервер управления.
   • GATEWAY_POD — это имя модуля, который по умолчанию является «шлюзом». Однако вы могли переименовать его во что-то другое, поэтому проверьте свою реализацию.
   • CASSANDRA_NODE_TYPE — это один из kms-datastore , dc-datastore и keyvaluemap-datastore .

   Например:

   curl -u nickdanger@google.com:myP@$$w0rD
     "http://192.168.0.1:8080/v1/servers?region=dc-1&pod=gateway&type=dc-datastore"

   В ответе используется следующий формат:

   {
     "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"
   }

   Например:

   {
     "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"
   }

   Обратите внимание на значения поля uUID в ответе. Вы будете использовать их для отмены регистрации узлов.

2. Повторите первый шаг для каждого типа узла Cassandra: kms-datastore , dc-datastore и keyvaluemap-datastore . Обязательно обратите внимание на возвращаемые UUID.
3. Отмените регистрацию узлов с помощью следующей команды:

   curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers/UUID" -X DELETE

   Где UUID — это UUID, возвращенный в ответе предыдущей команды.

4. Повторите шаг 3 для каждого UUID, который вы собрали на шагах 1 и 2.
5. Перерегистрируйте узлы, используя следующую команду:

   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

Обратите внимание, что эти операции регистрируют и отменяют регистрацию узлов в Zookeeper и не оказывают никакого влияния на кластер Cassandra. Дополнительные сведения об этих командах см. в разделе Обновление регистрации хранилища данных .

Политика регистрации сообщений, включая дополнительную информацию в сообщении журнала.

Элемент FormatMessage политики MessageLogging управляет форматом записываемого сообщения. Если FormatMessage=false зарегистрированное сообщение не должно содержать никакой информации, сгенерированной Apigee. Однако даже если вы установите FormatMessage=false , сообщение журнала по-прежнему будет содержать следующую информацию:

• Приоритетный балл
• Временная метка

Обходной путь:

Сброс пароля системного администратора не удался

Сброс пароля системного администратора для сервера управления, содержащего специальные символы, не удастся.

Обходной путь:

Определите пароль в файле данных, который затем передадите в конечную точку /users в Management API. Дополнительную информацию см. в разделе Сброс пароля системного администратора .