4.19.01.09 - Edge for Private Cloud リリースノート

Apigee Edge のドキュメントを表示しています。
Apigee X のドキュメントに移動します。 情報

2020 年 9 月 29 日に、Apigee Edge for Private Cloud の新しいバージョンをリリースしました。

更新手順

このリリースを更新すると、次の 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. source コマンドを使用して apigee-service.sh スクリプトを実行します。
      source /etc/profile.d/apigee-service.sh

  2. すべての Cassandra ノードを更新します。

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

    ここで、configFile は Apigee Edge for Private Cloud のインストールに使用した構成ファイルを指定します。例: /opt/silent.conf

  3. すべての Edge ノードで、edge プロセスの update.sh スクリプトを実行します。これを行うには、各ノードで次のコマンドを実行します。
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  4. New Edge エクスペリエンスを使用している場合は、次のコマンドを実行します。
    /opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
  5. （Apigee mTLS のみ）Apigee mTLS を更新するには、Apigee mTLS のアップグレードで説明されている手順に沿って操作します。

    詳細については、 Apigee mTLS の概要をご覧ください。

サポートされるソフトウェア

変更なし

非推奨と廃止

新しい非推奨または廃止はありません。

新機能

このセクションでは、このリリースの新機能について説明します。

JMX パスワードの暗号化

JMX パスワードを暗号化できるようになりました。詳細については、 JMX パスワードの暗号化を有効にすると Cassandra で JMX 認証を有効にするをご覧ください。（150633039）。

修正済みのバグ

次の表に、このリリースで修正されたバグを示します。

問題 ID 説明
159360654

apigee-mtls 証明書の有効期間は 30 日間のみでした。

新しい証明書の有効期間は 1 年間です。古い 30 日間の証明書を 1 年間有効な新しい証明書にアップグレードするには、 Apigee MTLS をアップグレードするをご覧ください。
160890634

Message Processor が再起動されたときに、一部のプロキシがデプロイされませんでした。
130416715

「True-Client-IP」ヘッダーによる潜在的な脆弱性

このリリースでは、この問題を解決する新しい Access Control ポリシー要素 IgnoreTrueClientIPHeader が導入されています。 IgnoreTrueClientIPHeader 要素をご覧ください。
132654321

ロールが更新されたユーザーが監査ログに表示されていませんでした。

既存のユーザーのロールを変更したり、既存のユーザーを組織に追加したりした後、監査ログに「ユーザーの更新が未定義」と表示され、アクションの対象となったユーザーを確認できませんでした。
160951701

Consul バイナリのバージョンが古いため、mTLS のインストールが失敗していました。

Consul バイナリが v1.6.2 から最新の安定バージョン v1.8.0 にアップグレードされました。
160916451

Consul の bindaddr フィールドのエントリがないため、mTLS のインストールが失敗していました。

apigee-mtls で、複数のネットワーク インターフェースとアドレスを持つサーバーが適切に処理されるようになりました。
133145969

UI でプロトコルを無効にするためのドキュメントが不足していた

新しいドキュメントについては、 TLS プロトコルの無効化をご覧ください。

既知の問題

次の表に、このリリースの既知の問題を示します。

問題 ID 説明
149245401

LDAP ポリシーの接続プールに関する問題

LDAP リソースを使用して指定された LDAP 接続プール プロパティが有効にならない。その結果、接続は 1 回の使用ごとに開閉され、LDAP サーバーへの接続が 1 時間あたり大量に作成されます。

回避策:

LDAP 接続プール プロパティを変更するには、次の手順で、すべての LDAP ポリシーにグローバルな変更を設定します。

  1. 構成プロパティ ファイルが存在しない場合は作成します。
    /opt/apigee/customer/application/message-processor.properties
  2. ファイルに以下を追加します（LDAP リソース構成の要件に基づいて、Java Naming and Directory Interface（JNDI）プロパティの値を置き換えます）。
    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. 各 Message Processor を再起動します。

接続プール JNDI プロパティが有効になっていることを確認するには、tcpdump を実行して、LDAP 接続プールの動作を時間経過とともに観察します。