WebSphere Application Server Network Deployment for i5/OS, Version 6.1   
             オペレーティング・システム: i5/OS

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

responsefile.txt

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

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

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

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

install -options myresponsefile.txt

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

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

使用方式

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

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

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

install -options myresponsefile.txt

作動環境の作成

プラグインのインストールは、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. インストールを開始します。 以下に例を示します。
    install -options path/myresponsefile.txt
  5. インストールを完了したら、成功を表すログを確認します。

ロギング

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

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

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

すべての検証にパスすると、インストールが起こります。 次に、プラグイン・インストール・ウィザードがインストール・イベントを以下のログ・ファイルに記録します。 ログ・ファイルは 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 : エントリーがログに入った後で 書き込まれます。

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 サーバー定義を手動で作成する必要があるからです。

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

使用上の注意

responsefile.txt ファイルの例

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

# **********************************************************************
# 
# Response file for Web Server Plug-ins for WebSphere Application 
# Server V6.1 Install
# 
# **********************************************************************

################################################################################
# 
# A common use of an options file is to run the wizard in silent mode. This lets
# the options file's author to 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:
# 
#   -options "/<responsefile.path>/responsefile"
#
################################################################################ 

################################################################################
#
# Invoke the install wizard in silent mode for both local and remote install 
# whenever the response file is used.
#

-silent

################################################################################
#
# TROUBLE SHOOTING TIP
#
# If no signs of an install are visible, reference the log file (plglogs/log.txt)
# in the /tmp/InstallShield directory for signs of a cause.
# 

###################################################################################
#
# 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 
# in the /tmp/InstallShield/plglogs 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>/plugin/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 to continue with
# the installation and log the warnings even though the prerequisite checking
# has failed.
#
#-OPT disableOSPrereqChecking="true"


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

-OPT installType="local"


################################################################################
#
# Plugins Install Location
#
# The desired install location of Web Server Plugins for IBM WebSphere 
# Application Server V6.1. Specify a valid directory into which the product 
# should be installed.  This directory must be either empty or not exist.
# 
# Below is the default Web Server Plugins install location for the i5 
# operating system.
#
# i5OS Default Install Location:
#
#  -OPT installLocation="/QIBM/ProdData/WebSphere/Plugins/V61/webserver"
#

-OPT installLocation="/QIBM/ProdData/WebSphere/Plugins/V61/webserver"


################################################################################
#
# Profile Location
#
# The desired install location of Web Server Plugins profiles.  For new installs, 
# specify a valid directory into which the profiles should be installed.  This 
# directory must be either empty or not exist.
#
# Below is the default profile install location for the i5 operating system.
#
# i5OS Default Profile Install Location:
#
#  -OPT defaultProfileLocation="/QIBM/UserData/WebSphere/Plugins/V61/webserver"
#

-OPT defaultProfileLocation="/QIBM/UserData/WebSphere/Plugins/V61/webserver"


################################################################################
#
# Allow Profile Location Override
#
# This option allows users to overrule the empty default profile location requirement.
#
# Valid values:
#	true - Allow profile location override
#	false - Do not allow profile location override
#
# If desired, uncomment the following entry
#
# -OPT allowOverrideProfileLocation="true"
#


################################################################################
#
# 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.
#
# Below is the default WebSphere Application Server install location for the i5 
# operating system.
#
# i5OS Default Install Location:
#
#  -OPT wasExistingLocation="/QIBM/ProdData/WebSphere/AppServer/V61/<EDITION>"
#
#  where Edition = "Express" for WebSphere Application Server - Express
#                = "Base" for WebSphere Application Server
#                = "ND" for WebSphere Application Server Network Deployment
#

-OPT wasExistingLocation="/QIBM/ProdData/WebSphere/AppServer/V61/Express"


################################################################################
#
# Web server to configure
#
# Valid options	
#		: none  	Install binaries only.  No Web server configuration.
#		: ihs           IBM HTTP Server V6 or V6.1
#		: domino6	Lotus Domino Web Server V6 or V6.5 (not supported on HP-UX)
#
# Note 	: Specify only one Web server to configure.
#

-OPT webServerSelected="none"


#===============================================================================
#
# 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/Group for IHS Administration server
#
# Specify the IHS Administrator server userid and user group. (only specify value 
# when configuring IHS)
#

-OPT ihsAdminUserID=""
-OPT ihsAdminUserGroup="" 

#
#================================================================================


################################################################################
#
# Web Server Configuration File 1
#
# Valid options for Web Server configuration file 1 location
#
#		ihs 		: httpd.conf 
#		domino6 	: Notes.jar
#
# Note	: File must exist
#
# Below is the default Web Server Configuration file location for the i5 
# operating system.
#
# i5OS Default Web Server Configuration file Location:
#
#  For IHS (IBM HTTP Server)
#    -OPT webServerConfigFile1="/www/<YourWebServerName>/conf/httpd.conf"
#
#  For Lotus Domino 6
#    -OPT webServerConfigFile1="/QIBM/ProdData/LOTUS/DOMINO605/Notes.jar"	
#

-OPT webServerConfigFile1=""


#===============================================================================
#
# DOMINO-specific settings
#
#===============================================================================
#
# Web server Configuration File 2
#
# Valid options for Web server configuration file 2 location
#
#		domino6 : names.nsf
#		
# Note	: File must exist
#
# File can be found under the DOMINO instance directory you defined when
# you created your DOMINO instance
#

-OPT webServerConfigFile2=""


################################################################################
#
# Domino 6 User ID
#
# Specify the Domino 6 User ID.#

-OPT domino6UserID="notes"

#
#================================================================================


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

-OPT webServerPortNumber="80"


################################################################################
#
# 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 the installer generating the 
#            plugin-cfg.xml file location at install time and configuring the Web 
#            Server to use this location.  This is the recommended option.
#
#	"<file_location>" : User may enter an existing file location.  The Web Server 
#                           will be configured to use this existing plugin-cfg.xml file 
#                           location.  If a file is specified, it must exist, otherwise 
#                           the 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 the 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 the 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 the hostname detected on the 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 name of the default profile
#                              Example:  -OPT profileName="AppSrv01"
#

-OPT profileName=""



参照トピック    

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

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