Lesson 7: Synchronize

Now you are ready to synchronize the remote client for the first time. This is done with the MobiLink client program dbmlsync. Dbmlsync connects to the remote database, authenticates itself with the MobiLink server, and performs all the uploads and downloads necessary to synchronize the remote and consolidated databases based on a publication in the remote database.

To synchronize the remote client

At a command prompt, run the following command:

dbmlsync 
-c "server=remote_eng;DBN=remote_db;UID=DBA;PWD=sql;"
-n sync_oracle_publication
-u oracle_remote -mp oracle_pass

dbmlsync is the synchronization application.
ENG specifies the name of the remote database server.
DBN specifies the name of the remote database.
UID is the user name used to connect to the remote database.
PWD is the password used to connect to the remote database.
sync_oracle_publication is the publication on the remote device that is used to perform the synchronization. (This publication was created by the Create Synchronization Model Wizard.)
oracle_remote is the user name used to authenticate with the MobiLink server.
oracle_pass is the password used to authenticate with the MobiLink server.

The progress of the synchronization appears in the SQL Anywhere MobiLink Client Messages window. When this command runs successfully, the dbmlsync application populates the remote database with a subset of information from the consolidated database.

If synchronization fails, check the connection information you pass to the dbmlsync application, and the MobiLink user name and password. Failing that, check the publication name you used, and ensure that the consolidated database and MobiLink server are running. You can also examine the contents of the synchronization logs (server and client).

Note

If you are running the dbmlsync application on a different computer from your MobiLink server, you must pass in arguments that specify the location of the MobiLink server.

View the data

After successfully synchronizing the remote client to the consolidated database through the MobiLink server, the remote data should be populated with information relevant to one salesperson. You can verify this in Sybase Central using the SQL Anywhere 12 plug-in.

To view the data in the remote database

Start Sybase Central.
Connect to the remote database:
1. On the left pane, right-click SQL Anywhere 12 and choose Connect.
2. In the Authentication dropdown list, choose Database and type DBA as the User Id and sql as the Password.
3. From the Action dropdown list, choose Connect To A Running Database On This Computer, and then type remote_eng as the Server Name and remote_db as the Database Name.
4. Click OK.
Choose the ORDERS table and then click the Data tab on the right pane.

In the ORDERS tables, all the records are for the salesperson with an identifier of 154. This particular salesperson is not concerned with the sales information of other salespeople. For this reason, you set the synchronization scripts to filter out rows by the remote ID, and you set this database's remote ID to the value of a particular salesperson identifier. Now this particular salesperson's database takes up less space, and requires less time to synchronize. Since the remote database size is kept to a minimum, frequently performed operations such as entering a new sale or processing a refund on a previous sale runs faster and more efficiently.