/
Software requirements

Software requirements

Owned by Cedric
Last updated: 04 Jun, 2025 by Olivier Tavard

Valid for Datafari 6.2

The documentation below is valid from Datafari v6.2

Looking for hardware requirements ?

See Hardware requirements

We detail here the software requirements for the machines used in your Datafari setup. It may vary based on your setup.

Note that you can EITHER use the script below to install Java and all the requirements dependencies OR install manually Java and the dependencies as explained into the page.

OPTION 1 - USING THE SCRIPT

Download script to install Java and dependencies

You can download an init script (.sh) for Datafari :
https://datafari.atlassian.net/wiki/download/attachments/110788634/init_datafari_6_2_dependencies.sh

  • Then launch the script with this command :

source init_datafari_6_2_dependencies.sh

This script will install Java, all the dependencies needed and will set the open files limit configuration. You have the details of all that the script does by looking at OPTION 2 below.

You can also choose to install only dependencies and not Java by using parameter nojava when running the script :

source init_datafari_6_2_dependencies.sh nojava

OPTION 2 - DOING IT MANUALLY (RISKIER)

OS requirements

  • Debian 12 (Bookworm), or Ubuntu 22.04 (Jammy) Environment 64 bits (a Docker image is available if you are on Windows environment) (available both for Datafari CE or Datafari EE)
    (Ubuntu 24.04 is not supported for now because of an issue with the default version of Python installed into this OS (3.12) and Cassandra, see https://gitlab.datafari.com/datafari-community/datafari/-/issues/1007)

  • CentOS or RedHat 8 or 9 and CentOS Stream 8 or 9 (available only for Datafari EE)

Java requirements

  • Java version 11 only mandatory installed on your environment (and you need to set the JAVA_HOME variable for all users and have the java executable in the PATH, see the annex below to view how to do it)

Dependences requirements

Depending on your OS, the list is not the same.

  • For Debian/Ubuntu users :

apt-get install bash curl debconf unzip sudo libc6-dev jq lsof apache2 libapache2-mod-jk iptables iptables-persistent zip iputils-ping systemd procps bc netcat-openbsd -y -q

  • For Almalinux/CentOS users :

yum install -y jq lsof curl perl-Test-Simple perl-version httpd mod_ssl nano iptables-services nc iputils unzip gcc python3-devel bc

Other requirements

  • Increase Open Files limit configuration

    Change the setting in /etc/security/limits.conf : 

    echo 'root soft nofile 100000' >> /etc/security/limits.conf echo 'root hard nofile 100000' >> /etc/security/limits.conf echo 'datafari soft nofile 100000' >> /etc/security/limits.conf echo 'datafari hard nofile 100000' >> /etc/security/limits.conf echo '* soft nofile 100000' >> /etc/security/limits.conf echo '* hard nofile 100000' >> /etc/security/limits.conf echo 'root soft nproc 100000' >> /etc/security/limits.conf echo 'root hard nproc 100000' >> /etc/security/limits.conf echo 'datafari soft nproc 100000' >> /etc/security/limits.conf echo 'datafari hard nproc 100000' >> /etc/security/limits.conf echo '* soft nproc 100000' >> /etc/security/limits.conf echo '* hard nproc 100000' >> /etc/security/limits.conf

    Then reboot the machine to enable those parameters

  • Set the locale setting (in the example with fr_FR but can be replaced with your locale) : 

    apt-get install locales locale-gen fr_FR.UTF-8 dpkg-reconfigure locales

If you have some errors, see the annex below.

Optional requirements

  • Optional: You need a user member of the sudo group to start Datafari (or it can be root user)  :

    visudo # add the line below root ALL=(ALL:ALL) ALL your_user ALL=NOPASSWD: ALL

  • Optional: Make sure that the machine is always up to date (in particular for the email alerts scheduler), by enabling ntpdate, for example : 

    ntpdate 0.fr.pool.ntp.org

ANNEXES

  • Set JAVA_HOME variable

# For example if you want OpenJDK JDK 11 in Debian 10 apt-get install openjdk-11-jdk # Set Java Home nano /etc/profile #in the file add the line : export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64 # Load the file source /etc/profile

  • Troubleshooting for setting the locale
    If you still have an error like "perl: warning: Setting locale failed."
    Do the additionnal steps :
    check the sshd configuration :

    nano /etc/ssh/sshd_config

    and comment the line :

    #AcceptEnv LANG LC_*

    Then relaunch the sshd service :

    /etc/init.d/ssh restart

    Add the locale variables to .bashrc configuration file :

    nano ~/.bashrc

    Add the lines :

    export LC_ALL="fr_FR.UTF-8" export LANG="fr_FR.UTF-8" export LANGUAGE="fr_FR.UTF-8"

    For PostgreSQL : 
    PostgreSQL needs to have the variables LANG and LC_* set. To check them, launch the command :

    locale

    If LC_ALL and LC_TYPE are not filled, enter this (for English language):

    export LC_ALL="en_US.UTF-8" export LC_CTYPE="en_US.UTF-8"

     You can also add the line to /etc/profile then.

 

 

Valid for Datafari 6.0 to 6.1 included

The documentation below is valid from Datafari v6.0 to 6.1 included

Looking for hardware requirements ?

See Hardware requirements

We detail here the software requirements for the machines used in your Datafari setup. It may vary based on your setup.

Note that you can EITHER use the script below to install Java and all the requirements dependencies OR install manually Java and the dependencies as explained into the page.

OPTION 1 - USING THE SCRIPT

Download script to install Java and dependencies

You can download an init script (.sh) for Datafari :

  • Then launch the script with this command :

source init_datafari_6_dependencies.sh

This script will install Java, all the dependencies needed and will set the open files limit configuration. You have the details of all that the script does by looking at OPTION 2 below.

OPTION 2 - DOING IT MANUALLY (RISKIER)

OS requirements

  • Debian 12 (Bookworm), or Ubuntu 22.04 (Jammy) Environment 64 bits (a Docker image is available if you are on Windows environment) (available both for Datafari CE or Datafari EE)
    (Ubuntu 24.04 is not supported for now because of an issue with the default version of Python installed into this OS (3.12) and Cassandra, see https://gitlab.datafari.com/datafari-community/datafari/-/issues/1007)

  • CentOS or RedHat 8 or 9 and CentOS Stream 8 or 9 (available only for Datafari EE)

Java requirements

  • Java version 11 only mandatory installed on your environment (and you need to set the JAVA_HOME variable for all users and have the java executable in the PATH, see the annex below to view how to do it)

Dependences requirements

Depending on your OS, the list is not the same.

  • For Debian/Ubuntu users :

apt-get install bash curl debconf unzip sudo libc6-dev jq lsof apache2 libapache2-mod-jk iptables iptables-persistent zip iputils-ping systemd procps bc netcat-openbsd -y -q

  • For Almalinux/CentOS users :

yum install -y jq lsof curl perl-Test-Simple perl-version httpd mod_ssl nano iptables-services nc iputils unzip gcc python3-devel bc

Other requirements

  • Increase Open Files limit configuration

    Change the setting in /etc/security/limits.conf : 

    echo 'root soft nofile 100000' >> /etc/security/limits.conf echo 'root hard nofile 100000' >> /etc/security/limits.conf echo 'datafari soft nofile 100000' >> /etc/security/limits.conf echo 'datafari hard nofile 100000' >> /etc/security/limits.conf echo '* soft nofile 100000' >> /etc/security/limits.conf echo '* hard nofile 100000' >> /etc/security/limits.conf echo 'root soft nproc 100000' >> /etc/security/limits.conf echo 'root hard nproc 100000' >> /etc/security/limits.conf echo 'datafari soft nproc 100000' >> /etc/security/limits.conf echo 'datafari hard nproc 100000' >> /etc/security/limits.conf echo '* soft nproc 100000' >> /etc/security/limits.conf echo '* hard nproc 100000' >> /etc/security/limits.conf

    Then reboot the machine to enable those parameters

  • Set the locale setting (in the example with fr_FR but can be replaced with your locale) : 

    apt-get install locales locale-gen fr_FR.UTF-8 dpkg-reconfigure locales

If you have some errors, see the annex below.

Optional requirements

  • Optional: You need a user member of the sudo group to start Datafari (or it can be root user)  :

    visudo # add the line below root ALL=(ALL:ALL) ALL your_user ALL=NOPASSWD: ALL

  • Optional: Make sure that the machine is always up to date (in particular for the email alerts scheduler), by enabling ntpdate, for example : 

    ntpdate 0.fr.pool.ntp.org

ANNEXES

  • Set JAVA_HOME variable

# For example if you want OpenJDK JDK 11 in Debian 10 apt-get install openjdk-11-jdk # Set Java Home nano /etc/profile #in the file add the line : export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64 # Load the file source /etc/profile

  • Troubleshooting for setting the locale
    If you still have an error like "perl: warning: Setting locale failed."
    Do the additionnal steps :
    check the sshd configuration :

    nano /etc/ssh/sshd_config

    and comment the line :

    #AcceptEnv LANG LC_*

    Then relaunch the sshd service :

    /etc/init.d/ssh restart

    Add the locale variables to .bashrc configuration file :

    nano ~/.bashrc

    Add the lines :

    export LC_ALL="fr_FR.UTF-8" export LANG="fr_FR.UTF-8" export LANGUAGE="fr_FR.UTF-8"

    For PostgreSQL : 
    PostgreSQL needs to have the variables LANG and LC_* set. To check them, launch the command :

    locale

    If LC_ALL and LC_TYPE are not filled, enter this (for English language):

    export LC_ALL="en_US.UTF-8" export LC_CTYPE="en_US.UTF-8"

     You can also add the line to /etc/profile then.