FaunaDB Dev

Download RPM

RPM package

Installing

After downloading the .rpm package, open up a terminal app and run the following commands:

$ sudo rpm -i <download-directory>/faunadb-2.11.3-0.rpm

Alternatively, you can install FaunaDB using the yum command line. For this, you will need to add the Fauna repository:

$ cat | sudo tee /etc/yum.repos.d/fauna-core-noarch.repo <<EOF
[fauna-core-noarch]
baseurl = https://repo.fauna.com/rpm/stable
gpgcheck = 1
gpgkey = https://repo.fauna.com/faunadb-gpg-public.key
name = Fauna, Inc Enterprise Database
sslverify = 1
EOF

$ sudo yum install faunadb

Both methods will install FaunaDB and create a faunadb user in your machine.

Configuring

Before running FaunaDB, it's necessary to create a yaml config file at /etc/faunadb.yml. Here is an example file with the bare minimum configurations necessary to startup the server:

$ cat | sudo tee /etc/faunadb.yml <<EOF
---
auth_root_key: secret
network_datacenter_name: NoDc
network_listen_address: 127.0.0.1
network_broadcast_address: 127.0.0.1
network_admin_http_address: 127.0.0.1
network_coordinator_http_address: 127.0.0.1
EOF

For more information about the above configurations and others, visit How to Operate FaunaDB.

Running

Now it's time to start FaunaDB. To do this, run:

$ sudo systemctl start faunadb-enterprise

Now, make sure the service is running:

$ systemctl status faunadb

faunadb-enterprise.service - FaunaDB Enterprise Edition
   Loaded: loaded (/usr/lib/systemd/system/faunadb.service; disabled; vendor preset: disabled)
   Active: active (running) since Tue 2018-08-14 12:00:38 EDT; 17s ago
  Process: 1311 ExecStartPre=/bin/chmod 755 /run/faunadb (code=exited, status=0/SUCCESS)
  Process: 1309 ExecStartPre=/bin/chown faunadb:faunadb /run/faunadb (code=exited, status=0/SUCCESS)
  Process: 1307 ExecStartPre=/bin/mkdir -p /run/faunadb (code=exited, status=0/SUCCESS)
 Main PID: 1313 (java)
   CGroup: /system.slice/faunadb.service
           └─1313 java -Djava.net.preferIPv4Stack=true -Dhttp.connection.timeout=2 -Dhttp.connection-manager.timeout=2 -Dhttp.socket.timeout=6 -Xmx249714K -Xms249714K -Xss256k -Xloggc:/var/log/faunadb/gc.log -XX:+UseG1GC -XX:MaxGCPauseMillis=200 ...

Aug 14 12:00:41 localhost.localdomain faunadb[1313]: Loaded configuration from /etc/faunadb.yml...
Aug 14 12:00:42 localhost.localdomain faunadb[1313]: Network Host ID: 127.0.0.1
Aug 14 12:00:42 localhost.localdomain faunadb[1313]: Cluster name: fauna
Aug 14 12:00:42 localhost.localdomain faunadb[1313]: Datacenter name: NoDc
Aug 14 12:00:47 localhost.localdomain faunadb[1313]: Data path: /var/lib/faunadb
Aug 14 12:00:47 localhost.localdomain faunadb[1313]: Temp path: /var/lib/faunadb/tmp
Aug 14 12:00:47 localhost.localdomain faunadb[1313]: Snapshot path: /var/lib/faunadb/snapshots
Aug 14 12:00:48 localhost.localdomain faunadb[1313]: Admin endpoint: 127.0.0.1:8444
Aug 14 12:00:48 localhost.localdomain faunadb[1313]: API endpoint: 127.0.0.1:8443
Aug 14 12:00:48 localhost.localdomain faunadb[1313]: FaunaDB is ready.

This indicates that FaunaDB initialized successfully and loaded our config file at /etc/faunadb.yml.

It also indicates that it's saving the data in the /var/lib/faunadb directory.

If it's the first time you're running the service, you will need to initialize the repository before issuing queries to FaunaDB. To do that, an admin tool is provided:

$ faunadb-admin init

Loaded configuration from /etc/faunadb.yml...
Node has initialized the cluster.

Testing

To confirm that the instance is responding to queries, a simple test can be run:

$ curl http://127.0.0.1:8443/ping

{ "resource": "Scope write is OK" }

If you see the above message, you are ready to go.

Dependencies

FaunaDB depends on Java 8 to run, so you might need to install it if you haven't already:

$ sudo yum install java-1.8.0-openjdk