Configuring Replication-Based Synchronization Properties

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 System Administration > Security Administration > Security Layers > Transport Security Setup.
Task
  1. In the left navigation pane, expand the Servers folder and select the server you want to configure.
  2. Select Server Configuration.
  3. In the right administration pane, click the Replication tab.
  4. If push synchronization is being added to replication-based synchronization application, select Synchronization Listener from the menu bar.
  5. 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.
  6. 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.
  7. (Optional) Expand the optional properties section to configure these properties:
    • Certificate Password – identifies the password that Unwired Server uses to unlock the security certificate.
    • Certificate – identifies the location of the security certificate used to encrypt and decrypt data transferred using SSL.
    • 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.

  8. Click Save.