Configuring a Replication Listener

(Not applicable to Online Data Proxy) Configure the port to receive synchronization requests from client devices.

Prerequisites
A secure synchronization stream uses SSL or TLS encryption. Both TLS and SSL require production-ready certificates to replace the default ones installed with SAP Mobile Server. Ensure that you possess digital certificates verified and signed by third-party trusted authorities. See Encrypting Synchronization for Replication Payloads in Security.
Task
  1. In the left navigation pane, select Configuration .
  2. In the right administration pane, click the General tab.
  3. From the menu bar, select Components.
  4. Select Replication and click Properties.
  5. Select the protocol and port you require:
    • If you do not require SSL encryption, choose Port. SAP Mobile Platform recommends this option if you do not require a secure communication stream for synchronization. By default, the port for HTTP is 2480.
    • To encrypt the HTTP stream with SSL, choose Secure port. By default, the port for HTTPS is 2481. The "Secure Sync Port" properties can be used to review and set the server identity and public certificate for the secure synchronization port. See below.
  6. (Optional) Configure additional properties for E2EE with TLS, HTTPS with SSL, and synchronization server startup options:
    Note: Leave E2E Encryption values blank to disable end-to-end encryption.
    • E2E Encryption Certificate – specify the file containing the private key that acts as the identity file for SAP Mobile Server.
    • E2E Encryption Certificate Password – set the password to unlock the encryption certificate.
    • E2E Encryption Public Key – specify the file containing the public key for SAP Mobile Server.
    • E2E Encryption Type – specify the asymmetric cipher used for key exchange for end-to-end encryption. You can only use RSA encryption.
    • Secure Sync Port Certificate – identifies the location of the security certificate used to encrypt and decrypt data transferred using SSL.
    • Secure Sync Port Certificate Password – is used to decrypt the private certificate listed in certificate file. You specify this password when you create the server certificate for SSL.
    • Secure Sync Port Public Certificate – specify the file containing the SSL public key that acts as the identity file for synchronization port.
    • Trusted Relay Server Certificate – if Relay Server trusted certificate is configured for HTTPS connections encrypted with SSL, identifies the public security certificate location.
    • User Options – sets the command line options for starting the synchronization server. These options are appended the next time the synchronization server starts. These are the available user options:
      Option Description
      @ [variable | filePath] Applies listener options from the specified environment variable or text file.
      -a <value> Specifies a single library option for a listening library.
      -d <filePath> Specifies a listening library.
      -e <deviceName> Specifies the device name.
      -f <string> Specifies extra information about the device.
      -gi <seconds> Specifies the IP tracker polling interval.
      -i <seconds> Specifies the polling interval for SMTP connections.
      -l <"keyword=value;..."> Defines and creates a message handler.
      -m Turns on message logging.
      -ni Disables IP tracking.
      -ns Disables SMS listening.
      -nu Disables UDP listening.
      -o <filePath> Logs output to a file.
      Note: Ensure that you enter the absolute file path for this property.
      -os <bytes> Specifies the maximum size of the log file.
      -p Allows the device to shut down automatically when idle.
      -pc [+ | -] Enables or disables persistent connections.
      -r <filePath> Identifies a remote database involved in the responding action of a message filter.
      -sv <scriptVersion> Specifies a script version used for authentication.
      -zf (Recommended in development environments) Causes the SAP Mobile Server replication service to check for script changes at the beginning of each synchronization. Unless this option is used, the service assumes that no script changes have been made, no checks for script changes are performed, once the service starts. For production environments, this option is not recommended due to its negative impact on synchronization performance.
      -t [+ | -] <name> Registers or unregisters the remote ID for a remote database.
      -u <userName> Specifies a synchronization server user name.
      -v [0 | 1 | 2 | 3] Specifies the verbosity level for the messaging log.
      -y <newPassword> Specifies a new synchronization server password.

      Do not use the User Options property in SAP Control Center to pass in these options: -c, -lsc, -q, -w, -x, -zs.

      For more information on synchronization server command line options, see MobiLink Listener options for Windows devices (http://infocenter.sybase.com/help/topic/com.sybase.help.sqlanywhere.12.0.1/mlsisync/ms-listener-s-3217696.html) in the SQL Anywhere® 12.0.1 online help.

  7. Click OK.