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



Replication (Hub) Configuration

A hub replica receives updates from a supplier (either a master or another hub) and sends updates to consumers (either dedicated consumers or another hub). However, it does not perform updates and forwards them instead as referrals to its supplier.

The status line reflects both roles by telling you the hub replica is ready to receive updates and that it logs changes so it can send the latest updates to its consumers.

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

  • Promote-Demote Replica. This menu item will start the replication wizard so you may either promote your hub to a master or demote it to a dedicated consumer.

  • 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 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 hub and its consumers. When active, this replica 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 hub 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 hub 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 hub 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.