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

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

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

Краткое описание выпуска

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

Новые возможности

Этот выпуск включает в себя следующие новые функции:

○ Поддержка LDAP для единого входа.
○ Поддержка развертывания 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 for Private Cloud Feature появились следующие выпуски, которые включены в этот выпуск:

○ Край:
19.07.23 (УИ)
19.03.01
19.02.19
19.02.04
19.01.23
19.01.14
18.12.04
18.08.31
18.07.31
○ Портал:
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
Выход на пенсию Никто
Устаревания

С выпуском 19.4.06 устарели следующие функции:

  • 4.18.01: Версия 4.18.01 Apigee Edge для частного облака устарела.

Дополнительную информацию см. в разделе Прекращение поддержки Apigee, прекращение использования и изменения CPS .

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

Этот выпуск включает следующие исправления ошибок:

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

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

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

Этот выпуск включает следующие известные проблемы:

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

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

Пути обновления

В следующей таблице показаны пути обновления для этого выпуска:

С 19.04.01 Непосредственное обновление с 4.19.01 → 4.19.06
С 18.04.05 Непосредственное обновление с 18.4.05 → 19.06.
С 18.04.01 Непосредственное обновление с 4.18.01 → 4.19.06

Новые возможности

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

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

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

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

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

Дополнительные сведения см. в разделе Включение развертывания HTTP .

Поддержка стойки Кассандра

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

Дополнительную информацию см. в разделе Поддержка стоек Cassandra .

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

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

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

Дополнительные сведения см. в разделе Запись аналитических данных в файл .

Упрощенная установка New Edge

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

Дополнительные сведения см. в разделе Установка New Edge Experience .

Поддержка LDAP IDP

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

Дополнительные сведения см. в разделе Обзор внешней аутентификации IDP .

Поддержка IPv6

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

Дополнительную информацию см. в разделе Использование IPv6 на маршрутизаторе .

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

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

Дополнительную информацию см. в разделе Свойства сервера монетизации .

Поддерживаемое программное обеспечение

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

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

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

  • Red Hat Enterprise Linux (RHEL) 6.10
  • ЦентОС 6.10
  • Оракул Линукс 6.9

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

  • Red Hat Enterprise Linux (RHEL) 6.9
  • ЦентОС 6.9
  • Оракул 6.8

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

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

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

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

UseStringDeduplication не установлен.

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

Ошибки МП

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

Неудачи Кассандры с JMX

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

13-узловые обновления

Обновления 13-узловых установок от 17.09, 18.01 и 18.05 не удались.
119802562

Прокси с таким же названием

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

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

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

Аналитика не удалась

Аналитика не удалась для среды, когда были предоставлены данные от Microgateway, для которых была установлена ​​дата в будущем.
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, сделанные изначально, не будут обрабатываться монетизацией и не будут оцениваться. Эти транзакции будут отображаться только в обычной аналитике.

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

Перезапустите все процессоры сообщений (MP), что можно сделать следующим образом:
apigee-service edge-message-processor restart

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

137865184

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

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

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

Никто.
135616498

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

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

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

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

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

    ИЛИ

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

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

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

Никто.
121095148

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

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

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

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

68722102

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

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

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

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

Никто.

Следующий шаг

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

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