ロケーション・エラー・メッセージ

デフォルトでは、IBM Cloud Satellite は、ロケーションの正常性をモニターして自動的に問題を解決しようとします。 問題が自動的に解決されなかった場合は、提供された正常性情報を確認してロケーションをデバッグすることができます。

エラー・メッセージとログの確認

  1. コンソールでロケーションを表示するか、CLI でロケーションをリストして、Status を確認します。 Status が正常でない場合は、次の手順に進んでください。 詳しくは、ロケーションの正常性の表示を参照してください。

    ibmcloud sat location ls

    出力例

    Name         ID                     Status            Ready   Created      Hosts (used/total)   Managed From   
Port-North   aaaaa1a11aaaaaa111aa   action required   no      6 days ago   3 / 5                Washington DC

  2. 自分のロケーションの詳細を見つけ、 「状態」、 「デプロイメント準備完了」 、および 「メッセージ」 の各セクションを確認します。 コンソールを使用する場合は、ロケーションをクリックし、ロケーション名と正常性が表示されているタイトルのツールチップをマウスオーバーします。

    ibmcloud sat location get --location <location_name_or_ID>

    出力例:

    Name:                           Port-NewYork   
ID:                             aaaaa1a11aaaaaa111aa   
Created:                        2020-06-05 13:50:58 -0400 (6 days ago)   
Creator:                        name@email.com   
Managed From:                   Washington DC   
State:                          action required   
Ready for deployments:          no   
Message:                        R0015: Could not assign hosts because no hosts are available. Attach more hosts to the location and try again. For more information, see the docs: 'http://ibm.biz/sat-loc'

  3. IBM Cloud Logs を設定し、 Satellite のロケーションログを確認することで、エラーメッセージおよび影響を受けるコンポーネントに関する詳細情報を確認できます。

  4. 問題を解決するための手順については、ロケーションの状態とメッセージを確認してください。 ロケーションの状態の説明については、 Red Hat OpenShift on IBM Cloud 資料の「 クラスターの状態 」を参照してください。 ロケーション・メッセージの説明については、以下のセクションを参照してください。 ロケーションの状態が warning または critical であり、 デプロイメントの準備ができている場合は、 サポート・チケットをオープン してください。

R0001: ロケーション準備完了

ロケーション・メッセージ
The Satellite location is ready for operations.
解決のための手順
この Satellite ロケーションに重大アラートはありません。また、ロケーション・コントロール・プレーン内の IBM Monitoring コンポーネントがロケーションの正常性をモニターしています。 ホストなど、そのロケーション内のリソースの状態を改善するために実行できるアクションについて、警告メッセージが表示される場合があります。

R0002, R0018, R0020, R0029, R0037, R0039, R0042: 位置情報の取得が完了するまでお待ちください

ロケーション・メッセージ
R0002: Satellite のロケーションに、IBM Cloud サポートが解決中の問題があります。 後で確認してください。
R0018: Satellite はリカバリーを試みています。
R0020: Satellite がリカバリー・アクションを完了しています。しばらくお待ちください。
R0029: リカバリー・アクションが正常に開始されました。
R0037: Satellite ロケーションに、障害状態のクラスターがあります。IBM Cloud サポートが解決作業を行っています。 後で確認してください。
R0039: Satellite ロケーション・コントロール・プレーンは現在正常な状態ではありません。IBM Cloud サポートが解決作業を行っています。 後で確認してください。
R0042: IBM Cloud サポートが、リンク API の障害を解決しています。 後で確認してください。 If this issue persists, raise a support case.
解決のための手順
時間をおいて、問題が解決されたかもう一度確認してください。 しばらくしても問題が解決しない場合は、サポート Case を開くことができます。

