From 3eea9104af5b7a1618e5eaef4f20d6c28ff1136f Mon Sep 17 00:00:00 2001 From: John Wilkins Date: Tue, 28 Aug 2012 11:41:59 -0700 Subject: [PATCH] doc: Added internal references. Clarified language in disk prepare. Signed-off-by: John Wilkins --- doc/config-cluster/chef.rst | 42 ++++++++++++++++++++++++++++++------- 1 file changed, 35 insertions(+), 7 deletions(-) diff --git a/doc/config-cluster/chef.rst b/doc/config-cluster/chef.rst index c2d394b0b533d..2840391931574 100644 --- a/doc/config-cluster/chef.rst +++ b/doc/config-cluster/chef.rst @@ -5,6 +5,8 @@ We use Chef cookbooks to deploy Ceph. See `Managing Cookbooks with Knife`_ for details on using ``knife``. For Chef installation instructions, see `Installing Chef`_. +.. _clonecbs: + Clone the Required Cookbooks ---------------------------- @@ -14,6 +16,8 @@ To get the cookbooks for Ceph, clone them from git.:: git clone https://github.com/opscode-cookbooks/apache2.git git clone https://github.com/ceph/ceph-cookbooks.git ceph +.. _addcbpaths: + Add the Required Cookbook Paths ------------------------------- @@ -35,6 +39,8 @@ Becomes:: '/some/other/path/to/cookbooks/' ] +.. _installcbs: + Install the Cookbooks --------------------- @@ -43,6 +49,8 @@ To install Ceph, you must upload the Ceph cookbooks and the Apache cookbooks knife cookbook upload apache2 ceph +.. _configcephenv: + Configure your Ceph Environment ------------------------------- @@ -110,6 +118,8 @@ Advanced users (i.e., developers and QA) may also add ``"ceph_branch": "{branch} to ``default-attributes``, replacing ``{branch}`` with the name of the branch you wish to use (e.g., ``master``). +.. configroles: + Configure the Roles ------------------- @@ -125,6 +135,8 @@ their respective role files. :: knife role from file roles/ceph-mds.rb knife role from file roles/ceph-radosgw.rb +.. _confignodes: + Configure Nodes --------------- @@ -155,8 +167,9 @@ Then, add at least one of:: "role[ceph-mds]" "role[ceph-radosgw]" -If you add more than one role, separate them with a comma. Replace the -``{hostname}`` setting of the ``name`` key to the host name for the node. :: +If you add more than one role, separate them with a comma. Run ``hostname`` +on your command line, and replace the ``{hostname}`` setting of the ``name`` +key to the host name for the node. :: { "chef_environment": "Ceph", @@ -173,18 +186,30 @@ If you add more than one role, separate them with a comma. Replace the ] } +.. _prepdisks: + Prepare OSD Disks ----------------- -For the Ceph 0.48 Argonaut release, install ``gdisk`` and configure the OSD -hard disks for use with Ceph. Replace ``{fsid}`` with the UUID you generated -while using ``uuidgen -r``. +Configuring a node with an OSD role tells Chef that the node will run at +least one OSD. However, you may run many OSDs on one host. For example, +you may run one ``ceph-osd`` daemon for each data disk on the system. +This step prepares the OSD disk(s) and tells Chef how many OSDs the +node will be running. -.. important: This procedure will erase all information in ``/dev/{disk}``. -:: +For the Ceph 0.48 Argonaut release, install ``gdisk``:: sudo apt-get install gdisk + +For the Ceph 0.48 Argonaut release, on each hard disk that will store data for +an OSD daemon, configure the hard disk for use with Ceph. Replace ``{fsid}`` +with the UUID you generated while using ``uuidgen -r``. + +.. important: This procedure will erase all information in ``/dev/{disk}``. + +:: + sudo sgdisk /dev/{disk} --zap-all --clear --mbrtogpt --largest-new=1 --change-name=1:'ceph data' --typecode=1:{fsid} Create a file system and allocate the disk to your cluster. Specify a @@ -202,6 +227,8 @@ Finally, simulate a hotplug event. :: sudo udevadm trigger --subsystem-match=block --action=add +.. _runchefclient: + Run ``chef-client`` on each Node -------------------------------- @@ -210,6 +237,7 @@ on each node. For example:: sudo chef-client +.. _proceedtoops: Proceed to Operating the Cluster -------------------------------- -- 2.39.5