Install: CentOS/RedHat/Fedora
This page shows you how to install Terraspace on CentOS, RedHat, Fedora and other Linux systems that use the yum-based package manager.
CentOS/RedHat/Fedora
Configure repo
sudo su
curl -so /etc/yum.repos.d/boltops.repo https://yum.boltops.com/boltops.repo
rpm --import https://yum.boltops.com/boltops-key.public
Install
yum install -y terraspace
Upgrade
cd terraspace-project
vim Gemfile # edit the terraspace version if it's pinned
bundle update terraspace
Uninstall
yum remove -y terraspace
Generated Wrappers
By default, the standalone installer creates wrapper scripts in /usr/local/bin. Here are some of them:
/usr/local/bin/bundle
/usr/local/bin/gem
/usr/local/bin/rspec
/usr/local/bin/ruby
/usr/local/bin/terraspace
Most users have /usr/local/bin configured in their PATH. So these wrappers work immediately. If you wish not to have these wrappers generated for you, set export TS_WRAPPERS=0 before running the installer.
Important: If you have ruby wrappers in /usr/local/bin already, the installer will overwrite them.
Why Upgrade with bundle?
You should use bundle to upgrade terraspace because it’ll ensure that all of your project gem dependencies are installed, not just terraspace. The standalone installs an embedded version of ruby, bundle, and terraspace in /opt/terraspace/embedded. It’ll work on the first install on a clean machine, but is will likely not work when upgrading because the embedded install has a different set of gem dependencies than your project’s Gemfile.lock.
Fedora Notes
For Fedora, you may also need the libxcrypt-compat package.
dnf install libxcrypt-compat -y
Or you’ll get this error:
$ terraspace -h
/opt/terraspace/embedded/bin/ruby: error while loading shared libraries: libcrypt.so.1: cannot open shared object file: No such file or directory
$
Fedora is a bleeding edge distro and is quicker about upgrading their system. The libcrypt.so has been removed. The libxcrypt-compat package installs it back.
Amazon Linux 2 Notes
The standalone installer does not support Amazon Linux 1. Please use Amazon Linux 2 instead.
Rpm Install
You can also download the rpm package and install it directly. Here are the commands:
wget https://yum.boltops.com/packages/terraspace/terraspace-latest.rpm
sudo su
rpm -ivh terraspace-latest.rpm
terraspace -h
You can check terraspace-latest.rpm.metadata.json to verify the package checksum. Here’s the checksum command.
sha256sum terraspace-latest.rpm
To uninstall
rpm -e terraspace-latest.rpm
