WindowsでEggplant DAIをインストールまたはアップグレードする

このセクションでは、Windows で Eggplant DAI をインストール、アップグレード、ライセンス認証するための手順を段階的に説明します。インストール プロセスを開始する前に、サポートされているオペレーティング システムと推奨されるインストール構成に関する情報について、前提条件 を必ずお読みください。

ノート

DAI 7.1のリリース以降、システム要件とサポートOSの情報は前提条件ページに移動しました。DAI インストール用のシステムのセットアップの詳細については、このページを参照してください。

Windows、Mac、Linux に EPF をインストールする手順は次のとおりです。

標準とアドバンスのインストール

Eggplant DAIのWindowsインストールは標準またはアドバンスのどちらかを選択できます。アドバンスインストールでは、いくつかの追加設定が可能です：

• デフォルトのポート設定を更新し、HTTPSを設定する
• PostgreSQLのデータが格納されるディレクトリを選択する
• Eggplant FunctionalのSuiteが保存されるディレクトリを選択する。

両方のインストールタイプに対して、インストールを開始するのステップに従い、適切なセクションにジャンプします。

Eggplant DAIのインストール

Eggplant DAIのWindowsインストールは次をサポートしています：

• 新規インストール
• 前のサポートバージョンからの段階的なアップグレード（サポート バージョンの完全なリストについては、リリースノートを参照してください）。
• ダウングレードはサポートしていません。

情報

アップグレードする場合は、インストールを開始する前に、必ずすべての DAI サーバーとサービスを停止し、ファイルとデータをバックアップしてください。ご質問がある場合、またはアップグレード前のデータベースのテストについてサポートが必要な場合は、テクニカル サクセス マネージャーまたは弊社の カスタマー サポート までお問い合わせください。

バックアップを取るには：

1. Windows Services managerを通じてDigital Automation Intelligence Serviceを停止します。
2. C:\ProgramData\Eggplant\Digital Automation Intelligence を開き、ProgramData ディレクトリの外にある data フォルダーと minio フォルダーを別のマシンまたはバックアップ デバイスにコピーします。
3. Digital Automation Intelligence サービスを起動します。

アップグレードで問題が発生し、以前に動作していた DAI バージョンを復元する必要がある場合は、次の手順に従います。

1. トラブルシューティングに役立つ可能性があるDAIファイルとデータのバックアップを作成するため、上記の手順1と2を繰り返します。
2. Windows の [コントロール パネル] の [プログラムと機能] オプションを使用して DAI をアンインストールします。
3. フォルダ C:\ProgramData\Eggplantを削除します。
4. フォルダ C:\Program Files\Digital Automation Intelligenceが存在するかどうかを確認し、存在する場合は削除します。この時点で、DAIはマシンから完全に削除されています。
5. 以前に動作していたバージョンの DAI をインストールします。 DAI の再インストールが完了したら、ブラウザを起動して DAI Web UI にログインし、インストールを確認します。
6. Windows サービスから DAI サービスを停止します。
7. フォルダ C:\ProgramData\Eggplant\Digital Automation Intelligenceに移動し、dataフォルダと minioフォルダを削除します。
8. DAIバックアップの場所から「data」フォルダとminioフォルダをC:\ProgramData\Eggplant\Digital Automation Intelligenceにコピーします。バックアップ ファイルは、手順 5 でインストールした DAI バージョンとまったく同じである必要があることに注意してください。
9. バックアップの場所からファイル 'config.yml' を開き、データベースのパスワード ('env' セクションの PG_PASSWORD の値) をコピーします。C:\ProgramData\EggplantDigital Automation Intelligenceのファイル「config.yml」を開き、「PG_PASSWORD」の値をバックアップしたパスワードに置き換えます。
10. DAI サービスを開始し、開始後に DAI Web UI にログインできることを確認します。

インストールを開始する

新規インストールまたは前のマイナーDAIリリースからのアップグレードにこれらの指示を使用します。

1. Eggplant DAI インストール ファイルをダウンロード。

2. インストールファイルを右クリックして、Run as Administratorオプションを使用してSetupウィザードを起動します。続行するにはNextをクリックします。

   ノート

   DAIのインストーラーは可能な限り管理者として実行することをお勧めします。これにより、DAIは正しい権限でインストールされます。

   まだ行っていない場合は、Eggplant DAIをアンインストールするように求められることがあります。

3. デフォルトのインストールディレクトリ C:\Program Files\Digital Automation Intelligence を保持するか、Browse.... をクリックして別の場所を選択します。

4. Advanced installer Options画面で、以下のどちらかを行います。

   • Nextをクリックして標準インストールを行います。
   • 高度なインストール設定を実行するを選択して高度なインストールを行います。

標準インストールの実行

前提条件: インストールを開始するのすべての手順を完了します。

