farmerswife

Welcome
Login  Sign up

Server and Client Installation Linux


Client Installation on Linux

Just download the Linux client from our webpage, give it execution permissions and launch it, that’s it!

IMPORTANT: It only works on 32 bits Linux installations.


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.

A Linux System Administrator is a prerequisite because we don’t give support for Linux itself, only for the service, and an additional Linux Support agreement is mandatory.

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: Nowadays 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.


Supported Linux server versions

  • Ubuntu: 12.04 LTS, 14.04 LTS, 16.04LTS

  • Debian: 8, 9

  • CentOS 7, Fedora 27, RedHat 7.4

  • Amazon Linux

Other versions may work but are not tested/supported.


Packages needed

  • ZIP

  • Java 8 orJava 9

  • 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)


Ubuntu 16.04 LTS

sudo add-apt-repository ppa:webupd8team/java
sudo apt update
sudo apt install oracle-java9-installer zip unzip x11-xserver-utils x11-apps xauth

Modify sshd_config to allow X11 forwarding.


Debian 9

sudo echo "deb http://ppa.launchpad.net/webupd8team/java/ubuntu xenial main" | sudo tee /etc/apt/sources.list.d/webupd8team-java.list

sudo echo "deb-src http://ppa.launchpad.net/webupd8team/java/ubuntu xenial main" | sudo tee -a /etc/apt/sources.list.d/webupd8team-java.list

sudo apt install dirmngr
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys EEA14886

sudo apt update
sudo apt install oracle-java9-installer zip unzip x11-xserver-utils x11-apps xauth

Modify sshd_config to allow X11 forwarding.


CentOS 7 / RedHat 7.4 / Fedora 27

wget --no-cookies --no-check-certificate --header "Cookie: gpw_e24=http%3A%2F%2Fwww.oracle.com%2F;oraclelicense=accept-securebackup-cookie" http://download.oracle.com/otn-pub/java/jdk/9.0.4+11/c2514751926b4512b076cc82f959763f/jre-9.0.4_linux-x64_bin.rpm

sudo rpm -ivh jre-9.0.4_linux-x64_bin.rpm
sudo yum makecache fast
sudo yum install zip unzip xorg-x11-xauth xorg-x11-apps

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


Amazon Linux

wget --no-cookies --no-check-certificate --header "Cookie: gpw_e24=http%3A%2F%2Fwww.oracle.com%2F;oraclelicense=accept-securebackup-cookie" http://download.oracle.com/otn-pub/java/jdk/9.0.4+11/c2514751926b4512b076cc82f959763f/jre-9.0.4_linux-x64_bin.rpm

sudo rpm -ivh jre-9.0.4_linux-x64_bin.rpm

sudo yum makecache fast

sudo yum install 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 http://farmerswife-customer-access.s3.amazonaws.com/603_Release_rev16881/farmerswife_603_Release_rev16881/Linux64_farmerswife_603_ServerWithAutoClientUpgrader?AWSAccessKeyId=AKIAIIRUFYG4IFTC3I7A&Expires=1513162073&Signature=Jj4sp5UBdC0lWB32xlj0UADb9dA%3D

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

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

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.

With this you’re finished, you can just launch the service and start working, and time to time you will need to stop the service, launch manually the server with X11 forwarding to add/modify/delete users.


Important note: at this moment those two scripts aren't inside the installation package, so you can download them from here. They will be on our future revisions of our installers.


Known-issues

Some times when you’re adding users it takes to long to create, 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 bellow 1000 you should generate more so it doesn’t take that long. Normally for a desktop Linux with moving the mouse or just opening applications it’s enough, 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 is diferent, 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