实验6TLQ中间件安装及配置

1、e-Bridge 电信业务平台实验指导书 实施类实验六TongLink/Q中间件安装及配置 知识准备6.1 1了解中间件概念、中间件类型、中间特点； 2了解TongLink/Q中间件功能及特点、基本原理。无 实验目的6.2 1掌握TongLink/Q的安装及配置； 2掌握中间件配置中队列、通道、节点等一些基本概念； 3掌握TongLink/Q中间件通信原理。 训练内容6.3 6.3.1 硬件、软件准备1、安装好RehHat LinuxAS5系统的PC机一台（RedHat LinuxAS5也可运行在虚拟机上）。2、Linux版本TongLink/Q中间件软件一套。3、文件上传ftp工具。6.3.

2、2 数据准备无。 实验设备及实验网络拓扑6.4 直接在Linux操作系统上进行操作或者Linux操作系统安装在VMware虚拟机上，所以只需要将虚拟机与PC机相连。 实验步骤6.5 .上传文件到服务器在本机利用ftp工具将TongLink/Q的安装tar包（TLQ63.tar）传到/opt/xunfang/目录（以bin方式上传）。6.5.2执行解压安装执行命令cd /opt/xunfangtar xvf TLQ63.tar #解压完成即安装完毕6.5.3 配置环境变量vi /etc/profile将以下添加到配置文件中export

3、 TLQHOMEDIR=/opt/xunfang/TLQ63export TLQCONFDIR=/opt/xunfang/TLQ63/etcexport TLQLOGDIR=/opt/xunfang/TLQ63/logexport TLQFILESDIR=/opt/xunfang/TLQ63/filesexport TLQSNDFILESDIR=/opt/xunfang/TLQ63/sndfilesexport TLQRCVFILESDIR=/opt/xunfang/TLQ63/rcvfilesexport TLQMSGDIR=/opt/xunfang/TLQ63/msgexport LD_L

4、IBRARY_PATH=$TLQHOMEDIR/libCLASSPATH中增加：$TLQHOMEDIR/java/lib/tlqadapter.jar:$TLQHOMEDIR/java/lib/TlqMng.jar:$TLQHOMEDIR/java/lib/tlqConf.jarPATH中增加：:$TLQHOMEDIR/bin: $TLQHOMEDIR/java/bin:配置完成后，执行source /etc/profile,使配置生效。6.5.4 覆盖配置文件将TlqLicense覆盖到 /opt/xunfang/TLQ63/etc目录下。6.5.5 TongLINK/Q系统目录结构 文件目

5、录名对应的环境变量描述信息TLQ63TLQHOMEDIR TLQ6.2的系统安装路径Bin PATH 可执行程序的存放目录Lib 开发接口函数 Incl 开发接口头文件 java 可执行程序和类库的存放目录 samples 示例程序 Etc TLQCONFDIR 存放配置文件、启动描述文件的目录msg TLQMSGDIR 系统启动后存放系统中队列的映射文件files TLQFILESDIR 消息传输过程中，消息中的文件的存放目录sndfiles TLQSNDFILESDIR 消息传输过程中，发送消息文件的存放目录 rcvfiles TLQRCVFILESDIR 消息传输过程中，接收消息文件的存

6、放目录 Log TLQLOGDIR 存放日志文件的目录使用说明： 前六个文件目录名为开发、运行使用，必须放在指定的目录下； 后六个文件目录名为节点使用，可以放在其他目录下，但要与环境变量一致。 另外，java文件目录下有两个子目录：bin 和lib 。bin文件目录下主要存放一些.bat文件和.config文件； lib文件目录下主要存放.jar文件：tlclient.jar、tlqadapter.jar和TlqMng.jar。tlqadapter.jar：为JNI方式的Java 接口类。tlclient.jar：为JMS方式的Java 接口类。TlqMng.jar：界面配置包。TLQ 根目录

