Connecting to the wireless network

---

As shown in Chapter 1, "Architecture," Wireless Data Server can connect to the wireless network through one of three plug-ins, each of which has its own specific configuration requirements.

• Setting up wireless services
  • General configuration
  • Configuring DCE connections
  • Configuring SMPP connections
  • Configuring UCP connections
• Other considerations

---

Setting up wireless services

Regardless of what plug-in you use to connect to the wireless network, you will have to provide Wireless Data Server with general information about each connection you set up.

General configuration

Each connection is configured inside its own section of the /etc/config/wds.ini file. These sections may have any name, but it is suggested that you name each section according to the connection it configures. For example, two sections connecting to DCEs on ports COM1 and COM2 could be named [DCE_COM1] and [DCE_COM2] respectively. For more information on the specific configuration of each connection, see the appropriate section below.

NOTE:

You may configure as many sections as you need on one instance of Wireless Data Server, but all connections must use the same plug-in to connect to the wireless network. If you require two different kinds of connections simultaneously (DCE and SMPP, for example), you must run two instances of Wireless Data Server, each with a single connection type.

You must include the names of these sections in the value of the wds.ini [WDS] smscconnections parameter in order to tell Wireless Data Server to initiate the connections on startup.

In addition, you need to specify what type of connections these are, and therefore what plug-in Wireless Data Server should load, by setting the [WDS] smscplugin parameter. For DCE connections, use the smscdce library; for SMPP connections, use the smscsmpp library; for UCP connections use the smscucp library. The library name must be preceded by the path to your Wireless Data Server's /bin directory, and on UNIX platforms the string lib, and terminated with the platform-specific file extension (.dll for Windows, .sl for UNIX). For example, /wds/bin/libsmscdce.sl.

Finally, specify the character set used for all SMSC connections through the [WDS] smsccharset parameter. If you do not know the correct character set to use, consult Appendix A, "Server parameters." for suggested values.

Configuring DCE connections

In addition to the general parameters described above, you must configure a number of parameters in each section of wds.ini that configures a DCE connection.

Wireless Data Server MSISDN

Set the MSISDN number of the modem using the [<DCE>] msisdn parameter.

SMSC MSISDN

Set the MSISDN number of the SMSC using the [<DCE>] smscmsisdn parameter.

DCE port

Set the port to which the DCE is attached using the [<DCE>] port parameter.

DCE speed

Set the speed of the DCE using the [<DCE>] speed parameter. Make sure that the value of this parameter is the same as the value set on the modem itself. For instructions on configuring your DCE, see the documentation supplied by your hardware vendor.

Configuring SMPP connections

In addition to the general parameters described above, you must configure a number of parameters in each section of wds.ini that configures an SMPP connection.

Wireless Data Server MSISDN number, plan indicator and type

Set the MSISDN number of Wireless Data Server using the [<SMPP>] msisdn parameter. Also use the [<SMPP>] msisdnnpi and msisdnton parameters to set the numbering plan indicator and number type for Wireless Data Server's MSISDN number, according to GSM 03.40, section 9.1.2.5.

SMSC address and port

Set the IP address and port of the SMSC using the [<SMPP>] host and port parameters respectively.

Wireless Data Server system information

Set the system ID and type for Wireless Data Server using the [<SMPP>] systemid and systemtype parameters.

ENQUIRE_LINK operation

Enable ENQUIRE_LINK operations between Wireless Data Server and SMSC using the [<SMPP>] enquirelink parameter. Use the [<SMPP>] enquirelink_timeinterval parameter to set the time interval between ENQUIRE_LINK operations.

Throttle parameters

Set the number of messages per unit time allowed by the SMSC using the set of throttle parameters: [<SMPP>] throttle_smsmsgburst, throttle_timeinterval and throttle_smsmsgrate. Set a time interval using the throttle_timeinterval parameter, and set the number of messages allowed in that interval using the throttle_smsmsgburst parameter. Wireless Data Server will use these values to determine a value for throttle_smsmsgrate on its own. Do not set the throttle_smsmsgrate parameter on your own.

Configuring UCP connections

In addition to the general parameters described above, you must configure a number of parameters in each section of wds.ini that configures a UCP connection.

Wireless Data Server address, MSISDN number and number type

Set the network address or IP address of Wireless Data Server using the [<UCP>] localhost parameter. Set Wireless Data Server's MSISDN number and its type using the [<UCP>] msisdn and msisdntoa parameters. Only change the given value of the msisdntoa parameter if your Wireless Data Server's MSISDN number is alphanumeric in nature, as opposed to a standard MSISDN number (e.g. +15147338500).

SMSC address and port

Set the IP address and port of the SMSC using the [<UCP>] host and port parameters respectively.

UCP network configuration file

If you have a file containing the following UCP network configuration information:

[NAF]

networks TCP/IP

use the [<UCP>] confile parameter to specify its location. If you do not have a file with this information already, include these lines in wds.ini and set the value of the confile parameter to the location of wds.ini.

Throttle parameters

Set the number of messages per unit time allowed by the SMSC using the set of throttle parameters: [<UCP>] throttle_smsmsgburst, throttle_timeinterval and throttle_smsmsgrate. Set a time interval using the throttle_timeinterval parameter, and set the number of messages allowed in that interval using the throttle_smsmsgburst parameter. Wireless Data Server will use these values to determine a value for throttle_smsmsgrate on its own. Do not set the throttle_smsmsgrate parameter on your own.

---

Other considerations

Blocked MSISDN numbers

Use the wds.ini [WDS] blockedmsisdns parameter to specify phone numbers to which Wireless Data Server will not send wireless messages under any circumstance. Always set the value of this parameter to include at a minimum all MSISDN numbers used by Wireless Data Server itself, to avoid the possibility of a circular loop.

Copyright information