WebSphere Process Server または Client をサイレント・モードでインストールする

応答ファイルと呼ばれるファイルを使用して、分散システムでサイレント・インストールまたはバックグラウンド・インストールを実行できます。この場合、サイレント・インストールによって、インストール・プログラムは、グラフィカル・ユーザー (「ウィザード」) インターフェースを表示する代わりに、ユーザーが提供するファイルからユーザーの応答をすべて読み取ることができます。 応答ファイル responsefile.wps.txt を使用して、WebSphere Process Server または Client のサイレント・インストールを実行することができます。応答ファイルは、デフォルト値で出荷されています。

始める前に

この手順を使用してインストールする前に、以下のことを確認してください。
  • サイレント・インストールを望んでおり、WebSphere Process Server も Client もまだインストールされていない。実行しようとするインストールがこれらの基準を満たさない場合、ソフトウェアのインストールの他のインストール手順についての説明を参照してください。
  • 希望するインストールのタイプを決定している。
    • カスタム・インストールでは、インストールする製品機能を選択できます。WebSphere Application Server Network Deployment もインストールされ、インストール完了時にプロファイル・ウィザードを実行して WebSphere Process Server プロファイルを作成できます。
    • クライアント・インストールでは、WebSphere Process Server Client をインストールします。WebSphere Application Server Network Deployment をインストールすることもできます。
  • WebSphere Process Server または Client のインストールの一環として WebSphere Application Server Network Deployment をインストールするのか、WebSphere Application Server または WebSphere Application Server Network Deployment のバージョン 6.0.x.x の既存のインストール済み環境を使用するのかを決定している。
  • インストール・トポロジーの計画で、可能なインストール・トポロジーを確認している。
  • システムはすべてのハードウェア要件を満たしており、必要なすべてのソフトウェア相互前提条件および前提条件をインストール済みである。詳しくは、ハードウェアおよびソフトウェアの要件を参照してください
  • オペレーティング・システムでインストールの準備が整っている。詳しくは、インストールのためのオペレーティング・システムの準備を参照してください。
  • Linux または UNIX システムの root ユーザーとして、または Windows システムの管理者グループのメンバーとして、製品をインストールする。

応答ファイル内での -silent オプションの使用の回避

応答ファイル内で -silent オプションを使用しないでください。使用すると、プロファイルの作成が失敗する可能性があります。

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

応答ファイルの例 responsefile.wps.txt は、WebSphere Process Server CD 1WBI ディレクトリー内にあります。これはインストールされません。

重要: Icon indicating AIX platforms AIX プラットフォームの場合: AIX でのサイレント・インストール用のファイルを準備する場合は、UNIX 行終了文字 (0x0D0A) を使用して応答ファイルの各行を終了します。ファイルを作成する最も安全な方法は、 ターゲット・オペレーティング・システム上でファイルを編集することです。

必要なディスク・スペース

スペース所要量について詳しくは、http://www.ibm.com/support/docview.wss?uid=swg27006205WebSphere Process Server の詳細なシステム要件を確認し、ご使用のバージョンの WebSphere Process Server のリンクを選択してください。

応答ファイルを使用したインストール

