RepoMirrors/ceph
1
0
Fork 0
mirror of https://github.com/ceph/ceph synced 2025-02-23 02:57:21 +00:00
Code Issues Packages Projects Releases Wiki Activity

doc: Add RGW quick start info

Browse Source 
Add details of how to use ceph-deploy to deploy the CivetWeb-based
RGW present in Hammer.

Signed-off-by: Travis Rhoden <trhoden@redhat.com>
This commit is contained in:
Travis Rhoden 2015-03-20 17:07:36 -04:00
parent 8041636b72
commit ab647bd520
2 changed files with 59 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
doc/start/quick-ceph-deploy.rst
View File

@ -100,6 +100,10 @@ configuration details, perform the following steps using ``ceph-deploy``.
- ``{cluster-name}.client.admin.keyring``
- ``{cluster-name}.bootstrap-osd.keyring``
- ``{cluster-name}.bootstrap-mds.keyring``
- ``{cluster-name}.bootstrap-rgw.keyring``
.. note:: The bootstrap-rgw keyring is only created during installation of clusters
running Hammer or newer
#. Add two OSDs. For fast setup, this quick start uses a directory rather
@ -270,6 +274,38 @@ For example::
with multiple metadata servers.
Add an RGW Instance
-------------------
To use the :term:`Ceph Object Gateway` component of Ceph, you must deploy an
instance of :term:`RGW`. Execute the following to create an new instance of
RGW::
ceph-deploy rgw create {gateway-node}
For example::
ceph-deploy rgw create node1
.. note:: This functionality is new with the **Hammer** release, and also with
``ceph-deploy`` v1.5.23.
By default, the :term:`RGW` instance will listen on port 7480. This can be
changed by editing ceph.conf on the node running the :term:`RGW` as follows:
.. code-block:: ini
[client]
rgw frontends = civetweb port=80
To use an IPv6 address, use:
.. code-block:: ini
[client]
rgw frontends = civetweb port=[::]:80
Adding Monitors
---------------

29
doc/start/quick-rgw.rst
View File

@ -2,10 +2,27 @@
Quick Ceph Object Storage
===========================
At this time, ``ceph-deploy`` does not provide a rapid installation for
:term:`Ceph Object Storage`. To install a :term:`Ceph Object Gateway`,
see `Install Ceph Object Gateway`_. To configure a Ceph Object Gateway,
see `Configuring Ceph Object Gateway`_.
To use the :term:`Ceph Object Storage` Quick Start guide, you must have executed the
procedures in the `Storage Cluster Quick Start`_ guide first. Make sure that you
have at least one :term:`RGW` instance running.
.. _Install Ceph Object Gateway: ../../install/install-ceph-gateway
.. _Configuring Ceph Object Gateway: ../../radosgw/config
Configure new RGW instance
==========================
The :term:`RGW` instance created by the `Storage Cluster Quick Start`_ will run using
the embedded CivetWeb webserver. ``ceph-deploy`` will create the instance and start
it automatically with default parameters.
To administer the :term:`RGW` instance, see details in the the
`RGW Admin Guide`_.
Additional details may be found in the `Configuring Ceph Object Gateway`_ guide, but
the steps specific to Apache are no longer needed.
.. note:: Deploying RGW using ``ceph-deploy`` and using the CivetWeb webserver instead
of Apache is new functionality as of **Hammer** release.
.. _Storage Cluster Quick Start: ../quick-ceph-deploy
.. _RGW Admin Guide: ../../radosgw/admin
.. _Configuring Ceph Object Gateway: ../../radosgw/config