配置短信网关

背景信息

当对接短信网关的用户密码发生变化时，请同步修改AICC侧配置，修改方式：选择“配置中心 > 接入配置 > 网关配置”，单击待修改列的网关对应的“编辑”，单击消息协议参数配置，输入修改后的登录口令。

操作步骤

1. 以租户管理员帐号登录客户服务云，选择“配置中心 > 接入配置 > 网关配置”，设置网关信息。
2. 单击“新建”，进入增加网关配置页面。配置新增网关参数。
   图1 配置网关类型参数
   
   • 网关名称：自定义网关名称。
   • 配置类型：短信。
   • 协议类型：smpp。

3. 单击“下一步”，进入网关地址对接配置页面。

   进行网关地址对接参数配置，页面包含基础配置和高级配置，基础配置需要用户手动填入，高级配置缺省填入，用户用户根据需要额外填写配置项。

   • 基础配置为用户需要填写的配置项。
     图2 配置网关地址对接参数
     

     表1 基础配置参数说明

     参数名称	参数描述
     SMG地址	必填项。 短信网关的IP地址。 示例：10.10.10.10。
     SMG端口	必填项。 短信网关的端口号。
     登录名	登录网关的帐号（使用网关模拟器时可不填写）。
     登录口令	登录网关的密码（使用网关模拟器时可不填写）。
     收发模式	必填项。 表示协议设备是用于发送短信，还是用于接收短信。 默认值：收发短信，取值范围： 收发短信：表示该协议设备即用于处理从SMSC接收到的消息又用于发送短信。 接收短信：表示该协议设备用于处理从SMSC接收到的消息。 发送短信：表示该协议设备用于发送短信。
     SMPP PDU 类型	必填项。 短信发送时使用的SMPP PDU类型。 默认值：submit_sm，取值范围： submit_sm data_sm
     默认发送号码	必填项。 网关配置的允许发送号码段。 取值范围： 字母（a～z、A～Z） 数字（0～9） 特殊符号（+、-） 例如：该参数设置为“130”，则该链路只允许以130开头的发送号码进行消息发送。 多个号码之间以“;”分隔。
     默认接收号码	必填项。 网关配置的允许接收号码段。 取值范围： 字母（a～z、A～Z） 数字（0～9） 特殊符号（+、-） 例如：该参数设置为“130”，则该链路只允许发送以130开头的接收号码信息。 多个号码之间以“;”分隔。

   • 高级配置包含ESME连接配置和消息协议参数配置两项，如图3，缺省填入，用户可根据自身需要额外修改。单击“确认”。
     图3 网关地址对接配置-高级配置
     

     表2 高级配置参数说明

     参数名称	参数说明
     ESME连接配置
     客户端端口	必填项。 指定CC-Notification服务器一个未被占用的端口，用于与短信网关建立连接。当短信网关需要指定客户端端口时，需要设置该参数。 默认值：0，表示CC-Notification系统随机分配一个端口。取值范围：0～65535。
     上行消息接收端口	接收上行消息的端口号。 默认值：0，表示由CC-Notification自动分配。取值范围：0～65535。
     心跳间隔（毫秒）	文本框 为了维持CC-Notification与短信网关的长连接，需要定期向短信网关发送心跳消息。用于设置发送心跳消息的间隔时间。 默认值：30000，单位：毫秒。取值范围：1～10位数字，取值必须大于“事务超时时间（毫秒）”，小于“接收超时时间（毫秒）”。
     心跳无响应最大连接次数	文本框 连续心跳无响应次数大于该参数值时，CC-Notification将断开与网关的连接。 0～5位数字。 输入 默认值：3
     重发次数	设置重发的最大次数。 默认值：0，取值范围：0-10位数字。 CC-Notification发送心跳消息后，如果在事务超时时间内未得到心跳响应，则CC-Notification将等待一段时间（即“重发等待时间（毫秒）”的值），然后重新发送心跳消息。
     重发等待时间（毫秒）	CC-Notification收到短信网关返回的短信发送失败的应答消息后，等待多长时间重发该短信。 默认值：0，取值范围：0-10位数字。
     接收超时时间（毫秒）	必填项。 短信设备和网关建立连接后，允许没有数据传输的最长时间。如果在接收超时时间内，短信设备没有收到对端设备的数据，则连接自动断开。 默认值：180000，取值范围：1-10位以内数字，取值必须大于“心跳间隔（毫秒）”和“事务超时时间（毫秒）”。 为了保证不出现无效连接，接收超时时间不能设置为“0”。
     接收最大错误包数	一个设备上连续收到错误包的消息数量。 默认值：10，取值范围：0-10位以内数字。 如果连续收到设置数量的错误数据包，则表明这个链路有故障，该链路将被断开。
     滑窗大小	必填项。 标识CC-Notification系统的瞬间并发处理能力。 默认值：16，一般设置为16的倍数。取值范围：2-5位以内数字。 用于限制CC-Notification的消息发送量，防止发送量过大时，系统压力过大而导致SMSC侧发生异常。
     事务超时时间（毫秒）	短信设备发送一个消息后，等待对端响应的最大时长。如果在此时间内，对端没有发送对这个消息的响应，则短信设备不再等待。 默认值：6000，单位：毫秒。取值范围：0-10位以内数字，取值必须小于“心跳间隔（毫秒）”和“接收超时时间（毫秒）”。
     最大消息长度（字节）	必填项。 协议规定的整个消息的长度。 默认值：2048，单位：字节。取值范围：1-5位以内数字。
     超长短信拆分方式	必填项。 短信内容超过“最大内容长度（字节）”时短信的拆分方式。 默认值：禁止拆分，取值范围： 禁止拆分：对于超长短信不执行发送，并在CC-Notification侧抛出异常。 不拆分：不判断短信是否超长，直接执行发送。 物理拆分：将超长短信按“最大内容长度（字节）”进行分段，拆分成多条独立的短信发送。 超长拆分：将超长短信拆分成多条连锁短信发送，即系统在拆分后的短信中添加子消息组合控制信息。支持连锁短信的终端可以将这些子消息重新组合成一条完整的短信。
     最大内容长度（字节）	必填项。 根据协议规定的消息的内容长度。在对长消息进行拆分时，以该参数为标准进行拆分。 默认值：140，单位：字节。取值范围：1-5位以内数字。
     发送线程池最小数	必填项。 使用协议栈发送消息时，线程池的最小启动线程数。 默认值：20，取值范围：1-5位以内数字。
     发送线程池最大数	必填项。 使用协议栈发送消息时，线程池能达到的最大线程数。 默认值：200，取值范围：1-5位以内数字。
     发送线程池队列长度	必填项。 在发送线程池中，等待线程处理队列的长度。 默认值：2000，取值范围：1-5位以内数字。
     接收线程池最小数	必填项。 状态报告接收线程的最小数量。接收线程池要以发送线程池为参考进行配置，不要求完全相等。 默认值：20，取值范围：1-5位以内数字。
     接收线程池最大数	必填项。 状态报告接收线程的最大数量。 默认值：200，取值范围：1-5位以内数字。
     接收线程池队列长度	必填项。 状态报告接收线程的队列长度。 默认值：2000，取值范围：1-5位以内数字。
     最大接收速率	使用协议接收消息的最大速率。 取值范围： 空 正数 取值为空时，“最大发送速率”、“超流量处理策略”必须一致为空。
     最大发送速率	使用协议发送短信的最大速率。 取值范围： 空 正数 取值为空时，“最大接收速率”、“超流量处理策略”必须一致为空。
     超流量处理策略	超流量发送处理策略。 取值范围： 空 正数 取值为空时，“最大接收速率”、“最大发送速率”必须一致为空。
     长短信合并模式	必填项。 长短信合并模式。 默认值：GSM用户数据头，取值范围： GSM用户数据头 SMPP参数
     消息协议参数配置
     ESME类型	标识ESME（External Short Message Entity）的类型。 取值范围：字符串长度<=13。 详细取值建议参考SMPP协议bind消息system_type字段的说明。
     ESME地址类型编号	扩展短信实体的地址类型编号。 取值范围：28以内的正整数。 详细取值建议参考SMPP协议bind消息addr_ton字段的说明。
     ESME地址编码方式	扩展短信实体的地址编码方式。 取值范围：0～10位数字。 详细取值建议参考SMPP协议bind消息addr_npi字段的说明。
     ESME地址范围	扩展短信实体的地址编码方式。 取值范围：字符串长度<=15。 详细取值建议参考SMPP协议bind消息address_range字段的说明。
     服务类型	网关指定的用于指明短信的SMS应用服务。 取值范围：字符串长度<=500。 详细取值建议参考SMPP协议submit_sm/data_sm消息service_type字段的说明。
     源地址编码类型	必填项。 指定SMPP SubmitMessage中源地址的编码类型。 默认值：0，取值范围：1-10位数字。 详细取值建议参考SMPP协议submit_sm/data_sm消息source_addr_ton字段的说明。
     源地址编码方案	必填项。 指定SMPP SubmitMessage中源地址的编码方案。 默认值：0，取值范围：1-10位数字。 详细取值建议参考SMPP协议submit_sm/data_sm消息source_addr_npi字段的说明。
     目的地址编码类型	必填项。 指定SMPP SubmitMessage中目的地址的编码类型。 默认值：0，取值范围：1-10位数字。 详细取值建议参考SMPP协议submit_sm/data_sm消息dest_addr_ton字段的说明。
     目的地址编码方案	必填项。 指定SMPP SubmitMessage中目的地址的编码方案。 默认值：0，取值范围：1-10位数字。 详细取值建议参考SMPP协议submit_sm/data_sm消息dest_addr_npi字段的说明。
     信息类型	必填项。 表明该消息的类型。 默认值：0，取值范围：1-10位数字。 详细取值建议参考SMPP协议submit_sm/data_sm消息esm_class字段的说明。
     信息格式	必填项。 短信内容的编码方式。 默认值：ASCII串，取值范围： ASCII串：一个字符占一个字节。 二进制信息。 UCS2编码：ISO/IEC-10646，所有消息字符都占两个字节。
     协议标识	必填项。 GSM协议的编号。 默认值：0，取值范围：1-10位数字。 详细取值建议参考SMPP协议submit_sm消息data_coding字段的说明。
     返回状态确认报告	必填项。 定义返回哪些状态报告。 默认值：2，取值范围： 0：不接收状态报告。 1：返回失败和成功的状态报告。 2：返回失败的状态报告。
     替换标识	必填项。 是否替换现存的源地址、目标地址字段都相同的短信。 默认值：不替换，取值范围： 不替换。 替换。
     默认消息ID	必填项。 预定义短信ID，是消息中心管理者建立的预定义短信的索引。 默认值：0，取值范围：字符串长度<=500。 详细取值建议参考SMPP协议submit_sm消息sm_default_msg_id字段的说明。

4. 单击“确认”，完成短信网关配置。

后续操作

• 重建网关。
  1. 选择“配置中心 > 系统管理 > 网关监控”。
  2. 单击“重建”。
• 断开连接失败的网关。
  1. 选择“配置中心 > 系统管理 > 网关监控”。
  2. 单击“断开”。