www.nordicmessaging.se

EMG 3.0.17 - User's Guide

Table of Contents Previous

Table of Contents

1. Acknowledgements

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 Persistence

4. Configuration

4.2 Refreshing the server

4.3 Testing a configuration

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 CIMD2

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.5 Load balancing

6.6 User-based routing

6.7 Keyword-based routing

6.7.1 Sample scenario

6.7.2 Setting up the connectors

6.7.3 Setting up the routing table

6.7.4 Keyword sessions

6.8 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

A. Command reference

B. Configuration options

B.1 General options

B.1.1 BLACKLIST

B.1.2 CMREXPIRE

B.1.3 CONNECTORLOGDB

B.1.4 CONNECTOR_LOGLEVEL

B.1.5 DBPROFILE

B.1.6 DISABLE_CREDITS

B.1.7 DISABLE_MESSAGEBODY

B.1.8 DISABLE_MESSAGEOPTION

B.1.11 DNSTHREADS

B.1.12 EXPIREI_INTERVAL

B.1.13 LOGFLUSHSIZE

B.1.14 LOGLEVEL

B.1.16 MAXTOTALQUEUESIZE

B.1.17 NOEXPIRE

B.1.19 NOLOGSERVER

B.1.20 ORPHANSSIZE

B.1.21 PERSISTFILES

B.1.22 PERSISTSIZE

B.1.23 ROTATELOGS

B.1.24 ROUTEDLR

B.1.25 ROUTELOGDB

B.1.26 ROUTELOGSIZE

B.1.28 SERVERNAME

B.1.30 SPOOLDIR

B.1.31 SSL_KEYFILE

B.1.32 SSL_PASSWORD

B.1.33 TABLE_PREFIX

B.1.34 TIME_OFFSET

B.1.35 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 BLACKLIST

B.2.17 CDRFIELDS

B.2.19 DEFAULT_CHARCODE

B.2.20 DEFAULT_DESTADDRNPI

B.2.21 DEFAULT_DESTADDRNPI_IN

B.2.22 DEFAULT_DESTADDRTON

B.2.23 DEFAULT_DESTADDRTON_IN

B.2.24 DEFAULT_DLR

B.2.25 DEFAULT_DLRADDRESS

B.2.26 DEFAULT_MSGTYPE

B.2.27 DEFAULT_PROTOCOLID

B.2.28 DEFAULT_QPRIORITY

B.2.29 DEFAULT_SMSCOP

B.2.30 DEFAULT_SOURCEADDR

B.2.31 DEFAULT_SOURCEADDRNPI

B.2.32 DEFAULT_SOURCEADDRNPI_IN

B.2.33 DEFAULT_SOURCEADDRTON

B.2.34 DEFAULT_SOURCEADDRTON_IN

B.2.35 DEFAULT_VP

B.2.36 DELAYFIRSTMESSAGE

B.2.37 DESTFULLNAME

B.2.38 DLR_ERR_HEX

B.2.39 DLREXPIRES

B.2.40 DLR_EXPIRES_STATUS

B.2.41 DLRIGNOREKEYWORD

B.2.42 DLRMINMATCHLENGTH

B.2.44 FAILOVER

B.2.45 FAILOVER_ALL

B.2.46 FIRST_TRN

B.2.47 FORCE_CHARCODE

B.2.48 FORCECLOSE

B.2.49 FORCE_DCS

B.2.50 FORCE_DESTADDR

B.2.51 FORCE_DESTADDR_IN

B.2.52 FORCE_DESTADDRNPI

B.2.53 FORCE_DESTADDRNPI_IN

B.2.54 FORCE_DESTADDRTON

B.2.55 FORCE_DESTADDRTON_IN

B.2.56 FORCE_DESTPORT_IN

B.2.57 FORCE_DLR

B.2.58 FORCE_MESSAGE

B.2.59 FORCE_PRIORITY

B.2.60 FORCE_PROTOCOLID

B.2.61 FORCE_SERVICETYPE

B.2.62 FORCE_SERVICETYPE_IN

B.2.63 FORCE_SOURCEADDR

B.2.64 FORCE_SOURCEADDR_IN

B.2.65 FORCE_SOURCEADDRNPI

B.2.66 FORCE_SOURCEADDRNPI_IN

B.2.67 FORCE_SOURCEADDRTON

B.2.68 FORCE_SOURCEADDRTON_IN

B.2.69 FORCE_SOURCEPORT_IN

B.2.70 FORCE_VP

B.2.71 GSMNOSCA

B.2.72 GSMSTORE

B.2.74 HOME_IMSI

B.2.75 HOME_VLR

B.2.76 IDLETIMEOUT

B.2.77 IGNOREMAXTOTALQUEUESIZE

B.2.79 INITSTRING

B.2.80 INSTANCES

