Check YugabyteDB servers

1. Are the YugabyteDB servers running?

Connect to the local node where YugabyteDB is running.

On the local setup, this is your local machine (or a Docker instance running on your local machine). On a multi-node cluster, you may need to ssh into the machines where the YugabyteDB nodes are running.

$ ps aux | grep yb-tserver

If you are expecting a yb-master servers on this node, you can also do the following.

$ ps aux | grep yb-master

If the servers are not running you can start them with:

• yb-ctl when using a local cluster.

• bin/yb-tserver and bin/yb-master servers when using a multi-node cluster.

Once the servers are running, if they are not accessible from your client machine this may be a network issue (see below).

2. Are the yb-master and yb-tserver endpoints accessible?

Generally, the endpoints are:

However, in some setups these endpoints may not be accessible, depending on the configuration on your physical machines or on your cloud-provider account.

IP not accessible

• Private versus Public IP: Consider setting up a VPN or using the node’s public IP (for example, get it from the machine status on your cloud-provider account).

Ports closed

• Cloud Account Configuration: Open the relevant ports (see below), for TCP traffic on your cloud-provider account (for example, security group rules).

• SELinux turned on: If your host has SELinux turned on, run the following commands to open the ports using firewall exceptions.

sudo firewall-cmd --zone=public --add-port=7000/tcp;
sudo firewall-cmd --zone=public --add-port=7100/tcp;
sudo firewall-cmd --zone=public --add-port=9000/tcp;
sudo firewall-cmd --zone=public --add-port=9100/tcp;
sudo firewall-cmd --zone=public --add-port=11000/tcp;
sudo firewall-cmd --zone=public --add-port=12000/tcp;
sudo firewall-cmd --zone=public --add-port=9300/tcp;
sudo firewall-cmd --zone=public --add-port=9042/tcp;
sudo firewall-cmd --zone=public --add-port=6379/tcp;

Ports already in use

• macOS Monterey turns on AirPlay receiving by default, which listens on port 7000. This conflicts with YugabyteDB and causes yugabyted start to fail.

$ ./bin/yugabyted start
Starting yugabyted...
/ Running system checks...Failed to bind to address:  0.0.0.0:7000

The workaround is to turn AirPlay receiving off, then start YugabyteDB, and then (optionally) turn AirPlay receiving back on. Alternatively(recommended), you can change the default port number using the --master_webserver_port flag when you start the cluster as follows:

$ ./bin/yugabyted start --master_webserver_port=9999