Scaling disk, memory, and CPU

Review current resources and hosting model

In the Resources tab, you find both Hosting model and Resource allocations tiles. These tiles reflect your current resources and hosting model. Select Configure to adjust the settings in the Resource allocations tile.

Scaling in the UI

In the Resources tab of the UI, select Configure on the Resource allocations tile. This opens up a panel where you can adjust your resources.

If your database is on the Isolated Compute hosting model, you then see a "Host sizes" table, where you can select the vCPU and RAM configuration per member for your database.

The "Disk (GB/member)" slider is your disk selection per member. Drag the slider or adjust the number in the input box to change the number of GB disk. Note that disk is tied to IOPS at 1 GB = 5 IOPS.

Members is the number of members of your database. For MongoDB, members are set to 3.

Review your total estimated cost in the calculator on the bottom.

After you are done, click Apply changes to trigger the scaling operation.

Review current resources and hosting model

To interact with Cloud Databases on Gen 2 via the CLI you must utilize the IBM Cloud Resource Controller's CLI. For more information, see the General IBM Cloud CLI (ibmcloud) commands. To get information about a particular instance, use the following command:

ibmcloud resource service-instance <INSTANCE_NAME> -o JSON

Resources and scaling in the CLI

To update your instance (this includes operations, such as scaling and modifying other parts of your service), use the ibmcloud resource service-instance-update command.

ibmcloud resource service-instance-update <INSTANCE_NAME> -p '<{FIELDS_TO_UPDATE}>'

For example, to update the host_flavor of a Databases for MongoDB instance, use a command like:

ibmcloud resource service-instance-update test-database databases-for-mongodb standard us-south -p '{"host_flavor": "mx3d.8x80.encrypted", "storage_gb": 10 }'

Review current resources and hosting model

The Foundation endpoint that is shown on the Overview panel of your service provides the base URL to access this deployment through the API. Use it with the /groups endpoint if you need to manage or automate scaling programmatically.

To view the current and scalable resources on a deployment, use the /deployments/{id}/groups endpoint.

curl -X GET https://api.{region}.databases.cloud.ibm.com/v5/ibm/deployments/{id}/groups -H 'Authorization: Bearer <>' \

Scaling with the API

To scale the host_flavor of a deployment to mx3d.8x80.encrypted for each memory member, use the following command:

curl -X POST https://resource-controller.cloud.ibm.com/v2/resource_instances
-H 'Authorization: Bearer <>'
-H 'Content-Type: application/json'
-d '{
   "name": "my-instance",
    "target": "ca-mon",
    "resource_group": "5c49eabc-f5e8-5881-a37e-2d100a33b3df",
    "resource_plan_id": "databases-for-mongodb-standard",
    "dataservices": {
      "resources": {
        "database": {
          "host_flavor": "mx3d.8x80.encrypted"
        }
      }
     }
   }'

For more information, see the API reference.

Review current resources and hosting model

Review resource allocations to your database by checking your Terraform scripts for cpu { allocation_count = }, memory {allocation_mb = }, and disk { allocation_mb = }.

Scaling with Terraform

Before executing a Terraform script on an existing instance, use the terraform plan command to compare the current infrastructure state with the desired state defined in your Terraform files. Any alteration to the resource_group_id, service plan, version, key_protect_instance, key_protect_key, backup_encryption_key_crn attributes recreates your instance. For a list of current argument references with the Forces new resource specification, see the ibm_database Terraform Registry.

Scale your instance by adjusting your Terraform script for the resource you're interested in. In the following example, host_flavor and disk allocations are specified.

To implement your change, run terraform apply.

data "ibm_resource_group" "group" {
  name = "<your_group>"
}
resource "ibm_database" "<your_database>" {
  name              = "<your_database_name>"
  plan              = "databases-for-mongodb-gen2-standard"
  location          = "eu-gb"
  service           = "databases-for-mongodb"
  resource_group_id = data.ibm_resource_group.group.id
  tags              = ["tag1", "tag2"]
  adminpassword     = "password12"
  group {
    group_id = "member"
    cpu {
      allocation_count = 6
    }
    memory {
      allocation_mb = 24576
    }
    disk {
      allocation_mb = 256000
    }
  }
  users {
    name     = "user123"
    password = "password12"
  }
  allowlist {
    address     = "172.168.1.1/32"
    description = "desc"
  }
}
output "ICD MongoDB database connection string" {
  value = "http://${ibm_database.test_acc.ibm_database_connection.icd_conn}"
}