サイレントインストール

サイレントインストールとは、ウィザードに従って対話的にインストールするのではなく、コマンドプロンプトでインストール時に必要な情報をオプションとして指定してインストールする機能です。 例えば、パッケージ製品でユーザに意識させずに PowerGres をインストールしたり、ネットワークを通じて大量のサーバにインストールしたりする場合に便利です。

サイレントインストールの機能を利用するには、以下のようにインストーラの実行ファイル powergres-13.x-setup.exe に /S オプションを指定して実行します。 /LICENSE_KEY オプションはライセンスキーを指定するオプションです。 その他にも多くのオプションが存在します。 指定できるオプションについては「オプション」を参照してください。

powergres-13.x-setup.exe /S /LICENSE_KEY=XXXX-XXXX-XXXX-XXXX

PowerGres のインストールは OS の管理者権限のあるユーザで行ってください。 また、Windows のユーザアカウント制御 (UAC) が有効な場合、インストールとアンインストールを行う最初の時点で管理者承認モードへの移行が求められますので、コマンドプロンプトを管理者として実行する必要があります。

インストーラの実行ファイル powergres-13.x-setup.exe は ZIP ファイルを展開したフォルダの setup フォルダに格納されています。

オプション

インストーラのオプションはサイレントモードでない場合にも指定できます。 サイレントモードでない場合には、インストーラのウィザードが起動され、オプションで指定した値が入力された状態になります。

オプションの大文字、小文字の違いは区別されます。 例えば、サイレントモードで起動する場合には、オプションは /s ではなく /S と指定する必要があります。

存在しないオプションを指定してもエラーにならずに無視されます。

オプションの値に空白が含まれていても「" (ダブルクォート)」で囲む必要はありません。 「"」で囲んでも /D オプションを除いて問題はありません。 /D オプションの値は「"」で囲まずに指定する必要があります。

サイレントモードはインストール時だけでなくアップデート時にも利用できます。 アップデート時にはインストール時のオプションがデフォルトになります。 アップデート時に変更できない値 (インストール先のフォルダ) に、アップデート前と異なる値を指定した場合には、エラーになります。

PowerGres のオプション

/S

インストーラをサイレントモードで起動します。

/D=インストール先のフォルダ

インストール先のフォルダを絶対パスで指定します。 /D オプションは、コマンドラインの最後に指定し、パスに空白が含まれている場合にもクォートせずに指定する必要があります。

powergres-13.x-setup.exe /S /LICENSE_KEY=XXXX-XXXX-XXXX-XXXX /D=C:\My Program Files\PowerGres13

デフォルトでは C:\Program Files\PowerGres 13 になります。

/LICENSE_KEY=ライセンスキー

ライセンスキーを指定します。 サイレントモードでのインストール時には必ず指定する必要があります。 評価版のライセンスキー Evaluation も指定できます。

/COMPONENTS=コンポーネント名[,コンポーネント名]

インストール対象のコンポーネントの名前をカンマ区切りで指定します。 指定できるコンポーネントは以下のとおりです。 コンポーネント名の大文字、小文字の違いは区別されません。

CLIENT	PowerGres クライアント (必須)
SERVER	PowerGres サーバ
DOCS	PowerGres ドキュメント
DEVEL	PowerGres 開発
POSTGIS	PostGIS
TEXTSEARCH_JA	textsearch_ja
PGADMIN4	pgAdmin 4
START_MENU	スタートメニューとデスクトップにショートカットを作成

デフォルトでは CLIENT、SERVER、DOCS、START_MENU になります。

/COMPONENTS オプションを指定した場合には、デフォルトのコンポーネントの指定が解除されます。 そのため、すべてのコンポーネントをインストールする場合には、CLIENT を除くすべてのコンポーネントを指定する必要があります。

アップデート時にインストール済みのコンポーネントの指定を解除してもアップデートされます。

終了コード

インストールが正常に完了したかどうかはインストーラの終了コードで判断できます。 終了コードは、インストールが正常に完了した場合には 0、ユーザによって中断された場合には 1、エラーによって中断された場合には 2 を返します。

インストーラの終了コードは、コマンドプロンプトの変数 ERRORLEVEL、または ERRORLEVEL コマンドで参照できます。 ただし、コマンドプロンプトやバッチファイルから直接インストーラを起動すると、別のプロセスとして起動されて終了コードが設定されません。

C:\> ECHO %ERRORLEVEL%
9009
C:\> powergres-13.x-setup.exe /S /LICENSE_KEY=XXXX-XXXX-XXXX-XXXX
C:\> ECHO %ERRORLEVEL%
9009 <- インストーラの終了コードが設定されていない

インストーラの終了コードを参照したい場合には、START コマンドでインストーラを起動してインストールが完了するまで待つ必要があります。

@ECHO OFF
START "" /WAIT /B powergres-13.x-setup.exe /S /LICENSE_KEY=XXXX-XXXX-XXXX-XXXX
IF ERRORLEVEL 1 (
  ECHO PowerGres のインストールに失敗しました。
  EXIT /B 1
)