常见问题处理指南.docx

常见问题处理指南.docx

《常见问题处理指南.docx》由会员分享，可在线阅读，更多相关《常见问题处理指南.docx（13页珍藏版）》请在冰豆网上搜索。

常见问题处理指南

TongLINK/Q常见问题处理指南

北京东方通科技支持服务中心

目录

1.引言3

2.故障处理前期准备3

3.故障处理流程4

3.1.故障处理流程4

3.2.节点运行诊断流程4

3.2.1.操作系统核心参数5

3.2.2.TongLINK/Q环境变量6

3.2.3.查看TongLINK/Q配置文件6

3.2.4.查看系统资源和进程7

3.2.5.查看TongLINK.sys文件8

3.3.网络连接诊断流程9

3.3.1.网络层连通性诊断9

3.3.2.使用TongLINK/Q命令检测节点间的连通性10

3.4.检查队列中的消息11

3.4.1.检查错误日志TongLink.sys12

4.【附录】13

4.1.常用系统命令13

4.2.核心参数13

4.3.setp文件Demo14

1.引言

TongLINK/Q的常见故障主要出现在基于TongLINK/Q架构的应用系统运行时。

此文档将重点描述如何判断和处理TongLINK/Q常见的故障问题。

2.故障处理前期准备

在进行故障处理之前，必须先了解TongLINK/Q运行环境的相关信息，具体的信息需求如表格所示：

类型

内容

备注

操作系统类型

操作系统版本

TongLINK/Q产品版本

TongLINK/Q架构模式

故障现象描述

项目名称

客户名称

联系人

联系电话

图2.1故障处理需求表

注：

1、表格中红色字体选项是东方通科技公司支持服务中心人员进行故障处理时必须了解的信息；

2、“TongLINK/Q架构模式”包括多节点、转发、集群、订阅/发布、JMS等；

3.故障处理流程

3.1.故障处理流程

TongLINK/Q故障处理顺序如下：

查看节点运行情况、查看网络运行状况、判断队列中消息运行情况、查看应用日志判断故障等；具体的总流程如下：

图3.0故障处理总流程

3.2.节点运行诊断流程

在处理TongLINK/Q可能出现的问题时，首先需要要确保客户方和服务方的TongLINK/Q正常运行，网络连接正常，并且机器资源够用。

具体的处理流程如下图3.2所示：

图3.1节点运行诊断流程

每一检查点的具体步骤描述将在下文具体描述。

3.2.1.操作系统核心参数

操作系统核心参数的大小会影响TongLINK/Q的正常运行（包括启动）。

TongLINK/Q运行时需要调整的操作系统核心参数包括共享内存、信号灯、打开文件数、进程数等。

另外，还必须保证当前操作系统的内存、CPU以及安装TongLINK/Q的当前用户磁盘空间足够用。

具体查看命令查看附录中“常见操作系统命令”部分。

3.2.2.TongLINK/Q环境变量

需要检查TongLINK/Q的环境变量是否齐全，并且指向的目录正确。

在UNIX和LINUX系统中可以用命令行的方式查看TongLINK/Q环境变量是否正确，正确显示入下（假设安装TongLINK/Q的是tlq用户，安装在/home/tlq目录下）：

$su–tong

$env|grepTLQ

TLQHOMEDIR=/home/tlq

TLQMSGDIR=/home/tlq/msg

TLQCONFDIR=/home/tlq/etc

TLQRCVFILESDIR=/home/tlq/rcvfiles

TLQSNDFILESDIR=/home/tlq/sndfiles

TLQFILESDIR=/home/tlq/files

TLQLOGDIR=/home/tlq/log

$env|grepPATH

PATH=.:

/home/tlq/bin:

……

#假如需要启动管理界面或者运行java程序，还应该有与java相关的环境变量

注：

TongLINK/Q自身的环境变量包括：

●TLQCONFDIR------配置文件的存放目录

●TLQLOGDIR-------日志文件的存放目录

●TLQFILESDIR-----传输文件存放目录

●TLQSNDFILESDIR----消息传输过程中，发送消息文件的存放目录

●TLQRCVFILESDIR---消息传输过程中，接收消息文件的存放目录

●TLQMSGDIR-------系统中队列的映射文件存放目录

●PATH------------可执行程序的存放目录

●CLASSPATH-------JMS和JAVA接口的存放目录

●JAVA_HOME-------指向JDK的安装路径

●PATH：

TongLINK/Q核心进程已经应用程序服务方程序存放路径

假如使用Java应用程序还需要根据操作系统的不同设定相关的LD_LIBRARY_PATH/SHLIB_PATH/SHLIB_PATH等

以上参数的具体设定方法见TongLINK/Q手册《TongLINKQ系统管理》第2章“运行”中“配置环境变量”章节的描述。

3.2.3.查看TongLINK/Q配置文件

●TongUser.Conf

