RPM based
Verify the RPM
Obtain the latest Maverics RPM package. Place the package on the system on which you’d like to install Maverics.
It is a security best practice to verify an RPM before installing it.
Download Strata’s public GPG key:
curl --silent https://ops.strata.io/strata-pub-key.gpg --output strata-pub-key.gpg
Import the key into RPM:
sudo rpm --import strata-pub-key.gpg
Verify the key installation by running:
rpm --query --install gpg-pubkey-ad3f5520-* --queryformat '%{name}-%{version}-%{release} --> %{summary}\n'
Verify the RPM:
rpm --checksig -v maverics.rpm
Install the RPM
To install the Maverics package, run the following command substituting your filename in place of maverics.rpm.
sudo rpm --upgrade --verbose --file maverics.rpm
By default, the Maverics binary is installed in the /usr/local/bin directory. The
default maverics.yaml configuration file is created in the /etc/maverics directory.
After installing Maverics, it will run as a service under systemd. To verify the Maverics service is running, run the following command.
sudo systemctl status maverics
If your Orchestrator installed successfully, you should see message similar to this.
Redirecting to /bin/systemctl status maverics.service
● maverics.service - Maverics
Loaded: loaded (/etc/systemd/system/maverics.service; enabled; vendor preset: disabled)
Active: active (running) since Thu 2020-08-13 16:48:01 UTC; 24h ago
Main PID: 330772 (maverics)
Tasks: 5 (limit: 11389)
Memory: 14.0M
CGroup: /system.slice/maverics.service
└─330772 /usr/local/bin/maverics --config /etc/maverics/maverics.yaml
If the Maverics service fails to start, execute the following command to investigate the problem:
journalctl --identifier=maverics --reverse
The most recent log entry will appear at the beginning of the output.
Installing with a custom user/group
If you need to run the Orchestrator under a specific user or group, set MAVERICS_USER and MAVERICS_GROUP environment variables before the installation. For example:
export MAVERICS_USER=maverics-service-acct
export MAVERICS_GROUP=id_services
sudo --preserve-env rpm --upgrade --verbose --file maverics.rpm
The user and group must already exist before you start the installation, and the variables will need to be set to the same values when you upgrade. If variables are not set, a default maverics user and group are created and used.
If you see user or group related errors during or after installation, or if a service fails to start with an error such as Failed to start maverics.service: Unit maverics.service has a bad unit file setting., uninstall with the command sudo rpm --erase --noscripts maverics then reinstall with valid user and group names.
Update
If you need to update your Orchestrator instance to use the latest version of the software, follow these steps:
Obtain the latest Maverics RPM package. Place the package on the system where Maverics will be updated.
To update the Maverics package, run the following command substituting your filename in place of maverics.rpm.
sudo rpm --upgrade --verbose --file maverics.rpm
For users upgrading from Maverics prior to v0.16.0, you will also need to run the following commands:
sudo mv /etc/systemd/system/maverics.service.rpmnew /etc/systemd/system/maverics.service
sudo systemctl daemon-reload
sudo systemctl restart maverics
To verify the maverics service is running, run the following command.
sudo systemctl status maverics
Uninstall
If you need to uninstall your Orchestrator instance from your machine, follow these steps:
To uninstall the Maverics package, run the following command.
sudo rpm --erase maverics
To verify the service does not exist anymore, run the following command.
sudo systemctl status maverics
If your Orchestrator was successfully uninstalled, you should see a message similar to this.
Unit maverics.service could not be found.
DEB based
The Debian package uses the following install paths:
/etc/maverics/maverics.env: Orchestrator environment variables/etc/maverics/maverics.yaml: Orchestrator config file/etc/systemd/system/maverics.service: Orchestrator Systemd unit file/usr/local/bin/maverics: Orchestrator binary
Verify the .deb package
Download and import Strata’s public key:
curl --silent https://ops.strata.io/strata-pub-key.gpg --output strata-pub-key.gpg
gpg --import strata-pub-key.gpg
Verify the .deb.sig file
gpg --verify --trusted-key BC4E16AE1DFF76345272DB209554157EAD3F5520 /path/to/maverics.deb.sig /path/to/maverics.deb
Install
To install, run the following command:
sudo apt install /path/to/maverics.deb
Uninstall
To uninstall and keep all configuration files intact, use:
To uninstall and remove configuration files added during the initial installation, use:
If you perform apt remove maverics and manually delete configuration files after uninstalling, you will not be able to reinstall the orchestrator until you run apt purge maverics.