启动 Workstation

简介 › 管理 Workstation › 启动 Workstation

启动 Workstation

使用下列方法之一启动 Workstation：

在 Windows 中，可以：
- 运行 Introscope Workstation.exe。
- 单击“开始”、“APM”、“Introscope Workstation”
在浏览器中使用类似如下的 URL：
```
http://<EM_Host>:8081/workstation
```
- 其中，EM_Host 是企业管理器的主机名。
请参阅“使用特定参数启动 Workstation”。

注意：在您第一次启动 Workstation 时，系统会提示您启动 workstation.jnlp 或保存文件。

建议您启动 workstation.jnlp。
不建议保存文件并选中“今后自动对此类文件执行此操作”选项。此选项将阻止您通过 URL 正确启动 Workstation。
使用命令行。
注意：有关详细信息，请参阅“从命令行执行 Workstation 功能”。

要进行登录：

在“登录”对话框中，输入以下信息：
- 主机名或 IP 地址。
  注意：仅当客户端计算机和主机计算机均支持同一 IP 协议时，才可以使用 IP 地址代替主机名。
- 端口号。
- 用户名和密码。
单击“连接”，或者要使当前主机和用户信息成为将来登录时的默认值，请单击“设置默认”。
将打开控制台。如果身份验证过程不成功，则会出现一条消息，通知您验证失败。

注意：要配置 Workstation 用户权限，请参阅《CA APM 安全指南》。

使用特定参数启动 Workstation

可以使用指定要访问 Workstation 中的哪个视图的特定参数来启动 Workstation。您可以按以下方式使用这些参数：

从命令行发出的 Java 启动命令。
使用 Java Web Start 启动 Workstation 的 URL。
IntroscopeWorkstation.lax 文件中的参数。

注意：您可以使用标准 URL 编码转义代理或度量标准名称中的特殊字符。

示例 1

例如，在命令行中，-page 和 -agent 选项将是：

java -client -Xms64m -Xmx256m -Dsun.java2d.noddraw=true -jar launcher.jar 
-consoleLog -noExit -product com.wily.introscope.workstation.product 
-name "Introscope Workstation" -install ".\\product\\workstation" 
-configuration ".\\product\\workstation\\configuration" -page
investigator -agent "SuperDomain|localhost|WebLogic|WebLogic Agent"

在 URL 中，同样的组合将是：

http://<localhost>:8081/workstation?page=investigator&agent=SuperDomain|localhost|WebLogic|WebLogic%20Agent

在 IntroscopeWorkstation.lax 文件中，可以通过编辑 lax.command.line.args 说明符来指向同一页面。字符串的末尾指定相同页面和代理位置，如下所示：

lax.command.line.args=$CMD_LINE_ARGUMENTS$ -consolelog -noExit -product com.wily.introscope.workstation.product -name "Introscope Workstation" -install ".\\product\\workstation" -configuration ".\\product\\workstation\\configuration" -page investigator -agent "SuperDomain|localhost|WebLogic|WebLogic Agent"

添加这些参数后，只要从“开始”菜单启动 Workstation，Workstation 就会打开指定页面和代理位置。

请注意每个示例处理代理名称中的空格字符的方式。

在示例中，因为名称中包含空格，所以在整个代理名称两边使用引号。
在 URL 示例中，空格字符呈现为 %20。

示例 2

如果代理名称是“MyAgent%1”，则在 URL 中使用以下字符串：

MyAgent%251

其中，%25 是文本字符 % 的 URL 编码。

示例 3

如果代理名称是“WhatIsThisAgent??”，则在 URL 中使用以下字符串：

WhatIsThisAgent%3F%3F

其中，%3F 是文本字符 ? 的 URL 编码。

下表描述了其他参数：

