IBM Maximo Application Suite のセットアップ

IBM® Maximo® Application Suiteをインストールすると、セットアップ・プログラムによって初期構成がガイドされます。

始める前に

  1. インストールを完了します。

    Maximo Application Suiteセットアッププログラムへのリンクと、セットアッププロセスの完了に必要なログイン認証情報を取得します。

    ログイン認証情報の入手方法については、 デフォルトのユーザー名とパスワードを確認する方法を参照してください。

  2. Maximo Application Suite 自己署名証明書のログインを有効にします。
    開発環境またはテスト環境で自己署名証明書を使用している場合は、以下のいずれかの方法を使用して手動でログインを有効にする必要があります。
    • クラスターから証明書をダウンロードし、それらをローカルの証明書マネージャーに追加します。
    • ブラウザで URL https://api.<mas_domain>/ にアクセスし、証明書のセキュリティリスクを受け入れます。 リスクを受け入れると、AIUC01999E エラーが表示されます。 このメッセージは予期されたものです。 これで、セットアップ・プロセスを続行できます。

    もし Maximo Application Suite 初回ログイン後にダッシュボードがロードされず、代わりにスピニング・ホイールが表示される場合は、 問題のトラブルシューティング方法を参照してください。

このタスクについて

Maximo Application Suiteのセットアップ設定は、System スコープで設定します。 構成スコープの詳細については、 構成 Maximo Application Suite を参照してください。

