test

监视 Java EE 组件

监视应用服务器、协作和警报（命令行）

使用 Enterprise Manager 命令行客户端，您可以监视应用服务器、协作和警报。

Enterprise Manager 命令行客户端位于 JavaCAPS-install-dir/emanager/em-client 目录中。

Enterprise Manager 命令行客户端提供了以下两种监视服务：

运行命令行客户端的计算机必须安装 Java 1.4.2 或更高版本。此外，路径变量必须包含 Java 安装 bin 目录的条目。

注 –

JAVA_HOME 变量的值中不得包含引号。

如果运行的是 UNIX，则使用 em-cmdline-client.sh 脚本。

如果运行的是 Windows，则使用 em-cmdline-client.bat 脚本。

Enterprise Manager 命令行客户端语法

Enterprise Manager 命令行客户端语法为：


em-cmdline-client -l hostname -p port -u username -w password -s service 
-m method -Pparameter=value

下表介绍了这些参数。

表 1–6 Enterprise Manager 命令行客户端参数

参数 

描述 

-h, --help 

显示有关命令行客户端的帮助。 

-l, --host 

用于指定运行 Enterprise Manager 的计算机的主机名。 

-p, --port 

用于指定 Enterprise Manager 基本端口号。 

-u, --userid 

用于指定 Enterprise Manager 用户名。 

-w, --password 

用于指定 Enterprise Manager 用户名的密码。 

-s, --service 

用于指定要使用的服务。运行时服务称为 RuntimeService51x。警报服务称为 AlertService51x。

-m, --method 

用于指定要调用的方法。 

-P 

用于指定方法的参数名称和值。某些方法不需要参数。 

-n, --signatures 

显示可用方法的签名。 

-t, --timeout 

用于指定命令的 HTTP 请求超时值（以毫秒为单位）。 

-v, --validate 

检查所需的参数数目。 

可以使用以下参数连接到 Enterprise Manager 服务器：-l、-p、-u 和 -w。

监视应用服务器和协作（命令行）

可使用 Enterprise Manager 命令行客户端的运行时服务来监视应用服务器和协作。

在开始之前，请确保 Enterprise Manager 服务器正在运行。

将 -s 参数设置为 RuntimeService51x。将 -m 参数设置为所需的方法。对于每个参数，请将 -P 参数设置为名称和值。

注 –

将在多行中显示这些命令以提高可读性。您必须在一行中输入这些命令。

列出运行时服务的可用方法

可以使用 -n 参数来显示运行时服务的可用方法列表。例如：


em-cmdline-client -l entmgrhost -p 15000 -u Administrator -w STC
-s RuntimeService51x -n

 Note: the order of the parameters is important.
 Available methods and parameters:

-m getState -Pcomponent=<component> -PcomponentType=<componentType>
-m startComponent -Pcomponent=<component> -PcomponentType=<componentType>
-m getComponentsList
-m stopComponent -Pcomponent=<component> -PcomponentType=<componentType>
-m getStatus -Pcomponent=<component> -PcomponentType=<componentType>

显示组件列表

运行时服务的方法要求您指定组件路径和组件类型。使用 getComponentsList 方法，您可以获取此信息。例如：


em-cmdline-client -l entmgrhost -p 15000 -u Administrator -w STC
-s RuntimeService51x
-m getComponentsList

e51x|Servers|myserver:4848
is51x

e51x|Servers|myserver:4848|IQ_Manager_18007
stcms

e51x|Servers|myserver:4848|Sun_JMQ_7676
jmq

e51x|Servers|myserver:4848|Project1|Deployment1|CMap1|Service1
jce.JavaCollaborationDefinition

e51x|Servers|myserver:4848|Project1|Deployment1|CMap1|Service2
jce.JavaCollaborationDefinition

e51x|Servers|myserver:4848|Project1|Deployment1|CMap1|Topic1
messageService.Topic

显示当前状态

使用 getState 方法，可以显示应用服务器或协作以及 JMS IQ Manager 的当前状态。您必须指定以下参数：组件路径和组件类型。例如：


em-cmdline-client -l entmgrhost -p 15000 -u Administrator -w STC
-s RuntimeService51x
-m getState
-Pcomponent="e51x|Servers|myserver:4848"
-PcomponentType=is51x

Up

查看基本信息

使用 getStatus 方法，可以查看应用服务器或协作的基本信息。您必须指定以下参数：组件路径和组件类型。例如：


em-cmdline-client -l entmgrhost -p 15000 -u Administrator -w STC
-s RuntimeService51x
-m getStatus
-Pcomponent="e51x|Servers|myserver:4848"
-PcomponentType=is51x

HostAndPort = myserver:4848
Component = e51x|Servers|myserver:4848
System = e51x
RestartRequired = true

启动和停止协作

使用 startComponent 方法，可以启动协作。您必须指定以下参数：组件路径和组件类型。例如：


em-cmdline-client -l entmgrhost -p 15000 -u Administrator -w STC
-s RuntimeService51x
-m startComponent
-Pcomponent="e51x|Servers|myserver:4848|Project1|Deployment1|CMap1|Service1"
-PcomponentType=jce.JavaCollaborationDefinition

