1) Do the following changes in the configData

TOKEN_UNIQUE_TWO_DIGITS=78 (any unique no.)

TOKEN_HOSTMACHINE_IP=<ip address>
TOKEN_HOSTMACHINE_NAME=<hostname>
TOKEN_ROOT_DIR=/opt/AirMessenger MMSC/latest (Directory path for msg directory)
TOKEN_DEFAULT_MMSC_IP=<ip address>
TOKEN_AE_LOG_SEVERITY=1
TOKEN_ENUM_SENDER_ENABLED=false
TOKEN_ENUM_RECIPIENT_ENABLED=false
TOKEN_GSTATE_TRANSACTIONAL_MODE=false
TOKEN_ASI_DEFAULT_SENDER_ADDRESS_STRING=16135551200
TOKEN_MM1AM_SENDERMSISDN=16135551200
TOKEN_MM1AM_DefaultFromDisplay=16135551212
TOKEN_MM1AM_DefaultBroadcastToMsisdn=16135551212
TOKEN_MMS_SYSTEM_ADDRESS=lab@REPLACEME.com
TOKEN_DEFAULT_MMSC_SYSTEM_ADDRESS=lab@REPLACEME.com
TOKEN_TRAP_MANAGER_ADDRESS=<host ip address>/162
TOKEN_MMSC_HOST=<hostname>

2)TOKEN_GSTATE_TRANSACTIONAL_MODE=false
3)TOKEN_ASI_AUTHENTICATION=false
4)To change the MMM shared memory set this param
TOKEN_SHARE_CACHE_SIZE=92160

<Required for CD623> If you want to see the full logs, then change the following
param value to 1
TOKEN_AE_LOG_SEVERITY=1 (to see all the logs)

If you want to direct the logs to syslog, change the following param
TOKEN_AE_LOG_TO_STREAM=1
TOKEN_AE_SYS_LOG_FACILITY=4 (it is the name of local4 defined in syslog.conf)

<Required for CD623> If enum address translation is required to be disabled

change the following param to false
TOKEN_ENUM_SENDER_ENABLED=false
TOKEN_ENUM_RECIPIENT_ENABLED=false

5)<Required for CD623, will be set later>If MM4AM is connected to AirMessenger

MMSC then only configure these params
TOKEN_MM4AM1_EGRESSMTAHOST=<ip address>
TOKEN_MM4AM2_EGRESSMTAPORT=<port number>
TOKEN_MM4AM3_RESPDUMTAHOST=<ip address>
TOKEN_MM4AM4_RESPDUMTAPORT=<port number>

6)To receive delivery reports set the following param value

TOKEN_ASI_DEFAULT_SENDER_ADDRESS_STRING=16135551200

To enable database set the following params, these values will go in the asi.cfg,
smd.cfg and all AMs
TOKEN_DATABASE_CLIENT_ENABLE=false (This is for DB enable)
(error in suggestion)
TOKEN_DATABASE_CLIENT_CACHE_TIMEOUT=60 (This will update after every 1
min)
7) ./install.sh
./ oamp_agent_init.sh
./pminit.sh
tail -f AirMessenger MMSC.log | ae-log-colorize.pl

8) Adding multiple instances of MM4AM

existing MM4AM should also be renamed to MM4AM1
Add a new config file for each mm4am instance, corresponding to this add n number of
smtpServer.cfg
changes in each instance config files :
a. ServerHostPort=<hostname>:<port number>
b. egressMTAPort=<port number>
c. TARAL_SERVICE_NAME=TARAL_SVC_MM4AM1
OampInstanceId=<adapter number, ie 1 for mm4am1, 2 for mm4am2, etc>
d. smtpServerConfigFile=/opt/AirMessenger
MMSC/latest/msg/config/smtpServer1.cfg
e. smtpServer.cfg : Any smtp/mm4 messages entering AirMessenger MMSC will
enter at ingress port of smtpServer, so if for each adapter instance you require a
separate ingress port, configure a new smtpServer with the different value of
ingress.
For .ex smtpServer2.cfg
SmtpServer2.cfg:ServerHostPort=<hostname>:<port number>

