www.nordicmessaging.se

EMG 5.2.21 - User's Guide

Table of Contents Previous

Table of Contents

1. Acknowledgements

1.5 Tokyo Cabinet

2.3 Binary messages and User-Data Header (UDH)

2.4 Long messages

2.8 Message life cycle

2.9 Routing log

2.11 Protocol conversion

2.11.1 CIMD2 (Nokia)

2.11.2 SMPP (SMS Forum)

2.11.3 UCP/EMI (CMG)

2.11.4 OIS (Sema)

2.12 Performance

3. Installing or upgrading EMG

3.1 Before installing EMG

3.2 Download software

3.3 Get license key

3.4 Install software

3.4.1 Full distribution

3.4.2 Binaries-only

3.5 Configure software

3.6 Starting, stopping and refreshing the server

3.7 On-disk message store

4. Configuration

4.2 Refreshing the server

4.3 Testing a configuration

4.4 The license file

4.4.1 License expiration dates

5.1 Connector types

5.2 Connector modes

5.3 Static vs non-static

5.4 Connector states

5.6 Message types

5.8 Address rewriting

5.8.1 Masquerading

5.8.2 Source Address Translation (SAT)

5.9 Inheritance and virtual connectors

5.10 Limiting connector queue sizes

5.11 Sample configurations

5.11.1 Incoming MGP supporting up to 3 connections

5.11.2 Incoming SMPP supporting up to 10 connections

5.11.3 Incoming CIMD2 supporting 1 connection

5.11.4 Outgoing SMPP

5.11.5 Outgoing UCP using authentication via operation 60

5.11.6 Outgoing UCP via modem

5.11.7 Outgoing HTTP

5.11.8 Outgoing EBE

5.11.9 Outgoing GSM

5.11.10 Outgoing OIS

6.1 Specifying a routing criteria for a message

6.2 Specifying a routing criteria for a connector

6.2.1 The REDIRECT keyword

6.3 Routing table

6.3.1 Regular expressions

6.3.2 Advanced routing on message options

6.3.3 Setting message options

6.5 Load balancing

6.6 User-based routing

6.7 Routing to a specific user

6.8 Keyword-based routing

6.8.1 Sample scenario

6.8.2 Setting up the connectors

6.8.3 Setting up the routing table

6.8.4 Keyword sessions

6.9 Concatenated Message Routing (CMR)

7. Sending messages

7.1 Using HTTP connector

7.2 Using SMTP connector

7.2.1 Sample outgoing SMTP session

7.3 Using EBE connector

7.4 Using emgsend

7.5 Using emgclient

7.6 Sending MMS

8. Receiving messages

8.1 Using HTTP connector

8.2 Using SMTP connector

8.2.1 Sample incoming SMTP session

8.2.2 Preventing SMTP relaying

8.3 Receiving WAP push via PAP

9. Delivery receipts (DLR)

9.2 Requesting a DLR

9.2.1 Using emgsend

9.2.2 Using connector keyword

9.3 Routing DLRs

9.4 DLRs and buffered status

10.1 Location of log files

10.2 Format of log files

10.2.1 Connector log file

10.2.2 Sample incoming connector log file

10.2.3 Sample outgoing connector log file

10.2.4 PDU log files

10.3 Log file rotation

10.3.1 Log file rotation based on time

10.3.2 Log file rotation based on size

10.4 Logging to a database

11.1 Access control

11.2 Authentication

11.3 Blacklists and whitelists

11.4.1 Outgoing SSL without a certificate

11.4.2 Incoming SSL

12. Database support

12.1 Getting started with a DB

12.1.1 Installing the database server

12.1.2 Initializing the database

12.1.3 Creating a database profile

12.1.4 Referencing a database profile

12.2 Using the database

12.2.1 Putting the message route log in a database

12.2.2 Putting the connector log in a database

12.2.3 User authentication from database

12.3 Schema version handling

13. Performance

13.1 Hardware and operating system

13.1.4 Operating system

13.4 Other issues

13.4.1 Modifying message content

13.4.2 Server logging and debug mode

13.5 About benchmarks

14.2.1 Normal mode

14.3 Proxy mode

14.4 Configuration

14.4.1 One-to-one mapping

14.4.2 One-to-many mapping (fail-over)

14.4.3 One-to-many mapping (load balancing)

A. Command reference

B. Configuration options

B.1 General options

B.1.2 BLACKLIST

B.1.3 CMREXPIRE

B.1.4 CONNECTORLOGDB

B.1.5 CONNECTOR_LOGLEVEL

