此内容没有您所选择的语言版本。

Chapter 1. Install Ceph object gateway


Note

To run the Ceph object gateway service, you should have a running Ceph cluster, the gateway host should have access to storage and public networks, and SELinux should be in permissive mode.

The Ceph Object Gateway daemon runs on Apache and FastCGI.

To run a Ceph Object Storage service, you must install Apache and Ceph Object Gateway daemon on the host that is going to provide the gateway service, i.e, the gateway host. 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.

Note

Previous versions of Ceph shipped with mod_fastcgi. The current version of Red Hat Ceph Storage ships with mod_proxy_fcgi instead.

In RHEL 7, mod_proxy_fcgi is present in the main httpd package. When you’ve installed the httpd package with yum, mod_proxy_fcgi will already be available for use on your server.

In RHEL 6, mod_proxy_fcgi comes in its own mod_proxy_fcgi package. You will need to install it with yum install mod_proxy_fcgi.

1.1. Install Apache

To install Apache on the gateway host, execute the following:

sudo yum install httpd

1.2. Enable RH-COMMON repositories

You need to enable RH-COMMON repositories with subscription-manager to install packages required for setting up Ceph Object Gateway on the gateway host.

On RHEL 7, execute:

subscription-manager repos --enable=rhel-7-server-rh-common-rpms

On RHEL 6, execute:

subscription-manager repos --enable=rhel-6-server-rh-common-rpms

1.3. Configure Apache

Make the following changes in Apache’s configuration on the gateway host:

1.3.1. Give the ServerName in httpd.conf

Uncomment #ServerName in /etc/httpd/conf/httpd.conf and add the name of your server. Provide the fully qualified domain name of the server machine (e.g., hostname -f):

ServerName {fqdn}

1.3.2. Load mod_proxy_fcgi module

Update /etc/httpd/conf/httpd.conf to load mod_proxy_fcgi module. Append the following to the file:

<IfModule !proxy_fcgi_module>
  LoadModule proxy_fcgi_module modules/mod_proxy_fcgi.so
</IfModule>

1.3.3. Update httpd to listen to public IP address

Edit the line Listen 80 in /etc/httpd/conf/httpd.conf with the public IP address of the host that you are configuring as a gateway server.

e.g. Listen {IP ADDRESS}:80 in place of Listen 80.

1.3.4. Start httpd service

On RHEL 7, execute:

sudo systemctl start httpd

On RHEL 6, execute:

sudo service httpd start

1.4. Enable SSL

Some REST clients use HTTPS by default. So you should consider enabling SSL for Apache. Use the following procedures to enable SSL on the gateway host.

Note

You can use self-certified certificates. Some client APIs check for a trusted certificate authority. You may need to obtain a SSL certificate from a trusted authority to use those client APIs.

To enable SSL, execute the following steps:

  1. Ensure that you have installed the dependencies:

    sudo yum install mod_ssl openssl
  2. Generate private key:

    openssl genrsa -out ca.key 2048
  3. Generate CSR:

    openssl req -new -key ca.key -out ca.csr
  4. Generate a certificate:

    openssl x509 -req -days 365 -in ca.csr -signkey ca.key -out ca.crt
  5. Copy the files to appropriate locations:

    sudo cp ca.crt /etc/pki/tls/certs
    sudo cp ca.key /etc/pki/tls/private/ca.key
    sudo cp ca.csr /etc/pki/tls/private/ca.csr
  6. Update the Apache SSL configuration file /etc/httpd/conf.d/ssl.conf. with correct locations of SSLCertificateFile and SSLCertificateKeyFile:

    SSLCertificateFile /etc/pki/tls/certs/ca.crt
    SSLCertificateKeyFile /etc/pki/tls/private/ca.key
  7. Restart httpd service:

    On RHEL 7, execute:

    sudo systemctl restart httpd

    On RHEL 6, execute:

    sudo service httpd restart

1.5. Install Ceph Object Gateway Daemon

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.

To install the Ceph Object Gateway daemon on the gateway host, execute the following:

sudo yum install ceph-radosgw

To install the Ceph Object Gateway synchronization agent, execute the following:

sudo yum install radosgw-agent
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2026 Red Hat
返回顶部