[Windows][Linux]

WASService コマンド

WASService コマンド行ツールを使用すると、 Linux および Windows オペレーティング・システム上での本製品の Java™ プロセス用サービスを作成することができます。

WebSphere® Application Server Java プロセス用のサービスを 作成することができます。潜在的なサービスには、以下のサーバー・プロセスが含まれます。
  • アプリケーション・サーバー・ノードでのデフォルトの server1 プロセス
  • アプリケーション・サーバー・ノードで作成するアプリケーション・サーバー・プロセス
  • デプロイメント・マネージャー・セルの一部であるアプリケー ション・サーバー・ノード上の nodeagent プロセス。
  • デプロイメント・マネージャー・プロセス、dmgr
[Windows]注: 統合ノードまたは管理対象ノードの一部であるアプリケーション・サーバーは、Windows サービスとして追加しないでください。フェデレーテッド・ノードを管理するにはノード・エージェントを使用してください。
トラブルの回避 (Avoid trouble) トラブルの回避 (Avoid trouble): WASService コマンドの代わりとして、WASService コマンドを補足し、発生する可能性がある構成エラーを削減する WASServiceHelper ユーティリティーを使用できます。詳しくは、WASServiceHelper を使用した Windows サービスの作成に関する資料を参照してください。gotcha
[Windows]Microsoft Windows オペレーティング・システム上で この機能をセットアップして実行するには、ユーザーが管理者グループに属しており、以下の拡張ユーザー権限を備えている必要があります。
  • オペレーティング・システムの一部として機能
  • サービスとしてログオンする

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

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

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

コマンド構文

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

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

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

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

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

[Linux]
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]
        
[Linux]注: WebSphere Application Server バージョン 7.0 以降の場合、wasservice.sh を指定する際にユーザー ID の接頭部として「@」記号を使用しないでください。wasservice.sh のユーザー ID で接頭部として「@」記号を使用できるのは、WebSphere Application Server バージョン 6.1 の場合のみです。

バージョン 7.0 以降では、-userid @myuser を使用して wasservice.sh を指定してはなりません。

[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]
      
トラブルの回避 (Avoid trouble) トラブルの回避 (Avoid trouble): -logroot パラメーターの指定はオプションですが、このオプション・パラメーターを含めることをお勧めします。 場合によっては、このオプション・パラメーターを指定しないと、アプリケーション・サーバーが -logroot パラメーターを使用してサービスの作成を試行していることを示すエラーがイベント・ログに表示される場合があります。gotcha

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

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

[Linux]
wasservice.sh -remove service_name
[Windows]
WASService.exe -remove service_name

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

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

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

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

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

[Linux]
wasservice.sh -status service_name
[Windows]
WASService.exe -status service_name

必須パラメーター

このコマンドには、以下のパラメーターが必要です。

-profilePath server_profile_directory
このオプションを使用して、サーバー・プロセスを定義するプロファイルのディレクトリー・パスを指定します。
-serverName server_name
このオプションを使用して、サービスが制御するサーバーを識別します。

オプション・パラメーター

以下のパラメーターは、このコマンドのオプション・パラメーターです。

-add service_name
このオプションを使用して、「service_name」という名前のサービスを作成するか、 既存のサービスを更新します。この構文はどちらの場合も同じです。
-configRoot configuration_repository_directory (Windows のみ)
このオプションを使用して、WebSphere Application Server 製品のインストール・ルート・ディレクトリーの構成ディレクトリーを識別します。
-encodeParams service_name (Windows のみ)
このオプションを使用して、サービスに -startArgs および -stopArgs を強制的にエンコードさせ、レジストリーの編集によって引数 が判別できないようにします。 引数のないコマンド行に -encodeParams を加えて、-add パラメーターの付いたサービスを作成する場合に、このパラメーターを使用します。
[Windows]または、既存のサービスのパラメーターをエンコードします。
WASService -encodeParams service_name
-logFile service_log_file (Windows のみ)
このオプションを使用して、WASService コマンドがアクティビティーを記録するときに使用する ログ・ファイルを識別します。
トラブルの回避 (Avoid trouble) トラブルの回避 (Avoid trouble): サービス・ログ・ファイルは固有パスのある完全修飾名として指定するよう注意してください。システムに複数のインスタンスがある場合、この修飾がないと、予期しない結果になり、WASService は初期化がいつ完了したのかを判別できません。gotcha
-logRoot server_log_directory (Windows のみ)
このオプションを使用して、プロファイルのサーバー・ログ・ディレクトリーを識別します。 WASService コマンドは server_name.pid という名前のファイルを 見つけて、サーバーが稼働しているかどうかを決定します。
-remove service_name
このオプションを使用して、指定されたサービスを削除します。
-restart true | false (Windows のみ)
このパラメーターを使用して、サービスが失敗した場合に既存のサービスを自動的に再始動するかどうかを指定します。値を false に設定していると、既存のサービスは自動で始動しません。デフォルトで、この再始動の動作は true に設定されているため、既存のサービスが失敗すると、そのサービスは自動的に再始動します。
-start service_name [optional startServer.bat parameters]
このオプションを使用して、既存のサービスを開始します。
-startArgs additional_start_arguments
このページを使用して、追加のパラメーターを識別します。
-startType automatic | manual | disabled (Windows のみ)
このオプションを使用して、新しいサービスの始動タイプを定義します。自動始動タイプは、システムが始動したと き、またはサービスが初めて呼び出されたときに自動的に始動します。 オペレーティング・システムがサービスを読み込み、利用できるようにす る前に、手動のサービスを始動する必要があります。 開始タイプを変更する前に使用不可のサービスを始動することはできま せん。 デフォルトでは、このパラメーターの値は manual に設定されます。
-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
このオプションを使用して、製品のインストール・ルート・ディレクトリーを識別します。
注: 以下のパラメーターは、"Windows のみ"のパラメーターです。
  • -configRoot
  • -encodeParams
  • -logFile
  • -logRoot
  • -restart
  • -startType