B.1.6 DBPROFILE

B.1.7 DISABLE_CREDITS

B.1.8 DISABLE_MESSAGEBODY

B.1.9 DISABLE_MESSAGEOPTION

B.1.10 DLRSSIZE

B.1.12 DNSTHREADS

B.1.13 EXPIRE_INTERVAL

B.1.14 IDWINDOW

B.1.15 KWSTORE_EXPIRES

B.1.16 KWSTORE_ROTATE_SIZE

B.1.17 LOGLEVEL

B.1.19 MAXTOTALQUEUESIZE

B.1.20 MAXTOTALQUEUESIZE_SOFT

B.1.21 NOEXPIRE

B.1.23 NOLOGSERVER

B.1.24 ORPHANSSIZE

B.1.25 PERSISTFILES

B.1.26 PERSISTSIZE

B.1.27 ROTATELOGS

B.1.28 ROUTEDLR

B.1.29 ROUTELOGDB

B.1.30 ROUTELOGSIZE

B.1.32 SERVERNAME

B.1.34 SPOOLDIR

B.1.35 SSL_KEYFILE

B.1.36 SSL_PASSWORD

B.1.37 TABLE_PREFIX

B.1.38 TIME_OFFSET

B.1.39 WHITELIST

B.2 Connector options

B.2.3 ADDRESSRANGE

B.2.4 ALLOWROUTE

B.2.8 AUTOMATICTONNPI

B.2.9 AUTOMATICTONNPI_ALPHANUMERIC_NPI

B.2.10 AUTOMATICTONNPI_ALPHANUMERIC_TON

B.2.11 AUTOMATICTONNPI_DEFAULT_NPI

B.2.12 AUTOMATICTONNPI_DEFAULT_TON

B.2.13 AUTOMATICTONNPI_SHORTCODE_NPI

B.2.14 AUTOMATICTONNPI_SHORTCODE_TON

B.2.15 BINARYMAPPING

B.2.16 BLACKLIST

B.2.18 CDMA_NO_PORTS

B.2.19 CDRFIELDS

B.2.21 DEFAULT_CHARCODE

B.2.22 DEFAULT_DESTADDRNPI

B.2.23 DEFAULT_DESTADDRNPI_IN

B.2.24 DEFAULT_DESTADDRTON

B.2.25 DEFAULT_DESTADDRTON_IN

B.2.26 DEFAULT_DLR

B.2.27 DEFAULT_DLR_IN

B.2.28 DEFAULT_DLR_OUT

B.2.29 DEFAULT_DLRADDRESS

B.2.30 DEFAULT_MSGTYPE

B.2.31 DEFAULT_NT

B.2.32 DEFAULT_PROTOCOLID

B.2.33 DEFAULT_QPRIORITY

B.2.34 DEFAULT_SMSCOP

B.2.35 DEFAULT_SOURCEADDR

B.2.36 DEFAULT_SOURCEADDRNPI

B.2.37 DEFAULT_SOURCEADDRNPI_IN

B.2.38 DEFAULT_SOURCEADDRTON

B.2.39 DEFAULT_SOURCEADDRTON_IN

B.2.40 DEFAULT_VP

B.2.41 DELAYFIRSTMESSAGE

B.2.42 DESTFULLNAME

B.2.43 DLR_ERR_HEX

B.2.44 DLR_EXPIRES_STATUS

B.2.45 DLR_SUPPORT

B.2.46 DLREXPIRES

B.2.47 DLRIGNOREKEYWORD

B.2.48 DLRMINMATCHLENGTH

B.2.50 FAILOVER

B.2.51 FAILOVER_ALL

B.2.52 FAILOVER_ALL_TO_SELF

B.2.53 FIRST_TRN

B.2.54 FORCE_CHARCODE

B.2.55 FORCECLOSE

B.2.56 FORCE_DCS

B.2.57 FORCE_DESTADDR

B.2.58 FORCE_DESTADDR_IN

B.2.59 FORCE_DESTADDRNPI

B.2.60 FORCE_DESTADDRNPI_IN

B.2.61 FORCE_DESTADDRTON

B.2.62 FORCE_DESTADDRTON_IN

B.2.63 FORCE_DESTPORT_IN

B.2.64 FORCE_DLR

B.2.65 FORCE_DLR_IN

B.2.66 FORCE_DLR_OUT

B.2.67 FORCE_MESSAGE

B.2.68 FORCE_PRIORITY

B.2.69 FORCE_PROTOCOLID

B.2.70 FORCE_SERVICETYPE

