WebSphere Application Server, Version 6.0.x   
             オペレーティング・システム: AIX , HP-UX, Linux, Solaris, Windows

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

WASService コマンド

WASService コマンド行ツールを使用すると、 製品の Java プロセス用のサービスを作成することができます。

WebSphere Application Server Java プロセス用のサービスを 作成することができます。潜在的なサービスには、以下のサーバー・プロセスが含まれます。
  • アプリケーション・サーバー・ノードでのデフォルトの server1 プロセス
  • アプリケーション・サーバー・ノードで作成するアプリケーション・サーバー・プロセス

インストール・ウィザードで作成したサービスは、 アンインストーラー・プログラムで除去できます。WASService コマンドを 使用してご自身でサービスを作成する場合は、そのサービスが有効でなくなった際には、 お客様の責任において除去してください。アンインストーラー・プログラムは、お客様が WASService コマンドで作成したサービスは除去しません。

[Windows] Microsoft Windows オペレーティング・システムで この機能のセットアップと実行を行うには、ユーザーが管理者グループに属しており、以下の拡張ユーザー権限を備えている必要があります。
  • オペレーティング・システムの一部としてアクションを行う
  • サービスとしてログオンする

コマンド・ファイルのロケーション

[AIX] [HP-UX] [Linux] [Solaris] wasservice.sh コマンド・ファイルは、 app_server_root¥bin ディレクトリーにあります。

[Windows] WASService.exe コマンド・ファイルは、 app_server_root¥bin ディレクトリーにあります。

コマンド構文

既存のサービスを開始するコマンド構文

コマンド構文は次のようになります。

[AIX] [HP-UX] [Linux] [Solaris]
wasservice.sh -start service_name [optional startServer.bat parameters]
[Windows]
WASService.exe -start service_name [optional startServer.bat parameters]

サービスの作成または既存のサービスの更新を行う コマンド構文

コマンド構文は次のようになります。

[AIX] [HP-UX] [Linux] [Solaris]
wasservice.sh -add service_name
   -serverName  server_name   -profilePath server_profile_directory
   [-wasHome  app_server_root]
   [-startArgs additional_start_arguments]
   [-stopArgs additional_stop_arguments]
   [-userid user_id -password password]
        
[Windows]
WASService.exe -add service_name
   -serverName  server_name   -profilePath server_profile_directory
   [-wasHome  app_server_root]
   [-configRoot configuration_repository_directory]
   [-startArgs additional_start_arguments]
   [-stopArgs additional_stop_arguments]
   [-userid user_id -password password]
   [-logFile service_log_file]
   [-logRoot server_log_directory]
   [-restart true | false]
   		[-startType automatic | manual | disabled]
      

サービスを削除するコマンド構文

コマンド構文は次のようになります。

[AIX] [HP-UX] [Linux] [Solaris]
wasservice.sh -remove service_name
[Windows]
WASService.exe -remove service_name

サービスの実行を停止するコマンド構文

コマンド構文は次のようになります。

[AIX] [HP-UX] [Linux] [Solaris]
wasservice.sh -stop service_name [optional stopServer.bat parameters]
[Windows]
WASService.exe -stop service_name [optional stopServer.bat parameters]

サービス状況を検索するコマンド構文

コマンド構文は次のようになります。

[AIX] [HP-UX] [Linux] [Solaris]
wasservice.sh -status service_name
[Windows]
WASService.exe -status service_name

パラメーターをエンコードするためのコマンド構文 [Windows]

コマンド構文は次のようになります。

WASService.exe -encodeParams service_name

パラメーター

サポートされている引数は以下のとおりです。

