4.19.06 Edge for Private Cloud リリースノート

現在、Apigee Edge のドキュメントを表示しています。
Apigee X のドキュメントをご確認ください
情報

このセクションでは、Edge for Private Cloud 機能リリースのバージョン 4.19.06 について説明します。

リリースの概要

次の表に、このリリースでの変更点の概要を示します。

新機能

このリリースには、次の新機能が含まれています。

○ SSO の LDAP サポート
○ HTTP デプロイのサポート
○ プラグイン可能な分析
○ Cassandra ラックのサポート
○ IPv6 のサポート
○ New Edge エクスペリエンスのインストールの簡素化
INVALID_TSC トランザクションの除外(収益化)

これらの新機能の詳細については、新機能をご覧ください。

下位互換性

このバージョンの Apigee Edge for Private Cloud では、下位互換性に影響する次の問題が見つかりました。

     
  • 19.03.01 Public Cloud リリースノートで説明されている問題 132443137 の修正により、Message Processor は X-Apigee-* で始まるヘッダーを無視するようになりました。そのため、X-Apigee-* ヘッダーを使用するコードをリファクタリングし、それらのヘッダーをサポートされているヘッダーに置き換える必要があります。

  • Cassandra のログファイルの名前が変更されました。現在では、

    /opt/apigee/var/log/apigee-cassandra/system.log
含まれるリリース

以前の Edge for Private Cloud 機能リリース以降、次のリリースが行われ、このリリースに含まれています。

○ エッジ:
   19.07.23(UI)
   19.03.01
   19.02.19
   19.02.04
   19.01.23
3.1}1.81}11.81}1.81}
19.19.01

19.01.1418.12.0418.08.3118.07.31
○ ポータル:
   19.07.08
   19.05.23
   19.05.08
   19.04.18
   19.03.20
919.03.20
919.02.2719.02.2119.02.0419.01.16
廃止 なし
サポートの終了

4.19.06 のリリースでは、次のものが非推奨になりました。

  • 4.18.01: Apigee Edge for Private Cloud のバージョン 4.18.01 が非推奨になりました。

詳細については、Apigee の非推奨、廃止、CPS の変更をご覧ください。

バグの修正

このリリースには、次のバグ修正が含まれています。












HEAD

各修正の詳細については、バグの修正をご覧ください。

既知の問題

このリリースには、次の既知の問題が含まれています。

○ Mint が最初にトランザクションを評価しない(141628497)






apigee-monit

回避策など、これらの既知の問題の詳細については、既知の問題をご覧ください。

アップグレード パス

次の表に、このリリースのアップグレード パスを示します。

From 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 管理、ポータル リリースのすべての機能が含まれています。

このリリースでは、以下の機能強化に加えて、ユーザビリティ、パフォーマンス、セキュリティ、安定性に関する複数の改善が行われました。

HTTP デプロイのサポート

デフォルトでは、Edge は RPC を使用して API プロキシをデプロイします。このモードはほとんどのインストール環境で非常にうまく機能しますが、MP の数が多い大規模なトポロジでは、RPC を介して多数の同時呼び出しが行われるとタイムアウトが発生する可能性があります。

そのため Apigee では、大規模なデプロイでは RPC ではなく HTTP を使用してデプロイすることをおすすめします。HTTP デプロイの有効化がサポートされるようになりました。

詳細については、HTTP デプロイを有効にするをご覧ください。

Cassandra ラックのサポート

Apigee Edge for Private Cloud の Cassandra をラック対応にすることで、Cassandra のオペレーションをスケーリングするための一般的なガイダンスを提供するようになりました。

詳細については、Cassandra ラックのサポートをご覧ください。

プラグイン可能な分析

デフォルトでは、Message Processor で収集された分析データは Qpid と Postgres にアップロードされ、処理が行われます。これにより、Edge UI で分析データを表示できます。

この機能リリースでは、分析データをディスクに書き込むように Message Processor を構成できます。また、両方のオプションを使用することもできます。

