Prerequisites

YugabyteDB Anywhere first needs to be installed on a host computer, and then you configure YugabyteDB Anywhere to work in your on-premises private cloud or in a public cloud environment. In a public cloud environment, YugabyteDB Anywhere spawns instances for starting a YugabyteDB universe. In a private cloud environment, you use YugabyteDB Anywhere to add nodes in which you want to be in the YugabyteDB universe. To manage these nodes, YugabyteDB Anywhere requires SSH access to each of the nodes.

Supported Linux distributions

You can install YugabyteDB Anywhere on the following Linux distributions:

Hardware requirements

The hardware requirements depend on the type of your YugabyteDB Anywhere installation:

Docker-based installations

A node running YugabyteDB Anywhere is expected to meet the following requirements:

  • 4 cores (minimum) or 8 cores (recommended)
  • 8 GB RAM (minimum) or 10 GB RAM (recommended)
  • 100 GB SSD disk or more
  • x86-64 CPU architecture

Kubernetes-based installations

A Kubernetes node is expected to meet the following requirements:

  • 5 cores (minimum) or 8 cores (recommended)

  • 15 GB RAM (minimum)

  • 250 GB SSD disk (minimum)

  • 64-bit CPU architecture

Prepare the host

The requirements depend on the type of your YugabyteDB Anywhere installation:

Docker-based installations

For a Docker-based installation, YugabyteDB Anywhere uses Replicated scheduler for software distribution and container management. You need to ensure that the host can pull containers from the Replicated Docker Registries.

Replicated installs a compatible Docker version if it is not pre-installed on the host. The currently supported Docker version is 20.10.n.

Installing on airgapped hosts requires additional configurations, as described in Airgapped hosts.

Airgapped hosts

Installing YugabyteDB Anywhere on airgapped hosts, without access to any Internet traffic (inbound or outbound) requires the following:

  • Whitelisting endpoints: To install Replicated and YugabyteDB Anywhere on a host with no Internet connectivity, you have to first download the binaries on a computer that has Internet connectivity, and then copy the files over to the appropriate host. In case of restricted connectivity, the following endpoints have to be whitelisted to ensure that they are accessible from the host marked for installation: https://downloads.yugabyte.com https://download.docker.com

  • Ensuring that Docker Engine version 20.10.n is available. If it is not installed, you need to follow the procedure described in Installing Docker in airgapped.

  • Ensuring that the following ports are open on the YugabyteDB Anywhere host:

    • 8800 – HTTP access to the Replicated UI
    • 80 – HTTP access to the YugabyteDB Anywhere UI
    • 22 – SSH

  • Ensuring that the attached disk storage (such as persistent EBS volumes on AWS) is 100 GB minimum.

  • Having YugabyteDB Anywhere airgapped install package. Contact Yugabyte Support for more information.

  • Signing the Yugabyte license agreement. Contact Yugabyte Support for more information.

Kubernetes-based installations

The YugabyteDB Anywhere Helm chart has been tested using the following software versions:

  • Kubernetes 1.22
  • Helm 3.10

Before installing YugabyteDB Anywhere, verify that you have the following:

  • A Kubernetes cluster with nodes configured according to the hardware requirements.
  • A client environment with the kubectl and Helm command-line tools configured with a service account or user that has admin access to a single namespace on the subject Kubernetes cluster.
  • A Kubernetes secret obtained from Yugabyte.

In addition, ensure the following: