www.nordicmessaging.se

EMG 3.0.17 - User's Guide

Table of ContentsPreviousNextIndex

Table of Contents

1. Acknowledgements

1.1 OpenSSL

1.2 LibXML

1.3 PCRE

1.4 PCRS

2. Overview

2.1 Licensing

2.2 Messages

2.3 Binary messages and User-Data Header (UDH)

2.4 Long messages

2.5 MMS

2.6 Connectors

2.7 Routing

2.8 Message life cycle

2.9 Routing log

2.10 Orphans

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

2.13 Support

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.1 General

4.2 Refreshing the server

4.3 Testing a configuration

5. Connectors

5.1 Connector types

5.2 Connector modes

5.3 Static vs non-static

5.4 Connector states

5.5 Instances

5.6 Message types

5.7 Mappings

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. Routing

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.4 Failover

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.1 Overview

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. Logging

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. Security

11.1 Access control

11.2 Authentication

11.3 Blacklists and whitelists

11.4 Using SSL

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.1 CPU

13.1.2 RAM

13.1.3 Disk

13.1.4 Operating system

13.2 Protocols

13.3 Instances

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

A.1 emgclient

A.2 emgd

A.3 emgsend

A.4 emgstat

A.5 mmscomp

A.6 pushtohex

A.7 rttltohex

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.9 DLRSSIZE

B.1.10 DLRVP

B.1.11 DNSTHREADS

B.1.12 EXPIREI_INTERVAL

B.1.13 LOGFLUSHSIZE

B.1.14 LOGLEVEL

B.1.15 LOGYEAR

B.1.16 MAXTOTALQUEUESIZE

B.1.17 NOEXPIRE

B.1.18 NOFLUSH

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.27 ROUTING

B.1.28 SERVERNAME

B.1.29 SHMKEY

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.1 ACCESS

B.2.2 ADDRESS

B.2.3 ADDRESSRANGE

B.2.4 ALLOWROUTE

B.2.5 AUTHCODE

B.2.6 AUTHNPI

B.2.7 AUTHTON

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.16 CDMA

B.2.17 CDRFIELDS

B.2.18 CMR

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.43 DOMAIN

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.73 HEXID

B.2.74 HOME_IMSI

B.2.75 HOME_VLR

B.2.76 IDLETIMEOUT

B.2.77 IGNOREMAXTOTALQUEUESIZE

B.2.78 INHERIT

B.2.79 INITSTRING

B.2.80 INSTANCES

B.2.81 INTERFACEVERSION

B.2.82 KEEPALIVE

B.2.83 LIBRARY

B.2.84 LOCALDOMAINS

B.2.85 LOCALIPS

B.2.86 LOGLEVEL

B.2.87 LOGMESSAGE

B.2.88 LOGPDU

B.2.89 LONGMESSAGE

B.2.90 LONGMODE

B.2.91 MAPPING

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.102 MODE

B.2.103 MODEM

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.116 ORIGIN

B.2.117 PARSEMESSAGE

B.2.118 PASSWORD

B.2.119 PLUGIN

B.2.120 POLLRECEIVE

B.2.121 PREFIX

B.2.122 PRESERVESAR

B.2.123 PROMPT

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.145 REVDLR

B.2.146 REVDLR_IN

B.2.147 ROUTE

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.161 SMPPTZ

B.2.162 SOURCEADDR_GSM

B.2.163 SOURCEFULLNAME

B.2.164 SSL

B.2.165 SSL_KEYFILE

B.2.166 SSL_PASSWORD

B.2.167 STATIC

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.175 TYPE

B.2.176 UDHVIAOPTIONAL

B.2.177 USEDELTIME

B.2.178 USEPRIORITY

B.2.179 USERDB

B.2.180 USERDB_FORCE

B.2.181 USERNAME

B.2.182 USERS

B.2.183 USESENDER

B.2.184 USESUBJECT

B.2.185 VASID

B.2.186 VASPID

B.2.187 VIRTUAL

B.2.188 WAITBEFORECONNECT

B.2.189 WAITDELAY

B.2.190 WAITFOR

B.2.191 WHITELIST

B.2.192 XAUTH

B.2.193 XAUTHPASSWORD

B.2.194 XAUTHUSERNAME

B.2.195 XPASSWORD

B.2.196 XUSERNAME

B.3 DB options

B.3.1 DBNAME

B.3.2 HOST

B.3.3 INSTANCES

B.3.4 PASSWORD

B.3.5 PORT

B.3.6 TYPE

B.3.7 USERNAME

B.4 SAT pool options

B.4.1 ADDRESSRANGE

B.4.2 EXPIRE

B.4.3 QUOTEDREPLY

B.4.4 THREADED

B.5 Domain options

B.5.1 MAILSPERMINUTE

B.5.2 MAILSPERSESSION

B.5.3 PORT

B.5.4 RETRYTIME

B.5.5 SESSIONS

B.6 Plugin options

B.6.1 CONFIG

B.6.2 INSTANCES

B.6.3 LIBRARY

B.6.4 OFFSET

C. MGP options

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.18 ID (1)

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.48 VP (18)

C.2.49 XUSERNAME (119)

D. Error codes

D.1 CIMD2

D.2 SMPP

D.3 UCP/EMI

D.4 OIS

D.5 HTTP

D.6 SMTP

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.2 Protocol

E.2.3 Performance

E.2.4 Security

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

F.16 EMG 3.0

Table of ContentsPreviousNextIndex