詳細については、分析データをファイルに書き込むをご覧ください。

New Edge エクスペリエンスのインストールを簡素化

New Edge エクスペリエンスのインストールが、新しいスクリプトにより簡素化されました。

詳細については、New Edge Experience のインストールをご覧ください。

LDAP IDP のサポート

Edge UI と Edge Management API の呼び出しによるユーザーの認証で、SAML に加えて LDAP もサポートされるようになりました。LDAP のサポートには、直接バインディングと間接バインディングの両方のメソッドが含まれます。

詳細については、外部 IDP 認証の概要をご覧ください。

IPv6 サポート

デフォルトでは、Apigee Edge for Private Cloud に対するすべてのランタイム API 呼び出しで IPv4 が使用されます。新しいプロパティで IPv6 サポートを Router に追加できます。

詳細については、Router で IPv6 を使用するをご覧ください。

INVALID_TSC 件の取引を除外する(収益化)

Monetization の使用時に、INVALID_TSC トランザクションを Postgres データベースに追加しないよう除外できるようになりました。

詳細については、Monetization サーバーのプロパティをご覧ください。

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

このリリースには、サポートされているソフトウェアに対する次の変更が含まれています。

サポートが追加されました サポート終了

このリリースでは、次のプラットフォームのサポートが追加されました。

  • 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

サポートされているプラットフォームの一覧については、サポートされているソフトウェアとバージョンをご覧ください。

バグの修正

このセクションでは、このリリースで修正された Private Cloud のバグを示します。さらに、このリリースには、含まれるリリースに示されている Edge UI、Edge 管理、ポータル リリースのバグがすべて修正されています。

問題 ID 説明
140270474

UseStringDeduplicate が設定されていない

本番環境の edge-message-processor コンポーネントに UseStringDeduplication が設定されませんでした。
111445518

MP エラー

Message Processor では、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 認証が有効になっているときに、Cassandra オペレーションが機能していませんでした
138931337

13 ノードのアップグレード

17.09、18.01、18.05 からの 13 ノード構成のアップグレードが失敗しました。
119802562

同じ名前のプロキシ

同じ組織内で 2 人のユーザーが同じ名前でプロキシを作成した場合、2 人目に作成されたプロキシで最初のプロキシが上書きされます。これは、異なるユーザーが他のプロキシを表示できない場合にのみ発生しました。
118851790

キーストアが読み込まれない

組織/環境に 100 を超えるキーストアがある場合、Edge UI のキーストアと参照のセクションが読み込まれませんでした。代わりに Internal Error (Error Fetching Keystores) エラーが表示されました。
110988191

分析に失敗した

将来の日付に設定された Microgateway からデータを受け取った場合、環境の分析が失敗しました。
110785400

バックアップの失敗

ZooKeeper、Cassandra、OpenLDAP で断続的にデータが適切にバックアップされず、次のエラーが返されました: File changed as we read it.
79993247

Node.js への HEAD リクエスト

Node.js ターゲットへの HEAD リクエストはハングアップする可能性があります。その場合、接続が保留状態のままになります。
70291825

apigee-postgres のバックアップ/復元

apigee-postgres のバックアップ/復元を実行すると、すべてのコンポーネントのデータがバックアップされるようになりました。
65737520

sysadmin パスワードのリセット

特殊文字を含む Management Server のシステム管理者パスワードをリセットすると、失敗します。

既知の問題

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

問題 ID 説明
141628497

最初にミントが取引を評価しない

組織の収益化を初めて有効にした時点で、Edge for the Private Cloud ではトランザクションの評価は行われません。これは、新規と既存の組織に適用されます。

Monetization Enablement API は、ジョブ ID を返します。完了すると、ジョブのステータスは成功を示します。ただし、最初に行われた収益化対象 API 呼び出しは収益化の対象外となり、評価も行われません。これらのトランザクションは、通常の分析でのみ表示されます。

回避策:

次の方法で Message Processor(MP)を再起動します。
apigee-service edge-message-processor restart

