バージョン: DAI 7.4

Windows での DAI サイレントインストール、アップグレード、またはアンインストール

このページでは、Microsoft Windows で Eggplant DAI のインストール、アップグレード、またはアンインストールをサイレントに実行する方法について、手順を追って説明します。ここで「サイレント」という用語を使用するのは、グラフィカルユーザーインターフェイス (GUI) を介したユーザー入力なしでコマンドラインからこれらのタスクを実行するプロセスを説明するためです。サイレントメソッドは、DAI のインストールを自動化する場合、またはマシンにコマンドラインアクセスのみがある場合に便利です。

注記

サイレントインストール、アップグレード、およびアンインストールプロセスに対する DAI サポートは、DAI バージョン 7.4 以降で利用できます。

サイレントインストールの仕組み

DAI サイレントインストールでは、通常のセットアッププログラムと同じインストーラーを使用しますが、セットアッププログラムパネルで構成情報を入力するように求められる代わりに、インストーラーの実行時に読み取る ini ファイルで構成設定の値を事前に指定します。この点に留意してください。

必ず以下をお読みください: Prerequisites、Install or Upgrade、Post-Installation Configuration、最初のログインとライセンスも通常のインストールと同じです。
アップグレードする場合は、必ずback up your filesしてください。

通常のインストールとは異なり、Standard InstallとAdvanced Installの違いはそれほどありません。一部の設定に値を入力せずに、標準インストールをサイレントに複製する方法を説明します。

注記

サイレントおよび通常のインストールとアップグレードは同等であるため、サイレントでインストールしてグラフィカルにアップグレードすることも、その逆も可能です。アンインストールについても同様です。

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

Eggplant DAI Windows インストーラーは以下をサポートします:

新規インストール
以前のサポートバージョンからの増分 upgrades (サポートされるバージョンの完全なリストについては、Release Notes を参照してください)。

注記

ダウングレードはサポートされていません。

ステップバイステップ: サイレントインストールを実行する

新規インストールまたは既存の DAI インストールのアップグレードには、これらの手順を使用します。

Download the Eggplant DAI Server installer。
アップグレードの場合は、インストールする前に DAI Windows サービスを停止する必要があります。
DAI データフォルダ C:\ProgramData\Eggplant\Digital Automation Intelligence\silent.ini に silent.ini ファイルを作成します。

注記
新規インストールの場合は、C:\ProgramData\Eggplant\Digital Automation Intelligence ディレクトリを作成する必要があります。DAI は Windows の local system アカウントで実行されるため、このアカウントに Digital Automation Intelligence ディレクトリへの書き込み権限があることを確認する必要があります。
silent.ini ファイルに構成設定を入力します。以下の Silent Install Configuration Settings を参照してください。
管理者権限でコマンドシェルを起動します。たとえば、Windows の Start メニューをクリックし、Search ボックスに CMD と入力し、Command Prompt を右クリックして、コンテキストメニューから Run as Administrator を選択します。

注記
DAI が正しい権限でインストールされるように、管理者権限 (上記の手順で説明したように Run as Administrator) でインストールを実行することをお勧めします。
次のコマンドを使用してコマンドプロンプトからインストーラーを実行するか、自動インストールの場合はバッチファイルでコマンドを使用します。
```
<file path to >eggplantDAI-<version>.exe /VERYSILENT /SUPPRESSMSGBOXES /NORESTART /LOG="C:\ProgramData\Eggplant\Digital Automation Intelligence\install.log"
```
ここで、<file path to> は DAI Server インストーラ実行ファイルへのファイルパス、eggplantDAI-<version>.exe はダウンロードして実行しているインストーラのバージョンです。/VERYSILENT フラグはサイレントタイプのインストールであることを指定します。/SUPPRESSMSGBOXES はメッセージボックスが表示されないことを指定します。/NORESTART はインストーラがホスト Windows マシンを自動的に再起動しないことを指定します。インストール後に Windows ホストマシンを再起動する必要があることに注意してください。/NORESTART フラグを使用すると、再起動を制御できます。

