Microsoft Azure のインストールの問題のトラブルシューティング

IBM® Maximo® Application Suite のインストールが失敗すると、インストール・パラメーターの欠落や無効、ブート・ノードの作成の失敗、クラスター作成の問題など、多くの原因が考えられます。

Maximo Application Suite のインストールが失敗すると、インストール・パラメーターの欠落や無効、ブート・ノードの作成の失敗、クラスター作成の問題など、多くの原因が考えられます。

障害点

Microsoft Azureで Maximo Application Suite のインストールを開始すると、構成した Microsoft Azure Resource Manager ・テンプレートを使用して、ブート・ノードのリソース・グループにデプロイメントが作成されます。このプロセス中に、ブート・ノードが作成されます。その後、ブート・ノードは Maximo Application Suite の残りのインストールを完了します。

Red Hat® OpenShift® クラスターを作成するために、ブート・ノードはブートストラップ・プロセスを開始します。このプロセスにより、 OpenShift インストーラーを使用してマスター・ノードとワーカー・ノードを作成するブートストラップ・ノードが作成されます。

Maximo Application Suite のインストールは、 Microsoft Azure デプロイメント開始プロセス中、またはブートストラップ・プロセス時に失敗する可能性があります。

Microsoft Azure デプロイメントの開始プロセス中にインストールが失敗した場合は、以下のインディケーターが適用されます。

デプロイメントの実行依頼が失敗しました。
ブート・ノードは作成されません。
リソース・グループのデプロイメント・セクションで、 Maximo Application Suite デプロイメントに関連付けられたデプロイメントが失敗として表示されます。

ブートストラップ・プロセス中にインストールが失敗した場合は、以下の標識が適用されます。

デプロイメントの実行依頼が成功しました。
ブート・ノードが作成されます。
リソース・グループのデプロイメント・セクションで、 Maximo Application Suite デプロイメントに関連付けられたデプロイメントが成功として表示されます。
E メール通知の MAS プロビジョニング状況フィールドに、失敗の原因を示すインストール失敗メッセージが表示されます。以下に例を示します。
```
FAILURE#The provided ER key is not valid. It does not have access to download the MAS images
```

障害の一般的な原因

インストールは、以下のいずれかの理由で失敗する可能性があります。

必須のインストール・パラメーターが欠落しているか、無効なオプション・パラメーターが指定されています。
サポートされない Microsoft Azure 地域が選択されています。
Red Hat OpenShift クラスター・インストーラーは、仮想インフラストラクチャー・リソースの作成を待機した後、タイムアウトになります。

インストール・パラメーターが欠落しているか無効です

すべての必須パラメーターを入力しないと、インストールは失敗します。さらに、オプション・パラメーターのグループ ( Maximo Manage データベース構成パラメーターなど) の場合は、グループのパラメーターをすべて入力するか、すべて空のままにする必要があります。

以下の表は、欠落している必須パラメーターと無効なオプション・パラメーターの障害点を示しています。