1. Server & Administration Settings画面で、以下を入力します。

   • DAI Server Hostname: URLの主要なDAIサーバーのホスト名。ホスト名に http:// や https:// の接頭辞は含めないでください。

     • サーバーがローカルマシンである場合は、localhostと入力します。これは、Eggplant DAIは http://localhost:8000 からのみアクセスできることを意味します。
     • DAIサーバーに他のリモートマシンからアクセスする必要がある場合は、完全なドメイン名（例：www.serverhostname.com）を入力します。これにより、例えば http://<serverhostname>:8000 からブラウザでEggplant DAIにアクセスできます。
     ヒント

     サーバーのホスト名を調べるには、Settings > System > Aboutに移動します。

   • System管理者の詳細: Eggplantのアイデンティティアクセス管理システム(IAM)の管理者の資格情報。

     • username: < > \ / { } " % ! ^ と大文字を除いたASCII印刷可能な文字のみを入力します。
     • Password: " \ { } % ! ^ を除いたASCII文字を使用して、12から128文字の間で入力します。 :::info 重要
     情報

     システム管理者アカウントの資格情報は安全な場所に保管してください。特定の状況下では、Eggplantテクニカルサクセスマネージャーから探して使用するように依頼される場合があります。

   • DAI管理者の詳細: DAI管理者の資格情報と個人詳細。

     • username: < > \ / { } " % ! ^ と大文字を除いたASCII印刷可能な文字のみを入力します。
     • Password: " \ { } % ! ^ を除いたASCII文字を使用して、12から128文字の間で入力します。
     ノート

     はじめてEggplant DAIにログインするときや、他のユーザーを作成または更新するときには、DAI管理者の資格情報が必要です。ログインしたら、上記の除外された文字と他の言語や文字（例：ユニコード）を含めてパスワードを更新できます。管理者のユーザー名は更新できません。

     DAI でシングル サインオン (SSO) 認証を使用する場合は、初回ログインとライセンス で説明されているように、DAI バージョン 7.1 以降をインストールした「後」に構成します。および シングル サインオン (SSO) 認証と DAI の統合。

2. Select Start Menu Folder画面に進むには、Nextをクリックします。

3. Eggplant DAIへのショートカットの別の場所を選択するには、デフォルトの設定を受け入れるか、Browse… をクリックします。

4. Ready to Install画面に進むには、Nextをクリックします。インストールを開始するには、Installをクリックします。

5. インストールが完了したら、DAI Windows Service Start-up画面が表示され、ここでDAIサービスが初めて開始されます。このプロセスは最大10分かかる場合があり、必要に応じてマイグレーション活動が含まれる場合があります。

6. HTMLのDAI Windows Service Start-up Reportがデフォルトのインターネットブラウザで開かれ、正常に開始されたサービスがリストされます。すべてのDAI services are started successfullyというStart-up Reportに示されている場合、マイグレーションプロセスは正常に完了しています。起動中に発生するエラーは、トラブルシューティングの補助のためにここで詳細に説明されます。

7. セットアップが完了したら、Finishボタンをクリックします。

8. DAIサービスが正常に起動できない場合は、Windowsサービスマネージャを通じてDAIサービスを再起動するか、PCを再起動する必要があります。

9. First Log in and Licensingに進む。

高度なインストールの実行

Preconditions：

• Start Your Installationのすべてのステップを完了する。
• Eggplant DAIサーバーのHTTPSを設定するには、信頼できる証明書とキーが必要です。信頼できる証明書はMozillaのページに記載されている証明機関から発行されます：
  • PEM形式のTLS証明書: 有効な証明書のリストについては、Mozillaページを参照してください。
  • PEM形式のSSLキー: nginxが受け付けるすべてのキーフォーマット。

ノート

Windows環境では、証明書はブラウザまたはエージェントを実行しているマシンに信頼されたルート認証機関としてインストールされている別の証明機関によって署名できます。

自己署名SSL証明書を使用する場合は、インストール後に設定を更新する必要があります。次のように設定します：

• _発行者_を証明書を発行する組織、たとえば"yourcompanyname"に設定します。
• サブジェクト_は証明書が生成されたホスト名、たとえば"local.dai.com"に設定し、インストール中に入力したホスト名と一致する_必要があります。

ChromeとFirefoxで受け入れられるためには、エンドエンティティ証明書はSubject Alternative NameフィールドとAuthority Key Identifierフィールドを設定する必要があります。現在はsha512が十分に強力なハッシュ関数を使用しています。

