Direkt zum Hauptinhalt

Server - Installation mit Distributionspaketen (*:deb, *.rpm)

Mit Hilfe fertiger Installationspakete ersparen wir dem Anwender das Installieren von Kompilierungswerkzeugen und Bibliotheken und reduzieren dadurch erheblich den Ressourcen- und Zeitverbrauch. Alternativ zu den Installationspaketen gibt es auch Beschreibungen für das Selbstkompilieren sowie das Deployment mit Containern.

Im Paket fabaccess-bffh enthalten sind der BFFH Server, sowie das FabFire Provisioning Tool. Die zwei Binaries, die installiert werden, sind damit:

  • /usr/bin/bffhd
  • /usr/bin/fabfire_provision

Anforderungen und Kompabilität

Mindestanforderungen und kompatible Hardware finden sich hier.

Downloads

Fertige Pakete für Debian / Ubuntu / Kubuntu (*.deb) und Fedora / CentOS / Redhat OS (*.rpm) finden sich in:

Der öffentliche Teil des PGP-Schlüssels, der für die Paketerzeugung verwendet wird, findet sich hier: https://gitlab.com/fabinfra/fabaccess/bffh/-/blob/feature/deb+rpm/debian/public.pgp. Dieser kann verwendet werden, um die Signaturen zu überprüfen.

Paket per Dry-run testen

Debian / Ubuntu / Kubuntu

Wer nicht gleich installieren will, kann vorher testen und Infos vom Paket abrufen:

dpkg-deb --info fabaccess-bffh_0.4.4_amd64.deb

sudo apt install --simulate ./fabaccess-bffh_0.4.4_amd64.deb

Installation

Nach dem Downloaden wechseln wir in das Zielverzeichnis.

Debian / Ubuntu / Kubuntu

Erforderliche Hilfspakete installieren:

sudo apt install mosquitto
sudo systemctl enable mosquitto --now

BFFH Paket installieren:

Das Paket schlägt beim Installieren die Installation weiterer optionaler (suggested) und abhängiger (dependent) Pakete vor. Diese Infos lassen über dpkg-deb --info fabaccess-bffh_0.4.4_amd64.deb | grep "Depends:\|Suggests:" abrufen. Ein empfehlenswertes Paket ist z.B. dhall.

sudo dpkg -i fabaccess-bffh-0.4.4_amd64.deb

# oder

sudo apt install ./fabaccess-bffh_0.4.4_amd64.deb
# Hinweis: Beim Installieren des Pakets mit apt erhalten wir ggf. eine Warnmeldung 
# "N: Der Download wird als root und nicht Sandbox-geschützt durchgeführt,
# da auf die Datei »/home/someone/Downloads/bffh_0.4.4_amd64.deb« durch den Benutzer 
# »_apt« nicht zugegriffen werden kann". Diese kann ignoriert oder umgangen werden, 
# indem das Paket nach /tmp/ heruntergeladen wird.

cd /tmp/
wget fabaccess-bffh_0.4.4_amd64.deb
sudo apt install ./fabaccess-bffh_0.4.4_amd64.deb

Installation prüfen:

Fedora / CentOS / Redhat OS

Erforderliche Hilfspakete installieren:

sudo dnf install mosquitto
sudo systemctl enable mosquitto --now

BFFH Paket installieren:

sudo rpm -i fabaccess-bffh-0.4.4-1_amd64.rpm

Installation prüfen:

sudo dpkg -l | grep fabaccess-bffh

BFFH als Service aktivieren und Logs prüfen

sudo systemctl enable bffh --now
sudo journalctl -f -u bffh.service

BFFH startet standardmäßig auf dem TCP-Port 59661, wenn nicht geändert. Außerdem wird im Hintergrund auf dem TCP-Port 49289 eine Debugger Console gestartet.

BFFH Hilfe anzeigen

Es gibt eine minimale Manpage für BFFH. Diese kann angezeigt werden:

man bffhd
man fabfire_provision

BFFH Konfiguration

Nach der Installation muss der Server passend konfiguriert werden. Das ist kein Bestandteil des Installers und ist komplett individuell, je nach Gebrauchszweck. Alle wichtige Infos finden sich im Kapitel FabAccess Konfiguration.

Metainformationen anzeigen

Das ist rein informativ und nicht notwendig!

Ein paar Kommandos für verschiedene Zwecke (z.B. nach Tags suchen, Infos zu Paket anzeigen):

sudo apt install debtags

debtags update
debtags show fabaccess-bffh

apt-cache search fabaccess
apt-cache search bffh
apt search fabaccess
apt search bffh
apt search difluoroborane

aptitude search '?tag(network::server)'
aptitude search fabaccess
aptitude search bffh
aptitude search difluoroborane

Deinstallation

Die Deinstallation von BFFH ist relativ rückstandsfrei, bis auf Konfigurationsdateien, Datenbanken und Logs. Bitte ggf. die Verzeichnisse manuell danach überprüfen:

  • /var/log/bffh/
  • /etc/bffh/
  • /var/lib/bffh/

Debian / Ubuntu / Kubuntu

sudo apt remove fabaccess-bffh

oder:

sudo apt purge fabaccess-bffh

Fedora / CentOS / Redhat OS

dnf hat keinen purge Befehl (bei apt kann man deinstallieren oder deinstallieren + restlos bereinigen = purge). Bei dnf gibt nur remove!

sudo dnf remove fabaccess-bffh

Benennung von Debian Paketen

Diese Entscheidungen sind grundlegend, deshalb finden sie hier Ewähnung.

fabaccess-bffh - BFFH Server

Der Server hat mehrere Namen: FabAccess Server, BFFH, bffh, bffhd, Diflouroborane - welcher ist der beste? Wir entscheiden uns für den Paketname fabaccess-bffh, weil

  • der Paketname relativ klar ist und erlaubt, später weitere Pakete im Zusammenhang fabaccess-* zu publizieren
  • mit dem Nachteil, dass es etwas länger ist als einfach bffh und der systemd Service bffh heißt. Das müssen wir im Setup also klar heraus stellen!
nach oben