9) Change done in the ipcmanager.cfg

a. In the IPCqueue add the new AM sets. For ex.
IPCQ_LIST=IPCQ_ASI IPCQ_MMM IPCQ_MRE IPCQ_MM4AM1
IPCQ_MM4AM2

b. Add the entry in the IPC queue, for ex.

[IPCQ_MM4AM1]
size=5000
name=TARAL_SVC_MM4AM1 (Unique instance name)
key=TARAL_SVC_MM4AM1_78 (78 is the unique 2 digits and should not be
changed)

10) Change framework.cfg for newly added AM/instances

a. In the System Configuration section, in the Processes add the newly added AMs
Ex: Processes=GSTATE MMM SMPP_AM MM4AM1 MM4AM2 CDR ….

b. In the processes configuration section add the new AM entries

For ex.
[MM4AM1]
CommandLine=./mm4am /opt/AirMessenger
MMSC/latest/msg/config/mm4am1.cfg --dalConfig /opt/AirMessenger
MMSC/latest/msg/config/dal.cfg --cache-name MMMClientCache_22
--cache
-size 307200
MMMClientCache_22 --cache-size 9216
 c. In the Blade Configuration sections, add the AM instance names
For ex.
MM4AM1.Instance=mm4am1
MM4AM2.Instance=mm4am2

. d) Add adapterSet definitions in pa.cfg

For ex add a new set say mm4amSet2 and change the routing rules based on sender
or recipient whatever is desired.

e) Add this adapter Set in the adapterSetList, for mre to route to the newly added AM,
if the address rules match.

f). Now add the AM instances for this AM Set for ex. for mm4am instance 1
[mm4am1]
name=MM4AM1 (Unique for each instance)
description=MM4AM protocol adapter instance 1
oamComponentNumber=2
interfaceName=TARAL_SVC_MM4AM1 (This should be unique for each
AM instance)
cost=1
maxFailures=0
backoffInterval=1

g) Add this new instance in the adapterList of the adapterSet, for ex add
adapterList = mm4amSet1

11) Use a SMTP simulator to receive messages

a) To start SMTP simulator to receive messages use the script:
./smtp-sink-file –v <Host-ip>:<mm4am:egressMTAPort> 100

TO SEND MESSAGE
a)(ASI as ingress)
[gchadha@ggnard05:~/home3/]$ ./submit_one_valid_VAS_VASP_mmsc.pl
10.203.164.119 30435 ./5k_bmrk.mms //30445 is “ServerHostPort” of asi
b)(MM1 as ingress)
./mm1encoder mm1encoder.cfg
c)(MM4 as ingress)
[gchadha@ggnard05:/home3/gchadha/SMTP/smtpSim]$ ./smtp-sink -v
10.203.164.119:2506 100 //2506 is the egressMTAPort of mm4am
[gchadha@ggnard05:~/home3/SMTP/Sydney/uat_test_scripts]$ ./inject_DR
{
Vi inject_DR
./smtp-source -v -f 987654321 -t 34567890 -r 1 -X ./DR3.txt
10.203.164.119:2503 // 2503 is the smtpserverhostport, smtp server is run by
framework by default
 //DR3.txt is the mms
}
d) MM4
a) run vasp verbose: ~/home3/AutomationScripts/MM7_Scripts]$ ./vasp-server-
verbose.pl 40130 & //40130 is the port in ipcmanager.cfg representing “reportUrl” and “destUrl”
.

b) run smtp simulator which will act as mm4 sink : ~/SMTP/smtpSim]$

./smtp-sink -v 10.203.164.119:2506 100& //2506 is the mm4 egress port ”egressMTAPort” in
mm4am.cfg.

c) gchadha@ggnard05:~/SMTP/Sydney/uat_test_scripts]$ ./inject_DR // in
inject_DR the
“./smtp-source -v -f 2345678 -t 113456100 -r 1 -X ./testData/2.2.4.1.REQ.txt
10.203.164.119:2503”