注記
インストーラーの実行にはかなりの時間がかかることがありますが、コマンドシェルにステータスは報告されません。ただし、インストーラーの進行状況の詳細を出力する install.log ファイルを確認することで、インストールの進行状況を監視できます。インストーラーは、発生した問題もログファイルに報告します。たとえば、構成ファイルに無効な値が含まれている場合、インストーラーはログファイルに問題を報告します。プロセスの終わり近く、DAI サービスが起動し、アップグレード移行が実行されている間、最大 10 分間、ログファイルに制限されたアクティビティが表示されます。
インストールが完了すると、インストールログに「スタートアップレポートがC:\ProgramData\Eggplant\Digital Automation Intelligence\logs\startup_service.htmlに書き込まれました」というメッセージが表示されます。このDAI Windows Service Start-up Reportには、正常に開始されたサービスがリストされます。スタートアップレポートにDAI services are started successfullyと表示されたら、インストールが成功したことがわかります。起動中に発生したエラーもここに詳細に記録され、
インストールプロセスを完了するには、マシンを再起動します。インストーラーコマンドで /NORESTART 設定を使用して、Windows を自動的に再起動しないように指定しているため、これが必要になります。

サイレントインストールの構成設定

.ini ファイルの構造

サイレントインストールおよびアップグレードを行うには、silent.ini ファイルを作成する必要があります。以下に、silent.ini ファイルに関する情報と、システムに合わせてコピーして変更できるサンプルを示します。

注記

アンインストールには silent.ini ファイルは必要ありません。

有効な silent.ini ファイルを作成するには、次のルールが適用されます。

