vania-janet/multiturn-rag-retrieval-data huggingface dataset:
Choose a service name, region, organization and space to provision the service in, and for the Select a database version field, choose Latest Preferred Version. In this example, the service name is "example-rabbitmq".

Click Create to provision your service. Provisioning can take a while to complete. You are taken back to your IBM Cloud Dashboard while the service is provisioning.

You cannot connect an application to the service until provisioning is complete.





 Step 2: Clone the Hello World sample app from GitHub 

Use the following command to clone the Hello World app to your local environment from your terminal:

git clone -b node git@github.com:IBM-Cloud/clouddatabases-helloworld-cloudfoundry-examples.git





 Step 3: Install the app dependencies 

Use npm to install dependencies.

From your terminal, change the directory to where the sample app is located.

Install the dependencies listed in the package.json file.

npm install





 Step 4: Download and install the IBM Cloud CLI tool 

The IBM Cloud CLI tool is what you use to communicate with IBM Cloud from your terminal or command line. For more information, see [Download and install IBM Cloud CLI](https://cloud.ibm.com/docs/cli/reference/bluemix_cli/download_cli.html).





 Step 5: Connect to IBM Cloud 

Connect to IBM Cloud in the command-line tool and follow the prompts to log in.

ibmcloud login

If you have a federated user ID, use the ibmcloud login --sso command to log in with your single sign-on ID. See [Logging in with a federated ID](https://cloud.ibm.com/docs/cli/login_federated_id.htmlfederated_id) to learn more.

Make sure that you are targeting the correct IBM Cloud org and space.

ibmcloud target --cf

By using the same values that you used when creating the service, choose from the provided options.





 Step 6: Create a Cloud Foundry alias for the database service 

IBM® Cloud Foundry is deprecated.
Getting Started with the SDKs 

IBM Cloud® Object Storage provides SDKs for Java, Python, NodeJS, and Go which can help you to make the most of Object Storage.

In this quickstart guide, you are provided a code example that demonstrates the following operations:



* Create a new bucket
* List the available buckets
* Create a new text file
* List the available files
* Retrieve the text file contents
* Upload a large binary file
* Delete a file
* Delete a bucket





 Before you begin 

You need:



* An [IBM Cloud® Platform account](https://cloud.ibm.com/login)
* An [instance of IBM Cloud Object Storage](https://cloud.ibm.com/docs/cloud-object-storage/basics?topic=cloud-object-storage-provision)
* An [IAM API key](https://cloud.ibm.com/docs/cloud-object-storage/iam?topic=cloud-object-storage-iam-overview) with Writer access to your Object Storage







 Getting the SDK 

Specific instructions for downloading and installing the SDK is available in [Using Python](https://cloud.ibm.com/docs/cloud-object-storage/libraries?topic=cloud-object-storage-python)[Using Node.js](https://cloud.ibm.com/docs/cloud-object-storage/libraries?topic=cloud-object-storage-node)[Using Java](https://cloud.ibm.com/docs/cloud-object-storage/libraries?topic=cloud-object-storage-java)[Using Go](https://cloud.ibm.com/docs/cloud-object-storage?topic=cloud-object-storage-using-go).





 Code Example 

The code examples below provide introductory examples of running the basic operations with Object Storage. For simplicity, the code example can be run multiple times as it uses Universally Unique Identifiers (UUIDs) for bucket/item names to prevent potential conflicts.

In your code, you must remove the angled brackets or any other excess characters that are provided here as illustration.
Plans and provisioning 

IBM® Cloudant® for IBM Cloud® Standard is IBM Cloudant's most feature-rich offering, receiving updates and new features first. Pricing is based on provisioned throughput capacity that is allocated and data storage that is used, making it suitable for any required load.

The free [Lite plan](https://cloud.ibm.com/docs/services/Cloudant?topic=Cloudant-ibm-cloud-publiclite-plan) includes a fixed amount of throughput capacity and data for development and evaluation purposes. The paid [Standard plan](https://cloud.ibm.com/docs/services/Cloudant?topic=Cloudant-ibm-cloud-publicstandard-plan) offers configurable provisioned throughput capacity and data storage pricing that scales as your application requirements change. An optional [Dedicated Hardware plan](https://cloud.ibm.com/docs/services/Cloudant?topic=Cloudant-ibm-cloud-publicdedicated-hardware-plan) is also available for an extra monthly fee to run one or more of your Standard plan instances on a dedicated hardware environment. The dedicated hardware environment is for your sole use. If a Dedicated Hardware plan instance is provisioned within a US location, you can optionally select a [HIPAA](https://en.wikipedia.org/wiki/Health_Insurance_Portability_and_Accountability_Act) -compliant configuration.



 Plans 

You can select which plan to use when you [provision your IBM Cloudant service instance](https://cloud.ibm.com/docs/services/Cloudant?topic=Cloudant-ibm-cloud-publicprovisioning-a-cloudant-nosql-db-instance-on-ibm-cloud). The available plans include Lite and Standard. When you select a plan, Capacity displays, and the Cost estimator shows the monthly charge for the selected plan. By default, the [Lite plan](https://cloud.ibm.com/docs/services/Cloudant?topic=Cloudant-ibm-cloud-publiclite-plan) is selected.



 Lite plan 

The Lite plan is free, and is designed for development and evaluation purposes.
Plans and provisioning 

IBM® Cloudant® for IBM Cloud® Standard is IBM Cloudant's most feature-rich offering, receiving updates and new features first. Pricing is based on provisioned throughput capacity that is allocated and data storage that is used, making it suitable for any required load.

The free [Lite plan](https://cloud.ibm.com/docs/Cloudant?topic=Cloudant-ibm-cloud-publiclite-plan) includes a fixed amount of throughput capacity and data for development and evaluation purposes. The paid [Standard plan](https://cloud.ibm.com/docs/Cloudant?topic=Cloudant-ibm-cloud-publicstandard-plan) offers configurable provisioned throughput capacity and data storage pricing that scales as your application requirements change. An optional [Dedicated Hardware plan](https://cloud.ibm.com/docs/Cloudant?topic=Cloudant-ibm-cloud-publicdedicated-hardware-plan) is also available for an extra monthly fee to run one or more of your Standard plan instances on a dedicated hardware environment. The dedicated hardware environment is for your sole use. If a Dedicated Hardware plan instance is provisioned within a US location, you can optionally select a [HIPAA](https://en.wikipedia.org/wiki/Health_Insurance_Portability_and_Accountability_Act) -compliant configuration.



 Plans 

You can select which plan to use when you [provision your IBM Cloudant service instance](https://cloud.ibm.com/docs/Cloudant?topic=Cloudant-ibm-cloud-publicprovisioning-a-cloudant-nosql-db-instance-on-ibm-cloud). The available plans include Lite and Standard. When you select a plan, Capacity displays, and the Cost estimator shows the monthly charge for the selected plan. By default, the [Lite plan](https://cloud.ibm.com/docs/Cloudant?topic=Cloudant-ibm-cloud-publiclite-plan) is selected.



 Lite plan 

The Lite plan is free, and is designed for development and evaluation purposes.
[Migrating an Enterprise plan to a Lite or Standard plan](https://cloud.ibm.com/docs/Cloudant?topic=Cloudant-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.

Cloudant



* 30 minutes
* 2023-04-06



[Migrating from a Lite plan to a Standard plan](https://cloud.ibm.com/docs/Cloudant?topic=Cloudant-migrating-from-a-lite-plan-to-a-standard-plan)Migrating from a Lite plan to a Standard plan

Migrating from the free Lite plan to the Standard plan by completing the following tasks.

Cloudant



* 15 minutes
* 2023-04-06



[Finding your IBM Cloudant plan](https://cloud.ibm.com/docs/Cloudant?topic=Cloudant-find-your-ibm-cloudant-plan)Finding your IBM Cloudant plan

You can subscribe to different IBM Cloudant plans, including the Lite, Standard, or Enterprise plans.

Cloudant



* 20 minutes
* 2023-03-30



[Combining IBM Cloudant with other IBM services](https://cloud.ibm.com/docs/Cloudant?topic=Cloudant-combine-ibm-services)Combining IBM Cloudant with other IBM services

Each database technology has its own strengths and weaknesses. Some are built for high availability and data durability (at the expense of more hardware and extra cost). Others favor speed and can churn out blazingly fast queries (but might lose data in a sudden power failure).

Cloudant



* 2023-03-30



[Enhance cloud security by applying context-based restrictions](https://cloud.ibm.com/docs/solution-tutorials?topic=solution-tutorials-cbr-enhanced-security)Enhance cloud security by applying context-based restrictions
Migration FAQ 

Migrate your plan to an IBM® Cloudant® for IBM Cloud® Lite or Standard plan instance.



  Which plans can I migrate? 

You can migrate to a Lite or Standard plan from one of the following plans:



*  IBM Cloudant Enterprise
*  Apache CouchDB



For more information, see [Migrating an Enterprise plan to a Lite or Standard plan](https://cloud.ibm.com/docs/Cloudant?topic=Cloudant-migrating-an-enterprise-plan-to-a-lite-or-standard-plan).

Or you can migrate from the Lite plan to a Standard plan, which is just upgrading from the Lite plan to the Standard plan. For more information, see [Migrating from a Lite plan to a Standard plan](https://cloud.ibm.com/docs/Cloudant?topic=Cloudant-migrating-from-a-lite-plan-to-a-standard-plan).





  Can I back up my data before I migrate? 

The IBM Cloudant team advises that you use the [couchbackup](https://cloud.ibm.com/docs/Cloudant?topic=Cloudant-ibm-cloudant-backup-and-recoveryibm-cloudant-backup-and-recovery) utility to export data to disk. Or use [IBM Cloud Object Storage](https://www.ibm.com/cloud/object-storage), which is an inexpensive, scalable solution for storing the exported files.





  Can I keep my username.cloudant.com domain and redirect it to the new service on IBM Cloudant? 

No, it's not possible to keep your domain. You must plan to update your applications to use the new account URL and credentials that are generated for the IBM Cloudant instances.





  Who do I contact if I have questions? 

Go to the [IBM Cloud Support portal](https://www.ibm.com/cloud/support), or open a ticket from within the IBM Cloudant Dashboard if you have any questions about migration. IBM Cloudant support is happy to provide more details.
SERVICE_NAME cloudantnosqldb 
 SERVICE_PLAN_NAME Lite plan (lite) or Standard plan (standard) 
 LOCATION The location where you want to deploy includes the following cities: Sydney au-syd, Chennai in-che, Osaka jp-osa, Tokyo jp-tok, Seoul kr-seo, Frankfurt eu-de, London eu-gb, Dallas us-south, Washington DC us-east. 
 legacyCredentials Defaults to true. This field dictates whether the instance uses both legacy and IAM credentials or IAM credentials only. 



SERVICE_PLAN_NAME is the type of pricing plan you select when you create an instance. For more information, see [Plans](https://cloud.ibm.com/docs/Cloudant?topic=Cloudant-ibm-cloud-publicplans-and-provisioning) in the documentation for details on using the IBM Cloudant Lite or Standard plan.

For more information about choosing an authentication method, see the [IAM guide](https://cloud.ibm.com/docs/Cloudant?topic=Cloudant-managing-access-for-cloudant). The IBM Cloudant team recommends that you use IAM access controls over IBM Cloudant legacy authentication whenever possible.

Now, we create a service instance that is called, cs20170517a.



1. Set your target resource group and region by using the following format. To run this command, you need to know the region and resource groups, which you find in the following steps.

For more information, see [General CLI (ibmcloud) commands](https://cloud.ibm.com/docs/cli?topic=cli-ibmcloud_cliibmcloud_target) under ibmcloud target.

ibmcloud target [-r REGION_NAME] [-g RESOURCE_GROUP]
2. To see a list of regions, run the following command.

ibmcloud regions
3. To see a list of resource groups, run the following command.

ibmcloud resource groups
4. Create an instance of an IBM Cloudant service by using the Lite plan.
Learning about IBM Cloudant architecture and workload isolation 

Review the following sample architecture for IBM® Cloudant® for IBM Cloud®, and learn more about different isolation levels. After that, you can choose the solution that best meets the requirements of the workloads that you want to run in the cloud.



 IBM Cloudant isolation models and architecture 

IBM Cloudant is a multi-tenant-capable database system with mechanisms in place to distribute any shared resources like CPU or I/O fairly among the active tenants. IBM Cloudant implements isolation in the database layer itself, and not by relying on containers. Instances are isolated from each other for access control, meaning that it is not possible to read or write data in one instance from another.

Workload isolation is an important consideration for many customers. To select the best IBM Cloudant plan choice for your workload isolation requirements, see the following architectural information:



1. Standard and Lite plans on Multi-Tenant Hardware, which offer excellent isolation.
2. Standard plan provisioned on a Dedicated Hardware plan instance, which offers improved isolation over Standard on Multi-Tenant Hardware.





 Standard and Lite 

Standard and Lite plans are provisioned onto large, shared IBM Cloudant database deployments where customers share compute and storage resource. Standard and Lite plans apply provisioned throughput rate-limiting, along with other resource and access isolation mechanisms within the database layer itself. Together, these provide strong security guarantees alongside robust resource separation within the shared environment.

Zoom

![Diagram about how to isolate data with the IBM Cloudant Standard plan for two customers.](https://cloud.ibm.com/docs-content/v1/content/522c6f62358b063f921283400a601c3f9bc66f08/Cloudant/images/Isolation-Standard.svg)

Figure 1. Data isolation on IBM Cloudant Standard plan

Disk encryption is used to provide encryption at rest by using an IBM owned and managed encryption key. Customer data resides in different files on disk.





 Standard on Dedicated Hardware 

A Dedicated Hardware instance offers improved storage and compute isolation for your most valuable data, including use of BYOK.
Choosing your plan 

Event Streams is available as Lite plan, Standard plan, Enterprise plan, or Satellite plan depending on your requirements.

For information about Event Streams plan pricing, see the [catalog](https://cloud.ibm.com/catalog). Search for Event Streams, then click the Event Streams tile to go to the provisioning page.



 Lite plan 

The Lite plan is free for users who want to try out Event Streams or build a proof-of-concept. Do not use the Lite plan for production use. It offers shared access to a multi-tenant Event Streams cluster.





 Standard plan 

The Standard plan is appropriate if you require event ingest and distribution capabilities but do not require any additional benefits of the Enterprise plan. The Standard plan offers shared access to a multi-tenant Event Streams cluster that seamlessly autoscales as you increase the number of partitions you are using for your workload.

The architecture is highly available by default. The service is distributed across three availability zones, which means that the cluster is resilient to the failure of a single zone or any component within that zone.





 Enterprise plan 

The Enterprise plan is appropriate if data isolation, performance, and increased retention are important considerations. The Enterprise plan includes the following features:



* Exclusive access to a single-tenant Event Streams service instance deployed in a highly available multi zone region (MZR).
* Option to provision a single-tenant Event Streams service instance in a geographically local but single zone location [(SZR)](https://cloud.ibm.com/docs/EventStreams?topic=EventStreams-slasla_szr).
* Scaling options to customize throughput, storage capacity, or both.



The architecture is highly available when you choose to deploy into a multi-zone region. The service is distributed across three availability zones, which means that the cluster is resilient to the failure of a single zone or any component within that zone.





 Satellite plan 

The IBM Cloud Satellite® plan is appropriate if you want to deploy an Enterprise plan into Satellite locations of your own choice.
You can't provision a Lite plan instance on a Dedicated Hardware environment.
4. Select an environment.

For Dedicated Hardware provisioned instances, you can select from the major IBM Cloud regions in the IBM Cloud Dashboard. However, the actual physical location of the Dedicated Hardware instance is dictated by the location parameter in a later step.



1. Click Dedicated.
2. Click Select existing host.
3. Select the dedicated environment that you created from the drop-down menu.
The screen capture shows the example environment, Dedicated Hardware Environment (staging).



Zoom

![From the Select an environment window. Select the Dedicated Hardware Environment.](https://cloud.ibm.com/docs-content/v1/content/522c6f62358b063f921283400a601c3f9bc66f08/Cloudant/tutorials/images/img0005h.png)

Figure 4. Dedicated environment



4. Select the appropriate IBM Cloud region.



Zoom

![From the Select an environment window, create an IBM Cloud region.](https://cloud.ibm.com/docs-content/v1/content/522c6f62358b063f921283400a601c3f9bc66f08/Cloudant/tutorials/images/img0005d2.png)

Figure 5. IBM Cloud region
5. Configure the IBM Cloudant instance.



1. Enter an instance name or accept the pre-filled name.
2. Select a resource group.
3. (Optional) Add a tag.
4. Select an authentication method.
The Standard plan is the only plan you can use with the Dedicated Hardware environment.



Zoom

![Configure your IBM Cloudant instance.]
* What's a Lite pricing plan for services?

A Lite plan is a free quota-based service plan. You can use a service's Lite plan to build an app without incurring any charges. A Lite plan might be offered on a monthly cycle that is renewed each month or on a one-off usage basis. Lite pricing plans are available with all account types. You can have one instance of a Lite plan for each service. For more information about Lite accounts, see [Account types](https://cloud.ibm.com/docs/account?topic=account-accountsliteaccount).
* How many apps can I build?

There's no limit to the number of apps you can build in a Pay-As-You-Go or Subscription account.

If you created a Lite account before 12 August 2021, you can build and deploy apps with 256 MB of instantaneous runtime memory. To get 512 MB of free instantaneous runtime memory, upgrade to a Pay-As-You-Go or Subscription account and pay only for what you use over that limit.
* What happens when my Lite plan instance reaches the monthly quota?

Reaching any quota limit for Lite plan instances suspends the service for that month. Quota limits are per org, not instance. New instances that you create in the same org reflect any usage from previous instances. The quota limits reset on the first of every month.

You can check your usage by going to Manage > Billing and usage in the IBM Cloud console, and selecting Usage. For more information, see [Viewing your usage](https://cloud.ibm.com/docs/billing-usage?topic=billing-usage-viewingusage).
* How many resource groups, orgs, or spaces can I create?

If you have a Pay-As-You-Go or Subscription account, there's no limit to the number of resource groups, orgs, or spaces that you can create. However, if you have a Lite account, you're limited to one org and one resource group.
* Can I change which notifications I receive?
: Release of the [Lite plan](https://cloud.ibm.com/docs/EventStreams?topic=EventStreams-plan_chooseplan_lite) in US-South allowing users to provision a minimal Event Streams instance for free.





 1 July 2019 

Updates to Enterprise plan
: Apache Kafka version upgrade.
: Support for Cloud Service Endpoints.

Kafka version upgrade
: Event Streams Enterprise supports version 2.2 of Apache Kafka to align with our recently released and upgraded Standard plan.
: This update for Event Streams is nondisruptive and was tested with our supported Kafka client list.
: If your Kafka client is not on this list, then while we expect the upgrade to be nondisruptive, these clients were not tested and we cannot offer any support statement for these clients. If this is a concern, do any extra testing that you require.
: Note: The Standard plan is already updated to Apache Kafka version 2.2 and can be used for extra testing.

Support for Cloud service endpoints
: Event Streams supports Cloud service endpoints.
: This capability means that any data that you publish or consume from the Event Streams service is over the private network and not public interfaces.





 14 May 2019 

New Standard plan
: Support for Apache Kafka version 2.2.
: Support for fine-grained authorization to topic level.
: Support for availability zones to further increase the resiliency of the service.
: A brand new IBM® Design Thinking-led developer and user experience.
: Available in the US-South region.
A user is required to have have at a minimum the platform role of editor for all IAM enabled services, or at least for Cloud Object Service. For more information, see the [IAM documentation on roles](https://cloud.ibm.com/docs/account?topic=account-iam-service-roles-actions).
* Which one of my instances uses a Lite plan?

An account is limited to a single instance of IBM Cloud Object Storage that uses a Lite plan. You can find this instance three different ways:



1. Navigate to the [catalog](https://cloud.ibm.com/objectstorage/create) and attempt to make a new Lite instance. An error will pop up prompting you to delete the existing instance, and provides a link to the current Lite instance.
2. Navigate to the storage section of the resource list, and click on any area of blank space to select an instance of Object Storage. An informational sidebar will appear and provide the plan name: either Lite or Standard.
3. Use the CLI to search for the resource:



ibmcloud resource search "service_name:cloud-object-storage AND 2fdf0c08-2d32-4f46-84b5-32e0c92fffd8"
* How do I upgrade a service instance from Lite to Standard?

Typically, this is easily done from the IBM Cloud Object Storage console found here [https://cloud.ibm.com/objectstorage/](https://cloud.ibm.com/objectstorage/), select the correct name of Cloud Object Storage Instance you wish to upgrade,click on Plan in the navigation menu, located after Instance Usage. Select the "standard" plan and hit save.

In cases where the instance has been locked due to exceeding the maximum allowed size of a Lite instance it may be necessary to use the CLI. The plan ID for a standard Object Storage instance is 744bfc56-d12c-4866-88d5-dac9139e0e5d (if curious, this can be found by issuing the CLI command ic catalog service cloud-object-storage).