Modify a Cluster

    +
    Modify and scale clusters after they have been created.

    To perform any of the procedures on this page, you must have Project Edit privileges for the project that contains the cluster that you wish to modify.

    Add a New Service to a Cluster

    Limitations

    You cannot add new services to clusters that were deployed using the Quick Start template — the Add Service button will not be present in the cluster’s Services tab. Likewise, you cannot add a particular service to a cluster if that service is already deployed on that cluster.

    1. Go to the cluster’s Services tab.

      1. Go to the Clusters tab in the main navigation.

      2. Find and click on the cluster that you wish to modify.

        This opens the cluster with its Overview tab selected.

      3. Click the Services tab.

    2. Click Add Service.

      This opens the Add Service fly-out menu.

    3. Configure the service.

      In the Add Service fly-out menu, configure the following fields:

      Service

      Select the Couchbase service that you wish to add. Only services that are not already deployed on the cluster will be available for selection.

      Capacity

      Select one of the available compute instance types. The compute instance type you choose will be used for each node in the service configuration.

      Number of Nodes

      Select the number of nodes having the current configuration that you wish to add to the cluster.

      Storage

      Enter the desired amount of storage for the service.

      For more information about the above fields, refer to Sizing a Cluster.

    4. Once you’re satisfied with the service configuration, click Add Service.

    5. In the notification that appears, click Deploy Now.

      The cluster will begin to rebalance so that the service’s data gets re-distributed over the new superset of nodes. The amount of time it takes for the new nodes to rebalance into the cluster is dependent on both the service of the new node, as well as how much data needs to be redistributed. During the rebalance, existing cluster services will remain available.

    Modify an Existing Service Configuration

    Limitations

    You cannot modify existing services on clusters that were deployed using the Quick Start template — these services will not be clickable in the cluster’s Services tab.

    You cannot decrease the number of nodes of an existing service.

    You cannot change the capacity (VM instance type) or storage of service nodes.

    1. Go to the cluster’s Services tab.

      1. Go to the Clusters tab in the main navigation.

      2. Find and click on the cluster that you wish to modify.

        This opens the cluster with its Overview tab selected.

      3. Click the Services tab.

    2. Click on a node that is running the service that you wish to modify.

      This opens the Edit Service fly-out menu.

    3. Edit the service configuration.

      You can edit the following configuration details:

      Number of Nodes

      Select the desired number of nodes that you wish to scale the service to.

      For more information about the above fields, refer to Sizing a Cluster.

    4. When you’re satisfied with the new service configuration, click Save.

    5. In the notification that appears, click Deploy Now.

      The cluster will begin to rebalance so that the service’s data gets re-distributed over the new superset of nodes. For example, if you added a new node to the Data Service, then whatever active and replica vBuckets were previously distributed across the existing Data nodes will be redistributed across the new superset of Data nodes created by the addition.

      The amount of time it takes for the new nodes to rebalance into the cluster is dependent on both the service of the new node, as well as how much data needs to be redistributed. During the rebalance, cluster services will remain available.

    Remove a Service from a Cluster

    Removing a service from a cluster is not currently supported.

    Rename a Cluster

    1. From the Clusters tab, find the cluster that you wish rename, and click on its row.

      This opens the cluster with its Overview tab selected.

    2. Click the vertical ellipsis to the right of the cluster’s name. In the drop-down menu that appears, click Edit Cluster Name.

    3. Enter a new name for the cluster.

    4. Once you’ve finished entering a new name for the cluster, click Save.

    5. In the notification that appears, click Deploy Now.

      The cluster will initiate a minor re-redeployment process, during which cluster services will remain available.