From 8a1e2e548b5cbfd4ef6ae3463275baec77692831 Mon Sep 17 00:00:00 2001 From: Frode Nordahl Date: Tue, 5 Jun 2018 08:42:19 +0200 Subject: [PATCH] Update README.md with information on initializing disks Weed out some references to the now deprecated `ceph` charm. Add example of juju storage usage and reference to juju storage documentation. Change-Id: Ia9955e2b49589072fd2e1d265a88439d4aebe511 --- README.md | 32 ++++++++++++++++++++++---------- 1 file changed, 22 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index edc26e05..a3f22bf8 100644 --- a/README.md +++ b/README.md @@ -5,8 +5,8 @@ Ceph is a distributed storage and network file system designed to provide excellent performance, reliability, and scalability. This charm deploys additional Ceph OSD storage service units and should be -used in conjunction with the 'ceph' charm to scale out the amount of storage -available in a Ceph cluster. +used in conjunction with the 'ceph-mon' charm to scale out the amount of +storage available in a Ceph cluster. Usage ===== @@ -18,6 +18,10 @@ cluster:: A list of devices that the charm will attempt to detect, initialise and activate as ceph storage. + If the charm detects pre-existing data on a device it will go into a + blocked state and the operator must resolve the situation utilizing the + `list-disks`, `zap-disk` and/or `blacklist-*` actions. + This this can be a superset of the actual storage devices presented to each service unit and can be changed post ceph-osd deployment using `juju set`. @@ -25,20 +29,28 @@ cluster:: For example:: ceph-osd: + options: osd-devices: /dev/vdb /dev/vdc /dev/vdd /dev/vde -Boot things up by using:: +Example utilizing Juju storage:: - juju deploy -n 3 --config ceph.yaml ceph + ceph-osd: + storage: + osd-devices: cinder,20G -You can then deploy this charm by simple doing:: +Please refer to [Juju Storage Documentation](https://docs.jujucharms.com/devel/en/charms-storage) for details on support for various storage providers and cloud substrates. - juju deploy -n 10 --config ceph.yaml ceph-osd - juju add-relation ceph-osd ceph +How to deploy:: -Once the ceph charm has bootstrapped the cluster, it will notify the ceph-osd -charm which will scan for the configured storage devices and add them to the -pool of available storage. + juju deploy -n 3 ceph-osd + juju deploy ceph-mon --to lxd:0 + juju add-unit ceph-mon --to lxd:1 + juju add-unit ceph-mon --to lxd:2 + juju add-relation ceph-osd ceph-mon + +Once the 'ceph-mon' charm has bootstrapped the cluster, it will notify the +ceph-osd charm which will scan for the configured storage devices and add them +to the pool of available storage. Network Space support =====================