Connect to MobiLink Server window

This window lets you connect to a running MobiLink server. A MobiLink Monitor connection is like a synchronization connection to the MobiLink server in that most of the parameters are the same. You must use parameters that are compatible with the MobiLink server's settings. For all MobiLink Monitor sessions, the script version is set to for_MLMonitor_only.

This window has the following components:

User   Type the name of the MobiLink user for the connection. If you started the MobiLink server with -zu+, then it doesn't matter what user ID you supply.

Password   Type a password for the connection. This must be the correct password for the MobiLink user you specify. Leave this field blank if the MobiLink user does not have a password.

Host   The network name or IP address of the computer on which the MobiLink server is running. By default, it is the computer where the MobiLink Monitor is running. You can use localhost if the MobiLink server is running on the same computer as the MobiLink Monitor.

Protocol   Select the communications stream protocol to be used for the connection. This protocol and port should be set to the same protocol and port as the MobiLink server is using for synchronization requests.

  • HTTP   Select this option to connect via HTTP. By default, HTTP version 1.1 is used.

    • Port   The MobiLink server communicates over a specific port. By default, the port number is 80 for HTTP. If you choose a value other than this, you must configure your MobiLink server to listen on the port you specify.

  • HTTPS   Select this option to connect via HTTPS.

    • Port   The MobiLink server communicates over a specific port. By default, the port number is 443 for HTTPS. If you choose a value other than this, you must configure your MobiLink server to listen on the port you specify.

    • Encryption   Choose the same type of encryption that the MobiLink server is using. By default, the HTTPS communication stream uses RSA security.

      The following options are supported for encryption:

      • ECC   Elliptic-curve cryptography (ECC) requires a separate license.

      • RSA   RSA encryption is provided free with SQL Anywhere.

      • RSA (FIPS 140-2 certified)   Federal Information Processing Standard (FIPS) 140-2 specifies requirements for security algorithms. FIPS 140-2 is granted by the American and Canadian governments through the National Institute of Standards and Testing (NIST) and the Canadian Communications Security Establishment (CSE). FIPS technology requires a separate license.

    To use HTTPS, you must have MobiLink client-side data stream encryption installed on the computer running the MobiLink Monitor. The MobiLink Monitor trusts all certificates, so when you use HTTPS, you do not specify any certificate-related parameters in the Additional Protocol Options field.

    Separately licensed component required

    ECC encryption and FIPS-certified encryption require a separate license. All strong encryption technologies are subject to export regulations.

    See Separately licensed components.

    For more information about security, see Encrypting MobiLink client/server communications.

  • TCP/IP   Select this option to connect via TCP/IP.

    • Port   The MobiLink server communicates over a specific port. By default, the port number is 2439 for TCP/IP. If you choose a value other than this, you must configure your MobiLink server to listen on the port you specify.

  • TLS (TCP/IP with transport layer security)   Select this option to connect via TCP/IP with transport layer security.

    • Port   The MobiLink server communicates over a specific port. By default, the port number is 2439 for TLS (TCP/IP with transport layer security). If you choose a value other than this, you must configure your MobiLink server to listen on the port you specify.

    • Encryption   Choose the same type of encryption that the MobiLink server is using.

      The following options are supported for encryption:

      • ECC   Elliptic-curve cryptography (ECC) requires a separate license.

      • RSA   RSA encryption is provided free with SQL Anywhere.

      • RSA (FIPS 140-2 certified)   Federal Information Processing Standard (FIPS) 140-2 specifies requirements for security algorithms. FIPS 140-2 is granted by the American and Canadian governments through the National Institute of Standards and Testing (NIST) and the Canadian Communications Security Establishment (CSE). FIPS technology requires a separate license.

Additional protocol options   Specify optional network parameters in this field. The allowed values depend on the connection stream type.

The following table lists the parameters you can specify. These parameters are supported by all connection streams (TCP/IP, HTTP, and HTTPS), except where noted otherwise.

Parameter

Description

buffer_size=number

HTTP and HTTPS only. The maximum body size for a fixed content length message, in bytes. Changing the option increases or decreases the amount of memory allocated for sending content. The default is 65535.

client_port=nnnnn

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.

This option can be useful for clients inside a firewall communicating with a MobiLink server outside the firewall.

persistent={ 0 | 1 }

HTTP and HTTPS only. 1 (True) means that the client attempts to use the same TCP/IP connection for all HTTP requests in a synchronization. A setting of 0 (False) is more compatible with intermediate agents. The default is 0.

Note: You should only set persistent to 1 if you are connecting directly to a MobiLink server. If you are connecting through an intermediate agent such as a proxy or redirector, a persistent connection may cause problems.

proxy_host=proxy_hostname

HTTP and HTTPS only. The host name of the proxy server.

proxy_port= proxy_portnumber

HTTP and HTTPS only. The port number of the proxy server. The default value is 80.

url_suffix=suffix

HTTP and HTTPS only. The suffix to add to the URL on the first line of each HTTP request. When synchronizing through a proxy server or the MobiLink Redirector, the suffix may be necessary to find the MobiLink server. The default value is MobiLink.

version= versionnumber

HTTP and HTTPS only. A string specifying the version of HTTP to use. You have a choice of 1.0 or 1.1. The default value is 1.1.

For more information about these network parameters, see MobiLink client network protocol options.

See also