]> git-server-git.apps.pok.os.sepia.ceph.com Git - ceph.git/commitdiff
doc: More edits in RGW quick start.
authorBarbora Ančincová <bancinco@redhat.com>
Tue, 13 Oct 2015 10:43:06 +0000 (12:43 +0200)
committerBarbora Ančincová <bancinco@redhat.com>
Tue, 13 Oct 2015 10:43:06 +0000 (12:43 +0200)
Removed all mentions about Red Hat specific steps. Added commands for
Ubuntu

Signed-off-by: Bara Ancincova <bancinco@redhat.com>
doc/start/quick-rgw.rst

index 7dc1e589d46ad62fedcf959d3afec58fee3eed5b..ad4da4aa42472486516771802cce74fe7f47a1c2 100644 (file)
@@ -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.<client-node>]``, replacing ``<client-node>`` 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=<port-number>`` 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.<short-hostname>
+
 #. 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:
       </Buckets>
     </ListAllMyBucketsResult>
 
-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.