WebSphere WebSphere Enterprise Service Bus, Version 6.0.1 オペレーティング・システム: AIX, HP-UX, Linux, Solaris, Windows

カスタム・プロファイルのサイレント作成

responsefile.pcaw.esb.managedProfile.txt ファイルは、 カスタム・プロファイルを作成するためのサンプル応答ファイルです。addNode コマンドを使用して、 カスタム・ノードをデプロイメント・マネージャーのセルにフェデレートし、ノードを作動可能にします。 このプロファイルは管理対象ノードでもあることから、管理対象プロファイル と呼ばれることがあります。

オプションの応答ファイルを使用してカスタム・ノードを作成する前に、Linux® プラットフォームまたは UNIX® プラットフォーム上で root としてログオンするか、または Windows® プラットフォーム上で Administrator グループに属するユーザーとしてログオンします。Windows プラットフォームでのいくつかのインストール手順には、ユーザーが Administrator グループに属しており、オペレーティング・システムの一部として機能 し、サービスとしてログオンできる、という上級ユーザー権限を備えている必要があります。

サイレント・インストールが行われると、インストール・プログラムによってこのファイルが読み込まれ、 デプロイメント・マネージャー・プロファイルの特性が判別されます。この応答ファイルを使用すると、初期インストールのあとに、 他のデプロイメント・マネージャー・プロファイルを作成することができます。応答ファイルはデフォルト値で出荷されています。

カスタム・プロファイルのフェデレート

ファイル内のいくつかのディレクティブは、 カスタム・ノードがデプロイメント・マネージャー・セル内にフェデレートされる方法についてのオプションを提供します。
  • -W pctfederationpanelInstallWizardBean.federateLater

    以下のフェデレーションの説明にあるいずれかの理由により、 デプロイメント・マネージャーが実行されていないか、アクセスが可能でない場合は、この値を true に設定します。

  • -W pctfederationpanelInstallWizardBean.hostname

    デプロイメント・マネージャーが実行されているシステムに解決する値を指定します。 ホストの命名について詳しくは、「プロファイル、ノード、ホスト、およびセルの命名に関する考慮事項」を参照してください。

  • -W pctfederationpanelInstallWizardBean.port

    デプロイメント・マネージャーの SOAP ポートの値を指定します。正しい値を指定する必要があります。 値が正しくなければ、ノードのフェデレートが妨げられ、 INSTCONFFAILED 標識を伴う全体的な失敗という結果になります。デプロイメント・マネージャーに対するデフォルトの SOAP ポートは、8879 です。

プロファイルの作成中または作成後のノードのフェデレート

次の条件をすべて 満たしている場合にかぎり、 カスタム・プロファイルのサイレント作成時にノードをフェデレートします。
  • デプロイメント・マネージャーが実行されている。
  • デプロイメント・マネージャーが WebSphere ESB プロファイルである。
  • セキュリティーがデプロイメント・マネージャーのノード上で使用可能になっていない。
  • デプロイメント・マネージャーがデフォルトの SOAP JMX コネクター・タイプを使用し、その コネクターが使用可能になっている。
次のいずれかに 当てはまる場合は、プロファイルのサイレント作成中にノードをフェデレートしないで ください。
  • デプロイメント・マネージャーが実行中でないか、実行中であるかどうか確実でない場合。
  • デプロイメント・マネージャーは、 WebSphere ESB プロファイルにまだ拡張されていない WebSphere Application ServerNetwork Deployment プロファイルである。
  • セキュリティーがデプロイメント・マネージャー・ノードで使用可能になっている。
  • SOAP コネクターが使用不可になっている。
  • デプロイメント・マネージャーが、 優先 Java Management Extensions (JMX) コネクターとして 、デフォルトでないリモート・メソッド呼び出し (RMI) を使用するように再構成されている。 (優先コネクター・タイプを確認するには、デプロイメント・マネージャーの管理コンソール で「システム管理 (System administration)」>「デプロイメント・マネージャー (Deployment manager)」>「管理サービス (Administration services)」を選択します。)
これらのいずれか 1 つでも当てはまる場合は、ノードをフェデレートする前に、addNode コマンドを使用してノードを作成し、 ユーザー ID およびパスワードをコマンドに入力してください。

デプロイメント・マネージャーが実行されていない、 または別の理由で使用不可になっているときにカスタム・ノードをフェデレートしようとすると、 プロファイルの作成は失敗し、カスタム・プロファイルは使用できなくなります。その場合、同じプロファイル名で他のカスタム・プロファイルを作成する前に、このカスタム・プ ロファイル・ディレクトリーをプロファイル・リポジトリー (デフォルトでは、install_rootprofiles ディレクトリーであり、install_rootWebSphere ESB インストール・ディレクトリーです) の外に移動する必要があります。

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