Linux でエラーのロギングおよびスローを行う代替手段は、システムの標準の sysvinit を使用して通常の startServer.sh スクリプトを実行する方法です。
注意:
認識されないパラメーターは無視されます。

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

プロファイル管理ツール が作成できるサービスの名前は 以下のとおりです。
デプロイメント・マネージャー
IBM WebSphere Application Server V9.x - node_name_of_the_deployment_manager_node
アプリケーション・サーバー
IBM WebSphere Application Server V9.x - node_name_of_the_server1_node
カスタム・プロファイル
ノードの統合とアプリケーション・サーバーの作成が終わると、IBM WebSphere Application Server V9.x - node_name_of_the_managed_node というサービスを作成できます。

カスタム・プロファイルを作成した後、ノードを統 合してノード上にノード・エージェント・サーバーを作成する必要がありま す。 デプロイメント・マネージャーの管理コンソールを使用してノード上にアプリケーション・サーバー・プロセスを作成することもできます。 ノード・エージェント・サーバー・プロセス用に Windows サービスを作成できます。

デプロイメント・マネージャー・セルにアプリケーション・サーバー・ノードを追加した後に ノード・エージェント・サーバーも作成されます。 後述するように、ノード・エージェント・サーバー・プロセス用にサービスを作成することができます。

サービス・パネルの表示

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

[Windows]

デプロイメント・マネージャー・サービスの作成

この例では、dmgr プロセスを開始する IBM® WebSphere Application Server V9.x - name_of_the_deployment_manager_service と呼ばれるサービスを作成します。

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

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

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

「スタート」>「設定」>「コントロール パネル」>「管理ツール」>「サービス」とクリックして、 新しいサービスを操作します。

ノード・エージェント・サービスの作成

この例では、ノード・エージェント・サーバー・プロセスを開始する IBM WebSphere Application Server V9.x - name_of_the_node_agent_service と呼ばれるサービスを作成します。

WASService -add name_of_the_node_agent_service
   -servername node_agent_server_name
   -profilePath profile_root
   -wasHome app_server_root
   -logFile WS_startNode.log
   -logRoot profile_root¥logs¥node_agent_server_name
   -restart true
各部の意味は、次のとおりです。
  • name_of_the_node_agent_service は、 サービスに指定したい名前です。
  • profile_root は、ファイル・システム上でノード・エージェントがある場所です。
  • node_agent_server_name は、ノード・エージェントの 名前です。

    これは単純に nodeagent にするのが一般的です。

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

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

アプリケーション・サーバー・サービスの作成

この例では、アプリケーション・サーバー・プロセスを開始する IBM WebSphere Application Server V9.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 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 V9.x - name_of_the_application_server_service service successfully added.

既存のアプリケーション・サーバー・サービスの更新

Windows オペレーティング・システムの場合のこの例では、additional_stop_arguments およびユーザー名とパスワードを使用して IBM WebSphere Application Server V9.x - Server2 Service と呼ばれる既存のサービスを更新します。パラメーターは、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 サービスを開始することによって実行されます。

nodeagent プロセスの Windows サービスを作成した後に startNode コマンド または stopNode コマンドを実行すると、 以下の例と同様のメッセージが表示されます。

nodeagent は Windows サービスとして実行すると登録されているの
で、このサーバーを開始または停止する要求は、関連する Windows サービス
を開始または停止することによって実行されます。
ログ・ファイルを調べて、このコマンドに関連するメッセージを表示します。

デプロイメント・マネージャーの Windows サービスを作成した後に startManager コマンド または stopManager コマンドを実行すると、 以下の例と同様のメッセージが表示されます。

dmgr は Windows サービスとして実行すると登録されているの
で、このサーバーを開始または停止する要求は、関連する Windows サービス
を開始または停止することによって実行されます。
ログ・ファイルを調べて、このコマンドに関連するメッセージを表示します。
トラブルの回避 (Avoid trouble) トラブルの回避 (Avoid trouble): Windows で WebSphere サービスの作成および削除を行うと、混乱を招き、エラーが発生しやすくなる可能性があります。エラー診断におけるヘルプについて詳しくは、WASServiceCmd を使用した WebSphere Application Server の Windows サービスの作成に関する情報を参照してください。gotcha

トピックのタイプを示すアイコン 参照トピック



タイム・スタンプ・アイコン 最終更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rins_wasservice
ファイル名:rins_wasservice.html