summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorSage Weil <sage@inktank.com>2012-06-05 20:16:04 -0700
committerSage Weil <sage@inktank.com>2012-06-05 20:16:04 -0700
commit5b443ebd7fe980b96d42fc229b73c7f0ffe0bbab (patch)
treefb7626a263a1c1fe782bb55293bc6e406781bfff /doc
parentf918049b90eb5194915df7618956beeafce59e05 (diff)
downloadceph-5b443ebd7fe980b96d42fc229b73c7f0ffe0bbab.tar.gz
doc: keyring.bin -> keyring everwhere
Signed-off-by: Sage Weil <sage@inktank.com>
Diffstat (limited to 'doc')
-rw-r--r--doc/config-cluster/authentication.rst22
-rw-r--r--doc/config-cluster/demo-ceph.conf2
2 files changed, 12 insertions, 12 deletions
diff --git a/doc/config-cluster/authentication.rst b/doc/config-cluster/authentication.rst
index c107b5d2d52..672a0a37b6a 100644
--- a/doc/config-cluster/authentication.rst
+++ b/doc/config-cluster/authentication.rst
@@ -20,7 +20,7 @@ Provide a ``keyring`` setting in ``ceph.conf`` like this::
[global]
auth supported = cephx
- keyring = /etc/ceph/keyring.bin
+ keyring = /etc/ceph/keyring
If there is no keyring in the path, generate one.
@@ -30,8 +30,8 @@ To generate a keyring in the default location, use the ``ceph-authtool`` and
specify the same path you specified in the ``[global]`` section of your
``ceph.conf`` file. For example::
- sudo ceph-authtool --create-keyring /etc/ceph/keyring.bin
- sudo chmod +r /etc/ceph/keyring.bin
+ sudo ceph-authtool --create-keyring /etc/ceph/keyring
+ sudo chmod +r /etc/ceph/keyring
Specify Keyrings for each Daemon
--------------------------------
@@ -60,9 +60,9 @@ you need to have a ``client.admin`` key to run ``ceph`` commands.
::
- sudo ceph-authtool /etc/ceph/keyring.bin -n client.admin --gen-key
- sudo ceph-authtool -n client.admin --cap mds 'allow' --cap osd 'allow *' --cap mon 'allow *' /etc/ceph/keyring.bin
- sudo ceph auth add client.admin -i /etc/ceph/keyring.bin
+ sudo ceph-authtool /etc/ceph/keyring -n client.admin --gen-key
+ sudo ceph-authtool -n client.admin --cap mds 'allow' --cap osd 'allow *' --cap mon 'allow *' /etc/ceph/keyring
+ sudo ceph auth add client.admin -i /etc/ceph/keyring
Generate a Key
--------------
@@ -75,7 +75,7 @@ the ``{keyring/path}`` and ``{username}`` below. ::
For example::
- sudo ceph-authtool /etc/ceph/keyring.bin -n client.whirlpool --gen-key
+ sudo ceph-authtool /etc/ceph/keyring -n client.whirlpool --gen-key
.. note: User names are associated to user types, which include ``client``
``admin``, ``osd``, ``mon``, and ``mds``. In most cases, you will be
@@ -85,7 +85,7 @@ List Keys
---------
To see a list of keys in a keyring, execute the following::
- sudo ceph-authtool /etc/ceph/keyring.bin --list
+ sudo ceph-authtool /etc/ceph/keyring --list
A keyring will display the user, the user's key, and the capabilities
associated to the user's key.
@@ -101,18 +101,18 @@ one capability when executing the ``ceph-authtool`` command. Replace the
For example::
- ceph-authtool -n client.whirlpool --cap mds 'allow' --cap osd 'allow rw pool=swimmingpool' --cap mon 'allow r' /etc/ceph/keyring.bin
+ ceph-authtool -n client.whirlpool --cap mds 'allow' --cap osd 'allow rw pool=swimmingpool' --cap mon 'allow r' /etc/ceph/keyring
Add the Keys to your Cluster
----------------------------
Once you have generated keys and added capabilities to the keys, add each of the
keys to your cluster. Replace the ``{usertype.username}`` below. ::
- sudo ceph auth add {usertype.username} -i /etc/ceph/keyring.bin
+ sudo ceph auth add {usertype.username} -i /etc/ceph/keyring
For example::
- sudo ceph auth add client.whirlpool -i /etc/ceph/keyring.bin
+ sudo ceph auth add client.whirlpool -i /etc/ceph/keyring
List Keys in your Cluster
diff --git a/doc/config-cluster/demo-ceph.conf b/doc/config-cluster/demo-ceph.conf
index 6f7048cd5d9..8805df2a815 100644
--- a/doc/config-cluster/demo-ceph.conf
+++ b/doc/config-cluster/demo-ceph.conf
@@ -1,7 +1,7 @@
[global]
; use cephx or none
auth supported = cephx
- keyring = /etc/ceph/keyring.bin
+ keyring = /etc/ceph/keyring
[mon]
mon data = /srv/mon.$id