ファイル内に -silent オプションが存在するときに問題が発生します。ファイルは、プロファイル作成ウィザードへの直接呼び出し中にオプションと連携しますが、製品のサイレント・インストールからの呼び出し時には失敗します。 製品のサイレント・インストール中にサイレントでプロファイルを作成する方法については、オプション応答ファイルのカスタマイズを参照してください。

このオプションは必須ではありません。 このオプションを使用しないことにすれば問題を回避できます。

応答ファイルの場所

オプション応答ファイルのサンプルは、2 つの場所にあります。

サンプル・ファイル
  • responsefile.pcaw.esb.dmgrProfile.txt
  • responsefile.pcaw.esb.managedProfile.txt
  • responsefile.pcaw.esb.standAloneProfile.txt

場所:

表 1. オプション応答ファイルの場所
製品ディスクの場所 インストールされる場所
/ESB ディレクトリー install_root/bin/ProfileCreator ディレクトリー

製品ディスク上でファイルを使用し、WebSphere ESB のサイレント・インストールを行ってプロファイルを作成します。

WebSphere ESB をインストールした後で、プロファイル作成ウィザード・コマンド上で -options パラメーターを使用してインストールした応答ファイルを使用できます。

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

プロファイル 必要なディスク・スペース 必要な一時スペース
デプロイメント・マネージャー・プロファイル 30 MB 40 MB
カスタム・プロファイル 10 MB 40 MB
アプリケーション・サーバー・プロファイル 200 MB 40 MB

製品インストール中の操作環境の作成

WebSphere ESB のインストールは 2 段階のプロセスです。
  1. 中核となる製品ファイルと機能ファイルのインストール
  2. デプロイメント・マネージャー・プロファイル (deployment manager profile)、カスタム・プロファイル (custom profile)、またはアプリケーション・サーバー・プロファイルの作成

オプション応答ファイルのサンプル、 responsefile.esb.txt は、インストールの最初の部分 を制御し、また、インストールの 2 番目の部分を開始することもできます。 中核となる製品ファイルのインストールの一環としてプロファイル を作成するには、プロファイル作成のための応答ファイルを識別する responsefile.esb.txt ファイルでオプションを使用します。 そうすることにより、ユーザーはプロファイル応答ファイルを使用して、 プロファイル作成ウィザードのサイレント使用を行うことができます。

プロファイルの作成に適した応答ファイルを編集し、使用するには、次の手順を実行します。
  1. 製品の適切なファイルを、製品ディスクの ESB ディレクトリーからマ シン内の識別しやすい場所にコピーします。 サンプル・ファイルは次の通りです。
    作成するファイル コピーする応答ファイル
    デプロイメント・マネージャー・プロファイル responsefile.pcaw.esb.dmgrProfile.txt
    カスタム・プロファイル responsefile.pcaw.esb.managedProfile.txt
    アプリケーション・サーバー・プロファイル responsefile.pcaw.esb.standAloneProfile.txt
  2. ファイルを編集して、ご使用のインストール済み環境用に値をカスタマイズします。
  3. プロファイル作成ウィザードの応答ファイルに、-silent オプションがないことを確認します。 このオプションが存在していると、プロファイルは作成されません。
  4. ファイルを保管します。
  5. responsefile.esb.txt ファイルを編集して、プロファイル応答ファイルの場所と名前を示します。 -W pcawresponsefilelocationqueryactionInstallWizardBean.fileLocation オプションの値を変更して、このファイルを識別するようにします。例:
    -W pcawresponsefilelocationqueryactionInstallWizardBean.fileLocation=
    "/opt/IBM/WebSphere/MyOptionFiles/customProfile.txt"
  6. インストールを開始します。例:
    install -options "myresponsefile.txt" -silent
  7. インストール後に、ログを検査して成功したことを確認します。

インストール後のプロファイルの作成

WebSphere ESB 製品のインストールは 2 段階のプロセスです。
  1. 中核となる製品ファイルと機能ファイルのインストール
  2. デプロイメント・マネージャー・プロファイル (deployment manager profile)、カスタム・プロファイル (custom profile)、またはスタンドアロン・サーバー・プロファイル (stand-alone server profile) の作成

中核となる製品ファイルが存在している場合は、プロファイル作成ウィザードを使用していつでもプロファイルを作成できます。 ファースト・ステップ・コンソールから、またはプロファイル作成ウィザード・コマンドを直 接使用して、ウィザードを開始します。

