WebSphere Application Server Network Deployment, Version 6.0.x   
             オペレーティング・システム: AIX , HP-UX, Linux, Solaris, Windows

             目次と検索結果のパーソナライズ化

responsefile.txt

このトピックは、WebSphere Application Server 用の Web サーバー・プラグインのサイレント・インストールを実行するための応答ファイルについて説明します。

オプションの応答ファイルを使用して、サイレントに製品をインストールします。

responsefile.txt ファイルは、インストール・オプションを 設定するディレクティブを持っています。ファイル内のコメントには、それぞれのディレクティブのストリング値の設定方法が説明されています。

サイレント・モードでプラグイン・インストール・ウィザードを実行するオプション・ファイルを使用します。これはサイレントなインストールと呼ばれます。 ウィザードはオプション・ファイルを読み取って応答を判断しますが、グラフィカル・ユーザー・インターフェースは表示しません。 以下のコマンドを使用して、サイレント・インストール用の myresponsefile.txt と呼ばれる オプション・ファイルのコピーを使用します。

install -options "myresponsefile.txt" -silent

応答ファイルのロケーション

サンプルのオプション応答ファイルは、responsefile.txt と呼ばれます。 このファイルは、製品ディスク上またはダウンロードされたインストール・イメージ内の plugin ディレクトリー にあります。

使用方式

プラグイン・インストール・ウィザードは、既存のオプション応答ファイルを読み取り、グラフィカル・ユーザー・インターフェースを表示することなくサイレントに実行することが可能です。

サイレント・インストール

オプション・ファイルは、サイレントにインストールするとき、プラグイン・インストール・ウィザードへの値を提供します。 ウィザードはオプション・ファイルを読み取って応答を判断しますが、グラフィカル・ユーザー・インターフェースは表示しません。 以下のコマンドを使用して、サイレント・インストール用の myresponsefile.txt と呼ばれる オプション・ファイルのコピーを使用します。

install -options "myresponsefile.txt" -silent

作動環境の作成

プラグインのインストールは、3 段階のプロセスです。
  1. サポートされている Web サーバーのバイナリー・プラグイン・モジュールのインストール
  2. バイナリー・モジュールを使用して、アプリケーション・サーバーと通信する Web サーバーの構成
  3. アプリケーション・サーバー内の Web サーバー定義の作成

    アプリケーションをインストールするとき、アプリケーション・サーバーに加えて、Web サーバー定義上にインストールすることができます。 Web サーバー定義上のすべてのアプリケーションは、プラグイン構成ファイル内にリストされます。 伝搬の後で、実際の Web サーバーはアプリケーションにアクセスすることができます。

Web サーバーに対するアプリケーションの微細な割り当ては、バージョン 6 の新機能です。

オプションの応答ファイルの例 responsefile.txt は、バイナリー・プラグイン のインストール、Web サーバーの構成を制御し、リモート・アプリケーション・サーバー・マシン上で、 Web サーバー定義を作成するために、スクリプトを作成します。 このスクリプトは、responsefile.txt ファイル内で提供された値に従ってカスタマイズされます。 スクリプトが生成されてアプリケーション・サーバー・マシン上で実行され、Web サーバー定義を作成します。

Web サーバーが、スタンドアロン・アプリケーション・サーバーと同じマシン上にある場合は、 responsefile.txt ファイルがスクリプトを作成することなく直接 Web サーバー定義を 作成できます。

プラグインをインストールし、Web サーバーおよびアプリケーション・サーバーを構成するために、応答ファイルを編集し使用するには、以下の手順を実行します。
  1. 製品ディスク上の plugins ディレクトリーから responsefile.txt ファイルを、 マシン上の容易に識別できる場所にコピーします。
  2. ファイルを編集して、インストールに応じた値にカスタマイズします。
  3. ファイルを保管します。
  4. インストールを開始します。 以下に例を示します。
    [AIX] [HP-UX] [Linux] [Solaris]
    install -options /tmp/plugins/myresponsefile.txt -silent
    
    [Windows] Windows ではないオペレーティング・システム上で、サイレント・インストールは同期処理として実行されます。 サイレント・インストールが完了するまで、プロセスは戻りません。 Windows 上で同時に実行されるサイレント・インストールの場合、以下のコマンドの最初の部分を実行します。
    • 同期処理: START /WAIT install.exe -options "C:¥temp¥myresponsefile.txt" -silent
    • 非同期処理: install -options "C:¥temp¥plugins¥myresponsefile.txt" -silent
  5. インストールを完了したら、成功を表すログを確認します。

ロギング

