From: Barbora Ančincová Date: Tue, 13 Oct 2015 10:43:06 +0000 (+0200) Subject: doc: More edits in RGW quick start. X-Git-Tag: v10.0.4~117^2~8 X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=91d51b938b6491a6522f6c7b658d8d137480de05;p=ceph.git doc: More edits in RGW quick start. Removed all mentions about Red Hat specific steps. Added commands for Ubuntu Signed-off-by: Bara Ancincova --- diff --git a/doc/start/quick-rgw.rst b/doc/start/quick-rgw.rst index 7dc1e589d46a..ad4da4aa4247 100644 --- a/doc/start/quick-rgw.rst +++ b/doc/start/quick-rgw.rst @@ -2,17 +2,13 @@ Ceph Object Gateway Quick Start =============================== -Red Hat Ceph Storage v1.3 dramatically simplifies installing and configuring a Ceph Object Gateway. The Gateway daemon embeds Civetweb, so you do not have to install a web server or configure FastCGI. Additionally, ``ceph-deploy`` can install the gateway package, generate a key, configure a data directory and create a gateway instance for you. +New version of Ceph Storage dramatically simplifies installing and configuring a Ceph Object Gateway. The Gateway daemon embeds Civetweb, so you do not have to install a web server or configure FastCGI. Additionally, ``ceph-deploy`` can install the gateway package, generate a key, configure a data directory and create a gateway instance for you. .. tip:: Civetweb uses port ``7480`` by default. You must either open port ``7480``, or set the port to a preferred port (e.g., port 80) in your Ceph configuration file. To start a Ceph Object Gateway, follow this procedure: -#. Execute the pre-installation steps on your ``client-node``. If you intend to use Civetweb's default port ``7480``, you must open it using ``firewall-cmd``. - -#. Enable the ``rhel-7-server-rhceph-1.3-tools-rpms`` repository on the ``client-node`` node, if you haven't done so already:: - - sudo subscription-manager repos --enable=rhel-7-server-rhceph-1.3-tools-rpms +#. Execute the pre-installation steps on your ``client-node``. If you intend to use Civetweb's default port ``7480``, you must open it using etiher ``firewall-cmd`` or ``iptables. See `Preflight Checklist`_ for more information. #. From the working directory of your administration server, install the Ceph Object Gateway package on the ``client-node`` node. For example:: @@ -26,17 +22,25 @@ To start a Ceph Object Gateway, follow this procedure: #. To change the default port (e.g,. to port ``80``), modify your Ceph configuration file. Add a section entitled ``[client.rgw.]``, replacing ```` with the short node name of your Ceph client node (i.e., ``hostname -s``). For example, if your node name is ``client-node``, add a section like this after the ``[global]`` section:: - [client.rgw.client-node] rgw_frontends = "civetweb port=80" + [client.rgw.client-node] + rgw_frontends = "civetweb port=80" .. note:: Ensure that you leave no whitespace between ``port=`` in the ``rgw_frontends`` key/value pair. -#. To make the new port setting take effect, restart the Ceph Object Gateway:: +#. To make the new port setting take effect, restart the Ceph Object Gateway. On Red Hat Enterprise Linux 7 and Fedora, run the following command:: sudo systemctl restart ceph-radosgw.service + On Ubuntu, run the following command:: + + sudo service radosgw restart id=rgw. + #. Finally, check to ensure that the port you selected is open on the node's firewall (e.g., port ``80``). If it is not open, add the port and reload the firewall configuration. For example:: - sudo firewall-cmd --list-all sudo firewall-cmd --zone=public --add-port 80/tcp --permanent sudo firewall-cmd --reload + sudo firewall-cmd --list-all sudo firewall-cmd --zone=public --add-port 80/tcp --permanent + sudo firewall-cmd --reload + + See `Preflight Checklist`_ for more information on configuring firewall with ``firewall-cmd`` or ``iptables``. You should be able to make an unauthenticated request, and receive a response. For example, a request with no parameters like this:: @@ -54,4 +58,4 @@ To start a Ceph Object Gateway, follow this procedure: -See the Ceph Object Storage Guide for RHEL ``x86_64`` for additional administration and API details. +See the `Configuring Ceph Object Gateway`_ guide for additional administration and API details.