test

Sun Java System Application Server Enterprise Edition 8.1 2005Q2 管理指南

有关 JMS 提供者的管理控制台任务

Procedure配置 JMS 提供者的常规属性

使用“JMS 服务”页面配置所有 JMS 连接都使用的属性。

有关配置 JMS 服务的更多信息，请参见 Application Server Developer’s Guide。

  1. 在树组件中，选择“配置”节点。

  2. 选择要配置的实例：

    • 要配置特定的实例，请选择该实例的配置节点。例如，对于默认实例 server，请选择 server-config 节点。

    • 要为将来的实例 （使用 default-config 副本）配置默认设置，请选择 default-config 节点。

  3. 选择“Java 消息服务”节点以打开“JMS 服务”页面。

  4. 要更改 Application Server 在异常中止启动之前等待 JMS 服务启动的时间，请编辑“启动超时”字段中的值。

    在运行缓慢或过载的系统中，在默认超时值 (60) 的基础上增大该值。

  5. 从“类型”下拉式列表中：

    • 选择 LOCAL（server-config 配置的默认设置）以访问本地主机上的 JMS 服务。JMS 服务由 Application Server 启动和管理。

    • 选择 REMOTE（default-config 配置的默认设置 ）以访问其他系统或群集上的 JMS 服务。如果选择了 REMOTE，则下一次启动服务器时 JMS 服务不会由 Application Server 启动。而是通过 来启动和管理服务，因而必须单独启动代理。有关启动代理的信息，请参见 Message Queue Administration Guide。如果选择此值并使用了远程主机，请按照编辑 JMS 主机中的说明来指定远程主机的名称。

  6. 在“启动变量”字段中，键入变量以自定义 JMS 服务启动。

    通过 MQ-install-dir/imq/bin/imqbrokerd 命令使用任意可用的变量。

  7. 使用“重新连接”复选框指定连接丢失时，JMS 服务是否尝试重新连接至消息服务器（或 AddressList 中的地址列表）。

    默认情况下，启用重新连接。

  8. 在“重新连接时间间隔”字段中，键入重新连接尝试之间的秒数。

    此设置适用于对 AddressList 中每个地址的尝试，及对该列表中连续地址的尝试。如果该时间间隔太短，则代理将没有时间恢复。如果该时间间隔太长，则重新连接可能会指明这是不可接受的延迟。

    默认值为 60 秒。

  9. 在“重新连接尝试”字段中，键入指定客户机运行时尝试连接（或重新连接）AddressList 列表中每个地址的次数。到达这个值后，客户机运行时将尝试连接列表中的下一个地址。

    值 -1 表示重新连接尝试次数没有限制（客户机运行时将尝试连接至第一个地址，直到连接成功）。默认值为 3。

  10. 从“默认 JMS 主机”下拉式列表中选择一个主机。默认值为 default_JMS_host。

  11. 在“地址列表行为”下拉式列表中，选择是按 AddressList 中的地址顺序 (priority) 还是按随机顺序 (random) 来尝试连接。

    priority 表示重新连接始终尝试连接 AddressList 中的第一个服务器地址，并且仅在第一个代理不可用时才使用其他地址。

    如果许多客户机同时尝试使用同一个连接工厂来进行连接，则应指定 random 以防止它们全部连接至同一个地址。

    默认值为 random。

  12. 在“地址列表重复”字段中，键入 JMS 服务建立（或重新建立）连接时，在 AddressList 中迭代的次数。

    值 -1 表示尝试次数没有限制。

    默认值为 3。

  13. 在“MQ 模式”和“MQ 服务”字段中，输入 Message Queue 地址模式名称和 Message Queue 连接服务名称（如果要使用非默认模式或服务）。

    消息服务地址的完整语法为


    scheme://address-syntax

    其中，scheme 和 address-syntax 将在下表中进行介绍。

    MQ 模式和 MQ 服务是下表的前两列中显示的值。

    模式名称 

    连接服务 

    说明 

    地址语法 

    mq

    jms 和 ssljms

    Message Queue 客户机运行时将连接位于指定主机和端口的 MQ 端口映射器。该端口映射器返回动态建立的连接服务端口的列表，然后 Message Queue 客户机运行时将连接托管指定连接服务的端口。 

    [hostName][: port][/serviceName]

    默认值：hostName = localhost, port = 7676, serviceName = jms

    默认值仅适用于 jms 连接服务。对于 ssljms 连接服务，需要指定所有变量。

    示例：mq:MyHost:7677/ssljms

    mqtcp

    jms

    Message Queue 客户机运行时将与指定主机和端口建立 TCP 连接（绕过 MQ 端口映射器）从而建立连接。 

    hostName:port/jms

    示例：mqtcp:localhost:7676/jms

    mqssl

    ssljms

    Message Queue 客户机运行时将与指定主机和端口建立安全 SSL 连接（绕过 MQ 端口映射器）从而建立连接。 

    hostName:port/ssljms

    示例：mqssl:localhost:7676/ssljms

    http

    httpjms

    Message Queue 客户机运行时将与指定 URL 处的 Message Queue 隧道 Servlet 建立 HTTP 连接。（必须按照 Administrator’s Guide 中的描述配置代理，才能访问 HTTP 隧道 Servlet。）

    hostName:port/contextRoot/tunnel

    如果多个代理实例使用同一个隧道 Servlet，则连接特定代理实例（而不是随机选择的实例）的语法为：http://hostName:port/contextRoot/tunnel?serverName=hostName:instanceName

    https

    httpsjms

    Message Queue 客户机运行时将与指定 Message Queue 隧道 Servlet URL 建立安全 HTTPS 连接。（必须按照 Administrator’s Guide 中的描述配置代理，才能访问 HTTPS 隧道 Servlet。）

    hostName:port/contextRoot/tunnel

    如果多个代理实例使用同一个隧道 Servlet，则连接特定代理实例（而不是随机选择的实例）的语法为：http://hostName:port/contextRoot/tunnel?serverName=hostName:instanceName

  14. 在“其他属性”区域中，单击“添加属性”以添加属性。

    下表列出了可用的 Sun Java System Message Queue 代理配置属性。

    属性名称 

    说明 

    instance-name

    指定完整的 Message Queue 代理实例名。默认值为 imqbroker。

    instance-name-suffix

    指定要添加到完整的 Message Queue 代理实例名中的后缀。该后缀与实例名之间以下划线字符 (_) 分隔。例如，如果实例名为 imqbroker，则在附加后缀 xyz 之后，实例名将更改为 imqbroker_xyz。

    append-version

    如果为 true，则应在完整的 Message Queue 代理实例名后附加主要和次要版本号，这两个版本号之前都有一个下划线字符 (_)。例如，如果实例名为 imqbroker，则在附加版本号之后，实例名将更改为 imqbroker_8_0。默认值为 false。

  15. 单击“保存”以保存更改，或者单击“装入默认值”以恢复服务的默认值。

