Link Search Menu Expand Document

Advanced Installation

Table of Contents

This page provides several advanced installation options should you require them.

Scripted installation for Linux-based systems:

Use the following script to install the Elastio CLI and elastio-snap:

sudo /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/elastio/elastio-stack/master/scripts/install-elastio.sh)"

We recommend that you install the Elastio CLI together with the elastio-snap driver. However, they can be installed separately.

Use the following script to install the Elastio CLI only:

sudo /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/elastio/elastio-stack/master/scripts/install-elastio.sh) $0" -- -c

Here is the installation script for the elastio-snap driver only:

sudo /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/elastio/elastio-stack/master/scripts/install-elastio.sh) $0" -- -d

To uninstall both the Elastio CLI and elastio-snap, use the following script:

sudo /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/elastio/elastio-stack/master/scripts/install-elastio.sh) $0" -- -u

Elastio CLI manual installation

You can also install the Elastio CLI manually as follows:

RHEL/CentOS

Note: You must use the EPEL repo for the RHEL installation.

The repository to install package, elastio-repo, is available for CentOS/RHEL 7 and later. Use the following script to install this repo:

sudo yum localinstall https://repo.assur.io/master/linux/rpm/CentOS/$(rpm -E %rhel)/x86_64/Packages/elastio-repo-0.0.2-1.el$(rpm -E %rhel).noarch.rpm

After this repository installation has been completed, you can install the Elastio CLI and elastio-snap as follows:

Use the following command to install the Elastio CLI:

sudo yum install elastio

Use the following command to install elastio-snap:

sudo yum install elastio-snap-utils

Note: It is recommended that you install the Elastio package with the elastio-snap-utils package on Linux-based operating systems, such as CentOS/RHEL 8 and Fedora. In most cases, these systems have an option install_weak_deps=True. Therefore, installing elastio-snap is unnecessary because the elastio-snap-utils package is installed together with Elastio.

Use this command to install the Elastio CLI package without the recommended elastio-snap-utils dependency:

sudo yum --setopt=install_weak_deps=False install elastio

The elastio-snap-utils package depends on the dkms-elastio-snap kernel driver on CentOS 7. In turn, the dkms-elastio-snap kernel driver has a dependency on the kernel-devel package. Therefore, both the kernel-devel package and the dkms-elastio-snap kernel driver must be installed before installing the elastio-snap-utils package.

Note: The kernel-devel package version must equal the kernel version of the running OS (operating system). It is worth remembering that yum always installs the most recently available versions of any packages or software.

Secondly, please install the kernel-devel-$(uname -r) package in addition to the elastio-snap-utils package under the following circumstances:

  • If your machine is not running the most recent Linux kernel available through yum, CentOs’s primary package management tool, and
  • You aren’t going to use yum to update the Linux kernel and reboot the machine to deploy the fresh kernel before the elastio-snap installation.
  • Or you are not sure about the freshness of the kernel; please install the kernel-devel-$(uname -r) package in addition to the elastio-snap-utils package.

Add the kernel-devel-$(uname -r) package to the current kernel and kernel-devel for all the subsequent kernel updates if you are going to update the Linux kernel and package after installing elastio-snap. You must also use this command to install elastio-snap instead of the command highlighted above:

sudo yum install kernel-devel-$(uname -r) kernel-devel elastio-snap-utils

Amazon Linux

The repository to install the elastio-repo is available for Amazon Linux 2.

Use the following command to install this repo:

sudo yum localinstall https://repo.assur.io/master/linux/rpm/Amazon/$(rpm -E %amzn)/x86_64/Packages/elastio-repo-0.0.2-1.amzn$(rpm -E %amzn).noarch.rpm

The elastio-snap-utils package depends on the dkms-elastio-snap kernel driver on Amazon Linux 2. Additionally, the dkms-elastio-snap kernel driver has a dependency on the kernel-devel package. As a result, both the kernel-devel package and the dkms-elastio-snap kernel driver must be installed before installing the elastio-snap-utils package.

Note: The kernel-devel package version must equal the kernel version of the running OS (operating system). It is worth remembering that yum always installs the most recently available versions of any packages or software.

