https://github.com/quobyte/quobyte-ansible
Ansible based Quoybte installation. Idempotent playbooks to install and configure a Quoybte storage cluster.
https://github.com/quobyte/quobyte-ansible
Last synced: about 1 year ago
JSON representation
Ansible based Quoybte installation. Idempotent playbooks to install and configure a Quoybte storage cluster.
- Host: GitHub
- URL: https://github.com/quobyte/quobyte-ansible
- Owner: quobyte
- License: other
- Created: 2021-10-04T07:14:38.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2025-07-16T11:26:04.000Z (about 1 year ago)
- Last Synced: 2025-07-17T15:25:02.967Z (about 1 year ago)
- Language: Jinja
- Size: 85.9 KB
- Stars: 3
- Watchers: 8
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Ansible based Quobyte installer
This collection of playbooks installs a Quobyte cluster from scratch.
In depth documentation for Quobyte can be found here:
[Quobyte Documentation](https://support.quobyte.com/docs/16/latest/index.html).
Before installing it is recommended reading the [prerequisites section](https://support.quobyte.com/docs/16/latest/installation_overview.html#installation-prerequisites) of that documentation.
## Installing Quobyte
### Step one: Adjust Inventory and Variables
You can use ``` inventory.yaml ``` as an example and adjust it to your needs. Within this file you will
line out how your Quobyte cluster will look like.
You can decide which nodes will run data services, metadata services and so on.
The second part to consider is the variables file ``` vars/ansible-vars ```.
You can decide here which devices will hold your metadata, the credentials for a Quobyte superuser account
you and so on.
With only these two files in place you can start the installation.
### Step two: Install the Storage Cluster
All your playbooks can be executed using the following command:
```
$ ansible-playbook -i inventory.yaml
```
You can choose to install these playbooks step by step or all at once. For example
```
$ ansible-playbook -i inventory.yaml 00_install_quobyte_server.yaml 01_setup_coreservices.yaml 02_create_superuser.yaml 03_add_metadataservices.yaml 04_add_dataservices.yaml 05_optional_tune-cluster.yaml
```
would result in a Quobyte setup that is ready to use and has already ensured some system tuning parameters.
The same way you can for example add a license, create volumes etc.
## Lifecycle management
All playbooks are designed to be idempotent. You can run them more than once and can expect the same results.
### Adding Dataservices
Should your installation require more dataservices you can use the following procedure:
1) Add nodes to the inventory
2) Run two playbooks:
```
$ ansible-playbook -i inventory.yaml 00_install_quobyte_server.yaml 04_add_dataservices.yaml
```
This will only result in changes on the newly added dataservices, they will be part of the cluster afterwards with all empty devices added as datadevices.
### Adding more Storage Devices
If more disks are inserted into a server (either virtual or physical) you can re-run also the "add_dataservices" playbook:
```
$ ansible-playbook -i inventory.yaml 04_add_dataservices.yaml
```
All empty devices are then also part of the cluster.
### Uninstall
There is one playbook you can use to get rid of a Quobyte installation:
```
$ ansible-playbook -i inventory.yaml helper/0x_wipe_cluster.yaml
```
This playbook erases all data on all Quobyte devices, stops services and removes binaries.
You can use it for example if you want to start from scratch with a new installation.
### Notes for Rocky Linux
Using these playbooks with Rocky Linux not only "ansible-core" needs to be installed, but also
the community repositories:
```
ansible-galaxy collection install community.general
```