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

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

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

回避策:

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

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

  または

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

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

回避策:

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

回避策:

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

セッション トークンが無効になっていない

ユーザーが [Apigee Edge Logout] ボタンをクリックしても、サーバー上のセッション トークンは無効になりません。

回避策:

JMX 認証が有効になっている場合に Cassandra のオペレーションが機能しない

回避策:

Node.js ターゲットへの HEAD リクエストがハングする

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

回避策:

この問題を回避するには、空のレスポンスを明示的に返す HEAD リクエストのハンドラを定義します。

ホスト名が解決されない

Edge for Private Cloud をインストールまたはアップグレードすると、ホスト名がアドレスに解決されない場合があります。

回避策:

この問題を解決するには、Edge UI コンポーネントを再起動します。

/opt/apigee/apigee-service/bin/apigee-service edge-ui restart

複数のデータセンター構成での 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_EMAIL と ADMIN_PW は、Apigee の認証情報です。 あります。
   • MS_IP と MS_PORT は、Management Server の IP アドレスとポートです。 あります。
   • REGION は、Management Server がインストールされているデータセンターの名前です。 できます。
   • GATEWAY_POD は Pod 名で、デフォルトは「gateway」です。もしかしたら、 名前が別の名前に変更されているので、実装を確認してください。
   • 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 ごとに手順 1 を繰り返します。 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. 手順 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 からのノードの登録と登録解除を行います。 影響を軽減できます。これらのコマンドの詳細については、このモジュールの データストアの登録を更新する。

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

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

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

回避策:

システム管理者パスワードを再設定できない

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

回避策:

データファイルにパスワードを定義してから、Management API の /users エンドポイントに渡します。詳しくは、システム管理者パスワードを再設定するをご覧ください。