Universe creation

Creation of a YugabyteDB universe involves a number of steps.

Start YB-Masters

When creating a YugabyteDB universe, the first step is to bring up a sufficient number of YB-Masters (as many as the replication factor), with each being made aware of the others. These YB-Masters initialize themselves with a universally unique identifier (UUID), learn about each other and perform a leader election. At the end of this step, one of the masters establishes itself as the leader.

Start YB-TServers

You need to start as many YB-TServers as there are nodes, with the master addresses being passed to them on startup. They start sending heartbeats to the masters, communicating the fact that they are alive. The heartbeats also communicate about the tablets the YB-TServers are currently hosting as well as their load information, however the tablets do not yet exist in the system.


Suppose a table with four nodes is created in a YugabyteDB universe. In addition, suppose that the table has a replication factor of 3. First the three masters are started in create mode. This is done explicitly to prevent accidental errors in creating a universe while it is already running. The following diagram depicts the start of the universe creation process:


The following diagram depicts the process of the masters learning about each other and electing one leader:


Finally, the YB-TServers are started, and they all send heartbeats to the YB-Master, as per the following diagram: