|
|
|
|
|
Wireless Data Server 2.1 | Administrator's Guide |
| View in pdf format |
| Go to User's Guide |
Configuration
This chapter describes in detail the configurable parameters controlling the operation of Wireless Data Server.
Server configuration
The administrator can control and define server behaviour using configurable parameters located in the /etc/config/wds.ini file. These parameters should be reviewed and tuned on a per installation basis. In addition, certain parameters in the /users/unison/misc/unison.ini must be modified. Consult the product Readme file for details.
The stated default values are not necessarily the optimal settings for your installation. It is strongly recommended that for reference purposes you keep a copy, in either printed or electronic format, of this file before modification.
NOTE:When a parameter is not supplied, the default value is automatically assumed.
Configuration parameters
The following table lists all parameters by section. The sections, as well as the individual parameters within each section, are listed in alphabetical order. Use this table to look up a parameter, get a brief description of what it does, and determine what page it is on.
The following parameter descriptions are divided into common and installation-specific sections.
NOTE:All section names enclosed in angle-brackets are variables. They should be changed according to the setup of your system. For example, the section referred to throughout this text as [<UNISON>] could have any name. Similarly, the [<DCE>] or [<SMPP>] sections should be renamed according to your preference.
For each section, choose a name descriptive of the connection it configures. For example, to set up connections to node 144 and 145 of a calendar server named "Scribe", you would have two [<UNISON>] sections, perhaps titled [SCRIBE_144] and [SCRIBE_145] respectively. Whatever names you choose, however, be sure to specify them using the [WDS] smscconnection and unisonconnections parameters.
Common ParametersThe following parameters, in the [LIC], [WDS] and [<UNISON>] sections, apply to all installations of Wireless Data Server, regardless of the plug-in used to connect to the wireless network.
Product license
Section
Parameter
Description
Your confidential license key, provided by your Steltor representative. Do not change the value of this parameter without explicit instructions from technical support personnel.
Accepted values
Default value
Blocked MSISDN numbers
Section
Parameter
Description
A list of MSISDN numbers to which Wireless Data Server will not send SMS messages.
Accepted values
A list of valid MSISDN numbers, separated by commas and enclosed in {}. For example:
Please note: this list should always contain the MSISDN numbers of all Wireless Data Server gateways to avoid the possibility of a circular loop.
Default value
Debug mode
Section
Parameter
Description
Logs input/output data in wds.log.
Accepted values
Default value
Message reference number
Section
Parameter
Description
A reference number for the transmission of request, notification and system messages. Wireless Data Server increments this value automatically. Do not change the value of this parameter without explicit instructions from technical support personnel.
Accepted values
Default value
Narrowband Socket datagram reference number
Section
Parameter
Description
A reference number for the transmission of Narrowband Socket datagrams. Wireless Data Server increments this value automatically. Do not change the value of this parameter without explicit instructions from technical support personnel.
Accepted values
Default value
Transaction reference number
Section
Parameter
Description
A reference number for Wireless Data Server transactions. Wireless Data Server increments this value automatically. Do not change the value of this parameter without explicit instructions from technical support personnel.
Accepted values
Default value
Transaction log buffering
Section
Parameter
Description
Determines whether or not to buffer transactions in memory before writing them to the transaction log in order to improve performance. See also [WDS] translogbuffersize.
Accepted values
FALSE (write transactions directly to the log)
Default value
Transaction log buffer size
Section
Parameter
Description
Determines the number of transactions Wireless Data Server will buffer before recording them in the transaction log. See also [WDS] translogbuffersize.
Accepted values
Default value
Wireless Data Server port
Section
Parameter
Description
Specifies the port used by Wireless Data Server.
Accepted values
Default value
Character set used by the SMSC connection
Section
Parameter
Description
Specifies the character set used by the SMSC connection. Please see the readme file provided with your installation for instructions on setting this parameter.
Accepted values
Default value
Section name(s) of all SMSC connections
Section
Parameter
Description
A list of section names for all SMSC connections configured in wds.ini.
Accepted values
A list of strings, enclosed in curly braces and separated by commas. For example:
Default value
SMSC plug-in
Section
Parameter
Description
Specifies the plug-in for Wireless Data Server to use to connect to the SMS Centre. Set this parameter according to your installation type, as instructed in the Readme.
Accepted values
/wds/bin/smscdce.dll (for DCE connections only)
/wds/bin/smsccgw.dll (for SONERA-CGW connections only)
/wds/bin/smscsmpp.dll (for SMPP connections only)
/wds/bin/smscucp.dll (for UCP connections only)
Default value
SMTP message storage directory
Section
Parameter
Description
The subdirectory in which Wireless Data Server stores incoming SMTP messages. The specified directory will be created within Wireless Data Server's db directory (e.g. /wds/db).
Accepted values
Default value
. (db directory itself, e.g. /wds/db)
Minimum vCalendar summary size
Section
Parameter
Description
Specifies the minimum size for the vCalendar SUMMARY property (Nokia 61xx only). Do not change the value of this parameter without explicit instructions from technical support personnel.
Accepted values
Default value
Trace mode
Section
Parameter
Description
Prints every function call Wireless Data Server makes to wds.log.
Accepted values
Default value
Cache size
Section
Parameter
Description
Specifies the maximum number of users for whom to store information in memory.
Accepted values
Default value
Section name(s) of all calendar server connections
Section
Parameter
Description
A list of section names for all calendar server connections configured in wds.ini.
Accepted values
A list of strings, enclosed in curly braces and separated by commas. For example:
Default value
Repeat symbol
Section
Parameter
Description
Allows the use of the repeat symbol ("R") to designate repeating events, instead of sending multiple SMS messages. The value of this parameter only affects phones set to receive events as vCalendar objects. Text messages will always use the repeat symbol.
Accepted values
FALSE (Repeat symbol disabled)
Default value
Incoming request storage directory
Section
Parameter
Description
The subdirectory in which Wireless Data Server stores incoming messages from the SMS Centre. The specified directory will be created within Wireless Data Server's db directory (e.g. /wds/db).
Accepted values
Default value
. (db directory itself, e.g. /wds/db)
Expiry time limit
Section
Parameter
Description
Specifies the length of time in hours before unprocessed wireless requests expire.
Accepted values
Default value
Accept and decline new meetings
Section
Parameter
Description
Specifies whether or not users can accept and decline new meetings by replying to notification messages. See the Wireless Data Server User's Guide for more details.
Accepted values
TRUE (Users can accept or decline)
FALSE (No option to accept or decline)
Default value
Calendar server host name
Section
Parameter
Description
The name of the calendar server's host.
Accepted values
Default value
Calendar server node-ID
Section
Parameter
Description
A node-ID on the calendar server specified by the [<UNISON>] host parameter.
Accepted values
Default value
Calendar server SysOp password
Section
Parameter
Description
Encrypted SysOp password for the calendar server node specified by the node parameter in this [<UNISON>] section. Run cspasswd.exe to set this parameter for each [<UNISON>] section in wds.ini. For more information on using cspasswd.exe, consult the Readme file provided to you with Wireless Data Server.
Accepted values
Alphanumeric string. For example:
Default value
Default value
Installation-specific parametersThis section describes the parameters used in the [<DCE>], [<SONERA-CGW>] and [<SMPP>] sections. Please see A word about section names.
Debug mode
Section
Parameter
Description
Logs input/output data in wds.log and/or the file specified by the [<DCE>] logfile parameter. Supercedes the [WDS] debug parameter for the connection configured in this [<DCE>] section.
Accepted values
Default value
Error logging
Section
Parameter
Description
Forces the logging of all errors to wds.log and/or the file specified by the [<DCE>] logfile parameter. Unexpected errors are always logged, regardless of this parameter.
Accepted values
Default value
Log file name
Section
Parameter
Description
Specifies a file for log messages concerning only the connection between Wireless Data Server and GSM modem. Wireless Data Server will still print its internal log messages to wds.log.
Accepted values
Please note: Wireless Data Server will preface your filename with the default path of its log directory (/wds/log/).
Default value
If this parameter is left blank, Wireless Data Server will print all log messages to wds.log.
DCE serial port
Section
Parameter
Description
Specifies the serial port to which the DCE is connected.
Accepted values
Default value
DCE SMS mode
Section
Parameter
Description
Specifies whether the DCE uses text or Protocol Data Unit (PDU) mode.
Note: If you set the value of this parameter to 1, you must set the value of the [WDS] smsccharset parameter to MSCP437. In this case, users with Nokia 71xx phones will not be able to create events using calendar notes.
Accepted values
Default value
Wireless Data Server's MSISDN number
Section
Parameter
Description
Wireless Data Server's MSISDN number.
Accepted values
Default value
SMSC MSISDN
Section
Parameter
Description
Specifies the MSISDN number of the SMS Centre.
Accepted values
Default value
DCE connection data rate
Section
Parameter
Description
Specifies the data rate of transmissions to and from the DCE in bits per second (bps).
Accepted values
Default value
Stats mode
Section
Parameter
Description
Prints statistics concerning connection time and other information to wds.log and/or the file specified by the [<DCE>] logfile parameter. Supercedes the [WDS] stats parameter for the connection configured in this [<DCE>] section.
Accepted values
Default value
Trace mode
Section
Parameter
Description
Prints every function call Wireless Data Server makes to wds.log and/or the file specified by the [<DCE>] logfile parameter. Supercedes the [WDS] trace parameter for the connection configured in this [<DCE>] section.
Accepted values
Default value
ENQUIRE_LINK operation
Section
Parameter
Description
Enables and disables ENQUIRE_LINK operations from Wireless Data Server to SMS Centre.
Accepted values
Default value
Interval between ENQUIRE_LINK operations
Section
Parameter
Description
Time interval between successive ENQUIRE_LINK operations from Wireless Data Server to SMS Centre, in seconds.
Accepted values
Default value
SMSC IP address
Section
Parameter
Description
The IP address of the SMS Centre.
Accepted values
Any correctly-formatted IP address. For example:
Default value
Wireless Data Server's MSISDN number
Section
Parameter
Description
Wireless Data Server's MSISDN number.
Accepted values
Default value
MSISDN numbering plan indicator
Section
Parameter
Description
A number indicating Wireless Data Server's MSISDN numbering plan. For more information, please see GSM 03.40, 9.1.2.5.
Accepted values
An integer between 0 and 15 inclusive.
Default value
MSISDN number type
Section
Parameter
Description
Wireless Data Server's type of MSISDN number. For more information, please see GSM 03.40, 9.1.2.5.
Accepted values
An integer between 0 and 7 inclusive.
Default value
Password
Section
Parameter
Description
Wireless Data Server's encrypted password. Please see the Readme file for instructions on using cspasswd.exe to set the value of this parameter.
Accepted values
Alphanumeric string. For example:
Default value
SMSC port number
Section
Parameter
Description
The port number of the SMS Centre.
Accepted values
Default value
System ID
Section
Parameter
Description
Wireless Data Server's system identifier.
Accepted values
Default value
System type
Section
Parameter
Description
Wireless Data Server's system type.
Accepted values
Any valid system type, or none.
Default value
Committed burst size
Section
Parameter
Description
The number of messages allowed by the SMS Centre in the time interval specified by the [<SMPP>] throttle_timeinterval parameter.
Please note: configure only two of the three throttle parameters (throttle_timeinterval, throttle_smsmsgburst, and throttle_smsmsgrate). The third will be determined according to the following equation:
timeinterval = smsmsgburst / smsmsgrate
Accepted values
Default value
Committed information rate
Section
Parameter
Description
The number of messages allowed by the SMS Centre over a given period of time. Specify the number of messages and time interval using the [<SMPP>] throttle_smsmsgburst and throttle_timeinterval parameters.
Please note: configure only two of the three throttle parameters (throttle_timeinterval, throttle_smsmsgburst, and throttle_smsmsgrate). The third will be determined according to the following equation:
timeinterval = smsmsgburst / smsmsgrate
Accepted values
Default value
Committed rate measurement interval
Section
Parameter
Description
The span of time during which a number of SMS messages specified by the [<SMPP>] throttle_smsmsgburst parameter may be sent to the SMS Centre.
Please note: configure only two of the three throttle parameters (throttle_timeinterval, throttle_smsmsgburst, and throttle_smsmsgrate). The third will be determined according to the following equation:
timeinterval = smsmsgburst / smsmsgrate
Accepted values
Default value
SMSC address
Section
Parameter
Description
The network address of the SMSC.
Accepted values
Any valid IP address or host name.
Default value
SMSC port number
Section
Parameter
Description
The port number of the SMS Centre.
Accepted values
Default value
Local WDS host address
Section
Parameter
Description
The network address of the WDS.
Accepted values
Any valid IP address or host name.
Default value
Location of UCP configuration file
Section
Parameter
Description
The location of the file containing the following UCP configuration information:
- [NAF]
- networks TCP/IP
If no such file exists on your system, this information may also be kept in the wds.ini file. In that case, set the value of the confile parameter to the path and filename of wds.ini (e.g. C:\wds\config\wds.ini).