Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

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

Chapter 3. Client Quick Start

Red Hat Ceph Storage supports three types of Ceph clients:

  • Ceph CLI: The ceph command-line interface (CLI) enables Ceph administrators to execute Ceph administrative commands such as creating a CRUSH hierarchy, monitoring cluster health, or managing users from the command line.
  • Ceph Block Device: Red Hat Ceph Storage supports mounting a thin-provisioned, re-sizable block device. While the most popular use case for Ceph Block Device is to use its librbd library with QEMU and libvirt to serve as a back end for cloud platforms like the Red Hat Open Stack Platform, we also support a kernel block device (RHEL 7.1 x86_64 and later releases only).
  • Ceph Object Gateway: Red Hat Ceph Storage supports a Ceph Object Gateway with its own user management and Swift- and S3-compliant APIs.

To use Ceph clients, you must first have a Ceph Storage Cluster running, preferably in the active + clean state.

Ceph clients typically run on nodes separate from the Ceph Storage Cluster. You can use ceph-deploy on your Calamari administration to configure a Ceph client node.

diag 04185b26d3585d1b29a1bcc6bbb85341
View larger image
diag 04185b26d3585d1b29a1bcc6bbb85341

3.1. Execute the Pre-Installation Procedure
复制链接

For streamlined installation and deployment, execute the pre-installation procedures on your Ceph client node. Specifically, disable requiretty, set SELinux to permissive mode (with Red Hat Ceph Storage 1.3.2 or later, SELinux can run in enforcing mode, see the SELinux and Install ceph-selinux sections for more details), and set up a Ceph Deploy user with password-less sudo (see the Create a Ceph Deploy User and Enable Password-less sudo sections). For Ceph Object Gateways, open the ports that Civetweb uses in production (by default port 80 and port 7480).

3.2. Enable Ceph Client Repository
复制链接

Red Hat includes Ceph Storage clients in the rhel-7-server-rhceph-1.3-tools-rpms repository. To ensure you are using the same version of the Ceph client as your storage cluster, execute the following to enable the repository: 

# subscription-manager repos --enable=rhel-7-server-rhceph-1.3-tools-rpms
Copy to Clipboard Toggle word wrap

3.3. Install the Ceph Common Package
复制链接

The Ceph Common packages provides the Ceph CLI tools, the Ceph Block Device and the Ceph Object Store daemon.

To install ceph-common CLI tools, go to the working directory of Calamari administration server and execute: 

ceph-deploy install --cli <node-name>
Copy to Clipboard Toggle word wrap
Note

Using ceph-deploy requires you to execute the Pre Installation procedure first.

The ceph CLI tools are intended for administrators. To make your Ceph client node an administrator node, execute the following from the working directory of your administration server. 

ceph-deploy admin <node-name>
Copy to Clipboard Toggle word wrap

The CLI tools include:

  • ceph
  • ceph-authtool
  • ceph-dencoder
  • rados

3.4. Block Device Quick Start
复制链接

The following quick start describes how to mount a thin-provisioned, resizable block device for RHEL 7.1 x86_64 and later releases only. You must install ceph-common first before using this procedure.

Execute the following procedures on a separate physical node (or within a VM) from the Ceph monitor and OSD nodes. Running Linux kernel clients and kernel server daemons on the same node can lead to kernel deadlocks.

  1. Create a user for your block device. This step requires the Ceph CLI interface with administrative privileges. To create a user, execute ceph auth get-or-create and output the result to a keyring file. 

    # ceph auth get-or-create USERTYPE.USERID {daemon} \
 'allow <r|w|x|*|...> [pool={pool-name}]' \
 -o /etc/ceph/rbd.keyring
    Copy to Clipboard Toggle word wrap

    A block device user should have rwx permissions on OSDs, because block devices use classes and therefore require execute x permissions. The following example limits the client.rbd user to the default rbd pool. For example, on the ceph-client node, execute: 

    # ceph auth get-or-create client.rbd \
