IBM Spectrum Symphony のトラブルシューティング

IBM Cloud Schematics がプライベート GitHub リポジトリーを複製できないのはなぜですか?

Schematics はプライベート GitHub リポジトリーを複製できず、次のエラー・メッセージが表示されます: Failed to clone git repository, repository not found (check url, also check the scope 'repo' of the personal access token if SCHEMATICSGITTOKEN is used)

正しい GitHub トークンを指定しなかったか、 GitHub トークンを完全に指定しませんでした。

GitHub トークンを指定し、ワークスペース作成 API の github_token パラメーターで正しい GitHub トークンが指定されているかどうかを確認します。

IBM Cloud Schematics がパブリック GitHub リポジトリーを複製できないのはなぜですか?

Schematics はパブリック GitHub リポジトリーを複製できず、以下のいずれかのエラー・メッセージが表示されます。

Fatal, could not download repo, Failed to clone git repository, authentication required (or the git url is incorrect). Problems found with the Repository. Please Rectify and Retry
Template error: Failed to clone git repository, authentication required (or the git url is incorrect)

正しい GitHub URL を指定しなかったか、 GitHub トークンを指定しましたが、これはパブリック・リポジトリーの複製には必要ありません。 GitHub アクセス・トークンは、プライベート・リポジトリーにアクセスするためにのみ必要です。

GitHub トークンを指定しないでください。また、パブリック・リポジトリーを使用してワークスペースを作成する際に、 github_token パラメーターに GitHub トークンが指定されているかどうかを確認してください。

IBM Cloud Schematics がワークスペースを作成できないのはなぜですか?

Schematics はワークスペースを作成できず、次のエラー・メッセージが表示されます: You don't have the required to create a workspace in any resource groups. You must be assigned the manager role on the Schematics service in at least one resource group. Contact your account administrator for access.

リソース・グループ内にワークスペースを作成するために必要なアクセス権限がありません。少なくとも 1 つのリソース・グループで Schematics サービスに対するマネージャー役割が割り当てられている必要があります。

アカウント管理者に連絡して、少なくとも 1 つのリソース・グループの Schematics サービスに対するマネージャー役割を割り当てます。

IBM Cloud Schematics がクラスターをプロビジョンできず、 `symphony_license_confirmation` 変数のエラー・メッセージで失敗するのはなぜですか?

Schematics がクラスターをプロビジョンできず、次のエラー・メッセージが表示されます。 Error: Invalid value for variable "symphony_license_confirmation"

プロパティー symphony_license_confirmation に「true」以外の値を入力しました。

プロパティー symphony_license_confirmation は、有効な値として「true」のみを受け入れます。「true」の値は、以下の 2 つの条件のいずれかに同意したことを示します。

実動クラスターをデプロイする場合は、 IBM Spectrum LSF を IBM Cloud にデプロイするための十分なライセンスがあり、これらのライセンスが国際プログラムのご使用条件でカバーされていることをビジネス・チームに確認してください。
IBM Cloud に IBM Spectrum LSF を使用して評価クラスターをデプロイし、プログラム評価のご使用条件 (ILAE) に従うことに同意します。

IBM の IPLA および ILAE のソフトウェアご利用条件については、こちらを参照してください。

2 つの条件のいずれかに同意した後、プロパティー値を「true」に更新して再試行してください。

IBM Cloud Schematics がクラスターをプロビジョンできず、許可エラーで失敗するのはなぜですか?

Schematics がクラスターをプロビジョンできず、次のエラー・メッセージが表示されます。 Request is not authorized. Check your user permissions and authorizations and try again.

プロビジョンされた VPC リソースを取得するために必要なアクセス権限がありません。

アカウント管理者に連絡して、必要なすべてのアクセス権限を取得してください。詳しくは、必要な許可を参照してください。

IBM Cloud Schematics がクラスターをプロビジョンできず、指定された名前が固有でないというエラーで失敗するのはなぜですか?

Schematics がクラスターをプロビジョンできず、以下のエラー・メッセージの例が表示されます。

"code": "validation_unique_failed",
"message": "Provided Name (sample-symphony-vpc) is not unique",
"target": {
"name": "name",
"type": "field",
"value": "sample-symphony-vpc"
}

VPC リソース名は固有でなければなりません。同じ名前のリソースが存在する場合は、同様のエラーが発生する可能性があります。

既存のリソースをプロビジョン解除して、再試行してください。

