短信平臺接入網關說明書及常見問題解答

1、一、 網關介入說明1 網關接入運營商網關接入有2種方式，推薦專線接入安全可靠不易丟包。如果是互聯(lián)網推薦使用防火墻隔離出互聯(lián)網DMZ區(qū)，保證安全。1.1 專線接入專線接入：下圖只做參考，各省可根據(jù)實際情況在保證網絡安全前提下進行劃分網絡。移動運營商如果提供MAS機可以和短信平臺部署一個網段，MAS機可認為移動的前端網關服務器，它是為了方便移動管理和維護以及安全考慮提供一臺MAS機。注意：Mas機是部署在和短信平臺同一個局域網內。如果接入Mas機，由于全國MAS廠商很多，所以要主要短信平臺和MAS機的連接方式，目前支持的方式：直接提供MAS機的ip，端口配置在短信平臺的網關參數(shù)配置中。如果是提供相

2、關的api、接口或者數(shù)據(jù)庫連接方式，目前不支持這幾種方式，這幾個方式出問題了不是很好管理，出現(xiàn)問題不好解決。如果Mas是這樣連接的話，請直接采用網關直連的方式。如果是只提供ip和端口就可以了，就相當于mas機就是移動的短信業(yè)務平臺，就很好管理了，就算有問題也只有網絡方面的 1.2 互聯(lián)網接入互聯(lián)網接入：下圖只做參考，各省可根據(jù)實際情況在保證網絡安全前提下進行劃分網絡。移動運營商如果提供MAS機可以和短信平臺部署一個網段，MAS機可認為移動的前端網關服務器，它是為了方便移動管理和維護以及安全考慮提供一臺MAS機。2 網關參數(shù)2.1 移動參數(shù)短信平臺支持移動CMPP2、CMPP3.0協(xié)議，需要運營

3、商提供參數(shù)如下：特服號碼：12379，短信平臺必填項企業(yè)代碼：移動運營商提供企業(yè)id，短信平臺必填項網關地址：移動運營商提供網關服務器ip地址，短信平臺必填項網關端口：移動運營商提供網關服務器端口號，短信平臺必填項登錄名稱：移動運營商提供登錄網關用戶名，短信平臺必填項登錄密碼：移動運營商提供登錄網關密碼，短信平臺必填項業(yè)務代碼：移動運營商提供業(yè)務類型，沒有提供則為空2.2 電信參數(shù)短信平臺支持電信SMGP3.0和ISAG協(xié)議，SMGP協(xié)議需要運營商提供參數(shù)如下：特服號碼：12379，短信平臺必填項企業(yè)代碼：電信運營商提供企業(yè)id，短信平臺必填項網關地址：電信運營商提供網關服務器ip地址，短信平

4、臺必填項網關端口：電信運營商提供網關服務器端口號，短信平臺必填項登錄名稱：電信運營商提供登錄網關用戶名，短信平臺必填項登錄密碼：電信運營商提供登錄網關密碼，短信平臺必填項業(yè)務代碼：電信運營商提供業(yè)務代碼，沒有提供則為空ISAG協(xié)議需要運營商提供參數(shù)如下：特服號碼：12379，短信平臺必填項企業(yè)代碼：電信運營商提供企業(yè)id，短信平臺必填項網關地址：電信運營商提供網關服務器訪問地址“http:/網關IP:網關端口”，短信平臺必填項登錄名稱：電信運營商提供登錄網關用戶名，短信平臺必填項登錄密碼：電信運營商提供登錄網關密碼，短信平臺必填項服務代碼：電信運營商提供服務代碼，沒有提供則為空產品代碼：電信運

5、營商提供產品代碼，沒有提供則為空回調地址：默認填寫http:/短信平臺IP:8080/asp/sms/SmsWebService，短信平臺必填項2.3 聯(lián)通參數(shù)短信平臺支持聯(lián)通SGIP1.2協(xié)議，需要運營商提供參數(shù)如下：特服號碼：12379，短信平臺必填項企業(yè)代碼：聯(lián)通運營商提供企業(yè)id，短信平臺必填項網關地址：聯(lián)通運營商提供網關服務器ip地址，短信平臺必填項網關端口：聯(lián)通運營商提供網關服務器端口號，短信平臺必填項登錄名稱：聯(lián)通運營商提供登錄網關用戶名，短信平臺必填項登錄密碼：聯(lián)通運營商提供登錄網關密碼，短信平臺必填項本地端口：短信平臺自身提供，默認8801，短信平臺必填項業(yè)務代碼：聯(lián)通電信運