パラメーター/グループ	必須/オプション	障害点	詳細情報
SSH 公開鍵	必須	デプロイメント開始プロセス
Bootnode NSG Ingress CIDR IP 範囲	必須	デプロイメント開始プロセス
Microsoft Azure サービス・プリンシパル・クライアント ID	必須	デプロイメント開始プロセス
Microsoft Azure サービス・プリンシパルのクライアント秘密鍵	必須	デプロイメント開始プロセス
ライセンスのあるレジストリー・キー	必須	デプロイメント開始プロセス
URL	必須	デプロイメント開始プロセス
OpenShift プル・シークレット	オプション	ブートストラップ・プロセス	新しい Red Hat OpenShift クラスターを作成する場合は、このパラメーターを指定する必要があります。
パブリック・ドメイン	オプション	ブートストラップ・プロセス
パブリック・ドメイン・リソース・グループ	オプション	ブートストラップ・プロセス
Red Hat OpenShift クラスタ URL	オプション	ブートストラップ・プロセス	既存の Red Hat OpenShift クラスターを再利用する場合は、3 つのパラメーターをすべて指定する必要があります。指定されている数が少ない場合、デプロイメントは失敗します。
OpenShift ユーザー
OpenShift パスワード
SLS エンドポイント URL	オプション	ブートストラップ・プロセス	既存の SLS インスタンスを再利用する場合は、3 つのパラメーターをすべて指定する必要があります。指定されている数が少ない場合、デプロイメントは失敗します。
SLS 登録キー
SLS公開証明書 URL
DROエンドポイント URL	オプション	ブートストラップ・プロセス	既存のDROインスタンスを再利用する場合は、3つのパラメータをすべて指定する必要があります。指定されている数が少ない場合、デプロイメントは失敗します。
DRO APIキー
DRO公開証明書 URL
Maximo Manage DB ユーザー	オプション	ブートストラップ・プロセス	これらのパラメーターは、 Maximo Application Suite コアおよび Maximo Manage オファリングの場合にのみ必須です。
Maximo Manage DB パスワード
Maximo Manage DB JDBC URL
Maximo Manage 証明書 URL
SMTP ホスト	オプション	ブートストラップ・プロセス	これらのパラメーターは、「E メール通知」が `true`に設定されている場合にのみ必須です。
SMTPポート
SMTP ユーザー名
SMTP パスワード

サポートされない Microsoft Azure 地域

Microsoft Azure Marketplace で Maximo Application Suite をサブスクライブしたときに、サポートされない地域を選択した場合、ブートストラップ・プロセスでインストールが失敗します。エラー・メッセージは、ログ・ファイルと E メール通知に以下のように表示されます。

You are using unsupported region for deploying  					Maximo Application Suite.

クラスター・インストーラーのタイムアウト

Maximo Application Suite のインストール・プロセスで、 Red Hat OpenShift cluster インストーラーが待機するネットワーク・リソースの作成に時間がかかりすぎると、クラスター・インストーラーがタイムアウトになる場合があります。この場合、 Maximo Application Suite のインストールがブートストラップ・プロセスで失敗し、ログ・ファイルに以下のエラー・メッセージが表示されます。

Failure in creating OCP cluster.

障害メッセージ

インストールの失敗、考えられる原因、および推奨される次のステップについては、以下の表を参照してください。

