このトピックは、WebSphere Application Server 用の Web サーバー・プラグインのサイレント・インストールを実行するための応答ファイルについて説明します。
オプションの応答ファイルを使用して、サイレントに製品をインストールします。
responsefile.txt ファイルは、インストール・オプションを 設定するディレクティブを持っています。ファイル内のコメントには、それぞれのディレクティブのストリング値の設定方法が説明されています。
サイレント・モードでプラグイン・インストール・ウィザードを実行するオプション・ファイルを使用します。これはサイレントなインストールと呼ばれます。 ウィザードはオプション・ファイルを読み取って応答を判断しますが、グラフィカル・ユーザー・インターフェースは表示しません。 以下のコマンドを使用して、サイレント・インストール用の myresponsefile.txt と呼ばれる オプション・ファイルのコピーを使用します。
install -options "myresponsefile.txt" -silent
サンプルのオプション応答ファイルは、responsefile.txt と呼ばれます。 このファイルは、製品ディスク上またはダウンロードされたインストール・イメージ内の plugin ディレクトリー にあります。
オプション・ファイルは、サイレントにインストールするとき、プラグイン・インストール・ウィザードへの値を提供します。 ウィザードはオプション・ファイルを読み取って応答を判断しますが、グラフィカル・ユーザー・インターフェースは表示しません。 以下のコマンドを使用して、サイレント・インストール用の myresponsefile.txt と呼ばれる オプション・ファイルのコピーを使用します。
install -options "myresponsefile.txt" -silent
Web サーバーに対するアプリケーションの微細な割り当ては、バージョン 6 の新機能です。
オプションの応答ファイルの例 responsefile.txt は、バイナリー・プラグイン のインストール、Web サーバーの構成を制御し、リモート・アプリケーション・サーバー・マシン上で、 Web サーバー定義を作成するために、スクリプトを作成します。 このスクリプトは、responsefile.txt ファイル内で提供された値に従ってカスタマイズされます。 スクリプトが生成されてアプリケーション・サーバー・マシン上で実行され、Web サーバー定義を作成します。
Web サーバーが、スタンドアロン・アプリケーション・サーバーと同じマシン上にある場合は、 responsefile.txt ファイルがスクリプトを作成することなく直接 Web サーバー定義を 作成できます。
インストール・ログが存在しない場合、一時ディレクトリー内の 一時ログ・ファイル temporaryPluginInstallLog.txt を参照してください。 また、以下のセクションで説明するように、インストールの発生を妨げる問題についての状況を、ISMP に記録させることができます。
例えば、-W silentInstallLicenseAcceptance.value="true" ディレクティブ内のライセンスを受け入れないでサイレント・インストールを開始すると、インストールは起こりません。 ライセンス・エントリーが受け入れられなかったという事実が、 ユーザーの一時ディレクトリー内の temporaryPluginInstallLog.txt に 記録されます。
例えば、Linux システム上の root ユーザーは、 通常は /tmp/temporaryPluginInstallLog.txt ディレクトリー内でファイルを検索します。
いずれかの応答ファイル検証が失敗という結果になると、 失敗は temporaryPluginInstallLog.txt ファイル内にリストされ、 インストールは失敗します。
install -options fully_qualified_options_response_file_name -silent -log # !fully_qualified_log_file_name @ALL
install -options "/usr/IBM/WebSphere/silentFiles/myresponsefile.txt" -silent -log # !/usr/IBM/WebSphere/myOptionFiles/log.txt @ALL
install -options "/opt/IBM/WebSphere/silentFiles/myresponsefile.txt" -silent -log # !/opt/IBM/WebSphere/myOptionFiles/log.txt @ALL
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 ファイル内に失敗が記録されます。
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=""