访问远程服务器

将提供者和主机更改到远程系统将使所有 JMS 应用程序在远程服务器上运行。要同时使用本地服务器和一个或多个远程服务器，请使用 AddressList 属性创建连接工厂资源，从而创建访问远程服务器的连接。请参见创建 JMS 连接工厂资源。

Procedure检验 JMS 服务设置

  1. 在树组件中，选择“配置”节点。

  2. 选择要配置的实例：

    • 要配置特定的实例，请选择该实例的配置节点。例如，对于默认实例 server，请选择 server-config 节点。

    • 要为将来的实例 （使用 default-config 副本）配置默认设置，请选择 default-config 节点。

  3. 选择“Java 消息服务”节点以打开“JMS 服务”页面。

  4. 单击 "Ping"。

    如果 JMS 服务已启动并且正在运行，则将显示消息“Ping 成功：JMS 服务正在运行”。

等效的 asadmin 命令

jms-ping

Procedure创建 JMS 主机

Application Server Platform Edition 要求只能有一个 JMS 主机，其默认名称为 default_JMS_host。也可以创建其他主机，但 Application Server 无法识别它们。

  1. 在树组件中，展开“配置”节点。

  2. 选择要配置的实例：

    • 要配置特定的实例，请选择该实例的配置节点。例如，对于默认实例 server，请选择 server-config 节点。

    • 要为将来的实例 （使用 default-config 副本）配置默认设置，请选择 default-config 节点。

  3. 展开“Java 消息服务”节点。

  4. 选择“JMS 主机”节点。

  5. 在“JMS 主机”页面中，单击“新建”。将显示“创建 JMS 主机”页面。

  6. 在“名称”字段中，键入主机的名称。例如：


    NewJmsHost

  7. 在“主机”字段中，键入将运行 JMS 主机的系统的名称或 Internet 协议 (Internet Protocol, IP) 地址（localhost 或者本地或远程系统的名称）。

  8. 在“端口”字段中，键入 JMS 服务的端口号。

    仅当使用的 JMS 服务在非默认端口上运行时，才需要更改此字段。（默认端口为 7676。）

  9. 在“管理用户名”和“管理密码”字段中，键入 Message Queue 代理用户名和密码。

    该用户名和密码与 Application Server 的用户名和密码不同。仅当已使用 MQ-install-dir/imq/bin/imqusermgr 命令更改了 Message Queue 代理值时，才需要编辑这些字段。默认值为 admin 和 admin。

  10. 单击“确定”。

等效的 asadmin 命令

create-jms-host

Procedure编辑 JMS 主机

  1. 在树组件中，展开“配置”节点。

  2. 选择要配置的实例：

    • 要配置特定的实例，请选择该实例的配置节点。例如，对于默认实例 server，请选择 server-config 节点。

    • 要为将来的实例 （使用 default-config 副本）配置默认设置，请选择 default-config 节点。

  3. 展开“Java 消息服务”节点。

  4. 选择“JMS 主机”节点。

  5. 在“JMS 主机”页面中，选择要编辑的主机。

  6. 在“编辑 JMS 主机”页面中，可以执行以下任务：

    • 在“主机”字段中，更改主机名或 Internet 协议 (Internet Protocol, IP) 地址。

      • 在“端口”字段中，更改 JMS 服务的端口号。

      • 更改“管理用户名”和“管理密码”字段中的值。

  7. 单击“保存”以保存更改，或者单击“装入默认值”以恢复主机的默认值。

Procedure删除 JMS 主机

  1. 在树组件中，展开“配置”节点。

  2. 选择要配置的实例：

    • 要配置特定的实例，请选择该实例的配置节点。例如，对于默认实例 server，请选择 server-config 节点。

    • 要为将来的实例 （使用 default-config 副本）配置默认设置，请选择 default-config 节点。

  3. 展开“Java 消息服务”节点。

  4. 选择“JMS 主机”节点。

  5. 在“JMS 主机”页面中，选中要删除的主机的名称旁边的复选框。

  6. 单击“删除”。

    注意 – 注意 –

    请勿删除所有 JMS 主机。否则，将使 Application Server 无法重新启动。您必须至少保留一个 JMS 主机。

等效的 asadmin 命令

delete-jms-host