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

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
Copy to Clipboard Toggle word wrap

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
Copy to Clipboard Toggle word wrap

On RHEL 6, execute:

subscription-manager repos --enable=rhel-6-server-rh-common-rpms
Copy to Clipboard Toggle word wrap

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}
Copy to Clipboard Toggle word wrap

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>
Copy to Clipboard Toggle word wrap

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
Copy to Clipboard Toggle word wrap

On RHEL 6, execute:

sudo service httpd start
Copy to Clipboard Toggle word wrap

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
    Copy to Clipboard Toggle word wrap
  2. Generate private key:

    openssl genrsa -out ca.key 2048
    Copy to Clipboard Toggle word wrap
  3. Generate CSR:

    openssl req -new -key ca.key -out ca.csr
    Copy to Clipboard Toggle word wrap
  4. Generate a certificate:

    openssl x509 -req -days 365 -in ca.csr -signkey ca.key -out ca.crt
    Copy to Clipboard Toggle word wrap
  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
    Copy to Clipboard Toggle word wrap
  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
    Copy to Clipboard Toggle word wrap
  7. Restart httpd service:

    On RHEL 7, execute:

    sudo systemctl restart httpd
    Copy to Clipboard Toggle word wrap

    On RHEL 6, execute:

    sudo service httpd restart
    Copy to Clipboard Toggle word wrap

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
Copy to Clipboard Toggle word wrap

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

sudo yum install radosgw-agent
Copy to Clipboard Toggle word wrap
返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

Theme

© 2025 Red Hat