収益化が有効になった後、MP を再起動すると、Edge は起動時に ZooKeeper から構成を読み込みます。この動作は再起動のたびに発生するため、この問題は初回のみ発生します。

137865184

Mint 評価サーバーのメモリリーク

新しい Qpid インスタンスが mxgroup に登録されると、キューはコンシューマなしで構築されます。そのため、利用可能なすべてのリソースが使用されるまで、キューの深さが増加します。

回避策:

なし
135616498

apigee-sso インストールのメタデータ ファイル形式

apigee-sso をインストールし、URL の代わりに metadata.xml ファイルを使用する場合、metadata.xml ファイルの最後に新しい行(CRLF)が含まれていないと、metadata.xml ファイル全体が読み取られません。

回避策:

この問題を回避するには、次のいずれかを行います。

  • metadata.xml ファイルの末尾に CRLF を追加します。

    または

  • メタデータに URL ベースの場所を使用する
122370980

apigee-monit は Amazon Linux 1 ではサポートされていません

回避策:

なし
121095148

Message Processor のバックアップで正しいファイルセットがバックアップされない

回避策:

バックアップをもう一度実行すると、正しいファイルセットがバックアップされます。

76087166

複数のデータセンター構成での DataAccessException

複数のデータセンターの構成で 1 つのデータストアが使用できなくなると、次のエラーが発生することがあります。

DataAccessException: Error while accessing datastore;
Please retry later

Management Server は、dc-1 と dc-2 の両方の Cassandra ノードに接続しようとしているため、起動しない可能性があります。DataAccessExceptions は、Cassandra ノードが停止した場合に発生します。これにより、API トラフィックが中断することも考えられます。具体的には、KVM を取得しようとしたときに Message Processor から DataAccessExceptions が報告されます。

予期される状態は、Management Server がリージョン間でデータストア コンポーネントに接続しないということです。

回避策

回避策として、利用できないデータセンターで次の Cassandra ノードタイプの登録を解除し、Cassandra ノードが再び利用可能になった後で再登録します。

  • kms-datastore
  • dc-datastore
  • keyvaluemap-datastore

これらの Cassandra ノードタイプの登録を解除して再登録するには:

  1. 次の curl コマンドを使用して、Cassandra ノードの UUID を取得します。
    curl -u ADMIN_EMAIL:ADMIN_PW \
      "http://MS_IP:MS_PORT/v1/servers?region=REGION&pod=GATEWAY_POD \
      &type=CASSANDRA_NODE_TYPE"

    各要素の意味は次のとおりです。

    • ADMIN_EMAILADMIN_PW は、Apigee アカウントの認証情報です。
    • MS_IPMS_PORT は、Management Server の IP アドレスとポート番号です。
    • REGION は、Management Server が配置されているデータセンターの名前です。
    • GATEWAY_POD は Pod 名です。デフォルトは "gateway" です。ただし、名前が別の名前になっている可能性があるため、実装を確認してください。
    • CASSANDRA_NODE_TYPE は、kms-datastoredc-datastorekeyvaluemap-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-datastoredc-datastorekeyvaluemap-datastore ごとにステップ 1 を繰り返します。返された UUID をメモしておいてください。
  3. curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers/UUID" -X DELETE
    コマンドを使用してノードの登録を解除します。

    ここで、UUID は前のコマンドのレスポンスで返された UUID です。

  4. 手順 1 と 2 で収集した UUID ごとに手順 3 を繰り返します。
  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 ポリシー

MessageLogging ポリシーの FormatMessage 要素は、ログに記録されるメッセージの形式を制御します。FormatMessage=false の場合、ログに記録されるメッセージには Apigee が生成した情報は含まれません。ただし、FormatMessage=false を設定しても、ログメッセージには次の情報が含まれます。

  • 優先度スコア
  • タイムスタンプ

回避策:

なし

次のステップ

Edge for Private Cloud 4.19.06 の使用を開始するには、次のリンクを使用します。

新規インストール:
新規インストールの概要
既存のインストール:
アップグレードパス