主要关注下级节点该配置文件中[UpNodeRecord]小节的“UpName”、“ConnPort”和“NodeIP”项的值与上级节点该配置文件中[SelfNode]的“LocalNodeName”、[System]中的“ListenPort”以及上级节点所在机器的IP地址分别一一对应；另外上级节点[DownNodeRecord]小节的“DownName”与下级节点中[SelfNode]的“LocalNodeName”一一对应；

每个发送队列中“QueDestNode”必须在节点配置中配置（上级或者下级节点）；

各配置文件配置项的具体描述见TongLINK/Q手册《TongLINK/Q系统管理》第3章“参数配置”中各章节的描述；

3.2.4.查看系统资源和进程

TongLINK/Q45正常运行后，产生的IPC资源包括：

5块共享内存，3块信号灯；并且至少有2个进程启动（tld、tmoni，假如远程代理或者JMS服务还应该有其他的进程）。

如下所示：

$su–tlq

$ipcs|greptlq

m34079200x124c0b73--rw-rw-rw-tlqusr

m30147310x124c0b51--rw-rw-rw-tlqusr

m111412480x124c0b6d--rw-rw-rw-tlqusr

m211027320x124c0b61--rw-rw-rw-tlqusr

m149423810x124c0b50--rw-rw-rw-tlqusr

s117965100x124c0b50--ra-ra-ra-tlqusr

s183501260x4624c0b2--ra-ra-ra-tlqusr

s14419100x124c0b71--ra-ra-ra-tlqusr

$ps-ef|greptong

tlq689281111:

56:

51-0:

35/home/tlq/bin/tlqd

tlq735141011:

56:

51-0:

00/home/tlq/bin/tlqmoni

……

如果与此不符合，说明TongLINK/Q启动不正常，需要停止TongLINK/Q，停止与TongLINK/Q相关的进程，清空与TongLINK/Q相关的IPC资源，重新启动。

＃查看进程：

$ps-ef|greptlq

tlq689281111:

56:

51-0:

35/home/tlq/bin/tlqd

tlq735141011:

56:

51-0:

00/home/tlq/bin/tlqmoni

……

（能看到一个tlqd和一个tlqmoni进程存在，表示启动正常）

＃停止进程：

$kill－968928－973514

＃查看IPC资源：

$ipcs|greptong

m108791060x12900ee2--rw-rw----tlqusr

s62914950x12900ee2--ra-ra----tlqusr

……

＃清空IPC资源：

$ipcrm–m10879106-m13631628–s1048665

在TongLINK/Q启动时，如果操作系统的IPC资源不足，则在启动时TongLINK.sys日志中出现错误提示信息：

例如：

3.2.5.查看TongLINK.sys文件

系统正常启动的日志如下：

$su–tlq

$tlq

Becauseofthelargesizequeues,StartKernelprocessmaybetakeafewminutes....

TongLINK/QstartOK!

否则，说明TongLINK/Q启动有问题；具体的问题处理详见“TongLINK/Q问题集”。

3.3.网络连接诊断流程

图3.2网络连接诊断流程

3.3.1.网络层连通性诊断

TongLINK/Q两个节点连接不通，如果节点自身运行、配置没有问题，那么出现问题的原因可能是：

●网络不通；

检查及解决方法：

在下级节点所在机器执行：

“ping上级节点所在机器IP地址”

假如ping不通说明网络有问题，联系网络管理员解决问题；

●下级节点或者上级节点机器上有防火墙，并且没有开放TongLINK/Q监听端口，阻值了TongLINK/Q节点间的连通；

检查及解决方法：

在下级节点所在机器执行如下命令：

telnet上级节点机器IP地址监听端口号

如果执行后窗口无任何字符显示，并且锁死，不能进行任何操作则为正常结果，即IP地址和端口号均可用；否则联系网络管理员解决问题；例如：

＃在unix操作系统有如下显示表示端口号可用：

$telnet168.1.1.11150010

Trying...

Connectedto168.1.1.111.

Escapecharacteris'^]'.

Connectionclosed.

＃如果有如下显示表示不可用

$telnet168.1.1.11110240

Trying...

telnet:

connect:

Aremotehostrefusedanattemptedconnectoperation.

●TongLINK/Q上级节点所在机器没有开通TongLINK/Q监听端口（上级节点TongLINK.conf文件中“SelfPort”所指的端口号；

检查及解决方法同上；

●有两个下级节点重名；

检查及解决方法：

在服务方节点，如果用tlqstat–l命令屏幕显示某一下级节点连接状态时断时续，并且上级节点的TongLINK.sys中有如下错误信息有如下信息“CheckSIPNameerror,……,alreadyexist”等信息，说明有两个不同IP地址的下级节点名重名了。

通用解决方法是修改其中之一节点名名称，因为在同一个TongLINK/Q节点构造的网络中，节点名必须唯一；

3.3.2.使用TongLINK/Q命令检测节点间的连通性

