Bug 2178991 - [rgw][doc]: Add doc on the usage of rgw-restore-bucket-index tool in the rhcs-6.0 guide.
Summary: [rgw][doc]: Add doc on the usage of rgw-restore-bucket-index tool in the rhcs...
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Ceph Storage
Classification: Red Hat Storage
Component: Documentation
Version: 6.0
Hardware: Unspecified
OS: Unspecified
unspecified
urgent
Target Milestone: ---
: 6.1
Assignee: Akash Raj
QA Contact: Vidushi Mishra
Ranjini M N
URL:
Whiteboard:
Depends On:
Blocks: 2126050 2183976
TreeView+ depends on / blocked
 
Reported: 2023-03-16 11:53 UTC by Vidushi Mishra
Modified: 2023-06-21 06:59 UTC (History)
6 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
.Resharding a bucket removes the bucket's metadata Resharding a bucket removes the bucket's metadata if the bucket was created with `bucket_index_max_shards` as `0`. You can recover the affected buckets by restoring the bucket index. The recovery can be done in two ways: By executing `radosgw-admin object reindex --bucket _BUCKET_NAME_ --object _OBJECT_NAME_` command. By executing the script `rgw-restore-bucket-index [--proceed] _BUCKET_NAME_ [_DATA_POOL_NAME_]`. This script in turn invokes `radosgw-admin object reindex ...`. Post performing the above steps, ensure to perform either a `radosgw-admin bucket list` or `radosgw-admin radoslist` command on the bucket for the bucket stats to correctly reflect the number of objects in the bucket. [NOTE] ==== Prior to the execution of the script, perform 'microdnf install jq' inside the `cephadm` shell. The tool does not work for versioned buckets. ---- [root@argo031 ~]# time rgw-restore-bucket-index --proceed serp-bu-ver-1 default.rgw.buckets.data NOTICE: This tool is currently considered EXPERIMENTAL. `marker` is e871fb65-b87f-4c16-a7c3-064b66feb1c4.25076.5. `bucket_id` is e871fb65-b87f-4c16-a7c3-064b66feb1c4.25076.5. Error: this bucket appears to be versioned, and this tool cannot work with versioned buckets. ---- The tool's scope is limited to a single site only and not on a multi-site. If you execute the `rgw-restore-bucket-index` tool at site-1, it does not recover objects on site-2 and vice versa. On a multi-site, the recovery tool and the object reindex command should be executed at both sites for a bucket. ====
Clone Of:
: 2183976 (view as bug list)
Environment:
Last Closed: 2023-06-21 06:59:51 UTC
Embargoed:


Attachments (Terms of Use)


Links
System ID Private Priority Status Summary Last Updated
Red Hat Issue Tracker RHCEPH-6265 0 None None None 2023-03-16 11:56:56 UTC

Comment 6 Aditya Ramteke 2023-05-31 04:02:35 UTC
Removing needinfo


Note You need to log in before you can comment on or make changes to this bug.