ceph-workbench¶
ceph-workbench is a GPLv3+ Licensed command-line toolbox for Ceph.
Installation¶
Install Docker http://docs.docker.com/engine/installation/
Copy the following shell function to
~/.bashrc:eval "$(docker run dachary/ceph-workbench install)"
Verify that it works:
ceph-workbench --help
Optionally link ceph-workbench with your OpenStack tenant (for use with the
ceph-qa-suitesubcommand:Download your
openrc.shfile by clicking on the “Download OpenStack RC File” button, which can be found in the “API Access” tab of the “Access & Security” dialog of the OpenStack Horizon dashboard.Create a
~/.ceph-workbenchdirectory, set its permissions to 700, and move theopenrc.shfile into it. Make sure that the filename is exactly ~/.ceph-workbench/openrc.sh.Edit the file so it does not ask for your OpenStack password interactively. Comment out the relevant lines and replace them with something like:
export OS_PASSWORD="aiVeth0aejee3eep8rogho3eep7Pha6ek"
User Guide¶
The document Contributing to Ceph: A Guide for Developers explains the context in
which ceph-workbench can be used.
Contributor Guide¶
If you want to contribute to ceph-workbench, this part of the documentation is for
you.