TongLinkQ常见问题处理指南

1、TongLINK/Q常见问题处理指南北京东方通科技支持服务中心1. 引言3故障处理前期准备3故障处理流程41.1. 故障处理流程41.2. 节点运行诊断流程41.2.1. 操作系统核心参数51.2.2. TongLINK/Q环境变量61.2.3. 查看TongLINK/Q配置文件61.2.4. 查看系统资源和进程71.2.5. 查看TongLINK.sys文件81.3. 网络连接诊断流程91.3.1. 网络层连通性诊断91.3.2. 使用TongLINK/Q命令检测节点间的连通性101.4. 检查队列中的消息112. 检查错误日志TongLink.sys12【附录】132.1. 常用系统命令1

2、32.2. 核心参数132.3. SETP文件DEMO141.引言TongLINK/Q的常见故障主要出现在基丁TongLINK/Q架构的应用系统运行时。此文档将重点描述如何判断和处理TongLINK/Q常见的故障问题。2.故障处理前期准备在进行故障处理之前，必须先了解TongLINK/Q运行环境的相关信息，具体的信息需求如表格所示：类型内容备注操作系统类型操作系统版本TongLINK/Q产品版本TongLINK/Q架构模式故障现象描述项目名称客户名称联系人联系电话图2.1故障处理需求表1、表格中红色字体选项是东方通科技公司支持服务中心人员进行故障处理时必须了解的信息；3.故障处理流程3.1.故

3、障处理流程TongLINK/Q故障处理顺序如下：查看节点运行情况、查看网络运行状况、判断队列中消息运行情况、查看应用日志判断故障等；具体的总流程如下：3.2. 图3.0故障处理总流程节点运行诊断流程在处理TongLINK/Q可能出现的问题时，首先需要要确保客户方和服务方的TongLINK/Q正常运行，网络连接正常，并且机器资源够用。具体的处理流程如下图3.2所示：TH图3.1节点运行诊断流程每一检查点的具体步骤描述将在下文具体描述。3.2.1.操作系统核心参数操作系统核心参数的大小会影响TongLINK/Q的正常运行（包括启动）。TongLINK/Q运行时需要调整的操作系统核心参数包括共享内存

4、、信号灯、打开文件数、进程数等。另外，还必须保证当前操作系统的内存、CPU以及安装TongLINK/Q的当前用户磁盘空间足够用。具体查看命令查看附录中“常见操作系统命令”部分3.2.2.TongLINK/Q环境变量需要检查TongLINK/Q的环境变量是否齐全，并且指向的目录正确。在UNIX和LINUX系统中可以用命令行的方式查看TongLINK/Q环境变量是否正确，正确显示入下（假设安装TongLINK/Q的是tlq用户，安装在/home/tlq目录下）：$sutong$env|grepTLQTLQHOMEDIR=/home/tlqTLQMSGDIR=/home/tlq/msgTLQCONF

5、DIR=/home/tlq/etcTLQRCVFILESDIR=/home/tlq/rcvfilesTLQSNDFILESDIR=/home/tlq/sndfilesTLQFILESDIR=/home/tlq/filesTLQLOGDIR=/home/tlq/log$env|grepPATHPATH=.:/home/tlq/bin:#假如需要启动管理界面或者运行java程序，还应该有与java相关的环境变量TongLINK/Q自身的环境变量包括：TLQCONFDIR配置文件的存放目录TLQLOGDIR日志文件的存放目录TLQFILESDIR-传输文件存放目录TLQSNDFILESDIR-消息传

