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

Временное решение:

Резервное копирование обработчика сообщений не создает правильный набор файлов.

Временное решение:

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

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

Токены сессии на сервере не аннулируются, когда пользователь нажимает кнопку «Выход из 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 — это имя пода, которое по умолчанию равно "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. Для получения дополнительной информации об этих командах см. раздел «Обновление регистрации хранилищ данных» .

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

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

• Приоритетный балл
• Отметка времени

Временное решение:

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

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

Временное решение:

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