Nokia WAP and SMS gateway Deﬁnes what kind of action, For this value are, Is the mst accurate

Page 43

		Chapter 5. Setting up a SMS Gateway
Variable	Value	Description
		Deﬁnes what kind of action
		should be taken if the the ack of
		a message expires. The options
		for this value are: 0x00 -
		disconnect/reconnect, (default)
		0x01 - as is now, requeue, but
		this could potentially result in the
		msg arriving twice 0x02 - just
		carry on waiting (given that the
		wait-ack should never expire this
wait-ack-expire	number	is the mst accurate)
		This SMSC can support two
		types of ﬂow control. The ﬁrst
		type of ﬂow control is a
		stop-and-wait protocol, when
		this parameter equals to ’1’.
		During the handling of
		commands, no other commands
		shall be sent before the a
		response is received. Any
		command that is sent before the
		reception of the response will be
		discarded. The second type of
		ﬂow control is windowing,
		when this parameter is unset or
		equals ’0’. In this case a
		maximum of n commands can be
		sent before a response is
flow-control	number	received.
		When using flow-control=0,
		emi works in windowed ﬂow
		control mode. This variable
		deﬁnes the size of the window
		used to send messages. (optional,
window	number (messages)	defaults to the maximum - 100)
		If SMSC requires that kannel
		limits the number of messages
		per second, use this variable.
throughput	number (messages/sec)	(optional)
		Assuming that kannel is well
		conﬁgured and we had one
		sucessful connection, if retry is
		true, kannel will always retry the
		connection even if some related
retry	boolean	error ocur.

36

Image 43

Contents Andreas Fink Open Source WAP and SMS gatewayLars Wirzenius Kalle MarjolaStipe Tolj Bruno RodriguesAarno Syvänen Kannel 1.3.1 User’s Guide Open Source WAP and SMS gateway Table of Contents Extended headers Kannel Post XML Post Fake messages Fakesmsc command line options Vii List of TablesOverview of WAP IntroductionOverview of WAP Push Overview of SMS This section needs to be written FeaturesRequirements IntroductionPage Getting the source code Installing the gatewayFinding the documentation Compiling the gateway Using pre-compiled binary packages Installing the gatewayInstalling Kannel from RPM packages Removing Kannel Log in as root Remove the RPM package Installing the gateway Installing Kannel from DEB packagesRemove the package completely Installing the gateway Install or upgrade the DEB packageIf you don’t want Kannel to run as a daemon, run Page Conﬁguring the gateway Using the gatewayConﬁguration ﬁle syntax Inclusion of conﬁguration ﬁles Variable Value Description Core conﬁgurationIP-listseveral addresses, separated with With admin-port, this can beLower network layer. Defaults Bool Layer. Defaults to noIP or ’*’ VariableValueﬁlename Receiving SMS messages from String to unify received phoneNumbers, for Smsc routing Handle them properly. This isOnly, i.e. for the administration Using this variable, no SMSﬁlename Down violently Enable the use of an Http SMS service requests toWorking as a Https client. If Type Default this is set to ’internal’When Kannel message queues Kannel is willing to trust whenAfter the bearer box, you can start the WAP box Command line optionsRunning Kannel Starting the gatewayKannel statuses Using the gateway Set debug-places for ’debug’ level outputHttp administration No other chance to resume normal operation Bring down the gateway, by setting state toSpace. Password required Shutdown a single Smsc link. PasswordWAP gateway conﬁguration Setting up a WAP gatewayWapbox conﬁguration Left side URL to the given Default gives you 10 mappingsMap-url setting. Thus, Adds a single mapping forChecking whether the WAP gateway is alive Running WAP gatewaySMS centers Setting up a SMS GatewayRequired components SMS gateway conﬁgurationAn optional name or id for Problems, so avoid it and anySpecify the used SMS-service See below for a complete listSemicolon ’’. For example Which are accepted to be sentThrough this SMSC. Multiple Entries are separated withNokia Cimd 1.37 Machine that runs the Smsc Setting up a SMS GatewayValue. Set it to 0 to disable this Feature This preﬁx from the sender All messages sent from Kannel. If Kannel is asked to Send a message, it will removeOr hostname Connecting over a modem to anDefaults to send. All outgoing ServiceIf set, only connections from Keepalive command will beFeature. Requires username or More than this time. Defaults toError ocur Disconnect/reconnect, defaultWhen this parameter is unset or Defaults to the maximumSmpp Attempt to use a Transceiver modeUse value 0 to disable this I/O Password matchingChange the interface version Default if not set isNot deﬁned the default device That no more than 10 defaultVariableValue Sema Group SMS2000 OIS 4.0 SM/ASI for CriticalPath InVoke SMS Center GSM modem Modem Type Modems Too Default value 0 means to try toNokia 6210, 7110, 8210 tested Probably other Nokia phonesOptional phone number Using the ’message-storage’To work with this setting are For this many seconds. IfCommand, enable this String to use when trying toOptional. Defaults to false Before ﬁrst commandFake Smsc HTTP-based relay and content gateways Sema Ois At2 Http Using multiple SMS centersFeature checklist FeaturecimdCan send octet data without UDH Smsc driver internal featuresCan set Validity Can set Deferred Can set PID Can set RPI Can send 8 bits Correctly send GSM alphabetSmsbox conﬁguration Symbol MeaningBearerbox for the purpose Smsbox Group VariablesOptional smsbox instance An smsbox connected to anSendsms-charsstring Global-sender Non-zero value Typical ’smsbox’ group could be something like thisApply Smsbox routing inside bearerboxDeﬁnes for which smsbox Instance the routing rules doSMS-service conﬁgurations Word in the SMS message Services are identiﬁed byWord Message contains If the service has aliases, they URL corresponds to oneService. b Multiple entries are You use this sms-service typeUse these kind of services is Checked using white/black-listCertain shortcut numbers to be Service. This may be used toAllowed to this service Allow only inbound SMS toNormally Content-Type for reply, it isUsed for url type services, If client does not setﬁle Black-list service is deﬁnedSee notes of phone number Format from numhash.h headerHow sms-service interprets the Http response SMSPush equivalent Kannel Header Extended headersHex format Kannel PostXML Post Parameter escape code Kannel Header EquivalentSetting up a SMS Gateway SendSMS-user conﬁgurations Some sample ’sendsms-user’ groups LibSDB DLR storage External delivery report DLR storageInternal DLR storage MySQL DLR storageDLR database ﬁeld conﬁguration Table ﬁeld that is used for the timestamp data VariableSample ’dlr-db’ group Over-The-Air conﬁgurations MySQL connection conﬁgurationDefaults to data Ota-setting. Any string isFor your WAP services, i.e Description of the serviceOta-bookmark. Any string is Setting up more complex servicesA ’sendsms-user’ to use with it. With concatenation enabled 14. OTA Bookmark Group VariablesSetting up multi-operator Kannel Setting up operator speciﬁc servicesRedirected replies ’Authorization failed’ reply Using the Http interface to send SMS messagesRunning SMS gateway Phone number of the sender Content can be more thanBits or to UCS2. Defaults to ReturnedIndicator, or 5,6,7,8 for Default-smscvariable canIndicator bits in DCS ﬁeld. If Indicator. The accepted valuesInform SMS Center that it should Conﬁguration, or 0X per defaultIndicator RPI value. See Etsi Optional. If given, kannel willGET method for the OTA Http interface Using the Http interface to send OTA conﬁguration messagesBookmark document looks like this Conﬁguration, or ’Authorization Name or ID of the ’ota-setting’Not given the ﬁrst ’ota-setting’ When a XML document isSMS&WAP gateway conﬁguration Setting up a SMS&WAP gatewayRunning SMS&WAP gateway Mandatory value. Tells that we Setting up Push Proxy GatewayConﬁguring ppg core group, for push initiator PI interface PPG core group conﬁguration variablesConﬁguring PPG user group variables String Username for this user String Password for this userWap-push-user String An userFinishing ppg conﬁguration Running a push proxy gateway An example using Http SmscSetting up Push Proxy Gateway You can, of course, use more complex command line optionsDefault network and bearer used by push proxy gateway Using SSL client support Using SSL for HttpUsing SSL server support for PPG Https interface Using SSL server support for the sendsms Http interfaceUsing SSL for Http Delivery Reports Getting help and reporting bugs Appendix A. Using the fake WAP sender Setting up fakesmsc Appendix B. Using the fake SMS centerRunning Kannel with fakesmsc connections Switch Value Description Fakesmsc command line optionsFake messages Send a maximum of max Creating push content and control document for testing Starting necessary programs Default any. Application Table C-1. Testppg’s command line optionsUse content qualiﬁer string Instead of default si serviceTesting PAP protocol over Https Using Nokia Toolkit as a part of a developing environment101 Directive Value Description String User’s username Mandatory value. PPG service ﬁlename Document Mandatory value. PPG serviceString User’s password 103 104 Appendix D. Setting up a dial-up lineAnalog modem Add the following lines to /etc/ppp/options.serverConﬁgure your phone this example is for Nokia Isdn terminalThis section needs to be written 105 Appendix E. Log ﬁles Bearerbox Access LogLog rotation 107 Appendix E. Log ﬁlesMClass GlossaryCoding RFC 2616 Hypertext Transfer Protocol -- HTTP/1.1 Society 109 Bibliography