Installation

SmartOS

❗️

Configuration

After installing DPX make sure to configure it correctly, especially hosts like Postgres and dalmatinerdb are important!

🚧

Dataset Version

The pre-compiled packages require the 14.4 LTS detests (for example 1bd84670-055a-11e5-aaa2-0346bb21d5a1 14.4.2 minimal-64-lts) as newer versions do not provide packages for the same ncurses library that erlang was compiled with. - This might change in the future!

πŸ“˜

Delegated dataset

It is highly encouraged to use a delegated dataset mounted to the /data directory as all mutable data is stored there. this allows for updating at later times

Starting with 14.4.0 Datasets, Joyent introduced signed packages.

In order to install Dalmatiner frontend from the latest pre-built binary, the Project-FiFo public key is required and can be installed with the following commands:

curl -O https://project-fifo.net/fifo.gpg
gpg --primary-keyring /opt/local/etc/gnupg/pkgsrc.gpg --import < fifo.gpg
gpg --keyring /opt/local/etc/gnupg/pkgsrc.gpg --fingerprint

πŸ“˜

Key verification

The key id is BB975564 and the fingerprint CE62 C662 67D5 9129 B291 62A0 ADDF 278A BB97 5564 should be returned respectively.

The Dalmatiner frontend SmartOS package can be installed from the Project-FiFo repository, using pkgin:

VERSION='dev' # use 'rel' for release packages
echo "http://release.project-fifo.net/pkg/${VERSION}" >>/opt/local/etc/pkgin/repositories.conf
pkgin -fy up
pkgin install dalmatinerpx # To install the frontend package

From source

These dependencies should be met before installing from source:

  • Erlang R18
  • Git
  • GCC
  • G++
  • Make

The following instructions will create a self-contained build of DalmatinerDB:

git clone https://gitlab.com/Project-FiFo/DalmatinerDB/dalmatinerpx.git
cd dalmatinerpx
./rebar3 release
TARGET_DIRECTORY=/usr/local # or where your OS stores local binaries
cp -r _build/prod/rel/dalmatinerpx $TARGET_DIRECTORY
cd $TARGET_DIRECTORY/dalmatinerpx
mkdir -p /data/dalmatinerpx/etc
cp etc/dalmatinerpx.conf.example /data/dalmatinerpx/etc/dalmatinerpx.conf
vi /data/dalmatinerpx/etc/dalmatinerpx.conf # check the settings and adjust if needed
chown -R dalmatiner /data/dalmatinerpx
./bin/dalmatinerpx start

πŸ“˜

Dalmatiner user

DalmatinerFrontend by default expects to run as the user dalmatiner, this can be changed or disabled by changing/removing the bin/dalmatinerfe file’s entry RUNNER_USER.
This user should have read access to the etc directory and read/write access to the logs directories.

πŸ“˜

Configuration changes

In order for configuration changes to take effect, the service must be restarted.