IBM Cloud Docs
Migrating an Enterprise plan to a Lite or Standard plan

Migrating an Enterprise plan to a Lite or Standard plan

Migration from the Enterprise plans to IBM Cloudant Lite or Standard plans includes these tasks, which are described in the following steps.

Sign up for IBM Cloud

  1. Go to the IBM Cloud Dashboard.
  2. Authenticate with your username and password.
    The IBM Cloud Dashboard opens to the Resource list.

Create an IBM Cloudant instance

  1. Click Create resource.

  2. Click Databases > Cloudant.

    Select Databases > Cloudant dashboard as your instance.
    IBM Cloudant Dashboard

    For more information, see the Getting started tutorial.

Find out whether your application is ready for IBM Cloudant

  1. Revisit your application’s usage of IBM Cloudant to make sure it is ready to handle the capacity limits of the Standard plan. For more information, see how the IBM Cloudant API works.
  2. Verify that your application can handle a 429: too many requests HTTP response.

The following table provides more information about these HTTP responses:

HTTP responses
HTTP response Issue
429: too many requests Retrying requests that get a 429 response is acceptable for occasional traffic spikes that exceed your plan's capacity. If your application traffic is routinely generating 429 responses, you probably need to upgrade to a larger plan.
413: request entity too large The maximum individual document size is 1 MB on IBM Cloudant. You receive a 413 message if the limit is exceeded. For more information, see request and document size limits.

Migrate data from the old service to the new service

  1. Set up continuous replications from your existing service to your IBM Cloudant account.

    For more information, see the Replication guide and Using IBM Cloudant about how to set up and monitor replication tasks.

  2. Alternatively, use the couchreplicate tool to coordinate the transfer of data from one IBM Cloudant account to another.

    The couchreplicate tool sets up multiple replication jobs between the source and target accounts, ensuring that only so many replication jobs proceed at one time. If you need to migrate hundreds of databases, then couchreplicate can help coordinate the replication jobs.

  3. Verify that all your data replicates to the new service and that indexes are built.

Test your application

  1. Conduct load and functional testing on your application.
  2. Ensure that no issues exist before you migrate to production.

Move to the new instance

  1. Update your application to use the new account URL and credentials for the IBM Cloudant instance.
  2. (Optional) Go to the Getting started tutorial to obtain the service credentials for your IBM Cloudant instance.

Turn off the old service

  1. Verify that your application is fully migrated to the Lite or Standard instance.
  2. Delete the old Enterprise plan instance from your IBM Cloud console to ensure that you're no longer charged for the service.