1. CentOS or RHEL 8 instructions
2. CentOS or RHEL 7 instructions
3. Ubuntu 20.04 instructions
4. Ubuntu 18.04 instructions
5. Ubuntu 16.04 instructions
6. Ubuntu 14.04 instructions
CentOS and Red Hat Enterprise Linux (64-bit)
Install SPX on CentOS or RHEL 8
Important: The EPEL repository is required to install SPX on CentOS or RHEL.
Note: SPX supports DKMS, which allows you to build the snapshot driver for the kernel you are using.
1. Install the EPEL repository. Run the command:
sudo yum install epel-release
Note: Most CentOS and RHEL Linux installs include the EPEL components. However, if needed, you may manually download and install the EPEL repositories. Go to the Fedora website, https://fedoraproject.org/wiki/EPEL, to get the EPEL package. Then run the above command.
If fprintd-pam is installed, then you may encounter a conflict with SPX. To avoid this you can uninstall fprintd-pam:
sudo yum remove fprintd-pam -y
Note: If this command displays errors, skip to the next step.
2. Install and configure our repo on the system. This only needs to be done once.
Open a terminal and type the following:
wget https://downloads.storagecraft.com/spx/CentOS8/storagecraft-repo-latest.rpm -O storagecraft-repo-latest.rpm
sudo yum install storagecraft-repo-latest.rpm -y
3. Install the kernel headers required for DKMS installation.
This package contains the kernel headers:
To install kernel-devel, use this command to make sure you have your headers:
sudo yum install kernel-devel-$(uname -r)
If this fails (because it is locked in the vault), you need to manually download the kernel-devel package from the vault: http://archive.kernel.org/centos-vault/
4. Install SPX and the snapshot driver along with DKMS:
sudo yum install spx kmod-stcvsm-dkms
Note: The above command line does a clean install of SPX. If SPX and a snapshot driver are already installed, a one-time manual DKMS installation is required.
To install only DKMS:
sudo yum install kmod-stcvsm-dkms
Important: This assumes the appropriate kernel-devel package has been installed. If it hasn't been installed, CentOS might install kernel-bug-devel, which will cause the snapshot to fail.
5. Verify that the latest version of SPX installed:
rpm -qi spx
6. Start the service:
sudo systemctl start spx
7. Add the current user to the newly created SPX management group:
sudo /usr/bin/gpasswd -a $USER spx
8. To enable SPX remote management:
sudo /opt/StorageCraft/spx/bin/spx_cli remote --enable
The repo rpm package only needs to be installed once. After that, install subsequent builds by using:
sudo yum update spx
If you get an error message saying there's a conflict with a package, remove it:
sudo yum remove <packagename>
And then repeat the install.