ファイルには [settings] という名前のセクションが 1 つ必要です。
必要な設定は、以下の [Fresh Install]](#fresh) および Upgrade セクションで定義されています。アップグレードの場合は、必要な設定が少なくなります。
すべての設定の行をファイルに指定する必要があります (機密値を除く。以下の Secrets を参照)。
一部の設定はオプションです。たとえば、https_cert_path= の設定では、この設定に値は提供されません。
ブール型の Yes/No 設定は、0 または 1 として表されます。たとえば、use_https=0 の設定では、HTTPS ではなく HTTP が使用されます。
サイレントインストールでは、通常のインストールと同じ検証ルールが使用されます。有効なルールと無効なルールの詳細については、Windows Install Guide をお読みください。

秘密

Eggplant DAI のインストールプロセスでは、ユーザー名とパスワードを指定する必要があります。有効な管理者名に関する情報は、Run a Standard Install に記載されています。

silent.ini ファイルでユーザー名とパスワードを指定できますが (詳細は下記を参照)、セキュリティ上の理由からこれはお勧めしません。代わりに、これらの設定を除外し、同等の環境変数を介して設定することをお勧めします。

同等の環境変数は同じ名前を持ちますが、すべて大文字です。たとえば、dai_admin_username は DAI_ADMIN_USERNAME 環境変数を使用して設定されます。これは以下に適用されます。

DAI_ADMIN_USERNAME: DAI管理者のユーザー名
DAI_ADMIN_PASSWORD: DAI管理者パスワード
KEYCLOAK_ADMIN_USERNAME: (Keycloak) システム管理者のユーザー名
KEYCLOAK_ADMIN_PASSWORD: (Keycloak) システム管理者のパスワード

注記

これらの環境変数を設定するときは、機密データがコマンドシェルの履歴に漏洩しないように注意してください。理想的には、組織のシークレットマネージャーでこれらの設定を指定し、環境変数を設定できるようにする必要があります。

新規インストール

Eggplant DAI の新規インストールを実行するには、以下に示すような silent.ini が必要です。以下の例は標準インストール用であり、高度なインストールでは、この例で空になっている設定の一部またはすべてを入力する必要があります。

[設定]
pgsql_data_directory=C:\ProgramData\Eggplant\Digital Automation Intelligence\data
server_port=8000
use_https=0
https_cert_path=
https_key_path=
https_server_name=
https_key_requires_password=0
https_key_password_file_path=
report_usage=0
minio_data_directory=C:\ProgramData\Eggplant\Digital Automation Intelligence\minio
server_name=localhost
keycloak_firstname=dai
keycloak_lastname=dai
keycloak_email=dai@keysight.com
# some or all of the following 4 settings can be removed from this file and replaced with equivalent environment variables
dai_admin_username=admin
dai_admin_password=AdminPassword
keycloak_admin_username=sys_admin
keycloak_admin_password=SysAdminPassword

各フィールドは、グラフィカルインストールプロセスの同等のフォームフィールドにマップされます。

設定	グラフィカルインストーラーでの同等の設定	インストールタイプ
pgsql_データディレクトリ	PostgresQL データディレクトリ	高度な設定
server_port	サーバーポート	高度な設定
use_https	HTTPS (チェックボックス)	高度な設定
https_cert_path	HTTPS 証明書	高度な設定
https_key_path	HTTPS 秘密鍵	高度な設定
https_server_name	Not used	高度な設定
https_key_requires_password	秘密鍵にはパスワードが必要です（チェックボックス	高度な設定
https_key_password_file_path	秘密鍵パスワードファイル	高度な設定
report_usage	使用状況統計（チェックボックス）	高度な設定
minio_data_directory	スイートデータディレクトリ	高度な設定
server_name	DAI サーバーホスト名	DAI 管理者名
keycloak_lastname	DAI管理者ユーザー名	標準
キークロークメール	DAI 管理者のメールアドレス	標準
dai_admin_username	DAI管理者ユーザー名	標準
dai_admin_password	DAI管理者パスワード	標準
keycloak_admin_username	システム管理者のユーザー名	標準
keycloak_admin_password	システム管理者のユーザー名	標準

アップグレード

Eggplant DAI の既存のインストールをアップグレードするには、以下に示すような silent.ini ファイルが必要になります。

[設定]
# 次の 4 つの設定の一部またはすべてをこのファイルから削除し、同等の環境変数に置き換えることができます
dai_admin_username=admin
dai_admin_password=AdminPassword
keycloak_admin_username=sys_admin
keycloak_admin_password=SysAdminPassword

Eggplant DAI をサイレントアンインストールする

アンインストーラーの機能の詳細については、通常の Uninstall ページを参照してください。

Eggplant DAI をインストールすると、インストーラーによって、インストールディレクトリ (例: C:\Program Files\Digital Automation Intelligence\unins000.exe) に unins???.exe (通常は unins000.exe) という名前のアンインストーラーファイルが作成されます。

再度、管理者権限でアンインストーラーを実行する必要があります。サイレントモードで管理者として実行するには、次の手順を実行する必要があります。

管理者権限でコマンドシェルを起動します。たとえば、Windows の Start メニューをクリックし、Search ボックスに CMD と入力し、Command Prompt を右クリックして、コンテキストメニューから Run as Administrator を選択します。
システムに作成されたアンインストーラーファイルの名前を使用して、次のようなコマンドでアンインストーラーを実行します。
```
<file path to>unins000.exe /VERYSILENT /SUPPRESSMSGBOXES /NORESTART /LOG="C:\ProgramData\Eggplant\Digital Automation Intelligence\install.log"
```
ここで、<file path to> は DAI サーバーのアンインストーラ実行可能ファイルへのファイルパスです。

サイレントインストールの仕組み​

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

ステップバイステップ: サイレントインストールを実行する​

サイレントインストールの構成設定​

.ini ファイルの構造​

秘密​

新規インストール​

アップグレード​

Eggplant DAI をサイレントアンインストールする​