1. PostgresSQL Data Directory画面では、次のいずれかを選択します：

   • デフォルトのパスを受け入れるには、Nextをクリックします。
   • 別のディレクトリを選択するには、Browseをクリックします。たとえば、DAIデータベースのカスタムロケーションを使用するには、C:\MyCompany\Dataに移動します。
   情報

   DAIはWindowsのlocal systemアカウントの下で動作します。このアカウントが選択したディレクトリに書き込む権限を持っていることを確認する必要があります。そうでなければ、インストールが失敗します。Make New Folderをクリックすると、別のデ イレクトリを選択したときに適切な権限が設定されることが確認できます。

2. Server Port & HTTPS画面に進むには、Nextをクリックします。

3. デフォルトのポート値8000を保持します。このポートが使用できない場合や、代替のポートを使用する必要がある場合は、インストール後にいつでも設定を更新できます。

   ノート

   ポート80は、HTTPまたはHTTPSの設定のいずれにも現在サポートされていません。

4. DAIサーバーを安全にするためにHTTPSを設定したくない場合は、Use HTTPSのチェックボックスをクリアし、Nextをクリックし、そのままステップ6に進みます。それ以外の場合は、Use HTTPSのチェックボックスを選択したまま、次のステップに進みます。

   • ポート8000が利用可能な場合は、デフォルト値をそのままにします。
   • ポート8000が利用できない場合は、使用するHTTPポートを入力します。

5. 証明書の詳細を追加します：

   • HTTPS証明書： HTTPS証明書をブラウズして選択します。
   • HTTPS Private Key： HTTPSキーファイルをブラウズして選択します。
   • オプション）プライベートキーにはパスワードが必要: プライベートキーを解除するためにパスワードが必要な場合は、このオプションを選択し、パスワードファイルをブラウズして選択します。

6. Next をクリックして Usage Statistics 画面に進みます。次のメトリクスを収集するために Eggplantに許可を与えるためにチェックボックスを選択したままにします：

   • 製品識別子
   • 製品バージョン
   • ホストOS
   • ホストOSバージョン
   • ライセンス（シリアル番号）情報。

7. Next をクリックして Suites Data Directory 画面に進みます。次のいずれかを選択します：

   • デフォルトのパスを受け入れるには、再度 Next をクリックします。
   • Eggplant FunctionalSuiteの別のディレクトリを選択するには、Browse をクリックします。これは、エージェントがSuiteをアップロードするディレクトリで、現在それらを保存している場所とは異なる可能性があります。
   情報

   DAIはWindowsのlocal systemアカウントの下で動作します。このアカウントが選択したディレクトリに書き込む権限を持っていることを確認する必要があります。そうでなければ、インストールが失敗します。Make New Folderをクリックすると、別のディレクトリを選択したときに適切な権限が設定されることが確認できます。

8. 標準インストールの全ての手順を完了します。

初回ログインとライセンス認証

Eggplant DAI がインストールされて実行されている場合、ブラウザからアプリケーションにアクセスする必要があります。次の手順に従って、ログインし、ライセンスを取得し、Eggplant DAI の使用を開始します。

1. ブラウザから適切なURLを入力してログイン画面を表示します：

   • インストール中にホスト名localhostを追加した場合は、Eggplant DAIサーバーが実行されているコンピューターからブラウザを起動し、http://localhost:8000を入力します。
   • インストール中に完全なホスト名を追加した場合、リモートマシンからEggplant DAIサーバーにアクセスすることができます。ブラウザを起動し、http://<serverhostname>:8000を入力します。

2. Eggplant DAIがログインを求めます。インストール中に設定したDAI管理者アカウントのユーザー名とパスワードを入力し、OKをクリックします。

3. ライセンスページで、Licenseキーを入力し、Agreeをクリックします。Eggplant Software License agreementのコピーは、Agreeをクリックする前に読んでダウンロードすることができます。ライセンスは、Keysight Software Manager (KSM)で生成できます。ライセンスが受け入れられた後、新規DAIユーザーが自分のパスワードを設定できるようにメールを設定するための**設定**ページが表示されます。このステップはスキップすることができますが、その場合は一時的なパスワードをユーザーに提供する必要があります。

4. ユーザーアカウントの更新を行うことができます。Eggplant DAIインターフェースの左メニューでAccessをクリックします。

ノート

DAI で Microsoft Active Directory (AD) によるシングル サインオン (SSO) 認証を使用する場合は、「シングル サインオン (SSO) 認証と DAI の統合」(dai-sso-integration.md) を参照してください。

1. 新しいブラウザタブで管理コンソールを開くには、Manage usersをクリックします。
2. ユーザーを編集するには、検索ボックスにユーザー名の最初の数文字を入力して一致するユーザーを見つけ、正しいレコードのIDをクリックします。
3. あなたのメールアドレスを入力し、Saveを選択します。
4. 管理環境について詳しく知りたい場合は、ユーザーの管理セクションに進んでください。または、初めてアプリケーションを使用する場合は、はじめにを参照してください。