サイレントにインストールするには、以下の手順を実行します。
  1. responsefile.wps.txt ファイルを、WebSphere Process Server CD 1WBI ディレクトリーから、ご使用のマシン上の分かりやすい場所にコピーし、myoptionsfile などの新しい名前を付けて保管します。
  2. ターゲット・オペレーティング・システム上で、選択したフラット・ファイル・エディターを使用してこのファイルを編集し、ご使用のシステム用のパラメーターを使用してカスタマイズします。応答ファイル内の指示を読み取って、適切な値を選択します。 応答ファイルのサンプルについては、responsefile.wps.txt ファイルの例を参照してください。
    重要: 必ず、ファイル内のご使用条件への同意に関する記述において、値を "true" に変更してください。値を "false" のままにすると、インストールが失敗します。
    WebSphere Process Server Client 環境をインストールする場合、手順 4 に進んでください。 WebSphere Process Server 環境をインストールする場合、手順 3 に進んでください。
  3. 作動可能な WebSphere Process Server 環境を作成するには、プロファイルが存在しなければなりません。responsefile.wps.txt のコピーの末尾で特定の値を指定することによって、プロファイル・ウィザードを起動し、プロファイルをサイレントに作成することができます。
    • インストール・プロセスの最後に、プロファイル・ウィザードを起動し、プロファイルをサイレントに作成するには、以下の手順を実行します。
      1. responsefile.wps.txt のコピーの末尾で、オプション -W summaryPanel_InstallWizardBean.launchPCAW の値を true に変更します。 以下に例を示します。
        -W summaryPanel_InstallWizardBean.launchPCAW="true"
      2. 作成するプロファイルのタイプに対応するプロファイル応答ファイルを、WebSphere Process Server CD 1WBI ディレクトリーから、ご使用のマシン上の分かりやすい場所にコピーし、MyStandaloneProfile などの新しい名前を付けて保管します。オリジナル・プロファイル応答ファイルの名前は以下のとおりです。
        • スタンドアロン・サーバー・プロファイル: responsefile.pcaw.wps.standAloneProfile.txt
        • デプロイメント・マネージャー・プロファイル: responsefile.pcaw.wps.dmgrProfile.txt
        • カスタム・プロファイル: responsefile.pcaw.wps.managedProfile.txt
      3. ターゲット・オペレーティング・システム上で、選択したフラット・ファイル・エディターを使用してこのプロファイル応答ファイルを編集し、ご使用のシステム用のパラメーターを使用してカスタマイズします。 応答ファイル内の指示を読み取って、適切な値を選択します。 詳しくは、『プロファイルのサイレント作成』を参照してください。
      4. オプション -W pcawResponseFileLocationQueryAction_InstallWizardBean.fileLocation の値を "" から (変更済みの) プロファイル応答ファイルの絶対ファイル・パスを示すように変更します。以下に例を示します。
        -W pcawResponseFileLocationQueryAction_InstallWizardBean.fileLocation=
        "/opt/IBM/WebSphere/MyOptionFiles/MyStandaloneProfile.txt"
    • プロファイル・ウィザードを起動せず、プロファイルをサイレントに作成しない 場合は、必ずオプション -W summaryPanel_InstallWizardBean.launchPCAW の値を false としてください。 以下に例を示します。
      -W summaryPanel_InstallWizardBean.launchPCAW="false"
  4. 操作可能な WebSphere Process Server Client 環境を作成するには、オプション機能 (サンプルおよび JavadocTM) を選択したり、およびインストールの一部としてプロファイルを作成しないでください。これを行うと、インストールが失敗する可能性があります。クライアントのインストール済み環境を作成する例として、サンプル応答ファイルを参照してください。
  5. responsefile.wps.txt のコピーに変更内容を保管します。
  6. 以下のコマンドのいずれか 1 つを使用して、WebSphere Process Server をインストールします。ここに示すコマンドでは、responsefile.wps.txt ファイルが一時ディレクトリーにコピーされ、ファイルがカスタマイズされる前に myoptions.txt に名前変更されたことを前提としています。
    • Icon indicating Linux platforms Icon indicating UNIX platforms Linux および UNIX プラットフォームの場合:
      install -options /tmp/WBI/myoptions.txt -silent
    • Icon indicating Windows platforms Windows プラットフォームの場合:
      install.exe -options "C:¥temp¥WBI¥myoptions.txt" -silent
log.txt のログ・ファイルを調べて、インストールが正常に終了していることを確認します。ファイルの最後の行に INSTCONFSUCCESS という語が含まれていれば、選択したコンポーネントは正常にインストールされています。ログ・ファイルは、以下の場所にあります (install_root は、WebSphere Process Server または Client のインストール済み環境の場所です)。
  • Icon indicating Linux platforms Icon indicating UNIX platforms Linux および UNIX プラットフォームの場合: install_root/logs/wbi/log.txt
  • Icon indicating Windows platforms Windows プラットフォームの場合: install_root¥logs¥wbi¥log.txt
