vania-janet/multiturn-rag-retrieval-data huggingface dataset:
Retrieve the Cloud Resource Name (CRN) of the key by using the View CRN option in the key management service instance GUI.
5. Provision an instance of [Event Streams](https://cloud.ibm.com/docs/EventStreams?topic=EventStreams-getting-started). This feature is supported on the Enterprise plan only.



If provisioning through IBM Cloud® console, select a key management service instance and then select a root key from the instance.

If provisioning through CLI, use the following command:

ibmcloud resource service-instance-create EVENT-STREAMS-INSTANCE-NAME messagehub ibm.message.hub.enterprise.3nodes.2tb REGION -p '{"kms_key_crn":"KMS_KEY_CRN"}'

If you want to update your existing Event Streams instance to use a customer-managed key, open a [support ticket](https://cloud.ibm.com/docs/get-support?topic=get-support-open-case) on Event Streams that contains the following information:



* The CRN of the root key that you want to use in your key management service instance.
* The CRN of your Event Streams service instance.



You find this CRN by copying and pasting the full IBM Cloud® console URL after you click the Event Streams service in the console. Alternatively, paste in the output from the following CLI command:

ibmcloud resource service-instance NAME

The Event Streams Operations team responds to your support ticket to confirm that your instance of IBM Cloud® is now using a customer-managed key. Expect the enablement to be completed in one business day.

This operation is destructive and results in the loss of all message and topic definitions. For more information, see [deciding to enable customer-managed keys](https://cloud.ibm.com/docs/EventStreams?topic=EventStreams-managing_encryptionconsiderations_keys).





 Using a customer-managed key 

After a customer-managed key is enabled, the cluster operates as normal, but with the following additional capabilities.



 Preventing access to data 

To temporarily prevent access, disable your root key.
ibmcloud plugin install cloud-databases

For a list of commands and usage information, use a command like:

ibmcloud cdb help





 ibmcloud cdb help 

On its own, the ibmcloud cdb help command displays the available top-level commands. When followed by another command, it displays specific help for that command.

ibmcloud cdb help [<command>]



 Command options 

No command-specific options.





 Examples 

Get help on the task-show command.

ibmcloud cdb help task-show







 Deployments and Deployables 

Get information about the deployable databases and database versions on the Cloud Databases platform. Also, get a list of all of the Cloud Databases on your IBM Cloud account.



 ibmcloud cdb deployables-show 

The deployables are the templates available for new database deployments. This command shows deployable database types, specifically the available versions of databases, and their preferred or stable status.

ibmcloud cdb deployables-show [--stable] [--preferred] [--json]

Short version - deployables



 Command options 



* --stable or -s Only list stable versions of databases.
* --preferred or -p Only list preferred versions of databases.
* --json or -j Display results as JSON.







 Examples 

Show all the stable versions of databases available.

ibmcloud cdb deployables-show --stable







 ibmcloud cdb deployments 

Short version - ls

Use this command to list the deployments associated with the account.

ibmcloud cdb deployments [--all] [--json]



 Command options 



* --all or -a Display instance name and CRN.
* --json or -j Display results as JSON.







 Examples 

List all current deployments with an account.

ibmcloud cdb ls







 ibmcloud cdb deployment-about 

Short version - about

Use this command to get details of which database is deployed within the instance, which version, and any options applied.
Storage template feature overview 



Storage template feature comparison

 Name Version Supported providers Encryption at rest Encryption in transit Snapshot support Availability Volume expansion 

 AWS EBS CSI Driver 1.1.0 AWS True True True Zonal True 
 AWS EBS CSI Driver 1.5.1 AWS True True True Zonal True 
 AWS EBS CSI Driver 1.12.0 AWS True True True Zonal True 
 AWS EFS CSI Driver 1.3.1 AWS True True False Regional False 
 AWS EFS CSI Driver 1.3.7 AWS True True False Regional False 
 AWS EFS CSI Driver 1.4.2 AWS True True False Regional False 
 Azure Disk CSI Driver 1.4.0 Azure True True False Zonal False 
 Azure Disk CSI Driver 1.18.0 Azure True True False Zonal False 
 Azure Disk CSI Driver 1.23.0 Azure True True False Zonal False 
 Azure File CSI Driver 1.9.0 Azure True True False Regional False 
 Azure File CSI Driver 1.18.0 Azure True True False Regional False 
 Azure File CSI Driver 1.22.0 Azure True True False Regional False 
 GCP Compute Persistent Disk CSI Driver 1.0.4 Google True True True Zonal False 
 GCP Compute Persistent Disk CSI Driver 1.7.1 Google True True True Zonal False 
 GCP Compute Persistent Disk CSI Driver 1.8.0 Google True True True Zonal False 
 IBM Object Storage Plugin 2.2 IBM 
 IBM System Storage Block CSI driver 1.4.0 IBM False False True Regional True 
 IBM System Storage Block CSI driver 1.5.0 IBM False False True Regional True 
 IBM System Storage Block CSI driver 1.10.0 IBM False False True Regional True 
 IBM System Storage Block CSI driver 1.11.1 IBM False False True Regional True 
 [Beta] IBM VPC Block CSI driver 5.0 IBM 
 Local Storage Operator - Block 4.8 AWS,IBM False False False Zonal False 
 Local Storage Operator - Block 4.9 AWS,IBM False False False Zonal False 
 Local Storage Operator - Block 4.10 AWS,IBM False False False Zonal False 
 Local Storage Operator - Block 4.11 AWS,IBM False False False Zonal False
* [Setting up an IBM Cloud Object Storage service instance](https://cloud.ibm.com/docs/openshift?topic=openshift-utilitiesbackup_restore_setup_object_storage)
* [Using IBM Cloud Object Storage to back up and restore PVC data](https://cloud.ibm.com/docs/openshift?topic=openshift-utilitiesbackup-restore-pvc)



* [Setting up IBM Cloud Monitoring for storage volumes](https://cloud.ibm.com/docs/openshift?topic=openshift-utilitiesmonitor_storage)



* [Troubleshooting persistent storage when an IBM Cloud Monitoring alert is triggered](https://cloud.ibm.com/docs/openshift?topic=openshift-utilitiesmonitor_storage_ts)









 Backing up and restoring storage data 

[Backing up and restoring storage data](https://cloud.ibm.com/docs/openshift?topic=openshift-storage_brstorage_br)





 Enhancing your cluster with Cloud Paks, Operators, and integrations 

[Red Hat OpenShift on IBM Cloud partners](https://cloud.ibm.com/docs/openshift?topic=openshift-service-partnersservice-partners)



* [Portworx](https://cloud.ibm.com/docs/openshift?topic=openshift-service-partnersportworx-parter)



* [Benefits](https://cloud.ibm.com/docs/openshift?topic=openshift-service-partnersportworx-benefits)
* [Integration with Red Hat OpenShift on IBM Cloud](https://cloud.ibm.com/docs/openshift?topic=openshift-service-partnersportworx-integration)
* [Billing and support](https://cloud.ibm.com/docs/openshift?topic=openshift-service-partnersportworx-billing-support)
Changing the default NFS version 

The following customized storage class lets you define the NFS version that you want to provision. For example, to provision NFS version 3.0, replace <nfs_version> with 3.0.

Example for Endurance File Storage for Classic.

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
name: ibmc-file-mount
labels:
kubernetes.io/cluster-service: "true"
provisioner: ibm.io/ibmc-file
parameters:
type: "Endurance"
iopsPerGB: "2"
sizeRange: "[1-12000]Gi"
reclaimPolicy: "Delete"
classVersion: "2"
mountOptions: nfsvers=<nfs_version>

Example for Performance File Storage for Classic.

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
name: ibmc-file-mount
labels:
kubernetes.io/cluster-service: "true"
provisioner: ibm.io/ibmc-file
parameters:
type: "Performance"
classVersion: "2"
sizeIOPSRange: |-
"[20-39]Gi:[100-1000]"
"[40-79]Gi:[100-2000]"
"[80-99]Gi:[100-4000]"
"[100-499]Gi:[100-6000]"
"[500-999]Gi:[100-10000]"
"[1000-1999]Gi:[100-20000]"
"[2000-2999]Gi:[200-40000]"
"[3000-3999]Gi:[200-48000]"
"[4000-7999]Gi:[300-48000]"
"[8000-9999]Gi:[500-48000]"
"[10000-12000]Gi:[1000-48000]"
* [OpenShift Data Foundation](https://cloud.ibm.com/docs/openshift?topic=openshift-storage-planstorage-plan-odf)





[Understanding Kubernetes storage basics](https://cloud.ibm.com/docs/openshift?topic=openshift-kube_conceptskube_concepts)



* [Persistent volumes and persistent volume claims](https://cloud.ibm.com/docs/openshift?topic=openshift-kube_conceptspvc_pv)
* [Dynamic provisioning](https://cloud.ibm.com/docs/openshift?topic=openshift-kube_conceptsdynamic_provisioning)
* [Static provisioning](https://cloud.ibm.com/docs/openshift?topic=openshift-kube_conceptsstatic_provisioning)
* [Storage classes](https://cloud.ibm.com/docs/openshift?topic=openshift-kube_conceptsstorageclasses)
* [Next steps](https://cloud.ibm.com/docs/openshift?topic=openshift-kube_conceptsnext-steps-storage)



[Setting up classic IBM Cloud File Storage for Classic](https://cloud.ibm.com/docs/openshift?topic=openshift-file_storagefile_storage)



* [Quick start for IBM Cloud Classic File Storage for Classic](https://cloud.ibm.com/docs/openshift?topic=openshift-file_storagefile_qs)
* [Deciding on the File Storage for Classic configuration](https://cloud.ibm.com/docs/openshift?topic=openshift-file_storagefile_predefined_storageclass)



* [File storage types](https://cloud.ibm.com/docs/openshift?topic=openshift-file_storagefile-types)
This means that data is stored unevenly across database partitions such that only a subset of data partitions participate in the processing while the rest remain idle. For more information about distribution keys, see [Distribution keys for multi-partitioned plans](https://cloud.ibm.com/docs/Db2whc?topic=Db2whc-distribution_keys).

If you’re using a single-partitioned plan, there’s no need to worry about distribution keys because all of the data is stored on one data partition.
* The Db2 engine includes many registry and environment variables, and database configuration parameters. As a SaaS offering, Db2 Warehouse on Cloud is deployed with preconfigured variables and parameters to optimize performance. Changing any of these settings might result in adverse effects on database operation or performance and is therefore strongly discouraged. If you think your system might benefit from changes to some registry variables, environment variables, or database configuration parameters, open a support case to request guidance from our service experts.
* Storage performance depends on various factors, including RAID configuration and disk striping, network configuration, block size, configured IOPS (input/output operations per second) for network-attached storage, VM hardware configuration and method of storage attachment, clustering and replication methods, and use of storage policies such as encryption, deduplication, and compression. Plan time to test and tune your configuration to meet your storage performance needs.
* Review your vSAN storage policy



* RAID 1 provides better performance and smaller windows of susceptibility to sequential failure, such as shorter rebuild time, than RAID 5. However, RAID 5 has less storage overhead.
* RAID 6 provides protection against dual failures, but requires a minimum of six hosts compared to four hosts for RAID 5.



* To add more storage to your vSAN cluster, you must add new hosts to the cluster or add IBM Cloud Endurance NFS storage instead. Adding disks to the existing hosts is not currently supported.
* If you mount additional IBM Cloud Endurance NFS storage to your cluster, ensure that you follow the architecture guidance and configure host routes to the storage that uses the cluster's NFS port group addresses. You must authorize these addresses, rather than the hosts themselves, to the storage. For more information, see [Attached storage infrastructure management](https://cloud.ibm.com/docs/vmwaresolutions?topic=vmwaresolutions-storage-infra-mgmtstorage-infra-mgmt-vsphere-routing).







 Related links 



* [Overview of VMware Solutions](https://cloud.ibm.com/docs/vmwaresolutions?topic=vmwaresolutions-solution_overview)
* [Design overview](https://cloud.ibm.com/docs/vmwaresolutions?topic=vmwaresolutions-design_overview)
* [Scaling capacity](https://cloud.ibm.com/docs/vmwaresolutions?topic=vmwaresolutions-solution_scaling)
"[2000-2999]Gi:[200-40000]"
"[3000-3999]Gi:[200-48000]"
"[4000-7999]Gi:[300-48000]"
"[8000-9999]Gi:[500-48000]"
"[10000-12000]Gi:[1000-48000]"
type: "Performance"
reclaimPolicy: Delete
volumeBindingMode: Immediate
Show more





 Changing the default NFS version 

The following customized storage class lets you define the NFS version that you want to provision. For example, to provision NFS version 3.0, replace <nfs_version> with 3.0.

Example for Endurance File Storage for Classic.

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
name: ibmc-file-mount
labels:
kubernetes.io/cluster-service: "true"
provisioner: ibm.io/ibmc-file
parameters:
type: "Endurance"
iopsPerGB: "2"
sizeRange: "[1-12000]Gi"
reclaimPolicy: "Delete"
classVersion: "2"
mountOptions: nfsvers=<nfs_version>

Example for Performance File Storage for Classic.

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
name: ibmc-file-mount
labels:
kubernetes.io/cluster-service: "true"
provisioner: ibm.io/ibmc-file
parameters:
type: "Performance"
classVersion: "2"
sizeIOPSRange: |-
"[20-39]Gi:[100-1000]"
"[40-79]Gi:[100-2000]"
"[80-99]Gi:[100-4000]"
"[100-499]Gi:[100-6000]"
Options are: id, username, datacenter, storage_type, capacity_gb, bytes_used, ip_addr,active_transactions, created_by, mount_addr.

--column
: Column to display. Options are: id, username, datacenter, storage_type, capacity_gb, bytes_used, ip_addr, active_transactions,mount_addr, created_by, notes. This option can be specified multiple times.

Examples:

ibmcloud sl file volume-list -d dal09 -t endurance --sortby capacity_gb

This command lists all endurance volumes on the current account that are located in data center dal09, and sorts them by capacity.





 ibmcloud sl file volume-convert 

Convert a dependent duplicate volume to an independent volume:

ibmcloud sl file volume-convert VOLUME_ID

Examples:

ibmcloud sl file volume-convert 12345678

Convert a dependent duplicate 12345678 to an independent volume.





 ibmcloud sl file volume-detail 

Display details for a specified volume:

ibmcloud sl file volume-detail VOLUME_ID

Examples:

ibmcloud sl file volume-detail 12345678

This command shows details of volume with ID 12345678.





 ibmcloud sl file volume-duplicate 

Order a file volume by duplicating an existing volume:

ibmcloud sl file volume-duplicate VOLUME_ID [OPTIONS]

Command options:

-o, --origin-snapshot-id
: ID of an original volume snapshot to use for duplication.

-s, --duplicate-size
: Size of duplicate file volume in GB. If no size is specified, the size of the original volume is used.

-i, --duplicate-iops
: Performance Storage IOPS. Range 100-6000, and in multiples of 100. If no IOPS is specified, the IOPS of the original volume is used.

-t, --duplicate-tier
: Endurance Storage Tier. If no tier is specified, the tier of the original volume is used.
* --storage-affinity value: Affinity policy for storage pool selection. Valid values are "affinity" and "anti-affinity". If --storage-pool is provided then this it cannot be specified.
* --storage-affinity-instance value: PVM instance identifier or name to base storage affinity policy against; required if "--storage-affinity affinity" is specified and --storage-affinity-volume is not provided.
* --storage-affinity-volume value: Volume identifier or name to base storage affinity policy against; required if "--storage-affinity affinity" is specified and --storage-affinity-instance is not provided
* --storage-anti-affinity-instance value: Space separated list of PVM instance identifiers or names to base storage affinity policy against; required if "--storage-affinity anti-affinity" is specified and --storage-anti-affinity-volumes is not provided.
* --storage-anti-affinity-volume value: Space separated list of volume identifiers or names to base storage affinity policy against; required if "--storage-affinity anti-affinity" is specified and --storage-anti-affinity-instances is not provided.
* --pin-policy value: Pin policy ("none", "soft", "hard"). Default is "none".
* --replicants value: Number of duplicate instances to create in this request.
* --replicant-scheme value: Naming scheme to use for duplicate VMs (suffix, prefix).
* --replicant-affinity-policy value: Affinity policy to use when multicreate is used (affinity, anti-affinity).
* --IBMicss-license value: IBMi CSS software license associated with the instance.
* --IBMiDBQ-license value: IBMi DBQ software license associated with the instance.
* --IBMiPHA-license value: IBMi PHA software license associated with the instance.
* --IBMiRDS-users value: Number of IBMi RDS users software license associated with the instance, default IBMiRDSUsers=0 (no license).
* --placement-group value: The placement group ID of the group that the server will be added to.
For more information about network options, see [Network options](https://cloud.ibm.com/docs/bare-metal?topic=bare-metal-network-options).





 Block and file storage add-on 

If you need extra storage, IBM makes it easy! You can now order block and file storage (20 - 12,000 GB) when you provision a bare metal server.

Your add-on storage isn't automatically connected to your bare metal server. You need to connect the add-on storage to your bare metal server after your server provisions.

For more information about block and file storage, see the following links.



* [Getting started with Block Storage](https://cloud.ibm.com/docs/BlockStorage?topic=BlockStorage-getting-started)
* [Getting started with File Storage](https://cloud.ibm.com/docs/FileStorage?topic=FileStorage-getting-started)









 Bare metal server add-ons 

The following add-ons are available when you provision a bare metal server.



Table 5. Bare metal server provisioning options

 Option Description 

 Power supply You can provision your bare metal server with two independent power supply units. These redundant units alternate power sources within the data center to help maintain uptime during unplanned or planned electrical maintenance. 
 IBM Cloud Backup IBM Cloud Backup is an automated, agent-based backup and recovery system that is managed through the Cloud Backup WebCC browser utility. For more information, see [Getting started with IBM Cloud Backup](https://cloud.ibm.com/docs/Backup?topic=Backup-getting-started). 
 Server security Intel Trusted Execution Technology (TXT) provides hardware-assisted security technologies to enhance your security portfolio and act as an extra security for your infrastructure. 
 Business continuance insurance (BCI) Business continuance insurance helps you avoid overage charges if you experience a network attack (DDOS) that uses all of your allowed bandwidth. 
 Firewall A hardware firewall provides an extra layer of security that is provisioned on demand without service interruptions. This firewall prevents unwanted traffic from reaching your servers by reducing your attack surface, and by enabling your server resources to be dedicated for their intended use.
* [Connecting to LUNS on Microsoft® Windows](https://cloud.ibm.com/docs/BlockStorage?topic=BlockStorage-mountingWindows)
* [Mounting a LUN in XenServer Shared Storage](https://cloud.ibm.com/docs/virtualization?topic=virtualization-setting-up-and-mounting-an-iscsi-node-in-xenserver-shared-storage)
* [Configuring Block Storage for backup with cPanel](https://cloud.ibm.com/docs/BlockStorage?topic=BlockStorage-cPanelBackups)
* [Configuring Block Storage for backup with Plesk](https://cloud.ibm.com/docs/BlockStorage?topic=BlockStorage-PleskBackups)







 Disaster recovery considerations 

To avoid data-loss and to ensure business continuity, consider replicating your servers and storage in another data center. Replication keeps your data in sync in two different locations based on your snapshot schedule. For more information, see [Replicating data](https://cloud.ibm.com/docs/BlockStorage?topic=BlockStorage-replication).

If you want to clone your volume and use it independently from the original volume, see [Creating and managing independent duplicate volumes](https://cloud.ibm.com/docs/BlockStorage?topic=BlockStorage-duplicatevolume).

If you want to clone your volume and refresh the duplicate on demand, see [Creating and managing dependent duplicate volumes](https://cloud.ibm.com/docs/BlockStorage?topic=BlockStorage-dependentduplicate).





 Identifying Block Storage for Classic on your invoice 

All LUNs appear on your invoice as a line item. Endurance appears as “Endurance Storage Service” and Performance appears as "Performance Storage Service" The rate varies based on your storage level. You can expand on Endurance or Performance to see that it's Block Storage for Classic.
},{"date":"2022-03-26T16:20:11Z","name":"gate_length","unit":"ns","value":327.1111111111111}],"qubits":8,5]},{"gate":"cx","name":"cx6_7","parameters":{"date":"2022-03-29T06:24:05Z","name":"gate_error","unit":"","value":0.006045323520269763},{"date":"2022-03-26T16:20:11Z","name":"gate_length","unit":"ns","value":327.1111111111111}],"qubits":6,7]},{"gate":"cx","name":"cx7_6","parameters":{"date":"2022-03-29T06:24:05Z","name":"gate_error","unit":"","value":0.006045323520269763},{"date":"2022-03-26T16:20:11Z","name":
","name":"gate_length","unit":"ns","value":320}],"qubits":4,1]},{"gate":"cx","name":"cx1_4","parameters":{"date":"2022-03-29T05:36:07Z","name":"gate_error","unit":"","value":0.008564952951145177},{"date":"2022-03-26T16:20:11Z","name":"gate_length","unit":"ns","value":391.1111111111111}],"qubits":1,4]},{"gate":"cx","name":"cx2_1","parameters":{"date":"2022-03-29T05:27:13Z","name":"gate_error","unit":"","value":0.004980288172714564},{"date":"2022-03-26T16:20:11Z","name":"gate_length","unit":"ns","value":
":15,18]},{"gate":"cx","name":"cx18_15","parameters":{"date":"2022-03-29T07:47:17Z","name":"gate_error","unit":"","value":0.017329520597709702},{"date":"2022-03-26T16:20:11Z","name":"gate_length","unit":"ns","value":448}],"qubits":18,15]},{"gate":"cx","name":"cx19_22","parameters":{"date":"2022-03-29T07:47:17Z","name":"gate_error","unit":"","value":0.00979214064158948},{"date":"2022-03-26T16:20:11Z","name":"gate_length","unit":"ns","value":398.2222222222222}],"qubits":19,22]},{"gate":"cx","name":"cx22_19","parameters
11_14","parameters":{"date":"2022-03-29T06:42:56Z","name":"gate_error","unit":"","value":0.008256839859945575},{"date":"2022-03-26T16:20:11Z","name":"gate_length","unit":"ns","value":348.4444444444444}],"qubits":11,14]},{"gate":"cx","name":"cx14_11","parameters":{"date":"2022-03-29T06:42:56Z","name":"gate_error","unit":"","value":0.008256839859945575},{"date":"2022-03-26T16:20:11Z","name":"gate_length","unit":"ns","value":384}],"qubits":14,11]},{"gate":"cx","name":"cx23_24","parameters":{"date":"2022-03-29T06:42:56Z","
","parameters":{"date":"2022-03-29T05:17:13Z","name":"gate_error","unit":"","value":0.006391025928785515},{"date":"2022-03-26T16:20:11Z","name":"gate_length","unit":"ns","value":337.77777777777777}],"qubits":2,3]},{"gate":"cx","name":"cx0_1","parameters":{"date":"2022-03-29T05:09:13Z","name":"gate_error","unit":"","value":0.004674805929968107},{"date":"2022-03-26T16:20:11Z","name":"gate_length","unit":"ns","value":252.44444444444443}],"qubits":0,1]},{"gate":"cx","name":"cx1_0","parameters":{"date":"2022-03-29T05:09:13Z","name":
":1]},{"gate":"x","name":"x2","parameters":{"date":"2022-03-29T04:47:30Z","name":"gate_error","unit":"","value":0.00023935710621385495},{"date":"2022-03-29T16:20:11Z","name":"gate_length","unit":"ns","value":35.55555555555556}],"qubits":2]},{"gate":"x","name":"x3","parameters":{"date":"2022-03-29T04:47:30Z","name":"gate_error","unit":"","value":0.000301709293328055},{"date":"2022-03-29T16:20:11Z","name":"gate_length","unit":"ns","value":35.55555555555556}],"qubits":3]},{"gate":"x","name":"x4","parameters":{"date":"