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

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

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

Решение

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

• Добавьте CRLF в конец файла metadata.xml.

  ИЛИ

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

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

Решение

Резервная копия Message Processor не содержит нужные файлы

Решение

Запустите резервное копирование ещё раз. На этот раз будет скопирован правильный набор файлов.

Токены сеансов не аннулируются

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

Решение

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

Решение

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

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

Решение

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

Не удается распознать имена хостов

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

Решение

Чтобы устранить эту проблему, перезапустите компонент Edge UI:

/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 – название пода, по умолчанию "gateway". Возможно, вы переименовали его, поэтому проверьте свою реализацию.
   • 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. Повторите шаг 1 для каждого типа узла 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. Подробнее об обновлении регистраций хранилищ данных…

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

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

• Оценка приоритета
• Временная метка

Решение

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

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

Решение

Задайте пароль в файле данных, который затем передайте в конечную точку /users в Management API. Подробнее о том, как сбросить пароль системного администратора…