Installation Guide using Salt
Deploy SODA using Salt. This is an experimental solution using repeatable patterns of jinja/yaml to deploy cloud-native stack using infrastructure as code.
Software versions
Verified on CENTOS-7, UBUNTU-18, and OPENSUSE-15 with Salt 2018.3 and 2019.2 releases.
Solution View
Reference Vagrant setup
Refer to Hacking. Prefer a minimum of 6GB+4CPU per virutalized hosts.
Procedure
Deploy SODA using the steps below. The expected installer duration is 20-55 minutes depending on your network bandwith and compute resources (we recommend at least 4CPU x 8G ram x 60G rootdisk).
Install Salt on UBUNTU/CENTOS/OpenSUSE_15
curl -o salter.sh https://raw.githubusercontent.com/opensds/opensds-installer/master/salt/salter.sh && sudo bash salter.sh -i bootstrap && sudo bash salter.sh -i salter
Reboot if kernel got major-upgraded. If in doubt, reboot anyway.
init 6
Review site deployment data to double check ipv4 adddres. Set auth_strategy: noauth if not using keystone.
ip addr
sudo vi /srv/salt/opensds/site.j2
Deploy SODA on UBUNTU/CENTOS/OpenSUSE_15
sudo bash salter.sh -i opensds
How to test SODA cluster
Check openSDS services are running (check logs/status if necessary)
sudo -s
docker ps -a
ps -ef | grep osds
systemctl list-unit-files | grep opensds
Check openSDS services which start slowly first time:
journalctl -u opensds-multi-cloud --follow
journalctl -u opensds-cinder --follow
Configure SODA CLI tool:
export OPENSDS_AUTH_STRATEGY=noauth
export OPENSDS_ENDPOINT=http://127.0.0.1:50040 (or your <primary_host_ip)
Check if the pool resource is available
osdsctl pool list
Then create a default profile:
osdsctl profile create '{"name": "default", "description": "default policy", "storageType": "block"}'
Create a volume:
osdsctl volume create 1 --name=test-001
List all volumes:
osdsctl volume list
Delete the volume:
osdsctl volume delete <your_volume_id>
Dashboard
The SODA dashboard is available at http://127.0.0.1:8088 or http://
Please login to the dashboard using the default admin credentials: admin/opensds@123. Create tenant, user, and profiles as admin. Multi-Cloud is also supported by dashboard.
Now logout from dashboard (as admin) and login the dashboard again as a non-admin user to create volume, snapshot, expand volume, create volume from snapshot, create volume group.
How to purge and clean SODA cluster
sudo /srv/salt/opensds/salter.sh -r opensds
sudo /srv/salt/opensds/salter.sh -r devstack # optional