Configuring a Synchronization Listener for Replication-Based Synchronization

Configure the port to receive replication-based synchronization requests from client devices, and if you are using push synchronization, then also configure synchronization listener properties.

Prerequisites
Determine whether you require an encrypted (secured) or unencrypted synchronization stream. A secure synchronization stream uses SSL encryption; therefore, before setting up a secure configuration, ensure that you possess digital certificates verified and signed by third-party trusted authorities. The HTTPS protocol is slower than the HTTP protocol; use SSL only if you require HTTPS. See Transport Security Setup.
Task
  1. Open Sybase Control Center.
  2. In the left navigation pane, expand the Servers folder and select the server you want to configure.
  3. Select Server Configuration.
  4. In the right administration pane, click the Replication tab.
  5. If push synchronization is being added to replication-based synchronization application, select Synchronization Listener from the menu bar.
  6. Select the protocol and port you require:
    • If you do not require SSL encryption, choose Synchronization 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 Synchronization port. By default, the port for HTTPS is 2481.
  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 5. If you experience performance issues, you may need to increase this value.
  8. (Optional) Expand the optional properties section to configure these properties:
    Note: You can only configure the encryption properties on the primary Unwired Server. Secondary servers will inherit the values, where they become read-only.
    • Certificate Password – is used to decrypt the private certificate listed in certificate file. You specify this password when you create the server certificate.
    • Certificate – identifies the location of the security certificate used to encrypt and decrypt data transferred using SSL.
    • E2E Encryption Type – specify the asymmetric cipher used for key exchange for end-to-end encryption. You can only use RSA encryption.
    • E2E Encryption Certificate – specify the file containing the private key that acts as the identity file for Unwired Server.
    • E2E Encryption Certificate Password – set the password to unlock the encryption certificate.
    • 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.
      -ot <filePath> Truncates a file, then logs output to that 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 Listener options for Windows in the SQL Anywhere 11.0.1 online help.

  9. Click Save.
Parent topic: Server Administration Overview