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] [-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] [-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 パラメーターも参照してください。
これは、WebSphere Application Server のオプション・パラメーターです。
このパラメーターを省略すると、デフォルトのセル名が割り当てられます。
プロファイルを削除する前に作成した拡張の拡張解除を行います。
ディレクトリーは、削除することも残すことも可能です。 ただし、profile_dir/logs ディレクトリーには、プロファイルのアンインストールに関する情報が含まれます。 例えば、アンインストール・プロシージャー中に問題が起こったときにその原因を判別するために、_nodeuninst.log ファイルを残しておくことができます。
パラメーターを削除しても、拡張解除は自動実行されません。 プロファイルを削除する前に拡張解除を手動で行う必要があります。
-startingPort パラメーターを 使用する場合は、このパラメーターを使用しないでください。
完全修飾パスにスペースが含まれている場合は、
その値を引用符で囲んでください。
このパラメーターは、-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 -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
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 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