TelScale SMSC Gateway

Release Notes

Amit Bhayani <amit.bhayani (at) telestax.com>

Sergey Vetyutnev <serg.vetyutnev (at) telestax.com>
Vinu S Renish <svinu.renish (at) telestax.com>

TelScale SMSC Gateway: Release Notes

by Amit Bhayani, Sergey Vetyutnev, and Vinu S Renish
Copyright 2014 TeleStax, Inc.
Abstract
These release notes contain important information related to TelScale SMSC Gateway 6.2.2.710.
You must ensure that you read the Release Notes before installing and using TelScale SMSC
Gateway.

1. Introduction ................................................................................................................. 1
2. Important Notes ........................................................................................................... 2
2.1. Download ...........................................................................................................
2.2. What's Included? ................................................................................................
2.3. What's New? ......................................................................................................
2.4. Issues Fixed .......................................................................................................
2.5. Configuration Settings .........................................................................................
2.6. Documentation ....................................................................................................
2.7. Support ..............................................................................................................
A. Revision History ............................................................................................................
Index ................................................................................................................................

iii

2
2
2
3
6
7
7
8
9

Chapter 1. Introduction
TeleStax is pleased to announce the release of TelScale SMSC Gateway 6.2.2.710. TelScale
SMSC Gateway is the first and only Java based Open Source SMSC Gateway implementation
that is fully tested and supported by TeleStax.
TelScale SMSC Gateway strictly adheres to the standards and specifications defined by the
International Telecommunications Union (ITU). It is an easy-to-install and easy-to-deploy platform
based on the robust and proven TelScale JAIN SLEE 1.1 Server and TelScale jSS7 Stack. It can
be installed on any Operating System that supports Java (JDK 7 and SCTP).
Enterprises can now use TelScale SMSC Gateway with the added assurance that the product is
fully supported by TeleStax.

Chapter 2. Important Notes

2.1. Download
The binary release is available for download from the TeleStax Customer Support Portal at http://
code.google.com/p/smscgateway/downloads/list.

2.2. What's Included?

This binary release includes:
cassandra: Contains the script that can help you to learn how Cassandra Keyspace is
configured. This is not a script for database structure creation, SMSC GW will create Cassandra
Keyspace itself.
docs: Contains all relevant documentation in respective subfolders.
jboss-5.1.0.GA: The core server with two profiles "default" and "simulator". The "default" profile
is a clean profile where you will have to start from scratch and configure the entire SS7 Stack
and SMSC Gateway. The "simulator" profile is a pre-configured profile to work with jss7- and
smpp- simulators. Refer to the Admin Guide for instructions on how to start the server in either
of the profiles.
resources: Contains SLEE MAP RA jars.
tools: Contains SLEE tools and jss7-simulator.

2.3. What's New?

Lightweight pass-through mode. TelScale SMSC Gateway 6.2.2.710 now for sending of only
SMPP originated datagramm and transactional messages does not need to install any database.
Message processing rules. TelScale SMSC Gateway 6.2.2.710 introduces of message
processing (mproc) rules. Each rule contains a set of conditions (like destination address mask).
If an incoming message fits to the conditions then rule actions will be applied to the message
(like adding a prefix into a destination address or networkId changing). There is a default
implementation of mproc rules which covers some cases. But a customer can implement his own
custom set of mproc rules by implementing of java code.
Diameter rejections. When Diameter server rejects an incoming message then TelScale
SMSC Gateway 6.2.2.710 will send those rejects as responses back to an message originator
(for SMPP and MO originated messages). So the message originator will know if the message
is accepted or not.
Fixing of GSM7 messages encoding issues. Fixed several issues of GSM7 encoding errors
in case of two-septets characters (like "[" or "]") are present or in the case when the last part of
a splitted message is short.

Important Notes

GSM7 encoding at SMPP part. TelScale SMSC Gateway 6.2.2.710 supports now GSM7
encoding at SMPP part (in addition to UTF-8 and Unicode encoding).
Preconfigured HLR address. There is now a possibility of using a special preconfigured HLR
address instead of MSISDN for SCCP CalledPartyAddress in SRI request.
National Language Shift Tables. TelScale SMSC Gateway 6.2.2.710 supports now National
Language Shift Tables which are used in encoding of GSM7 encoding.
Message restrictions for ESMEs. TelScale SMSC Gateway 6.2.2.710 supports now a
minimal/maximal message length and rate per a second (a minute, a hour, a day) limits per ESME.
GSM message classes. TelScale SMSC Gateway 6.2.2.710 supports now dest_addr_subunit
parameter at SMPP part. This parameter specifies GSM message classes.
New license library. TelScale SMSC Gateway 6.2.2.710 has switched to license library 2.2.3.

2.4. Issues Fixed

For a full list of resolved issues and their details, please refer to https://telestax.atlassian.net/
browse/SMSC/.

