Oracle Cloud Infrastructure Documentation

Creating a Cluster Network with Instance Pools

Create a cluster network with instance pools.

Cluster networks are built on top of the instance pools feature. Most operations in the instance pool are managed directly by the cluster network, though you can resize the underlying instance pool, change the instance configuration that the pool uses to create new instances, monitor the pool, and add tags. For background information, see Cluster Networks with Instance Pools.

Tip

If you want to manage instances in the RDMA network independently of each other or use different types of instances in the network group, then use compute clusters instead.
Note

For information about permissions and prerequisites, see Required IAM Policy and Before You Begin.

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

    1. Open the navigation menu and click Compute. Under Compute, click Cluster Networks.
    2. Click Create cluster network.
    3. Accept the default name or enter a name for the cluster network. It doesn't have to be unique, and you can change it later. Avoid entering confidential information.
    4. Select the compartment in which to create the cluster network.
    5. Select the availability domain in which to run the cluster network. You can select only the availability domains that have hardware that supports cluster networks.
    6. In the Configure networking section, specify the network that you want to use to administer the cluster network. This network is separate from the closed RDMA network between nodes within the cluster. Enter the following information:
      • Virtual cloud network in compartment: The virtual cloud network (VCN) for the cluster network.
      • Subnet in compartment: The subnet for the cluster network.
    7. In the Configure instance pool section, enter the following information:
      • Instance pool name in compartment: A name for the instance pool that is managed by the cluster network. Avoid entering confidential information.
      • Number of instances: The number of instances in the pool.
      • Instance configuration in compartment: Select the instance configuration to use when creating instances in the cluster network's instance pool, as described in the prerequisites.
    8. (Optional) Click Show tagging options to add tags to the cluster network.
      If you have permissions to create a resource, then you also have permissions to apply free-form tags to that resource. To apply a defined tag, you must have permissions to use the tag namespace. For more information about tagging, see Resource Tags. If you're not sure whether to apply tags, skip this option or ask an administrator. You can apply tags later.
    9. Click Create cluster network.

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

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

  • Use the cluster-network create command and required parameters to create a cluster network.

    oci compute-management cluster-network create [OPTIONS]

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

  • Use the CreateClusterNetwork operation to create a cluster network.