Software requirements for cloud provider configuration database nodes

Prepare a VM for deploying universes using a cloud provider configuration

When deploying universes using a public cloud provider configuration (AWS, GCP, or Azure), YugabyteDB Anywhere (YBA) creates cloud VMs for database nodes directly.

You have two options for provisioning the operating system for database nodes:

  • Use a default (YBA-managed) Linux version (and disk image).
  • Specify a custom Linux version (and disk image).

Using a YBA-managed Linux version requires connectivity from the database nodes to the public Internet. If you lack such connectivity, you will need to use a custom Linux version.

YBA-managed Linux version

For YBA-managed Linux version, YBA manages the creation and provisioning of database nodes, including installing the disk image, configuring the Linux OS, and installing the additional software.

You can proceed directly to installing YBA, creating your cloud provider configuration, and creating universes. YBA-managed Linux versions use ec2-user on AWS and centos on GCP and Azure.

Custom Linux version with Internet connectivity

If you choose to provide your own custom Linux version and your VMs have connectivity to the public Internet, you must provide to YBA a Linux OS disk image with the following pre-installed:

  • Supported Linux OS. The SSH user must have passwordless sudo and must not be named yugabyte (YBA creates that account during provisioning). YBA uses this user to configure the OS, including creating the yugabyte user and updating ulimits.
    • AWS and GCP: that user must already exist on the image. For standard images, use the image's default login user (for example ec2-user or ubuntu).
    • Azure: Azure creates the SSH user you specify when it provisions the VM. For a custom or shared-gallery image, choose a username that does not already exist on the image; Azure rejects the request if that user is already present.
  • Additional software

Take the time now to prepare the Linux disk image.

  • Save the SSH user name and the SSH private key PEM file.
  • Save the disk image IDs for later when installing and configuring YBA.
Save for later To configure
SSH user name Linux version catalog
SSH private key PEM file SSH Key Pairs
Disk image IDs Linux version catalog

Custom Linux version without Internet connectivity

If you choose to provide your own custom Linux version and your VMs don't have connectivity to the public Internet, you must provide to YBA a Linux OS disk image with the following pre-installed:

  • Supported Linux OS. The SSH user must have passwordless sudo and must not be named yugabyte (YBA creates that account during provisioning). YBA uses this user to configure the OS, including creating the yugabyte user and updating ulimits.
    • AWS and GCP: that user must already exist on the image. For standard images, use the image's default login user (for example ec2-user or ubuntu).
    • Azure: Azure creates the SSH user you specify when it provisions the VM. For a custom or shared-gallery image, choose a username that does not already exist on the image; Azure rejects the request if that user is already present.
  • Additional software
  • Additional software for airgapped

Take the time now to prepare the Linux disk image.

  • Save the SSH user name and the SSH private key PEM file.
  • Save the disk image IDs for later when installing and configuring YBA.
Save for later To configure
SSH user name Linux version catalog
SSH private key PEM file SSH Key Pairs
Disk image IDs Linux version catalog