SMGP模拟器

SMGP模拟器主要是模拟使用中国电信SMGP协议(版本1.x~3.x)的网关。此类型网关既可以使用一个收发连接(短信接收和发送在一个链接上进行),也可以使用收发连接分离的模式。

模拟器要求使用JDK1.4以上的Java运行环境,请确认相关环境已经安装妥当。如果还没有安装Java环境,请访问java.sun.com下载最新J2SE的SDK。

此模拟器已经使用了全新的核心设计,主要针对应用程序的稳定性、可靠性、效率以及配置、管理和监控方面做了很大的调整。基本界面风格和应用功能上没什么变化。

安装模拟器

模拟器整个是一个压缩包。点击链接下载模拟器:SMGPSimulator.zipSMGP3Simulator.zip(支持TLV)。

有关模拟器的常见问题,可以参考:模拟器常见问题

解包以后应该可以看到目录结构。其中bin目录是存放运行程序包的目录;SMGPSimulator目录存放配置文件(config.xml)、启动命令(startup.bat/startup.sh)和关闭命令(shutdown.bat/shutdown.sh)。

如果解开后没有发现相关的的启动命令和关闭命令文件,请点击这里下载:startup.batstartup.shshutdown.batshutdown.sh

Bat文件是windows环境下使用的启动和关闭命令;Shell文件是Unix系统下使用的启动和关闭命令。下面主要以Windows环境进行讲解,Unix下基本类似。

如果Java运行环境安装正确,则可以直接运行和关闭,无需安装其他软件或者运行

启动模拟器

启动模拟器只需要运行startup.bat即可。正常启动后,会出现一个Console窗口,最后会提示:

......
SimulatorCenter.main : system startup !
......

关闭模拟器

关闭模拟器只需要输入quit命令即可,或者运行shutdown.bat。正常关闭后,Console窗口中应该最后会提示:

...... 
TaskManager.uninitialize : process manager was uninitialized ! 
......

使用模拟器

        模拟器启动以后使用缺省配置端口9890进行通讯。缺省配置的企业代码是:99999;地区码为027;特别服务号码(也称长号码)是99999;用户名是333;密码是0555。这些配置可以在config.xml中找到:

......
<!-- These are all authentications of gateway. -->
  <authenticate name="whoami" role="authorized">
    <enterprise_code>3027099999</enterprise_code>
    <service_code>99999</service_code>
    <account>333</account>
    <password>0555</password>
</authenticate>
......

启动后,会在系统目录中多出几个工作目录。日志文件在目录webpages目录下。

在系统运行过程中,请勿删除工作目录;在系统关闭后,可以根据需要删除工作目录。如果需要完全重置模拟器的工作状态,则必须完全删除相关工作目录。

1. 建立Socket连接与登陆

使用自己的SMGP客户端程序,与9890端口建立Socket连接。然后按照SMGP协议发送登陆数据包。模拟器会按照协议处理相关连接和登陆过程。

2. 发送短信息

正确建立连接和登陆以后,可以按照SMGP协议的Submit过程提交相关数据并得到应答。模拟器在接收到数据以后,会进行解析并按照协议要求进行应答和回复。相关的处理信息会记录在日志文件中。

3. 接收短信息

正确建立连接和登陆以后,在同一连接上等待模拟器的Deliver数据包即可,并且要求客户端按照协议给予应答。模拟器会对相关过程记录在日志信息当中。

4. 模拟MT以及状态报告过程

发送submit时,请将need_report设置为1即可。

模拟器收到相关数据包以后,会通过submit_response应答给出message_id;随后模拟出deliver数据包给出状态报告,其中is_report为1。

5. 模拟MO过程

发送submit时,请将need_report设置为0即可。

模拟器收到相关数据包以后,会通过deliver请求发送模拟的MO。其中deliver的相关数据全部来自接收到的submit数据。包括来源号码、目标号码、业务代码以及信息内容。

6. 模拟压力测试

如果需要进行模拟的完整压力测试过程,只需要以最大速度重复步骤5即可。

监控模拟器

模拟器有一个基于Web监控后台,系统启动的时候同时启动。缺省端口建立在8081上。监控的URL地址、用户名和密码可以在配置文件中找到。

......
<authenticate name="admin" role="administrator">
  <url>http://localhost:8081</url>
  <account>forest_luo</account>
  <password>root</password>
</authenticate>
<service port="8081">
  <application docBase="/webpages" id="admin" mapping="/admin"/>
</service>
......

1. 登陆监控页面

打开IE浏览器输入URL地址,然后输入用户名和密码即可访问(Firefox不支持iframe,不建议使用)

此图片的alt属性为空;文件名为login.jpg

2. 系统根目录区

点击相关图标即可展开各个部分。

3. 观察网关状态

点击Gateway链接,则在左边会出现一些功能提示。

......
......返回首页 | 网关状态 | 流量报告
......

请点击“网关状态”,则页面跳至一个定时(间隔5秒)刷新的状态:

 由于相关参数众多,这里只告诉几个比较常用的检查参数。

(1) hbtelecom smgp …… T : yes R : no
此行的T和R表示连接情况。其中T代表发送;R代表接收。No表示尚未建立连接;Yes表示连接进入准备状态或者已经建立链接。
(2) tQueue……0
此行的最后一个参数表示通过tQueue的数据包总数,也就是发送数据包的总数。
(3) rQueue……0
此行的最后一个参数表示通过rQueue的数据包总数,也就是接收数据包的总数。
(4) transmit……CF0
此行的最后一个参数表示数据包发送的当前速度。单位是“个/秒”。
(5) receiver……CF0
此行的最后一个参数表示数据包接收的当前速度。单位是“个/秒”。

例如:项目(1)可以查看连接情况;一般执行步骤4的时候,项目(2)和项目(3)的总数相等;项目(4)和项目(5)表明数据收发的速度。模拟器内部连接互测试的时候,这个数值可以达到500以上。