mirror of
https://github.com/ceph/ceph
synced 2024-12-16 00:15:35 +00:00
254 lines
6.9 KiB
ReStructuredText
254 lines
6.9 KiB
ReStructuredText
|
=============================
|
||
|
|
Install Ceph Object Gateway
|
||
|
|
=============================
|
||
|
|
|
||
|
|
The :term:`Ceph Object Gateway` daemon runs on Apache and FastCGI.
|
||
|
|
|
||
|
|
To run a :term:`Ceph Object Storage` service, you must install Apache and
|
||
|
|
FastCGI. Then, you must install the Ceph Object Gateway daemon. The Ceph Object
|
||
|
|
Gateway supports 100-continue, but you must install Ceph builds of Apache and
|
||
|
|
FastCGI for 100-continue support. To install the Ceph Object Gateway, first
|
||
|
|
install and configure Apache and FastCGI. Then, install the Ceph Object Gateway
|
||
|
|
daemon. If you plan to run a Ceph Object Storage service with a federated
|
||
|
|
architecture (multiple regions and zones), you must also install the
|
||
|
|
synchronization agent.
|
||
|
|
|
||
|
|
|
||
|
|
Apache/FastCGI w/out 100-Continue
|
||
|
|
=================================
|
||
|
|
|
||
|
|
You may use standard Apache and FastCGI packages for your Ceph Object
|
||
|
|
Gateways. However, they will not provide 100-continue support.
|
||
|
|
|
||
|
|
Debian Packages
|
||
|
|
---------------
|
||
|
|
|
||
|
|
To install Apache and FastCGI Debian packages, execute the following::
|
||
|
|
|
||
|
|
sudo apt-get install apache2 libapache2-mod-fastcgi
|
||
|
|
|
||
|
|
|
||
|
|
RPM Packages
|
||
|
|
------------
|
||
|
|
|
||
|
|
To install Apache and FastCGI RPMs, execute the following::
|
||
|
|
|
||
|
|
rpm -ivh fcgi-2.4.0-10.el6.x86_64.rpm
|
||
|
|
rpm -ivh mod_fastcgi-2.4.6-2.el6.rf.x86_64.rpm
|
||
|
|
|
||
|
|
Or::
|
||
|
|
|
||
|
|
sudo yum install httpd mod_fastcgi
|
||
|
|
|
||
|
|
|
||
|
|
Apache/FastCGI w/ 100-Continue
|
||
|
|
==============================
|
||
|
|
|
||
|
|
The Ceph community provides a slightly optimized version of the ``apache2``
|
||
|
|
and ``fastcgi`` packages. The material difference is that the Ceph packages are
|
||
|
|
optimized for the ``100-continue`` HTTP response, where the server determines
|
||
|
|
if it will accept the request by first evaluating the request header. See `RFC
|
||
|
|
2616, Section 8`_ for details on ``100-continue``. You can find the most recent
|
||
|
|
builds of Apache and FastCGI packages modified for Ceph at `gitbuilder.ceph.com`_.
|
||
|
|
|
||
|
|
|
||
|
|
Debian Packages
|
||
|
|
---------------
|
||
|
|
|
||
|
|
#. Add a ``ceph-apache.list`` file to your APT sources. ::
|
||
|
|
|
||
|
|
echo deb http://gitbuilder.ceph.com/apache2-deb-$(lsb_release -sc)-x86_64-basic/ref/master $(lsb_release -sc) main | sudo tee /etc/apt/sources.list.d/ceph-apache.list
|
||
|
|
|
||
|
|
#. Add a ``ceph-fastcgi.list`` file to your APT sources. ::
|
||
|
|
|
||
|
|
echo deb http://gitbuilder.ceph.com/libapache-mod-fastcgi-deb-$(lsb_release -sc)-x86_64-basic/ref/master $(lsb_release -sc) main | sudo tee /etc/apt/sources.list.d/ceph-fastcgi.list
|
||
|
|
|
||
|
|
#. Update your repository and install Apache and FastCGI::
|
||
|
|
|
||
|
|
sudo apt-get update && sudo apt-get install apache2 libapache2-mod-fastcgi
|
||
|
|
|
||
|
|
|
||
|
|
RPM Packages
|
||
|
|
------------
|
||
|
|
|
||
|
|
To install Apache with 100-continue, execute the following steps:
|
||
|
|
|
||
|
|
#. Install ``yum-plugin-priorities``. ::
|
||
|
|
|
||
|
|
sudo yum install yum-plugin-priorities
|
||
|
|
|
||
|
|
#. Ensure ``/etc/yum/pluginconf.d/priorities.conf`` exists.
|
||
|
|
|
||
|
|
#. Ensure ``priorities.conf`` enables the plugin. ::
|
||
|
|
|
||
|
|
[main]
|
||
|
|
enabled = 1
|
||
|
|
|
||
|
|
#. Add a ``ceph-apache.repo`` file to ``/etc/yum.repos.d``. Replace
|
||
|
|
``{distro}`` with the name of your distribution (e.g., ``centos6``,
|
||
|
|
``rhel6``, etc.) ::
|
||
|
|
|
||
|
|
[apache2-ceph-noarch]
|
||
|
|
name=Apache noarch packages for Ceph
|
||
|
|
baseurl=http://gitbuilder.ceph.com/apache2-rpm-{distro}-x86_64-basic/ref/master
|
||
|
|
enabled=1
|
||
|
|
priority=2
|
||
|
|
gpgcheck=1
|
||
|
|
type=rpm-md
|
||
|
|
gpgkey=https://ceph.com/git/?p=ceph.git;a=blob_plain;f=keys/autobuild.asc
|
||
|
|
|
||
|
|
[apache2-ceph-source]
|
||
|
|
name=Apache source packages for Ceph
|
||
|
|
baseurl=http://gitbuilder.ceph.com/apache2-rpm-{distro}-x86_64-basic/ref/master
|
||
|
|
enabled=0
|
||
|
|
priority=2
|
||
|
|
gpgcheck=1
|
||
|
|
type=rpm-md
|
||
|
|
gpgkey=https://ceph.com/git/?p=ceph.git;a=blob_plain;f=keys/autobuild.asc
|
||
|
|
|
||
|
|
|
||
|
|
#. Add a ``ceph-fastcgi.repo`` file to ``/etc/yum.repos.d``. Replace
|
||
|
|
``{distro}`` with the name of your distribution (e.g., ``centos6``,
|
||
|
|
``rhel6``, etc.) ::
|
||
|
|
|
||
|
|
[fastcgi-ceph-basearch]
|
||
|
|
name=FastCGI basearch packages for Ceph
|
||
|
|
baseurl=http://gitbuilder.ceph.com/mod_fastcgi-rpm-centos6-x86_64-basic/ref/master
|
||
|
|
enabled=1
|
||
|
|
priority=2
|
||
|
|
gpgcheck=1
|
||
|
|
type=rpm-md
|
||
|
|
gpgkey=https://ceph.com/git/?p=ceph.git;a=blob_plain;f=keys/autobuild.asc
|
||
|
|
|
||
|
|
[fastcgi-ceph-noarch]
|
||
|
|
name=FastCGI noarch packages for Ceph
|
||
|
|
baseurl=http://gitbuilder.ceph.com/mod_fastcgi-rpm-centos6-x86_64-basic/ref/master
|
||
|
|
enabled=1
|
||
|
|
priority=2
|
||
|
|
gpgcheck=1
|
||
|
|
type=rpm-md
|
||
|
|
gpgkey=https://ceph.com/git/?p=ceph.git;a=blob_plain;f=keys/autobuild.asc
|
||
|
|
|
||
|
|
[fastcgi-ceph-source]
|
||
|
|
name=FastCGI source packages for Ceph
|
||
|
|
baseurl=http://gitbuilder.ceph.com/mod_fastcgi-rpm-centos6-x86_64-basic/ref/master
|
||
|
|
enabled=0
|
||
|
|
priority=2
|
||
|
|
gpgcheck=1
|
||
|
|
type=rpm-md
|
||
|
|
gpgkey=https://ceph.com/git/?p=ceph.git;a=blob_plain;f=keys/autobuild.asc
|
||
|
|
|
||
|
|
|
||
|
|
#. Update your repo and install Apache and FastCGI. ::
|
||
|
|
|
||
|
|
sudo yum update && sudo yum install httpd mod_fastcgi
|
||
|
|
|
||
|
|
|
||
|
|
Configure Apache/FastCGI
|
||
|
|
========================
|
||
|
|
|
||
|
|
To complete the installation, ensure that you have the rewrite module
|
||
|
|
enabled and FastCGI enabled. The steps differ slightly based upon the
|
||
|
|
type of package installation.
|
||
|
|
|
||
|
|
Debian-based Packages
|
||
|
|
---------------------
|
||
|
|
|
||
|
|
#. Open the ``apache2.conf`` file. ::
|
||
|
|
|
||
|
|
sudo vim /etc/apache2/apache2.conf
|
||
|
|
|
||
|
|
|
||
|
|
#. Add a line for the ``ServerName`` in the Apache configuration file.
|
||
|
|
Provide the fully qualified domain name of the server machine
|
||
|
|
(e.g., ``hostname -f``). ::
|
||
|
|
|
||
|
|
ServerName {fqdn}
|
||
|
|
|
||
|
|
#. Enable the URL rewrite modules for Apache and FastCGI. ::
|
||
|
|
|
||
|
|
sudo a2enmod rewrite
|
||
|
|
sudo a2enmod fastcgi
|
||
|
|
|
||
|
|
|
||
|
|
#. Restart Apache so that the foregoing changes take effect. ::
|
||
|
|
|
||
|
|
sudo service apache2 restart
|
||
|
|
|
||
|
|
|
||
|
|
RPM-based Packages
|
||
|
|
------------------
|
||
|
|
|
||
|
|
|
||
|
|
#. Open the ``httpd.conf`` file. ::
|
||
|
|
|
||
|
|
sudo vim /etc/httpd/conf/httpd.conf
|
||
|
|
|
||
|
|
#. Uncomment ``#ServerName`` and add the name of your server.
|
||
|
|
Provide the fully qualified domain name of the server machine
|
||
|
|
(e.g., ``hostname -f``).::
|
||
|
|
|
||
|
|
ServerName {fgdn}
|
||
|
|
|
||
|
|
#. Ensure that the Rewrite module is enabled. ::
|
||
|
|
|
||
|
|
#if not present, add:
|
||
|
|
LoadModule rewrite_module modules/mod_rewrite.so
|
||
|
|
|
||
|
|
#. Save the ``httpd.conf`` file.
|
||
|
|
|
||
|
|
#. Ensure that the FastCGI module is enabled. The installer should
|
||
|
|
include an ``/etc/httpd/conf.d/fastcgi.conf`` file that loads the
|
||
|
|
FastCGI module. ::
|
||
|
|
|
||
|
|
#if not present, add:
|
||
|
|
LoadModule fastcgi_module modules/mod_fastcgi.so
|
||
|
|
|
||
|
|
#. Restart Apache so that the foregoing changes take effect.. ::
|
||
|
|
|
||
|
|
etc/init.d/httpd restart
|
||
|
|
|
||
|
|
.. _RFC 2616, Section 8: http://www.w3.org/Protocols/rfc2616/rfc2616-sec8.html
|
||
|
|
.. _gitbuilder.ceph.com: http://gitbuilder.ceph.com
|
||
|
|
.. _Installing YUM Priorities: ../yum-priorities
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
Install Ceph Object Gateway
|
||
|
|
===========================
|
||
|
|
|
||
|
|
Ceph Object Storage services use the Ceph Object Gateway daemon (``radosgw``)
|
||
|
|
to enable the gateway. For federated architectures, the synchronization
|
||
|
|
agent (``radosgw-agent``) provides data and metadata synchronization between
|
||
|
|
zones and regions.
|
||
|
|
|
||
|
|
|
||
|
|
Debian Packages
|
||
|
|
---------------
|
||
|
|
|
||
|
|
To install the Ceph Object Gateway daemon, execute the
|
||
|
|
following::
|
||
|
|
|
||
|
|
sudo apt-get install radosgw
|
||
|
|
|
||
|
|
|
||
|
|
To install the Ceph Object Gateway synchronization agent, execute the
|
||
|
|
following::
|
||
|
|
|
||
|
|
sudo apt-get radosgw-agent
|
||
|
|
|
||
|
|
|
||
|
|
RPM Packages
|
||
|
|
------------
|
||
|
|
|
||
|
|
To install the Ceph Object Gateway daemon, execute the
|
||
|
|
following::
|
||
|
|
|
||
|
|
yum install ceph-radosgw
|
||
|
|
|
||
|
|
|
||
|
|
To install the Ceph Object Gateway synchronization agent, execute the
|
||
|
|
following::
|
||
|
|
|
||
|
|
yum install radosgw-agent
|