选项	说明
-loginimmediate	弃用登录屏幕，并立即使用指定主机名和端口号或默认值登录到 Workstation。
-loginhost <hostname>	指定登录主机名；如果未指定，默认为 localhost。
-loginport <portnumber>	指定登录端口号；如果未指定，默认为 5001。
-loginresponse <values>	在以逗号分隔的列表中指定用户名和密码的身份验证值。
-page	要启动的 Workstation 屏幕的名称。必须在 Workstation 命令行界面的每个请求中包括此参数。支持的值： investigator historicalquery console
-agent	显示在“调查器”窗口中的完全限定代理名称。在 page 参数为 investigator 时必需。使用 URL 编码来呈现代理名称中的特殊字符。
-metric	显示在“调查器”窗口中的指定代理的度量标准路径。如果使用此参数，必须指定代理。使用 URL 编码呈现度量标准名称中的特殊字符。
-start	“调查器”窗口中的历史时间范围的开始时间（采用毫秒的标准 Java 格式）或“事务跟踪器历史查询”的开始时间，具体取决于 page 参数的值。注意：start/end 或 guid 参数在 page 参数为 historicalquery 时是必需的。
-end	调查器窗口中的历史时间范围的结束时间（采用标准 Java 毫秒格式）或事务跟踪器历史查询的结束时间，具体取决于页面参数值。 start/end 或 guid 参数在 page 参数为 historicalquery 时是必需的。以下示例使用 Java 时间戳值。使用广泛可用的转换器（包括可从 Internet 上获得的那些）可以将日历日期转换成 Java 时间戳值。 http://<localhost>:8081/workstation?page=historicalquery&start=1135686483474&end=1136686483474
-guid	显示在“事务跟踪器历史查询”窗口中的事务的唯一标识符。 start/end 或 guid 参数在 page 参数为 historicalquery 时是必需的。例如： http://<localhost>:8081/workstation?page=historicalquery&guid=aRx345
-agentSpecifier	筛选数据以将显示板限制为显示来自指定代理的数据。仅当 page 参数 = console 时可以使用。 AgentSpecifier 参数的参数必须包含代理名称，包括企业管理器主机名。用于分隔代理名称元素的特殊字符（如 \| 符号）必须使用反斜线进行转义。在代理名称中用字符串 %20 代替空格。在本示例中，显示板将仅显示来自 WebLogic 代理的数据： http://<localhost>:8081/workstation?page=console&agentSpecifier=machine1\\|WebLogic\\|WebLogic%20Agent&metric=GC%20Heap:Bytes%20In%20Use
-dashboardName	指定要显示的显示板。仅当 page 参数 = console 时可以使用。将显示板名称中的空格替换为字符串 %20。在本示例中，URL 将跳到名为“GC Memory In Use”的显示板： http://<localhost>:8081/workstation?page=console&dashboardName=GC%20Memory%20In%20Use&metric=GC%20Heap:Bytes%20In%20Use

执行某一 URL（或使用等效的 Java 命令行启动 Workstation）将启动 Workstation 实例并打开相应窗口。随后的 URL 请求会在现有 Workstation 实例中打开一个新窗口。

其他示例

要使用 Java Web Start 启动 Workstation，以下是使用 URL 的几个示例：

启动控制台视图中的特定显示板（显示板名称为“Introscope 简介”）的 WebStart：

http://localhost:8081/workstation?host=localhost&port=5001&username=<User_ID>&password=<Your_Pwd>&page=console&dashboardName=An%20Intro%20to%20Introscope

启动调查器中的特殊代理 (<Agent_Name>) 的 WebStart：

http://localhost:8081/workstation?host=localhost&port=5001&username=<User_ID>&password=<Your_Pwd>&page=investigator&agent=SuperDomain|<Host_Name>|AppServers|<Agent_Name>

启动调查器中的特殊代理和度量标准的 WebStart：

http://localhost:8081/workstation?host=localhost&port=5001&username=<User_ID>&password=<Your_Pwd>&page=investigator&agent=SuperDomain|<Host_Name>|AppServers|<Agent_Name>&metric=GC%20Heap:Bytes%20In%20Use

启动历史查询查看器中的特殊事务跟踪 GUID (<GUID_Number>) 的 WebStart：

http://localhost:8081/workstation?host=localhost&port=5001&username=<User_ID>&password=<Your_Pwd>&page=historicalquery&guid=<GUID_Number>

Java Web Start 的 JVM 要求

您计划使用 Java Web Start 启动 Workstation 的服务器，在本地必须有一个受支持的 JVM 版本。

Java Web Start 将安装 Workstation 客户端的临时副本。使用不正确的 JVM 版本时，使用代理身份验证连接到企业管理器的计算机可能会遇到问题。

在客户端系统上，Java Web Start 通过以下文件启动 Workstation（使用 Java 版本）：

<企业管理器主目录>\product\enterprisemanager\plugins\com.wily.introscope.workstation.webstart_9.5\WebContent\jnlp\workstation.jsp
<企业管理器主目录>\product\enterprisemanager\plugins\com.wily.introscope.workstation.webstart_9.5\WebContent\jnlp\com.wily.introscope.workstation.feature.jsp

这两个文件都包含带有版本属性 j2se 节点，可用于确定启动 Workstation 的 Java 版本。有关 Java Web Start 如何检测目前的 JVM 并对其做出响应的更加详细的解释，请查看文件中的备注。

注意：有关 JVM 要求的信息，请参阅《兼容性指南》。

连接到备用企业管理器

可以使用“使用特定参数启动 Workstation”中指定的参数，从单个浏览器启动不同企业管理器主机上的多个 Workstation 应用程序实例。要连接到备用或其他企业管理器，请根据需要更改 loginHost 参数。