問題の詳細を確認するには、 Satellite のロケーション向けに IBM Cloud Logs を設定してください。

  1. IBM Cloud Logs ロケーションのプラットフォーム・ログを表示できるように Satellite をセットアップします。
  2. エラー・コードをプラットフォーム・ログで検索して、権限エラーのために失敗した API メソッドなどの詳しい情報を取得します。
  3. 詳細に許可エラーが示されている場合は、以下のようにします。
    1. アカウント管理者として IBM Cloud CLI にログインし、ロケーションが含まれているリソース・グループおよびリージョンをターゲットとして指定します。
        ibmcloud login -g <resource_group> -r <region>
    ```
2. 許可に使用される API キーをリセットします。
```sh {: pre}
    ibmcloud ks api-key reset
    ```

R0009: 復旧不可

ロケーション・メッセージ
R0009: Satellite は問題からリカバリーできません。
解決のための手順
Satellite は、問題を自動的に解決しようとしましたが失敗しました。 ロケーションにホストを追加するなど、詳しいトラブルシューティングについてのメッセージがないか確認してください。 しばらくしても問題が解決しない場合は、サポート Case を開くことができます。

R0010、R0030、R0031、R0032: コントロール・プレーンにホストが必要

ロケーション・メッセージ
R0010: ロケーション・コントロール・プレーンにさらにホストを割り当てるか、正常でないホストを取り替えます。
R0030: Satellite ロケーション・コントロール・プレーンのゾーンがクリティカル・レベルの容量に達しています。 If critical capacity is reached, you cannot add more clusters to location. Add more hosts to the control plane zone, or replace unhealthy hosts.
R0031: Satellite ロケーション・コントロール・プレーンのゾーンが警告レベルの容量に近づいています。 Add more hosts to the control plane zone, or replace unhealthy hosts.
R0032: 3 つのすべてのゾーンでコントロール・プレーンにホストを手動で割り当てます。
解決のための手順
お住まいの地域には、 Satellite がロケーション制御プレーンに自動的に割り当てられるホストが存在しません。 その場所は収容能力の限界に近づいています。 以下のオプションから選択できます。
  • ロケーション・コントロール・プレーンに追加ホストを接続して割り当てます。 ロケーション・コントロール・プレーンをスケールアップするときは、3 の倍数の台数を均等にスケーリングし、ゾーン間で均等にホストを割り当ててください。
  • ホストを削除してから再接続します。

R0011、R0040、R0041: コントロール・プレーンのホストの問題

ロケーション・メッセージ
R0011: Satellite ロケーションのすべてのホストが正常な状態であることを確認します。 If you still have issues, contact IBM Cloud Support and include your Satellite location ID.
R0040: Satellite ロケーション・データ・プレーンは現在正常な状態ではありません。 To debug the host, see 'http://ibm.biz/sat-host-debug'. それでも問題が解決しない場合は、IBM Cloud サポートに連絡して、Satellite ロケーション ID をお知らせください。
R0041: Satellite ロケーション・コントロール・プレーン・ホストで不明な問題が検出されました。 Ensure that hosts meet the minimum requirements, http://ibm.biz/sat-host-reqs. それでも問題が解決しない場合は、IBM Cloud サポートに連絡して、Satellite ロケーション ID をお知らせください。
解決のための手順
  1. ホストの状況を確認します。ibmcloud sat host ls --location <location_name_or_ID>
  2. ホストがない場合は、ロケーションにホストを接続します。
  3. ロケーション・コントロール・プレーンの操作を実行するには、ロケーションのインフラストラクチャー・クラスターに (1 ゾーンにつきホスト 2 台で 3 ゾーン全体で) 少なくとも 6 台のホストを割り当てておく必要があります。
  4. ホストの「Status」が表示されず、未割り当ての状態である場合は、ホスト・マシンにログインしてデバッグします。
  5. ホストの「Status」を確認して、ホストの問題を解決します。

R0012: 3 つのすべてのゾーンにホストが必要

ロケーション・メッセージ
R0012: 3 つのすべてのゾーンで、ロケーション・コントロール・プレーンにホストがあるわけではありません。 Add available hosts to your location for the control plane.
解決のための手順
コントロール・プレーンにホストを割り当てて間もない場合は、ブートストラッピング・プロセスが完了するまでしばらく待ってください。 そうでない場合は、コントロール・プレーン操作を実行できるように、ロケーション自体の 3 つのゾーンのそれぞれに少なくとも 1 台のホストを割り当ててください。
  • 既に 3 つのゾーンのそれぞれに 2 台以上のホストを割り当てている場合は、ホストの CPU とメモリーのサイズを確認してください。 ホストには少なくとも vCPU 4 つとメモリー 16 GB が必要です。
  • 既に各ゾーンに 2 台以上のホストを割り当てている場合は、オペレーティング・システムやネットワーキング構成など、Satellite で使用するための最小要件をホストが満たしていることを確認してください。
  • 既に 3 つのゾーンのそれぞれに 2 台以上のホストを割り当てているのにブートストラッピング・プロセスが失敗した場合は、ホスト・マシンにログインしてデバッグしてください。

R0013: ゾーンが使用不可

ロケーション・メッセージ

R0013: ロケーション・コントロール・プレーンのゾーンが使用できません。 Attach more hosts to the location and assign the hosts to the zone, or replace unhealthy hosts.

解決のための手順

コントロール・プレーン操作を実行できるように、ロケーション自体の 3 つのゾーンのそれぞれに 2 台以上のホストを割り当ててください。 既に 3 つのゾーンのそれぞれに 2 台以上のホストを割り当てた場合は、以下の手順を実行します。

  1. ホストの CPU とメモリーのサイズを確認します。 ホストには少なくとも vCPU 4 つとメモリー 16 GB が必要です。
  2. オペレーティング・システムやネットワーキング構成など、Satellite で使用するための最小要件をホストが満たしていることを確認します。
  3. ホスト・マシンにログインしてデバッグします。
  4. ホストを削除してから再接続します。 ホストを削除すると、そのホストはロケーション・コントロール・プレーンへの割り当てを解除されるので、別のホストをゾーンに割り当てる必要があります。

R0014: コントロール・プレーンの DNS レコード

ロケーション・メッセージ
R0014: Satellite ロケーションに、ロケーション・コントロール・プレーンへのロード・バランシング要求の DNS レコードがあることを確認します。
解決のための手順
  1. ibmcloud sat host ls --location <location_ID_or_name> を実行して、Satellite コントロール・プレーン内のすべてのホストが assigned の状態と Ready の状況を示していることを確認します。
  2. すべてのホストが正しい状態および状況を示している場合、ロケーションの DNS レコードはまだ作成されていません。 このプロセスは、すべてのホストがロケーションに正常に割り当てられてから、完了するまでに最長 30 分かかることがあります。
  3. 1 台以上のホストが正しい状態または状況を示していない場合は、ホストの正常性のデバッグを参照してください。

R0015、R0016: ホストの問題

ロケーション・メッセージ
R0015: 使用可能なホストがないため、ホストを割り当てることができませんでした。 Attach more hosts to the location and try again. For more information, see the docs: 'http://ibm.biz/sat-loc'
R0016: ホストの割り当て後に予期しないエラーが発生しました。 To debug the host, see 'http://ibm.biz/sat-host-debug'. If you still have issues, contact IBM Cloud Support and include your Satellite location ID.
解決のための手順
ロケーションに追加ホストを接続してください。 接続したホストが空きホストとして表示されない場合は、ホストの正常性のデバッグを参照してください。

R0023、 R0101: ロケーションが作動可能になるまで待機します。

ロケーション・メッセージ
R0023: Satellite がロケーション制御プレーンの設定を行うまでお待ちください。
R0101: Satellite のロケーションでは、操作の途中でクラスターが発生しています。 Wait for them to finish and check back later.
解決のための手順
ロケーション・コントロール・プレーンのセットアップが完了するまで待機し、後で再度確認します。

R0024, R0025: クラスタに関する問題

ロケーション・メッセージ
R0024: Satellite ロケーションには、正常性が警告レベルの Red Hat OpenShift 個のクラスターがあります。
R0025: Satellite ロケーションには、クリティカル状態の Red Hat OpenShift クラスターがあります。
解決のための手順
  1. ホスト容量に関するメッセージなど、別のメッセージが返されるかどうか観察します。
  2. ホスト・メッセージが返された場合は、ホストをデバッグしてみてください。
  3. それ以上メッセージが返されない場合は、Red Hat OpenShift on IBM Cloud クラスターをデバッグしてみてください。

R0026: ホストのディスク・スペース

ロケーション・メッセージ
R0026: ロケーション・コントロール・プレーンのホストのディスク・スペースが不足しています。 ロケーション・コントロール・プレーンに追加のホストを割り当てるか、ディスク・スペースの問題があるホストを再ロードしてください。
解決のための手順
  1. ibmcloud sat host ls --location <location_name_or_ID> | grep infrastructure を実行して、コントロール・プレーンに割り当てられているホストをリストします。
  2. ibmcloud sat host get --host <host_ID> --location <location_name_or_ID> を実行して、ホストの詳細を確認します。
  3. ホストのインフラストラクチャー・プロバイダーで、ホスト・マシンのディスク・スペースを確認します。 各ホストが最小要件を満たしていることを確認します。 ホストを削除してから再接続します。
  4. ホストをデバッグして再接続しても問題が解決しない場合は、ロケーション・コントロール・プレーンが稼働を継続するために追加のコンピュート・リソースを必要としています。 ロケーション・コントロール・プレーンに追加ホストを割り当ててください。

R0033、R0034、R0035: コントロール・プレーンの容量の問題

ロケーション・メッセージ
R0033: ロケーション・コントロール・プレーンのホストのメモリー使用量にクリティカルな問題があります。 Add more hosts to the location control plane and wait for the location to return to normal.
R0034: ロケーション・コントロール・プレーンのホストの CPU 使用率にクリティカルな問題があります。 Add more hosts to the location control plane and wait for the location to return to normal.
R0035: ロケーション・コントロール・プレーンは最大容量で実行されており、これ以上のワークロードをサポートできません。 Add hosts to each zone and wait for the location to return to normal.
解決のための手順
  1. 各ゾーンで、ホストの CPU とメモリーのサイズを確認します。
    • ゾーン内にあるホスト全体で、合計で少なくとも 3 つの CPU が使用可能でなければなりません。
    • ゾーン内のすべてのホストにわたって、少なくとも合計 4 GB のメモリーが使用可能でなければなりません。
  2. ロケーションに追加の 3 台のホストを接続します。
  3. 3 つのゾーンのそれぞれに少なくとも 1 台のホストを割り当てることで、コントロール・プレーン操作のための容量を追加します。 ロケーション・コントロール・プレーンをスケールアップするときは、3 の倍数の台数を均等にスケーリングし、ゾーン間で均等にホストを割り当ててください。
  4. ibmcloud ks cluster master refresh --cluster <cluster-id> コマンドを実行してクラスタをリフレッシュします。

R0036: ロケーション・サブドメインのトラフィック・ルーティング

ロケーション・メッセージ
R0036: ロケーション・サブドメインが、コントロール・プレーン・ホストにトラフィックを正しくルーティングしていません。 ibmcloud sat location dns コマンドを使用して、ロケーション・サブドメインがコントロール・プレーン・ホストの正しい IP アドレスに登録されていることを確認します。
解決のための手順
ロケーション・サブドメインでトラフィックがコントロール・プレーンのホストにルーティングされないのはなぜですか?を参照してください。

R0038、 R0101: ロケーションでクラスター操作が進行中です

ロケーション・メッセージ
R0038: Satellite ロケーションに、操作中のクラスターがあります。 Wait for them to finish and check back later.
R0101: Satellite のロケーションでは、操作の途中でクラスターが発生しています。 Wait for them to finish and check back later.
解決のための手順
クラスターの操作が完了するまで待機し、後で再度確認してください。

R0043: レイヤー 3 接続

ロケーション・メッセージ
R0043: ロケーションが次の要件を満たしていません。ホスト全体のすべてのポートに対して、ホストに TCP/UDP/ICMP レイヤー 3 接続が必要です。 If you still have issues, contact IBM Cloud Support and include your Satellite location ID.
解決のための手順
すべてのホストのポートで TCP/UDP/ICMP のレイヤー 3 接続が可能でなければなりません。 ホスト間の通信に必要なポートへのアクセスをブロックすることはできません。 ホスト・ネットワーク要件を確認し、インフラストラクチャー・プロバイダーでホストのポートのブロックを解除してください。 このエラーは、必要な RHEL パッケージがホストにインストールされていないか、必要な CPU、メモリー、ディスク・スペース、およびファイアウォール・ポートが開いたことを意味する場合もあります。 ご使用のホストがすべての要件を満たしていることを確認した後、プラットフォーム・ログを調べてください。

ホスト間のすべてのポートで TCP/UDP/ICMP レイヤー 3 接続をテストするには、次の操作を行います。

  1. ロケーションに接続されているものの、リソースには割り当てられていないホストに SSH で接続します。

    SSH でマシンに接続できるのは、ホストをクラスターに割り当てていない場合、または割り当てが失敗した場合のみです。 通常は、セキュリティーのために、SSH でホストにログインする機能は Satellite によって無効にされています。 ホストを削除してオペレーティング・システムを再ロードすることで、SSH でマシンに接続する機能を復元できます。

  2. TCP 接続を確認するには、netcat がポート 10250 で他のすべてのホストから応答を受信することを確認します。 操作がタイムアウトした場合は、ホストのネットワーク要件を確認し、インフラストラクチャー・プロバイダーでホストのポートのブロックを解除してください。

    nc -zv <host_IP> 10250

  3. ICMP 接続を確認するには、他のすべてのホストに対して ping が成功することを確認します。 ロケーションに接続されているホストの IP アドレスごとに、この手順を繰り返します。 ping がタイムアウトした場合は、ホストのネットワーク要件を確認し、インフラストラクチャー・プロバイダーでホストのポートのブロックを解除してください。

    ping <host_IP>

  4. TCP および ICMP の接続チェックで問題が検出されない場合は、一度に 1 つずつホストをリブートして、すべてのコントロール・プレーン・ホストをリブートします。 同時にコントロール・プレーン・ホストをリブートしないでください。これにより、コントロール・プレーン・ホストで etcd を実行できなくなる可能性があります。

R0044: DNS の問題

ロケーション・メッセージ
R0044: 1 つ以上のホストで DNS の問題が検出されました。 Verify that your DNS solution is working as expected. If you still have issues, contact IBM Cloud Support and include your Satellite location ID.
解決のための手順
ロケーションの 1 台以上のホストが DNS 照会を解決できないか、予期しない問題が検索ドメインで発生しています。 予期されるとおりに DNS ソリューションが機能していること、およびすべてのホストが ネットワーク・ホスト要件を満たしていることを確認してください。

DNS 解決をテストするには、以下のようにします。

  1. ロケーションに接続されているものの、リソースには割り当てられていないホストに SSH で接続します。

    SSH でマシンに接続できるのは、ホストをクラスターに割り当てていない場合、または割り当てが失敗した場合のみです。 通常は、セキュリティーのために、SSH でホストにログインする機能は Satellite によって無効にされています。 ホストを削除してオペレーティング・システムを再ロードすることで、SSH でマシンに接続する機能を復元できます。

  2. DNS 解決が正常に機能していることを確認します。

    dig +short +timeout=5 +nocookie cloud.ibm.com

  3. DNS設定において、 localhost およびこれに追加された検索ドメインが、何も解決されないか、あるいは 127.0.0.1 のみに解決されるようにしてください。 各ホストのDNS解決を管理する /etc/resolv.conf ファイルには、 search ibm.com など、複数の検索ドメインを記載することができます。 各ホストの Calico Typha ポッドは、localhost の解決を使用するヘルス・チェックを実行します。 ヘルスチェックが localhost の解決を試みる際に、検索ドメインが追加されると、ヘルスチェックは失敗します。 ヘルスチェックが正常に実行されるようにするため、 localhost の末尾に、記載されている検索ドメインのいずれかを付加した際に、 127.0.0.1 の IP アドレス以外には解決されないことを確認してください。

R0045: ホストの読み取り専用ファイル・システムの問題

ロケーション・メッセージ
R0045: 1 つ以上のホストで読み取り専用ファイル・システムが検出されました。 Replace the affected host(s).
解決のための手順
  1. 影響を受けているホストに関する詳しい情報を得るために、IBM Cloud Logs ロケーション・プラットフォーム・ログ用に Satellite をセットアップします。
  2. 影響を受けているホストを削除し、新しいホストを再接続します。
  3. それでも問題が解決しない場合は、サポート Case を開き、Satellite ロケーション ID を記入してください。

R0046: NTP の問題

ロケーション・メッセージ
R0046: 1 つ以上のホストで NTP の問題が検出されました。 Verify that your NTP solution is working as expected.
解決のための手順
ロケーションの 1 台以上のホストの Network Time Protocol (NTP) に、解決しなければならない問題があります。

ホストで NTP をテストするには、以下のようにします。

  1. ロケーションに接続されているものの、リソースには割り当てられていないホストに SSH で接続します。

    SSH でマシンに接続できるのは、ホストをクラスターに割り当てていない場合、または割り当てが失敗した場合のみです。 通常は、セキュリティーのために、SSH でホストにログインする機能は Satellite によって無効にされています。 ホストを削除してオペレーティング・システムを再ロードすることで、SSH でマシンに接続する機能を復元できます。

  2. ホストから報告される時刻と実際の時刻の差が 3 分を超えていないことを確認します。 時刻の差が 3 分を超えている場合は、NTP の解決方法についてインフラストラクチャー・プロバイダーに確認してください。

    date +%s

  3. この手順を繰り返して、NTP に問題があるホストを特定します。

R0047: ロケーションのヘルス・チェック

ロケーション・メッセージ
R0047: IBM Cloud は、ヘルス・チェック・エンドポイントを使用してロケーションの正常性を検査できません。
解決のための手順
IBM Cloud でロケーションの正常性を確認できないのはなぜですか? を確認してください。

R0048: etcd バックアップの障害

ロケーション・メッセージ
R0048: ロケーションのクラスターの etcd バックアップが、過去 1 日以内に完了できませんでした。
解決のための手順
etcd データは、Satellite ロケーション・コントロール・プレーンから IBM Cloud Object Storage インスタンス内のバケットに 8 時間ごとにバックアップされます。 このバックアップが24時間の間に3回連続で失敗した場合は、 Object Storage のバケットまたはサービスインスタンスに問題があるか、あるいは Satellite のロケーションと Object Storage インスタンスとの接続に問題がある可能性があります。

問題が存在する場所を判別するには、以下のようにします。

  1. ロケーション・コントロール・プレーンに割り当てたホストが、ロケーションを管理する IBM Cloud Object Storage リージョンの IBM Cloud エンドポイントにアクセスできることを確認してください。 例えば、ホスト・ファイアウォールで、コントロール・プレーン・ホストから以下のエンドポイントへのアウトバウンド接続を許可する必要があります。
ホストからObject Storageエンドポイントへのアウトバウンド接続が必要
リージョン Object Storage エンドポイント
wdc s3.us.cloud-object-storage.appdomain.cloud
lon s3.eu.cloud-object-storage.appdomain.cloud

  1. etcd データをバックアップする Object Storage サービス・インスタンスおよびバケットが使用可能であり、削除されていないことを確認します。

    1. Satellite コンソールから、ロケーションの名前をクリックします。
    2. ロケーション概要の詳細セクションで、Object Storage バケットの名前をコピーします。
    3. IBM Cloud コンソールで、 IBM Cloud のリソース一覧に移動します。
    4. **「ストレージ」**行を展開します。
    5. バケットを作成した Object Storage インスタンスを探します。 ロケーションの作成時にバケット名を指定しなかった場合は、各 Object Storage インスタンスを確認し、そのロケーション用に自動生成されたバケットが見つかるまで探してください。
    6. インスタンス名をクリックします。 **「バケット」**リスト・ページが開きます。
    7. コントロール・プレーンの etcd のバックアップのバケットが存在することを確認します。
    8. サービス・インスタンスまたはバケットが削除されていた場合は、サポート Case を開き、Satellite ロケーション ID を含めてください。

  2. コントロール・プレーン・ホストが Object Storage エンドポイントに到達でき、Object Storage サービス・インスタンスおよびバケットが存在する場合、バックアップ障害を調査するためにサポート Case を開き、Satellite ロケーション ID を含めてください。

R0049: Satellite Link IAM API キーの問題

ロケーション・メッセージ

Linkトンネルクライアントで認証に関する問題が発生しています。 IBM Cloud サポートに連絡して、Satellite ロケーション ID をお知らせください。

このエラーが発生するのは、そのロケーションが属するリージョンまたはリソースグループに設定されている IAM API キーが、 Satellite または Kubernetes Service で指定された必要な権限を持っていないためです。通常、これは API キー所有者の権限が変更されたか、API キー所有者がアカウント削除されたことが原因です。

解決のための手順

Satellite のロケーションに Red Hat OpenShift クラスターがあり、かつ、 アカウント所有者、またはすべての Satellite コンポーネントに対して管理者権限を持つユーザーである場合は、APIキーをリセットすることでこの問題を解決できます。 API キーをリセットすると、古いキーが削除されることに注意してください。 この API キーが他のサービスで使用されていないか確認してください。

  1. IBM Cloud: ibmcloud login にログインします。
  2. ロケーションの管理元のリージョンをターゲットにします。ibmcloud target -r <region>。
  3. ロケーションがにあるリソース・グループをターゲットにします。ibmcloud target -g <resource-group>。
  4. そのリージョンまたはリソース・グループの IAM API キーをリセットします。ibmcloud ks api-key reset --region <region>。
  5. API キーが設定されていることを確認します。ibmcloud ks api-key info --cluster <roks_cluster_in_location>。
  6. サポート Case を開き 、リフレッシュするクラスターが含まれている場所を確認します。 ibmcloud sat location ls コマンドを実行して見つけることができるロケーション ID を含めます。

ロケーションにクラスターがない場合は、自分で API キーをリセットすることはできません。 代わりに、 サポート Case を開き 、ロケーションを最新表示するように依頼してください。 ibmcloud sat location ls コマンドを実行して見つけることができるロケーション ID を含めます。

R0050、R0051: Satellite Link コネクターの問題

ロケーション・メッセージ
Linkトンネルクライアントで、トークン認証に関する問題が発生しています。 IBM Cloud サポートに連絡して、Satellite ロケーション ID を含めます。
LinkトンネルクライアントがロケーションIDを取得できません。 IBM Cloud サポートに連絡して、Satellite ロケーション ID をお知らせください。
解決のための手順
サポート Case を開き、Satellite ロケーション ID を含めます。

R0052: Ingress 証明書の生成の問題

ロケーション・メッセージ
ロケーション・エンドポイント用の Ingress 証明書が生成されていません。
解決のための手順
IBM Cloud サポートに通知され、問題を解決するための作業が行われています。 後でもう一度試してください。

R0056: ポッドの状況がterminatingでスタックする

ロケーション・メッセージ
1 時間以上、ロケーション・コントロール・プレーン・ノードでポッドが終了状態のままになっています。
解決のための手順
1 時間以上終了状態のままになっているポッドは、ロケーション・コントロール・プレーンが正常でないことを示します。 ロケーション・コントロール・プレーン・ホストを再始動して、問題が解決されるかどうかを確認します。 それでも問題が解決しない場合は、手順に従って、ロケーション・コントロール・プレーン・ホストを交換します。

コントロール・プレーン・ホストを更新または交換すると、**同時に複数のホストを割り当てまたは削除しないでください。**そうするとコントロール・プレーンが壊れる可能性があります。 あるホストの割り当てまたは削除が完了するまで待ってから、別のホストの割り当てまたは削除を行う必要があります。 サービスの中断を防ぐため、ホストを削除する前に、必ずコントロールプレーンに追加のホストを接続し、割り当てを行ってください。

  1. コントロール・プレーンから削除する各ホストについて、追加のホストを接続してください。
  2. 自分のロケーションに 接続されたホストを割り当てます。 別のホストを割り当てる前に、ホストを一度に 1 つずつ割り当て、各割り当てが完了していることを確認してください。
  3. Satellite ロケーションから元のホストを削除します。 ホストを一度に 1 つのみ削除し、各削除が完了してから別のホストを削除するようにしてください。

影響を受けるコンポーネントに関する追加情報については、 IBM Cloud Logs を設定し、R0056 エラー ログ。

R0057: IAM へのアウトバウンド・トラフィックが失敗する

ロケーション・メッセージ
IBM Cloud IAM へのアウトバウンド・トラフィックが失敗しています。 すべてのホスト要件が満たされていることを確認するには、ホスト・システム要件を参照してください。 詳しくは、IBM Cloud プラットフォーム・ログを参照してください。 問題が解決しない場合は、IBM Cloud サポートに連絡して、Satellite ロケーション ID を伝えてください。
解決のための手順
正常性の状況を調べて、ホスト・システム要件が満たされていることを確認してください。

  1. 以下のコマンドを実行して、正常性状況を確認します。

    curl https://iam.cloud.ibm.com/healthz

  2. 前のステップの出力が失敗を示している場合は、ホストがすべての システム要件を満たしていることを確認します。

  3. システム要件をすべて満たしているにもかかわらず問題が解決しない場合は、 サポートチケットを発行し、 Satellite のロケーションIDを記載してください。 ibmcloud sat location ls コマンドを実行して、ロケーション ID を見つけることができます。

影響を受けるコンポーネントに関する追加情報については、 IBM Cloud Logs を設定し、R0057 エラー ログ。

R0058: DNS 登録が失敗する

ロケーション・メッセージ
この名前のロケーションは最近削除されました。 最近削除した場所の名前を再利用したい場合、DNSの登録が完了するまで最大1週間かかります。
解決のための手順
このロケーション名を再使用する必要がない場合は、このロケーションを削除して、固有の名前でロケーションを作成してください。 問題が解決しない場合は、サポート Case を開いて Satellite ロケーション ID を指定してください。

R0059: IBM Cloud Container Registry への送信トラフィックが失敗しています。

ロケーション・メッセージ
IBM Cloud Container Registry への送信トラフィックが失敗しています。 すべてのホスト要件が満たされていることを確認するには、 ホスト・システム要件 を参照してください。 詳しくは、IBM Cloud プラットフォーム・ログを参照してください。 問題が解決しない場合は、IBM Cloud サポートに連絡して、Satellite ロケーション ID を伝えてください。
解決のための手順
正常性の状況を調べて、ホスト・システム要件が満たされていることを確認してください。

  1. 以下のコマンドを実行して、正常性状況を確認します。

    curl https://iam.cloud.ibm.com/healthz

  2. 前のステップの出力が失敗を示している場合は、ホストがすべての システム要件を満たしていることを確認します。

  3. システム要件をすべて満たしているにもかかわらず問題が解決しない場合は、 サポートチケットを発行し、 Satellite のロケーションIDを記載してください。 ibmcloud sat location ls コマンドを実行して、ロケーション ID を見つけることができます。

影響を受けるコンポーネントに関する追加情報については、 IBM Cloud Logs を設定し、R0059 エラー ログ。

R0061: IBM Cloudから Satellite クラスター API サーバーに到達できません。

ロケーション・メッセージ
Satellite クラスター API サーバーは、 IBM Cloudから到達できません。 詳細については、『 IBM Cloud Platform Logs』を参照してください。 問題が解決しない場合は、IBM Cloud サポートに連絡して、Satellite ロケーション ID を伝えてください。
解決のための手順
この問題を解決するには、以下の手順に従ってください。

  1. 詳しくは、 IBM Cloud プラットフォーム・ログを確認してください。 詳細については、 IBM Cloud Logs の設定を 参照し、 R0061 エラー ログ。

  2. ご使用のホストがすべての システム要件 を満たしていることを確認します。特に、 IBM およびリンク・トンネル・クライアントに接続するためのアウトバウンド接続について確認します。

  3. システム要件をすべて満たしているにもかかわらず問題が解決しない場合は、 サポートチケットを発行し、 Satellite のロケーションIDを記載してください。 ibmcloud sat location ls コマンドを実行して、ロケーション ID を見つけることができます。