Resharding bucket index manually

If a bucket has grown larger than the initial configuration for which it was optimized, reshard the bucket index pool by using the radosgw-admin bucket reshard command.

This command performs the following tasks:

  • Creates a new set of bucket index objects for the specified bucket.

  • Distributes object entries across these bucket index objects.

  • Creates a new bucket instance.

  • Links the new bucket instance with the bucket so that all new index operations go through the new bucket indexes.

  • Prints the old and the new bucket ID to the command output.

Prerequisites

  • At least two running IBM Storage Ceph clusters.

  • A Ceph Object Gateway installed at a minimum of two sites.

Procedure

  1. Back up the original bucket index:

    Syntax 

    radosgw-admin bi list --bucket=BUCKET > BUCKET.list.backup

    Example 

    [ceph: root@host01 /]# radosgw-admin bi list --bucket=data > data.list.backup

  2. Reshard the bucket index:

    Syntax 

    radosgw-admin bucket reshard --bucket=BUCKET --num-shards=NUMBER

    Example 

    [ceph: root@host01 /]# radosgw-admin bucket reshard --bucket=data --num-shards=100

Verification

  • Check bucket resharding status:

    Syntax 

    radosgw-admin reshard status --bucket bucket

    Example 

    [ceph: root@host01 /]# radosgw-admin reshard status --bucket data