Skip to main content

Realm-Zonegroup-Zone

Sample output for realm,zonegroup and zone details

Reference: https://docs.ceph.com/en/latest/radosgw/layout/

Realm: A realm is a container for multi-site configuration, storing information about zonegroups, zones, and a time "period".

Zonegroup: Collection of zones. Realm and zones are mainly for namespace abstraction.

Zone: lowest level of multisite configuration. Sync happens at Zone level

Period: Every realm has a "period" which is a snapshot of the realm's configuration at a specific point in time.

Epochs: Within a period, there are epochs, which represent versions or iterations of the period.

  • RGW service created as :

    Realm - Asia
    Zonegroup - India
    Zone - Kerala
    # radosgw-admin realm list
    {
    "default_info": "13a144f6-52e1-4eb4-b39f-f17de566aa2b",
    "realms": [
    "asia"
    ]
    }
    # radosgw-admin zonegroup list
    {
    "default_info": "fc3a7e3c-e3dc-40a7-a0b8-dbedb7c094a7",
    "zonegroups": [
    "india"
    ]
    }
    # radosgw-admin zone list
    {
    "default_info": "1847c1d2-a429-4a01-a65b-30eac3893e1e",
    "zones": [
    "kerala"
    ]
    }
    # radosgw-admin zonegroup get
    {
    "id": "fc3a7e3c-e3dc-40a7-a0b8-dbedb7c094a7",
    "name": "india",
    "api_name": "india",
    "is_master": true,
    "endpoints": [],
    "hostnames": [],
    "hostnames_s3website": [],
    "master_zone": "1847c1d2-a429-4a01-a65b-30eac3893e1e",
    "zones": [
    {
    "id": "1847c1d2-a429-4a01-a65b-30eac3893e1e",
    "name": "kerala",
    "endpoints": [],
    "log_meta": false,
    "log_data": false,
    "bucket_index_max_shards": 11,
    "read_only": false,
    "tier_type": "",
    "sync_from_all": true,
    "sync_from": [],
    "redirect_zone": "",
    "supported_features": [
    "compress-encrypted",
    "notification_v2",
    "resharding"
    ]
    }
    ],
    "placement_targets": [
    {
    "name": "default-placement",
    "tags": [],
    "storage_classes": [
    "STANDARD"
    ]
    }
    ],
    "default_placement": "default-placement",
    "realm_id": "13a144f6-52e1-4eb4-b39f-f17de566aa2b",
    "sync_policy": {
    "groups": []
    },
    "enabled_features": [
    "notification_v2",
    "resharding"
    ]
    }
    # radosgw-admin realm get
    {
    "id": "13a144f6-52e1-4eb4-b39f-f17de566aa2b",
    "name": "asia",
    "current_period": "50b5f3d5-07e8-4a64-b27f-aed0dce95eb9",
    "epoch": 2
    }
    # radosgw-admin zone get
    {
    "id": "1847c1d2-a429-4a01-a65b-30eac3893e1e",
    "name": "kerala",
    "domain_root": "kerala.rgw.meta:root",
    "control_pool": "kerala.rgw.control",
    "gc_pool": "kerala.rgw.log:gc",
    "lc_pool": "kerala.rgw.log:lc",
    "log_pool": "kerala.rgw.log",
    "intent_log_pool": "kerala.rgw.log:intent",
    "usage_log_pool": "kerala.rgw.log:usage",
    "roles_pool": "kerala.rgw.meta:roles",
    "reshard_pool": "kerala.rgw.log:reshard",
    "user_keys_pool": "kerala.rgw.meta:users.keys",
    "user_email_pool": "kerala.rgw.meta:users.email",
    "user_swift_pool": "kerala.rgw.meta:users.swift",
    "user_uid_pool": "kerala.rgw.meta:users.uid",
    "otp_pool": "kerala.rgw.otp",
    "notif_pool": "kerala.rgw.log:notif",
    "topics_pool": "kerala.rgw.meta:topics",
    "account_pool": "kerala.rgw.meta:accounts",
    "group_pool": "kerala.rgw.meta:groups",
    "system_key": {
    "access_key": "",
    "secret_key": ""
    },
    "placement_pools": [
    {
    "key": "default-placement",
    "val": {
    "index_pool": "kerala.rgw.buckets.index",
    "storage_classes": {
    "STANDARD": {
    "data_pool": "kerala.rgw.buckets.data"
    }
    },
    "data_extra_pool": "kerala.rgw.buckets.non-ec",
    "index_type": 0,
    "inline_data": true
    }
    }
    ],
    "realm_id": "13a144f6-52e1-4eb4-b39f-f17de566aa2b"
    }
  • These details are saved in objects in .rgw.root pool

default.realm 
realms.13a144f6-52e1-4eb4-b39f-f17de566aa2b
realms.13a144f6-52e1-4eb4-b39f-f17de566aa2b.control
realms_names.asia

default.zonegroup.13a144f6-52e1-4eb4-b39f-f17de566aa2b
zonegroup_info.fc3a7e3c-e3dc-40a7-a0b8-dbedb7c094a7
zonegroups_names.india

default.zone.13a144f6-52e1-4eb4-b39f-f17de566aa2b
zone_info.1847c1d2-a429-4a01-a65b-30eac3893e1e
zone_names.kerala


periods.13a144f6-52e1-4eb4-b39f-f17de566aa2b:staging
periods.13a144f6-52e1-4eb4-b39f-f17de566aa2b:staging.latest_epoch
periods.50b5f3d5-07e8-4a64-b27f-aed0dce95eb9.1
periods.50b5f3d5-07e8-4a64-b27f-aed0dce95eb9.latest_epoch
periods.b144eeca-6230-45e0-b45d-1159e8444240.1
periods.b144eeca-6230-45e0-b45d-1159e8444240.latest_epoch