/2.2.4.1.req.txt ::: is the message to be sent , it contains the parameters to enable or diable
read/delivery reports.

TO OPEN CDR
[gchadha@ggnard05:~/home3/MMSC_testing/msg/tmp/CDR]$ source
../../scripts/pminit.env
[gchadha@ggnard05:~/home3/MMSC_testing/msg/tmp/CDR]$ ../../bin/reader -d . -f
CDR_1209537000 > cdr.txt

12) Configuration of SMSC Simulator

./smsc_server -smpp-server-port 54321 -forward-wap -wap-server-host
10.203.164.119 -wap-server-port 4321 -verbose
Command to be used:
- ./smsc_server -smpp-server-port 9222 -forward-wap -wap-server-host
10.203.164.16 -wap-server-port 30221 -verbose
- here 9222 is the value of smpp_am1.cfg:[MMT]port (It is the port from
where smsc will send message)
- 10.203.164.16 is the ipaddress of the machine where SMSC simulator is
running
- 30221, is the value of handsetSimulator.cfg:ServerHostPort (At this port
handset is listening for the message from SMSC)
- This will forward the SIR on to the Handset.
 ./smsc_server -smpp-server-port 30490 -forward-wap -wap-server-host
10.203.164.119 -wap-server-port 45678 –verbose

./smsc_server -smpp-server-port 54321 -forward-wap -wap-server-host

10.203.164.119 -wap-server-port 4321 -verbose

13) Configuration of Handset Simulator

Do this before source ../../msg/scripts/pminit.env
Set proper path of error log in simulator.cfg
ErrorLogFile = ./tmp/error_log
Command to be used:
- ./handset-simulator handsetSimulator.cfg
- Change the following in the handsetSimulator.cfg
ServerHostPort = 10.203.164.16:30221 (This port same as in used by
smsc simulator)
ManagementHostPort = 10.203.164.16:30671 (to any port)
DefaultMMSCURL = http://10.203.164.16:30239/mmsc
30239, is the value of port from where handset will enquire MMSC for the
message retrieval
This port should be same in all the following files
mm1am.cfg:ServerHostPort=10.203.164.16:30239
mm1am.cfg:SirBaseUrl=http:// 10.203.164.16:30239
ipcmanager.cfg:baseSirUrl=http://10.203.164.16:30239
- If any error occurs it will be displayed along with Error code.
- If no error is generated no message will be displayed.

14) Using mm1encoder to send MM1 messages

Note: Using the mm1encoder requires having a paylod file in the same directory as the
encoder and the configuration file. A small jpeg file should be copied over to the
directory.
a. Do the following changes in the mm1encoder.cfg,
b. Change the vaspConfig.cfg as follows
i. outputMethod=NETWORK
ii. outputHost=<Host of the machine running AirMessenger>
iii. outputPort=<MM1AM server port>
iv. wrapOutputFileInHeaders=YES
v. VASP_1.VaspId = guyvasp1 (vasp defines in vasp.cfg)
vi. mmFiles=<name of jpeg file>
vii. mmTypes=image/jpeg
 viii. mmsMessageType=MESSAGE_TYPE_M_SEND_REQ
ix. mmsVersion=MMS_VERSION_10
x. subReqMmsTransactionId=<any string ie offnet_test>
xi. subReqFrom=<any MSISDN>/TYPE=PLMN
xii. subReqContentType=CT_APPLICATION_MULTIPART_MIXED
xiii. subReqDate=418439430960
xiv. subReqTo=<Sender address required by the test>/TYPE=PLMN
c. Send the message by executing the the following command from the
directory containing the executable, the configuration file, and the jpeg file;
$> ./mm1encoder mm1encoder.cfg

./submit_one_valid_VAS_VASP_mmsc.pl 10.203.164.119 30435 ./5k_bmrk.mms

./submit_one_valid_VAS_VASP_mmsc.pl 10.203.164.74 30035 ./5k_bmrk.mms