MobiLink Synchronization Reference
MobiLink Synchronization Server Options
MobiLink synchronization server
dbmlsrv9 options
Sets communications protocol and parameters for MobiLink clients. These are used by the MobiLink synchronization server to listen for synchronization requests.
dbmlsrv9 -c "connection-string"
-x protocol[ ( network-parameters;... ) ]...
Specify communications protocol through which to communicate with client applications. The default is TCPIP with port 2439.
Note for UltraLite usersIf you are using an UltraLite Java application and you are using TLS security, the syntax of -x is slightly different. For details, see Using transport-layer security. |
The allowed values of protocol are as follows:
tcpip Accept connections from applications via TCP/IP.
http Accept connections via the standard Web protocol. Client applications can pick their HTTP version and the MobiLink synchronization server adjusts on a per-connection basis.
https Accept connections via a variant of HTTP that handles secure transactions. The HTTPS stream implements HTTP over SSL/TLS using RSA encryption, and is compatible with any other HTTPS server.
Optionally, you can also specify network parameters, in the form parameter=value. Separate multiple parameters with semicolons. Which parameters you specify depends on the protocol you choose.
TCP/IP parameters If you specify the tcpip protocol, you can optionally specify the following network-parameters:
client_port=nnnnn or client_port=nnnnn-mmmmm A range of client ports for communication. If only one value is specified, the end of the range is 100 greater than the initial value, for a total of 101 ports.
The option can be useful for clients inside a firewall communicating with a MobiLink synchronization server outside the firewall.
host=hostname The host name or IP number on which the MobiLink synchronization server should listen. The default value is localhost.
liveness_timeout=n The amount of time, in seconds, after a client stops communicating before MobiLink recovers the connection. A value of 0 means that there is no timeout. This option is only effective if download acknowledgement if set to off (the default). The default is 120 seconds.
port=portnumber The socket port number on which the MobiLink synchronization server should listen. The default port is 2439, which is the IANA registered port number for the MobiLink synchronization server.
security=cipher(keyword=value;...) All communication through this connection is to be encrypted using the cipher suite specified. The cipher can be one of ecc_tls or rsa_tls. These refer to elliptic-curve and RSA certification. For backwards compatibility, ecc_tls can also be specified as certicom_tls.
You can optionally specify the security keywords certificate (the certificate that is to be used for server authentication), and certificate_password. Certificate value is a file. You must use a certificate that matches the cipher suite you choose. If you do not specify a certificate, MobiLink uses a sample certificate appropriate to the cipher suite you chose.
Your installation includes a sample elliptic-curve certificate called sample.crt with password tJ1#m6+W, and a sample RSA certificate called rsaserver.crt with password test. The sample certificates are for testing and development only. They provide no security because the same certificates and passwords are distributed to all Adaptive Server Anywhere customers. New certificates are available from several companies, including Entrust Technologies and VeriSign.
Separately licensable option requiredUse of Certicom technology requires that you obtain the separately-licensable SQL Anywhere Studio security option and is subject to export regulations.For more information about security, see Transport-Layer Security. |
HTTP parameters If you specify the http protocol, you can optionally specify the following network-parameters:
client_port=nnnnn or client_port=nnnnn-mmmmm A range of client ports for communication. If only one value is specified, the end of the range is 100 greater than the initial value, for a total of 101 ports.
contd_timeout=seconds The number of seconds the MobiLink synchronization server waits to receive the next part of a partially completed synchronization before the synchronization is abandoned. You can tune this option to free MobiLink worker threads when the wait time indicates that the client will never continue the connection. The default value is 30 seconds.
host=hostname The host name or IP number on which the MobiLink synchronization server should listen. The default value is localhost.
port=portnumber The socket port number on which the MobiLink synchronization server should listen. The port number must be a decimal number that matches the port the MobiLink synchronization server is setup to monitor. The default port is 80.
security=cipher(keyword=value;...) All communication through this connection is to be encrypted using the cipher suite specified. The cipher can be one of ecc_tls or rsa_tls. These refer to elliptic-curve and RSA certification. For backwards compatibility, ecc_tls can also be specified as certicom_tls.
You can optionally specify the security keywords. certificate (the certificate that is to be used for server authentication), and certificate_password. Certificate value is a file. You must use a certificate that matches the cipher suite you choose. If you do not specify a certificate, MobiLink uses a sample certificate appropriate to the cipher suite you chose.
Your installation includes a sample elliptic-curve certificate called sample.crt with password tJ1#m6+W, and a sample RSA certificate called rsaserver.crt with password test. The sample certificates are for testing and development only. They provide no security because the same certificates and passwords are distributed to all Adaptive Server Anywhere customers. New certificates are available from several companies, including Entrust Technologies and VeriSign.
Separately licensable option requiredUse of Certicom technology requires that you obtain the separately-licensable SQL Anywhere Studio security option and is subject to export regulations.For more information about security, see Transport-Layer Security. |
unknown_timeout=seconds The number of seconds the MobiLink synchronization server waits to receive HTTP headers on a new connection before the synchronization is abandoned. You can tune this option to free MobiLink worker threads when the wait time indicates that a network failure has occurred. The default value is 30 seconds.
url_suffix=suffix The suffix to add to the URL on the first line of each HTTP request. This parameter can be used to help ensure that a particular client connects to the intended server. Values must match or synchronization will not be successful.
version=http-version The MobiLink synchronization server automatically detects the HTTP version used by a client. This parameter is a string specifying the default version of HTTP to use in case the server cannot detect the method used by the client. You have a choice of 1.0 or 1.1. The default value is 1.1.
HTTPS parameters The HTTPS communication stream uses Certicom RSA security.
Separately licensable option requiredUse of Certicom technology requires that you obtain the separately-licensable SQL Anywhere Studio security option and is subject to export regulations.For more information about security, see Transport-Layer Security. |
If you specify the https protocol, you can optionally specify the following network-parameters:
client_port=nnnnn or client_port=nnnnn-mmmmm A range of client ports for communication. If only one value is specified, the end of the range is 100 greater than the initial value, for a total of 101 ports.
contd_timeout=seconds The number of seconds the MobiLink synchronization server waits to receive the next part of a partially completed synchronization before the synchronization is abandoned. You can tune this option to free MobiLink worker threads when the wait time indicates that the client will never continue the connection. The default value is 30 seconds.
host=hostname The host name or IP number on which the MobiLink synchronization server should listen. The default value is localhost.
port=portnumber
The socket port number on which the MobiLink synchronization server should listen. The port number must be a decimal number that matches the port the MobiLink synchronization server is setup to monitor. The default port is 443.
certificate An optional parameter that specifies a certificate name. This must be an RSA certificate. If you do not specify a certificate, MobiLink uses the sample RSA certificate that is provided with Adaptive Server Anywhere. It is called rsaserver.crt and has the password test.
The sample certificates are for testing and development only. They provide no security because the same certificates and passwords are distributed to all Adaptive Server Anywhere customers. New certificates are available from several companies, including Entrust Technologies and VeriSign.
certificate_password An optional parameter that specifies a password for the certificate.
For more information about security, see Transport-Layer Security.
unknown_timeout=seconds The number of seconds the MobiLink synchronization server waits to receive HTTP headers on a new connection before the synchronization is abandoned. You can tune this option to free MobiLink worker threads when the wait time indicates that a network failure has occurred. The default value is 30 seconds.
url_suffix=suffix The suffix to add to the URL on the first line of each HTTP request. This parameter can be used to help ensure that a particular client connects to the intended server. Values must match or synchronization will not be successful.
version=http-version The MobiLink synchronization server automatically detects the HTTP version used by a client. This parameter is a string specifying the default version of HTTP to use in case the server cannot detect the method used by the client. You have a choice of 1.0 or 1.1. The default value is 1.1.