www.nordicmessaging.se

EMG 3.1.5 - 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_DLR_IN

B.2.26 DEFAULT_DLR_OUT

B.2.27 DEFAULT_DLRADDRESS

B.2.28 DEFAULT_MSGTYPE

B.2.29 DEFAULT_PROTOCOLID

B.2.30 DEFAULT_QPRIORITY

B.2.31 DEFAULT_SMSCOP

B.2.32 DEFAULT_SOURCEADDR

B.2.33 DEFAULT_SOURCEADDRNPI

B.2.34 DEFAULT_SOURCEADDRNPI_IN

B.2.35 DEFAULT_SOURCEADDRTON

B.2.36 DEFAULT_SOURCEADDRTON_IN

B.2.37 DEFAULT_VP

B.2.38 DELAYFIRSTMESSAGE

B.2.39 DESTFULLNAME

B.2.40 DLR_ERR_HEX

B.2.41 DLREXPIRES

B.2.42 DLR_EXPIRES_STATUS

B.2.43 DLRIGNOREKEYWORD

B.2.44 DLRMINMATCHLENGTH

B.2.45 DOMAIN

B.2.46 FAILOVER

B.2.47 FAILOVER_ALL

B.2.48 FIRST_TRN

B.2.49 FORCE_CHARCODE

B.2.50 FORCECLOSE

B.2.51 FORCE_DCS

B.2.52 FORCE_DESTADDR

B.2.53 FORCE_DESTADDR_IN

B.2.54 FORCE_DESTADDRNPI

B.2.55 FORCE_DESTADDRNPI_IN

B.2.56 FORCE_DESTADDRTON

B.2.57 FORCE_DESTADDRTON_IN

B.2.58 FORCE_DESTPORT_IN

B.2.59 FORCE_DLR

B.2.60 FORCE_DLR_IN

B.2.61 FORCE_DLR_OUT

B.2.62 FORCE_MESSAGE

B.2.63 FORCE_PRIORITY

B.2.64 FORCE_PROTOCOLID

B.2.65 FORCE_SERVICETYPE

B.2.66 FORCE_SERVICETYPE_IN

B.2.67 FORCE_SOURCEADDR

B.2.68 FORCE_SOURCEADDR_IN

B.2.69 FORCE_SOURCEADDRNPI

B.2.70 FORCE_SOURCEADDRNPI_IN

B.2.71 FORCE_SOURCEADDRTON

B.2.72 FORCE_SOURCEADDRTON_IN

B.2.73 FORCE_SOURCEPORT_IN

B.2.74 FORCE_VP

B.2.75 GSMNOSCA

B.2.76 GSMSTORE

B.2.77 HEXID

B.2.78 HOME_IMSI

B.2.79 HOME_VLR

B.2.80 IDLETIMEOUT

B.2.81 IGNOREMAXTOTALQUEUESIZE

B.2.82 INHERIT

B.2.83 INITSTRING

B.2.84 INSTANCES

B.2.85 INTERFACEVERSION

B.2.86 KEEPALIVE

B.2.87 LIBRARY

B.2.88 LOCALDOMAINS

B.2.89 LOCALIPS

B.2.90 LOGLEVEL

B.2.91 LOGMESSAGE

B.2.92 LOGPDU

B.2.93 LONGMESSAGE

B.2.94 LONGMODE

B.2.95 MAPPING

B.2.96 MASQUERADE

B.2.97 MAXFAILEDCONNECTS

B.2.98 MAXFAILEDSLEEP

B.2.99 MAXMESSAGELENGTH

B.2.100 MAXTRIES

B.2.101 MESSAGELENGTH

B.2.102 MESSAGEMODE

B.2.103 MESSAGES_PER_REQUEST

B.2.104 MIMEBOUNDARY

B.2.105 MMS_TEXT_CHARSET

B.2.106 MODE

B.2.107 MODEM

B.2.108 MODEM_BPS

B.2.109 MSGDELAY

B.2.110 MSGRETRYTIME

B.2.111 MTBILLING

B.2.112 NOBINARYMAPPING

B.2.113 NOUCS2MAPPING

B.2.114 NOUSERMESSAGEREFERENCE

B.2.115 OPSENTEXPIRES

B.2.116 OPS_MAXINCOMING

B.2.117 OPS_MAXOUTGOING