インストール・ログが存在しない場合、一時ディレクトリー内の 一時ログ・ファイル temporaryPluginInstallLog.txt を参照してください。 また、以下のセクションで説明するように、インストールの発生を妨げる問題についての状況を、ISMP に記録させることができます。

例えば、-W silentInstallLicenseAcceptance.value="true" ディレクティブ内のライセンスを受け入れないでサイレント・インストールを開始すると、インストールは起こりません。 ライセンス・エントリーが受け入れられなかったという事実が、 ユーザーの一時ディレクトリー内の temporaryPluginInstallLog.txt に 記録されます。

例えば、Linux システム上の root ユーザーは、 通常は /tmp/temporaryPluginInstallLog.txt ディレクトリー内でファイルを検索します。

いずれかの応答ファイル検証が失敗という結果になると、 失敗は temporaryPluginInstallLog.txt ファイル内にリストされ、 インストールは失敗します。

すべての検証にパスすると、インストールが起こります。 次に、プラグイン・インストール・ウィザードがインストール・イベントを以下のログ・ファイルに記録します。 ログ・ファイルは plugins_root/logs/install ディレクトリーにあります。
log.txt
インストール時に発生するすべての ISMP イベントを記録します。このログは、インストールがローカルであるか、 またはリモートであるかも示します。ファイルの最後にあるメッセージが、インストールを完了するために手動構成ステップが必要かどうかを示します。
インストール・レコード内を検索するキー・エレメントは以下のとおりです。
マニュアル・ステップ警告

ウィザードが Web サーバー定義を作成するためのスクリプトの実行を要求するとき、ウィザードはマニュアル・ステップが要求されたという事実を参照します。

マニュアル・ステップが要求されている場合、実行が必要なスクリプトの名前とロケーションが、インストール・レコードの最後にあるログ・ファイル内に書き込まれます。

Web サーバー・タイプ

ログは、例えば IBM HTTP Server 用の IHS のような、Web サーバー・タイプの記録を持っています。

プラグイン構成ファイルのロケーション

ログは、現在 Web サーバー構成内にある、plugin-cfg.xml ファイル・ ロケーションの記録を持っています。

installconfig.log
インストール中に発生したすべての構成イベントをリストします。
installGSKit.log
GSKit コードのインストール中に発生したイベントをリストします。

インストールが起こったとき、インストール用のコマンド行がリストされます。 GSKit 7 インストール・レコードは GSKIT 7 : エントリーがログに入った後で 書き込まれます。

[Solaris] GSKit 4 インストール・レコードは、 GSKIT 4: エントリーがログに入った後で書き込まれます。

installWeb_server_typePlugin.log
Web サーバー・プラグインのインストール時に発生するイベントを記録します。 このファイルの名前は、Web サーバーを反映して異なります。
  • installAPACHEPlugin.log
  • installIHSPlugin.log
  • installIISPlugin.log
  • installSunOnePlugin.log
  • installDomino5Plugin.log
  • installDomino6Plugin.log
  • installDomino7Plugin.log
それぞれのログは、以下の重大な情報をリストします。
  • 現在インストールされているプラグイン・バイナリー・モジュール
  • Web サーバー用に構成されたプラグイン構成ファイルの現在のロケーション
configure_Web_server_type_webserver.log
Web サーバー・プラグインの構成中に発生したイベントをリストします。 このファイルの名前は、Web サーバーを反映して異なります。
  • configure_APACHE_webserver.log
  • configure_IHS_webserver.log
  • configure_IIS_webserver.log
  • configure_SUNJAVASYSTEM_webserver.log
  • configure_DOMINO_webserver.log

configureWeb_server_type_webserver.log ファイルは、 Web サーバー構成ファイルが更新されるときに、プラグイン・インストール・ウィザードが実行するアクションを報告します。

リモートのシナリオでは、このログはありません。スクリプトを実行して、Web サーバー定義を手動で作成する必要があるからです。

統合されたシナリオでは、スクリプトは作成されて、このログはありません。

ISMP が、プラグイン・インストール・ウィザードを開始できないときにログに記録する情報