IBM Cloud Schematics がカスタム・イメージの使用中にクラスターをプロビジョンできないのはなぜですか?

カスタム・イメージの使用中に、 Schematics がクラスターをプロビジョンできず、以下のいずれかのエラー・メッセージが表示されます。

The argument "image" is required, but no definition was found.
Unknown variable. There is no variable named "image_id".

仮想サーバー・インスタンスの 1 つに使用されるカスタム・イメージがターゲットのリージョンとゾーンに存在しないか、クラスターのプロビジョンに使用されるアカウントと API キーからアクセスできません。

いずれかの仮想サーバー・インスタンスにカスタム・イメージを使用している場合は、そのカスタム・イメージがターゲットのリージョンとゾーンで使用可能であり、クラスターのプロビジョンに使用されるアカウントと API キーからアクセス可能であることを確認してください。

リフレッシュ・トークンのエラーを受け取るのはなぜですか?

計画の生成、 計画の適用、および リソースの破棄 要求でリフレッシュ・トークン・エラーを受け取ります。 Error: The provided Refresh Token is invalid. Please provide a proper refresh token for Terraform to run the configuration. Code: 400

正しいリフレッシュ・トークンを指定しなかったか、リフレッシュ・トークンを完全に指定しませんでした。

curl コマンドを使用して生成されたリフレッシュ・トークンが正しいかどうかを確認してください。正しい場合は、リフレッシュ・トークンを再生成してください。

ワークスペースに変更を適用するとエラーが発生するのはなぜですか?

ワークスペースに変更を適用しようとすると、次のエラーが発生します: Apply failed due to "Error: Error Deleting Volume : The volume is still attached to an instance."

ボリューム・プロファイル、容量、または IOPS を再構成した後、変更を適用する前にワークスペースをクリーンアップする必要があります。

既存のリソースを破棄して、変更の適用を再試行する必要があります。既存のリソースを破棄すると、ストレージ・ノード上のデータは削除されます。

指定された ssh_key_name 値のエラーを受け取るのはなぜですか?

Schematics ワークスペースで計画を生成または適用しようとすると、以下のエラーが発生します。 failed due to "Error: No SSH Key found with name <KEY_NAME>".

Terraform は、指定された SSH 鍵の名前を検出できませんでした。

指定された SSH 鍵が、クラスターがプロビジョンされている現在のリージョンに存在するかどうかを確認してください。指定された SSH 鍵が存在しない場合は、現在のリージョンに SSH 鍵を作成します。
複数の SSH 鍵を構成する場合は、SSH 鍵の名前の前後に空白文字が追加されていないことを確認してください。
複数の SSH 鍵を使用している場合は、SSH 鍵の間の区切り文字としてコンマ (,) が使用されているかどうか、および SSH 鍵の前後に空白文字が追加されていないことを確認してください。

Spectrum Symphony VaR シミュレーションを実行しようとするとエラーが発生するのはなぜですか?

Spectrum Symphony Value at Risk(VaR)シミュレーションを実行しようとすると、 Failed to Login エラーが発生します。

VaR シミュレーションで制限が発生している可能性があります。このシミュレーションでは、クラスター接頭部は 10 文字以下でなければならず、Symphony の 1 次ホスト・ホスト名は 20 文字未満でなければなりません。

クラスター接頭部が 10 文字を超えないようにしてください。

ワークロードの進行中にワーカー・ノードが解放される

symA リクエスターは、ワークロードがまだ進行中の間に、計算ノード仮想マシンを解放する場合があります。これは、プロパティー return_idle_only が true に設定されており、即時戻りポリシー symA がこのホストの割り振りを取得できないため、割り振りがないと想定した場合に発生します。この問題は、モニター対象アプリケーションのタスクが少数しか残っていない場合に発生します。詳しくは、ワーカー・ノードが削除されるまでのアイドル時間の更新を参照してください。

プロバイダー構成値が正しくないとエラーにならない

Symphony GUI から IBM Cloud プロバイダー構成を更新する場合、 「メニュー」アイコン「リソース」>「クラウド」>「構成」 で、構成に設定されている値は検証されません。構成に無効な値がある場合、仮想マシンのプロビジョニングは失敗します。障害が発生した場合は、 /opt/ibm/spectrumcomputing/hostfactory/log for more information で HostFactory サービスを実行しているホストのホスト・ファクトリー・ログを確認します。

専用ホストで使用可能なプロファイルの制限

