Use YugabyteDB Anywhere to modify a universe

YugabyteDB Anywhere supports both horizontal and vertical scaling of your universe. If your workloads have increased, you can change to more powerful instance types or add nodes to improve latency, throughput, and memory. Likewise, if your cluster is over-scaled, you can reduce nodes to reduce costs.

-> For information on changing configuration flags, refer to Edit configuration flags.

-> For information on changing user tags, refer to Create and edit instance tags.

-> For information on changing Kubernetes overrides, refer to Edit Kubernetes overrides.

Edit a universe

To change the configuration of a universe, do the following:

1. Navigate to your universe and choose Actions > Edit Universe to display the Edit universe page.

2. Update the configuration.

   Using the Edit Universe page, you can modify the following:

   • Cloud Configuration

     • Regions - Select any region configured in the provider used to deploy the universe.
     • Master Placement.
     • Total Nodes and Availability Zones - As you add nodes, they are automatically distributed among the availability zones; you can also add, configure, and remove availability zones.

   • Instance Configuration

     • Instance Type and Volume Info Size - Change instance type and storage volume size as configured in the provider. In some cases, these operations are available as a smart resize.
     • Storage Type and Volume Info Count - For cloud providers, you can also change the storage volume count and type. On AWS, you can additionally change throughput and IOPS.

   • Advanced Configuration

     • Override Deployment Ports - You can change the Master and TServer HTTP and RPC ports, and the Prometheus Node Exporter port.

   • User Tags. Changing tags doesn't require any node restarts or data migration.

   Note that you can't change the replication factor of a universe.

3. Click Save.

YugabyteDB automatically ensures that new nodes start hosting the tablet leaders for a set of tablets in such a way that the tablet leader count remains evenly balanced across all the available nodes.

To change the number of nodes of universes created with an on-premises provider and secured with third-party certificates obtained from external certification authorities, you must first add the certificates to the nodes you will add to the universe. Refer to Add certificates. Ensure that the certificates are signed by the same external CA and have the same root certificate. In addition, ensure that you copy the certificates to the same locations that you originally used when creating the universe.

Edit connection pooling

{{<tags/feature/ea idea="1368">}}If your universe is running database v2024.2 or later, you can enable Built-in connection pooling.

While in Early Access, the feature is not available by default. To make connection pooling available, set the Allow users to enable or disable connection pooling Global Runtime Configuration option (config key yb.universe.allow_connection_pooling) to true. Refer to Manage runtime configuration settings. You must be a Super Admin to set global runtime configuration flags.

To enable or disable connection pooling on a universe:

1. Navigate to your universe.
2. Click Actions > Edit Connection Pooling to open the Edit Connection Pooling dialog.
3. Enable or disable the Built-In Connection Pooling option.
4. Optionally, you can change the YSQL API port (used by applications to connect to a universe) and the Internal YSQL Port, which is the port that the YugabyteDB internal PostgreSQL process listens on when connection pooling is enabled. It defaults to 6433 and is only required for local binding, not external connectivity.
5. Click Apply Changes.

Smart resize

Normally when resizing a universe, YugabyteDB moves the data from the old nodes to the new nodes. However, if the universe is deployed on AWS, GCP, or Azure using a cloud provider configuration, you can perform some resizing operations without migrating the data. This is referred to as smart resize, and can be significantly faster than a full copy of the data.

Smart resize is available for the following operations:

• Change the Instance type.

  Note that smart resize is not available when changing the instance type from an AWS EBS-backed instance type (like c5.xlarge) to a local storage-backed instance type (like i3.xlarge), or vice-versa.

• Increase the Volume disk size.

  Note that smart resize is not available with Azure ultra disks, or when decreasing the volume size.

• Both together.

In addition, smart resize isn't available if you change any options on the Edit Universe page in addition to the Instance Type and the size portion of the Volume Info field.

When available, if you change the Instance Type, or both the Instance Type and Volume Info size, and then click Save, YugabyteDB Anywhere gives you the option to either migrate the universe and its data to new nodes, or do a smart resize.

If you change only the Volume Info size and click Save, YugabyteDB Anywhere automatically performs a smart resize.