Setting Up Apache Kudu Using the Command Line

Follow these steps on each node in your Kudu cluster.

  1. The packages create a kudu-conf entry in the operating system's alternatives database, and they ship the built-in conf.dist alternative. To adjust your configuration, you can either edit the files in /etc/kudu/conf/ directly, or create a new alternative using the operating system utilities. If you create a new alternative, make sure the alternative is the directory pointed to by the /etc/kudu/conf/ symbolic link, and create custom configuration files there. Some parts of the configuration are configured in /etc/default/kudu-master and /etc/default/kudu-tserver files as well. You must include or duplicate these configuration options if you create custom configuration files.

    Review the configuration, including the default WAL and data directory locations, and adjust them according to your requirements.

  2. Configure the Kudu services to start automatically when the server starts, by adding them to the default runlevel.
    sudo chkconfig kudu-master on            # RHEL / CentOS 
    sudo chkconfig kudu-tserver on           # RHEL / CentOS 
    
    sudo update-rc.d kudu-master defaults    # Ubuntu / Debian 
    sudo update-rc.d kudu-tserver defaults   # Ubuntu / Debian
  3. Verify the Installation.

Verify the Installation

  1. Verify that the Kudu master and tablet servers are running using one of the following methods:
    • Examine the output of the ps command on servers to verify that the kudu-master and kudu-tserver processes are running.

    • Access the master or tablet server web UI by going to http://<_host_name_>:8051/ for masters, or http://<_host_name_>:8050/ for tablet servers.

  2. If Kudu isn’t running, look at the log files in /var/log/kudu, and if there’s a file ending with .FATAL, that means Kudu did not start.
    • If the error is related to a failed hole punch test or the file block manager, it might be a problem with your operating system.

    • If the error is related to clock synchronization, it is most likely a problem with the Network Time Protocol.