使用 Enterprise Manager 命令行客户端,您可以监视应用服务器、协作和警报。
Enterprise Manager 命令行客户端位于 JavaCAPS-install-dir/emanager/em-client 目录中。
Enterprise Manager 命令行客户端提供了以下两种监视服务:
运行时服务,可用于监视应用服务器和协作。
警报服务,可用于监视警报。
运行命令行客户端的计算机必须安装 Java 1.4.2 或更高版本。此外,路径变量必须包含 Java 安装 bin 目录的条目。
如果运行的是 UNIX,则使用 em-cmdline-client.sh 脚本。
如果运行的是 Windows,则使用 em-cmdline-client.bat 脚本。
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 方法,您可以删除所有警报。