WebSphere Application Server - Express, Version 6.1   
             オペレーティング・システム: AIX , HP-UX, Linux, Solaris, Windows, Windows Vista

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

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 サーバーはアプリケーションにアクセスすることができます。

オプションの応答ファイルの例 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. インストールを完了したら、成功を表すログを確認します。

ロギング

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

例えば、 -OPT silentInstallLicenseAcceptance="false" ディレクティブ内のライセンスを受け入れないで サイレント・インストールを開始すると、インストールは起こりません。ライセンス・エントリーが受け入れられなかったという事実が、 <userhome>/plglogs ディレクトリー内の log.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

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

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

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

使用上の注意

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 log file (waslogs/log.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.
################################################################################ 

###################################################################################
#
# Allow non-root/non-admin install
#
# Valid Options	: true   Allows install for non-root/non-admin users.
#		  false  Disallows install for non-root/non-admin users. Install will not occur.
#
# If no install occurs, this will be logged to a log file (waslogs/log.txt) 
# in the user's temporary directory.
#
# By changing this value in this response file to "true", you will allow the 
# install to continue
# for non-root/non-admin users. 
# 
#

-OPT allowNonRootSilentInstall="false"


###################################################################################
#
# 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 this 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.
#
# 

-OPT silentInstallLicenseAcceptance="false"

################################################################################
# Operating System Prerequisite Checking
#
# If you want to disable operating system prerequisite checking, uncomment
# the following line. This will notify the installer that you are disabling
# operating system prerequisite checking.
#
-OPT disableOSPrereqChecking="true"

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

-OPT installType="local"


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

-OPT installLocation="C:¥Program Files¥IBM¥WebSphere¥Plugins"


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

-OPT 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 or V6.1
#		: 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.
#

-OPT webServerSelected="domino6"


################################################################################
#
# IHS-specific Administrator settings
#
################################################################################
#
# HTTP Administration Port number
#
# Specify the HTTP Administration Port number (only specify value when configuring IHS)
#

-OPT ihsAdminPort=""


################################################################################
#
# IHS Administrator User ID for IHS Administration server
#
# Specify the IHS Administrator server userid. (only specify value when configuring IHS)
#

-OPT ihsAdminUserID=""



################################################################################
#
# 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
#

-OPT 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
#

-OPT webServerConfigFile2=""


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

-OPT webServerPortNumber="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.
#

-OPT domino6UserID="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.
#

-OPT 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.xml
#			    file 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, otherwise install will not proceed.
#

-OPT 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.
#

-OPT 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.
# 

-OPT 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.
#

-OPT webServerHostName=""


################################################################################
#
# WAS Profile Name
#
# Specify the name of the WAS Profile to be configured. This option is only valid
# in local install scenarios.
#
# Valid options:  
#	"<WAS_profile_name>"  : User must enter the name of an existing WAS profile
#                              leaving the string empty will result in the installer
#                               using the default profile
#                               example.  profileName="AppSrv01"
#

-OPT profileName=""
参照トピック    

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

最終更新: Jan 21, 2008 6:25:35 PM EST
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp?topic=/com.ibm.websphere.express.doc/info/exp/ae/rins_plugins_responsefile.html