Configuring synchronization model testing

Use the Test Window Configuration window to configure some of the options used for testing the synchronization model, enabling more complete testing of your synchronization logic and creating an environment closer to that of your production environment.

Prerequisites

You must have a synchronization model defined in your MobiLink project.

Context

Changes are made to the consolidated database when you use the test feature.

Procedure

Double-click the MobiLink project name.
Double-click Synchronization Models and select your synchronization model name.
In the Deployment pane, click Test. You are warned that testing the synchronization model causes changes to the consolidated database and modifies data in tables. Click OK.
Click Actions Configure .
Fill in the following fields:
- MobiLink User
  Type the MobiLink user name you want the MobiLink client to use when connecting to the MobiLink server.
- MobiLink Password
  Type the password for the MobiLink user name you specified.
- Authentication Parameters
  Type the authentication parameters, using a comma-separated list. For example, p1,p2,p3. These values are sent from the MobiLink client to the MobiLink server and can be accessed by the server-side synchronization scripts.
- MobiLink Server Command Line
  Choose a MobiLink server command line to use when starting the MobiLink server for testing. To review the options specified on the MobiLink server command line, click View. The MobiLink Server Command Line Properties window appears.
- Client Network Protocol
  Choose the network communication protocol for the MobiLink client to use when connecting to the MobiLink server. Only protocols defined by the MobiLink server command line can be chosen.
- Client Network Options
  Choose network protocol options for the MobiLink client to use when connecting to the MobiLink server. Edit the options directly or click Edit to edit the options from the Client Network Options page.
  
  When you select a client network protocol, default options are generated in this field based on the MobiLink server command line. Always review the default options to ensure that they are adequate for synchronization.
- Synchronization Type
  Choose one of the following synchronization types from the dropdown list.
  - Bidirectional
    Database operations are synchronized from the remote database to the consolidated database, and vice versa.
  - Download only
    Changes are synchronized from the consolidated database to the remote database only.
  - Upload only
    Changes are synchronized from the remote database to the consolidated database only.
- Always use these settings when testing this synchronization model with this consolidated database
  Check this option to use this configuration every time you test this synchronization model. The specified options are used until the settings are changed.
Click OK. You are warned that the synchronization model will be redeployed and that data in the remote database will be lost. Click OK.

Results

The synchronization model is redeployed in the Test window using the new settings.

Next Steps

You can perform the following tasks once the synchronization model has been redeployed:

Use Actions Configure to change the Test window settings again.
Modify the remote and/or consolidated database. There are several options for modifying the databases:
- Use the Data tab to directly modify data in the tables being synchronized.
- Use the Actions menu to open the dbisql utility on either database.
Run a test synchronization by clicking Synchronization.