このログ・ファイルの最後の行に INSTCONFSUCCESS というストリングが含まれている場合、インストールは正常に終了しています。INSTCONFPARTIALSUCCESS または INSTCONFFAILED などの他の用語が、ファイル内の別の行に (あるいは最後の行にも) 出現する場合がありますが、INSTCONFSUCCESS が最後の行に含まれているのであれば、 インストールは正常に終了しています。

インストールが正常終了しなかった場合は、他のログ・ファイルを調べて 原因を判別してください。インストール済み環境のトラブルシューティングのヒントについては、『ログ・ファイル』に記載されている関連のログ・ファイルの説明や『エラー・メッセージ: インストールおよびプロファイルの作成と拡張に記載されているエラー・メッセージ、後述のセクショントラブルシューティングを調べて、インストールのトラブルシューティングを参照してください。また、プロファイルが正常に作成されなかった場合は、トラブルシューティングのヒントとして、プロファイルの作成または拡張時の障害からのリカバリーを参照してください。

インストールが正常に終了した場合、WebSphere Process Server スタンドアロン・プロファイルまたはデプロイメント・マネージャー・プロファイルの作成後に、ファースト・ステップ・コンソールからサーバーやデプロイメント・マネージャーを始動し、インストール済み 環境が適切に作動していることを確認します。詳細については、ファースト・ステップ・コンソールのオプションを参照してください。インストール検査ツールを使用してインストールの検査を行うこともできます。詳しくは、『インストール検査ツールの使用 (Using the installation verification tools)』を参照してください。

トラブルシューティング

ファイルで値を提供するときは正確に行います: オプション応答ファイルは、 インストール・プログラムがそのファイルに含まれるオプション値を読み取れるように、正確にカスタマイズしてください。 誤った指定は、インストール・ウィザードのサイレント・インターフェースに影響を及ぼします。例えば、大/小文字の区別があるプロパティー名では、常に大/小文字の誤りのないようにしてください。 また、値は常に二重引用符で囲みます。

エラーが無効オプション値である場合、InstallShield for Multiplatforms (ISMP) には、インストールを確認して停止しなければならないという警告メッセージが 表示されます。

応答ファイルを、製品に同梱される responsefile.wps.txt ファイルと比較し、必要な修正を行います。 ファイルの修正後に、再インストールします。

特定のイベントによって、InstallShield for Multiplatforms (ISMP) がインストール・ウィザードをサイレント・モードで開始できなくなる可能性があります (例えば、インストール・ウィザードを起動するためのディスク・スペースが十分でない状況などが考えられます)。インストールが失敗し、インストール・ログに情報がない場合は、-log パラメーターを 使用して、ISMP プログラムがインストール・ウィザードの開始に失敗する原因となるイベントのエントリーを記録します。 このようなイベントを記録するための install コマンドの構文は、以下のとおりです。

Icon indicating AIX platforms AIX プラットフォームの場合:
install -options "/usr/IBM/WebSphere/silentFiles/myresponsefile.txt"
        -silent -log # !/usr/IBM/WebSphere/myOptionFiles/log.txt  @ALL
Icon indicating HP-UX platforms Icon indicating Solaris platforms HP-UX および Solaris プラットフォームの場合:
install -options "/opt/IBM/WebSphere/silentFiles/myresponsefile.txt"
        -silent -log # !/opt/IBM/WebSphere/myOptionFiles/log.txt  @ALL
Icon indicating Linux platforms Linux プラットフォームの場合:
install -options "/opt/ibm/WebSphere/silentFiles/myresponsefile.txt"
        -silent -log # !/opt/ibm/WebSphere/myOptionFiles/log.txt  @ALL
Icon indicating Windows platforms Windows プラットフォームの場合:
install.exe -options "C:¥IBM¥WebSphere¥silentFiles¥myresponsefile.txt"
            -silent -log # !C:¥IBM¥WebSphere¥silentFiles¥log.txt  @ALL

