Примечания к выпуску 4.19.06 Edge for Private Cloud

Вы просматриваете документацию по Apigee Edge.
Перейдите к документации по Apigee X.
Информация

В этом разделе описана версия 4.19.06 выпуска функций Edge для частного облака.

Сводка по выпуску

В таблице ниже приведены основные изменения в этой версии.

Новые функции

В этом выпуске добавлены следующие новые функции:

○ Поддержка LDAP для SSO
○ Поддержка развертывания HTTP
○ Поддержка подключаемой аналитики
○ Поддержка стоек Cassandra
○ Поддержка IPv6
○ Упрощенная установка New Edge
○ Исключение транзакций INVALID_TSC (монетизация)

Подробнее о новых функциях…

Обратная совместимость

В этой версии Apigee Edge для частного облака появились следующие проблемы, влияющие на обратную совместимость:

     
  • В связи с исправлением проблемы 132443137 (как описано в примечаниях к выпуску общедоступной облачной версии 19.03.01) процессоры сообщений теперь игнорируют заголовки, которые начинаются с X-Apigee-*. Поэтому вам нужно переработать код, в котором используются заголовки X-Apigee-*, и заменить их на поддерживаемые.

  • Изменилось название файлов журнала Cassandra. Сейчас:

    /opt/apigee/var/log/apigee-cassandra/system.log
Включенные релизы

С момента выхода предыдущей версии Edge для частного облака были выпущены следующие версии, которые включены в эту версию:

○ Edge:
   19.07.23 (UI)
   19.03.01
   19.02.19
   19.02.04
   19.01.23
   19.01.14
   18.12.04
   18.08.31
   18.07.31
○ Portal:
   19.07.08
   19.05.23
   19.05.08
   19.04.18
   19.03.20
   19.02.27
   19.02.21
   19.02.04
   19.01.16
Упразднение Нет
Прекращение поддержки

В версии 4.19.06 прекращена поддержка следующих функций:

  • 4.18.01: версия 4.18.01 Apigee Edge для частного облака больше не поддерживается.

Подробнее о прекращении поддержки, выводе из эксплуатации и изменениях в CPS…

Исправление ошибок

В этой версии исправлены следующие ошибки:

○ UseStringDeduplication не задано (140270474)
○ Ошибки MP (111445518)
○ Сбои Cassandra с JMX (113342838)
○ Обновления 13 узлов (138931337)
○ Прокси с одинаковыми именами (119802562)
○ Не загружаются хранилища ключей (118851790)
○ Сбой аналитики (110988191)
○ Сбои резервного копирования (110785400)
○ Запросы HEAD к Node.js (79993247)
○ Резервное копирование и восстановление apigee-postgres (70291825)
○ Сброс пароля системного администратора (65737520)

Подробнее об исправлении ошибок…

Известные проблемы

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

○ Mint не оценивает транзакции изначально (141628497)
○ Утечка памяти на серверах оценки Mint (137865184)
○ Формат файла метаданных для установки apigee-sso (135616498)
○ apigee-monit не поддерживается в Amazon Linux 1 (122370980)
○ При резервном копировании процессора сообщений не создается резервная копия нужного набора файлов (121095148)
○ Правило MessageLogging включает дополнительную информацию в сообщение журнала (68722102)

Подробнее об известных проблемах…

Варианты перехода

В таблице ниже показаны пути обновления для этой версии.

От 4.19.01 Переход с версии 4.19.01 на 4.19.06
С версии 4.18.05 Выполнить прямой переход с версии 4.18.05 на 4.19.06.
С версии 4.18.01 Непосредственно перейти с версии 4.18.01 на 4.19.06.

Новые функции

В этом разделе перечислены новые функции, добавленные в этом выпуске. Кроме того, в этот выпуск включены все функции, которые были добавлены в выпуски Edge UI, Edge Management и Portal, перечисленные в разделе Включенные выпуски.

Помимо перечисленных ниже улучшений, в этой версии также повышена удобство использования, производительность, безопасность и стабильность.

Поддержка развертывания HTTP

По умолчанию Edge использует RPC для развертывания прокси API. Этот режим хорошо подходит для большинства установок, но в крупных топологиях с большим количеством точек монтирования могут возникать тайм-ауты, когда по RPC выполняется большое количество одновременных вызовов.

Поэтому Apigee рекомендует использовать HTTP, а не RPC для крупных развертываний. Теперь можно включить развертывания HTTP.

Подробнее о том, как включить развертывание HTTP…

Поддержка стоек Cassandra

Теперь Apigee предоставляет общие рекомендации по масштабированию операций Cassandra, позволяя Cassandra на Apigee Edge для частного облака учитывать стойки.

Подробнее о поддержке стоек Cassandra…

Подключаемая аналитика

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

В этой версии функции вы можете настроить Message Processor так, чтобы он записывал аналитические данные на диск, или использовать оба варианта.

Подробнее о том, как записать данные аналитики в файл…

Упрощенная установка нового интерфейса Edge

Установка New Edge стала проще благодаря новому скрипту.