7、下MSG目录文件一般不要删除，或删除要小心，因为可能存在传输不完整或接收不完整的消息。TongLINK/Q系统重新启动时要对文件中的消息进行恢复。而且，启动时，重新创建这些队列在硬盘上的对应文件也需要时间。6.5.6 windows安装TLQ6.3程序1、 执行“Install_TLQ1_W.exe”安装程序2、 连续点击“Next”按钮，后面的设置采用默认即可3、 点击“Install”按钮，执行安装，出现如下界面表示安装完成4、将TlqLicense拷贝到C:Program FilesTongtechTLQ63etc目录下。6.5.7 windows下连接linux服务器进

8、行配置IP地址为连接到安装TLQ的linux服务器地址，端口固定为10242。6.5.8 核心配置选择“静态配置” “核心配置”（或使用功能键），即可进行系统的各项参数配置。出现“本地核心静态配置”界面如下： 下面几小节将进行详细介绍各项参数的配置。 系统参数配置本地核心静态配置的界面如下图所示： 基本配置参数说明： 程序记录数：系统允许注册的最多的程序记录数，默认值为：20。 进程记录数：系统允许同时最多的应用进程数，默认值为：100。 客户端连接数限制：系统允许同时最多的客户端连接数，默认值为：500。 发送队列数：系统允许的最多发送队列数，默认值为：100。 接收队列数：系统允许的最多接

9、收队列数，默认值为：100。 QIN管道记录数：消息队列QIN的最大消息数限制，默认值为：1000。 QOUT管道记录数：消息队列QOUT的最大消息数限制，默认值为：1000。 QAUX管道记录数：消息队列QAUX的最大消息数限制，默认值为：1000。 发送缓冲区记录数：发送数据缓冲区的最大记录数限制，一条记录存放1k数据，默认值为：1000。 接收缓冲区记录数：接收数据缓冲区的最大记录数限制，一条记录存放1k数据，默认值为：1000。 TLQ预留端口号：从预留端口号开始之后的10个端口号为TLQ专用。+0为本地节点端口号+1为tlqCliBroker客户端代理的端口号； +2为tlqSupe

10、rvise监控代理的端口号。系统中用到的端口号必须在5000-65535之间。 日志级别：TongLINK.sys日志记录的详细程度。共三个级别：0级、1级、2级。0级不记任何东西；1级只记网络信息；2级包括消息信息。在本地核心静态配置的界面中，单击“高级配置”按钮，弹出系统高级配置界面如下：高级配置参数说明： 路由记录数：系统允许的最多转发记录数，默认值为：50。 上级节点数：系统允许的最多上级节点个数，默认值为：50。 下级节点数：系统允许的最多下级节点个数，默认值为：50。 网络节点数：网络节点数限制，默认值为：200。 网络发送队列数 ：网络发送队列数限制，默认值为：100。 接收保留

11、历史消息数：接收保留历史消息数限制，默认值为：100。 数据包转文件限制：数据包转文件发送大小限制，单位为 K bytes。默认为：-1。 如果MaxPktSize0，发送类型为大数据包，且发送数据长度超过定义值，则大数据包自动转换到临时文件中。 如果MaxPktSize = 0，则数据包永远不会转为文件发送。 如果数据包在加密压缩后的长度仍然大于MaxPktSize*1024的值，就转为文件发送。 调试日志级别：共五个级别：1级、2级、3级、4级和5级。默认为：4级。(用户不需要关心) 调试日志模式：0xFFFFFFFF表示所有模块的调试日志全部打开。0：表示不输出调试日志。每个功能模块的调

12、试日志与程序逻辑密切相关，不建议支持人员掌握。默认值为：03000fff。(用户不需要关心) 连续处理QIN记录数：一次连续处理QIN队列记录数的限制，1为无限制。 核心检测周期：核心监控进程的检测周期。默认值为3，建议不要修改，如需修改，其值要远小于系统中配置的所有时间。 集群消息核对过程使用缓存数：集群消息核对过程使用缓存的最大数。默认值：200。 集群消息核对具体节点使用缓存数：集群消息核对具体节点使用缓存的最大数。默认值：2000。 集群消息核对超时时间：集群消息核对的超时时间。默认值：10。6.5.9 本地节点参数配置本地节点核心静态配置界面如下图所示： 配置参数说明： 本地节点名：