responsefile.wps.txt ファイルの例

WebSphere Process Server に付属の応答ファイル (変更前) は、次のような内容になります。
################################################################################
#
# Licensed Material - Property of IBM
# 5724-L01, 5655-N53
# (C) Copyright IBM Corporation 2005, 2006. All Rights Reserved.
# US Government Users Restricted Rights- Use, duplication or disclosure
# restricted by GSA ADP Schedule Contract with IBM Corp.
#
################################################################################

################################################################################
#
# InstallShield Options File
#
# Wizard name: Install
# Wizard source: setup.jar
#
# This file can be used to configure Install with the options specified below
# when the wizard is run with the "-options" command line option. Read each
# setting's documentation for information on how to change its value.
# 
# 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 mode. To use this options file for silent mode
# execution, use the following command line arguments when running the wizard:
# 
#    -options "D:¥installImage¥WBI¥responsefile.wps.txt" -silent
#
################################################################################

###################################################################################
#
# 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 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¥WBI¥LICENSES.  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.
#
# 

-G licenseAccepted="false"

################################################################################
#
# Incremental Install
#
# If you are installing additional features on top of an existing installation,
# (e.g. incremental install), uncomment the following line.  This will notify
# the installer that you are doing an incremental install.
#
# -W wbiDetectionPanel_InstallWizardBean.optionSelected="1"
#
# Please make sure installLocation is set to your existing install location.
#
# For already installed features, you need to set the feature active property
# to false.  For new features you want to install, you need to set the active
# properties to true.
#
# For example, you have installed the Samples Gallery feature, now you want to
# install the Public API Javadoc(tm) feature, the active properties should be:
#
# -P brbeansProductFeatureBean.active="false"
# -P emsProductFeatureBean.active="false"
# -P samplesProductFeatureBean.active="false"
# -P javadocsProductFeatureBean.active="true"


################################################################################
#
# IBM WebSphere Process Server, V6.0 Install Location
#
# The install location of the product. Specify a valid directory into which the
# product should be installed. If the directory contains spaces, enclose it in
# double-quotes as shown in the Windows example below. Note that spaces in the
# install location is only supported on Windows operating systems.
# 
# Below is the list of default install locations for each supported operating
# system.  By default, in this response file, the Windows install location is
# used.  If you want to use the default install location for another operating
# system, uncomment the appropriate default install location entry (by removing '#') and
# then comment out (by adding '#') the Windows operating system entry below.
#
#
# AIX Default Install Location:
#
#    -P wbiProductBean.installLocation=/usr/IBM/WebSphere/ProcServer
#
#
# HP-UX, Solaris or Linux Default Install Location:
#
#    -P wbiProductBean.installLocation=/opt/IBM/WebSphere/ProcServer
#
#
# Windows Default Install Location:
#
# NOTE: The Windows operating system limits the length of a fully qualified path
#       to 256 characters. A long pathname for the installation root directory makes
#       it more likely that this limit will be exceeded when files are created during
#       normal product use. IBM recommends that you keep the pathname of the installation
#       root directory as short as possible.

-P wbiProductBean.installLocation="C:¥Program Files¥IBM¥WebSphere¥ProcServer"


################################################################################
#
# Use Existing IBM WebSphere Application Server V6.0
#
# If you intend to use an existing installation of WebSphere Application Server V6.0 or
# WebSphere Application Server Network Deployment, V6.0, uncomment the following line
# (by removing '#').
#
# -W wasdetectionpanelInstallWizardBean.optionSelected="1"
#
# You must then set the above WebSphere Process Server install location to the install root
# of the existing WAS installation.
#
# Note that the install will fail if WebSphere Process Server has already been installed
# in the existing WAS install location.
#


