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

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

29 сентября 2020 г. мы выпустили новую версию Apigee Edge для частного облака.

Как обновить

После обновления этой версии будут обновлены компоненты в следующих RPM-пакетах:

  • edge-gateway-4.19.01-0.0.20095.noarch.rpm
  • edge-management-server-4.19.01-0.0.20095.noarch.rpm
  • edge-message-processor-4.19.01-0.0.20095.noarch.rpm
  • edge-postgres-server-4.19.01-0.0.20095.noarch.rpm
  • edge-qpid-server-4.19.01-0.0.20095.noarch.rpm
  • edge-router-4.19.01-0.0.20095.noarch.rpm
  • apigee-cassandra-2.1.16-0.0.2507.noarch.rpm
  • edge-management-ui-static-4.19.01-0.0.20017.noarch.rpm
  • apigee-setup-4.19.01-0.0.1123.noarch.rpm
  • apigee-mtls-consul-4.19.01-0.0.20129.noarch.rpm
  • apigee-mtls-4.19.01-0.0.20190.noarch.rpm

Чтобы проверить, нужно ли обновить установленные версии RPM, введите:

apigee-all version

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

  1. На всех узлах Edge:

    1. Очистите репозитории Yum: 
      sudo yum clean all
    2. Скачайте последнюю версию файла Edge 4.19.01 bootstrap_4.19.01.sh в /tmp/bootstrap_4.19.01.sh: 
      curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
    3. Установите утилиту Edge 4.19.01 apigee-service и зависимости: 
      sudo bash /tmp/bootstrap_4.19.01.sh apigeeuser=uName apigeepassword=pWord

      где uName:pWord – имя пользователя и пароль, полученные от Apigee. Если вы не укажете pWord, вам будет предложено ввести его.

    4. Обновите утилиту apigee-setup: 
      sudo /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    5. Чтобы выполнить скрипт apigee-service.sh, используйте команду source: 
      source /etc/profile.d/apigee-service.sh

  2. Обновите все узлы Cassandra:

    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile

    где configFile – файл конфигурации, который вы использовали для установки Apigee Edge Private Cloud. Пример: /opt/silent.conf.

  3. На всех узлах Edge выполните скрипт update.sh для процесса edge. Для этого выполните на каждом узле следующую команду: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  4. Если вы используете новый интерфейс Edge, выполните следующую команду: 
    /opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
  5. (Только для Apigee mTLS) Чтобы обновить Apigee mTLS, выполните инструкции из статьи Как обновить Apigee mTLS.

    Подробнее о Apigee mTLS…

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

Без изменений.

Прекращение поддержки

Новых устаревших функций нет.

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

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

Шифрование паролей JMX

Теперь вы можете шифровать пароли JMX. Подробную информацию можно найти в статьях Как включить шифрование пароля JMX и Как включить аутентификацию JMX для Cassandra. (150633039)

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

В таблице ниже перечислены ошибки, исправленные в этой версии.

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

Сертификаты apigee-mtls действовали только 30 дней.

Новые сертификаты действительны в течение одного года. Чтобы заменить старый 30-дневный сертификат новым, действительным в течение года, ознакомьтесь с разделом Обновление Apigee MTLS.
160890634

После перезапуска процессоров сообщений некоторые прокси-серверы не были развернуты.
130416715

Потенциальная уязвимость из-за заголовка True-Client-IP

В этом выпуске представлен новый элемент правил управления доступом – IgnoreTrueClientIPHeader, который устраняет проблему. Подробнее об элементе IgnoreTrueClientIPHeader…
132654321

В журналах аудита не отображались пользователи, чьи роли были изменены.

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

Установка mTLS не удавалась из-за устаревшей версии исполняемого файла Consul.

Исполняемый файл Consul обновлен с версии 1.6.2 до последней стабильной версии 1.8.0.
160916451

Установка mTLS не удалась из-за отсутствия записи для поля Consul bindaddr.

Теперь apigee-mtls корректно обрабатывает серверы с несколькими сетевыми интерфейсами и адресами.
133145969

Отсутствовала документация по отключению протоколов в интерфейсе

Новую документацию можно найти в разделе Отключение протоколов TLS.

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

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

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

Проблема с пулом подключений к правилам LDAP

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

Решение

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

  1. Создайте файл конфигурации, если его ещё нет: 
    /opt/apigee/customer/application/message-processor.properties
  2. Добавьте в файл следующие строки (замените значения свойств Java Naming and Directory Interface (JNDI) в соответствии с требованиями к конфигурации ресурса LDAP). 
    bin_setenv_ext_jvm_opts="-Dcom.sun.jndi.ldap.connect.pool.maxsize=20
-Dcom.sun.jndi.ldap.connect.pool.prefsize=2
-Dcom.sun.jndi.ldap.connect.pool.initsize=2
-Dcom.sun.jndi.ldap.connect.pool.timeout=120000
-Dcom.sun.jndi.ldap.connect.pool.protocol=ssl"
  3. Убедитесь, что файл /opt/apigee/customer/application/message-processor.properties принадлежит пользователю apigee:apigee.
  4. Перезапустите каждый процессор сообщений.

Чтобы убедиться, что свойства JNDI пула подключений действуют, можно выполнить tcpdump, чтобы отследить поведение пула подключений LDAP с течением времени.