このオファリングは、ワーカー・インスタンス (worker_node_instance_type) のインスタンスと同じ接頭部 (例えば、 bx2 および cx2) になるように、専用ホストのインスタンス・プロファイルを自動的に選択します。ただし、ターゲット・リージョンによっては、使用可能なインスタンス接頭部を制限することができます。専用ホストを使用する場合は、 ibmcloud target -r {region_name} および ibmcloud is dedicated-host-profiles を調べて、 worker_node_instance_type にターゲット領域に使用可能な接頭部があるかどうかを確認します。

認証またはタイムアウトの問題が原因でリソース・エラーが表示されるのはなぜですか?

特定のリソースの作成中に、以下のエラー・メッセージを受け取ります。

Error: An error occurred while performing the ‘authenticate’ step: Post “https://iam.cloud.ibm.com/identity/token”: context deadline exceeded (Client.Timeout exceeded while awaiting headers)
Error: timeout while waiting for state to become 'done, ' (last state: 'provisioning', timeout: 10m0s)

Schematics はインフラストラクチャー・リソースをデプロイしますが、API 呼び出しを介して IBM Cloud で認証します。クラウド環境への API を介した要求が多すぎる場合、 Schematics は認証できず、認証エラーでエラーが発生する可能性があります。

いずれかの問題 (認証エラーまたはタイムアウト・エラーが原因でリソースが失敗する) を修正するには、 Schematics ワークスペースのリソースを破棄し、リソースのデプロイを再試行してください。

クラスターの作成が SSH の問題で失敗するのはなぜですか?

Ansible プロビジョナーがワーカー・ノード・リソースおよびストレージ・ノード・リソースで Storage Scale 機能をセットアップしようとすると、以下のエラー・メッセージを受け取ります。

msg": "Failed to connect to the host via ssh, Connection closed by UNKNOWN port 65535", "unreachable": true}
Error: Failed to connect to the host via ssh: Connection timed out during banner exchange", "unreachable

Schematics はインフラストラクチャー・リソースをデプロイしますが、自動化コードはいくつかの Ansible プレイブックを使用して構成されます。これらのプレイブックは、 Ansible プロビジョナーを使用して仮想サーバー・インスタンス・ノード上で Storage Scale 機能をセットアップするために必要です。 Ansible プロビジョナーが Storage Scale 機能を使用するためにこれらのノードに SSH で接続しようとすると、ノードは unreachable 状態になります。

この問題を修正するには、以下のようにします。

ワークスペースからリソースを破棄して、再度デプロイしてください。
すべてのデプロイメントでこの問題が発生した場合は、 IBM Cloud サポート・チームにサポートの問題を報告して、インフラストラクチャーの問題がないか調査します。
インフラストラクチャーに問題がない場合は、さらに調査できる自動化チームにこの問題を報告してください。

イメージが見つからないというエラーを受け取るのはなぜですか?

ワークスペースに計画を生成または適用しようとすると、次のエラーが発生します: Apply failed due to "Error: [ERROR] No image found with name hpcc-symp731-scale5151-rhel84-v1-4".

プランの生成中または適用中に、Terraform は、指定されたイメージ名とそのイメージ ID が image_map.tf ファイルに存在するかどうかを検証しようとします。 Terraform は、正しいイメージの詳細を検出するとインスタンスをプロビジョンしますが、正しいイメージの詳細が見つからない場合は、 data_source を介して IBM Cloud からイメージの詳細をフェッチしようとします。

提供されたイメージがその特定のリージョンからクラウドに存在しない場合でも、エラーを受け取る可能性があります。

指定されたイメージ名にスペースが含まれているかどうか、およびそのイメージがデプロイメントを実行するリージョンに存在するかどうかを確認する必要があります。

`cannot_start_capacity` エラーを受け取るのはなぜですか?

ワークスペースにプランを適用しようとすると、次のエラーが発生します: Apply failed due to "code : cannot_start_capacity : message : Can't start instance because resource capacity is unavailable.

プランの適用プロセス中に、Terraform は、選択されたデプロイメント値に基づいて、仮想サーバー・インスタンスのプロビジョニング・プロセスまたはベア・メタル・サーバー・プロセスを開始します。デプロイしようとしているリージョンからリソース・キャパシティーの問題または割り当て量の問題が発生した場合、リソースは予期したとおりにプロビジョンされません。

