Home

SMSC-SMPP Integration Manual

1. Mitel NuPoint Messenger Technical Documentation Release 7 0 Default 0 i 4 B b B b6 CBN Protocol ID Description The CBN Protocol ID is one character and should be assigned by the SMSC system administrator it is the same as CBN SUBMIT protocol ID Default 0 I 4 B b B 6 Data Coding Description The GSM Data Coding Scheme is 1 character and should be assigned by the SMSC System Administrator it is the same as SUBMIT_SM data_coding Default 48 i 4 B b B b6 Destination Prepend Description This field is commonly used to prepend an area code to a mailbox number in systems with seven digit dial plans The field can contain either an ASCII string 408 510 and so forth or the name of one of the following mailbox fields DEPARTMENT or EXTENSION The field is prepended to the SUBMIT_SM destination address Default lt null data gt i 4 R 5 B b6 Prepend Data Length Description Prepend Data Length specifies the length of the prepend data It allows the SMSC_MGR to take out the prepended data from the destination address of delivery receipts from the SMSC Copyright 2002 Mitel Networks Corporation 23 Mitel NuPoint Messenger Technical Documentation Release 7 0 Default 0 i 4 B b B b6 Time out Seconds Description Time out Seconds specifies the interval between retries on failed transmissions from
2. Configuring Mailboxes and Message Formats SMSC Processes and Links Overview An SMSC process is an abstraction that represents real software configured and running at a remote SMSC You can view each SMSC process as a separate SMPP pathway The SMSC integration requires two or more SMSC processes depending on traffic expected and redundancy desired In addition to SMSC processes SMSC integration requires SMSC links SMSC links are connections for internal communication within the NuPoint Messenger server they are logical connections between two key runtime SMSC SMPP processes described later As with SMSC processes the number of SMSC links required for the integration depends on traffic expected and redundancy desired The initial step of SMSC integration is to define the SMSC processes and links and to make associations between them You enter the information as part of NuPoint Messenger server offline configuration Note SMSC process definitions are based primarily on SMSC software parameters As a result NuPoint Messenger server and SMSC administrators must cooperate to ensure that configuration information is shared and mutually understood Allocation of TCP Ports Each NuPoint Messenger server module used in the integration must have an Ethernet card and TCP IP software installed You must determine how many modules and SMSC processes are required for the configuration and allocate TCP ports appropriately The TCP ports a
3. MWI Enabled CBN Active STM Active Poller Port SMSC Name Number of MWI Agents Number of CBN Agents Number of STM Agents Link Debug Level Poller Debug Level 0 Keep Alive Active Exit E Il 2 NOON Soe ces nN Q MA MOMQNQOBZHHNACGE D ll K PEPEE EE EEE E E E EE EE E a eee ee ae Note For a detailed description of each link parameter refer to the configuration worksheets 4 Configuring Message Formats and Mailboxes This chapter covers the second and third steps for NuPoint Messenger server SMSC integration Specifically it describes how to edit the format of MWI and CBN messages and STM messagesand how to set up mailboxes to support the integration Note The first integration step is covered in Chapter 3 Configuring SMSC Processes and Links Message Format and Mailboxes Overview You must configure the format of messages that pass from the NuPoint Messenger server to the SMSC in MWI and CBN requests and STM requests You enter the information as part of the NuPoint Messenger server offline configuration process for SMSC integration MWI and CBN and STMmessage format consists of three types of information e Message index An identifier used by the SMSC to access entries in a table of predefined Copyright 2002 Mitel Networks Corporation 12 Mitel NuPoint Messenger Technical Documentation Release 7 0 messages The range of valid index numbers is 1 140 The letter F is also
4. R 6 Copyright 2002 Mitel Networks Corporation 26 Mitel NuPoint Messenger Technical Documentation Release 7 0 B iz 4 B Number of CBN Agents Description The number of SMSC_AGENT processes that will take CBN requests from MDBA format them and send them to the SMSC Range is 0 3 More agents mean increased output per minute Default 2 i b B 6 B ET 4 i Number of STM Agents Description The number of SMSC_AGENT processes that will take STM requests from MDBA format them and send them to the SMSC Range is 0 3 More agents mean increased output per minute Note STM message support is not implemented in NuPoint Messenger server Release 6 1 Default 2 i E 2 b B Zz 4 B Link Debug Level Description Specifies the granularity of CDR output from the SMSC_MGR and SMSC_AGENTs The supported levels are 0 Off 1 Fewer messages 2 Most messages Default 0 h b R 6 B Zz f B Copyright 2002 Mitel Networks Corporation 27 Mitel NuPoint Messenger Technical Documentation Release 7 0 Poller Level Description Specifies the granularity of CDR output from the SMSC_POLLER process The supported levels are 0 Off 1 Fewer messages 2 Most messages Default 0 a ee R 6 8 i i B Keep Alive Active Description Specifies whether or not the link is checked periodically to
5. 3 MDMNKMGCORESOUHE PIN Ii oQ on ut TT Note For a detailed description of each SMSC process protocol details parameter refer to the configuration worksheets After you configure SMSC processes you can configure edit MWI or CBN message format To do so exit the Protocol Details Menu to return to the SMSC Configuration Menu For details on configuring message formats see Chapter 4 Configuring Message Formats and Mailboxes Configuring Links From the SMSC Integration Menu choose L to configure links The Links Menu appears Links A Add a New Link C Copy a Link D Delete a Link E Edit a Link X Exit Copyright 2002 Mitel Networks Corporation 11 Mitel NuPoint Messenger Technical Documentation Release 7 0 At the Links Menu you have five choices e Add a New Link Creates a new link and assigns it the next available link number Propagates the new link with default values e Copy a Link Copies an existing link to a new link The new link is assigned the next available link number Delete a Link Deletes an existing link and renumbers remaining links in sequential order e Edit a Link Allows you to edit an existing link e Exit Returns you to the previous menu From the Links Menu choose A to add a new link or C to copy a link Then choose E to edit a link The Edit Link Menu appears Edit Link Link Number o1 Link Type Active Active Module
6. SMSC Processes and Links Instructions for the first of two parts of SMSC SMPP configuration Chapter 4 Configuring Mailboxes and Message Formats Instructions for the second of two parts of SMSC SMPP configuration Appendix A Configuration Worksheets Templates for recording configuration parameters What Related Documents Are Available For detailed reference on NuPoint Messenger server configuration and operating characteristics refer to the following e NuPoint Messenger Installation and Service Manual e NuPoint Messenger Reference and Configuration Manual 1 Introduction This chapter describes SMSC SMPP and relates it to elements of the mobile communications Copyright 2002 Mitel Networks Corporation Mitel NuPoint Messenger Technical Documentation Release 7 0 environment It also summarizes SMSC SMPP components and operation What is SMSC SMPP SMSC SMPP implements a Short Message Peer to Peer SMPP interface between a NuPoint Messenger server and Short Message Service Center SMSC The SMPP interface is a mechanism to integrate the NuPoint Messenger server with SMSCs SMPP allows a NuPoint Messenger server and SMSC to support the following features Message Waiting Indicator MWI and Call Back Numbers CBN The features are key to providing full service mobile communications MWI allows the NuPoint Messenger server and SMSC to alert a mobile subscriber that a message was recorded in the subscriber s
7. MSC SMPP integration products include Voice Fax Message Waiting Indicator MWI feature e Call Back Number CBN feature copyright 2002 Mitel Networks Corporation Mitel NuPoint Messenger Technical Documentation Release 7 0 The MWI feature is considered base SMSC SMPP software Customers who want the CBN feature can install CBN in addition to MWI You install optional feature software with your NuPoint Messenger server online To do so follow the instructions in the procedure CP 5402 Install Optional Feature With System Online Configuration Overview After loading SMSC SMPP optional feature software you can configure the NuPoint Messenger server SMSC integration There are three steps involved e Configuring SMSC Processes and Links e Configuring Editing Message Formats e Configuring Mailboxes for SMSC Support The first step is described in detail in Chapter 2 The second and third steps are described in Chapter 3 Following is a brief overview SMSC processes and links are mechanisms that implement SMSC integration An SMSC process represents software configured and running at the remote SMSC Each instance of SMSC process represents a separate SMPP pathway SMSC links are internal connections established by SMSC SMPP at the NuPoint Messenger server The first integration step is to identify define SMSC processes and links and to make associations between them This step involves considerable input of paramete
8. Messenger server Release 6 1 e Exit Returns you to the previous menu At the SMSC Process Configuration Menu choose W or Y or Z to edit a CBN or MWI or STM message respectively The Edit MWI CBN or STM Message Menu appears Edit MWI CBN or STM Message A Add a New Element Copy an Element Delete an Element Edit Field Separator Edit Message Index Edit Suppress Option Exit At the Edit MWI CBN or STM Message Menu you have the following seven choices Add a New Element Adds a new formatting instruction to the list of elements e Copy an Element Copies and adds an existing formatting instruction as the last element in the list e Delete an Element Deletes an existing formatting instruction and renumbers the remaining instructions in sequential order e Edit Field Separator Assigns a new hexadecimal value to the field separator The default value is 0x20 or space e Edit Message Index Assigns the message index number The default value is 0 e Edit Suppress Option Enables or disables the message suppress option Message suppress means suppress any fields after a zero data value is found in a used field e Exit Return you to the previous menu Configuring Mailboxes This section covers the mailbox setup that enables the NuPoint Messenger server to generate MWI or CBNor STM messages Part of mailbox configuration for SMSC integration involves setting one or mo
9. Mitel NuPoint Messenger Technical Documentation Release 7 0 SMSC SMPP I ntegration Manual Optional Feature for Release 6 1 2700 1426 01 Revision A March 1998 Contents Copyright 2002 Mitel Networks Corporation Distributed Courtesy of sPROMEMO m L ee eee S einCoORPORATED amp m m amp http www promemoinc com P O Box 1899 Brentwood CA 94513 Main 925 513 7510 Fax 925 775 7039 Support support promemoinc com Sales sales promemoinc com General info promemoinc com Copyright 2002 Mitel Networks Corporation Mitel NuPoint Messenger Technical Documentation Release 7 0 About This Manual This document is about NuPoint Messenger Communication server SMSC SMPP integration products SMSC SMPP products are optional feature software that allows a NuPoint Messenger server to integrate with a short message service center SMSC An SMSC is a front end device in the mobile communications environment sending and receiving messages to and from mobile stations Who Should Read This Manual This manual is for administrators who must install and configure SMSC SMPP products on a NuPoint Messenger server What s In This Manual Chapters contained in this manual are Chapter 1 Introduction A brief orientation to SMSC SMPP Chapter 2 Installing SMSC SMPP Instructions for installing SMSC SMPP files on the NuPoint Messenger server Chapter 3 Configuring
10. OS bit 271 Appendix A Configuration Worksheets Use the following worksheets to record information before attempting offline configuration The worksheets are divided into three sections e SMSC Process Configuration General Parameters e SMSC Process Configuration Protocol Detail Parameters SMSC Link Configuration Parameters Note You might want to photocopy these pages keeping the originals as templates SMSC Process Configuration General Parameters SMSC process configuration involves defining SMSC processes at the NuPoint Messenger copyright 2002 Mitel Networks Corporation 17 Mitel NuPoint Messenger Technical Documentation Release 7 0 server You can define up to six General parameters for SMSC processes include SMSC name protocol type TCP IP port primary and secondary IP address MWI source ID CBN source ID and STM source ID SMSC Name Description The name of the SMSC process definition up to 16 characters The name helps the system administrator identify the SMSC process The SMSC process name is also assigned to a link during link configuration Default SMSC1 SMSC6 i 4 R b B b6 Protocol Type Description The type of protocol that the SMSC process supports This information is used by the SMSC_MGR to know what protocol to run The only protocol type currently supported by SMSC SMPP is A Aldiscon SMPP 3 3 Default A h 4 B b bB b6 TC
11. P Port Description The TCP IP port that connects the NuPoint Messenger server with the remote SMSC Each SMSC process must specify a different port You must be sure that the assigned port numbers do not conflict with those assigned to other TCP IP based applications such as NP Net Default 5001 5006 i 4 R b B b6 Primary IP Address Description The primary TCP IP address of the SMSC Default 129 3 2 22 Copyright 2002 Mitel Networks Corporation 18 Mitel NuPoint Messenger Technical Documentation Release 7 0 h k 2 5 B 6 Secondary I P Address Description The secondary or redundant TCP IP address of the SMSC Default 129 3 2 22 i 4 R b B b6 MWI Source ID Description An ASCII string 21 characters maximum assigned by the SMSC system administrator for service type mapping for Voice Mail Alerts The string is often used as the SUBMIT_SM service_type it can be sent to the mobile station by the SMSC as the source address In addition the string is often the number for mailbox access Default 2222222222 ten 2s B b B b6 CBN Source ID Description An ASCII string 21 characters maximum assigned by the SMSC system administrator for service type mapping for CBNs The string is often used as the SUBMIT _SM source ID it can be sent to the mobile station by the SMSC as the source address In addition the string is often the
12. a the SMSC_POLLER to the SMSC Receives CBN requests from the message data base administrator MDBA Looks up mailbox status information in the OAA mailbox and builds output text Sends the text to the SMSC_MGR for transmission via the SMSC_POLLER to the SMSC e SMSC_STAT process Accumulates runtime statistics and builds a binary measurement file for each NuPoint Messenger module e SMSC_DEBUG process Runs only when the SMSC Debug option is chosen from the NuPoint Messenger console Utility Menu Displays real time status of SMSC SMPP and supports testing and performance tuning Figure 1 2 SMSC SMPP Components 2 Installing SMSC SMPP This chapter describes hardware and software requirements for SMSC SMPP It also describes how to load SMSC SMPFP files on the NuPoint Messenger server Before You Begin Optional feature software on a 3 5 inch diskette is supplied Before attempting to load files from the diskette do the following e Create a backup copy of the diskette e Check that necessary hardware for SMSC SMPP is installed on the NuPoint Messenger server Necessary hardware includes an Ethernet card for each module used in the SMSC SMPP integration e Check that the network connection between the NuPoint Messenger server and SMSC is configured correctly and operational e Check that NuPoint Messenger Release 6 1 or later software is installed on the NuPoint Messenger server Loading SMSC SMPP Files Currently S
13. a valid index entry meaning the FCOS number of the subscriber mailbox is the message index e Message text Composed of constants and variables Table 4 1 Constants are always entered in double quotes for example Unplayed U Fax F However at the console constants are displayed without quotes just as they appear on the display of the target mobile phone Variables can be either alpha or numeric Alpha and numeric fields are both left justified As noted in the table fixed alpha fields are right justified and spaced filled to the left e Field Separator A single character that is automatically placed after each constant or variable The field separator is entered in hexadecimal The default field separator is 0x20 an ASCII space character Enter FF if no field separator is used Table 4 1 Text Variables Variable Description mailbox_num Numeric up to 20 characters paging_num Numeric up to 20 characters short_text Alpha up to 40 characters lfcos Numeric 3 characters last_msg_time Alpha hh mm last_msg_date Alpha dd mm yy last_source Numeric up to 20 characters last_type Alpha 1 character V Voice F Fax l l num_unread Fixed alpha 4 characters l num_saved Fixed alpha 4 characters num_unread_fax Fixed alpha 4 characters num_saved_fax Fixed alpha 4 characters num_urgent Fixed alpha 4 characters
14. an existing mailbox If so the CLI number is stored as a mailbox number If not the CLI number is stored as a telephone number call back number If the CLI number captured automatically by the integration is overridden by the caller then the CLI is stored as a telephone number regardless of whether or not it matches an existing mailbox 264 280 CLI outside caller ON OFF If these bits are set the CLI outside caller interface is activated for the mailbox 266 SMPP CBN If this bit is set the mailbox supports CBN 267 SMPP STM If this bit is set the mailbox supports STM 268 SMPP CBNand STM receipts If this bit is set the mailbox passes CBNand STM receipts to the subscriber 271 Outstanding MWI messages If this bit is set the NuPoint Messenger server sends an SMPP cancel MWI to the SMSC on ML_OFF 272 Outstanding CBN messages If this bit is set the NuPoint Messenger server sends an SMPP cancel CBN to the SMSC on ML_OFF 280 264 CLI outside caller ON OFF If these bits are set the CLI outside caller interface is activated for the mailbox Note CLI is an optional feature that complements both MWI and CBN CLI allows the NuPoint Messenger server to automatically record a caller s number Configuring Mailboxes for MWIs Do the following to configure a mailbox to support MWI Set one of the Mail Waiting Light Fields 1 2 or 3 to type 24 SMS MWI Configuring Mail
15. boxes for CBNs Do the following to configure a mailbox to support CBNs Set FCOS bit 266 for SMPP CBN Set FCOS bit 268 for CBNand STM receipts copyright 2002 Mitel Networks Corporation Mitel NuPoint Messenger Technical Documentation Release 7 0 Configuring for Mailboxes for STMs Do the following to configure a mailbox to support STMs Set FCOS bit 267 for SMPP CBN Set FCOS 268 for CBN and STM receipts e To activate the short message text capability of bit 172 set mailbox parameters as follows Message waiting 1 24 Message waiting 2 5 Access page type 5 the same as in the SMSC link configuration Pager number 1234 Post pager number 1234 Start time 12 00 a m Stop time 12 00 a m Pager try 1 Pager interval 1 Busy attempts 1 Busy interval 1 Changing Triggers for MWI and CBN Messages The NuPoint Messenger server can send MWIls or CBN messages for every mailbox access It normally sends messages only if the caller deposits new mail When there is mailbox activity with no new mail some users might want to cancel undelivered messages others might wish to send a MWI message updating the mobile phone Three options are available e To cancel any outstanding MWI messages for activity with no new mail set mailbox FCOS bit 271 e To cancel any outstanding CBN messages for activity with no new mail set mailbox bit 272 e To send an MWI to the user for activity with no new mail set mailbox FC
16. d for SMSC_MGR RX link to SMSC_POLLER RX Figure 3 2 High Volume Configuration copyright 2002 Mitel Networks Corporation Mitel NuPoint Messenger Technical Documentation Release 7 0 Load Sharing and Redundant Configuration Load sharing and redundant configurations consist of several NuPoint Messenger server modules Figure 3 3 The first module has the primary Ethernet connection to the SMSC and another has the secondary connection Both modules have one or more SMSC_MGR POLLER transmitters for MWI and CBN requests However note that only one module probably the first has an SMSC_MGR POLLER receiver for delivery results If the module with the SMSC_MGR POLLER receiver goes out of service the receiver floats to the other module It only the Ethernet connection on the first module goes out of service the other module s SMSC_MGR POLLER transmitters continue to utilize the secondary Ethernet connection Five ports are required in this example of load sharing configuration Module 1 TCP Ports 5001 Used for TX link from NuPoint Messenger server to remote SMSC 5002 Used for RX link from NuPoint Messenger server to remote SMSC Module 1 Poller Ports 5011 Used for SMSC_MGR TX71 link to SMSC_POLLER TX1 5012 Used for SMSC_MGR TX2 link to SMSC_POLLER TX2 Module 2 Poller Ports 5013 Used for SMSC_MGR TX link to SMSC_POLLER TX Figure 3 3 Load Sharing and Redundant Configuration Configuring SMSC Processes Bef
17. determine that it is up Default Y h b B 6 B 7 4 B Copyright 2002 Mitel Networks Corporation 28
18. e High volume configuration e Load sharing and redundant configuration Basic Configuration Basic configurations consist of one NuPoint Messenger server module and one SMSC process The NuPoint Messenger server has one SMSC_MGR POLLER transmitter for MWI and CBN requests and one SMSC_MGR POLLER receiver for delivery results Figure 3 1 The SMSC has corresponding transmitter and receiver processes For the basic configuration four ports are required TCP Ports 5001 Used for TX link from NuPoint Messenger server to remote SMSC 5002 Used for RX link from NuPoint Messenger server to remote SMSC Poller Ports 5011 Used for SMSC_MGR TX to communicate with SMSC_POLLER TX 5012 Used for SMSC_MGR RX to communicate with SMSC_POLLER RX Figure 3 1 Basic Configuration High Volume Configuration High volume configurations can consist of several NuPoint Messenger server SMSC_MGR POLLER transmitters for MWI and CBN requests but only one SMSC_MGR POLLER receiver for delivery results Figure 3 2 This configuration works well for systems where call volume is high or throughput is an issue Five ports are required in this example of high volume configuration TCP Ports 5001 Used for TX link from NuPoint Messenger server to remote SMSC 5002 Used for RX link from NuPoint Messenger server to remote SMSC Poller Ports 5011 Used for SMSC_MGR TX71 link to SMSC_POLLER TX1 5012 Used for SMSC_MGR TX2 link to SMSC_POLLER TX2 5013 Use
19. e S to configure SMSC processes The SMSC Processes Menu appears SMSC Processes A Add a New SMSC C Copy a SMSC Process D Delete a SMSC Process E Edit a SMSC Process X Exit At the SMSC Processes Menu you have five choices e Add an SMSC Process Creates a new SMSC process definition and assigns it the next available SMSC number Propagates the new definition with default values e Copy an SMSC Process Copies an existing SMSC process definition to a new definition Assigns the new definition the next available SMSC number e Delete an SMSC Process Deletes an existing SMSC process definition and renumbers those remaining in sequential order e Edit an SMSC Process Allows you to edit an existing SMSC process definition e Exit Returns you to the previous menu From the SMSC Processes Menu choose A to add an SMSC process or C to copy an SMSC process Then choose E to edit an SMSC process The SMSC Process Configuration Menu appears SMSC Process Configuration SMSC Number 1 Protocol Type SMSC Name SMSC1 TCP Port 5001 Primary IP Address 129 3 2 22 Secondary IP Address 129 3 2 22 MWI Source ID 2222222222 CBN Source ID 1111111111 STM Source ID 3333333333 Edit Protocol Details Edit CBN Message Edit MWI Message Edit STM Message Exit A MNKSOPACHNHVHANEA The first eight choices let you edit general SMSC process parameters process na
20. e as SUMBIT_SM source_addr_npi Default 4 i a R b B 6 Source TON Description The GSM Type of Number TON for the source The source TON is 1 character and should be assigned by the SMSC system administrator it is the same as SUBMIT_SM source_addr_ton Copyright 2002 Mitel Networks Corporation 21 Mitel NuPoint Messenger Technical Documentation Release 7 0 Default 3 i 4 B b B b6 Destination NPI Description The GSM Numbering Plan Indicator NPI for the destination The destination NPI is 1 character and should be assigned by the SMSC system administrator it is the same as SUBMIT_SM source_addr_npi Default 1 if 4 B b B b6 Destination TON Description The GSM Type of Number TON for the destination The destination TON is 1 character and should be assigned by the SMSC system administrator it is the same as SUBMIT_SM source_addr_ton Default 1 s B b B 6 ESM Class Description The indication of message type for the deliver _sm command The ESM Class is one character and should be assigned by the SMSC system administrator it is the same as DELIVER_SM esm_class Default 0 i 4 2 5 B b6 MWI Protocol I D Description The MWI Protocol ID is one character and should be assigned by the SMSC system administrator it is the same as MWI Submit protocol ID Copyright 2002 Mitel Networks Corporation 22
21. ed then this link must also be assigned the link type of TX Default Y bo o R 6 B 7 4 B CBN Active Description Indicator that specifies whether CBN is active Y or not N on this link If CBN is enabled then this link must also be assigned the link type of TX Default Y E b R 6 8 E 4 B Copyright 2002 Mitel Networks Corporation 25 Mitel NuPoint Messenger Technical Documentation Release 7 0 STM Active Description Indicator that specifies whether STM is active Y or not N on this link If STM is enabled then this link must also be assigned the link type of TX Note STM message support is not implemented in NuPoint Messenger server Release 6 1 Default Y i b R 6 B Zz 4 B Poller Port Description The port number through which the SMSC processes communicate internally with the SMSC_POLLER process Default 5011 5018 h 5 R 6 8 i f B SMSC Name Description The name of the SMSC process definition which is assigned to this link The name is defined in the SMSC Process Configuration Menu and can be up to 16 characters Default SMSC1 2 6 6 7 a b Number of MWI Agents Description The number of SMSC_AGENT processes that will take MWI requests from MWLA format them and send them to the SMSC Range is 0 3 More agents mean increased output per minute Default 2 h b
22. ell defined formats The NuPoint Messenger server administrator configures the message data to be seen by the SMSC and usually the subscriber the SMSC might or might not alter the data The administrator configures message data by choosing from a series of NuPoint Messenger server mailbox variables and constants Each variable and constant combination is considered a separate message element A field separator automatically is inserted between each element The format for a brief message might be for example Element 1 Variable num_unread Element 2 Constant UNREAD Element 3 Variable last_source Element 4 Constant LAST CALLER Field separator 0x20 Message 33 UNREAD 4081235679 LAST CALLER For details on message format see Chapter 4 Configuring Message Format and Mailboxes copyright 2002 Mitel Networks Corporation Mitel NuPoint Messenger Technical Documentation Release 7 0 SMSC SMPP Components Figure 1 2 is a high level view of SMSC SMPP Key components are e SMSC_POLLER process Manages TCP IP communication with the SMSC SMSC_MGR process Builds MWI and CBN requests and sends them to the SMSC_POLLER for forwarding to the SMSC e SMSC_AGENT process Receives MWI requests from the message waiting light administrator MWLA Looks up mailbox status information in the open account administrator OAA mailbox and builds output text Sends the text to the SMSC_MGR for transmission vi
23. equest sent to the SMSC contains some or all of the following elements e Mailbox number e Time and date of last message e Source of last message caller ID number e Current FCOS of mailbox Copyright 2002 Mitel Networks Corporation Mitel NuPoint Messenger Technical Documentation Release 7 0 e Number of unplayed messages number of saved messages e Priority of messages normal urgent and so forth e Type of last message voice or fax e Request for delivery receipt e Replace if present flag Figure 1 1 Mobile Communications Environment Call Back Number CBN is required for paging services that provide a call back number The NuPoint Messenger server generates a CBN request whenever a cut through page is left for a subscriber whose mailbox has the SMSC pager system assigned The CBN request sent to the SMSC contains some or all of the following information e Mailbox number e Call back number e Urgent flag e Any of the information available for MWIs Delivery Receipt When the SMSC has completed its delivery attempts to the mobile phone it sends a receipt to the NuPoint Messenger server indicating whether the message was delivered Success or deleted failure The receipt triggers a message that is sent to the subscriber mailbox The CBN receipt message is Receipt for Call Back Number sent lt date and time gt the call back number was lt CBN gt Message Formats MWI and CBN messages follow w
24. mailbox CBN allows the NuPoint Messenger server and SMSC to supply the subscriber with a call back number if the subscriber wishes to call back In this document the term subscriber refers to a user at a mobile station mobile phone who has an account on both the SMSC and NuPoint Messenger server Note SMSC SMPP is based on SMPP version 3 3 and is compatible with select SMSCs that support that interface SMPP version 3 3 defines SMSC to NuPoint Messenger server communication via a TCP IP over Ethernet connection Terms and Concepts The following terms and concepts are used throughout this manual Be sure to understand this information before attempting to use SMSC SMPP Short Message Service Center An SMSC is a networked device in the mobile communications environment Figure 1 1 The SMSC provides a connection between mobile phones and voice processing systems or any message originating servers SMSCs have a transmitter and receiver to exchange messages with mobile phones through a wireless network They also have hardware and software to exchange messages with networked components over a LAN In the case of NuPoint Messenger server SMSC integration the means of exchange is TCP IP over Ethernet Voice Fax Waiting I ndicator MWI is like enhanced paging services The NuPoint Messenger server generates an MWI request whenever a new message is left in a subscriber mailbox that has the SMSMWI message waiting type assigned The MWI r
25. me protocol type and so forth The remaining choices are e Edit Protocol Details Takes you to the SMSC Process Protocol Details Menu allowing you to edit parameters that relate to protocol details for SMSC processes e Edit CBN Message Takes you to the Edit MWI CBN or STM Message Menu From there you can edit a CBN message copyright 2002 Mitel Networks Corporation 10 Mitel NuPoint Messenger Technical Documentation Release 7 0 e Edit MWI Message Takes you to the Edit MWI CBN or STM Message Menu From there you can edit an MWI message Edit STM Message Reserved for future use Note STM message support is not implemented in NuPoint Messenger server Release 6 1 e Exit Returns you to the previous menu Note For detailed descriptions of general SMSC process parameters refer to the configuration worksheets From the SMSC Process Configuration Menu choose D to edit protocol details The SMSC Process Protocol Details Menu appears SMSC Process Protocol Details Password MagicNum System Id System Type Service Type Address Range Source NPI 4 Source TON 3 Destination NPI Destination TON ESM Class 0 MWI Protocol ID CBN Protocol ID STM Protocol ID Data Coding Destination Prepen Prepend Len Time out Seconds Transmit Retries Exit H td YS YH YH HS YS YS YH HS SH TS LS NS SS NS LS LS LS ous VMS oll Hi ol ooo Pe 48 0 4
26. num_receipts Fixed alpha 4 characters Note Fixed alpha fields are right justified and space filled to the left Defaults are provided for MWI and CBN messages The defaults optimize use of the message formatting abilities of the SMSC The default CBN message is Field separator 0x20 Message index F Message text Element 1 Variable paging _num The default MWI message is Field separator 0x20 Message index F Message text Element 1 Constant T Element 2 Variable last_msg_time Copyright 2002 Mitel Networks Corporation 13 Mitel NuPoint Messenger Technical Documentation Release 7 0 Element 3 Constant D Element 4 Variable last_msg_date Element 5 Constant A Element 6 Variable last_source Element 7 Constant L Element 8 Variable last_type Element 9 Constant U Element 10 Variable num_unplayed Element 11 Constant W Element 12 Variable num_saved Element 13 Constant V Element 14 Variable num_voice Element 15 Constant F Element 16 Variable num_fax Element 17 Constant G Element 18 Variable num_urgent Note By sending the FCOS number as the message index the System Administrator can construct a wide variety of messages and send different formats to different subscribers based upon their FCOS Configuring MWI and CBNand STM Message Formats You configure edit message formats at the NuPoint Messenger server console
27. number for mailbox access Default 1111111111 ten 1s i a B b B b6 STM Source I D Description An ASCII string 21 characters maximum assigned by the SMSC system administrator for service type mapping for STMs The string is often used as the SUBMIT_SM source ID it can be sent to the mobile station by the SMSC as the source address In addition the string is often the number for mailbox access Copyright 2002 Mitel Networks Corporation 19 Mitel NuPoint Messenger Technical Documentation Release 7 0 Note STM message support is not implemented in NuPoint Messenger server Release 6 1 Default 3333333333 ten 3s i 4 R b B b6 SMSC Process Configuration Protocol Details You must specify protocol details for each of the defined SMSC processes Protocol detail parameters for SMSC processes include password system ID service type address range source NPI source TON destination NPI destination TON ESM class MWI protocol ID CBN protocol ID data coding destination prepend prepend data length time out seconds and transmit retries Password Description The password used by the SMSC for security purposes The password can be up to 9 characters and should be assigned by the SMSC system administrator it is the same as BIND password Default MagicNum i 4 R b B b6 System I D Description The ID that identifies the NuPoint Messenger serve
28. ore attempting to configure SMSC processes record configuration information on the worksheets at the end of this manual see Appendix A Configuration Worksheets You configure SMSC processes at the NuPoint Messenger server console using the Resource Configuration Manager Use the following pathway from the Main Menu to get to the SMSC Integration Menu S gt R gt R gt G The SMSC Integration Menu appears SMSC Integration S Configure SMSC Processes L Configure Links X Exit At the SMSC Integration Menu you have three choices e Configure SMSC Processes Defines SMSC processes that the NuPoint Messenger server can transmit MWIs and CBNs to or receive delivery results from You can define up to six SMSC processes however you normally define two one for transmit and one for receive e Configure Links Defines SMSC links used internally by SMSC SMPP Each link Copyright 2002 Mitel Networks Corporation Mitel NuPoint Messenger Technical Documentation Release 7 0 corresponds either to a transmit process which sends MWIls and CBNs to the SMSC or to a receiver process which gets delivery results from the SMSC The results are deposited as receipts in a mailbox Up to eight links can be defined however a normal configuration consists of one or more transmitters on each module of a system but only one receiver for an entire system e Exit Returns you to the previous menu From the SMSC Integration Menu choos
29. r to the SMSC The system ID can be up to 16 characters and should be assigned by the SMSC system administrator it is the same as BIND system_id Default Centigram h 4 B b B b6 System Type Description The ID that identifies the NuPoint Messenger server to the SMSC The system type can be up to 13 characters and should be assigned by the SMSC system administrator it is the same as BIND system_type Default VMS Copyright 2002 Mitel Networks Corporation 20 Mitel NuPoint Messenger Technical Documentation Release 7 0 h k 2 5 B 6 Service Type Description The service type that indicates the service associated with a message The service type can be up to six characters and should be assigned by the SMSC system administrator it is the same as SUBMIT_SM service_type Default None i 4 R b B b6 Address Range Description The address range is used in routing delivery results from the SMSC to the NuPoint Messenger server The address range can be up to 41 characters and should be assigned by the SMSC system administrator it is the same as BIND address_range A null value means all addresses are valid for this SMSC connection Default None h 4 B b B b6 Source NPI Description The GSM Numbering Plan Indicator NPI for the source The NPI is 1 character and should be assigned by the SMSC system administrator it is the sam
30. re FCOS bits Table 4 2 lists and describes the FCOS bits which relate to support of MWI or CBNor STM mechanisms Table 4 2 _ FCOS Bits Related to SMSC Integration FCOS Bit Description Copyright 2002 Mitel Networks Corporation 15 Mitel NuPoint Messenger Technical Documentation Release 7 0 172 Cut through paging and messaging If this bit is set the NuPoint Messenger server tries to page the mailbox subscriber using the call back number if any call back number was left by the caller If the paging system is set for a standard pager then the pager number of the subscriber is called and the call back number appears on the subscriber s pager If the paging system is set for short messages then a short message containing the CLI is sent to the subscriber s mobile phone 173 Page receipt If this bit is set the mailbox subscriber receives a receipt for each paging sent to a standard pager or short message sent to the subscriber s mobile phone 262 Store as telephone number If this bit is set the Calling Line ID CLI is stored as a telephone number call back number along with the voice fax message Even if the captured number matches an existing mailbox number it is stored as a telephone number and not as a mailbox number No existing mailbox match is attempted 263 Store as mailbox number or telephone number If this bit is set the NuPoint Messenger server tries to determine whether the CLI number matches
31. re used in either of two ways e The NuPoint Messenger server uses some TCP ports to exchange messages with the remote SMSC Each of these TCP ports is assigned to a separate SMSC process e The NuPoint Messenger server uses other TCP ports for internal communication SMSC links Each of these TCP ports is assigned to a separate link You assign TCP ports to SMSC processes as part of the first SMSC integration step You can configure up to six SMSC processes and the default TCP port number for each is SMSC1 Port 5001 SMSC4 Port 5004 SMSC2 Port 5002 SMSC5 Port 5005 SMSC3 Port 5003 SMSCE6 Port 5006 TCP ports used for SMSC links connect two key SMSC SMPP runtime processes SMSC_MGR and SMSC_POLLER These TCP ports used internally are called poller ports to avoid confusion with the TCP ports used externally Poller ports are assigned to links during SMSC SMPP configuration You can configure up to eight links and the default port number for each is Link1 Port 5011 Link4 Port 5014 Link2 Port 5012 Link5 Port 5015 copyright 2002 Mitel Networks Corporation Mitel NuPoint Messenger Technical Documentation Release 7 0 Link3 Port 5013 Link6 Port 5016 The number of TCP and poller ports required depends on the number of SMSC process and link definitions In turn the number of SMSC process and link definitions depends on the configuration desired In general there are three types of configuration e Basic configuration
32. rs For that reason worksheets to plan SMSC process and link configuration are provided in Appendix A Configuration Worksheets The second integration step is to configure the formats for messages contained in MWIs and CBNs The MWIs and CBNs are sent from the NuPoint Messenger server to the SMSC As indicated in Chapter 1 you configure message formats by assembling mailbox variables and constants in a series The variables and constants are called message elements A field separator is placed between each element The third step for SMSC integration is to set the appropriate subscriber mailbox parameters to support MWI and CBN mechanisms The first two integration steps are done offline at the NuPoint Messenger console using the Resource Configuration Manager The third step can be done through a network using the NP Mailbox Admin interface or it can be done offline at the console using the Resource Configuration Manager 3 Configuring SMSC Processes and Links This chapter covers the first of three steps for NuPoint Messenger server SMSC integration Specifically it describes how to define SMSC processes and links and how to make associations between them SMSC processes and links set up communication between the NuPoint Copyright 2002 Mitel Networks Corporation Mitel NuPoint Messenger Technical Documentation Release 7 0 Messenger server and SMSC Note The second and third integration steps are covered in Chapter 4
33. the NuPoint Messenger server to the SMSC Default 4 I 4 B b B 6 Transmit Retries Description Transmit Retries specifies the number of retries on each failed transmission between the NuPoint Messenger server and SMSC Default 3 h a B b B e Link Configuration Link configuration involves defining SMSC SMPP internal connections and associating them with SMSC processes You can define up to eight links Link parameters include Link type active active module MWI active CBN active STM active poller port SMSC name and link poller debug level Link Type Description The link type is either TX or RX depending on whether the link is used for transmitting CBNs or MWIls to the SMSC or for receiving delivery results from the SMSC Default TX i b B 6 B i 4 B Copyright 2002 Mitel Networks Corporation 24 Mitel NuPoint Messenger Technical Documentation Release 7 0 Active Description Indicator that specifies whether the link is active Y or not N Default Y i b R 6 B 7 4 B Active Module Description The NuPoint Messenger server module on which this SMSC process runs It can also be a float list for the RX link for example 1 3 4 Default 1 h b R 6 8 i 4 B MWI Active Description Indicator that specifies whether MWI is active Y or not N on this link If MWI is enabl
34. using the Resource Configuration Manager Use the following pathway from the Main Menu to get to the SMSC Process Configuration Menu S gt R gt R gt G gt S gt sE The SMSC Process Configuration Menu appears SMSC Process Configuration E SMSC Number 1 Protocol Type SMSC Name TCP Port Primary IP Address Secondary IP Address MWI Source ID CBN Source ID 1111111111 STM Source ID 3333333333 Edit Protocol Details Edit CBN Message Edit MWI Message Edit STM Message Exit A SMSC1 5001 mea ll 129 3 2 22 129 3 2 22 2222222222 ous mma l Il MNKSOUPAGCNVHAN The first eight choices let you edit general SMSC process parameters process name protocol type and so forth The remaining choices are e Edit Protocol Details Takes you to the SMSC Process Protocol Details Menu allowing you to edit parameters that relate to protocol details for SMSC processes e Edit CBN Message Takes you to the Edit MWI CBN or STM Message Menu From there you can edit a CBN message e Edit MWI Message Takes you to the Edit MWI CBN or STM Message Menu From there you can edit an MWI message Copyright 2002 Mitel Networks Corporation Mitel NuPoint Messenger Technical Documentation Release 7 0 Edit STM Message Reserved for future use Takes you to the Edit MWI CBN or STM Message Menu From there you can edit an STM message Note STM message support is not implemented in NuPoint

SMSC-SMPP Integration Manual

Contents

Download Pdf Manuals

Related Search

Related Contents