.\" Man page generated from reStructuredText
.\" by the Docutils 0.23 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "RGW-RESTORE-BUCKET-INDEX" "8" "Oct 05, 2026" "dev" "Ceph"
.SH NAME
rgw-restore-bucket-index \- try to restore a bucket's objects to its bucket index
.SH SYNOPSIS
.nf
\fBrgw\-restore\-bucket\-index\fP
.fi
.sp
.SH DESCRIPTION
.sp
\fBrgw\-restore\-bucket\-index\fP is an \fIEXPERIMENTAL\fP RADOS gateway
user administration utility. It scans the data pool for objects that
belong to a given bucket and tries to add those objects back to the
bucket index. It\(aqs intended as a \fBlast resort\fP after a
\fBcatastrophic\fP loss of a bucket index. Please thorougly review the
\fIWarnings\fP listed below.
.sp
The utility works with regular (i.e., un\-versioned) buckets, versioned
buckets, and buckets were versioning has been suspended.
.SH WARNINGS
.sp
This utility is currently considered \fIEXPERIMENTAL\fP\&.
.sp
The results are unpredictable if the bucket is in
active use while this utility is running.
.sp
The results are unpredictable if only some bucket\(aqs objects are
missing from the bucket index. In such a case, consider using the
\(dqobject reindex\(dq subcommand of \fIradosgw\-admin\fP to restore object\(aqs to
the bucket index one\-by\-one.
.sp
For objects in versioned buckets, if the latest version is a delete
marker, it will be restored. If a delete marker has been written over
with a new version, then that delete marker will not be restored. This
should have minimal impact on results in that the it recovers the
latest version and previous versions are all accessible.
.SH COMMAND-LINE ARGUMENTS
.INDENT 0.0
.TP
.B \-b <bucket>
Specify the bucket to be reindexed.
.UNINDENT
.INDENT 0.0
.TP
.B \-p <pool>
Optional, specify the data pool containing head objects for the
bucket. If omitted the utility will try to determine the data pool
on its own.
.UNINDENT
.INDENT 0.0
.TP
.B \-r <realm\-name>
Optional, specify the realm if the restoration is not being applied
to the default realm.
.UNINDENT
.INDENT 0.0
.TP
.B \-g <zonegroup\-name>
Optional, specify the zonegroup if the restoration is not being applied
to the default zonegroup.
.UNINDENT
.INDENT 0.0
.TP
.B \-z <zone\-name>
Optional, specify the zone if the restoration is not being applied
to the default zone.
.UNINDENT
.INDENT 0.0
.TP
.B \-l <rados\-ls\-output\-file>
Optional, specify a file containing the output of a rados listing
of the data pool. Since listing the data pool can be an expensive
and time\-consuming operation, if trying to recover the indices for
multiple buckets, it could be more efficient to re\-use the same
listing.
.UNINDENT
.INDENT 0.0
.TP
.B \-t <temporary\-directory>
Optional, specify a directory in which to store temporary files.
The size of the temporary files is highly dependent on the number
of bucket entries involved, so the partition on which the temporary
directory exists should be of suitable size.
.UNINDENT
.INDENT 0.0
.TP
.B \-y
Optional, proceed without further prompting. Without this option
the utility will display some information and prompt the user as to
whether to proceed. When provided, the utility will simply
proceed. Please use caution when using this option.
.UNINDENT
.SH EXAMPLES
.sp
Attempt to restore the index for a bucket named \fIsummer\-2023\-photos\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ rgw\-restore\-bucket\-index \-b summer\-2023\-photos
.EE
.UNINDENT
.UNINDENT
.SH AVAILABILITY
.sp
\fBrgw\-restore\-bucket\-index\fP 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.
.SH SEE ALSO
.sp
radosgw\-admin \%<>(8)
.SH Copyright
2010-2014, Inktank Storage, Inc. and contributors. Licensed under Creative Commons Attribution Share Alike 3.0 (CC-BY-SA-3.0)
.\" End of generated man page.