vania-janet/multiturn-rag-retrieval-data huggingface dataset:
Table 1. Service availability - Americas
Use the buttons for the countries to change the context of the table. This table has row and column headers. The row headers identify the service. The column headers identify where that service is located. To understand where a service is located in the table, navigate to the row, and find the for the location you are interested in.

 Service Dallas Washington DC Toronto Sao Paulo 

 API Connect ![Checkmark icon](https://cloud.ibm.com/docs-content/v1/content/adcecdbe4e86955f88aac7f3c1e7ec3ff44992ef/icons/checkmark-icon.svg) ![Checkmark icon](https://cloud.ibm.com/docs-content/v1/content/adcecdbe4e86955f88aac7f3c1e7ec3ff44992ef/icons/checkmark-icon.svg) ![Checkmark icon](https://cloud.ibm.com/docs-content/v1/content/adcecdbe4e86955f88aac7f3c1e7ec3ff44992ef/icons/checkmark-icon.svg) ![Checkmark icon](https://cloud.ibm.com/docs-content/v1/content/adcecdbe4e86955f88aac7f3c1e7ec3ff44992ef/icons/checkmark-icon.svg) 
 Analytics Engine ![Checkmark icon](https://cloud.ibm.com/docs-content/v1/content/adcecdbe4e86955f88aac7f3c1e7ec3ff44992ef/icons/checkmark-icon.svg) 
 App Configuration !
With the current generation of plans hosted on AWS, you can scale storage up or down. The ability to scale storage down allows you to reduce your costs as you move data from more expensive block storage to less expensive cloud storage. With all other plans, you can only scale storage up.

You can also enable auto-scaling for your storage. When you enable autoscaling, the storage on your Db2 Warehouse on Cloud instance will automatically be scaled up if your storage use exceeds the threshold you specify. The following screenshot shows the auto-scaling panel in the console for a Db2 Warehouse on Cloud Flex instance hosted on IBM Cloud.

Zoom

![Storage autoscaling tab](https://cloud.ibm.com/docs-content/v1/content/68e10678b2f8b8694884ecb5442c326c9b60a3fb/Db2whc/images/scaling2.png)

Figure 2. A screenshot of the autoscaling tab

Scaling storage up is an online operation. Scaling storage down requires downtime.
* UI
* CLI
* API
* Terraform







 Managing replica file shares 

Manage replica file shares by removing the replication relationship to create two independent file shares. The replica file share becomes read/write, and you can update and delete the share.

IBM Cloud® File Storage for VPC is available for customers with special approval to preview this service in the Frankfurt, London, Madrid, Dallas, Toronto, Washington, Sao Paulo, Sydney, Osaka, and Tokyo regions. Contact your IBM Sales representative if you are interested in getting access.

You need Administrator or Editor IAM user roles to create and manage file share replicas and the replication relationship. For a list of these roles and actions, see [IAM roles for creating and managing file shares](https://cloud.ibm.com/docs/vpc?topic=vpc-file-storage-managing&interface=uifile-storage-vpc-iam).



 Remove the replication relationship 

You can remove replication by removing the replication relationship between the source file share and replica file share. The operation is called splitting the file shares. Data is no longer synced between the file shares. Removing the replication relationship creates two independent, read/write file shares. You can separately manage each file share, expand capacity and adjust IOPS, and create replicas.

Use the [UI](https://cloud.ibm.com/docs/vpc?topic=vpc-file-storage-manage-replication&interface=apifs-remove-replication-ui), [CLI](https://cloud.ibm.com/docs/vpc?topic=vpc-file-storage-manage-replication&interface=apifs-remove-replication-cli), or [API](https://cloud.ibm.com/docs/vpc?topic=vpc-file-storage-manage-replication&interface=apifs-remove-replication-api) to remove the replication relationship. You can also specify that the source and replica file shares are split if a [failover](https://cloud.ibm.com/docs/vpc?topic=vpc-file-storage-failover) operation does not succeed.
* [Managing Snapshots](https://cloud.ibm.com/docs/FileStorage?topic=FileStorage-managingSnapshots)

slcli file snapshot-cancel
slcli file snapshot-create
slcli file snapshot-delete
slcli file snapshot-disable
slcli file snapshot-enable
slcli file snapshot-list
slcli file snapshot-restore







 Volume-related SLCLI commands 



* [Ordering a File Storage for Classic volume](https://cloud.ibm.com/docs/FileStorage?topic=FileStorage-orderingFileStorageorderingthroughCLI)

slcli file volume-order
* [Adjusting the IOPS](https://cloud.ibm.com/docs/FileStorage?topic=FileStorage-adjustingIOPS)

slcli file volume-modify
* [Expanding the capacity](https://cloud.ibm.com/docs/FileStorage?topic=FileStorage-expandCapacity)

slcli file volume-modify
* [Managing File Storage for Classic](https://cloud.ibm.com/docs/FileStorage?topic=FileStorage-managingstorage)

slcli file volume-cancel
slcli file volume-count
slcli file volume-detail
slcli file volume-duplicate
slcli file volume-list
slcli file volume-order
* [Creating and managing duplicate volumes](https://cloud.ibm.com/docs/FileStorage?topic=FileStorage-duplicatevolume)

slcli file volume-duplicate
slcli file volume-duplicate --dependent-duplicate TRUE <independent-vol-id>
slcli file volume-refresh <duplicate-vol-id> <parent-vol-snapshot-id>
slcli file volume-convert <dependent-vol-id>
slcli file duplicate-convert-status <dependent-vol-id>
[Setting capacity quotas for apps that use IBM Cloud Object Storage](https://cloud.ibm.com/docs/openshift?topic=openshift-storage-cos-tutorial-quotastorage-cos-tutorial-quota)



* [Objectives](https://cloud.ibm.com/docs/openshift?topic=openshift-storage-cos-tutorial-quotastorage-cos-quota-objectives)
* [Prerequisites](https://cloud.ibm.com/docs/openshift?topic=openshift-storage-cos-tutorial-quotastorage-cos-quota-prereqs)
* [Creating a set of service credentials](https://cloud.ibm.com/docs/openshift?topic=openshift-storage-cos-tutorial-quotastorage-cos-quota-credentials)
* [Creating a secret to store your credentials](https://cloud.ibm.com/docs/openshift?topic=openshift-storage-cos-tutorial-quotastorage-cos-quota-secret)
* [Installing the plug-in](https://cloud.ibm.com/docs/openshift?topic=openshift-storage-cos-tutorial-quotastorage-cos-quota-install)
* [Dynamically provisioning a bucket with a quota](https://cloud.ibm.com/docs/openshift?topic=openshift-storage-cos-tutorial-quotastorage-cos-quota-create-bucket)
* [Uploading a file to your bucket](https://cloud.ibm.com/docs/openshift?topic=openshift-storage-cos-tutorial-quotastorage-cos-quota-create-file)
* [Creating an app that mounts the bucket](https://cloud.ibm.com/docs/openshift?topic=openshift-storage-cos-tutorial-quotastorage-cos-quota-create-app)
You can describe storage classes in the command line with the oc describe sc <storage-class-name> command.



Table 10. NetApp ONTAP-SAN storage class reference.

 Storage class name Type File system Reclaim policy 

 sat-netapp-block-goldDefault ONTAP-SAN Block Delete 
 sat-netapp-block-silver ONTAP-SAN Block Delete 
 sat-netapp-block-bronze ONTAP-SAN Block Delete 







 OpenShift Data Foundation for local volumes 

Review the Satellite storage classes for OpenShift Data Foundation. You can describe storage classes in the command line with the oc describe sc <storage-class-name> command.



Table 11. NetApp ONTAP-SAN storage class reference.

 Storage class name Type File system Provisioner Volume binding mode Allow volume expansion Reclaim policy 

 sat-ocs-cephrbd-gold Block ext4 openshift-storage.rbd.csi.ceph.com Immediate True Delete 
 sat-ocs-cephfs-gold File N/A openshift-storage.cephfs.csi.ceph.com Immediate True Delete 
 sat-ocs-cephrgw-gold Object N/A openshift-storage.ceph.rook.io/bucket Immediate N/A Delete 
 sat-ocs-noobaa-goldDefault OBC N/A openshift-storage.noobaa.io/obc Immediate N/A Delete 
 sat-ocs-cephrbd-gold-metro Block ext4 openshift-storage.rbd.csi.ceph.com WaitForFirstConsumer True Delete 
 sat-ocs-cephfs-gold-metro File N/A openshift-storage.cephfs.csi.ceph.com WaitForFirstConsumer True Delete 







 OpenShift Data Foundation for remote volumes 

Review the Satellite storage classes for OpenShift Data Foundation. You can describe storage classes in the command line with the oc describe sc <storage-class-name> command.



Table 12. Storage class reference for OpenShift Container storage
* UI
* CLI
* API
* Terraform







 Managing replica file shares 

Manage replica file shares by removing the replication relationship to create two independent file shares. The replica file share becomes read/write, and you can update and delete the share.

IBM Cloud® File Storage for VPC is available for customers with special approval to preview this service in the Frankfurt, London, Madrid, Dallas, Toronto, Washington, Sao Paulo, Sydney, Osaka, and Tokyo regions. Contact your IBM Sales representative if you are interested in getting access.

You need Administrator or Editor IAM user roles to create and manage file share replicas and the replication relationship. For a list of these roles and actions, see [IAM roles for creating and managing file shares](https://cloud.ibm.com/docs/vpc?topic=vpc-file-storage-managing&interface=uifile-storage-vpc-iam).



 Remove the replication relationship 

You can remove replication by removing the replication relationship between the source file share and replica file share. The operation is called splitting the file shares. Data is no longer synced between the file shares. Removing the replication relationship creates two independent, read/write file shares. You can separately manage each file share, expand capacity and adjust IOPS, and create replicas.

Use the [UI](https://cloud.ibm.com/docs/vpc?topic=vpc-file-storage-manage-replication&interface=clifs-remove-replication-ui), [CLI](https://cloud.ibm.com/docs/vpc?topic=vpc-file-storage-manage-replication&interface=clifs-remove-replication-cli), or [API](https://cloud.ibm.com/docs/vpc?topic=vpc-file-storage-manage-replication&interface=clifs-remove-replication-api) to remove the replication relationship. You can also specify that the source and replica file shares are split if a [failover](https://cloud.ibm.com/docs/vpc?topic=vpc-file-storage-failover) operation does not succeed.
* UI
* CLI
* API
* Terraform







 Managing replica file shares 

Manage replica file shares by removing the replication relationship to create two independent file shares. The replica file share becomes read/write, and you can update and delete the share.

IBM Cloud® File Storage for VPC is available for customers with special approval to preview this service in the Frankfurt, London, Madrid, Dallas, Toronto, Washington, Sao Paulo, Sydney, Osaka, and Tokyo regions. Contact your IBM Sales representative if you are interested in getting access.

You need Administrator or Editor IAM user roles to create and manage file share replicas and the replication relationship. For a list of these roles and actions, see [IAM roles for creating and managing file shares](https://cloud.ibm.com/docs/vpc?topic=vpc-file-storage-managing&interface=uifile-storage-vpc-iam).



 Remove the replication relationship 

You can remove replication by removing the replication relationship between the source file share and replica file share. The operation is called splitting the file shares. Data is no longer synced between the file shares. Removing the replication relationship creates two independent, read/write file shares. You can separately manage each file share, expand capacity and adjust IOPS, and create replicas.

Use the [UI](https://cloud.ibm.com/docs/vpc?topic=vpc-file-storage-manage-replicationfs-remove-replication-ui), [CLI](https://cloud.ibm.com/docs/vpc?topic=vpc-file-storage-manage-replicationfs-remove-replication-cli), or [API](https://cloud.ibm.com/docs/vpc?topic=vpc-file-storage-manage-replicationfs-remove-replication-api) to remove the replication relationship. You can also specify that the source and replica file shares are split if a [failover](https://cloud.ibm.com/docs/vpc?topic=vpc-file-storage-failover) operation does not succeed.
<orderData xsi:type="ns1:SoftLayer_Container_Product_Order_Network_Storage_AsAService_Upgrade">
<volume xsi:type="ns1:SoftLayer_Network_Storage">
<id xsi:type="xsd:int">XXXXXXXX</id> <!--Where XXXXXXXX is the VolumeID -->
</volume>
<packageId xsi:type="xsd:int">759</packageId>
<volumeSize xsi:type="xsd:int">25</volumeSize> 
<prices SOAP-ENC:arrayType="ns1:SoftLayer_Product_Item_Price[3]" xsi:type="SOAP-ENC:Array">
<item xsi:type="ns1:SoftLayer_Product_Item_Price">
<id xsi:type="xsd:int">189433</id> 
</item>
<item xsi:type="ns1:SoftLayer_Product_Item_Price">
<id xsi:type="xsd:int">196033</id> 
</item>
<item xsi:type="ns1:SoftLayer_Product_Item_Price">
<id xsi:type="xsd:int">196093</id> 
</item>
</prices>
</orderData>
</ns1:placeOrder>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>



Unmount, then mount the modified volume, so the OS can recognize the extra storage space.





 Resizing storage with Terraform 

You can increase your storage capacity by using the ibm_storage_file resource, and specifying a different number in the capacity argument. The following example increases the capacity of an Endurance volume to 40 GB.

resource "ibm_storage_file" "fs_endurance" {
type = "Endurance"
datacenter = "dal09"
capacity = 40
Enter a new name for your storage assignment.

-f
: Optional. Force the command to run with no user prompts.

-q
: Optional. Do not show the message of the day or update reminders.





 Example 

ibmcloud sat storage assignment update --assignment ASSIGNMENT --group GROUP --name NAME [-f] [-q]







 ibmcloud sat storage assignment upgrade 

Upgrade a Satellite storage assignment. You can use the assignment upgrade command to upgrade a Satellite storage assignment to the latest storage configuration version.

ibmcloud sat storage assignment upgrade --assignment ASSIGNMENT [-f] [-q]



 Minimum required permissions 

IBM Cloud IAM Viewer platform role for the Resource resource in Satellite. For more information, see [Checking user permissions](https://cloud.ibm.com/docs/satellite?topic=satellite-iam-assign-accesschecking-perms).





 Command options 

--assignment ASSIGNMENT
: Required. The name of the storage assignment. To list storage assignments, run ibmcloud sat storage assignment ls.

-f
: Optional. Force the command to run with no user prompts.

-q
: Optional. Do not show the message of the day or update reminders.





 Example 

ibmcloud sat storage assignment upgrade --assignment my-storage-assignment







 ibmcloud sat storage config create 

Create a Satellite storage configuration that you can assign to your clusters to install storage drivers in your clusters.

Before you can use storage templates and configurations to manage your storage resources across locations and clusters, make sure you [Set up Satellite Config](https://cloud.ibm.com/docs/satellite?topic=satellite-setup-clusters-satconfig).

ibmcloud sat storage config create --location LOCATION --name NAME --template-name NAME [--template-version VERSION] [--param PARAM ...] [-q] [--source-branch BRANCH] [--source-org ORG]



 Minimum required permissions 

IBM Cloud IAM Editor platform role for the Configuration resource in Satellite.
A Space has its own set of management capabilities, so that each team can manage their APIs independently.

When you stage or publish an API to a Catalog that has Spaces enabled, you specify the Space within that Catalog that you want to stage or publish to. However, application developers that access the Developer Portal for the Catalog are unaware of the Space partitioning of the Catalog and see the APIs as a coordinated offering. Each Space has its own Product lifecycle management, subscription approvals, and analytics data. Use Space-specific access control to restrict user access to each Space; for example, a developer in the Flights team is able to stage APIs only to the Flights Space.

Note: By default, Spaces are disabled in a Catalog. You enable Spaces by modifying the Catalog settings.

To partition a catalog, see [Partitioning a catalog](https://cloud.ibm.com/docs/apiconnect?topic=apiconnect-create_catalogapic_spaces-create_catalog).
Example request to create a version 4.11 configuration.

curl -X POST "https://containers.cloud.ibm.com/global/v2/storage/satellite/createStorageConfigurationByController" -H "accept: application/json" -H "Authorization: TOKEN" -H "Content-Type: application/json" -d "{ "config-name": "string", "controller": "string", "storage-class-parameters": [ { "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } ], "storage-template-name": "odf-remote", "storage-template-version": "4.11", "update-assignments": true, "user-config-parameters": { "entry.name": "OSD-SIZE", { "entry.name": "OSD-STORAGE-CLASS", { "entry.name": "NUM-OF-OSD", { "entry.name": "WORKER-NODES", { "entry.name": "ODF-UPGRADE", { "entry.name": "BILLING-
Example request to create a version 4.11 configuration.

curl -X POST "https://containers.cloud.ibm.com/global/v2/storage/satellite/createStorageConfigurationByController" -H "accept: application/json" -H "Authorization: TOKEN" -H "Content-Type: application/json" -d "{ "config-name": "string", "controller": "string", "storage-class-parameters": [ { "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } ], "storage-template-name": "odf-local", "storage-template-version": "4.11", "update-assignments": true, "user-config-parameters": { "entry.name": "AUTO-DISCOVER-DEVICES", { "entry.name": "OSD-DEVICE-PATH", { "entry.name": "NUM-OF-OSD", { "entry.name": "WORKER-NODES", { "entry.name": "ODF-UPGRADE", { "entry.name": "BILLING
Editing a portable storage description 

You can view portable storage volumes (PSVs) in the IBM Cloud® console. The portable storage page displays the PSV's description, location, capacity, and device name to which the PSV is associated. You can update the description at any time. Update each PSV description to a unique identifier related to the use of the PSV.



  Before you begin 

First, go to the storage menu and make sure that you have the correct account permissions to complete the task.



*  Go to your console's storage menu. For more information, see [Navigating to devices](https://cloud.ibm.com/docs/virtual-servers?topic=virtual-servers-navigating-devices).
*  Make sure that you have any necessary account permissions and device access. Only the account owner, or a user with the Manage Users Classic infrastructure permission, can adjust the permissions.



For more information about permissions, see [Classic infrastructure permissions](https://cloud.ibm.com/docs/account?topic=account-infrapermission) and [Managing device access](https://cloud.ibm.com/docs/virtual-servers?topic=virtual-servers-managing-device-access).





  Editing a portable storage description 



1.  From the Storage menu, select Block Storage.
2.  In the Portable storage section, locate the portable storage volume that you want to edit. Use the Filter portable storage tool to quickly locate a volume.
3.  Click the Description section for the portable storage volume to open the description for edits.
4.  Enter or revise the content in the Description field, as necessary.
5.  Click anywhere in the row that contains the PSV to save the edited description.







  Next steps 

After you edit the description for a PSV, it remains in its original location in the list until you exit the portable storage page. When you reopen the page, the PSV appears in a new location, based on the description's alphabetical order. If the PSV isn't located in this list after the screen relaunches, hold Ctrl and click Refresh to clear the browser's cache and try again. You can change the description again at any time by repeating the previous steps.
ibmcloud sat storage config sc add --config ocs-config --name my-sc --param key=value --param key=value







 ibmcloud sat storage config sc get 

Get the details of a custom storage class in a Satellite storage configuration.

ibmcloud sat storage config sc get --config CONFIG --sc SC [--output OUTPUT] [-q]



 Minimum required permissions 

IBM Cloud IAM Viewer platform role for the Configuration resource in Satellite. For more information, see [Checking user permissions](https://cloud.ibm.com/docs/satellite?topic=satellite-iam-assign-accesschecking-perms).





 Command options 

--config CONFIG
: Required. The name of the storage configuration that you want to get storage class details from. To list Satellite storage configurations, run ibmcloud sat storage config ls.

--sc
: Required. The custom storage class that you want to retrieve. To list the storage classes of a Satellite storage configuration, run ibmcloud sat storage config sc ls.

--output JSON
: Optional. Displays the command output in JSON format.

-q
: Optional. Do not show the message of the day or update reminders.





 Example 

ibmcloud sat storage config sc get --config ocs-config --sc my-sc







 ibmcloud sat storage config sc ls 

List the custom storage classes in a Satellite storage configuration.

ibmcloud sat storage config sc ls --config CONFIG [-q]



 Minimum required permissions 

IBM Cloud IAM Viewer platform role for the Configuration resource in Satellite. For more information, see [Checking user permissions](https://cloud.ibm.com/docs/satellite?topic=satellite-iam-assign-accesschecking-perms).





 Command options 

--config CONFIG
: Required. The name of the storage configuration that you want to retrieve storage classes from.
Reviewing resources that are managed by Satellite Config 

You can use Satellite Config to review the Kubernetes resources that run in your registered clusters.

Before you begin, make sure that you have the [required permissions](https://cloud.ibm.com/docs/satellite?topic=satellite-iamiam-resource-config). For more information, see [Checking user permissions](https://cloud.ibm.com/docs/satellite?topic=satellite-iam-assign-accesschecking-perms).



 Enabling Watch-keeper collection methods 

Review the [Watch-keeper collection methods](https://github.com/razee-io/WatchKeepercollection-methods) to decide how to set up Watch-keeper for your resources. Common use cases include,



 Watch all the resources that my Satellite subscription creates 



1. [Add a ConfigMap](https://github.com/razee-io/WatchKeeperwatch-by-resource) to the YAML file of your Satellite configuration version.
2. In the metadata.namespace field of the ConfigMap, set the value to razeedeploy.
3. In the data section of the ConfigMap, add all the resources that you want Satellite Config to watch.
4. Subscribe your clusters to this version from the [console](https://cloud.ibm.com/docs/satellite?topic=satellite-satcon-manage-direct-upload) or [CLI](https://cloud.ibm.com/docs/satellite?topic=satellite-satcon-manage-direct-upload&interface=cli).







 Watch a particular resource in my Satellite Config version 



1. In the metadata.labels field of the Kubernetes resource in your Satellite Config version, set the value to razee/watch-resource=lite.
2.
Example request to create a version 4.10 configuration.

curl -X POST "https://containers.cloud.ibm.com/global/v2/storage/satellite/createStorageConfigurationByController" -H "accept: application/json" -H "Authorization: TOKEN" -H "Content-Type: application/json" -d "{ "config-name": "string", "controller": "string", "storage-class-parameters": [ { "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } ], "storage-template-name": "odf-remote", "storage-template-version": "4.10", "update-assignments": true, "user-config-parameters": { "entry.name": "OSD-SIZE", { "entry.name": "OSD-STORAGE-CLASS", { "entry.name": "NUM-OF-OSD", { "entry.name": "WORKER-NODES", { "entry.name": "ODF-UPGRADE", { "entry.name": "BILLING-