SMSC-144 [https://telestax.atlassian.net/browse/SMSC-144]: Document and blog with

examples about the different send modes - datagram, forward and store, store and forward
SMSC-177 [https://telestax.atlassian.net/browse/SMSC-177]: GSM7 Bit SMS with special
character and length of 140 chars throws exception
SMSC-179 [https://telestax.atlassian.net/browse/SMSC-179]: SMSC GW: lightweight passthrough mode
SMSC-186 [https://telestax.atlassian.net/browse/SMSC-186]: A special mode when all
generated by SMSC GW messages will be routed to originated ESMEs
SMSC-191 [https://telestax.atlassian.net/browse/SMSC-191]:
functionality

Old

style

home

routing

SMSC-194 [https://telestax.atlassian.net/browse/SMSC-194]: Message splitting procedure

must care on GSM7 extention table characters
SMSC-198 [https://telestax.atlassian.net/browse/SMSC-198]: Using in CalledPartyAddress
(SRI) a preconfigured HLR address instead of MSISDN
SMSC-199 [https://telestax.atlassian.net/browse/SMSC-199]: Docs: add description for HLR
addressing of SRI messages in HR mode
SMSC-200 [https://telestax.atlassian.net/browse/SMSC-200]: MessageProcessing (MProc)
functionality just after a message has come to SMSC GW

Important Notes

SMSC-201 [https://telestax.atlassian.net/browse/SMSC-201]: Converting of national ->

international numbers for incoming SS7 messages
SMSC-202 [https://telestax.atlassian.net/browse/SMSC-202]: Different networkId for incoming /
outgoing messages at SMPP ESME / SIP
SMSC-204 [https://telestax.atlassian.net/browse/SMSC-204]: Docs: Remove of mentioning of
cassandra.cql from SMSC GW Intsallation Guide
SMSC-205 [https://telestax.atlassian.net/browse/SMSC-205]: Needed to update InSystem field
for FAS mode when a message has beed invoked form a database
SMSC-206 [https://telestax.atlassian.net/browse/SMSC-206]: Docs: add a chapter that
describes all aspects of SMSC message routing
SMSC-207 [https://telestax.atlassian.net/browse/SMSC-207]: PotentialVersionIncompatibility
response -> switching to MAP V1 message problems
SMSC-209
[https://telestax.atlassian.net/browse/SMSC-209]:
MapVersionCacheMBean has to be updated

GUI

for

SMSC-210 [https://telestax.atlassian.net/browse/SMSC-210]: Delivery reciepts for the several

permanent undelivered messages contain the content of the first message
SMSC-211 [https://telestax.atlassian.net/browse/SMSC-211]: NetworkId of originated ESME
will be assigned to a delivery receipt (optional)
SMSC-213 [https://telestax.atlassian.net/browse/SMSC-213]: National Language Shift Table
support
SMSC-214 [https://telestax.atlassian.net/browse/SMSC-214]: Improper logger spelling
SMSC-216 [https://telestax.atlassian.net/browse/SMSC-216]: SS7 GUI shows Service running
only for jSS7 but when packaged with SMSC it always shows down
SMSC-217 [https://telestax.atlassian.net/browse/SMSC-217]: Double logging issue
SMSC-218 [https://telestax.atlassian.net/browse/SMSC-218]: Docs: adding "SCTP libraries"
into "SMSC GW installation Guide"
SMSC-219
[https://telestax.atlassian.net/browse/SMSC-219]:
"TelScale_SS7Stack_Release_Notes" and "TelScale_SS7Stack_Installation_Guide"

Add

SMSC-222 [https://telestax.atlassian.net/browse/SMSC-222]: Too long time duration to restore

of functionality after long time shutdown
SMSC-223 [https://telestax.atlassian.net/browse/SMSC-223]: Exception when GSM7 encoding
of the short message with UDH
SMSC-224 [https://telestax.atlassian.net/browse/SMSC-224]: Splitting messages for specified
length in SMPP-Simulator

Important Notes

SMSC-225 [https://telestax.atlassian.net/browse/SMSC-225]: Adding support for GSM7

encoding at SMPP part
SMSC-226 [https://telestax.atlassian.net/browse/SMSC-226]: GUI update after introducing of
GSM7 style encoding at SMPP part
SMSC-227 [https://telestax.atlassian.net/browse/SMSC-227]: Docs: introducing of GSM7 style
encoding at SMPP part
SMSC-228 [https://telestax.atlassian.net/browse/SMSC-228]: min-message-length / maxmessage-length ESME options
SMSC-229 [https://telestax.atlassian.net/browse/SMSC-229]: SMSC tries to store receipts into
SLOT_MESSAGES_TABLE_2000_01_01 table
SMSC-230
[https://telestax.atlassian.net/browse/SMSC-230]:
orignetworkidforreceipts

GUI:

mproc

and

SMSC-231
[https://telestax.atlassian.net/browse/SMSC-231]:
orignetworkidforreceipts

Docs:

mproc

and

SMSC-232 [https://telestax.atlassian.net/browse/SMSC-232]: GUI: adding min-messagelength / max-message-length ESME options

SMSC-233 [https://telestax.atlassian.net/browse/SMSC-233]: Docs: adding min-messagelength / max-message-length ESME options
SMSC-234 [https://telestax.atlassian.net/browse/SMSC-234]: GUI: National Language Shift
Table support
SMSC-235 [https://telestax.atlassian.net/browse/SMSC-235]: Docs: National Language Shift
Table support
SMSC-237 [https://telestax.atlassian.net/browse/SMSC-237]: Support for dest_addr_subunit at
SMPP part
SMSC-238 [https://telestax.atlassian.net/browse/SMSC-238]: GUI: for skip-unsent-messages
command
SMSC-239 [https://telestax.atlassian.net/browse/SMSC-239]:
messages" command and a new fields in "smsc stat get"

Docs:

"smsc

skip-unsent-

SMSC-240 [https://telestax.atlassian.net/browse/SMSC-240]: Docs: update a chapter for

manual's for CDR format
SMSC-241 [https://telestax.atlassian.net/browse/SMSC-241]: GUI: for hrhlrumber parameter
SMSC-242 [https://telestax.atlassian.net/browse/SMSC-242]: Docs: for hrhlrumber parameter
SMSC-245 [https://telestax.atlassian.net/browse/SMSC-245]: Switching to a license lib
2.2.3.Final

Important Notes

SMSC-246 [https://telestax.atlassian.net/browse/SMSC-246]: Docs : Add new chapter

explaining how to use TelScale-smpp-simulator tool
SMSC-247 [https://telestax.atlassian.net/browse/SMSC-247]: Response to an originator after a
diameter response (MO/SMPP orig)
SMSC-248 [https://telestax.atlassian.net/browse/SMSC-248]: Adding SMSC-Address 2017
parameter into diameter request
SMSC-249 [https://telestax.atlassian.net/browse/SMSC-249]: Bad processing the case when
there are very many messages to the one dest
SMSC-250 [https://telestax.atlassian.net/browse/SMSC-250]: BIND request sent by SMSC
doesn't respect System Type parameter
SMSC-251 [https://telestax.atlassian.net/browse/SMSC-251]:
Improvements

Review

SMSC

Docs

for

SMSC-252 [https://telestax.atlassian.net/browse/SMSC-252]: Big message count can be stored

into one due_slot
SMSC-253 [https://telestax.atlassian.net/browse/SMSC-253]: Reduced sending rate when very
many messages to the one dest address
SMSC-256 [https://telestax.atlassian.net/browse/SMSC-256]: Docs: adding a manual chapter
for smsc-diameter interconnection
SMSC-258 [https://telestax.atlassian.net/browse/SMSC-258]:
receipt creating after ValidityPeriod expiring filter

NullPointerException

when

SMSC-260 [https://telestax.atlassian.net/browse/SMSC-260]: mproc rules: checking conditions

based on last updated values
SMSC-261 [https://telestax.atlassian.net/browse/SMSC-261]: SMSC Re-preparing already
prepared query
SMSC-265 [https://telestax.atlassian.net/browse/SMSC-265]: SMSC should allow Custom
MProc Rule
SMSC-267 [https://telestax.atlassian.net/browse/SMSC-267]: Add the throttling capability in
smpp-load test tool
SMSC-268 [https://telestax.atlassian.net/browse/SMSC-268]: Update manuals for Customized
MProc Rule

2.5. Configuration Settings

You must perform post-installation configuration of the Gateway according to instructions in the
TelScale SMSC Gateway Admin Guide. Before using in Production, you must remember to finetune Memory, Database and logging settings for better performance.

Important Notes

Warning
Failure to configure memory, database, logging and other settings as per the
instructions in the Admin Guide may result in poor performance of the Gateway.

2.6. Documentation
When you download the binary release and extract the contents of the zip file, you will notice
that the top level directory is named telscale-smsc-<version> and within the telscale-smsc<version>/docs folder you will find the TelScale SMSC Gateway Installation Guide and Admin
Guide. For installation and usage guidance, please refer to these guides that will help you to install
and configure the Gateway.

2.7. Support
TelScale SMSC Gateway is fully supported by TeleStax. For help with the software or to raise bugs
please login to your account at https://telestax.zendesk.com/home and follow the instructions.

Appendix A. Revision History

Revision History
Revision 1.0
October 18 2012
G.A Release
Revision 2.0
September 8 2013
Added Release Notes for 6.2.2.710
Revision 3.0
January 13 2014
Added Release Notes for 6.1.5.GA
Revision 4.0
April 29 2014
Added Release Notes for 6.1.6.GA
Revision 5.0
October 10 2014
Added Release Notes for 6.2.0.GA

Vinu SRenish
Vinu SRenish
Vinu SRenish
Vinu SRenish
SergeyVetyutnev

Index