使用 stopComponent 方法，可以停止应用服务器域、应用服务器实例或协作。您必须指定以下参数：组件路径和组件类型。例如：


em-cmdline-client -l entmgrhost -p 15000 -u Administrator -w STC
-s RuntimeService51x
-m stopComponent
-Pcomponent="e51x|Servers|myserver:4848|Project1|Deployment1|CMap1|Service1"
-PcomponentType=jce.JavaCollaborationDefinition
注 –

无法使用 stopComponent 方法来停止消息服务器。

命令行并不提供指示方法是否成功的反馈。不过，您可以使用 getState 方法来验证组件是处于启动还是关闭状态。

监视警报（命令行）

可以使用 Enterprise Manager 命令行客户端的警报服务来监视警报。

在开始之前，请确保 Enterprise Manager 服务器正在运行。

将 -s 参数设置为 AlertService51x。将 -m 参数设置为所需的方法。

注 –

将在多行中显示这些命令以提高可读性。您必须在一行中输入这些命令。

列出警报服务的可用方法

可以使用 -n 参数来显示警报服务的可用方法列表。例如：


em-cmdline-client -l entmgrhost -p 15000 -u Administrator -w STC
-s AlertService51x -n

Note: the order of the parameters is important.
Available methods and parameters:

-m deleteAlerts -Pfilter=<filter>
-m getAllAlerts
-m observeAlerts -Pfilter=<filter>
-m resolveAlerts -Pfilter=<filter>
-m resolveAllAlerts
-m deleteAllAlerts
-m observeAllAlerts
-m getAlertQueryFields
-m getAlerts -Pfilter=<filter>
-m resetAlerts -Pfilter=<filter>
-m resetAllAlerts

列出查询字段

使用 getAlertQueryFields 方法，您可以列出可用于其他方法的过滤器。例如：


em-cmdline-client -l entmgrhost -p 15000 -u Administrator -w STC
-s AlertService51x
-m getAlertQueryFields

from
to
id
environmentName
physicalHostName
logicalHostName
serverName
componentProjectPathName
deploymentName
componentName
severity
type
observationalState
operationalState
messageCode
details

查看警报

使用 getAlerts 方法，可以显示指定组件的所有警报。可通过包含一个或多个过滤器来显示一部分警报。以下示例指定了两个过滤器：


em-cmdline-client -l entmgrhost -p 15000 -u Administrator -w STC
-s AlertService51x
-m getAlerts
-Pfilter=componentProjectPathName=Project1;environmentName=Environment1
 
ID:10
Date:Wed Jun 04 15:56:58 PDT 2008
EnvironmentName:Environment1
LogicalHostName:LogicalHost1
ServerName:server
ComponentProjectPathName:Project1
DeploymentName:Deployment1
ComponentName:Service1
PhysicalHostName:myserver:4848
Severity:INFO
Type:COLLABORATION
ObservationalState:Unobserved
OperationalState:Running
MessageCode:COL-00001
Details: Collaboration jcdB is RUNNING

ID:9
Date:Wed Jun 04 15:56:57 PDT 2008
EnvironmentName:Environment1
LogicalHostName:LogicalHost1
ServerName:server
ComponentProjectPathName:Project1
DeploymentName:Deployment1
ComponentName:Service1
PhysicalHostName:myserver:4848
Severity:INFO
Type:COLLABORATION
ObservationalState:Unobserved
OperationalState:Running
MessageCode:COL-00001
Details: Collaboration jcdA is RUNNING

使用 getAllAlerts 方法，您可以显示所有警报。

更改警报状态

警报的初始状态为“未观察”。您可以将状态更改为“已观察”或“已解决”。“已观察”表示您已看到并确认了警报。“已解决”表示您已解决导致警报的问题。

使用 observeAlerts 方法，您可以将警报的状态更改为“已观察”。


em-cmdline-client -l entmgrhost -p 15000 -u Administrator -w STC
-s AlertService51x
-m observeAlerts
-Pfilter=componentProjectPathName=Project1;environmentName=Environment1

使用 observeAllAlerts 方法，您可以将所有警报的状态都更改为“已观察”。

使用 resolveAlerts 方法，您可以将警报的状态更改为“已解决”。


em-cmdline-client -l entmgrhost -p 15000 -u Administrator -w STC
-s AlertService51x
-m resolveAlerts
-Pfilter=componentProjectPathName=Project1;environmentName=Environment1

使用 resolveAllAlerts 方法，您可以将所有警报的状态都更改为“已解决”。

使用 resetAlerts 方法，您可以将警报的状态更改为初始值（未观察）。


em-cmdline-client -l entmgrhost -p 15000 -u Administrator -w STC
-s AlertService51x
-m resetAlerts
-Pfilter=componentProjectPathName=Project1;environmentName=Environment1

使用 resetAllAlerts 方法，您可以将所有警报的状态都更改为初始值（未观察）。

删除警报

使用 deleteAlerts 方法，您可以删除警报。


em-cmdline-client -l entmgrhost -p 15000 -u Administrator -w STC
-s AlertService51x
-m deleteAlerts
-Pfilter=componentProjectPathName=Project1;environmentName=Environment1

使用 deleteAllAlerts 方法，您可以删除所有警报。