-add service_name
service_name という名前のサービスを作成するか、 既存のサービスを更新します。この構文はどちらの場合も同じです。
-configRoot configuration_repository_directory
WebSphere Application Server 製品のインストール・ルート・ディレクトリーの構成ディレクトリーを指定するパラメーター (オプション)。
-encodeParams service_name
サービスに対して -startArgs および -stopArgs を強制的にエンコードさせ、レジストリーの編集によって引数 が決定できないようにするオプション・パラメーター。 引数のないコマンド行に -encodeParams を加えて、-add パラメーターの付いたサービスを作成する場合に、このパラメーターを使用します。
[Windows] または、既存のサービスのパラメーターをエンコードします。
WASService -encodeParams service_name
-logFile service_log_file
WASService コマンドがアクティビティーを記録するときに使用する ログ・ファイルを指定するパラメーター (オプション)。
-logRoot server_log_directory
プロファイルのサーバー・ログ・ディレクトリーを識別する必要パラ メーターです。 WASService コマンドは server_name.pid という名前のファイルを 探して、サーバーが稼働しているかどうかを決定します。
-profilePath server_profile_directory
サーバー・プロセスを定義するプロファイルのディレクトリー・パスを指定します。
-remove service_name
指定したサービスを削除します。
-restart true | false
true に設定されている場合は、 既存のサービスで障害が発生した場合に自動的にそのサービスを再始動します。
-serverName server_name
サービスが制御するサーバーを指定します。
-start service_name [optional startServer.bat parameters]
既存のサービスを始動します。
-startArgs additional_start_arguments
パラメーターを追加指定するパラメーター (オプション)。
-startType automatic | manual | disabled
新しいサービスの始動タイプを定義します。自動始動タイプは、システムが始動したと き、またはサービスが初めて呼び出されたときに自動的に始動します。 オペレーティング・システムがサービスを読み込み、利用できるようにす る前に、手動のサービスを始動する必要があります。 開始タイプを変更する前に使用不可のサービスを始動することはできま せん。
-status service_name
サービスが実行中か、停止しているかなど、 サービスの現在の状況を戻します。
-stop service_name [optional stopServer.bat parameters]
指定したサービスを停止します。
-stopArgs additional_stop_arguments
パラメーターを追加指定するパラメーター (オプション)。
-userid user_id -password password
それを使って Windows サービスを実行する、特権ユーザー ID および パスワードを指定するオプショナル・パラメーター。
-wasHome app_server_root
製品のインストール・ルート・ディレクトリーを指定する、オプション・パラメーター。

ウィザードによって作成されるサービスのデフォルト名

インストール・ウィザードによって作成される サービスの名前は、IBM WebSphere Application Server V6.x - DefaultNode です。

サービス・パネルの表示

サービスを表示するには、コントロール パネルを開き、「管理ツール」 >「サービス」をクリックします。情報を表示するにはサービスを選択します。サービスを右マウス・ボタンでクリックして、「プロパティー」をクリックします。4 つのタブが情報および機 能を提供します。例えば、「一般」 タブの「Setup type」フィールドを選択して、 セットアップ・タイプを変更します。

[Windows]

この例では、アプリケーション・サーバー・プロセスを開始する IBM WebSphere Application Server V6.x - name_of_the_application_server_service というサービスを作成します。

WASService -add name_of_the_application_server_service
   -servername application_server_name
   -profilePath profile_root
   -wasHome app_server_root
   -logFile profile_root¥logs¥WS_startServer.log
   -logRoot profile_root¥logs¥application_server_name
   -restart true
各部の意味は、次のとおりです。
  • name_of_the_application_server_service は、 サービスに指定したい名前です。
  • application_server_name は、 ご使用のサーバーの名前です。

コマンドを入力した後、次の例と 同様のメッセージがコマンド・ウィンドウに表示されます。

Adding Service: name_of_the_application_server_service
  Config Root: profile_root¥config
  Server Name: application_server_name
  Profile Path: profile_root
  Was Home: app_server_root
  Start Args:
  Restart: 1
IBM WebSphere Application Server V6.x - name_of_the_application_server_service service successfully added.

Windows オペレーティング・システムのこの例では、別の stop 引数、ユーザー名、およびパスワードを持つ IBM WebSphere Application Server V6.x - Server2 Service という既存のサービスを更新します。 セキュリティーが使用可能になっているアプリケーション・サーバーを停止するためには stopServer コマンドではユーザー名とパスワードは必要ありません。 パラメーターは、Windows サービスがシステムをシャットダウンするために使用するスクリプトに自動的に渡されます。

WASService -add "Server2 Service"
   -servername server2
   -profilePath profile_root
   -logRoot profile_root¥logs¥server2
   -stopArgs "-username user_name  -password password"
   -encodeParams
[Windows]

Windows サービスを作成した後のサーバー・プロセスの開始と停止

この Windows オペレーティング・システムの例では、server1 用の Windows サービスを作成した後に startServer server1 コマンドまたは stopServer server1 コマンドを実行すると、 以下の例と同様のメッセージが表示されます。

server1 は Windows サービスとして実行すると登録されているので
、このサーバーを開始する要求は、関連する Windows サービスを開始することによって実行されます。



参照トピック    

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

最終更新: Jan 22, 2008 12:07:38 AM EST
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/index.jsp?topic=/com.ibm.websphere.base.doc/info/aes/ae/rins_wasservice.html