短信平台接入网关说明书及常见问题解答.doc

一、 网关介入说明1 网关接入运营商网关接入有2种方式，推荐专线接入安全可靠不易丢包。如果是互联网推荐使用防火墙隔离出互联网DMZ区，保证安全。1.1 专线接入专线接入：下图只做参考，各省可根据实际情况在保证网络安全前提下进行划分网络。移动运营商如果提供MAS机可以和短信平台部署一个网段，MAS机可认为移动的前端网关服务器，它是为了方便移动管理和维护以及安全考虑提供一台MAS机。注意：Mas机是部署在和短信平台同一个局域网内。如果接入Mas机，由于全国MAS厂商很多，所以要主要短信平台和MAS机的连接方式，目前支持的方式：直接提供MAS机的ip，端口配置在短信平台的网关参数配置中。如果是提供相关的api、接口或者数据库连接方式，目前不支持这几种方式，这几个方式出问题了不是很好管理，出现问题不好解决。如果Mas是这样连接的话，请直接采用网关直连的方式。如果是只提供ip和端口就可以了，就相当于mas机就是移动的短信业务平台，就很好管理了，就算有问题也只有网络方面的 1.2 互联网接入互联网接入：下图只做参考，各省可根据实际情况在保证网络安全前提下进行划分网络。移动运营商如果提供MAS机可以和短信平台部署一个网段，MAS机可认为移动的前端网关服务器，它是为了方便移动管理和维护以及安全考虑提供一台MAS机。2 网关参数2.1 移动参数短信平台支持移动CMPP2、CMPP3.0协议，需要运营商提供参数如下：特服号码：12379，短信平台必填项企业代码：移动运营商提供企业id，短信平台必填项网关地址：移动运营商提供网关服务器ip地址，短信平台必填项网关端口：移动运营商提供网关服务器端口号，短信平台必填项登录名称：移动运营商提供登录网关用户名，短信平台必填项登录密码：移动运营商提供登录网关密码，短信平台必填项业务代码：移动运营商提供业务类型，没有提供则为空2.2 电信参数短信平台支持电信SMGP3.0和ISAG协议，SMGP协议需要运营商提供参数如下：特服号码：12379，短信平台必填项企业代码：电信运营商提供企业id，短信平台必填项网关地址：电信运营商提供网关服务器ip地址，短信平台必填项网关端口：电信运营商提供网关服务器端口号，短信平台必填项登录名称：电信运营商提供登录网关用户名，短信平台必填项登录密码：电信运营商提供登录网关密码，短信平台必填项业务代码：电信运营商提供业务代码，没有提供则为空ISAG协议需要运营商提供参数如下：特服号码：12379，短信平台必填项企业代码：电信运营商提供企业id，短信平台必填项网关地址：电信运营商提供网关服务器访问地址“http:/网关IP:网关端口”，短信平台必填项登录名称：电信运营商提供登录网关用户名，短信平台必填项登录密码：电信运营商提供登录网关密码，短信平台必填项服务代码：电信运营商提供服务代码，没有提供则为空产品代码：电信运营商提供产品代码，没有提供则为空回调地址：默认填写http:/短信平台IP:8080/asp/sms/SmsWebService，短信平台必填项2.3 联通参数短信平台支持联通SGIP1.2协议，需要运营商提供参数如下：特服号码：12379，短信平台必填项企业代码：联通运营商提供企业id，短信平台必填项网关地址：联通运营商提供网关服务器ip地址，短信平台必填项网关端口：联通运营商提供网关服务器端口号，短信平台必填项登录名称：联通运营商提供登录网关用户名，短信平台必填项登录密码：联通运营商提供登录网关密码，短信平台必填项本地端口：短信平台自身提供，默认8801，短信平台必填项业务代码：联通电信运营商提供业务代码，没有提供则为空源节点ID：联通电信运营商提供源节点ID，没有默认填写02.4 配置参数短信平台支持5种协议，根据运营商提供的协议短信平台选择对应的协议，然后再进行每个协议的详细参数配置，参数配置完成点击“保存”按钮，在点击“停止”按钮，最后点击“启动”按钮，刷新当前页面查看状态指示灯是否为绿色，绿色代表短信平台与网关服务器联通。3 网关测试下行短信：通过短信平台下发短信给手机。上行短信：通过手机回复短信到短信平台。上行短信和下行短信全部测试成功，网关接入成功。3.1 下行短信用浏览器打开http:/IP:8080/asp短信平台网址，以值班员登录系统，用户名kaifa密码123456登录点击“信息发布”菜单进入信息录入页面，如图所示：由于发预警信息需要审核，为了方便测点击“其他信息”录入内容和手机号码后，点击“保存并发送”按钮。如图所示：点击“回执反馈”菜单查看回执信息，如图所示：点击测试记录的“查看”连接查看回执信息，如图所示：网关回执成功说明网关服务器成功接收短信平台下发信息，回执报告已接收说明手机已经收到短信。下行短信成功。3.2 上行短信上行短信指手机接收到短信后通过短信回复该条信息。要做上行短信测试系统默认必须是调查问卷，因为调查问卷才有短信回复功能。手机收到调查问卷后回复一条短信，点击刚刚回复的手机号码查看短信回复信息。如图所示：看到回复内如，说明上行短信成功。4 注意事项与常见问题一般情况短信平台只需向移动、电信运营商提供短信平台服务器IP，联通需提供短信平台IP和一个端口号8801（短信平台必须开通此端口）。网关参数配置保存后重启指示灯是红色，2种可能一种参数有误与运营商确认，另一种是是网络不通进行telnet+ip+端口方式查看能否连接网关服务器，如图所示：说明连接超时和网络管理员进行确认可能防火或者路由器配置有误。也可以通过traceroute+ip进行跟踪，定位哪个位置不通，如图所示：最后没有看到traceroute的ip地址说明没有通与网络管理员沟通查找原因。二、 短信平台常见问题及解决方法1 注意问题1.1 地市级注意短信平台是以省级为单位进行部署，地市级的发布管理平台的信息会先到达省级发布管理平台，再通过短信平台进行发送。地市级若出现信息发送失败，请先联系查看信息是否到达省级平台。1.2 操作时请谨慎在按照解决方案操作过程中如有疑问或者相关说明不够详细，请随时联系相关人员，切勿不按说明，随意操作后台信息。在解决过程中如果按照方案解决依然失败，请及时联系相关人员。1.3 相关人员联系方式姓名电话QQ梁伟1381125648848644105罗斯洋185012685617340387062 系统无法登陆问题2.1 如何判断系统是否已启动首先利用CRT或者Xshell工具，进入命令行操作界面然后输入以下指令查看进程：ps -ef|grep java当看到有进程存在/opt/app/ASP-TOMCAT这一部分，说明系统已经启动，反之则没有2.2 如何启动系统如果系统没有启动，则利用CRT或者Xshell工具，进入命令行操作界面然后输入以下指令进入目录：cd /opt/app/ASP-TOMCAT/bin接着启动程序：./startup.sh然后查看进程是否启动：ps -ef|grep java当看到有进程存在/opt/app/ASP-TOMCAT这一部分，说明系统启动成功2.3 如何重启系统如果需要重启系统，则先查看系统运行情况：ps -ef|grep java记录进程最前面的进程号，然后关闭进程：kill -9 xxxxx（进程号）然后输入以下指令进入目录：cd /opt/app/ASP-TOMCAT/bin接着启动程序：./startup.sh然后查看进程是否启动：ps -ef|grep java当看到有进程存在/opt/app/ASP-TOMCAT这一部分，说明系统启动成功2.4 如何查看系统运行日志如果系统没有启动，则利用CRT或者Xshell工具，进入命令行操作界面然后输入以下指令进入目录：cd /opt/app/ASP-TOMCAT/logs查看对应日期的日志：tail -f catalina.2011-11-11.out，即可查看日志情况3 与运营商连接问题3.1 如何判断与运营商网关的连接是否成功进入管理员用户，进入参数设置模块->网关参数配置，看三家运营商的指示灯是否为绿色或者进入值班员用户，在主页的右下角，查看三家运营商的连接情况是否为绿色3.2 如何判断线路的中断位置前提是已经获得运营商提供的网关IP地址和端口首先利用CRT或者Xshell工具，进入命令行操作界面采用Telnet的方法：telnet IP 端口号。看是否会提示连接超时或失败,如下图所示说明可以连通。采用traceroute（需要以root身份运行）：traceroute IP，看是否连接到了指定的IP，如未成功的话连接在何处断开3.3 显示已成功连接运营商网关，依然发送失败进入当天的系统日志，发送一条信息，查看系统的回复情况，并与运营商沟通，看运营商方面收到的信息回执状态何处出错。一般常见的有以下几点可能：l 运营商需要业务代码，但是系统上未填写l 运营商未开通相关专线l 发送的是调查问卷，而调查问卷会在12379后加上6未数字附加码，运营商方面未设置模糊匹配，无法识别该号码，这个问题需要和运营商沟通开启模糊匹配。l 运营商未开通黑名单，即免鉴权机制，只能发送指定的白名单号码4 与发布管理平台对接问题4.1 如何判断发布管理平台与短信平台已成功对接首先利用CRT或者Xshell工具，进入命令行操作界面查看Tonglink进程：ps -ef|grep TLQ，如果出现了TLQ的进程，说明Tonglink已连接，如果没有启动请跳到3.2模块。查看连接状态：首先输入tlqstat；输入qcu；按下ctrl+c；输入s；输入rcv_local；输入c，在跳出来的列表页面中，看前三个tlq编号从001-003的队列是否全部监听成功，成功监听的标准是最后的一列数据前三个都为1。4.2 如何启动发布管理平台和短信平台的对接服务注意在启动过程中，一定要保证TLQ先启动，Tomcat后启动首先关闭Tomcat：先查看系统运行情况：ps -ef|grep java记录进程最前面的进程号，然后关闭进程：kill -9 xxxxx（进程号）查看ps -ef|grep TLQ，查看是否启动完成若未启动，执行tlq命令。启动Tonglink然后启动Tomcat，输入以下指令进入目录：cd /opt/app/ASP-TOMCAT/bin接着启动程序：./startup.sh查看进程是否启动：ps -ef|grep java在回到3.1查看连接情况。4.3 如何重启发布管理平台和短信平台的对接服务注意在启动过程中，一定要保证TLQ先启动，Tomcat后启动首先关闭Tomcat：先查看系统运行情况：ps -ef|grep java记录进程最前面的进程号，然后关闭进程：kill -9 xxxxx（进程号）然后再ps -ef|grep TLQ，看Tonglink是否启动了然后关闭Tonglink连接服务：tlq cabort y w1接着打开连接服务。执行tlq然后输入以下指令进入目录：cd /opt/app/ASP-TOMCAT/bin接着启动程序：./startup.sh然后查看进程是否启动：ps -ef|grep java当看到有进程存在/opt/app/ASP-TOMCAT这一部分，说明系统启动成功然后回到3.1查看连接情况。4.4 如何手动同步或者设置自动同步，将发布管理平台部分数据同步至短信平台在发布管理平台的数据管理中，有同步模块，选择相应数据，就可以将数据同步至短信平台，同时也有自动同步的功能。但是自动同步是增量同步，只同步这段时间内增加的数据。5 成功对接后短信发送问题说明5.1 与发布管理平台对接成功，但是通过发布管理平台选择分组发送的信息，未发送至手机或者未全部发送发布管理平台的受众用户数据未同步到短信平台，请将数据同步后再尝试发送5.2 以调查问卷的形式发送信息失败以调查问卷形式发送信息时，系统会在12379后加上6未数字表示位，方便识别回复内容，运营商方面未设置模糊匹配的话，将导致运营商不识别号码，导致发送失败。5.3 已调查问卷形式发送的信息可成功收到，但是回复的信息系统无法接受有些省份的相关部门采用的网络只允许信息流出，不允许信息的流入。而有些运营商（目前发现的是联通）采用的回复方法是新建一条与信息发出时不同的通路，这就会导致回复信息被上面提到的部门（采用的网络只允许信息流出，不允许信息的流入）的防火墙等设备拦截。