Подробнее о том, как установить New Edge Experience…

Поддержка поставщика идентификационной информации LDAP

Аутентификация пользователей с помощью интерфейса Edge и вызовов API управления Edge теперь поддерживает LDAP в дополнение к SAML. Поддерживаются как прямое, так и непрямое связывание.

Подробнее об аутентификации с помощью внешнего поставщика идентификационной информации…

Поддержка IPv6

По умолчанию все вызовы API времени выполнения к Apigee Edge для частного облака используют IPv4. Вы можете добавить поддержку IPv6 в маршрутизатор с помощью нового свойства.

Подробнее о том, как использовать IPv6 на маршрутизаторе…

Исключение транзакций INVALID_TSC (монетизация)

Теперь вы можете исключить транзакции INVALID_TSC из добавления в базу данных Postgres при использовании монетизации.

Подробнее о свойствах сервера монетизации…

Поддерживаемое ПО

В этом выпуске внесены следующие изменения в поддерживаемое ПО:

Поддержка добавлена Больше не поддерживается

В этом выпуске добавлена поддержка следующих платформ:

  • Red Hat Enterprise Linux (RHEL) 6.10
  • CentOS 6.10
  • Oracle Linux 6.9

В этом выпуске больше не поддерживаются следующие платформы:

  • Red Hat Enterprise Linux (RHEL) 6.9
  • CentOS 6.9
  • Oracle 6.8

Полный список поддерживаемых платформ приведен в разделе Поддерживаемое ПО и его версии.

Исправлены ошибки.

В этом разделе перечислены ошибки личного облака, исправленные в этой версии. Кроме того, в этот выпуск включены все исправления ошибок, которые были добавлены в выпуски Edge UI, Edge Management и Portal, перечисленные в разделе Включенные выпуски.

Идентификатор проблемы Описание
140270474

Параметр UseStringDeduplication не задан

UseStringDeduplication не задавался для компонентов edge-message-processor в рабочих средах.
111445518

Ошибки MP

Обработчики сообщений каждые пять минут регистрировали следующее сообщение об ошибке:
2019-06-29 00:02:05,775 Apigee-Timer-6 ERROR CMgmt -
  ConnectorServiceImpl.refreshToken() : Connector Management API auth token
  generation failed: 0 null
113342838

Сбои Cassandra с JMX

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

Обновления 13 узлов

Не удавалось обновить установки с 13 узлами версий 17.09, 18.01 и 18.05.
119802562

Прокси-серверы с одинаковыми названиями

Если два пользователя в одной организации создали прокси с одинаковыми именами, второй прокси перезапишет первый. Это происходило только в том случае, если разные пользователи не могли видеть другой прокси-сервер.
118851790

Не загружаются хранилища ключей

Если в организации или среде было больше 100 хранилищ ключей, раздел хранилищ ключей и ссылок в интерфейсе Edge не загружался. Вместо этого в интерфейсе показывалась ошибка Internal Error (Error Fetching Keystores).
110988191

Ошибка при работе с аналитикой

Аналитика не работала в среде, когда ей предоставлялись данные от микрошлюза, в которых была указана дата из будущего.
110785400

Сбои при резервном копировании

В ZooKeeper, Cassandra и OpenLDAP периодически не удавалось создать резервную копию данных с помощью следующей ошибки: File changed as we read it.
79993247

HEAD запросов к Node.js

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

Резервное копирование и восстановление apigee-postgres

При выполнении резервного копирования или восстановления с помощью apigee-postgres теперь создается резервная копия данных для всех компонентов.
65737520

Как сбросить пароль системного администратора

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

Известные проблемы

В таблице ниже перечислены известные проблемы в этом выпуске.

Идентификатор проблемы Описание
141628497

Mint не оценивает транзакции изначально

Edge для частного облака не оценивает транзакции при первом включении монетизации для организации. Это относится как к новым, так и к существующим организациям.

API монетизации возвращает идентификатор задания, а после его выполнения статус задания будет указывать на успешное завершение. Однако монетизированные вызовы API, выполненные изначально, не будут обработаны и оценены. Эти транзакции будут показываться только в стандартной аналитике.

Решение

Перезапустите все процессоры сообщений, выполнив следующие действия:
apigee-service edge-message-processor restart

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

137865184

Утечка памяти на серверах рейтинга Mint

Когда в mxgroup регистрируется новый экземпляр Qpid, очереди создаются без потребителей, в результате чего глубина очереди увеличивается до тех пор, пока не будут использованы все доступные ресурсы.

Решение

Нет.
135616498

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

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

Решение

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

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

    ИЛИ

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

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

Решение

Нет.
121095148

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

Решение

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

76087166

Исключение 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. Подробнее об обновлении регистраций хранилищ данных…

68722102

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

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

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

Решение

Нет.

Дальнейшие действия

Чтобы начать работу с Edge for Private Cloud 4.19.06, воспользуйтесь следующими ссылками:

Новые установки:
Обзор новой установки
Существующие установки:
Пути обновления