特定のイベントにより、インストーラーがインストール・ウィザードを開始できない場合があります。 例えば、このようなイベントとは、インストール・ウィザードの起動に十分なディスク・スペースがないことなどです。 インストールが失敗し、インストール・ログに情報がない場合は、-log パラメーターを 使用して、インストーラー・プログラムがインストール・ウィザードの開始に失敗する原因となるイベントのエントリーを記録します。 このようなイベントを記録するための install コマンドの構文は、以下のとおりです。
install  -options fully_qualified_options_response_file_name               
         -silent
         -log # !fully_qualified_log_file_name  @ALL 
  • [AIX]
    install -options "/usr/IBM/WebSphere/silentFiles/myresponsefile.txt" 
            -silent -log # !/usr/IBM/WebSphere/myOptionFiles/log.txt  @ALL
    
  • [Linux] [HP-UX] [Solaris]
    install -options "/opt/IBM/WebSphere/silentFiles/myresponsefile.txt" 
            -silent -log # !/opt/IBM/WebSphere/myOptionFiles/log.txt  @ALL
    
  • [Windows]
    install.exe -options "C:¥IBM¥WebSphere¥silentFiles¥myresponsefile.txt" 
                -silent -log # !C:¥IBM¥WebSphere¥silentFiles¥log.txt  @ALL

app_server_root/product/logs/log.txt ファイルまたは app_server_root/product/logs/wasprofile/pctLog.txt ファイルに 問題の記録がないにもかかわらず、問題が生じている場合は、インストールの検証またはトラブルシューティングを行います。

エラーがインストールの初期に発生している場合は、システム一時ディレクトリー内のログを探します。 インストール・プログラムは、システム一時ディレクトリーからインストールの最後にあるログ・ディレクトリーにログをコピーします。

詳しくは、インストールのトラブルシューティング およびインストール・コンポーネントのトラブルシューティングのヒント を参照してください。

応答ファイル・ユーザー・エントリー妥当性検査

サイレント・インストールでは、responsefile 妥当性検査はインストール内へコード化されています。 応答ファイル妥当性検査が通過しない場合は、temporaryPluginInstallLog.txt ファイル内に失敗が記録されます。

ソフトウェアのご使用条件に同意
デフォルトのディレクティブ設定
-W silentInstallLicenseAcceptance.value="false"
有効な設定
ライセンスを受け入れてプラグインをインストールするには、このディレクティブを true に設定しなければなりません。
temporaryPluginInstallLog.txt 内のエラー ID
INSTCONFFAILED : LICENSE _ NOT _ ACCEPTED.
有効インストール・タイプ
デフォルトのディレクティブ設定
-P pluginSettings.installType="local"
有効な設定
このディレクティブを remote または local に設定しなければなりません。 他のすべての値は、妥当性検査に失敗します。
temporaryPluginInstallLog.txt 内のエラー ID
INSTCONFFAILED : INVALID _ PLUGIN _ INSTALL _ TYPE _ SCENARIO _ SELECTED.
有効な WAS V6.0 インストール・ロケーション
デフォルトのディレクティブ設定
-W websphereLocationWizardBean.wasExistingLocation= "C: ¥ Program Files ¥ IBM ¥ WebSphere ¥ AppServer"

設定は、オペレーティング・システムにより異なります。

有効な設定
-P pluginSettings.installType="" ディレクティブ を local 上に設定した場合、 そのパスが有効な WebSphere Application Server バージョン 6 ディレクトリーで あるかどうかを、妥当性検査によって確認します。 他のすべてのパスは、ローカル・インストール・タイプに対する妥当性検査に失敗します。
temporaryPluginInstallLog.txt 内のエラー ID
INSTCONFFAILED : NON _ WAS6 _ DIRECTORY
有効な Web サーバーの構成ファイル 1
デフォルトのディレクティブ設定
-P pluginSettings.webServerConfigFile1= "C:¥ Program Files ¥ IBM HTTP Server ¥ conf ¥ httpd.conf"
設定は、オペレーティング・システムにより異なります。 それぞれの Web サーバーに対する有効なファイル名は以下のとおりです。
  • IBM HTTP Server: httpd.conf
  • Apache: httpd.conf
  • Domino 5: notes.jar
  • Domino 6: notes.jar
  • Sun Java System Web Server: obj.conf
有効な設定
妥当性検査はファイルが存在することを確認します。 ISMP 内の既知の問題は、ディレクトリー仕様を検証します。 ただし、ファイルを識別して作業構成を確立する必要があります。
temporaryPluginInstallLog.txt 内のエラー ID
INSTCONFFAILED : NON _ EXISTENT _ WS _ CONFIG _ FILE.
有効な Web サーバーの構成ファイル 2
デフォルトのディレクティブ設定
-P pluginSettings.webServerConfigFile2=""
該当する Web サーバーの有効なファイル名は以下のとおりです。
  • Domino 5: names.nsf
  • Domino 6: names.nsf
  • Sun Java System Web Server: magnus.conf
