IBM Developer Advocacy

Create a replication job

Learn how to create a replication job.


This tutorial shows you how to create a replication job from the Cloudant Dashboard.

What you’ll learn

At the end of this tutorial, you should be able to:

  • create a document in the _replicator database.
  • provide the required source and target database information.
  • specify the replication type as continous or singular.

Replicate a database

  1. Sign in to Cloudant.
  2. Click the Replication tab.
  3. Complete the form on the right side of the screen to create a new replication job with the following specifications.
    1. Just like any document in any other Cloudant database, you can either use the auto-generated document ID, or provide your own. For this tutorial, type foundbite_replication
    2. In this tutorial, you want to replicate a database from the Education account to your own personal account, so indicate that the source database is a Remote Database and type the URL to the database as
      In this case, you don’t need to set any special permissions because this database is already set to allow anyone to replicate it locally as seen in the following image.

    3. For the target database, click New Database, select Create a new database locally, and then specify the database name as foundbite.

      Tip: The source and target databases can be within the same account, between two different accounts, or one remote and one local.

    4. Leave Make this replication continuous unchecked so this will be a singular replication event.
  4. Click Replicate.
  5. Next, type your password, and click Continue.
    Under the covers, the process base64 encodes your credentials and includes that authentication information in the replication document.

  6. You get the success message: This replication has been posted to the _replicator database but hasn’t been fired yet. Check the _replicator DB to see its state.
  7. create_replication_job_response

blog comments powered by Disqus