Replicate

Forces replication between two servers (the server where you enter this command and the server you specify).

Details

Use the server's full hierarchical name. If the server name is more than one word, enclose the entire name in quotes. To force replication of a particular database that the servers have in common, specify the database name after the server name. The initiating server (where you're currently working) first pulls changes from the other server, and then pushes its own updates to the answering server. Using Pull-Push, the replicator task on the calling server performs all the work.

If the server is already replicating when you issue the command, Domino® queues the command until the current replication ends. To check the status of the Replicator, enter this command at the console:

Show Tasks

The server displays one of the following messages:

  • If the server isn't replicating, the word Idle appears next to the Replicator program.
  • If the server is replicating, a status message, such as Replicating CONTRACT.NSF from MARKETING\CONTRACT.NSF, appears.

Domino® replicates only what is necessary. For example, if the servers recently replicated and no changes have since been made to any databases on either server, the servers don't replicate when you enter a Replicate command.

Replication is two-way only if databases on both servers have changed since the last replication. If databases on only one server have changed, replication is one-way.

To force replication in only one direction, use the Pull or Push server commands.

Syntax

 Replicate servername [databasename]

The optional argument -F is available to force a full replication of a database as an alternative to clearing the replication history. For more information, see Forcing a full database replication.

Examples

Replicate Marketing/Acme -- Initiates replication between your server and the Marketing/Acme server. The server console displays messages indicating when replication begins.

Replicate Marketing/Acme NAMES.NSF -- Initiates replication of NAMES.NSF between your server and the Marketing/Acme.

Replicating from the Domino® Administrator

You can replicate directly from the Server > Status tab in the Domino® Administrator.

  1. From the Domino® Administrator, click the Server > Status tab.
  2. If necessary, click Tools to display the tool bar, and then click Server - Replicate.
  3. Under Which server do you want to replicate with?, enter the server you want to replicate with, or select the server you want from the drop-down list.
  4. For Replication style, choose Pull - Push.
  5. Choose one:
    • Selected database -- to select a specific database to replicate. Click the database button and select a database from the list.
    • All databases in common -- to replicate all databases that both servers have in common. This is the default setting.
  6. Click Replicate.