Configuring a Replication Listener

(Not applicable to Online Data Proxy)Configure the port to receive synchronization requests from client devices. If you are using push synchronization, then also configure synchronization listener properties.

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 Unwired Platform. Ensure that you possess digital certificates verified and signed by third-party trusted authorities. See Encrypting Synchronization for Replication Payloads in Security.
Task
  1. Open Sybase Control Center.
  2. In the left navigation pane, expand the Servers folder and select the primary server.
    Note: You can only configure the encryption properties on the primary Unwired Server. Secondary servers will inherit the values, where they become read-only.
  3. Select Server Configuration.
  4. In the right administration pane, click the Replication tab.
  5. If push synchronization is being added to the application, select Listener from the menu bar.
  6. Select the protocol and port you require:
    • If you do not require SSL encryption, choose Port. Sybase 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 in the "Optional Properties" table can be used to review and set the server identity and public certificate for the secure synchronization port. See below.
  7. Configure these properties:
    • Synchronization Cache Size – sets the maximum cache size for the synchronization port. The default is 50MB.
    • Thread Count – sets the number of worker threads used for synchronization. The default is 10. If you experience performance issues, you may need to increase this value.
  8. (Optional) Expand the optional properties section to 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 Password – set the password to unlock the encryption certificate.
    • E2E Encryption Certificate – specify the file containing the private key that acts as the identity file for Unwired 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.
      -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 Sybase 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.

  9. Click Save.
Parent topic: Replication