失敗メッセージ	失敗の原因	次のステップ
OCP クラスターの作成に失敗しました。	クラスターが必要とする Microsoft Azure リソース (VNet、サブネット、ゲートウェイなど) は作成されません。	この問題は断続的に発生します。 Maximo Application Suiteをアンインストールしてから再インストールします。
OCP クラスターの構成に失敗しました。	エラーのため、 Red Hat OpenShift クラスターは構成されません。例えば、 IBM オペレーター・カタログにアクセスできないために、クラスター構成が失敗します。	セキュア・シェル (SSH) を使用してブート・ノードに接続し、 `/root/mas-on-aws` ディレクトリーから `mas-provisioning.log` ファイルを取得します。 IBM Maximo Application Suite サポートにお問い合わせください。
要塞ホストの作成に失敗しました。	エラーのため、要塞ホストは Red Hat OpenShift クラスターに作成されません。例えば、ご使用の AWS アカウントがサービス制限に達したため、要塞ホストの作成が失敗します。	セキュア・シェル (SSH) を使用してブート・ノードに接続し、 `/root/ansible-devops/multicloud-bootstrap/mas-provisioning.log` ファイルを取得します。 IBM Maximo Application Suite サポートにお問い合わせください。
Ansible プレイブックの実行に失敗しました。	ブート・ノードが Ansible 自動化を使用して Maximo Application Suite 前提条件または Maximo Application Suite 自体を Red Hat OpenShift クラスターにデプロイすると、エラーが発生します。	セキュア・シェル (SSH) を使用してブート・ノードに接続し、 `/root/ansible-devops/multicloud-bootstrap/mas-provisioning.log` ファイルを取得します。 IBM Maximo Application Suite サポートにお問い合わせください。
このリージョンは、 MAS デプロイメントではサポートされていません。	Microsoft Azure Marketplace からの Maximo Application Suite デプロイメント中に、サポートされない地域を選択しました。	Maximo Application Suiteをアンインストールします。 Maximo Application Suiteを再インストールするときに、構成ページでサポートされる地域を選択します。サポートされる地域のリストについては、 Microsoft Azure への Maximo Application Suite のインストールの準備のトピックを参照してください。
指定された ER キーが無効です。 MAS イメージをダウンロードするためのアクセス権限がありません。	Maximo Application Suite イメージは、 `Entitled registry key` インストール・パラメーターで指定されたキーを使用して IBM Entitled Registry からダウンロードできません。	Maximo Application Suiteをアンインストールします。 ER キーに、レジストリーから Maximo Application Suite イメージをダウンロードするための資格があることを確認します。例えば、 Docker コマンド・シェルで、以下のコマンドを使用して、 Maximo Application Suite イメージを手動でダウンロードできることを確認します。 `docker login cp.icr.io -u cp -p <ER-key> docker pull cp.icr.io/cp/mas/admin-dashboard:5.1.27` Maximo Application Suiteを再インストールします。
OCP プル・シークレットを指定してください。	`OpenShift pull secret` インストール・パラメーターでは、 OpenShift プル・シークレットは提供されません。	Maximo Application Suiteをアンインストールします。 Maximo Application Suiteを再インストールする場合は、 `OpenShiftPullSecret` インストール・パラメーターにプル・シークレットを指定します。
有効な MAS URL を入力してください。	`MAS license URL` のインストールパラメータでは、 HTTP または S3 の Maximo Application Suite ライセンスファイルの場所が指定されていません。	Maximo Application Suiteをアンインストールします。再インストール Maximo Application Suite の際には、 HTTP または S3 の Maximo Application Suite ライセンスファイルの場所を `MASLicenseUrl` インストールパラメータに指定してください。
既存の SLS を使用するには、すべての入力を指定してください。	既存の SLS インスタンスに無効なパラメーターが指定されています。	Maximo Application Suiteをアンインストールします。 Maximo Application Suiteを再インストールする場合は、 `Existing Infrastructure` グループの SLS 詳細のすべてのパラメーターを指定するか、すべて空のままにします。これらのパラメーターをすべて空のままにすると、新しい SLS インスタンスがクラスター内に作成されます。
既存の.DROを使用するためのすべての入力を提供してください	既存の DRO インスタンスに無効なパラメータが指定されている。	Maximo Application Suiteをアンインストールします。再インストールを Maximo Application Suiteにする場合は、`Existing Infrastructure`グループにDROの詳細に関するパラメータをすべて入力するか、すべて空欄にしてください。これらのパラメータをすべて空のままにすると、クラスタ内に新しいDROインスタンスが作成されます。
既存の OCP を使用するには、すべての入力を指定してください。	既存の Red Hat OpenShift クラスターに無効なパラメーターが指定されています。	Maximo Application Suiteをアンインストールします。 Maximo Application Suiteを再インストールする場合は、 `Existing Infrastructure` グループの Red Hat OpenShift クラスターの詳細のすべてのパラメーターを指定するか、すべて空のままにします。これらのパラメーターをすべて空のままにすると、新しい Red Hat OpenShift クラスターが作成されます。
Maximo Manage の JDBC の詳細が欠落しているか無効です。	Maximo Manage データベース構成パラメーターが指定されていないか、指定されたパラメーターが無効です。	Maximo Application Suiteをアンインストールします。有効な JDBC パラメーターを指定して、 Maximo Manage データベースに接続します。 dbeaverなどのデータベース接続ツールと、 Maximo Manage データベース構成資格情報を使用して、データベースに接続できることを確認します。 Maximo Application Suiteを再インストールします。