Page Comparison

...

概要

インストーラーのプロパティは、Yellowfinインストーラーをカスタマイズするうえで重要です。インストーラーにさまざまな変更を加えるために、さまざまなプロパティが使用されます。たとえば以下のとおりです：インストーラーのプロパティは、Yellowfinのインストーラーをカスタマイズするうえで重要です。インストーラーに様々な変更を加えるために、様々なプロパティが使用されます。含まれる項目は、以下の通りです。

1. ユーザーオプションの初期値を指定するユーザーオプションの初期値の指定
2. インストーラーの操作性を変更するインストーラーのルックアンドフィールの変更
3. インストーラーの動作を変更するインストーラーの動作の変更
4. Yellowfinインストールの設定を変更するYellowfinインストールの構成の変更

インストーラーのプロパティの値は、さまざまな方法で指定できます。インストーラーのプロパティの値は、様々な方法で指定することができます。

セクション

インストーラーのプロパティは、次のページにグループ分けして説明しています：インストーラーのプロパティを、以下のページにグループ分けしました。

1. ユーザーオプション、
2. インストーラーのルックアンドフィール、
3. インストーラーの動作、
4. Yellowfinの設定、およびYellowfinの構成
5. 付録 - すべてのインストーラープロパティのリストすべてのインストーラープロパティの一覧

...

インストーラープロパティの値の指定

インストーラーのプロパティの値は、さまざまな方法で設定できます。優先順に以下のとおりです：インストーラーのプロパティの値は、様々な方法で設定することができます。優先順に、以下のようになります。

1. インストーラーによって適宜提供されるデフォルトのオプション必要に応じて、インストーラーにより提供されるデフォルトオプション
2. インストーラーにバンドルされているカスタムプロパティファイル
3. サイレントインストーラーのプロパティファイル（サイレントインストールの場合のみ）
4. インストーラーによって提供されるコマンドライン引数インストーラーに提供されるコマンドライン引数
5. ユーザーがインストール中に入力するオプション（グラフィカルインストールおよびコマンドラインインストールの場合）ユーザーがインストール中に入力するオプション（グラフィック、またはコマンドラインインストールの場合）

たとえば、コマンドラインで指定するプロパティ値は、カスタムプロパティファイル内の同じプロパティに設定された値よりも優先します。例えば、コマンドラインで指定されたプロパティ値は、カスタムプロパティファイル内の同様のプロパティに設定された値を上書きます。

サイレントインストーラーは、ユーザーインターフェースを表示しません。そのため、すべてのユーザーオプションは、プロパティファイルまたはコマンドライン引数を使用して指定する必要があります。サイレントインストーラーは、ユーザーインターフェースを表示しません。そのため、すべてのユーザーオプションは、プロパティファイル、またはコマンドライン引数を使用して指定しなくてはいけません。

カスタムプロパティファイル

インストーラーをカスタマイズするメインの方法がカスタムプロパティファイルです。このファイルにインストーラーの操作性や動作を変更するプロパティを追加できます。このファイルは、カスタムプロパティファイルは、インストーラーをカスタマイズする主要な方法です。このファイルに、インストーラーのルックアンドフィールや動作を変更するプロパティを追加することができます。こちらのファイルは、「custom.properties」という名前のJavaプロパティファイルであり、インストーラーアーカイブのルートに追加されます（インストーラーへのファイルの追加を参照）。を参照してください）。

このファイルは、インストールオプションの標準的なデフォルト値の指定、インストール時に表示されるテキストの上書き、インストーラーで使用するデフォルトイメージを上書きするために使用するイメージの場所の指定、インストーラーの動作の変更、Yellowfinインストールの初期設定値の指定などに使用します。カスタムプロパティファイル内のオプションは、同じプロパティの値がインストーラーのコマンドライン引数として指定される場合に上書きされます。また、グラフィカルまたはコマンドラインインストーラーを使用するときのインストールプロセス時にユーザーオプションを上書きできます。こちらのファイルは、インストールオプションの標準的なデフォルト値の指定、インストール時に表示されるテキストの上書き、インストーラーで使用するデフォルトイメージを上書きするために使用するイメージの場所の指定、インストーラーの動作の変更、Yellowfinインストールの初期設定値の指定などに使用されます。カスタムプロパティファイル内のオプションは、同様のプロパティの値がインストーラーのコマンドライン引数として指定される場合に上書きされ、グラフィック、またはコマンドラインインストーラーを使用する場合、インストールプロセス時にユーザーオプションを上書きすることができます。