mon 'allow r' osd 'allow rwx pool=rbd' \
-o /etc/ceph/rbd.keyring
    Copy to Clipboard Toggle word wrap

    See the Red Hat Ceph Storage Administration Guide for additional details on user management.

  2. On the ceph-client node, create a block device image. 

    # rbd create foo --size 4096 --pool rbd \
--name client.rbd --keyring /etc/ceph/rbd.keyring
    Copy to Clipboard Toggle word wrap

  3. On the ceph-client node, map the image to a block device. 

    # rbd map foo --pool rbd \
--name client.rbd --keyring /etc/ceph/rbd.keyring
    Copy to Clipboard Toggle word wrap
    Important

    Kernel block devices currently only support the legacy straw bucket algorithm in your CRUSH map. If you have set your CRUSH tunables to optimal, you may have to set them to legacy or an earlier major release; otherwise, you will not be able to map the image. Alternatively, refer to the Ceph Storage Strategies guide and the section on editing a CRUSH map to ensure that you are not using straw2 (replace straw2 with straw).

  4. Use the block device by creating a file system on the ceph-client node. 

    # mkfs.ext4 -m0 /dev/rbd/rbd/foo
    Copy to Clipboard Toggle word wrap

    This may take a few moments.

  5. Mount the file system on the ceph-client node. 

    # mkdir /mnt/ceph-block-device
# mount /dev/rbd/rbd/foo /mnt/ceph-block-device
cd /mnt/ceph-block-device
    Copy to Clipboard Toggle word wrap

See the Red Hat Ceph Storage Block Device guide for additional details.

3.5. 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.

Tip

Civetweb uses port 7480 by default. You must either open port 7480, or set the port to a preferred port (typically port 80) in your Ceph configuration file.

To start a Ceph Object Gateway, follow this procedure:

  1. 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.

  2. Enable the rhel-7-server-rhceph-1.3-tools-rpms repository on the client-node node, if you haven’t done so already. 

    # subscription-manager repos --enable=rhel-7-server-rhceph-1.3-tools-rpms
    Copy to Clipboard Toggle word wrap

  3. From the working directory of your administration server, install the Ceph Object Gateway package on the client-node node. For example: 

    ceph-deploy install --rgw <client-node> [<client-node> ...]
    Copy to Clipboard Toggle word wrap

  4. From the working directory of your administration server, create an instance of the Ceph Object Gateway on the client-node. For example: 

    ceph-deploy rgw create <client-node>
    Copy to Clipboard Toggle word wrap

    Once the gateway is running, you should be able to access it on port 7480. (for example, http://client-node:7480).

  5. To change the default port (for example, 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 ($ 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"
    Copy to Clipboard Toggle word wrap
    Note

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

  6. To make the new port setting take effect, restart the Ceph Object Gateway. 

    # systemctl restart ceph-radosgw.service
    Copy to Clipboard Toggle word wrap

    Finally, check to ensure that the port you selected is open on the node’s firewall (for example, port 80). If it is not open, add the port and reload the firewall configuration. For example: 

    # firewall-cmd --list-all
# firewall-cmd --zone=public --add-port 80/tcp
# firewall-cmd --zone=public --add-port 80/tcp --permanent
    Copy to Clipboard Toggle word wrap

You should be able to make an unauthenticated request, and receive a response. For example, a request with no parameters like this: 

http://<client-node>:80
Copy to Clipboard Toggle word wrap

Should result in a response like this: 

<?xml version="1.0" encoding="UTF-8"?>
<ListAllMyBucketsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
	<Owner>
		<ID>anonymous</ID>
		<DisplayName></DisplayName>
	</Owner>
	<Buckets>
	</Buckets>
</ListAllMyBucketsResult>
Copy to Clipboard Toggle word wrap

See the Ceph Object Storage Guide for RHEL x86_64 for additional administration and API details.

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

Theme

© 2025 Red Hat