wasprofile コマンド行ツールは、 バージョン 6 におけるすべてのアプリケーション・サーバー・ランタイム 環境を作成します。このコマンドにより、デプロイメント・マネージャー、 カスタム・ファイル、またはスタンドアロン・アプリケーション・サーバーの ランタイム環境を定義するファイルのセットであるプロファイルが作成されます。
また、プロファイル作成ツール・グラフィカル・ユーザー・インターフェースを使用して、プロファイルの作成および管理を行うことが可能です。
wasprofile コマンドは、プロファイル と呼ばれる ファイルのセットの形で、WebSphere Application Server プロセス用の ランタイム環境を作成します。 プロファイルはランタイム環境を定義し、 ランタイム環境内のサーバー・プロセスによって変更できるファイルはすべて、 プロファイルに含まれています。
プロファイル作成ツールおよびそのグラフィカル・ユーザー・インターフェースであるプロファイル作成ウィザード は、V6 でランタイム環境を作成する唯一の方法です。
プロファイル作成ウィザード は、 InstallShield for Multiplatforms (ISMP) アプリケーションです。 このトピックで説明するパラメーターのほとんどは、このウィザードから入力できます。 ただし、一部のパラメーターについては wasprofile コマンドを使用する必要があります。 例えば、プロファイルを削除するには wasprofile コマンドを 使用する必要があります。これは、プロファイル作成ウィザードが削除機能を備えていないためです。
しかし、プロファイル作成ウィザードが実行するタスクの中には 、wasprofile コマンドでは実行できないものもあります。 例えば、ウィザードが作成する各プロファイル用の Windows サ ービスも、やはりウィザードによって作成されます。また、 バージョン 6 で以前に行ったポート割り当てを基に、 競合しないポートを割り当てることもできます。
このコマンド・ファイルは、app_server_root/bin ディレクトリーにあります。
プロファイル作成ウィザードは、コマンド行ツールのグラフィカル・ユーザー・インターフェースです。 プロファイル作成ウィザードを呼び出すコマンドのファイル名は、 オペレーティング・システム・プラットフォームによって異なります。詳しくは、グラフィカル・ユーザー・インターフェースによるプロファイルの作成 を参照してください。
wasprofile コマンドは、プロファイルを作成するたびに、そのログを作成します。 ログは、app_server_root/logs/wasprofile ディレクトリーにあります。 ファイルは、profile_name_create.log というパターンで命名されます。
このコマンドは、プロファイルを削除する場合にも、その都度ログを作成します。 ログは、app_server_root/logs/wasprofile ディレクトリーにあります。 ファイルは、profile_name_delete.log というパターンで命名されます。
wasprofile コマンドの長さは、1 行 256 文字という 通常のシェル・ウィンドウの制限を超えることができません。 コマンドがこの制限より長くなる場合は、行の終わりに円記号 (¥) を付加し 、Enter を押してから次の行にコマンドを続けるという方法で、コマンドを複数行に入力してください。
./wasprofile.sh ¥ -create -profileName bladetcb6profile ¥ -profilePath /usr/IBM/WebSphere/AppServer/profiles/bladetcb6profile ¥ -templatePath /usr/WebSphere/AppServer/profileTemplates/default ¥ -nodeName bladetcb6node ¥ -cellName bladetcb6Cell ¥ -hostName bladetcb6.rtp.raleigh.ibm.com
最後の行では行継続文字を省略して、 コマンドが終了することをオペレーティング・システムに知らせます。
# ./wasprofile.sh -help # ./wasprofile.sh -augment -help # ./wasprofile.sh -create -help # ./wasprofile.sh -create -templatePath fully_qualified_path/dmgr -help # ./wasprofile.sh -create -templatePath fully_qualified_path/default -help # ./wasprofile.sh -create -templatePath fully_qualified_path/managed -help # ./wasprofile.sh -delete -help # ./wasprofile.sh -getName -help # ./wasprofile.sh -getPath -help # ./wasprofile.sh -unaugment -help # ./wasprofile.sh -validateRegistry -help # ./wasprofile.sh -validateAndUpdateRegistry -help
# ./wasprofile.sh -listProfiles [-debug]
# ./wasprofile.sh -delete -profileName profile_name
# ./wasprofile.sh -create -profileName profile_name -profilePath fully_qualified_profile_path -templatePath template_path -nodeName node_name -cellName cell_name -hostName host_name [-isDefault] [-dmgrHost host_name] [-dmgrPort SOAP port] [-startingPort starting_port | -portsFile file_path] [-debug]
# ./wasprofile.sh -getName -profilePath profile_path [-debug]
# ./wasprofile.sh -getPath -profileName profile_name [-debug]
# ./wasprofile.sh -validateRegistry [-debug]
# ./wasprofile.sh -validateAndUpdateRegistry [-backup file_name] [-debug]
# ./wasprofile.sh -augment -profileName profile_name -templatePath fully_qualified_template_path
# ./wasprofile.sh -unaugment -profileName profile_name
# ./wasprofile.bat -help # ./wasprofile.bat -augment -help # ./wasprofile.bat -create -help # ./wasprofile.bat -create -templatePath fully_qualified_path¥dmgr -help # ./wasprofile.bat -create -templatePath fully_qualified_path¥default -help # ./wasprofile.bat -create -templatePath fully_qualified_path¥managed -help # ./wasprofile.bat -delete -help # ./wasprofile.bat -getName -help # ./wasprofile.bat -getPath -help # ./wasprofile.bat -unaugment -help # ./wasprofile.bat -validateRegistry -help # ./wasprofile.bat -validateAndUpdateRegistry -help
# ./wasprofile.bat -listProfiles [-debug]
# ./wasprofile.bat -delete -profileName profile_name | -profilePath profile_path [-debug]
# ./wasprofile.bat -create -profileName profile_name -profilePath fully_qualified_profile_path -templatePath template_path -nodeName node_name -cellName cell_name -hostName host_name [-isDefault] [-dmgrHost host_name] [-dmgrPort SOAP port] [-startingPort starting_port | -portsFile file_path] [-winserviceCheck true | false] [-winserviceAccountType specified_user | localsystem] [-winserviceUserName your_user_name] [-winservicePassword your_password] [-winserviceStartupType manual | automatic | disabled] [-debug]
-startingPort パラメーターを指定しない場合、プロファイル作成ツールは、serverindex.xml ファイルで指定したデフォルトのポート設定を使用します。
# ./wasprofile.bat -getName -profilePath fully_qualified_profile_path [-debug]
# ./wasprofile.bat -getPath -profileName profile_name [-debug]
# ./wasprofile.bat -validateRegistry [-debug]
# ./wasprofile.bat -validateAndUpdateRegistry [-backup file_name] [-debug]
# ./wasprofile.bat -augment -profileName profile_name -templatePath fully_qualified_template_path
# ./wasprofile.bat -unaugment -profileName profile_name
プロファイルの作成の具体的な例については、例: プロファイルを作成するコマンドの使用 セクションを参照してください。
拡張アクションが呼び出されると、wasprofile コマンドは、指定したテンプレート・パスにある actionRegistry.xml ファイルにアクセスしようとします。 アクション・レジストリー・ファイルの Config アクション・スタンザで定義された操作は、指定したプロファイルに適用されます。
-templatePath に完全修飾ファイル・パスを指定します。-templatePath パラメーターに相対ファイル・パスを指定すると、指定したプロファイルが完全には拡張されなくなります。
unaugment パラメーターも参照してください。
デプロイメント・マネージャー・セルにカスタム・プロファイルまたはスタンドアロン・プロファイルを統合することを予定している場合であっても、固有の名前を使用します。 統合によってデプロイメント・マネージャー・セルのノード部分を作成する前に、固有のセル名を指定する必要があります。 セル名は、同じ物理マシンまたはマシンのクラスター (SYSPLEX など) 上の、製品が稼働する環境では、どこでも固有でなければなりません。またセル名は、エンティティー間のネットワーク接続が、セル間で、または各セルとの通信が必要なクライアントから要求されるような環境では、どこでも固有でなければなりません。更に、セル名のネーム・スペースが統合されるような場合も、セル名が固有である必要があります。セル名が固有でないと、javax.naming.NameNotFoundException のような症状が起こり、固有名を持つセルの作成が必要になる可能性があります。
プロファイルを削除する前に作成した拡張の拡張解除を行います。
ディレクトリーは、削除することも残すことも可能です。 ただし、profile_dir/logs ディレクトリーには、プロファイルのアンインストールに関する情報が含まれます。 例えば、アンインストール・プロシージャー中に問題が起こったときにその原因を判別するために、_nodeuninst.log ファイルを残しておくことができます。
パラメーターを削除しても、拡張解除は自動実行されません。 プロファイルを削除する前に拡張解除を手動で行う必要があります。
ホスト名は、デプロイメント・マネージャー・マシンのロングまたはショートの DNS 名か、 IP アドレスです。
このオプション・パラメーターを指定すると、カスタム・プロファイルの作成時に、wasprofile コマンドが、デプロイメント・マネージャー・セルへのカスタム・ノードの統合を試みます。 デプロイメント・マネージャー・プロファイルまたはアプリケーション・サーバー・ プロファイルを作成する際には、このパラメーターは無視されます。
デプロイメント・マネージャーが使用不可の場合の統合
セキュリティーが使用可能になっているなどの理由で、デプロイメント・マネージャーが稼働していないか、または使用不可である場合に、 カスタム・ノードを統合すると、ログのインストール・インディケーターは INSTCONFFAIL となり、完全な失敗を示します。 結果として、カスタム・プロファイルは使用することができません。 同じプロファイル名で他のカスタム・プロファイルを作成する前に、 カスタム・プロファイル・ディレクトリーをプロファイル・リポジトリー (プロファイル・ インストール・ルート・ディレクトリー) から移動する必要があります。
セキュリティーが使用可能になっていたり、 デフォルトの JMX コネクター・タイプが変更されていたりする場合は 、wasprofile コマンドで統合することができません。 代わりに 、addNode コマンドを使用してください。
セキュリティーが使用可能になっていたり、 デフォルトの JMX コネクター・タイプが変更されていたりする場合は 、wasprofile コマンドで統合することができません。 代わりに 、addNode コマンドを使用してください。
-startingPort パラメーターを 使用する場合は、このパラメーターを使用しないでください。
-profilePath C:¥IBM¥WebSphere¥AppServer¥profiles¥profile01
完全修飾パスにスペースが含まれている場合は、
その値を引用符で囲んでください。
このパラメーターは、-portsFile パラメーターと共に使用しないでください。
profileTemplates ディレクトリー内には、さまざまなプロファイル・タイプに対応し、インストールされた製品のタイプに応じて異なる、さまざまなディレクトリーがあります。
プロファイル・ディレクトリーは、-templatePath オプションを使用しているときに指定するパスです。
インストール・ルートの外にプロファイル・テンプレートがある場合、それらを指定できます。
相対パスを指定した場合、指定されたテンプレートの場所は、デフォルトで app_server_root/profileTemplates ディレクトリーに設定されます。
例えば、以下の対の仕様はそれぞれ同じテンプレート・パスを指しています。
-templatePath /usr/WebSphere/AppServer/profileTemplates/default
-templatePath /opt/IBM/WebSphere/AppServer/profileTemplates/default
-templatePath C:¥Program Files¥IBM¥WebSphere¥AppServer¥profileTemplates¥default
縮小アクションが呼び出されると、wasprofile は、拡張コマンドで指定されたテンプレート・パスにある deleteRegistry.xml ファイルにアクセスしようとします。 削除レジストリー・ファイルの Config アクション・スタンザで定義された操作は、指定したプロファイルに適用されます。
拡張パラメーターも参照してください。
Windows サービスについての詳細は 、WASService コマンド を参照してください。
ユース・ケースは、ツールが使用される共通タスクの説明です。
wasprofile.sh -create
-profileName shasti
-profilePath ~/shasti/WebSphere
-templatePath /opt/IBM/WebSphere/AppServer/profileTemplates/dmgr
-cellName shaix1
-hostName planetaix
-nodeName dmgr1
Express 製品または基本製品のインストールでは、デプロイメント・マネージャー・テンプレートが存在しないので、 コマンドは何も作成しません。
Network Deployment 製品のインストールでは、このコマンドは、dmgr1 というノード名を持つロケーション ~/shasti/WebSphere にある shaix1 という名前のセル内に、shasti という名前のデプロイメント・マネージャー・ プロファイルを作成します。
wasprofile.sh -create
-profileName shasti
-profilePath G:¥shasti¥WebSphere
-templatePath C:¥IBM¥WebSphere¥AppServer¥profileTemplates¥dmgr
-cellName shwindows1
-hostName planetnt
-nodeName dmgr1
Network Deployment 製品のインストールでは、このコマンドは、dmgr1 というノード名を持つロケーション G:¥shasti¥WebSphere にある shwindows1 という名前のセル内に、shasti という名前のデプロイメント・マネージャー・プロファイルを作成します。
wasprofile.sh -delete
-profileName shasti
-startingPort パラメーターを指定しないで wasprofile ツールを使用すると、 ツールは app_server_root/profileTemplates/profile_type /actions/portsUpdate/bin/portdef.props ファイルを 使用して初期ポートを設定します。
wasprofile.bat -create -profileName Wow_Profile -profilePath profile_root -templatePath app_server_root¥profileTemplates¥default -nodeName Wow_node -cellName Wow_cell -hostName lorriemb -portsFile C:¥temp¥ports¥portdef.props
WC_defaulthost=39080 WC_adminhost=39060 WC_defaulthost_secure=39443 WC_adminhost_secure=39043 BOOTSTRAP_ADDRESS=32809 SOAP_CONNECTOR_ADDRESS=38880 SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=39401 CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=39403 CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=39402 ORB_LISTENER_ADDRESS=39100 DCS_UNICAST_ADDRESS=39353 SIB_ENDPOINT_ADDRESS=37276 SIB_ENDPOINT_SECURE_ADDRESS=37286 SIB_MQ_ENDPOINT_ADDRESS=35558 SIB_MQ_ENDPOINT_SECURE_ADDRESS=35578
<?xml version="1.0" encoding="UTF-8"?> <serverindex:ServerIndex xmi:version="2.0" xmlns:xmi="http://www.omg.org/XMI" ... <specialEndpoints xmi:id="NamedEndPoint_..." endPointName="BOOTSTRAP_ADDRESS"> <endPoint xmi:id="EndPoint_..." host="lorriemb" port="32809"/> </specialEndpoints> <specialEndpoints xmi:id="NamedEndPoint_..." endPointName="SOAP_CONNECTOR_ADDRESS"> <endPoint xmi:id="EndPoint_..." host="lorriemb" port="38880"/> </specialEndpoints> <specialEndpoints xmi:id="NamedEndPoint_..." endPointName="SAS_SSL_SERVERAUTH_LISTENER_ADDRESS"> <endPoint xmi:id="EndPoint_..." host="lorriemb" port="39401"/> </specialEndpoints> <specialEndpoints xmi:id="NamedEndPoint_..." endPointName="CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS"> <endPoint xmi:id="EndPoint_..." host="lorriemb" port="39403"/> </specialEndpoints> <specialEndpoints xmi:id="NamedEndPoint_..." endPointName="CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS"> <endPoint xmi:id="EndPoint_..." host="lorriemb" port="39402"/> </specialEndpoints> <specialEndpoints xmi:id="NamedEndPoint_..." endPointName="WC_adminhost"> <endPoint xmi:id="EndPoint_..." host="*" port="39060"/> </specialEndpoints> <specialEndpoints xmi:id="NamedEndPoint_..." endPointName="WC_defaulthost"> <endPoint xmi:id="EndPoint_..." host="*" port="39080"/> </specialEndpoints> <specialEndpoints xmi:id="NamedEndPoint_..." endPointName="DCS_UNICAST_ADDRESS"> <endPoint xmi:id="EndPoint_..." host="lorriemb" port="39353"/> </specialEndpoints> <specialEndpoints xmi:id="NamedEndPoint_..." endPointName="WC_adminhost_secure"> <endPoint xmi:id="EndPoint_..." host="*" port="39043"/> </specialEndpoints> <specialEndpoints xmi:id="NamedEndPoint_..." endPointName="WC_defaulthost_secure"> <endPoint xmi:id="EndPoint_..." host="*" port="39443"/> </specialEndpoints> <specialEndpoints xmi:id="NamedEndPoint_..." endPointName="SIB_ENDPOINT_ADDRESS"> <endPoint xmi:id="EndPoint_..." host="*" port="37276"/> </specialEndpoints> <specialEndpoints xmi:id="NamedEndPoint_..." endPointName="SIB_ENDPOINT_SECURE_ADDRESS"> <endPoint xmi:id="EndPoint_..." host="*" port="37286"/> </specialEndpoints> <specialEndpoints xmi:id="NamedEndPoint_..." endPointName="SIB_MQ_ENDPOINT_ADDRESS"> <endPoint xmi:id="EndPoint_..." host="*" port="35558"/> </specialEndpoints> <specialEndpoints xmi:id="NamedEndPoint_..." endPointName="SIB_MQ_ENDPOINT_SECURE_ADDRESS"> <endPoint xmi:id="EndPoint_..." host="*" port="35578"/> </specialEndpoints> <specialEndpoints xmi:id="NamedEndPoint_..." endPointName="ORB_LISTENER_ADDRESS"> <endPoint xmi:id="EndPoint_..." host="lorriemb" port="39100"/> </specialEndpoints> </serverEntries> </serverindex:ServerIndex>
wasprofile コマンドにより、 現行の portdefs.props ファイルのコピーが、profile_root¥logs ディレクトリー内に作成されます。
startingPort パラメーターを使用する場合は、portsFile パラメータ ーを使用しないでください。 この 2 つのパラメーターは互いに排他的です。
wasprofile コマンドは、-startingPort パラメーターを使用してコマンド行で指定する開始ポート値に基づいて、ポート番号を割り当てることができます。 このツールは、開始ポート番号値から順番にポート番号を割り当てます。
ポート割り当ては、任意の順序で行われます。割り当てを予測することはできません。
例えば、-startingPort 20002 と指定して作成されたポートは、次の例のように表示されます。
アプリケーション・サーバー・プロファイルに割り当てられたポート
WC_defaulthost=20002 WC_adminhost=20003 WC_defaulthost_secure=20004 WC_adminhost_secure=20005 BOOTSTRAP_ADDRESS=20006 SOAP_CONNECTOR_ADDRESS=20007 SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20008 CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20009 CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20010 ORB_LISTENER_ADDRESS=20011 DCS_UNICAST_ADDRESS=20012 SIB_ENDPOINT_ADDRESS=20013 SIB_ENDPOINT_SECURE_ADDRESS=20014 SIB_MQ_ENDPOINT_ADDRESS=20015 SIB_MQ_ENDPOINT_SECURE_ADDRESS=20016
WC_defaulthost=20002 WC_adminhost=20003 WC_defaulthost_secure=20004 WC_adminhost_secure=20005 BOOTSTRAP_ADDRESS=20006 SOAP_CONNECTOR_ADDRESS=20007 SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20008 CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20009 CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20010 ORB_LISTENER_ADDRESS=20011 CELL_DISCOVERY_ADDRESS=20012 DCS_UNICAST_ADDRESS=20013
CELL_DISCOVERY_ADDRESS=20010 BOOTSTRAP_ADDRESS=20004 DRS_CLIENT_ADDRESS=7989 SOAP_CONNECTOR_ADDRESS=20005 ORB_LISTENER_ADDRESS=20009 SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20006 CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20008 CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20007 WC_adminhost=20002 DCS_UNICAST_ADDRESS=20011 WC_adminhost_secure=20003
wasprofile.bat -create -profileName shasti -profilePath profile_root -templatePath template_path -nodeName W2K03 -cellName W2K03_Cell01 -hostName planetnt -startingPort 20002
以下の例は、wasprofile コマンドを使用してプロファイルを作成する方法を示しています。
以下の例のいずれかのコマンドを 1 行で発行します。 それぞれの例は、分かりやすくするために複数の行でコマンドを表示しています。
app_server_root/bin/manageprofiles.sh -create -profileName Dmgr001 -profilePath profile_root -templatePath app_server_root/profileTemplates/dmgr -nodeName Dmgr001Node -cellName Dmgr001NodeCell -hostName localhost -isDefault -startingPort 20000
app_server_root¥bin¥manageprofiles.bat -create -profileName Dmgr001 -profilePath profile_root -templatePath app_server_root¥profileTemplates¥dmgr -nodeName Dmgr001Node -cellName Dmgr001NodeCell -hostName localhost -isDefault -startingPort 20000
カスタム・プロファイルを統合して、デプロイメント・マネージャーでプロファイルをカスタマイズします。
c:¥WebSphere¥AppServer¥bin wasprofile -create -profileName Custom01 -profilePath profile_root -templateParh app_server_root¥profileTemplates¥managed -nodeName CustomNode01 -cellName CustomNodeCell01 -hostName myhost.mycity.mycompany.com -isDefault -dmgrHost myhost.mycity.mycompany.com -dmgrPort 8879 -startingPort 22000
app_server_root/bin/manageprofiles.sh -create -profileName Custom01 -profilePath profile_root -templatePath app_server_root/profileTemplates/managed -nodeName Custom01Node -cellName Custom01Cell -hostName myhost.mycity.mycompany.com -isDefault -startingPort 22000
app_server_root¥bin wasprofile -create -profileName Default01 -profilePath profile_root -templatePath app_server_root¥profileTemplates¥default -nodeName Default01Node -cellName Default01Cell -hostName myhost.mycity.mycompany.com -isDefault false -winserviceCheck true -winserviceAccountType user -winserviceUserName my_user_id -winservicePassword my_password -winserviceStartupType manual -startingPort 21000
app_server_root/bin/manageprofiles.sh -create -profileName Default01 -profilePath profile_root -templatePath app_server_root/profileTemplates/default -nodeName Default01Node -cellName Default01Cell -hostName myhost.mycity.mycompany.com -isDefault -startingPort 21000