プロファイル作成ウィザードをサイレント・モードで使用してプロファイルをサイレ ントに作成するために、プロファイルのオプション応答ファイルの次のサンプルのいずれかを使 用することもできます。 プロファイルの作成に適した応答ファイルを編集し、使用するには、次の手順を実行します。
  1. 製品の該当するファイルを、 install_root/bin/ProfileCreator ディレクトリーからマシン内の識別しやすい場所にコピーします。 サンプル・ファイルは次の通りです。
    プロファイルを作成する対象 コピーする応答ファイル
    デプロイメント・マネージャー responsefile.pcaw.esb.dmgrProfile.txt
    管理対象ノード responsefile.pcaw.esb.managedProfile.txt
    スタンドアロン・アプリケーション・サーバー responsefile.pcaw.esb.standAloneProfile.txt

    例えば、my_options_file.txt としてファイルをコピーします。

  2. ファイルを編集して、ご使用のインストール済み環境用に値をカスタマイズします。
  3. ファイルを保管します。
  4. インストールを開始します。
    例:
    • For AIX platforms ./pcatAIX.bin -options my_options_file.txt -silent
    • ./pcatHPUX.bin -options my_options_file.txt -silent
    • LINUX platforms ./pcatLinux.bin -options my_options_file.txt -silent
    • LINUX platforms Power プラットフォームの場合: ./pcatLinuxPPC.bin -options my_options_file.txt -silent
    • Solaris platforms ./pcatSolaris.bin -options my_options_file.txt -silent
    • For Windows platforms pcatWindows.exe -options my_options_file.txt -silent
  5. プロファイル作成ウィザードを使用した後で、ログを検査してインストールが正常に完了したことを確認します。

ロギング

次のログ・ファイルはプロファイル作成についての情報を記録します。
  • install_root/logs/log.txt ファイルは、インストールの状況を記録します。
  • install_rootprofiles/profile_name/logs/pctLog.txt ファイルは、プロファイル作成ウィザードによってプロファイルを作成する場合に起こる、インストール・イベントを記録します。
  • install_root/logs/wasprofile/wasprofile_create_profile_name.log ファイルは、プロファイルを作成する場合に起こる、インストール・イベントを記録します。
  • install_root/logs/wasprofile/wasprofile_delete_profile_name.log ファイルは、プロファイルを削除する場合に起こる、インストール・イベントを記録します。

命名に関する考慮事項

命名に関する考慮事項については、「プロファイル、ノード、ホスト、およびセルの命名に関する考慮事項」を参照してください。

responsefile.pcaw.esb.managedProfile.txt ファイルの例

ヒント: カスタム・プロファイルをデプロイメント・マネージャーのセルに追加して、 作動可能にする必要があります。このプロファイルは管理対象ノードでもあることから、管理対象プロファイル や管理対象ノードと呼ばれることがあります。

ノードをセルにフェデレートするまでは、ノードは管理対象外です。また、Application Server プロファイルにフェデレートされたノードなど、 フェデレートされたノー ドはすべて管理対象ノードであることにもご注意ください。

次の応答ファイルでは、 多くのディレクティブ名で custom ではなく managed という用語を参照しています。この場合でも、 この応答ファイル内のすべてのディレクティブでカスタム・プロファイルが定義されます。


################################################################################
#
# Response file for WebSphere ESB custom profile creation
#
# This options file is located in the CD_ROOT¥ESB¥ directory and in the 
# install_root¥bin¥ProfileCreator_wbi directory. 
#
# To use the options file under CD_ROOT¥ESB¥ directory, follow the instructions 
# in CD_ROOT¥ESB¥responsefile.esb.txt. The WebSphere ESB
# installer locates this file during silent installation
# and automatically runs the silent profile creation at the end of installation.
# 
# To use the options file under install_root¥bin¥ProfileCreator_wbi for silent profile
# creation, you must change various values in the file and use the following command 
# line arguments:
# 
#    -options "responsefile.pcaw.esb.managedProfile.txt" -silent
#
################################################################################


################################################################################
# 
# Profile name
#
# Set the name for this custom profile. The profile name must be unique for this 
# WebSphere ESB installation. 
#
#
-W profilenamepanelInstallWizardBean.profileName="profileManaged"

################################################################################
# If you want to set this profile to be your default profile, set to "true".
# Otherwise set to "false". If this is the first profile being created, the profile  
# automatically is the default. 
#
-W profilenamepanelInstallWizardBean.isDefault="false"


