apple/foundationdb

Make the binary package more quick start friendly

Open

#1.457 geöffnet am 12. Apr. 2019

Auf GitHub ansehen
 (1 Kommentar) (0 Reaktionen) (0 zugewiesene Personen)C++ (1.266 Forks)batch import
help wanted

Repository-Metriken

Stars
 (13.912 Stars)
PR-Merge-Metriken
 (Durchschn. Merge 4T 12h) (126 gemergte PRs in 30 T)

Beschreibung

It would be nice if the binary package included a single command to start a local FoundationDB server.

Description:

As a developer I want an easy way to run a local database for development and testing.

The "Getting Started on Linux" instructions assume that I will install a distro package, which isn't always possible or desired, e.g. in my case my distro is not supported.

The binaries tarball works but is a bit of hassle to get running, as you need to find the following:

  • a config file, which you can piece together from the documentation section by section
  • a cluster file, whose format is described but without a valid example or suggested way to generate an ID
  • a command line, e.g. do you run fdbmonitor or fdbserver, and with which arguments

(For a comparison, the relatively heavy-weight Kafka comes ready to run locally in two commands, one of which starts an included Zookeeper server.)

Suggestion:

The binary package should include a shell script that starts a local foundationdb server, creating a cluster file if necessary. The server should be configured to store its data and logs to the local directory. It should also include a readme file that shows how to start the server and connect to it with fdbcli.

Contributor Guide