6、營商提供業(yè)務代碼，沒有提供則為空源節(jié)點ID：聯(lián)通電信運營商提供源節(jié)點ID，沒有默認填寫02.4 配置參數(shù)短信平臺支持5種協(xié)議，根據(jù)運營商提供的協(xié)議短信平臺選擇對應的協(xié)議，然后再進行每個協(xié)議的詳細參數(shù)配置，參數(shù)配置完成點擊“保存”按鈕，在點擊“停止”按鈕，最后點擊“啟動”按鈕，刷新當前頁面查看狀態(tài)指示燈是否為綠色，綠色代表短信平臺與網關服務器聯(lián)通。3 網關測試下行短信：通過短信平臺下發(fā)短信給手機。上行短信：通過手機回復短信到短信平臺。上行短信和下行短信全部測試成功，網關接入成功。3.1 下行短信用瀏覽器打開http:/IP:8080/asp短信平臺網址，以值班員登錄系統(tǒng)，用戶名kaifa密碼12

7、3456登錄點擊“信息發(fā)布”菜單進入信息錄入頁面，如圖所示：由于發(fā)預警信息需要審核，為了方便測點擊“其他信息”錄入內容和手機號碼后，點擊“保存并發(fā)送”按鈕。如圖所示：點擊“回執(zhí)反饋”菜單查看回執(zhí)信息，如圖所示：點擊測試記錄的“查看”連接查看回執(zhí)信息，如圖所示：網關回執(zhí)成功說明網關服務器成功接收短信平臺下發(fā)信息，回執(zhí)報告已接收說明手機已經收到短信。下行短信成功。3.2 上行短信上行短信指手機接收到短信后通過短信回復該條信息。要做上行短信測試系統(tǒng)默認必須是調查問卷，因為調查問卷才有短信回復功能。手機收到調查問卷后回復一條短信，點擊剛剛回復的手機號碼查看短信回復信息。如圖所示：看到回復內如，說明上行

8、短信成功。4 注意事項與常見問題一般情況短信平臺只需向移動、電信運營商提供短信平臺服務器IP，聯(lián)通需提供短信平臺IP和一個端口號8801（短信平臺必須開通此端口）。網關參數(shù)配置保存后重啟指示燈是紅色，2種可能一種參數(shù)有誤與運營商確認，另一種是是網絡不通進行telnet+ip+端口方式查看能否連接網關服務器，如圖所示：說明連接超時和網絡管理員進行確認可能防火或者路由器配置有誤。也可以通過traceroute+ip進行跟蹤，定位哪個位置不通，如圖所示：最后沒有看到traceroute的ip地址說明沒有通與網絡管理員溝通查找原因。二、 短信平臺常見問題及解決方法1 注意問題1.1 地市級注意短信平臺

9、是以省級為單位進行部署，地市級的發(fā)布管理平臺的信息會先到達省級發(fā)布管理平臺，再通過短信平臺進行發(fā)送。地市級若出現(xiàn)信息發(fā)送失敗，請先聯(lián)系查看信息是否到達省級平臺。1.2 操作時請謹慎在按照解決方案操作過程中如有疑問或者相關說明不夠詳細，請隨時聯(lián)系相關人員，切勿不按說明，隨意操作后臺信息。在解決過程中如果按照方案解決依然失敗，請及時聯(lián)系相關人員。1.3 相關人員聯(lián)系方式姓名電話QQ梁偉1381125648848644105羅斯洋185012685617340387062 系統(tǒng)無法登陸問題2.1 如何判斷系統(tǒng)是否已啟動首先利用CRT或者Xshell工具，進入命令行操作界面然后輸入以下指令查看進程：p

10、s -ef|grep java當看到有進程存在/opt/app/ASP-TOMCAT這一部分，說明系統(tǒng)已經啟動，反之則沒有2.2 如何啟動系統(tǒng)如果系統(tǒng)沒有啟動，則利用CRT或者Xshell工具，進入命令行操作界面然后輸入以下指令進入目錄：cd /opt/app/ASP-TOMCAT/bin接著啟動程序：./startup.sh然后查看進程是否啟動：ps -ef|grep java當看到有進程存在/opt/app/ASP-TOMCAT這一部分，說明系統(tǒng)啟動成功2.3 如何重啟系統(tǒng)如果需要重啟系統(tǒng)，則先查看系統(tǒng)運行情況：ps -ef|grep java記錄進程最前面的進程號，然后關閉進程：kill

11、 -9 xxxxx（進程號）然后輸入以下指令進入目錄：cd /opt/app/ASP-TOMCAT/bin接著啟動程序：./startup.sh然后查看進程是否啟動：ps -ef|grep java當看到有進程存在/opt/app/ASP-TOMCAT這一部分，說明系統(tǒng)啟動成功2.4 如何查看系統(tǒng)運行日志如果系統(tǒng)沒有啟動，則利用CRT或者Xshell工具，進入命令行操作界面然后輸入以下指令進入目錄：cd /opt/app/ASP-TOMCAT/logs查看對應日期的日志：tail -f catalina.2011-11-11.out，即可查看日志情況3 與運營商連接問題3.1 如何判斷與運營商

12、網關的連接是否成功進入管理員用戶，進入參數(shù)設置模塊->網關參數(shù)配置，看三家運營商的指示燈是否為綠色或者進入值班員用戶，在主頁的右下角，查看三家運營商的連接情況是否為綠色3.2 如何判斷線路的中斷位置前提是已經獲得運營商提供的網關IP地址和端口首先利用CRT或者Xshell工具，進入命令行操作界面采用Telnet的方法：telnet IP 端口號?？词欠駮崾具B接超時或失敗,如下圖所示說明可以連通。采用traceroute（需要以root身份運行）：traceroute IP，看是否連接到了指定的IP，如未成功的話連接在何處斷開3.3 顯示已成功連接運營商網關，依然發(fā)送失敗進入當天的系統(tǒng)日

13、志，發(fā)送一條信息，查看系統(tǒng)的回復情況，并與運營商溝通，看運營商方面收到的信息回執(zhí)狀態(tài)何處出錯。一般常見的有以下幾點可能：l 運營商需要業(yè)務代碼，但是系統(tǒng)上未填寫l 運營商未開通相關專線l 發(fā)送的是調查問卷，而調查問卷會在12379后加上6未數(shù)字附加碼，運營商方面未設置模糊匹配，無法識別該號碼，這個問題需要和運營商溝通開啟模糊匹配。l 運營商未開通黑名單，即免鑒權機制，只能發(fā)送指定的白名單號碼4 與發(fā)布管理平臺對接問題4.1 如何判斷發(fā)布管理平臺與短信平臺已成功對接首先利用CRT或者Xshell工具，進入命令行操作界面查看Tonglink進程：ps -ef|grep TLQ，如果出現(xiàn)了TLQ的進

14、程，說明Tonglink已連接，如果沒有啟動請?zhí)?.2模塊。查看連接狀態(tài)：首先輸入tlqstat；輸入qcu；按下ctrl+c；輸入s；輸入rcv_local；輸入c，在跳出來的列表頁面中，看前三個tlq編號從001-003的隊列是否全部監(jiān)聽成功，成功監(jiān)聽的標準是最后的一列數(shù)據(jù)前三個都為1。4.2 如何啟動發(fā)布管理平臺和短信平臺的對接服務注意在啟動過程中，一定要保證TLQ先啟動，Tomcat后啟動首先關閉Tomcat：先查看系統(tǒng)運行情況：ps -ef|grep java記錄進程最前面的進程號，然后關閉進程：kill -9 xxxxx（進程號）查看ps -ef|grep TLQ，查看是否啟動完

15、成若未啟動，執(zhí)行tlq命令。啟動Tonglink然后啟動Tomcat，輸入以下指令進入目錄：cd /opt/app/ASP-TOMCAT/bin接著啟動程序：./startup.sh查看進程是否啟動：ps -ef|grep java在回到3.1查看連接情況。4.3 如何重啟發(fā)布管理平臺和短信平臺的對接服務注意在啟動過程中，一定要保證TLQ先啟動，Tomcat后啟動首先關閉Tomcat：先查看系統(tǒng)運行情況：ps -ef|grep java記錄進程最前面的進程號，然后關閉進程：kill -9 xxxxx（進程號）然后再ps -ef|grep TLQ，看Tonglink是否啟動了然后關閉Tongli

16、nk連接服務：tlq cabort y w1接著打開連接服務。執(zhí)行tlq然后輸入以下指令進入目錄：cd /opt/app/ASP-TOMCAT/bin接著啟動程序：./startup.sh然后查看進程是否啟動：ps -ef|grep java當看到有進程存在/opt/app/ASP-TOMCAT這一部分，說明系統(tǒng)啟動成功然后回到3.1查看連接情況。4.4 如何手動同步或者設置自動同步，將發(fā)布管理平臺部分數(shù)據(jù)同步至短信平臺在發(fā)布管理平臺的數(shù)據(jù)管理中，有同步模塊，選擇相應數(shù)據(jù)，就可以將數(shù)據(jù)同步至短信平臺，同時也有自動同步的功能。但是自動同步是增量同步，只同步這段時間內增加的數(shù)據(jù)。5 成功對接后短信發(fā)送問題說明5.1 與發(fā)布管理平臺對接成功，但是通過發(fā)布管理平臺選擇分組發(fā)送的信息，未發(fā)送至手機或者未全部發(fā)送發(fā)布管理平臺的受眾用戶數(shù)據(jù)未同步到短信平臺，請將數(shù)據(jù)同步