6、输过程中，发送消息文件的存放目录TLQRCVFILESDIR-消息传输过程中，接收消息文件的存放目录TLQMSGDIR系统中队列的映射文件存放目录PATH可执行程序的存放目录CLASSPATHJM济口JAVZ®口的存放目录JAVA_HOME指向JDK勺安装路径PATH:TongLINK/*心进程已经应用程序服务方程序存放路径假如使用Java应用程序还需要根据操作系统的不同设定相关的LD_LIBRARY_PATH/SHLIB_PATH/SHLIB_PATH以上参数的具体设定方法见TongLINK/Q手册TongLINKC统管理第2章“运行”中“配置环境变量”章节的描述。TongUser

7、.Conf主要关注下级节点该配置文件中UpNodeRecord小节的“UpName”、“ConnPorf和“NodelP”项的值与上级节点该配置文件中SelfNode的“LocalNodeName”、System中的“ListenPort”以及上级节点所在机器的IP地址分别一一对应；另外上级节点DownNodeRecord小节的“DownName”与下级节点中SelfNode的“LocalNodeName”一一对应；每个发送队歹0中“QueDestNodd必须在节点配置中配置（上级或者下级节点）；各配置文件配置项的具体描述见TongLINK/Q手册TongLINK/Q系统管理第3章“参数配置&

8、quot;中各章节的描述；3.2.4.查看系统资源和进程TongLINK/Q45正常运行后，产生的IPC资源包括：5块共享内存，3块信号灯；并且至少有2个进程启动（tld、tmoni，假如远程代理或者JMS服务还应该有其他的进程）。如下所示：$su-tlq$ipcs|greptlqm34079200x124c0b73-rw-rw-rw-tlqusrm30147310x124c0b51-rw-rw-rw-tlqusrm111412480x124c0b6d-rw-rw-rw-tlqusrm211027320x124c0b61-rw-rw-rw-tlqusrm149423810x124c0b50-r

9、w-rw-rw-tlqusrs117965100x124c0b50-ra-ra-ra-tlqusrs183501260x4624c0b2-ra-ra-ra-tlqusrs14419100x124c0b71-ra-ra-ra-tlqusr$ps-ef|greptongtlq689281111:56:51-0:35/home/tlq/bin/tlqdtlq735141011:56:51-0:00/home/tlq/bin/tlqmoni如果与此不符合，说明TongLINK/Q启动不正常，需要停止TongLINK/Q,停#查看进程：$ps-ef|greptlqtlq689281111:56:51-0

10、:35/home/tlq/bin/tlqdtlq735141011:56:51-0:00/home/tlq/bin/tlqmoni（能看到一个tlqd和一个tlqmoni进程存在，表示启动正常）#停止进程：$kill-968928-973514#查看IPC资源：$ipcs|greptongm108791060x12900ee2-rw-rw-tlqusrs62914950x12900ee2-ra-ra-tlqusr#清空IPC资源：$ipcrmm10879106-m13631628s1048665在TongLINK/Q启动时，如果操作系统的IPC资源不足，则在启动时TongLINK.sys日志中

11、出现错误提示信息：例如：3.2.5.查看TongLINK.sys文件系统正常启动的日志如下：$su-tlq$tlqBecauseofthelargesizequeues,StartKernelprocessmaybetakeafewminutes.TongLINK/QstartOK!否则，说明TongLINK/Q启动有问题；具体的问题处理详见“TongLINK/Q网络连接诊断流程图3.2网络连接诊断流程3.3.1.网络层连通性诊断TongLINK/Q两个节点连接不通，如果节点自身运行、配置没有问题，那么出现问题的原因可能是：网络不通；检查及解决方法：在下级节点所在机器执行：“ping上级节点所

12、在机器IP地址”假如ping不通说明网络有问题，联系网络管理员解决问题；下级节点或者上级节点机器上有防火墙，并且没有开放TongLINK/Q监听端口，阻值了TongLINK/Q节点间的连通；检查及解决方法：在下级节点所在机器执行如下命令：telnet上级节点机器IP地址监听端口号如果执行后窗口无任何字符显示，并且锁死，不能进行任何操作则为正常结果，即IP地址和端口号均可用；否则联系网络管理员解决问题；例如：#在unix操作系统有如下显示表示端口号可用：$telnet168.1.1.11150010Trying.Connectedto168.1.1.111.Escapecharacteris&#

13、39;A'.Connectionclosed.#如果有如下显示表示不可用$telnet168.1.1.11110240Trying.telnet:connect:Aremotehostrefusedanattemptedconnectoperation.TongLINK/Q上级节点所在机器没有开通TongLINK/Q监听端口（上级节点TongLINK.conf文件中“SelfPort”所指的端口号；检查及解决方法同上；有两个下级节点重名;检查及解决方法：在服务方节点,如果用tlqstatH命令屏幕显示某一下级节点连接状态时断时续，并且上级节点的TongLINK.sys中有如下错误信息有

14、如下信息“CheckSIPNameerror,；alreadyexist'等信息,说明有两个不同IP地址的下级节点名重名了。通用解决方法是修改其中之一节点名名称，因为在同一个TongLINK/Q节点构造的网络中，节点名必须唯一；3.3.2.使用TongLINK/Q命令检测节点间的连通性用tlq用户登录并执行tlqstat命令判断节点是否连通$su-tlq$tlqstatl#节点不通信息显示举例如下：<Self>:M123456789012<Toup>:TLQ5220DISCONN=121309:18:10.083=#节点连通信息举例如下：<Self>

15、:M123456789012<Toup>:TLQ5220CONNECTIP=168.1.1.139PORT=47233=121309:18:10.083=如果tlqstat-l显示DISCONN状态，证明与接收节点的TongLINK/Q没有成功连接，请参看“3.3.1网络层连通性诊断”中的诊断步骤。检查队列中的消息检查发送队列消息数命令：tlqstatw发送队列名（假设发送队列名是send）$tlqstat-ssend.SNDQ0,AP1:WAITMSGLINKHEADHead=1Tail=1Num=1Max=2Min=0Limit=1000cSize=424Ptr=0“Num=1

16、”表示当前名为send的发送队列中消息的数量是1。如果在发送队列中有消息堆积，可能原因是：消息发向的目的地节点与此节点连接不通，或者目的节点名不对；目的节点对应此发送队列的接收对列已满；其他的原因请参看“TongLINK/Q问题集”。检查接收队列消息数命令：tlqstat丁接收队列名（假设接收队列名是RcvQ1）$tlqstat-rRcvQI.ReadyMsgsLinkHandle:Head=0Tail=0Num=1Max=1Min=0Limit=2000Size=424Ptr=0"Num=1”表示当前名为RcvQ1的接收队列中消息的数量是1。如果在接收队列中有消息堆积，可能原因是：

17、接收对列已满（可能原因：没有应用程序接收消息或者接收进程太少）；用条件选择模式接收消息，但队列中的消息都不符合选择条件；其他的原因请参看“TongLINK/Q问题集”。3.4.1.检查错误日志TongLink.sys错误日志TongLink.sys文件位丁$TLQLOGDIR环境变量对应的目录下（即TongLink/Q安装目录下的log目录）。错误分析具体如下：#TongLINK.sys信息举例：.E052317:34:22.880|2|31698|tlqsocket.c|173|1:67:67|InitListenSockbind9error每行的最开始是该行信息的类型，E表示错误信息，W表

18、示警告信息，I表示正常；蓝色标识的信息（052317:34:22.88。是日志发生的时间，精确到毫秒。红色标识的用冒号分割开信息（|1:67:670是TongLINK/Q记载的3个错误号，其中第一个数字是TongLINK/Q的错误号，对应的错误信息可以用“tlqerr错误号”去查找对应的错误信息，第二个数字是Unix下的系统错误号，对应的错误信息可从/usr/include/error.h文件中查找，第三个数字是Win平台下的错误号，使用MicrosoftVisualStudio所带的Tools中的“errorlookup工具进行查看。4.【附录】常用系统命令跟踪日志tail-ffilenam

19、e查看ipc资源ipcs|greptong删除ipc资源ipcrm-m序号-s序号-q序号查看端口状态netstat-an查看系统进程ps-ef|greptongcpu使用状态top、sar、vmstat核心参数LINUX/proc/sys/kenerl中的文件msg*semshm*HP-UNIX使用sam命令进入界面配置AIX:Vmtune命令SOLARIS/etc/system文件SCOUNIX使用scoadmin进入界面配置编辑/etc/conf/cf.d目录下的stune和mtune两个文件通用命令：ulimited-f同时打开文件个数4.3.setp文件DemoWindows举例：假设TongLINK/Q安装在C:ProgramFilesTongtechTLQ63目录下，环境变量如下：setTLQHOMEDIR=C:ProgramFilesTongtechTLQ63setTLQCONFDIR=%TLQHOMEDIR%etcsetTLQMSGDIR=%TLQHOMEDIR%msgsetTLQLOGDIR=%TLQHOMEDIR%logsetTLQRCVFILESDIR=%TLQHO