################################################################################
# 
# Profile location
#
# Specify a directory to contain the files that define the run-time environment, 
# such as commands,configuration files, and log files. If the specified directory 
# already exists it must be empty. If the directory name 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.
#
# Default Install Location:
#
#    -P installLocation="<ESB_HOME>¥profiles¥<PROFILE_NAME>"
#
-P installLocation="C:¥Program Files¥IBM¥WebSphere¥ESB¥profiles¥profileManaged"


################################################################################
# 
# Node name
#
# Please select the node name for the Application Server. Node name under one cell 
# has to be unique. 
#
# Replace YOUR_NODE_NAME with the actual node name. 
#
-W nodehostnamepanelInstallWizardBean.nodeName="YOUR_NODE_NAME"


################################################################################
#
# Host name
#
# Specify the host name for the Application Server. The host name is the domain 
# name system (DNS) name (short or long) or the IP address of this computer. 
# 
# Replace YOUR_HOST_NAME with the actual host name. Comment the line to use 
# the default value.
# 
-W nodehostnamepanelInstallWizardBean.hostName="YOUR_HOST_NAME"


################################################################################
#
# Cell name
#
# You should not Modify this, unless absolutely necessary
# 
# The Wizard would set this to short local host name + "Node##Cell" by default.
#
# If you would like to override the resolved cell name value, uncomment the line and
# replace YOUR_CELL_NAME with <YOUR_OWN_VALUE>
#
# -W setnondmgrcellnameinglobalconstantsInstallWizardBean.value="YOUR_CELL_NAME"


################################################################################
# 
# Ports value assignment
#
# The following entries are used to reset port numbers used in the configuration
#
# They are currently set to the defaults. 
# Please check to make sure there are no port conflicts.
# Port nubmers for each profile can be find in: 
# <profile>/config/cells/<cell name>/nodes/<node name>/serverindex.xml
#
# If you specify true for the value of 
# the -W pctfederationpanelInstallWizardBean.federateLater  
# directive, port numbers are assigned automatically when you federate the 
# node with the addNode command. The following port numbers do not apply.
#
-W pctmanagedprofileportspanelInstallWizardBean.BOOTSTRAP_ADDRESS="2809"
-W pctmanagedprofileportspanelInstallWizardBean.SOAP_CONNECTOR_ADDRESS="8878"
-W pctmanagedprofileportspanelInstallWizardBean.SAS_SSL_SERVERAUTH_LISTENER_ADDRESS="9901"
-W pctmanagedprofileportspanelInstallWizardBean.CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS="9201"
-W pctmanagedprofileportspanelInstallWizardBean.CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS="9202"
-W pctmanagedprofileportspanelInstallWizardBean.ORB_LISTENER_ADDRESS="9100"
-W pctmanagedprofileportspanelInstallWizardBean.NODE_DISCOVERY_ADDRESS="7272"
-W pctmanagedprofileportspanelInstallWizardBean.NODE_MULTICAST_DISCOVERY_ADDRESS="5000"
-W pctmanagedprofileportspanelInstallWizardBean.NODE_IPV6_MULTICAST_DISCOVERY_ADDRESS="5001"
-W pctmanagedprofileportspanelInstallWizardBean.DCS_UNICAST_ADDRESS="9353"


################################################################################
# 
# Federation
#
# A custom profile contains an empty node that must be federated to a deployment 
# manager to become a functional managed node. Identify a running deployment
# manager that will administer the node or choose to federate the node later 
# using the addNode command.
#
# Set to "true" if you want to federate this custom node later using the addNode 
# command. You must federate this node later if the deployment manager :
#            - is not running. 
#            - has security enabled. 
#            - has the SOAP connector disabled
#
# If you want to federate it now, set to "" and fill in the entries for the host  
# and port of the deployment manager. 
#
-W pctfederationpanelInstallWizardBean.federateLater=""

################################################################################
# Specify the host name of the deployment manager for federation.
#
-W pctfederationpanelInstallWizardBean.hostname="YOUR_DEPLOYMENT_MANAGER_HOST_NAME"

################################################################################
# Specify the port number where the deployment manager (DMGR) is reachable on the 
# above host. The default port value is "8879".
#
-W pctfederationpanelInstallWizardBean.port="YOUR_DEPLOYMENT_MANAGER_PORT_NUMBER"





################################################################################
# 
# Profile type
#
# Must be set to "managed" for installing a custom profile. Do not change this!
# 
-W profiletypepanelInstallWizardBean.selection="managed"

関連タスク
オプション応答ファイルのカスタマイズ

Reference topic

ご利用条件 | フィードバック (英語のみ)

Timestamp icon最終更新: 5 Mar 2006
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/index.jsp?topic=/com.ibm.websphere.wesb.doc.nl1_6.0.1\tasks\twesb_silent_cust.html

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