13、本地节点的名称，必须定义。不能与其已有的上级节点名、下级节点名、路由目的节点名相同。 别名：本地节点别名。 口令 ：本地节点口令。可以为空，也可以修改口令。单击“修改”按钮，弹出“修改口令”界面如下： 若想修改口令，在上面的对话框中分别输入“旧密码”、“新密码”和“确认密码”，单击确定就可以了。 6.5.10 上级节点参数配置上级节点核心静态配置的界面如下图所示：单击“增加”按钮，可增加上级节点的基本配置。增加上级节点的基本配置界面如下图所示：基本配置参数说明： 节点名：上级节点名称。必须定义，并且不能与本节点名、本节点的下级节点名或本节点的其他上级节点名相同。 IP地址：上级节点的IP地址。

14、配置此项，就不用在hosts文件中配置。 端口号：上级节点连接端口号。必须定义。端口号必须在5000-65535之间。 线路类型：上级节点线路类型，包括100M LAN，10M LAN，动态连接，拨号连接。默认值为：10M LAN。 用户名：只适用拨号类型。 用户密码：只适用拨号类型。在增加上级节点界面中，单击“高级配置”按钮，出现缺省上级节点的高级配置，可以修改默认值。缺省上级节点的高级配置界面如下图所示：高级配置参数说明： 维持时间：无数据接收时的线路维持时间。其值要大于检测时间核心检测周期（系统参数描述表中），单位为：秒，默认值为：50。 检测时间：数据发送的最大时间间隔。单位为：秒，默

15、认值为：30。 连接有效时间：向上级节点的连接请求的等待应答超时时间。单位为：秒，默认值为：30。 重建连接等待时间：线路断开后向上级节点重新建立连接的时间间隔。单位为：秒，默认值为：30。 可连续发送数据块个数：线路可连续发送数据块个数（一块数据大小1k）。默认值为：8。 可连续接收数据块个数：线路可连续接收数据块个数（一块数据大小1k）。默认值为：4。 发送缓冲区大小：系统发送缓冲区大小。单位为： bytes，默认值为：32768。 接收缓冲区大小：系统接收缓冲区大小。单位为： bytes，默认值为：32768。 是否支持备份路由：取值为：是或否；是为支持，否为不支持；默认值：否。 路由转

16、发消息记录数：为路由转发节点，用于存放要求转发的消息记录数，单位为K。默认值：100。 转发消息连续发送数据块数：转发消息时连续发送数据块的比例数。默认值：4。 系统信息记录数：用于存放系统信息记录数。默认值：10。 安全出口标志：用于定义安全出口。分为三个层：网络层、传输层和API层。若存在安全出口，网络层是必选项。传输层和API层是可选项，即选择传输层和API层中的一种，网络层自动选上。若不存在安全出口，三项不选。默认为：空。 补充说明：在基本配置中说明的参数，在高级配置中不再说明。使用提示 可以 “增加”上级节点；也可以“修改”或“删除”已定义的上级节点。当要“修改”或“删除”已定义的上

17、级节点时，首先先选择表中要修改或删除的上级节点，然后才能对上级节点进行“修改”或“删除”。“排序”功能可以使节点按节点名的字母顺序排序。 当上级节点数超过系统参数配置中定义的最大上级节点数时，不能再增加上级节点。 增加的上级节点名不能与本地节点名和已配置的上级或下级节点名相同。 修改或删除上级节点时，如果该上级节点已经在发送队列里定义了，不能修改上级节点名或删除上级节点。 上级节点的维持时间大于检测时间。 6.5.11 下级节点参数配置下级节点核心静态配置的界面如下图所示：单击“增加”按钮，可以增加下级节点。增加下级节点的界面如下图所示：基本配置参数说明： 节点名：下级节点名称。必须定义，并且

18、不能与本节点名、本节点名的上级节点或本节点名的其他下级节点名相同。 口令：下级节点口令，可以为空。在增加下级节点界面中，单击“高级配置”按钮，出现缺省下级节点的高级配置，可以修改默认值。缺省下级节点的高级配置界面如下图所示：高级配置参数说明： 等待下级节点注册时间：收到下级节点的连接请求后，等待下级节点注册的时间间隔。单位为：秒，默认值：30。 状态：下级节点状态。分别为正常、 暂停使用、错误。默认为：正常。 是否支持备份路由：是否支持备份路由。取值为：是或否；是为支持，否为不支持；默认值：否。 路由转发消息记录数：路由转发消息记录数。为路由转发节点，用于存放要求转发的消息数，单位为K。默认值