手順

  1. インストール時に作成されたスーパーユーザー認証情報を使用して、 Maximo Application Suiteセットアッププログラムにログインします。
    https://admin.<mas_domain>/initialsetup
    重要: スーパーユーザー・アカウントは、サーバー上の root アカウントと同じ方法で扱います。 これは、初期セットアップの場合にのみ使用してください。 セットアップの一環として、 Maximo Application Suite 管理インターフェースへのアクセス権限を持つデフォルトの管理者ユーザー・アカウントを作成します。 この管理アカウントを使用して、ユーザーの追加と管理、アプリケーションのデプロイなどを行います。
    スーパーユーザー資格情報の取得についての詳細は、 デフォルトのユーザー名とパスワードの見つけ方を参照のこと。
  2. MongoDBを構成します。
    MongoDB は、 Maximo Application Suite およびそのアプリケーションのデータ・ディクショナリーとして使用されます。 これはデフォルトのユーザー・レジストリーとしても使用されます。
    以下のMongoDB情報を指定します:
    ホスト名およびポート
    1 つ以上の MongoDB ホスト名とポートの組み合わせを構成できます。
    認証メカニズム
    Maximo Application SuiteMongoDBに接続する際に認証に使用するメカニズムを指定します。 MongoDB クラスター用に構成されたメカニズムに最も近い一致を選択します。 例えば、クラスターで SCRAM-SHA-256 メカニズムを使用する場合は、 デフォルト (SCRAM)を選択します。

    LDAPを使って認証するには、認証メカニズムとしてPLAINを指定する。

    認証データベース

    認証データベースの名前を指定します。 LDAPで認証する場合は、$externalでなければなりません。

    MongoDB のログイン資格情報
    少なくとも、 MongoDB 管理者には表作成特権が必要です。
    注: MongoDB の検証には、最大で 1 分かかる場合があります。 MongoDB の検証が完了した後は、構成を変更できません。 MongoDB は、 Maximo Application Suiteの前提条件です。 構成を変更するには、サービスが停止しないように、慎重に調整し、可能なデータ・マイグレーションを行う必要があります。 システム管理者は、 Red Hat® OpenShift® コンソールで構成を変更できます。 MongoDB 構成の変更について支援が必要な場合は、 IBM 担当員にお問い合わせください。

    詳細については、 MongoDB のインストール」を参照してください。

  3. CA 証明書をアップロードします。
    サービスがトランスポート層セキュリティー (TLS) 通信プロトコルを使用し、既知の認証局 (CA) によって発行された証明書で保護されていない場合は、サービスの証明書を発行した CA の証明書を提供します。 CA は中間 CA を使用する可能性があるため、複数の証明書を提供できます。

    指定した証明書ごとに、以下の詳細が表示されます。

    • 証明書発行者の名前。
    • 証明書の発行先の所有者の名前 (組織など)。
    • 証明書の有効期間の開始日と終了日。 指定した証明書の有効期限が間もなく切れる場合は、警告メッセージが表示されます。

    証明書を自動的に取得したり、手動で追加したりすることができます。

    重要: MongoDB クラスターが自己署名 CA 証明書を使用する場合は、証明書を取得または追加する必要があります。
    • 証明書の自動取得

      「証明書」セクションで、 検索をクリックします。 指定した接続資格情報が正しい場合は、サーバー上で構成されているすべての CA 証明書が自動的に取得され、表示されます。

      これらの証明書は検証されません。 正しい証明書のみが取得されていることを確認し、予期しない証明書は削除する。

      証明書を取得した後、手動で証明書を追加できる。

    • 証明書の手動追加
      「証明書」セクションで、 手動で追加 をクリックし、追加する証明書ごとに以下の値を指定します。
      別名
      3〜50文字の英数字の識別子。
      証明書の内容
      X.509 または PEM 形式のいずれかの証明書ファイルの内容。
    詳細については、 認証局証明書の設定を参照してください。
  4. SMTP(Simple Mail Transfer Protocol)サーバー接続を構成して、新規ユーザー歓迎メールやパスワードリセット通信などのシステムイベントに対する電子メール通知を有効にします。 詳細については、 電子メール通知の設定を参照してください。
  5. 分析データを構成します。
    注: IBM Maximo Application Suite 9.0、 8.11.7、および 8.10.10以降、ユーザー・データ・サービス (UDS) は非推奨になり、 IBM Data Reporter Operator (DRO) に置き換えられました。

    詳細については、 Data Reporter Operatorを参照のこと。

    • Maximo Application Suite 8.11、8.10、またはそれ以前のバージョンを使用している場合は、User Data ServicesData Reporter Operator に移行する必要があります。 詳細については、 ユーザーデータサービスからData Reporter Operatorへの Maximo Application Suite
    • Maximo Application Suite 9.0, 8.11.7、8.10.10、またはそれ以降のバージョンでは、IBM Data Reporter Operator を構成します。

      IBM データ・レポーター・オペレーターは、イベントを受け入れ、IBM メトリクス・オペレーターのデータ・サービスに提出されるレポートに変換します。

      1. Data Reporter Operator Maximo Application Suiteに設定するには、以下の情報を入力してください:
        • URL - URL は URLです。 これを見つけるには Red Hat OpenShift コンソールを開き、ibm-common-services projectに切り替えて、 Networking > Routesに進みます。 ドロップエンドポイントのルートで、[場所]列に表示されている URLをコピーします。

          例: https://dro-endpoint-ibm-common-services.<your-cluster-domain>

        • API Key- この API Key は DRO API Key クレデンシャルです。 これを見つけるには Red Hat OpenShift コンソールにアクセスし、 ibm-common-services projectに切り替え、 Workloads > Secrets > Searchでdro-api-keyという名前のシークレットを選択するDataセクションで、apikeyの値をコピーする。

          例: k2wnQY...

        • Email - DROとの連絡に使用する連絡先メールアドレスを入力します。 電子メールアドレスは、既存の Maximo Application Suiteユーザーと一致する必要はありません。
        • Given Name - DROとの連絡に使用される連絡先メールアドレスの所有者の名前を入力してください。
        • - ユーザーデータサービスの通信に使用される連絡先メールアドレスの所有者の姓を入力してください。
        • 証明書 - DROのSSL証明書チェーンを入力します。 証明書を取得するには、 Maximo Application Suite に DRO を設定する際に、[Retrieve] ボタン([Certificates] セクションの下)をクリックします。 Maximo Application Suiteで設定する DRO 証明書は、DRO インストールをホストするクラウドサービスプロバイダーのクラスターによって異なります。
      2. 追加をクリックして、証明書チェーンの中間を追加します。
      3. エイリアスを入力してください:drocertpart1.
      4. 証明書の内容を入力... US, Let's Encrypt,R3 に発行されたLet's EncryptR3中間証明書を含める。 詳細については、 証明書の内容を参照のこと。 例:
        
        -----BEGIN CERTIFICATE-----
        MIIF5jCCBM6gAwIBAgISA0Y...
        -----END CERTIFICATE-----
        
      5. 「確認」をクリックします。 この証明書の最初の部分には有効期限を記載し、以下の例のようにする:
        
        Issued to: US, Let's Encrypt, R3 
        Issued by: US, Internet Security Research Group, ISRG Root X1 
        Valid from: Thu Aug 01 2024
        Valid to: Mon Sep 15 2025
        
        This is the intermediate certificate which is required for the SSL connection to DRO endpoint.
        
      6. 追加をクリックして、証明書チェーンのルートを追加します。
      7. エイリアスを入力してください:drocertpart2.
      8. 証明書の内容を入力する。 ISRG RootX1の自己署名証明書を含める。 詳細については、 証明書の内容を参照のこと。 例:
        
        -----BEGIN CERTIFICATE-----
        MIIFazCCA1OgAw...
        -----END CERTIFICATE-----
        
      9. 「確認」をクリックします。 この証明書の第2部には、有効な日付が記載され、以下の例のようになるはずである:
        
        Issued to: US, Internet Security Research Group, ISRG Root X1 
        Issued by: US, Internet Security Research Group, ISRG Root X1 
        Valid from: Thu Jun 04 2015
        Valid to: Mon Jun 04 2035
        
        
        This is the root certificate which is required for the SSL connection to DRO endpoint.
        
      10. DROの設定を保存します。
      11. ここで、DROコンフィギュレーションが照合されるのを待ちます。このプロセスには最大10分かかる場合があります。 コンフィギュレーションが正常に完了するのは、コンフィギュレーション・ステータスがReady.例
        構成準備完了 - DRO の構成が正常に検証されました
  6. Suite License Serviceを設定します。

    Suite License Service (SLS) は、 Maximo Application Suite ライセンスを保管および管理します。

    Maximo Application Suite インスタンスは、固有の SLS インスタンスに接続できます。 複数の Maximo Application Suite インスタンスで、SLS と対応するライセンス・ファイルを共有することもできます。

    以下の SLS 情報を入力して、 Maximo Application Suiteを構成します。

    • URL - SLSサーバー URL。
    • 登録キー - SLS登録キーを入力します。
    ご使用の環境によっては、SLS 構成が完了するまでに 10 分以上かかる場合があります。
  7. オプション: ライセンス・キー・ファイルをアップロードします。
    Maximo Application Suite で使用するために構成した IBM Suite License Service に有効なライセンス・ファイルが含まれている場合は、ライセンス・ファイルをアップロードする必要はありません。 次の構成ステップに進むことができます。

    アクティベーション Maximo Application SuiteIBM ライセンスキーセンターからライセンスキーを提供する必要があります。 License Key Center のウェルカム・レターでログイン情報が提供されます。 ライセンスの詳細については、 IBM サポート - ライセンスのページを参照してください。

    1. License Key Center にログインします。
    2. 会社名を選択します。
    3. IBM AppPoints 製品ラインを選択します。
    4. IBM Maximo Application Suite... ライセンス・キー名を選択します。
    5. ライセンス・キーを作成する製品または販売注文を選択します。
    6. 生成するキーの数を入力します。 これらは、ライセンス・キーに割り振られる AppPoints に対応します。
    7. Maximo Application Suite ライセンス・サーバー・パラメーターを指定します。
      セットアップ・プログラムの [Advanced settings ] > [ license key] セクションに表示されるパラメータを使用します。 Maximo Application Suite に表示されるパラメータを使用するか、次のパラメータを指定します:
      • 構成]には、[シングル ライセンス サーバ]を指定します。
      • ホスト ID タイプの場合は、イーサネット・アドレスを指定します。
      • 「ホスト ID」には、 Suite License Service (SLS) のインストール時に生成されたホスト ID を指定します。 この ID を表示するには、 Red Hat OpenShift クラスター に接続し、以下のコマンドを実行します。

        oc -n <sls_project_namespace> get licenseservice sls

        例えば、SLS プロジェクトの名前空間が mas-sls-dev5の場合、以下のコマンドを実行します。

        oc -n mas-sls-dev5 get licenseservice sls

        コマンド出力では、 LICENSEID 列にホスト ID が表示されます。

      • 「ホスト名」には、任意のホスト名を指定します (例: sls-mas )。
      • 「ポート」には、27000 を指定します。
    8. キーをダウンロードして、 Maximo Application Suite セットアップ・プログラムにアップロードします。
  8. ワークスペースを作成します。

    Maximo Application Suite ワークスペースは、 Maximo Application Suiteのインスタンスの構成設定の固有のコレクションです。 以下の情報を入力して、 Maximo Application Suite ワークスペースを作成します。

    • ワークスペース ID

      ワークスペースIDは Maximo Application Suite URL の一部を構成します。例えば:

      https://<workspace_id>.home.<mas_domain>

      注: ワークスペース ID は 3 文字から 12 文字の長さでなければならず、小文字と数字のみを使用できます。 先頭文字は英字でなければなりません。
    • ワークスペースの表示名

      表示名は、 Maximo Application Suite ユーザー・インターフェースに表示されます。

  9. セットアップ構成を確認します。

    これで、 Maximo Application Suite のセットアップが完了しました。 すべての構成設定が完了していることを確認し、「終了」をクリックしてセットアップを完了します。

次の作業

Maximo Application Suite のセットアップが完了したら、 Maximo Application Suite 管理または Maximo Application Suite ナビゲーター・ページに移動して、環境の使用を開始できます。
https://admin.<mas_domain>
https://<workspace_id>.home.<mas_domain>

これで、 Maximo Application Suite スーパーユーザーは、企業のニーズに合わせて環境の構成を続行できます。