Oracle Cloud Infrastructure Documentation

Resizing a Cluster Network with Instance Pools

Change the number of instances in a cluster network by resizing the underlying instance pool.

When you increase the size, instances are provisioned until the required number of instances in the instance pool are launched, subject to host capacity for nodes in the cluster's RDMA network.

When you decrease the size, instances are terminated (deleted) in the order that they were created, first-in, first-out. To remove a specific instance from the cluster network, you can detach the instance from the cluster network.

To determine whether capacity is available for a specific shape before you resize a cluster network, use the CreateComputeCapacityReport operation.

Note

The cluster network must be in the Running state to be resized.
    1. On the Compute Cluster Networks list page, select the cluster network that you want to manage. If you need help finding the list page, see Listing Cluster Networks.
    2. Select Edit.
    3. Number of instances: Specify the updated number of instances for the instance pool.
    4. Select Save changes.
    Tip

    To track the progress of the operation and troubleshoot errors that occur during instance creation, use the associated work request.

  • To resize a cluster network, you can use the instance-pool update command to resize the underlying instance pool to increase or decrease the size of the instance pool. You can also detach or attach an instance to change the pool size.

    oci compute-management instance-pool update --instance-pool-id <INSTANCE_POOL_OCID> --size <NUMBER>
    oci compute-management instance-pool-instance attach --from-json <file://path/to/file.json>
    oci compute-management instance-pool-instance detach --from-json <file://path/to/file.json>

    <file://path/to/file.json> is the path to a JSON file that defines the instance details. For information about how to generate an example of the JSON file, see Advanced JSON Options.

    For a complete list of flags and variable options for the Compute service CLI commands, see the command line reference for Compute.

  • For information about using the API and signing requests, see REST API documentation and Security Credentials. For information about SDKs, see SDKs and the CLI.

    To resize a cluster network's underlying instance pool, use the following API operations: