Installation
The Flock Networks Routing Suite is shipped as a Debian package. However the Routing Suite can run on any Linux system. The executables have no dependencies other than the Linux Kernel API (Sockets, Netlink, etc). The following instructions are for installing on a Debian based Linux distribution (Debian, Ubuntu, Mint, etc). To install on other systems please see Appendix C: Manual Install.
Download the latest Debian package.
Install the application from the Debian package (as root or using sudo);
# dpkg -i flockrsd_20.0.x_amd64.deb
The Flock Routing Suite Licence is appended to;
/usr/share/doc/flockrsd/copyright
The Flock Routing Suite Client (flockrsc) is copied to;
/usr/bin/flockrsc
The Flock Routing Suite Daemon (flockrsd) is copied to;
/usr/sbin/flockrsd
flockrsd config is stored under;
/etc/flockrsd/
flockrsd is controlled by systemd;
$ systemctl status flockrsd
# systemctl start flockrsd
# systemctl stop flockrsd
logging can be viewed via journalctl;
# journalctl -u flockrsd --boot
Example successful installation
# dpkg -i flockrsd_20.0.0_amd64.deb
Selecting previously unselected package flockrsd.
(Reading database ... 27695 files and directories currently installed.)
Preparing to unpack flockrsd_20.0.0_amd64.deb ...
Unpacking flockrsd (20.0.0) ...
Setting up flockrsd (20.0.0) ...
# systemctl start flockrsd
$ systemctl status flockrsd
● flockrsd.service - Flock Networks Routing Suite Daemon
Loaded: loaded (/lib/systemd/system/flockrsd.service; enabled; vendor preset: enabled)
Active: active (running) since Fri 2020-01-24 12:39:24 GMT; 6s ago
Main PID: 825 (flockrsd)
Tasks: 1 (limit: 1150)
Memory: 908.0K
CGroup: /system.slice/flockrsd.service
└─785 /usr/sbin/flockrsd
Jan 24 12:39:24 flocknet flockrsd[825]: [INFO flockrsd] START: PID=825, Compile Mode=Release, Log Level="info"
Jan 24 12:39:24 flocknet flockrsd[825]: [INFO flockrsd] OSPFv2 derived RouterId(192.168.122.171) from IPv4 Address
Jan 24 12:39:28 flocknet flockrsd[825]: [INFO flockrsd::ospf_intf] IntfId(2) 10.0.1.168/24 state change Wait -> Backup
Jan 24 12:39:28 flocknet flockrsd[825]: [INFO flockrsd::ospf_neigh] RouterId(10.0.100.2) V4(10.0.1.249) neigh state change Exchange -> Full
$ flockrsc system
{"software":"Flock Networks Routing Suite","version":"20.0.1","pid":825,"compile_mode":"Release","log_level":"info","uptime":{"days":0,"hours":0,"mins":0,"secs":19}}
Troubleshooting Installation
flockrsd fails to start
- systemd PolicyKit / polkit failure
PolicyKit / polkit is the "sudo of systemd". If you have PolicyKit / polkit active on the install host, and you want to start flockrsd as an unprivileged user, you will need to add PolicyKit / polkit configuration for flockrsd. Alternatively you can just run systemctl start flockrsd as root or under sudo.
$ systemctl start flockrsd
==== AUTHENTICATING FOR org.freedesktop.systemd1.manage-units ===
Authentication is required to start 'flockrsd.service'.
Authenticating as: www-data
Password:
Failed to start flockrsd.service: Connection timed out
See system logs and 'systemctl status flockrsd.service' for details.
polkit-agent-helper-1: pam_authenticate failed: Authentication failure