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::
#. 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::
</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.