B.2.81 INTERFACEVERSION

B.2.82 KEEPALIVE

B.2.84 LOCALDOMAINS

B.2.85 LOCALIPS

B.2.86 LOGLEVEL

B.2.87 LOGMESSAGE

B.2.89 LONGMESSAGE

B.2.90 LONGMODE

B.2.92 MASQUERADE

B.2.93 MAXFAILEDCONNECTS

B.2.94 MAXFAILEDSLEEP

B.2.95 MAXMESSAGELENGTH

B.2.96 MAXTRIES

B.2.97 MESSAGELENGTH

B.2.98 MESSAGEMODE

B.2.99 MESSAGES_PER_REQUEST

B.2.100 MIMEBOUNDARY

B.2.101 MMS_TEXT_CHARSET

B.2.104 MODEM_BPS

B.2.105 MSGDELAY

B.2.106 MSGRETRYTIME

B.2.107 MTBILLING

B.2.108 NOBINARYMAPPING

B.2.109 NOUCS2MAPPING

B.2.110 NOUSERMESSAGEREFERENCE

B.2.111 OPSENTEXPIRES

B.2.112 OPS_MAXINCOMING

B.2.113 OPS_MAXOUTGOING

B.2.114 OPS_MAXOUTSTANDING

B.2.115 OPS_MAXPERSESSION

B.2.117 PARSEMESSAGE

B.2.118 PASSWORD

B.2.120 POLLRECEIVE

B.2.122 PRESERVESAR

B.2.124 PROTOCOL

B.2.125 QUOTEDREPLY_SEPARATOR

B.2.126 QUOTEDSUBJECT

B.2.127 REDIRECT

B.2.128 REGEXP_DESTADDR

B.2.129 REGEXP_DESTADDR_IN

B.2.130 REGEXP_KEYWORD

B.2.131 REGEXP_MESSAGE

B.2.132 REGEXP_SOURCEADDR

B.2.133 REGEXP_SOURCEADDR_IN

B.2.134 REJECT_EMPTY

B.2.135 REMOVEPREFIX

B.2.136 REMOVEPREFIX_SOURCEADDR

B.2.137 REPLACEPREFIX

B.2.138 REPLACEPREFIX_IN

B.2.139 REPLACEPREFIX_SOURCEADDR

B.2.140 REPLACEPREFIX_SOURCEADDR_IN

B.2.141 REQUIREPREFIX

B.2.142 REQUIREPREFIX_SOURCEADDR

B.2.143 RETRYSCHEME

B.2.144 RETRYTIME

B.2.146 REVDLR_IN

B.2.148 ROUTEDLR

B.2.149 ROUTING

B.2.150 SATPOOL_CREATE

B.2.151 SATPOOL_CREATE_IN

B.2.152 SATPOOL_LOOKUP

B.2.153 SATPOOL_LOOKUP_IN

B.2.154 SCAADDR

B.2.155 SCAADDRNPI

B.2.156 SCAADDRTON

B.2.157 SENDERADDRESS

B.2.158 SEPARATOR

B.2.159 SERVICETYPE

B.2.160 SIMULATE

B.2.162 SOURCEADDR_GSM

B.2.163 SOURCEFULLNAME

B.2.165 SSL_KEYFILE

B.2.166 SSL_PASSWORD

B.2.168 SUBADDRESS

B.2.169 SUBJECT

B.2.170 SUPPRESS_EMGHEADERS

B.2.171 SYSTEMTYPE

B.2.172 TCPSOURCEIP

B.2.173 TCPSOURCEPORT

B.2.174 THROUGHPUT

B.2.176 UDHVIAOPTIONAL

B.2.177 USEDELTIME

B.2.178 USEPRIORITY

B.2.180 USERDB_FORCE

B.2.181 USERNAME

B.2.183 USESENDER

B.2.184 USESUBJECT

B.2.187 VIRTUAL

B.2.188 WAITBEFORECONNECT

B.2.189 WAITDELAY

B.2.190 WAITFOR

B.2.191 WHITELIST

B.2.193 XAUTHPASSWORD

B.2.194 XAUTHUSERNAME

B.2.195 XPASSWORD

B.2.196 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 3.0.17.18116

F.2 EMG 3.0.16.14262

F.3 EMG 3.0.15.12050

F.4 EMG 3.0.14.11726

F.5 EMG 3.0.13.10913

F.6 EMG 3.0.12.10307

F.7 EMG 3.0.11.9982

F.8 EMG 3.0.10.9505

F.9 EMG 3.0.9.9284

F.10 EMG 3.0.8.9115

F.11 EMG 3.0.7.8470

F.12 EMG 3.0.6.8403

F.13 EMG 3.0.5.7719

F.14 EMG 3.0.4.6983

F.15 EMG 3.0.3.6691

Table of Contents Previous