Also, please install the kernel-devel-$(uname -r) package in addition to the elastio-snap-utils package under the following circumstances:

  • If your machine is not running the most recent Linux kernel available through yum, and
  • You aren’t going to use yum to update the Linux kernel and reboot the machine to deploy the fresh kernel before the elastio-snap installation.
  • Or you are not sure about the freshness of the kernel; please install the kernel-devel-$(uname -r) package in addition to the elastio-snap-utils package

Add the kernel-devel-$(uname -r) package to the current kernel and kernel-devel for all the subsequent kernel updates if you are going to update the Linux kernel and package after installing elastio-snap. You must also use this command to install elastio-snap instead of the command highlighted above:

sudo yum install kernel-devel-$(uname -r) kernel-devel elastio-snap-utils

After these packages and drivers have been installed, you can install the Elastio CLI and elastio-snap.

Use the following command to install the Elastio CLI:

sudo yum install elastio

Use the following command to install elastio-snap:

sudo yum install elastio-snap-utils

Fedora

The repository install package, elastio-repo, is available for Fedora 31 and later.

Note: It is recommended that you install the Elastio package with the elastio-snap-utils package on Linux-based operating systems, such as CentOS/RHEL 8 and Fedora with the dnf package manager. In most cases, these systems have an option install_weak_deps=True. Therefore, installing elastio-snap is unnecessary because the elastio-snap-utils package is installed together with the Elastio CLI.

Use this command to install this repo:

sudo dnf install https://repo.assur.io/master/linux/rpm/Fedora/$(rpm -E %fedora)/x86_64/Packages/elastio-repo-0.0.2-1.fc$(rpm -E %fedora).noarch.rpm

After this repo has been installed, you can install the Elastio CLI and elastio-snap.

This command installs the Elastio CLI:

sudo dnf install elastio

The following command installs elastio-snap:

sudo dnf install elastio-snap-utils

Use this command to install the Elastio package without the recommended elastio-snap-utils dependency:

sudo dnf --setopt=install_weak_deps=False install elastio

Debian / Ubuntu LTS

The repository install package elastio-repo is available for Debian 8 (Jessie) and later as well as Ubuntu LTS starting from 16.04 (Xenial) and later.

Ubuntu

Run the following script to install the necessary packages and drivers as well as the Elastio repo, Elastio CLI, and elastio-snap-utils package:

sudo apt-get update

sudo apt-get install wget gnupg

debian_ver=$(grep VERSION_ID /etc/os-release | tr -cd [0-9])

[ $debian_ver > 1000 ] && debian_ver=$(($debian_ver/200))

wget https://repo.assur.io/master/linux/deb/Debian/${debian_ver}/pool/elastio-repo_0.0.2-1debian${debian_ver}_all.deb

sudo dpkg -i elastio-repo_0.0.2-1debian${debian_ver}_all.deb

sudo apt-get update

sudo apt-get install elastio

sudo apt-get install elastio-snap-utils

Debian

For Debian, run the following script to install the necessary prerequisites:

Note: In most cases, this step is not necessary, except when using pure docker.

sudo apt-get update

sudo apt-get install wget gnupg

#to detect Debian version:

debian_ver=$(grep VERSION_ID /etc/os-release | tr -cd [0-9])

Use this script to down and install the repo package:

wget https://repo.assur.io/master/linux/deb/Debian/${debian_ver}/pool/elastio-repo_0.0.2-1debian${debian_ver}_all.deb

sudo dpkg -i elastio-repo_0.0.2-1debian${debian_ver}_all.deb

sudo apt-get update

Use the following commands to install the Elastio CLI and elastio-snap:

sudo apt-get install elastio
sudo apt-get install elastio-snap-utils

Once these commands have completed running, the Elastio CLI has successfully been installed.

Note: It is recommended that the Elastio CLI is installed together with the elastio-snap driver. However, it is not necessary.

Use the following command to install the Elastio package without the recommended elastio-snap-utils dependency:

sudo apt-get --no-install-recommends install elastio