################################################################################
#
# Setup Type
#
# The type of installation you wish to perform. Legal values are:
#
#    Custom  - Performs a custom installation of WebSphere Process Server, including
#              optional features which can be enabled below.
#    Client - Performs a client-only installation of WebSphere Process Server. Optional
#             features such as Samples and Javadocs are not installed.
#
#    Additional Notes for a Client Install
#       - When running a client install, all features must be set to "false"
#       - The Profile Wizard cannot be started after a Client-only Install
#
# For example, to perform a Client installation, use
#
#    -W setuptypepanelInstallWizardBean.selectedSetupTypeId="Client"

-W setuptypepanelInstallWizardBean.selectedSetupTypeId="Custom"


################################################################################
#
# "Business Rule Beans (deprecated)" feature
#
# The selection state of the "Business Rule Beans (deprecated)" feature. Legal
# values are:
#
#    true  - Indicates that the feature is selected for installation
#    false - Indicates that the feature is not selected for installation
# 
# For example, to select "Business Rule Beans (deprecated)" for installation, use
#
#    -P brbeansProductFeatureBean.active="false"
#
# This value must be set to false for "Client" only installs.

-P brbeansProductFeatureBean.active="false"


################################################################################
#
# "Extended Messages (deprecated)" feature
#
# The selection state of the "Extended Messages (deprecated)" feature. Legal
# values are:
#
#    true  - Indicates that the feature is selected for installation
#    false - Indicates that the feature is not selected for installation
#
# For example, to select "Extended Messages (deprecated)" for installation, use
#
#    -P emsProductFeatureBean.active="false"
#
# This value must be set to false for "Client" only installs.

-P emsProductFeatureBean.active="false"


################################################################################
#
# "Samples Gallery" feature
#
# The selection state of the "Samples Gallery" feature. Legal values are:
#
#    true  - Indicates that the feature is selected for installation
#    false - Indicates that the feature is not selected for installation
#
# For example, to select "Samples Gallery" for installation, use
#
#    -P samplesProductFeatureBean.active="true"
#
# This value must be set to false for "Client" only installs.

-P samplesProductFeatureBean.active="true"


################################################################################
#
# "Public API Javadoc (tm)" feature
#
# The selection state of the "Public API Javadoc (tm)" feature. Legal values are:
#
#    true  - Indicates that the feature is selected for installation
#    false - Indicates that the feature is not selected for installation
#
# For example, to select "Public API Javadoc (tm)" for installation, use
#
#    -P javadocsProductFeatureBean.active="true"
#
# This value must be set to false for "Client" only installs.

-P javadocsProductFeatureBean.active="true"


################################################################################
#
# WebSphere Process Server Profile Wizard
#
# To launch the Profile Wizard SILENTLY at the end
# of the installation, please change the value to "true".
# Otherwise, set the value to "false".
#
# This option does not apply for the "Client" Setup Type.


-W summaryPanel_InstallWizardBean.launchPCAW="false"



################################################################################
# If you choose to run Profile Wizard silently at the end of the
# installation, you must
# 1. get a copy of the Profile Wizard response file (from CD) and put to a temp dir
#    such as: /tmp/WBI/responsefile.pcaw.wps.dmgrProfile.txt         For DMGR profile creation
#             /tmp/WBI/responsefile.pcaw.wps.managedProfile.txt      For Manage profile creation
#             /tmp/WBI/responsefile.pcaw.wps.standAloneProfile.txt   For Stand alone profile creation
# 2. modify the response file by filling in the required options/values.
# Note: If the values are not completed properly, the configuration may be unsuccessful.
# 3. specify below the absolute path to your modified response file.
# 
# For example, -W pcawResponseFileLocationQueryAction_InstallWizardBean.fileLocation=   ¥
# "/tmp/WBI/responsefile.pcaw.wps.dmgrProfile.txt"
#
# This option does not apply for the "Client" Setup Type.


-W pcawResponseFileLocationQueryAction_InstallWizardBean.fileLocation=""

(c) Copyright IBM Corporation 2005, 2006.
このインフォメーション・センターには Eclipse テクノロジー (http://www.eclipse.org) が採用されています。