特定のリージョンの割り当て量を増やすには、アカウントの管理者に相談する必要があります。あるいは、クラウド・インフラストラクチャーに関連付けられている不要なリソースをすべてクリーンアップしてみることもできます。不要なリソースをクリーンアップすると、デプロイメントで処理するスペースを解放することができます。

クラスターが IBM お客様番号エラーで失敗するのはなぜですか?

ワークスペースにプランを適用しようとすると、次のエラーが発生します: Apply failed due to "ERROR - [CLOUD-DEPLOY] Provided IBM Customer Number is not entitled to use Spectrum Symphony on Cloud. Kindly contact IBM Support Team. Exiting!

プランの適用プロセス中に、ブートストラップ・ノードは、ストレージおよびコンピュート・クラスター作成用のリソースのプロビジョニングを開始します。このプロセス中に、BYOL 概念を使用して、RPM および GPFS 関連パッケージと Symphony パッケージを暗号化解除する必要があります。 IBM お客様番号が有効な場合は、デプロイメントが開始されます。そうでない場合、自動化によってデプロイメントがエラーになります。

番号にスペースを含めずに、 Spectrum Symphony の資格を持つ有効な IBM お客様番号を指定する必要があります。指定した値が有効であり、それでもこのエラーが発生する場合は、 IBM サポートに連絡して、資格について明確にしてください。

インスタンス・プロビジョニングが `Starting` 状態のままになるのはなぜですか?

プランを適用した後、ワークスペースが仮想サーバー・インスタンスをプロビジョンするのに時間がかかり、ユーザー・インターフェースで仮想サーバー・インスタンスが Starting 状態のままであることに気付きます。

プランの適用プロセス中に、Terraform はクラウド・インフラストラクチャー内の仮想サーバー・インスタンスのプロビジョニング・プロセスを開始します。その特定の地域およびゾーンについて、インフラストラクチャー側からキャパシティーの問題または何らかの問題が発生した場合は、この問題が発生する可能性があります。

同じ問題が発生するかどうかを確認するために、自動化プロセス中に使用されるものと同じイメージを使用してユーザー・インターフェースでインスタンスを手動で作成することも、デプロイメント用に別のゾーンを試行することもできます。また、この問題がインフラストラクチャー側からのものかどうかを確認するために、この問題に対するサポート要求を発行することもできます。

ベアメタル・サーバーのプロビジョンに失敗した後にリソースを削除しようとするとエラーが発生するのはなぜですか?

ベアメタル・サーバーのプロビジョンに失敗し、ブートストラップ・ノードからリソースを削除しようとすると、 mmcloudworkflows cluster destroy コマンドの適用後に次のエラーが発生します。 [ERROR] Error deleting security group target binding while deleting security group : The specified network interface is not attached to any other security groups.

クラスターのプロビジョニングが失敗した場合は、クラスターの再プロビジョンを試行する前に、失敗したプロビジョンのすべてのリソースをクリーンアップすることをお勧めします。

破棄プロセス中に、ブートストラップ・ノードは、プロビジョニング・フェーズ中に作成されたすべてのリソースをクリーンアップしようとします。ベア・メタル・サーバーのプロビジョニングに予想より長い時間がかかり、その後失敗した場合、その後のクリーンアップ中に、失敗したベア・メタル・サーバーが、破棄しようとしているセキュリティー・グループにまだ接続されていることが破棄プロセスで苦情が発生する可能性があります。

クラスター接頭部の名前をコピーし、以下の手順を実行します。

セキュリティー・グループに移動し、-storage-sg にアクセスします。
セキュリティー・グループの接続済みリソース・セクションに移動します。
接続されているベア・メタル・サーバーをクリックし、サーバーの ID をコピーします。

CLI から以下のコマンドを実行して、サーバーを停止および削除します。

ibmcloud is bare-metal-server-stop $bare_metal_server_id

ibmcloud is bare-metal-server-delete $bare_metal_server_id

ベアメタル・サーバーの削除には数秒かかります。ベアメタル・ノードが削除されたら、 Schematics に移動し、リソースの破棄を申請します。

VPC およびサブネットの作成中の `subnet_not_in_address_prefix` エラーまたは `invalid CIDR format` エラーは何ですか?

ワークスペースにプランを適用しようとすると、次のエラーが発生します: Apply failed due to Error: [ERROR] Error while creating subnet. The specified CIDR does not fit in any of the address prefixes in the specified VPC. Make sure the subnet's CIDR is a subset of the CIDR of one of the address prefixes.

