WASService的使用
WASService的使用2010年06月11日 星期五 14:12
WASService 命令行工具允许您在 Linux 和 Windows 操作系统上为产品 Java 进程创建服务。
您可以为 WebSphere Application Server Java 进程创建服务。可能存在的服务包括下列服务器进程:
应用程序服务器节点上的缺省 server1 进程
您在应用程序服务器节点上创建的应用程序服务器进程
当安装向导创建服务时,卸载程序可以除去服务。如果使用 WASService 命令自已创建一个服务,那么当该服务不再有效时,您必须除去它。卸载程序不会除去您使用 WASService 命令创建的服务。
要在 Microsoft Windows 操作系统上设置并运行此功能,用户必须属于 administrator 组,而且具有下列高级用户权限:
作为操作系统的一部分
作为服务登录
有关将应用程序服务器作为服务在 Microsoft? Windows Vista? 操作系统上运行的注意事项:
如果要在 Microsoft Windows Vista 操作系统上启动或停止作为服务来运行的应用程序服务器,那么需要以管理员特权来运行。
服务可配置为在系统重新引导时自动启动,或者可以在接受管理员特权的提升提示后,手动从 Windows 服务面板启动和停止服务。
使用 WASService.exe 实用程序更改服务的特征或创建新服务时,也需要以管理员特权运行。
为此,通过执行以下操作,从启动的命令提示符处运行 WASService.exe:
右键单击命令文件或其快捷方式。
单击用管理员帐户运行。
可以执行下列 .bat 文件以调用服务操作:
startServer.bat
stopServer.bat
以标准用户特权运行时,不能执行改变或控制这些服务操作。管理员特权是必需的。
如果将应用程序服务器安装为服务,请执行以下操作以调用“命令提示符”窗口,然后在该窗口中运行 .bat 文件来控制此服务:
右键单击“命令提示符”快捷方式。
单击用管理员帐户运行。
如果未将应用程序服务器配置为作为服务来运行,那么不必根据管理员特权的提升提示来运行这些实用程序。
命令文件的位置
wasservice.sh 命令文件位于 app_server_root\bin 目录中。
WASService.exe 命令文件位于 app_server_root\bin 目录中。
命令语法
用于启动现有服务的命令语法
命令语法如下所示:
wasservice.sh -start service_name [optional startServer.bat parameters]
WASService.exe -start service_name [optional startServer.bat parameters]
用于创建服务或更新现有服务的命令语法
命令语法如下所示:
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]
???????
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]
?????
用于删除服务的命令语法
命令语法如下所示:
wasservice.sh -remove service_name
WASService.exe -remove service_name
用于停止正在运行的服务的命令语法
命令语法如下所示:
wasservice.sh -stop service_name [optional stopServer.bat parameters]
WASService.exe -stop service_name [optional stopServer.bat parameters]
用于检索服务状态的命令语法
命令语法如下所示:
wasservice.sh -status service_name
WASService.exe -status service_name
参数
支持的参数包括:
-add service_name
创建名为 service_name 的服务或者更新现有服务。对于这两种情况,语法是相同的。
-configRoot configuration_repository_directory
可选参数,它识别 WebSphere Application Server 产品的安装根目录的配置目录。
-encodeParams service_name
可选参数,它强制服务对 -startArgs 和 -stopArgs 进行编码以使无法通过编辑注册表来确定参数。使用 -add 参数创建服务时,通过在命令行上添加不带参数的 -encodeParams 的方式使用该参数。
或者对现有服务的参数进行编码:
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
定义新服务的启动类型。automatic 启动类型在系统启动或第一次调用服务时自动启动。在操作系统可以装入 manual 服务并且让它可供使用之前,您必须先将它启动。您无法在更改 disabled 启动类型之前,启动该服务。
-status service_name
返回服务的当前状态,它包含服务是在运行还是停止了。
-stop service_name [optional stopServer.bat parameters]
停止指定的服务。
-stopArgs additional_stop_arguments
识别其他参数的可选参数。
-userid user_id -password password
识别 Windows 服务将以该标识运行的特权用户标识和密码的可选参数。
-wasHome app_server_root
标识产品的安装根目录的可选参数。
由向导创建的服务的缺省名称
安装向导创建的服务的名称为 IBM WebSphere Application Server V6.x - DefaultNode。
查看服务面板
要查看服务,打开控制面板并单击管理工具 > 服务。选择要查看它的信息的服务。右击该服务并单击属性。四个选项卡提供信息和功能。例如,选择常规选项卡上的设置类型字段,更改设置类型。
示例
示例
本示例创建用于启动应用程序服务器进程的名为 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 操作系统的本示例使用其他的停止参数、用户名和密码来更新名为 IBM WebSphere Application Server V6.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 操作系统示例,如果在为 server1 创建 Windows 服务后发出 startServer server1 命令或 stopServer server1 命令,那么会显示类似于以下示例的消息:
因为将 server1 注册为作为 Windows 服务方式运行,因此启动此服务器的请求将通过启动关联的 Windows 服务完成。
?
说明:
在windows平台上在创建profile时,系统自动创建的服务名称为IBM WebSphere Application Server V6.x - name_of_the_application_server_service 例如:IBM WebSphere Application Server V6.1 - cnooc_n-node01
注意cnooc_n-node01才是服务的名称。
--------------------------------------------
相关参考
启用安全性后的访问问题