Pre-requisites

You should have already done these steps:

  1. Check Hardware provisioning

Note

This page describes in a human fashion the pre-requisites for Asqatasun. If you want code that automates stuff with no further explanation, leverage our bootstrap.sh from Asqatasun-Vagrant.

Required packages

  • Java JRE 8
  • Mysql 5.7
  • libGTK 3
  • libDbus
apt-get --no-install-recommends install \
    openjdk-8-jre          \
    libgtk-3-0             \
    libdbus-glib-1-2       \
    mysql-server

Note: MariaDB support is in progress (eee issue #504), any help is warmly welcome!

Database

Create a database and the associated user:

DB_DATABASE="asqatasun"
DB_USER="asqatasunDatabaseUserLogin"
DB_PASSWORD="asqatasunDatabaseUserP4ssword"

echo "GRANT ALL PRIVILEGES ON *.* TO '${DB_USER}'@'%' IDENTIFIED BY '${DB_PASSWORD}';" >> db.sql
echo "CREATE DATABASE ${DB_DATABASE};" >> db.sql
mysql -u root < db.sql
rm db.sql
service mysql restart

Firefox ESR

  • Firefox ESR 78
  • Gecko Driver
FIREFOX_VERSION="78.2.0esr"
GECKODRIVER_VERSION="v0.26.0"
FIREFOX_URL_PREFIX="https://download-installer.cdn.mozilla.net/pub/firefox/releases/"
GECKODRIVER_URL_PREFIX="https://github.com/mozilla/geckodriver/releases/download/"
FIREFOX_URL="${FIREFOX_URL_PREFIX}${FIREFOX_VERSION}/linux-x86_64/en-US/firefox-${FIREFOX_VERSION}.tar.bz2"
GECKODRIVER_URL="${GECKODRIVER_URL_PREFIX}${GECKODRIVER_VERSION}/geckodriver-${GECKODRIVER_VERSION}-linux64.tar.gz"

cd /opt
sudo wget "${FIREFOX_URL}"
sudo wget "${GECKODRIVER_URL}"
sudo tar xf "firefox-${FIREFOX_VERSION}.tar.bz2"
sudo tar xf "geckodriver-${GECKODRIVER_VERSION}-linux64.tar.gz"

Please note that Firefox version does matter: if you use something different from 78 ESR we cannot guaranty anything.

Mail SMTP

Asqatasun works better with email (informing you when an audit is finished, or if gives an error). Here are the steps to install locally an SMTP server. You can also use online services such as MailJet or Mandrill and configure it into /etc/asqatasun/asqatasun.org

Install the following packages:

sudo apt-get install postfix mailutils
sudo dpkg-reconfigure postfix

Once the configuration is displayed, options to take are :

  • Configuration type: Satellite system
  • SMTP relay: leave it empty (this is the trick, don’t type anything here)

Next step

Congratulations, you survived the manual pre-requisites stage :)

You can go to Installation.