Project

General

Profile

Actions

Fix #10995

open

docs: federated rgw setup create pools section should explain the need for dotted names

Added by Alfredo Deza about 9 years ago.

Status:
New
Priority:
Normal
Assignee:
Category:
documentation
Target version:
-
% Done:

0%

Source:
other
Tags:
Backport:
Reviewed:
Affected Versions:
ceph-qa-suite:
Pull request ID:
Crash signature (v1):
Crash signature (v2):

Description

After checking other pools and their values in the existing cluster, I am ready to create the pools but the naming convention explained in the in the 'Naming for the Master Region' does not look like the examples.

The docs assume more than one Ceph Object Gateway per zone and gives example of two per zone:

Finally, let’s assume that zones may have more than one Ceph Object Gateway instance per zone. For continuity, our naming convention will use {region name}-{zone name}-{instance} format, but you can use any naming convention you prefer.

    United States Region, Master Zone, Instance 1: us-east-1
    United States Region, Secondary Zone, Instance 1: us-west-1

But it ends up with final examples that a) are not mentioning both instances per zone and b) are prefaced by a dot

For continuity, our naming convention will use {region name}-{zone name} format prepended to the pool name, but you can use any naming convention you prefer. For example:

    .us-east.rgw.root
    .us-east.rgw.control
    .us-east.rgw.gc
    .us-east.rgw.buckets
    .us-east.rgw.buckets.index
    .us-east.rgw.buckets.extra
    .us-east.log
    .us-east.intent-log
    .us-east.usage
    .us-east.users
    .us-east.users.email
    .us-east.users.swift
    .us-east.users.uid

It is not clear if I am required to preface the pool names with a dot or not.

Asked Yehuda and he said that because of historical reasons, RGW pools are required to start with a dot, otherwise it will not work.

I couldn't find anywhere that mentioned this.

No data to display

Actions

Also available in: Atom PDF