How to remove process from test server

I am running a local foundationdb instance for experimenting with the API.

I changed the number of processes on my local server, by editing /etc/foundationdb/foundationdb.conf to use 4 processes:


This worked and foundationdb used 4 CPU cores.
When I wanted to reduce it to 3 CPUs, I removed the last line from the config and restarted the server.

Now I get the following error:

The database is unavailable; type `status’ for more information.

Welcome to the fdbcli. For help, type `help’.
fdb> status

Using cluster file `/etc/foundationdb/fdb.cluster’.

Locking coordination state. Verify that a majority of coordination server
processes are active. (reachable)

Unable to locate the data distributor worker.

Unable to locate the ratekeeper worker.

How do I correctly reduce the number of processes on my test server?

Did you have only a single coordinator in this setup? What does your cluster (fdb.cluster) config file look like?

Yes, this is a single machine / single coordinator setup on my local machine. I just want to get familiar with the API at the moment.

Here is my cluster file:


And here is my config file (no changes from default, except for number of processes):

## foundationdb.conf
## Configuration file for FoundationDB server processes
## Full documentation is available at

user = foundationdb
group = foundationdb

restart_delay = 60
## by default, restart_backoff = restart_delay_reset_interval = restart_delay
# initial_restart_delay = 0
# restart_backoff = 60
# restart_delay_reset_interval = 60
cluster_file = /etc/foundationdb/fdb.cluster
# delete_envvars =
# kill_on_configuration_change = true

## Default parameters for individual fdbserver processes
command = /usr/sbin/fdbserver
public_address = auto:$ID
listen_address = public
datadir = /var/lib/foundationdb/data/$ID
logdir = /var/log/foundationdb
# logsize = 10MiB
# maxlogssize = 100MiB
# machine_id = 
# datacenter_id = 
# class = 
# memory = 8GiB
# storage_memory = 1GiB
# cache_memory = 2GiB
# metrics_cluster = 
# metrics_prefix =

## An individual fdbserver process with id 4500
## Parameters set here override defaults from the [fdbserver] section

command = /usr/lib/foundationdb/backup_agent/backup_agent
logdir = /var/log/foundationdb


I installed the server from foundationdb-server_6.3.12-1_amd64.deb following the steps at Getting Started on Linux — FoundationDB 6.3 .

I think the issue could be that this db has replication factor of 1. So it cannot accommodate even one machine “failure”.

You should bring back that line to make the cluster healthy. Then:

  • for controlled machine exclusions, you can use the exclude command from fdbcli. This will first copy the data away from the machine, before excluding it from cluster. Once it is done, you can remove the process line for it from the config.
  • to accommodate uncontrolled failures, like the one you simulated by removing the process line, make the replication factor to be 2+ from fdbcli, and then try the file based removal again. This time the cluster should still do okay.

Be careful that your coordinator process is not excluded. You can increase coordinator process using coordinator fdbcli command to increase resiliency of coordinator process exclusion/failures.

Also see this.

Guarav’s recommendations are good, and to avoid a potential pitfall here I’ll point out one other detail that may impact you if you try to use a single machine for double replication. If you try to do this with the configuration you had above, I believe it will fail because it requires multiple machines. To make this work, you would need to simulate having different machines by configuring the machine IDs on your processes. For example:

machine_id = 0

machine_id = 1

machine_id = 2

machine_id = 3

Thanks for the answers.

I actually changed the number of processes to see how fdb scales when increasing the number of processes.
So changing the configuration back to the original was not to stimulate failures, I just wanted to go back to defaults without reinstalling fdb.

With gauravs answer, I was able to remove one of the four processes, but for getting back to the initial config I had to reinstall the server.