カスタムプロパティファイルは、行ごとに「キー=値」という形式で表記される一連のキーと値のペアです。空行は無視され、#で始まる行はコメントとして扱われます。カスタムプロパティファイルは、行ごとに「キー = 値」という形式で表記される、一連のキーと値のペアです。空白の行は無視され、「#」で始まる行はコメントとして扱われます。

コマンドライン引数

インストーラープロパティは、インストーラーを実行するときのコマンドライン引数として指定できます。通常の使い方は次のとおりです：インストーラープロパティは、インストーラー実行時のコマンドライン引数として指定できます。一般的な使用方法は、以下の通りです。

java -jar yellowfin-yyyymmdd-full.jar [-cmd|-gui] [property ...]
java -jar yellowfin-yyyymmdd-full.jar -silent [silentpropertiesfile [property ...]]

プロパティは次のように指定します：プロパティは、以下のように指定されます。
key=valueまたは-key=value

例：

java -jar yellowfin-yyyymmdd-full.jar option.serverport=80 option.winservice=true

サイレントインストーラーのプロパティファイル

サイレントインストーラーを使用するときは、追加のプロパティファイルを指定できます。過去の経緯から、このファイル内のプロパティの名前は標準のインストーラープロパティと異なっていますが、機能は同じです。サイレントインストーラー使用時に、追加のプロパティファイルを指定することができます。慣例的に、このファイル内のプロパティは、標準インストーラーのプロパティとは異なる名前を持ちますが、同様の機能があります。

可能な場合は、サイレントインストーラープロパティファイルではなく、カスタムプロパティファイルを使用することをお勧めします。カスタムプロパティファイルを使用した場合と比べて、サイレントインストーラープロパティファイルを介して設定できるプロパティは、非常に限られています。可能であれば、サイレントインストーラーのプロパティファイルではなく、カスタムプロパティファイルを使用することをお勧めします。サイレントインストーラーのプロパティファイルを通して設定された使用可能なプロパティは、カスタムプロパティファイルと比較して、非常に限定されています。

サイレントインストーラーのプロパティファイルは、インストール先コンピューターのファイルシステム上に存在する必要があります。ファイル名は、サイレントインストーラーのプロパティファイルは、インストール先コンピューターのファイルシステム上に存在しなくてはいけません。また、ファイル名は、「-silentスイッチの後の最初の引数にする必要があります：silent」に切り替えた後に、最初の引数を付けなくてはいけません。

java -jar yellowfin-yyyymmdd-full.jar -silent install.properties

コマンドライン引数をサイレントインストーラーに渡すときは、たとえ空のファイルであっても、サイレントインストーラーのプロパティファイルを、他のオプションよりも前に最初の引数として含める必要があります。以下は動作しません：コマンドライン引数をサイレントインストーラーに渡す際は、たとえ空ファイルであったとしても、サイレントインストーラーのプロパティファイルを、すべての追加オプションの前に、最初の引数として含めなくてはいけません。そのため、以下は動作しません。

java -jar yellowfin-yyyymmdd-full.jar -silent option.serverport=8090

...

サイレントインストーラープロパティファイル内のプロパティキーは、大文字と小文字を区別しません。

...

InstallPath=/applications/yellowfin
InstallTutorialDatabase=true
ServicePort=8080
InstallService=false
DatabaseType=MySQL
CreateYellowfinDB=true
CreateYellowfinDBUser=talse
DatabaseHostname=localhost
DatabaseName=yellowfin
DatabaseDBAUser=root
DatabaseDBAPassword=secret
DatabaseUser=yf
DatabasePassword=

...