有効な設定
妥当性検査はファイルが存在することを確認します。 ISMP 内の既知の問題は、ディレクトリー仕様を検証します。 ただし、ファイルを識別して作業構成を確立する必要があります。
temporaryPluginInstallLog.txt 内のエラー ID
INSTCONFFAILED : NON _ EXISTENT _ WS _ CONFIG _ FILE2.
有効な Web サーバーの定義名
デフォルトのディレクティブ設定
-P pluginSettings.webServerDefinition="webserver1"
有効な設定
妥当性検査は、Web サーバー定義名の中にそのスペースが存在しないことを検証します。 スペースが存在すれば、妥当性検査は失敗します。
temporaryPluginInstallLog.txt 内のエラー ID
INSTCONFFAILED : INVALID _ WEB _ SERVER _ DEFINITION _ NAME.
アプリケーション・マッピングが true または false であることを検証します。
デフォルトのディレクティブ設定
-P pluginSettings.mapWebserverToApplications="true"
有効な設定
ディレクティブを true または false 以外の値に設定する場合、 temporaryPluginInstallLog.txt ファイル内にはエラーは生成、または記録されません。 プラグイン・インストール・ウィザードのデフォルト値は true で、 インストールを継続します。
temporaryPluginInstallLog.txt 内のエラー ID
なし。
有効 Web サーバー
デフォルトのディレクティブ設定
-P pluginSettings.webServerSelected="ihs"
有効な設定
ご使用のオペレーティング・システムに対して正しい Web サーバーを指定する必要があります。 有効な値には、次のものが含まれます。
  • [AIX] none, ihs, apache, domino6, sunone
  • [Linux] none, ihs, apache, domino6, sunone
  • [HP-UX] none, ihs, apache, domino5, sunone
  • [Solaris] none, ihs, apache, domino6, sunone
  • [Windows] none, ihs, apache, domino6, iis5, iis6, sunone
temporaryPluginInstallLog.txt 内のエラー ID
INSTCONFFAILED : INVALID _ WEBSERVER _ SELECTED.

使用上の注意

responsefile.txt ファイルの例

WebSphere Application Server 製品に同梱されているファイルのバージョンを編集します。以下の例は、製品に同梱されているファイルの正確な表現であることが保証されていません。

################################################################################
# 
# A common use of an options file is to run the wizard in silent mode. This lets
# the options file author specify wizard settings without having to run the
# wizard in graphical or console mode. To use this options file for silent mode
# execution, use the following command line arguments when running the wizard:
# 
#   install -options "responsefile.txt" -silent
#
################################################################################ 
# Note: Synchronous Silent Installs
# ---------------------------------
# On non-Windows operating systems, silent installs will execute in a synchronous process. 
# The process will not return until the silent install has completed.
#
# For the silent install to run synchronously on Windows, you must run the
# executable in the following way:
#
#    START /WAIT  install.exe -options "response_local.txt" -silent
#
#
################################################################################

################################################################################
#
# TROUBLE SHOOTING TIP
#
# If no signs of an install are visible, reference the temporary log file 
#   (temporaryPluginInstallLog.txt)
# in the user's temporary directory for signs of cause.
# 

################################################################################ 
# Note: Default Web server Plugins install locations
# ---------------------------------------- 
#
#  Below are the default install locations for each supported operating system.
# 
#  AIX:  "/usr/IBM/WebSphere/Plugins"
#
#  HP-UX, Linux, and Solaris: "/opt/IBM/WebSphere/Plugins"
#
#  Windows: "C:¥Program Files¥IBM¥WebSphere¥Plugins"
#
#  Note: On unix operating systems, spaces in the install location is not supported.
################################################################################ 

###################################################################################
#
# License Acceptance
#
# Valid Options	: true   Accepts the license. Will install the product.
#		  false  Declines the license. Install will not occur.
#
# If no install occurs, this will be logged to a temporary log file 
#   (temporaryPluginInstallLog.txt)
# in the user's temporary directory.
#
# By changing the silentInstallLicenseAcceptance.value in this response file to "true", 
# you agree that you have reviewed and agree to the terms of the IBM International
# Program License Agreement accompanying this program, which is located at 
# CD_ROOT¥plugins¥lafiles.  If you do not agree to these terms, do not change 
# the value or otherwise download, install, copy, access, or use the program and promptly 
# return the program and proof of entitlement to the party from whom you acquired it 
# to obtain a refund of the amount you paid.
#
# 

-W silentInstallLicenseAcceptance.value="false"

################################################################################
#
# install Type
#
# Valid Options : local		WebSphere Application Server and Web server on same machine
#		  	remote	WebSphere Applicaiton Server and Web server on seperate machines.
#

-P pluginSettings.installType="local"

################################################################################
#
# pluginDestination
#
# Web server Plugins for IBM WebSphere Application Server V6 install location
#

