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

<ph type="x-smartling-placeholder"></ph> 現在、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 の特長:

     
  • 問題 132443137 の修正のため( 2019 年 3 月 19 日公開 Cloud リリースノートなど)で、Message Processor で X-Apigee-*。そのため、Terraform を使用するコードはすべてリファクタリングし、 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
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
老後の暮らし なし
サポートの終了

4.19.06 のリリースに伴い、以下は非推奨となりました。

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

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

バグの修正

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

○ UseStringDeduplicate が設定されていません(140270474)
○ MP エラー(111445518)
○ JMX での Cassandra の障害(113342838)
○ 13 ノードのアップグレード(138931337)
○ 同じ名前のプロキシ(119802562)
○ キーストアが読み込まれない(118851790)
○ アナリティクスに失敗した(110988191)
○ バックアップの失敗(110785400)
○ Node.js への HEAD リクエスト(79993247)
○ apigee-postgres backup/restore(70291825)
○ sysadmin パスワードのリセット(65737520)

それぞれの修正について詳しくは、バグの修正をご覧ください。

既知の問題

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

○ Mint が最初にトランザクションを評価していない(141628497)
○ Mint 評価サーバーのメモリリーク(137865184)
○ apigee-sso インストール用のメタデータ ファイル形式(135616498)
apigee-monit は Amazon Linux 1 ではサポートされていません(122370980)
○ Message Processor のバックアップで正しいファイルセットがバックアップされない(121095148)
○ マルチ データセンター構成での DataAccessExceptions(76087166)
○ ログ メッセージに追加情報が含まれる 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 管理、ポータル リリースに含まれる機能について説明します。 対象リリース

以下の機能強化に加え、このリリースには、 パフォーマンス、セキュリティ、安定性が向上します。

HTTP デプロイ サポート

デフォルトでは、Edge は RPC を使用して API プロキシをデプロイします。このモードはほとんどのケースで 多数の MP が存在する大規模なトポロジでは、多数の VM があるとタイムアウトが 同時呼び出しが行われます。

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

詳細については、HTTP を有効にする デプロイします

Cassandra ラックのサポート

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

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

プラグイン可能な分析

デフォルトでは、Message Processor によって収集された分析データは Qpid と Postgres にアップロードされます。 提供しますその後、Edge UI で分析データを表示できます。

今回の機能リリースにより、分析データを Cloud Storage バケットに書き込んで 両方のオプションを使用できます。

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

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

New Edge エクスペリエンスのインストールは、新しいスクリプトによって簡略化されました。

詳細については、New Edge エクスペリエンスをインストールするをご覧ください。

LDAP IDP のサポート

Edge UI と Edge Management API 呼び出しを使用するユーザーの認証で、LDAP がサポートされるようになりました。 サポートしています。LDAP のサポートには、直接バインディングと間接バインディングの両方の方法が含まれます。

詳細については、外部リンクの概要 IdP 認証

IPv6 サポート

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

詳細については、 Router

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

サポートされているプラットフォームの完全なリストについては、 サポートされているソフトウェアとサポート対象バージョン

バグの修正

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

問題 ID 説明
140270474

UseStringDeduplicate が設定されていない

UseStringDeduplication は次の条件を満たしていませんでした 本番環境で edge-message-processor コンポーネントを設定する 必要があります。
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 番目に作成すると、1 つ目が上書きされます。この問題は、次の場合にのみ発生しました。 別のユーザーが他のプロキシを見ることができませんでした。
118851790

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

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

分析に失敗しました

環境に対して分析に失敗した、 将来の日付に設定されています
110785400

バックアップの失敗

ZooKeeper、Cassandra、OpenLDAP が断続的にエラー 次のエラーが表示され、データを適切にバックアップしてください。File changed as we read it.
79993247

Node.js への HEAD リクエスト

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

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

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

sysadmin パスワードを再設定する

特別なソフトウェアを含む管理サーバーのシステム管理者パスワードのリセット 失敗します

既知の問題

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

問題 ID 説明
141628497

Mint が最初に取引を評価していない

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

Monetization Enablement API からジョブ ID が返され、完了すると、ジョブのステータスが成功を示します。ただし、最初に行われた収益化対象の API 呼び出しは、収益化で処理されず、レーティングの対象にもなりません。これらの取引は、通常のアナリティクスにのみ表示されます。

回避策:

Message Processor(MP)を再起動します。再起動は、次のコマンドで実行できます。
apigee-service edge-message-processor restart

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

137865184

Mint Rating サーバーのメモリリーク

新しい 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

Cassandra への接続を試行しているため、Management Server が起動しないことがあります。 dc-1 と dc-2 の両方のノードのDataAccessExceptions は、Cassandra ノードがノードにアタッチされているときに できます。API トラフィックが中断される可能性もあります。その場合、Message Processor の KVM の取得中に 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-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 ごとに手順 1 を繰り返します。 dc-datastorekeyvaluemap-datastore。その際は、 返される 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 からのノードの登録と登録解除を行います。 影響を軽減できます。これらのコマンドの詳細については、このモジュールの データストアの登録を更新する

68722102

ログメッセージに追加情報が含まれる MessageLogging ポリシー

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

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

回避策:

なし。

次のステップ

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

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