Navigation

As of firefly (v0.80), 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.

Execute the pre-installation steps on your client-node. If you intend to
use Civetweb’s default port 7480, you must open it using either
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"

Note

Ensure that you leave no whitespace between port=<port-number>
in the rgw_frontends key/value pair.

Important

If you intend to use port 80, make sure that the Apache
server is not running otherwise it will conflict with Civetweb. We recommend
to remove Apache in this case.

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:

sudosystemctlrestartceph-radosgw.service

On Red Hat Enterprise Linux 6 and Ubuntu, run the following command:

sudoserviceradosgwrestartid=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: