Options

<< Click to Display Table of Contents >>

Navigation:  Reference >

Options

Administrator


Set the full name and/or password for the administrator (admin) account. The admin account is used in the  web application and the HTTP API of the Web Connector.

 

Options_Administrator

 

If you want to prevent unauthorized access to the Diafaan SMS Server console program you can check the option to ask for the administrator password when a the console program is started.

 

 

Localization


 

In the localization settings the date and time format that is used in Diafaan SMS Server can be changed. The Date and time format is used in all situations where the date and time is used in combination. The Date format and Time format values are used for date only and time only fields.

 

Options_Localization

 

 

Email alerts


 

Options_EmailAlerts

Log error events to email

Check this option if you want to receive an email alert if an error is added to the event log. To prevent an avalanche of email messages after repeated errors are generated, the number of emails can be limited to one email in a predefined time span.

 

 

Options_EmailAlerts2

Event log filter

In the Email Message Template the email fields for the alert email can be changed and a filter can be set to limit the events for which an email alert is sent. The Event(s) field filters on the event text and the Source(s) field filters on the name of the gateway or connector. Both fields can contain multiple filters with wildcards (separated by semicolons) and it is possible to use a regular expression when the field starts with the keyword regex: (when a match is found) or -regex: (when no match is found).

 

Examples for the Event(s) field

 

Allow events that contain the text "Timeout" (wildcard filters are case insensitive):

*timeout*

 

Allow events that contain the text "Timeout" or "Reset":

*timeout*;*reset*

 

Allow events that do not contain the text "Timeout" or "Reset":

-*timeout*;*reset*

 

Allow events that start with the text "Reset" using a regular expression (regex filters are case sensitive):

regex:^Reset.*

 

 

HTTP callbacks


Only available in Diafaan SMS Server - basic and full editions.

See Use HTTP callbacks for the HTTP specifications

 

Options_HTTP_Callbacks

Enable HTTP callbacks

Check this option to enable HTTP callbacks in Diafaan SMS Server. This setting enables all HTTP callbacks for individual messages and events and also enables user authentication callbacks when the connector supports it.

 

Callback method (using HTTP server)

Use the full HTTP client only when the HTTP callbacks don't work with the minimal HTTP client. The minimal HTTP client is much faster but lacks advanced features like automatic proxy server detection and may not be compatible with all web servers.

 

Web page

Set the full URI of the web page that handles the HTTP callback request.

 

Callback method (using local CGI application)

Instead of sending an HTTP call to an HTTP server, Diafaan SMS Server can also use a local installation of a CGI application, for instance the PHP program php-cgi.exe. Instead of sending the callback request to a web server, this option lets you process the callback on the local server. This option was tested with the CGI applications PHP (php-cgi.exe), Perl (perl.exe), Ruby (ruby.exe) and Python (python.exe). php-cgi.exe is part of the PHP installation package for Windows.

 

CGI application

Select the .exe CGI application on your local server.

 

Script file

Provide the full path and file name of the local script that handles the HTTP callback request.

 

Callback method (using local php-cgi.exe FastCGI application)

PHP and some other CGI applications can also be used in a FastCGI mode where TCP/IP is used for the CGI communication instead of the relatively slow process communication of normal CGI. For reliable PHP scripts, FastCGI is always better than normal CGI. But if the PHP script has memory leaks or might otherwise be occasionally unresponsive, it is better to use normal CGI.

 

CGI application

Select the .exe CGI application on your local server.

 

Script file

Provide the full path and file name of the local script that handles the HTTP callback request.

 

FastCGI port

The TCP/IP port number that the FastCGI program uses for the communication with Diafaan SMS Server.

 

HTTP method

Select the POST or GET HTTP method depending on the expectations in the script.

 

Timeout

Timeout (in seconds) for the HTTP calls, increase this value if the HTTP server does not always handle the HTTP request in time.

 

Message out

Use an HTTP callback for each outgoing message before it is added to the message queue.

 

Message in

Use an HTTP callback for each received message before it is added to the message queue.

 

Message log

Use an HTTP callback for each message result and message result update or delivery report.

 

Event log items

Use an HTTP callback for all event log items.

 

 

Logging


 

Options_Logging

 

Log database maintenance

If the Limit to option is selected the number of log items in the Send Log, Receive Log and Event Log is limited to a fixed number of records. If the internal log database, and specifically the send log table, is getting too large, updating and viewing the logs will get gradually slower and a fixed log limit helps to prevent this.

 

An alternative to a fixed log length is to periodically remove older items from the database. If the remove log items option is checked, the oldest items are cleared from the database once a day. If you send tens of thousands of messages a day and are not very interested in the log, the time period can be set on 7 days or less. If you do not send large amounts of messages a day, the time period can be set to 6 months or one year.

You can make a backup copy of the removed records by checking the save removed items option.

 

 

Advanced


 

Options_Advanced

 

Resend wait time

If the message failed, wait x seconds before it is send again.

 

Post an error

Trigger an error in the event log when the message queue exceeds a specific number of messages.

 

Re-assign gateways

Check this option if you want to re-assign the (possible) gateways to all messages in the send queue after each configuration change. If the option is not enabled then the new gateway configuration will only be applied to new messages.

 

If there are a large number of messages in the send queue it may take a long time to assign the new gateway list to each message after each time the gateway- or connector properties are changed. It is advised to use this option only for situations where the number of messages in the send queue is limited.

 

Gateway unavailability timeout

Set the timeout, in minutes, when a gateway that is (temporarily) down is considered to be permanently unavailable. When the gateway is unavailable, messages that are routed through this gateway are flagged as failed. When the gateway is down but not yet unavailable, the pending messages are kept in the send queue until the gateway is working again.

 

Log to SQL connector

Send the log records and updates (delivery confirmation) of all messages in Diafaan SMS Server to a specific SQL connector.

 

Combine received message parts from different gateways

When there are multiple SMPP Gateways connected to the same SMPP server and the same account, there is a chance that multiple received messages parts for the same message are received with different SMPP Gateways. By default the message parts are only combined when they are received in the same SMPP Gateway. If this option is enabled, message parts from different SMPP Gateways are also combined to the original message length.

 

To improve the handling speed of received multiple message parts from different SMPP Gateways you can set the MessageInHandling property in the intended SMPP Gateways to SingleMessageParts.

 

Gateway batch message timeout

Set the timeout, in minutes, to re-send a message when it is pre-loaded in one of the gateways. This is a security measure for when a message is 'stuck' for too long in a gateway. The default value is 15 minutes When this message timeout is set too low it might result in duplicated messages, if it is set too high it might lead to a long send delay when one of the gateways malfunctions.

 

SSL protocols (for HTTPS)

List of negotiable SSL/TLS protocols for secure connections to and from HTTPS servers. This setting is not used for other connections, like connections to and from SMPP servers.