Linux
Hackolade is a desktop application with a GUI. By default it requires a Desktop environment like Gnome, Mate, Xfce etc... Given the nature of Linux that is often used to run servers (especially on Cloud infrastructures), please note that it is also possible to only run Hackolade in CLI mode even though a better solution might be to leverage our Docker deployment for that purpose.
Note: You must be aware that the installation of the software is a tacit acceptance of our Terms and Conditions and End-User License Agreement.
The application is shipped as a .zip file. To install, you simply unzip the file in the folder of your choice, then start the executable.
The application can be run from the terminal or from a script by terminal:
/path/to/unzipped/folder/Hackolade
Installation
Pre-requisites
Hackolade requires some packages to be installed on your system to run properly.
On Red Hat / Fedora / Centos / Amazon Linux (and other RPM packaging based Linux distributions)
The following .rpm packages need to be installed:
yum install at-spi2-atk cups-libs libdrm libgbm gtk3 alsa-lib libsecret
On Ubuntu / Debian (and other Deb packaging based Linux distributions)
The following .deb packages need to be installed
apt-get install \
libgbm1 \
libglib2.0-0 \
libgtk-3-0 \
libkrb5-3 \
libnss3 \
libnss-wrapper \
libsecret-1-0 \
libssl-dev
On servers
If you want to run Hackolade only in cli on a server without a GUI environment installed you'll still require some more tooling:
yum install Xvfb
or
apt-get install xvfb
Installation
Download the latest release
wget https://s3-eu-west-1.amazonaws.com/hackolade/current/Hackolade-linux-x64.zip
Then unzip:
unzip Hackolade-linux-x64.zip
rm Hackolade-linux-x64.zip
cd Hackolade-linux-x64
Notice: File “chrome-sandbox” must be owned by root user and have permissions 4755.
sudo chown root:root chrome-sandbox
sudo chmod 4755 chrome-sandbox
The application must be executed by a non-root user.
Start application
With a Desktop GUI environment
You just have to execute in the terminal. The application can be run from the terminal or from a script by terminal from the extracted folder /path/to/unzipped/folder/Hackolade
./Hackolade --help
On a server with XVFB
xvfb-run ./Hackolade --help
FAQ
Unable to run on AWS Amazon Linux 2
Hackolade is an Electron application that has components that are incompatible with Amazon Linux 2. We advise you to use EC2 instances running Amazon Linux 3 AMI instead.
Unable to run from File Manager
Unfortunately, the issue with running executable file from the file manager still is not resolved: electron/electron#15406
How to create a Desktop file for easier access
To workaround the previous issue or ease your user life you can create a desktop file to launch the application: https://stackoverflow.com/questions/55060402/electron-executable-not-recognized-by-nautilus
Create a file called myapp.desktop with the following contents.\
[Desktop Entry]
Name=My Application
Exec=/path/to/binary
Terminal=false
Type=Application
StartupNotify=true
Encoding=UTF-8
Then, mark the desktop file executable by issuing chmod +x myapp.desktop. Double clicking the file should launch the application as expected.
Run Hackolade over remote connection
In case of remote connection, you need VNC server: https://wiki.centos.org/HowTos/VNC-Server
CentOS 7 with no GUI
For CentOS 7 if GUI was not selected during installation, a complex procedure is documented below:
Pre-requisites
sudo yum update
sudo yum install gcc gcc-c++ kernel-devel make bzip2 clang dbus-devel gtk3-devel \
libgnome-keyring-devel xorg-x11-server-utils libcap-devel \
cups-devel libXtst-devel alsa-lib-devel libXrandr-devel \
nss-devel libsecret-devel libnotify-devel wget unzip
Copy and replace file in the directory (link):
/lib64/libstdc++.so.6
https://drive.google.com/file/d/17aJr9wHbl_xPtCZpyM7xygiObC7lzHTB/view?usp=sharing
sudo yum groupinstall “GNOME Desktop”
echo "exec gnome-session" >> ~/.xinitrc
Starting GNOME:
startx
Notice: you should start GNOME by a non-root user
https://www.techrepublic.com/article/how-to-install-a-gui-on-top-of-centos-7/
Installation
wget “https://s3-eu-west-1.amazonaws.com/hackolade/current/Hackolade-linux-x64.zip*” -O hackolade.zip*
unzip hackolade.zip
rm hackolade.zip
cd Hackolade-linux-x64
chown root:root chrome-sandbox
chmod 4755 chrome-sandbox
Notice:
File “chrome-sandbox” must be owned by root user and have permissions 4755.
The application must be executed by a non-root user.