用tlq用户登录并执行tlqstat命令判断节点是否连通

$su-tlq

$tlqstat–l

#节点不通信息显示举例如下：

:

[M123456789012]

:

[TLQ5220]----------DISCONN

=====================121309:

18:

10.083===============================

#节点连通信息举例如下：

:

[M123456789012]

:

[TLQ5220]----------CONNECTIP=168.1.1.139PORT=47233

=====================121309:

18:

10.083===============================

如果tlqstat-l显示DISCONN状态,证明与接收节点的TongLINK/Q没有成功连接，请参看“3.3.1网络层连通性诊断”中的诊断步骤。

3.4.检查队列中的消息

●检查发送队列消息数命令：

tlqstat–s发送队列名

（假设发送队列名是send）

$tlqstat-ssend

……

[SNDQ0,A][P1]:

[WAITMSGLINKHEAD]:

Head=1Tail=1Num=1Max=2Min=0Limit=1000cSize=424Ptr=0

……

“Num=1”表示当前名为send的发送队列中消息的数量是1。

如果在发送队列中有消息堆积，可能原因是：

✧消息发向的目的地节点与此节点连接不通，或者目的节点名不对；

✧目的节点对应此发送队列的接收对列已满；

✧其他的原因请参看“TongLINK/Q问题集”。

●检查接收队列消息数命令：

tlqstat–r接收队列名

（假设接收队列名是RcvQ1）

$tlqstat-rRcvQ1

……

[ReadyMsgsLinkHandle]:

Head=0Tail=0Num=1Max=1Min=0Limit=2000Size=424Ptr=0

……

“Num=1”表示当前名为RcvQ1的接收队列中消息的数量是1。

如果在接收队列中有消息堆积，可能原因是：

✧接收对列已满（可能原因：

没有应用程序接收消息或者接收进程太少）；

✧用条件选择模式接收消息，但队列中的消息都不符合选择条件；

✧其他的原因请参看“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表示警告信息，I表示正常；

✧蓝色标识的信息（052317:

34:

22.880）是日志发生的时间，精确到毫秒。

✧红色标识的用冒号分割开信息（|1:

67:

67|）是TongLINK/Q记载的3个错误号，其中第一个数字是TongLINK/Q的错误号，对应的错误信息可以用“tlqerr错误号”去查找对应的错误信息，第二个数字是Unix下的系统错误号，对应的错误信息可从/usr/include/error.h文件中查找，第三个数字是Win平台下的错误号，使用MicrosoftVisualStudio所带的Tools中的“errorlookup”工具进行查看。

4.【附录】

4.1.常用系统命令

◆跟踪日志

tail–ffilename

◆查看ipc资源

ipcs|greptong

◆删除ipc资源

ipcrm-m序号–s序号–q序号

◆查看端口状态

netstat–an

◆查看系统进程

ps–ef|greptong

◆cpu使用状态

top、sar、vmstat

4.2.核心参数

◆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文件Demo

Windows举例：

假设TongLINK/Q安装在C:

\ProgramFiles\Tongtech\TLQ63目录下，环境变量如下：

setTLQHOMEDIR=C:

\ProgramFiles\Tongtech\TLQ63

setTLQCONFDIR=%TLQHOMEDIR%\etc

setTLQMSGDIR=%TLQHOMEDIR%\msg

setTLQLOGDIR=%TLQHOMEDIR%\log

setTLQRCVFILESDIR=%TLQHOMEDIR%\rcvfiles

setTLQSNDFILESDIR=%TLQHOMEDIR%\sndfiles

setPATH=%PATH%;%TLQHOMEDIR%\bin;

set

CLASSPATH=%CLASSPATH%;%TLQHOMEDIR%\java\lib\tlclient.jar;%TLQHOMEDIR%\java\lib\tlqadapter.jar;%TLQHOMEDIR%\java\lib\TlqMng.jar

Unix举例：

假设TongLINK/Q安装在/home/TLQ63目录下，环境变量如下：

TLQHOMEDIR=/com/support/TLQ63

TLQCONFDIR=$TLQHOMEDIR/etc

TLQMSGDIR=$TLQHOMEDIR/msg

TLQLOGDIR=$TLQHOMEDIR/log

TLQRCVFILESDIR=$TLQHOMEDIR/rcvfiles

TLQSNDFILESDIR=$TLQHOMEDIR/sndfiles

PATH=$PATH:

$TLQHOMEDIR/bin

CLASSPATH=$CLASSPATH:

$TLQHOMEDIR/java/lib/tlclient.jar:

$TLQHOMEDIR/java/lib/tlqadapter.jar:

$TLQHOMEDIR/java/lib/TlqMng.jar

exportTLQHOMEDIRTLQCONFDIRTLQMSGDIRTLQLOGDIR

TLQRCVFILESDIRTLQSNDFILESDIRPATHCLASSPATH