Install YugabyteDB Anywhere
Use the following instructions to install YugabyteDB Anywhere software. For guidance on which method to choose, see YBA Prerequisites.
Note: For higher availability, one or more additional YugabyteDB Anywhere instances can be separately installed, and then configured later to serve as passive warm standby servers. See Enable High Availability for more information.
Prerequisites
If Docker is not installed on the host computer, you need to install a recent version that matches the minimum requirements outlined in Installing Docker in Airgapped Environments.
If access to the Docker repositories for your Linux distribution is not available on the host computer, you may have to manually transfer the necessary RPM or DEB packages whose locations are specified in Installing Docker in Airgapped Environments.
Refer to Airgapped hosts for more details on preparing your host machine.
Install Replicated
On a computer connected to the Internet, perform the following steps:
-
Make a directory for downloading the binaries by executing the following command:
sudo mkdir /opt/downloads
-
Change the owner user for the directory by executing the following command:
sudo chown -R ubuntu:ubuntu /opt/downloads
-
Change to the directory by executing the following command:
cd /opt/downloads
-
Download the
replicated.tar.gz
file by executing the following command:wget --trust-server-names https://get.replicated.com/airgap
-
Download the
yugaware
binary and change the following number, as required:wget https://downloads.yugabyte.com/releases/2.17.3.0/yugaware-2.17.3.0-b152-linux-x86_64.airgap
-
Switch to the following directory:
cd /opt/downloads
-
Extract the
replicated
binary, as follows:tar xzvf replicated.tar.gz
-
Install Replicated. If multiple options appear, select the
eth0
network interface, as follows:cat ./install.sh | sudo bash -s airgap
The yugaware
binary is installed using the Replicated UI after the Replicated installation completes.
After Replicated finishes installing, ensure that it is running by executing the following command:
sudo docker ps
You should see an output similar to the following:
The next step is to install YugabyteDB Anywhere.
Set Up HTTPS (optional)
Launch the Replicated UI via http://yugaware-host-public-ip:8800. Expect to see a warning stating that the connection to the server is not yet private. This condition is resolved once HTTPS for the Replicated Admin Console is set up in the next step. Proceed by clicking Continue to Setup > ADVANCED to bypass the warning and access the Replicated Admin Console, as shown in the following illustration:
You can provide your own custom SSL certificate and a hostname, as shown in the following illustration:
It is recommended that you start with using a self-signed certificate, and then add the custom SSL certificate later. Note that in this case you connect to the Replicated Admin Console using an IP address, as shown in the following illustration:
Upload the License File
Upload the Yugabyte license file that you received from Yugabyte, as shown in the following illustration:
Two options to install YugabyteDB Anywhere are presented as shown in the following illustrations:
Secure Replicated
Add a password to protect the Replicated Admin Console, which is different from the Admin Console for YugabyteDB used by YugabyteDB Anywhere, as shown in the following illustration:
Preflight checks
Replicated performs a set of preflight checks to ensure that the host is set up correctly for YugabyteDB Anywhere, as shown in the following illustration:
Click Continue to configure YugabyteDB Anywhere.
If the preflight check fails, review the Troubleshoot YugabyteDB Anywhere to resolve the issue.
Set the TLS Version for Yugaware Frontend
Specify TLS versions via Application config, as shown in the following illustration:
The recommended TLS version is 1.2.