B.2.71 FORCE_SERVICETYPE_IN

B.2.72 FORCE_SOURCEADDR

B.2.73 FORCE_SOURCEADDR_IN

B.2.74 FORCE_SOURCEADDRNPI

B.2.75 FORCE_SOURCEADDRNPI_IN

B.2.76 FORCE_SOURCEADDRTON

B.2.77 FORCE_SOURCEADDRTON_IN

B.2.78 FORCE_SOURCEPORT_IN

B.2.79 FORCE_VP

B.2.80 GSMNOSCA

B.2.81 GSMSTORE

B.2.83 HOME_IMSI

B.2.84 HOME_VLR

B.2.85 IDLETIMEOUT

B.2.86 IGNOREMAXTOTALQUEUESIZE

B.2.88 INITSTRING

B.2.89 INSTANCES

B.2.90 INTERFACEVERSION

B.2.91 KEEPALIVE

B.2.93 LOCALDOMAINS

B.2.94 LOCALIPS

B.2.95 LOGLEVEL

B.2.96 LOGMESSAGE

B.2.98 LONGMESSAGE

B.2.99 LONGMODE

B.2.100 MAPPING

B.2.101 MASQUERADE

B.2.102 MAXFAILEDCONNECTS

B.2.103 MAXFAILEDSLEEP

B.2.104 MAXMESSAGELENGTH

B.2.105 MAXTRIES

B.2.106 MESSAGELENGTH

B.2.107 MESSAGEMODE

B.2.108 MESSAGES_PER_REQUEST

B.2.109 MIMEBOUNDARY

B.2.110 MMS_TEXT_CHARSET

B.2.113 MODEM_BPS

B.2.114 MSGDELAY

B.2.115 MSGRETRYTIME

B.2.116 NOBINARYMAPPING

B.2.118 NOUCS2MAPPING

B.2.119 NOUSERMESSAGEREFERENCE

B.2.120 OPSENTEXPIRES

B.2.121 OPS_MAXEXPIRED

B.2.122 OPS_MAXOUTSTANDING

B.2.123 OPS_MAXPENDING

B.2.124 OPS_MAXPERSESSION

B.2.126 PARSEMESSAGE

B.2.127 PASSWORD

B.2.129 POLLRECEIVE

B.2.130 PRE_SPLIT

B.2.132 PRESERVESAR

B.2.134 PROTOCOL

B.2.136 QUOTEDREPLY_SEPARATOR

B.2.137 QUOTEDSUBJECT

B.2.138 REDIRECT

B.2.139 REGEXP_DESTADDR

B.2.140 REGEXP_DESTADDR_IN

B.2.141 REGEXP_KEYWORD

B.2.142 REGEXP_MESSAGE

B.2.143 REGEXP_SOURCEADDR

B.2.144 REGEXP_SOURCEADDR_IN

B.2.145 REJECT_EMPTY

B.2.146 RELATIVE_VP

B.2.147 REMOVEPREFIX

B.2.148 REMOVEPREFIX_SOURCEADDR

B.2.149 REPLACEPREFIX

B.2.150 REPLACEPREFIX_IN

B.2.151 REPLACEPREFIX_SOURCEADDR

B.2.152 REPLACEPREFIX_SOURCEADDR_IN

B.2.153 REQUIREPREFIX

B.2.154 REQUIREPREFIX_SOURCEADDR

B.2.155 RETRYSCHEME

B.2.156 RETRYTIME

B.2.158 REVDLR_IN

B.2.160 ROUTEDLR

B.2.161 ROUTING

B.2.162 SATPOOL_CREATE

B.2.163 SATPOOL_CREATE_IN

B.2.164 SATPOOL_LOOKUP

B.2.165 SATPOOL_LOOKUP_IN

B.2.166 SAVE_SMSCIDS

B.2.167 SCAADDR

B.2.168 SCAADDRNPI

B.2.169 SCAADDRTON

B.2.170 SENDERADDRESS

B.2.171 SERVICETYPE

B.2.172 SIMULATE

B.2.173 SMPP_ESME_TO_UCP_EC_MAP

B.2.174 SMPP_ESME_TO_UCP_MAP

B.2.175 SMPP_NEC_TO_UCP_MAP

B.2.177 SOURCEADDR_GSM

B.2.178 SOURCEFULLNAME

B.2.180 SSL_KEYFILE

B.2.181 SSL_PASSWORD

B.2.183 SUBADDRESS

B.2.184 SUBJECT

B.2.185 SUPPRESS_EMGHEADERS

B.2.186 SYSTEMTYPE

B.2.187 TCPSOURCEIP

B.2.188 TCPSOURCEPORT

B.2.189 THROUGHPUT

B.2.191 USC2MAPPING

B.2.192 UDHVIAOPTIONAL

B.2.193 USEDELTIME

B.2.194 USEPRIORITY

B.2.196 USERNAME

B.2.198 USESENDER

B.2.199 USESUBJECT

B.2.202 VIRTUAL

B.2.203 WAITBEFORECONNECT

B.2.204 WAITDELAY

B.2.205 WAITFOR

B.2.206 WHITELIST

B.2.207 WINDOWSIZE

B.2.209 XAUTHPASSWORD

B.2.210 XAUTHUSERNAME

B.2.211 XPASSWORD

B.2.212 XUSERNAME

B.3.3 INSTANCES

B.4 SAT pool options

B.4.1 ADDRESSRANGE

B.4.3 QUOTEDREPLY

B.5 Domain options

B.5.1 MAILSPERMINUTE

B.5.2 MAILSPERSESSION

B.5.4 RETRYTIME

B.6 Plugin options

B.6.2 INSTANCES

C.1 Option keys in numeric order

C.2 Options reference

C.2.1 BlLLINGID (79)

C.2.2 CHARCODE (28)

C.2.3 CONCATSMSMAX (75)

C.2.4 CONCATSMSREF (73)

C.2.5 CONCATSMSSEQ (74)

C.2.6 CONNECTOR (59)

C.2.7 DCS (113)

C.2.8 DELTIME (20)

C.2.9 DESTADDR (8)

C.2.10 DESTADDRNPI (10)

C.2.11 DESTADDRTON (9)

C.2.12 DESTPORT (12)

C.2.13 DLR (19)

C.2.14 DLRID (81)

C.2.15 ENDMSECS (96)

C.2.16 ENDSECS (95)

C.2.17 HPLMNADDR (110)

C.2.19 LRADDR (108)

C.2.20 LRPID (109)

C.2.21 MESSAGE (16)

C.2.22 MESSAGELEN (17)

C.2.23 MSGCLASS (27)

C.2.24 MSGTYPE (15)

C.2.25 NOTE (97)

C.2.26 OTOA (112)

C.2.27 OUTCONNECTOR (60)

C.2.28 PRIORITY (32)

C.2.29 PROTOCOLID (43)

C.2.30 QPRIORITY (118)

C.2.31 REMOTEIP (34)

C.2.32 REPLACEPID (107)

C.2.33 REPLYPATH (31)

C.2.34 ROUTE (38)

C.2.35 SCTS (21)

C.2.36 SMSCID (64)

C.2.37 SOURCEADDR (2)

C.2.38 SOURCEADDRNPI (4)

C.2.39 SOURCEADDRTON (3)

C.2.40 SOURCEPORT (6)

C.2.41 STARTMSECS (94)

C.2.42 STARTSECS (93)

C.2.43 STATUS (61)

C.2.44 SUBJECT (111)

C.2.45 UDH (14)

C.2.46 UDHI (106)

C.2.47 USER (30)

C.2.49 XUSERNAME (119)

E. SMSC inter-connectivity checklist

E.1 Your requirements

E.1.1 Send messages

E.1.2 Receive messages

E.1.3 Type of messages

E.1.4 Performance or message volume

E.1.5 Support and service

E.2 SMSC connection

E.2.1 Type of connection

E.2.3 Performance

E.3 Getting started

E.3.1 Account information

E.3.2 Sending the first message

E.3.3 Receiving a message

F. Change history

F.1 EMG 5.2.21.29764

F.2 EMG 5.2.20.29649

F.3 EMG 5.2.19.27495

F.4 EMG 5.2.18.27495

F.5 EMG 5.2.17.27380

F.6 EMG 5.2.16.27335

F.7 EMG 5.2.15.27271

F.8 EMG 5.2.14.27093

F.9 EMG 5.2.13.26773

F.10 EMG 5.2.12.26440

F.11 EMG 5.2.11.25846

F.12 EMG 5.2.10.25696

F.13 EMG 5.2.9.25495

F.14 EMG 5.2.8.25331

F.15 EMG 5.2.7.24722

F.16 EMG 5.2.6.24643

F.17 EMG 5.2.5.24257

F.18 EMG 5.2.4.24035

F.19 EMG 5.2.3.23815

F.20 EMG 5.2.2.23740

F.21 EMG 5.2.1.23721

F.22 EMG 5.2.0.23570

Table of Contents Previous