Limiting File Size of the Replication Change Log

Technical Note 2203

Last Reviewed 10-Dec-2008
Applies to:
Sun Warehouse Directory 5.2

Mobility XE server version 6.00 and higher
Mobility Server OS: Windows 2000 Server, Windows 2003 Server
 Printer-friendly version

Summary

The changelog is used by the Master (or Primary) warehouse to queue replication changes. In the event the Standby warehouse is unavailable for a period of time the changelog is used to get the standby back in sync after it reconnects. By default the changelog is configured to grow without bound. NetMotion recommends limiting the filesize to a particular number of days, meaning the Standby warehouse can be down for that period of time before replication will need to be reinitialized.

Important: All your Mobility warehouses must have Sun Patch 4 applied before making these changes, otherwise the warehouse services may fail to restart.

To determine if Patch 4 has been applied to your warehouses, do the following on each warehouse (primary and standby):

1. Open the Sun ONE Directory Server console: on the Start menu, click Programs | Sun ONE Server Products (or Sun Java™) System Server Products) | Sun ONE Server Console 5.2 (or Sun Java™ System Server Console 5.2). Log on with the user ID and password you created during warehouse setup. The default user ID is admin.

2. On the Servers and Applications tab, expand the tree in the left-hand pane until you see the Directory Server listing.

3. Select (highlight) "Directory Server".

4. In the right-hand pane, look at the "Version:" line.

5. A warehouse that has had Sun Patch 4 applied will read "Version: 5.2_Patch_4".

For information on applying Sun Patch 4, refer to http://www.netmotionwireless.com/support/technotes/2195.aspx.

Configuring the Changelog

The following steps describe how to clear the existing changelog file, then set it up again with a limited filesize.

1. On the computer running your Primary warehouse, open the Sun ONE Server console and log on with the user ID and password you created during warehouse setup.

2. On the Servers and Applications tab, expand the tree until you see your Directory Server listing. Select your server, and then click Open.

3. On the Configuration tab, select the "Data" node.

4. In the right-hand pane, select the Replication tab.

5. To clear the existing changelog file, deselect "Enable Changelog", then click Save.

6. To set up logging with a limit on the size of the file, select "Enable Changelog", then set the "Max changelog age" to 7 days (you'll need to deselect "unlimited"), then "save". You can choose a larger or smaller value if you'd like to allow for a larger window of time or a smaller filesize, but keep in mind that if the Standby Warehouse is out of contact with the Primary for longer than this value then it won't get a complete set of data and so it may not function properly as a backup if the primary goes down, unless you reinitialize the replication.

7. Restart the "Sun ONE Directory Server 5.2" service on the Standby warehouse:

   1. On the computer running your Standby warehouse, open the Sun ONE Server console and log on with the user ID and password you created during warehouse setup.

   2. On the Servers and Applications tab, expand the tree until you see your Directory Server listing. Select your server, and then click Open.

   3. On the Tasks tab, click "Restart Directory Server".

8. Verify that replication is still working: open the Mobility console and click on the Warehouse Status page. Note the date, time, and status of the most recent replication update. A replication update should have occurred within shortly after performing the steps above.

9. If replication is no longer working, perform the following steps to reinitialize the contents of the Standby warehouse and restart replication:

   1. Open the Sun ONE Directory Server console on the Primary warehouse and log on with the user ID and password you created during warehouse setup.

   2. On the Servers and Applications tab, expand the tree until you see your Directory Server listing. Select your server, and then click Open.

   3. On the Configuration tab, expand the "Data" tree, then expand the "o=Netmotion..." tree. Select (highlight) "Replication".

   4. In the right-hand pane, select (highlight) the IP address of the Standby warehouse you want to reinitialize.

   5. Click the "Action..." button and select "Initialize Remote Replica..." from the popup menu. Click "Yes" in the Confirmation Required dialog box.

   6. In the bottom section of the right-hand pane you will see the following message:

      Starting new total update.
      

   7. Wait several seconds, then click the "Refresh..." button and select "Refresh now" from the popup menu. In the bottom section, you should now see:

      The remote replica of the selected agreement has been initialized with the contents of this replica.
      

      Initialization ended at <current timestamp>.
      

      
      

      The last replication update message was:
      

      Incremental update session succeeded.
      

Related Information

Please comment on this technical note.