B.2.118 OPS_MAXOUTSTANDING

B.2.119 OPS_MAXPERSESSION

B.2.120 ORIGIN

B.2.121 PARSEMESSAGE

B.2.122 PASSWORD

B.2.123 PLUGIN

B.2.124 POLLRECEIVE

B.2.125 PREFIX

B.2.126 PRESERVESAR

B.2.127 PROMPT

B.2.128 PROTOCOL

B.2.129 QUOTEDREPLY_SEPARATOR

B.2.130 QUOTEDSUBJECT

B.2.131 REDIRECT

B.2.132 REGEXP_DESTADDR

B.2.133 REGEXP_DESTADDR_IN

B.2.134 REGEXP_KEYWORD

B.2.135 REGEXP_MESSAGE

B.2.136 REGEXP_SOURCEADDR

B.2.137 REGEXP_SOURCEADDR_IN

B.2.138 REJECT_EMPTY

B.2.139 RELATIVE_VP

B.2.140 REMOVEPREFIX

B.2.141 REMOVEPREFIX_SOURCEADDR

B.2.142 REPLACEPREFIX

B.2.143 REPLACEPREFIX_IN

B.2.144 REPLACEPREFIX_SOURCEADDR

B.2.145 REPLACEPREFIX_SOURCEADDR_IN

B.2.146 REQUIREPREFIX

B.2.147 REQUIREPREFIX_SOURCEADDR

B.2.148 RETRYSCHEME

B.2.149 RETRYTIME

B.2.150 REVDLR

B.2.151 REVDLR_IN

B.2.152 ROUTE

B.2.153 ROUTEDLR

B.2.154 ROUTING

B.2.155 SATPOOL_CREATE

B.2.156 SATPOOL_CREATE_IN

B.2.157 SATPOOL_LOOKUP

B.2.158 SATPOOL_LOOKUP_IN

B.2.159 SCAADDR

B.2.160 SCAADDRNPI

B.2.161 SCAADDRTON

B.2.162 SENDERADDRESS

B.2.163 SEPARATOR

B.2.164 SERVICETYPE

B.2.165 SIMULATE

B.2.166 SMPPTZ

B.2.167 SOURCEADDR_GSM

B.2.168 SOURCEFULLNAME

B.2.169 SSL

B.2.170 SSL_KEYFILE

B.2.171 SSL_PASSWORD

B.2.172 STATIC

B.2.173 SUBADDRESS

B.2.174 SUBJECT

B.2.175 SUPPRESS_EMGHEADERS

B.2.176 SYSTEMTYPE

B.2.177 TCPSOURCEIP

B.2.178 TCPSOURCEPORT

B.2.179 THROUGHPUT

B.2.180 TYPE

B.2.181 UDHVIAOPTIONAL

B.2.182 USEDELTIME

B.2.183 USEPRIORITY

B.2.184 USERDB

B.2.185 USERDB_FORCE

B.2.186 USERNAME

B.2.187 USERS

B.2.188 USESENDER

B.2.189 USESUBJECT

B.2.190 VASID

B.2.191 VASPID

B.2.192 VIRTUAL

B.2.193 WAITBEFORECONNECT

B.2.194 WAITDELAY

B.2.195 WAITFOR

B.2.196 WHITELIST

B.2.197 XAUTH

B.2.198 XAUTHPASSWORD

B.2.199 XAUTHUSERNAME

B.2.200 XPASSWORD

B.2.201 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.1.5.23563

F.2 EMG 3.1.4.20318

F.3 EMG 3.1.3.18957

F.4 EMG 3.1.2.18685

F.5 EMG 3.1.1.18573

F.6 EMG 3.1.0.18143

F.7 EMG 3.0.16.14262

F.8 EMG 3.0.15.12050

F.9 EMG 3.0.14.11726

F.10 EMG 3.0.13.10913

F.11 EMG 3.0.12.10307

F.12 EMG 3.0.11.9982

F.13 EMG 3.0.10.9505

F.14 EMG 3.0.9.9284

F.15 EMG 3.0.8.9115

F.16 EMG 3.0.7.8470

F.17 EMG 3.0.6.8403

F.18 EMG 3.0.5.7719

F.19 EMG 3.0.4.6983

F.20 EMG 3.0.3.6691

F.21 EMG 3.0

Table of ContentsPreviousNextIndex