19、：100。 转发消息连续发送数据块数：转发消息时连续发送数据块的比例数。默认值：4。 系统信息记录数：用于存放系统信息记录数限。默认值：10。补充说明： 在基本配置中说明的参数，在高级配置中不再说明。6.5.12 程序配置程序核心静态配置的界面如下图所示：单击“增加”按钮，可以增加程序记录。增加程序记录的界面如下图所示：配置参数说明： 程序编号：应用程序编号。必须定义且唯一。 程序注释：程序注释信息，长度限制为8字节。 类型：程序类型为触发程序、周期程序、定时程序、客户程序。必须定义。 最大数：该类应用程序最大注册数。必须定义。当时间条件符合，核心自动启动进程（根据此项配置的配置数决定）；当应

20、用最大注册数达到时，进程将无法再启动，进程的退出时间和条件由应用自己决定。 控制参数：启动控制参数。不同的程序类型对应的参数含义不同。 程序类型对应的控制参数含义如下： 周期程序(Period)：表示周期启动程序的间隔时间，且必须大于系统的核心检测周期TimeV；单位为秒。触发程序（Trig）：作为第二个参数传给应用进程。客户程序（Client）：不需要定义。定时程序（Time）：表示程序启动的时间。主要有四种格式： YYYYMMDD,HH:MM（年月日，时:分） *MMDD,HH:MM（*月日，时:分） *DD,HH:MM（*日，时:分） *,HH:MM（*，时:分） 程序名：可执行程序名称

21、。必须定义。 使用提示： 当前程序数超过系统参数配置中定义的程序记录限制时，不能再增加程序。 修改或删除程序时，如果该程序编号已经在接收队列里使用了，不能修改程序编号或删除程序。 增加的程序编号不能与已有的程序编号相同，若增加的程序编号与已有的程序编号相同，则会弹出“错误”对话框提示：“该程序已存在。” 可以 “增加”应用程序；也可以“修改”或“删除”已定义的应用程序。当要“修改”或“删除”已定义的应用程序时，首先先选择表中要修改或删除的应用程序，然后才能对应用程序进行“修改”或“删除”。“排序”功能可以使程序按程序编号的字母顺序排序。 6.5.13 发送队列配置发送队列核心静态配置的界面如下

22、图所示：单击“增加”按钮，可以增加发送队列。增加发送队列的界面如下图所示：基本配置参数说明 发送队列名：发送队列名称。 目的节点名：发送队列对应的节点名称。只能在定义过的节点中选择。 接收队列名：接收队列名称。 消息记录数限制：该队列中允许放入的消息记录数最大限制。 消息可用空间限制：该队列中允许消息可用空间的最大限制，单位为 K bytes。 存储模式：分为持久存储和非持久存储。与对应的接收队列的存储模式相同。在增加发送队列界面中，单击“高级配置”按钮，出现缺省发送队列的高级配置，可以修改默认值。缺省发送队列的高级配置界面如下图所示：高级配置参数说明 消息连续发送个数限制：同时发送消息个数的

23、最大限制。默认值：10。 数据块大小：一次发送数据块大小，单位为 K bytes，最小取值为1k，最大取值为8k。默认值：4。 数据块超时时间：数据块发送的超时时间，单位为秒。要小于消息的生命周期。默认值：20。 不相临节点连续发送数据块个数限制：不相邻节点连续发送数据块个数最大限制。默认值：4。 相临节点系统队列记录数限制：相邻节点系统队列记录数最大限制。默认值：10。对发送队列设定优先级，首先在发送队列配置表中选取要设定优先级的队列，然后单击优先级一栏中的“增加”按钮，增加优先级界面如下：优先级配置参数说明 优先级编号：优先级的编号。 必须定义且唯一。 限制取110之间的10个数，最小取值为1，最大取值为10。 可连续发送数据块比例数：可连续发送数据块的比例数。必须定义。默认值：4。使用提示 当前发送队列个数不能超过系统的发送队列个数限制。 删除发送队列时，其定义的优先级也同时被删除。 每