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

![[Windows]](../images/windows.gif)
コマンド・ファイルのロケーション
wasservice.sh コマンド・ファイルは、app_server_root¥bin ディレクトリーにあります。
WASService.exe コマンド・ファイルは、app_server_root¥bin ディレクトリーにあります。
コマンド構文
既存のサービスを開始するコマンド構文
コマンド構文は次のようになります。
![[Linux]](../images/linux.gif)
wasservice.sh -start service_name [optional startServer.bat parameters]
![[Windows]](../images/windows.gif)
WASService.exe -start service_name [optional startServer.bat parameters]
サービスの作成または既存のサービスの更新を行う コマンド構文
コマンド構文は次のようになります。
![[Linux]](../images/linux.gif)
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]](../images/linux.gif)
バージョン 7.0 以降では、-userid @myuser を使用して wasservice.sh を指定してはなりません。
![[Windows]](../images/windows.gif)
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]

サービスを削除するコマンド構文
コマンド構文は次のようになります。
![[Linux]](../images/linux.gif)
wasservice.sh -remove service_name
![[Windows]](../images/windows.gif)
WASService.exe -remove service_name
サービスの実行を停止するコマンド構文
コマンド構文は次のようになります。
![[Linux]](../images/linux.gif)
wasservice.sh -stop service_name [optional stopServer.bat parameters]
![[Windows]](../images/windows.gif)
WASService.exe -stop service_name [optional stopServer.bat parameters]
サービス状況を検索するコマンド構文
コマンド構文は次のようになります。
![[Linux]](../images/linux.gif)
wasservice.sh -status service_name
![[Windows]](../images/windows.gif)
WASService.exe -status service_name
必須パラメーター
このコマンドには、以下のパラメーターが必要です。
- このオプションを使用して、サーバー・プロセスを定義するプロファイルのディレクトリー・パスを指定します。
- このオプションを使用して、サービスが制御するサーバーを識別します。
オプション・パラメーター
以下のパラメーターは、このコマンドのオプション・パラメーターです。
- -add service_name
- このオプションを使用して、「service_name」という名前のサービスを作成するか、 既存のサービスを更新します。この構文はどちらの場合も同じです。
- -configRoot configuration_repository_directory (Windows のみ)
- このオプションを使用して、WebSphere Application Server 製品のインストール・ルート・ディレクトリーの構成ディレクトリーを識別します。
- -encodeParams service_name (Windows のみ)
- このオプションを使用して、サービスに -startArgs および
-stopArgs を強制的にエンコードさせ、レジストリーの編集によって引数
が判別できないようにします。
引数のないコマンド行に -encodeParams を加えて、-add パラメーターの付いたサービスを作成する場合に、このパラメーターを使用します。
または、既存のサービスのパラメーターをエンコードします。
WASService -encodeParams service_name
- -logFile service_log_file (Windows のみ)
- このオプションを使用して、WASService コマンドがアクティビティーを記録するときに使用する
ログ・ファイルを識別します。
トラブルの回避 (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
- このオプションを使用して、製品のインストール・ルート・ディレクトリーを識別します。
- -configRoot
- -encodeParams
- -logFile
- -logRoot
- -restart
- -startType
ウィザードによって作成されるサービスのデフォルト名
- 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]](../images/windows.gif)
例
デプロイメント・マネージャー・サービスの作成
この例では、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
各部の意味は、次のとおりです。コマンドを入力した後、次の例と 同様のメッセージがコマンド・ウィンドウに表示されます。
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
各部の意味は、次のとおりです。コマンドを入力した後、次の例と 同様のメッセージがコマンド・ウィンドウに表示されます。
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
各部の意味は、次のとおりです。コマンドを入力した後、次の例と 同様のメッセージがコマンド・ウィンドウに表示されます。
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]](../images/windows.gif)
Windows サービスを作成した後のサーバー・プロセスの開始と停止
この Windows オペレーティング・システムの例では、server1 用の Windows サービスを作成した後に startServer server1 コマンドまたは stopServer server1 コマンドを実行すると、 以下の例と同様のメッセージが表示されます。
server1 は Windows サービスとして実行すると登録されているので
、このサーバーを開始する要求は、関連する Windows サービスを開始することによって実行されます。
nodeagent プロセスの Windows サービスを作成した後に startNode コマンド または stopNode コマンドを実行すると、 以下の例と同様のメッセージが表示されます。
nodeagent は Windows サービスとして実行すると登録されているの
で、このサーバーを開始または停止する要求は、関連する Windows サービス
を開始または停止することによって実行されます。
ログ・ファイルを調べて、このコマンドに関連するメッセージを表示します。
デプロイメント・マネージャーの Windows サービスを作成した後に startManager コマンド または stopManager コマンドを実行すると、 以下の例と同様のメッセージが表示されます。
dmgr は Windows サービスとして実行すると登録されているの
で、このサーバーを開始または停止する要求は、関連する Windows サービス
を開始または停止することによって実行されます。
ログ・ファイルを調べて、このコマンドに関連するメッセージを表示します。
