Contents Dochome
Sun Java(TM) System Directory Server Online Help

> # Replication (Master) Configuration

> A master replica allows clients to write or modify entries and then supplies these updates to its consumers (either dedicated consumers, hubs or another master). In multi-master replication (MMR), several master replicas all accept client write operations on the same data and then send updates to each other to synchronize the contents of the replicated suffix.

> The status line shows you the replica ID of this master and that it logs changes so it can send the latest updates to its consumers. Only master replicas have an ID, and every master must have a different ID in order to allow multi-master synchronization.

> Change. Click this button to change the status of your replica. The following changes are available:

> - Promote-Demote Replica. Choose this menu item to demote your suffix from a master to a hub replica using the replication wizard. You must demote a master to a hub before being able to demote it further to a dedicated consumer replica.

> - Enable or Disable 4.x Compatibility. Choose this menu item to allow or disallow this suffix to receive updates from a Directory Server version 4.x supplier. When 4.x compatibility is enabled on a master, the replica will not accept client modifications and instead return a referral to the 4.x supplier server.

> When enabled for the first time, you will be prompted to enter a bind DN and password that the 4.x supplier must use to replicate to this suffix. Otherwise, 4.x compatibility will be enabled or disabled for this replica without confirmation. The status line will tell you when 4.x compatibility is enabled.

> - Disable Replication. Choose this menu item to unconfigure replication on this suffix. All replication agreements will be deleted, and the suffix will stop receiving and sending updates.

> Advanced. Click this button to configure advanced replication settings for your hub replica, such as defining additional replication manager DNs and alternate referrals.

> Defined replication agreements. This list shows all of the replication agreements between this suffix and its consumers. When active, this master will send updates to the consumer replica defined in each agreement. Each agreement is listed with the following information:

> - An icon that may change according to the status of the replication agreement: either enabled, initialization in progress, or disabled.

> - The host name and port number of the server holding the replica.

> - A description string you may provide when defining the replication agreement.

> When you select a replication agreement in the list, its status and Action button will be displayed in the text box below. The replication status for each agreement contains information such as initialization messages and the status of updates needing to be sent to this consumer.

> New. Click this button to define a new replication agreement.

> Delete, Edit, and Duplicate. Use these buttons to manage the replication agreement currently selected in the list. When you edit an agreement, you can set the replication manager, define a schedule for updates, limit the set of replicated attributes, or configure the network usage by the replication mechanism.

> Refresh. To reduce resource usage on the server, the information in the replication agreement status box is not refreshed automatically. To update the status box and the icon of the replication agreement in the list, click on one of the following Refresh items:

> - Refresh now. Select this item to refresh the replication agreement status with the most current information from the server.

> - Continuous Refresh. Select or deselect this checkbox to start or stop refreshing the replication agreement status automatically.

> Action. This button has three menu items to take action on the currently selected replication agreement:

> - Initialize Remote Replica. This action will initialize or reinitialize the consumer replica with the current contents of this master replica. You will be asked to confirm if you want to replace the current contents of the consumer replica. Any messages about the initialization will appear in the text box.

> - Send Updates Now. This action will force the master to send all pending updates to the consumer immediately. Otherwise, replication updates are sent as needed, or according to a replication schedule you may have defined in the replication agreement.

> - Disable Agreement. This action will stop the master from sending updates to the consumer replica, but the agreement will still exist. Use this action if you wish to interrupt the replication of the suffix but keep the possibility of enabling it again with the same configuration.

> When the replication agreement is disabled, this button is labeled Enable, which is the only action possible on a disabled agreement.

> ## See Also

> Chapter 8, "Managing Replication," in the Sun Java System Directory Server Administration Guide.

> Contents Dochome

> Copyright 2004 Sun Microsystems, Inc. All rights reserved.