配置 SIP 应用程序路由器
使用会话启动协议 (SIP) 应用程序路由器来选择 SIP 应用程序的触发顺序。在配置 SIP 应用程序路由器时,您可以使用缺省应用程序路由器,也可以创建定制应用程序路由器。
关于此任务
SIP 容器提供了名为“缺省应用程序路由器”(DAR) 的应用程序路由器组件。此 DAR 组件使用一个与
Java™ 属性文件相似的配置文本文件,该文件定义应用程序路由器向应用程序发送 SIP 请求的顺序。
限制: WebSphere® Application Server 提供了一种缺省方法对 SIP
应用程序调用进行排序,即,使用“启动行为”设置进行此排序。排序顺序基于应用程序权重。仅当您未指定 DAR 配置文件时,或者未使任何定制应用程序路由器与服务器或集群相关联时,这种权重策略才适用。
您可以使用 DAR 或定制应用程序路由器来执行应用程序路由,如以下过程所述。
请使用以下过程来选择最适合于为您的配置实现 SIP 应用程序路由器的方法。
过程
- 将 DAR 组件与 DAR 配置文件配合使用。
- 在管理控制台中,单击环境 > SIP 应用程序路由器。表将显示可用应用程序路由器的列表,其中包括 DAR 组件。
- 单击 DefaultSIPApplicationRouter 链接。
- 在目标表中查看与此应用程序路由器相关联的服务器目标和集群目标的列表。
- 这些目标可能可用,也可能不可用。要更改应用程序路由器的目标,请返回到“SIP 应用程序路由器”面板,单击路由器名称,并检查是否列示了目标。如果列示了目标,请选择目标,然后单击移至应用程序路由器按钮。下拉菜单将允许您选择另一个应用程序路由器。
- 对于 DefaultSIPApplicationRouter,请单击目标链接名称,以便为该目标设置应用程序路由配置。
- 单击高级应用程序路由规则(DAR 配置)以使用 DAR 配置文件,然后单击应用。
- 单击配置路由规则以查看或编辑路由规则。
- 如果您已有 DAR 配置文件,那么可以单击导入...按钮以上载新的 DAR 配置文件。 此时将显示导入文件窗口,此窗口允许您进行浏览以查找文件并将其上载;然后,请单击导入按钮。
- 使用 DAR 配置文件页面上的新建、删除、上移和下移按钮来创建和修改路由规则。
- 单击保存以直接保存到主配置,然后重新启动服务器或集群以使更改生效。
- 将 DAR 组件与手动应用程序排序功能配合使用。
- 在管理控制台中,单击环境 > SIP 应用程序路由器。表将显示可用应用程序路由器的列表,其中包括 DAR 组件。
- 单击 DefaultSIPApplicationRouter 链接。
- 在“目标”表中查看与此应用程序路由器相关联的服务器目标和集群目标的列表。
- 这些目标可能可用,也可能不可用。要更改应用程序路由器的目标,请返回到“SIP 应用程序路由器”面板,单击路由器名称,并检查是否列示了目标。如果列示了目标,请选择目标,然后单击移至应用程序路由器按钮。下拉菜单将允许您选择另一个应用程序路由器。
- 对于 DefaultSIPApplicationRouter,请单击目标链接名称,以便为该目标设置应用程序路由配置。
- 单击基本应用程序启动顺序以使用目标的应用程序顺序;然后,单击应用。
- 单击配置应用程序启动顺序以查看应用程序在此目标上的应用程序启动顺序权重。
- 在应用程序的启动顺序权重列中输入一个数字值。 启动顺序权重确定 SIP 应用程序路由器将 SIP 请求发送到应用程序的顺序。这些值也确定在服务器重新启动后,应用程序的启动顺序。
启动值较小的应用程序将首先启动。
限制: 如果将两个或两个以上 SIP 应用程序捆绑在一个企业归档 (EAR) 应用程序文件中,那么捆绑的 SIP 应用程序将具有相同的权重。如果需要更复杂的路由规则,那么必须使用另一种应用程序路由器方法。
- 单击更新。
- 单击保存以直接保存到主配置,然后重新启动服务器或集群以使更改生效。
注意: CEA 样本包包括一个 wsadmin (Jython) 脚本库,可用于简化自动化配置更改的脚本的开发和测试。有关进一步的信息,请参阅 wsadmin (Jython) 脚本编制过程以了解 CEA 信息。 - 使用定制应用程序路由器。
- 在管理控制台中,单击环境 > SIP 应用程序路由器。表将显示可用应用程序路由器的列表,其中包括 DAR 组件。
- 从列表中选择定制 SIP 应用程序路由器,或者单击New以创建新的 SIP 应用程序路由器。 “配置”选项卡将显示该应用程序路由器的名称以及该应用程序路由器的提供程序名称。应用程序路由器的提供程序名称必须设置为定制应用程序路由器实现的标准类名。
- 将 Java 归档
(JAR) 文件放置在服务器类路径中。 例如,将 JAR 文件放置在 java_home/lib/ext 目录中,并确保此目录包括在服务器的类路径中。
避免故障: 请勿将此路径添加至服务器 > 服务器类型 > Websphere 应用程序服务器 > server_name > SIP 容器 > Java 和进程管理 > 进程定义 > Java 虚拟机 > 类路径条目中,因为这可能会导致冲突。gotcha
- 根据需要,在必填字段中输入或编辑信息。 必填字段标有星号 (*)。
- 单击应用,然后单击保存以直接保存到主配置。
- 要更改应用程序路由器的目标,请单击路由器名称,并检查是否列示了目标。如果列示了目标,请选择目标,然后单击移至应用程序路由器按钮。下拉菜单将允许您选择另一个应用程序路由器。
- 单击保存以直接保存到主配置,然后重新启动服务器或集群以使更改生效。
注意: CEA 样本包包括一个 wsadmin (Jython) 脚本库,可用于简化自动化配置更改的脚本的开发和测试。有关进一步的信息,请参阅 wsadmin (Jython) 脚本编制过程以了解 CEA 信息。 - 使用定制属性来配置 SIP 应用程序路由器。 您可以使用下列定制属性来配置 DAR 或定制应用程序路由器。这些定制属性将覆盖管理控制台设置。
- 在管理控制台中,单击服务器 > 服务器类型 > WebSphere 应用程序服务器 > server_name。
- 在容器设置中,展开SIP 容器设置,然后单击SIP 容器。
- 在其他属性中,单击定制属性,然后单击新建。
- 对于 DAR,请使用 javax.servlet.sip.ar.dar.configuration 定制属性。 此属性指定 DAR 属性文件的位置,此属性文件用于定义应用程序路由器向应用程序发送 SIP 请求的顺序(如 JSR 289 规范的附录 C 所述)。
- 对于定制应用程序路由器,请使用 javax.servlet.sip.ar.spi.SipApplicationRouterProvider 定制属性。 此属性指定定制应用程序路由器实现的标准类名,如 JSR 289 规范的 15.4.2 节所述。定制应用程序路由器实现类用于定义应用程序路由器向应用程序发送 SIP 请求的顺序。
- 单击保存以直接保存到主配置,然后重新启动服务器或集群以使更改生效。
结果
子主题
SIP 应用程序路由器集合
使用此页面创建和删除 SIP 应用程序路由器。 “会话启动协议”(SIP) 应用程序路由器允许您选择在初始 SIP 请求时运行 SIP 应用程序的顺序。SIP 应用程序路由器设置
使用此页面配置 SIP 应用程序路由器容器设置。“会话启动协议”(SIP) 应用程序路由器允许您选择触发 SIP 应用程序的顺序。 您可以根据 SIP Servlet 规范使用缺省应用程序路由器 (DAR) 或指定定制应用程序路由器。应用程序路由顺序设置
使用此页面指定缺省 SIP 应用程序路由器(DAR)是必须依赖基本应用程序启动顺序还是高级应用程序路由规则(DAR 配置)。应用程序启动顺序设置
使用此页面定义将“会话启动协议” (SIP) 请求路由到应用程序的顺序。SIP 容器定制属性
您可以将任意以下定制属性添加到会话开始协议 (SIP) 容器的配置设置中。缺省应用程序路由器规则集合
使用此页面来查看或修改缺省应用程序路由器 (DAR) 路由规则或导入新的 DAR 配置文件。DAR 是“会话启动协议”(SIP) 应用程序路由器,您可以使用该路由器来选择触发 SIP 应用程序的顺序。缺省应用程序路由器规则设置
使用此页面编辑应用程序路由器规则的详细信息。
相关概念:


http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tcea_sipapprouter_cfg
文件名:tcea_sipapprouter_cfg.html