-P pluginProductBean.installLocation="C:¥Program Files¥IBM¥WebSphere¥Plugins"

################################################################################
#
# WAS V6 Existing Location
#
# Valid Options : Existing WebSphere Application Server Version 6.0 install home directory.
#
# Note 	: This option is valid for local install type.
#   	  	The install will use the directory entered below.
#

-W websphereLocationWizardBean.wasExistingLocation="C:¥Program Files¥IBM¥WebSphere¥AppServer"

################################################################################
#
# Web server to configure
#
# Valid options	
#		: none  	Install binaries only.  No Web server configuration.
#		: ihs		IBM HTTP Server V6
#		: apache	Apache Web Server V2
#		: domino5 	Lotus Domino Web Server V5 (supported on HP-UX)
#		: domino6	Lotus Domino Web Server V6 or V6.5 (not supported on HP-UX)
#		: sunone	Sun ONE Web Server 6.0 or Sun Java System Web Server V6.1	
#		: iis5	Microsoft Internet Information Services V5 (supported on Windows)
#		: iis6	Microsoft Internet Information Services V6 (supported on Windows)
#
# Note 	: Specify only one Web server to configure.
#

-P pluginSettings.webServerSelected="ihs"

################################################################################
#
# Web server Configuration File 1
#
# Valid options for Web server configuration file 1 
#
#		ihs 		: httpd.conf 
#		apache 	: httpd.conf
#		domino5 	: Notes.jar
#		domino6 	: Notes.jar
#		sunone  	: obj.conf
#
# Note	: File must exist
#

-P pluginSettings.webServerConfigFile1="C:¥Program Files¥IBM HTTP Server¥conf¥httpd.conf"

################################################################################
#
# Web server Configuration File 2
#
# Valid options for Web server configuration file 2
#
#		domino5 : names.nsf
#		domino6 : names.nsf
#		sunone  : magnus.conf
#              
# Note	: File must exist
#

-P pluginSettings.webServerConfigFile2=""

################################################################################
#
# Web server port number
#
# Specify the Web server port for the Web server selected to be configured.
#

-P pluginSettings.portNumber="80"


################################################################################
#
# Domino 6 User ID
#
# Specify the Domino 6 User ID.(only specify value when configuring Domino 6 on
# Linux, Solaris, and AIX platforms)
#
# Note : Domino 6 is supported on Windows, but this value is not required on Windows.
#

-W domino6UserIDPanel.userID="notes"

################################################################################
#
# Web server Definition Name
#
# A web server definition allows for Web server administration through the WebSphere 
# admin console.  
#
#  Note : No spaces are allowed in the Web server definition name.
#

-P pluginSettings.webServerDefinition="webserver1"


################################################################################
#
# plugin-cfg.xml File Location  
#
# This file will be generated by the plugin installer.  
#
# Valid options:  
#       ""                  : leaving the string empty will result in installer generating 
#                             the plugin-cfg.xmlfile location at install time and configuring 
#                             Web server to use this location. This is the recommended option.
#
#	"<file_location>" : User may enter an existing file location.  Web server will be 
#			    configured to use this existing plugin-cfg.xml file location.
#                         If file is specified, it must exist, or the install will not proceed.
#

-P pluginSettings.pluginCfgXmlLocation=""


################################################################################
#
# WebSphere Application Server Machine HostName
#
# remote install type 	: enter the hostname of the WebSphere Application Server machine.
# local install type 	: hostname of machine being installed to will be used.
#

-P pluginSettings.wasMachineHostName=""

################################################################################
#
#  Advanced User Options available in silent installs only
#  

#  Map all the existing deployed applications to the Web server.
#
#  Valid Options 
#			true 	:  Web server Definition is mapped as a target to 
#                 the existing deployed applications such as snoop and hitcount (Recommended)
#			false	:  No applications are mapped to the Web server definition.
#
#  Note : If not set to a valid option of true or false, the installer will set to 
#         true and continue install.
# 

-P pluginSettings.mapWebserverToApplications="true"

#  Web server Hostname
#
#  In advanced scenarios where a user has multiple Web server hostnames on a machine, 
#  set the entry
#  below to the Web server hostname used to configure.
#
#  Valid Options :
#		  	""  		:  Install will resolve to hostname detected on machine (Recommended)		  
#			"<HOSTNAME>"	:  Where <HOSTNAME> is a Web server hostname on the machine.
#

-P pluginSettings.webServerHostName=""

参照トピック    

ご利用条件 | フィードバック

最終更新: Jan 21, 2008 10:13:28 PM EST
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/index.jsp?topic=/com.ibm.websphere.nd.doc/info/ae/ae/rins_plugins_responsefile.html