RGW-GAP-LIST(8)

NAME
rgw-gap-list - List bucket index entries with damaged RADOS backing objects

SYNOPSIS
rgw-gap-list

DESCRIPTION

rgw-gap-list is an EXPERIMENTAL RADOS gateway user administration utility. It produces a listing of bucket index entries that have missing backing RADOS objects. It places the results and intermediate files on the local filesystem rather than on the Ceph cluster itself, and therefore will not itself consume additional cluster storage.

In theory these gaps should not exist. However because Ceph evolves rapidly, bugs do crop up, and they may result in bucket index entries that have missing RADOS objects, such as when a delete operation does not fully complete.

Behind the scenes it runs rados ls and radosgw-admin bucket radoslist ... and produces a list of those entries that appear in the latter but not the former. Those entries are presumed to be the gaps.

Note: Depending on the size of the pool(s) involved, this tool may be quite slow to produce its results.

WARNINGS

This utility is considered EXPERIMENTAL.

OPTIONS

-p pool
    The RGW bucket data pool name. If option omitted the pool name will be prompted during execution. Multiple pools can be supplied as a space-separated double quoted list.

-t temp_directory
    The tool can produce large intermediate files. By default /tmp is used, but if the filesystem housing /tmp doesn't have sufficient free space, a different directory (on a filesystem with sufficient free space) can be specified.

-m  Use two (multiple) threads to speed up the run.

EXAMPLES

Launch the tool:

    $ rgw-gap-list -p default.rgw.buckets.data -t /home/super_admin/temp_files

AVAILABILITY

rgw-gap-list is part of Ceph, a massively scalable, open-source, distributed storage system. Please refer to the Ceph documentation at <https://docs.ceph.com> for more information.

SEE ALSO

radosgw-admin <>(8) rgw-orphan-list <>(8)

Copyright
2010-2014, Inktank Storage, Inc. and contributors. Licensed under Creative Commons Attribution Share Alike 3.0 (CC-BY-SA-3.0)