farmerswife

Welcome
Login  Sign up

Server and Client Installation Linux

This documentation is only for power users who have worked with Linux before.

Client Installation on Linux

Download the Linux client from our installer page, give it execution permissions and launch it, that’s it!
IMPORTANT: It only works on 32 bits Linux installations.

Example:

wget -O farmerswife-client https://s3-eu-west-1.amazonaws.com/farmerswife-customer-access/603_SP1_rev17162/farmerswife_603_SP1_rev17162/Linux32_farmerswife_603_SP1_Client

Server Installation on Linux

The Linux flavour is recommended for those companies who have Linux server environment in their infrastructure and have a Linux System Administrator.
DISCLAIMER: A Linux System Administrator is a prerequisite because we don’t give support for Linux itself, only for the service.
You have two ways to do it, one with the graphical interface on the machine that will serve farmerswife or on a headless server with X11 forwarding.
IMPORTANT: The server side pdf printer is not available on the Linux flavour.

Why it needs a graphical interface or X11 forwarding?

farmerswife needs a graphical interface for its configuration process because it’s the way it was made, but it can run as a service with a daemon, only needing a GUI when you need to add/modify/delete users or modify the server config.

Only spot tested Linux Distributions:

  • Ubuntu: 12.04 LTS, 14.04 LTS, 16.04 LTS, 18.04 LTS

Might also work on these Linux Distributions

  • Debian: 8, 9
  • CentOS 7, Fedora 27, RedHat 7.4

  • Amazon Linux

Other versions may work but are not tested.

Manually install these packages

  • ZIP

  • Java 8 orJava 10

  • x11-xserver-utils (only on deb based distributions, and if your server doesn’t have GUI)

  • x11-apps (xorg-x11-apps on RPM based distributions, and if your server doesn’t have GUI)

  • xauth (xorg-x11-xauth on RPM based distributions, and if your server doesn’t have GUI)

Server preparation

Ubuntu 18.04 LTS

sudo apt update
sudo apt install openjdk-8-jre-headless zip unzip x11-xserver-utils x11-apps xauth

Modify sshd_config to allow X11 forwarding.

Debian 9

sudo apt update
sudo apt install openjdk-8-jre-headless zip unzip x11-xserver-utils x11-apps xauth

Modify sshd_config to allow X11 forwarding.

CentOS 7 / RedHat 7.4 / Fedora 27
sudo yum makecache fast
sudo yum install java-1.8.0-openjdk-headless zip unzip xorg-x11-xauth xorg-x11-apps

Modify /etc/ssh/sshd_config to allow X11 forwarding.

Amazon Linux

sudo yum makecache fast

sudo yum install java-1.8.0-openjdk-headless zip unzip xorg-x11-xauth xorg-x11-apps

Modify /etc/ssh/sshd_config to allow X11 forwarding.

Post-server preparation

Connect to your server allowing X11 forwarding and download the installer version you need. For example:

wget -O farmerswife-installer https://s3-eu-west-1.amazonaws.com/farmerswife-customer-access/603_SP1_rev17162/farmerswife_603_SP1_rev17162/Linux64_farmerswife_603_SP1_ServerWithAutoClientUpgrader

Once installed create a folder called system inside the installation folder you selected and place the license files inside (and db files if you just migrated to Linux).

Then manually launch the farmerswife server with X11 forwarding executing the binary farmerswife at the root of the installation folder. This way you can configure users, SMTP port, fullbackup folders and so on.

Once finished stop the server, execute the file systemd-installer.sh or initd-installer.sh from the same folder where it is, for example, if the script is located at /opt/farmerswife-server go with cd to that folder and execute the script, that’s because the script takes the pwd value to configure the systemd/init-d service unit.

As the installation process is completed you can just launch the service and start working. From time to time you will need to stop the service, launch the server manually with X11 forwarding to add/modify/delete users.

Known-issues

Some times when you add users it can take a long time, that’s because the server itself doesn’t have enough entropy to hash and salt the user password.

To check your entropy just execute the following command:

sudo cat /proc/sys/kernel/random/entropy_avail

If the entropy is below 1000 you should generate more so it doesn’t take that long. To do this for a Linux desktop it should be enough to just move the mouse or open applications, but for servers you can install the package rng-tools and execute the following command:

rngd -r /dev/urandom -o /dev/random -b -n 1

For Debian you need to modify the file /etc/default/rng-tools and add the following line:

HRNGDEVICE=/dev/urandom

And start the rng-tools daemon:

/etc/init.d/rng-tools start

Please contact support@farmerswife.com for more information.

Did you find it helpful? Yes No