Skip to content

Object storage operation tips

Public Ceph Documentation

The latest official documentation for ceph is available at http://docs.ceph.com/docs/master

For convenience an offline copy is available here. It may not be the latest of course as it was built as part of your punchplatform release.

Useful Commands

Info

The commands listed below can be run only from the platform operator accounts; from the administration servers. The ceph nodes themselves are not configured to operate the ceph cluster.

Note

In this chapter, we assume the target ceph cluster is named main. Checkout out your punchplatform.properties file to determine the name of yours.

Checking the cluster status

1
$ ceph health --cluster main

Checking cluster used/free space

1
$ ceph df --cluster main

This will output:

  • the global summed-up free/used storage space of all the cluster data nodes
  • for each pool, the used space and the remaining storage space. Remember that if you activated erasure coding on a pool, the user data stored in the cluster will be smaller than the used storage space.

For additional information on the ceph data stored in a cluster pool, refer to punchplatform-objects-storage.sh manual page.

List data pools

1
$ ceph osd pool ls --cluster main

For detailed information about ceph data stored in a cluster pool by PunchPlatform, please refer to punchplatform-objects-storage.sh command help.

List topics

  • only the topic names, on January 2018 (for example):
1
$ punchplatform-objects-storage.sh list-topics --cluster ceph:main --pool mytenant-data --elasticsearch-cluster-name es_search --from-date 2018-01-01T00:00:00+01:00 --to-date 2018-01-31T23:59:59+01:00
  • With more details:
1
$ punchplatform-objects-storage.sh list-topics --cluster ceph:main --pool mytenant-data --elasticsearch-cluster-name es_search --from-date 2018-01-01T00:00:00+01:00 --to-date 2018-01-31T23:59:59+01:00 --details

This may take up to a few minutes per topic.

  • View detailed information for a single topic, on January 2018 (for example):
1
$ punchplatform-objects-storage.sh topic-status --cluster ceph:main --pool mytenant-data --elasticsearch-cluster-name es_search --from-date 2018-01-01T00:00:00+01:00 --to-date 2018-01-31T23:59:59+01:00 --topic apache