プランの適用プロセス中に、ワークスペースは、デプロイメント値から指定された範囲の CIDR アドレス接頭部を持つ VPC およびサブネットを作成しようとします。アドレス接頭部の範囲が範囲外であるか、VPC の IP アドレス範囲のファミリーに属していない場合は、アドレスが範囲内にないというエラーが表示されます。

サブネット作成用に指定されたアドレス接頭部の範囲が、VPC に使用されているのと同じ範囲のアドレスからのものであるかどうかを検証します。例えば、VPC アドレス接頭部が 10.241.0.0/18の場合、サブネットは 10.241.x.x の範囲内でなければなりません。別の IP アドレス範囲を使用する場合は、サブネットを分割して、サブネットの作成に必要な IP アドレス範囲を選択する必要があります。

「プロセスが状況 2 で終了しました (process exited with status 2)」というエラー・メッセージが表示されてデプロイメントが失敗するのはなぜですか?

ワークスペースにプランを適用しようとすると、次のエラーが発生します: Apply failed due to Error: Error: remote-exec provisioner error and error executing "/tmp/terraform_1756078506.sh": Process exited with status 2.

ソリューションは、指定されたライセンス番号が有効であるかどうかを評価するロジックを使用して実装されます。この機能はカスタム・イメージの上に設計されているため、デプロイメントが実行されるたびに、製品デプロイメントが完了するために必要なパッケージが評価され、暗号化解除されます。この機能を持たないイメージを使用すると、自動化コードはエラーになります。

ソリューション・チームによって提供される適切なカスタム・イメージを使用します。ソリューション・チームには、ライセンスを評価し、パッケージを暗号化解除する機能があります。

IBM Cloud Schematics がクラスターをプロビジョンできず、 `Enabling the Custom resolver` エラーで失敗するのはなぜですか?

Schematics は VPC リソースを作成しようとしましたが、カスタム・リゾルバーを作成しようとしましたが、次のエラーで失敗しました: [ERROR] Error Enabling the Custom resolver : MaxTimeout

Terraform は、カスタム・リゾルバー環境の作成を試行し、カスタム・リゾルバーの状態がアクティブ状態になるのを待機します。このプロセス中に、カスタム・リゾルバーが予想よりも多くの時間を費やした場合、Terraform はエラー・メッセージをスローします。

デプロイメントの失敗後に、すべてのリソースをクリーンアップします。それ以降の試行では、前に失敗した試行のリソースと名前が競合しないように、新しいクラスター接頭部を使用してください。問題が引き続き発生する場合は、 IBM Cloud サポートの問題をオープンしてください。

IBM Cloud Schematics がクラスターをプロビジョンできず、パスワードなしの SSH エラーで失敗するのはなぜですか?

spectrum_scale_enabled が true に設定されている場合、 Schematics がすべてのリソースを作成した後、ソリューションは Ansible コードをトリガーして、ストレージ・ベアメタル・サーバー上で Scale 構成全体を構成します。 Ansible の構成中に、以下のエラーが発生します。 [ERROR] Check passwordless SSH on all scale inventory hosts (1 retries left)

すべてのインフラストラクチャー関連リソースが稼働中になると、 Ansible コードは、パスワードなしの SSH 方式を使用して Scale 構成を実行しようとします。このプロセス中に、ストレージ・ベアメタル・サーバー上で SSH サービスが実行状態でない場合、 Ansible はその特定のベアメタル・ストレージ・ノードに SSH で接続できず、エラーで失敗します。

IBM Cloud Schematics がクラスターをプロビジョンできず、 `nmmcrcluster` エラーで失敗するのはなぜですか?

spectrum_scale_enabled が true に設定されている場合、 Schematics がすべてのリソースを作成した後、ソリューションは Ansible コードをトリガーして、ストレージ・ベアメタル・サーバー上で Scale 構成全体を構成します。 Ansible の構成中に、以下のエラーが発生します。 [ERROR] nmmcrcluster: Error found while checking node descriptor

すべてのインフラストラクチャー関連リソースが稼働中になると、 Ansible コードは、パスワードなしの SSH 方式を使用して Scale 構成を実行しようとします。このプロセス中に、ストレージ・ベア・メタル・サーバー上で、前の destroy コマンドからいずれかのベア・メタル構成が適切にクリーンアップされないと、エラーが発生する可能性があります。