doc: sync with mainline

Updated to: "2016-04-05"

Signed-off-by: Drunkard Zhang <[email protected]>

Makefile.am

@@ -33,4 +33,5 @@ EXTRA_DIST = \
 	man/8/rbd-replay-many.rst	\
 	man/8/rbd-replay-prep.rst	\
 	man/8/rbd-replay.rst	\
-	man/8/rbd.rst
+	man/8/rbd.rst		\
+	man/8/rbdmap.rst

rados/configuration/mon-config-ref.rst

@@ -213,32 +213,39 @@ Ceph 监视器的最简配置必须包括一主机名及其监视器地址，这
 
 ``mon initial members``
 
-:描述: 集群启动时初始监视器的 ID ，若指定， Ceph 需要奇数个监视器来确定最初\
-       法定人数（如 3 ）。
+:描述: 集群启动时初始监视器的 ID ，若指定， Ceph 需要奇数个\
+       监视器来确定最初法定人数（如 3 ）。
 
 :类型: String
 :默认值: None
 
-.. note:: 集群内的\ *大多数*\ 监视器必须能互通以建立法定人数，你可以用此选项减小初\
-   始监视器数量来形成。
+.. note:: 集群内的\ *大多数*\ 监视器必须能互通以建立法定人数，\
+   你可以用此选项减小初始监视器数量来形成。
+
 
 .. index:: Ceph Monitor; data path
 
+.. _Data:
+
 数据
 ----
 
-Ceph 监视器有存储数据的默认路径，生产集群为实现更高性能可把监视器部署到非 OSD 节点\
-的独立主机上。因为监视器会频繁 ``fsync()`` ，这可能影响 OSD 。
+Ceph 监视器有存储数据的默认路径。为优化性能，在生产集群上，\
+我们建议在独立主机上运行 Ceph 监视器，不要与运行 Ceph OSD 守\
+护进程的主机混用。因为 leveldb 靠 ``mmap()`` 写数据， Ceph
+监视器会频繁地把数据从内存刷回磁盘，如果其数据与 OSD 守护进\
+程共用存储器，就会与 Ceph OSD 守护进程的载荷冲突。
 
-在 Ceph 0.58 及更早版本中，监视器数据以文件保存，这样人们可以用 ``ls`` 和 ``cat`` \
-这些普通工具检查监视器数据，然而它不能提供健壮的一致性。
+在 Ceph 0.58 及更早版本中，监视器数据以文件保存，这样人们可以\
+用 ``ls`` 和 ``cat`` 这些普通工具检查监视器数据，然而它不能提\
+供健壮的一致性。
 
-在 Ceph 0.59 及后续版本中，监视器以键/值对存储数据。监视器需要 `ACID`_ 事务，数据\
-存储的使用可防止监视器用损坏的版本进行恢复，除此之外，它允许在一个原子批量操作中进行\
-多个修改操作。
+在 Ceph 0.59 及后续版本中，监视器以键/值对存储数据。监视器需要
+`ACID`_ 事务，数据存储的使用可防止监视器用损坏的版本进行恢复，\
+除此之外，它允许在一个原子批量操作中进行多个修改操作。
 
-一般来说我们不建议更改默认数据位置，如果要改，我们建议所有监视器统一配置，加到配置文\
-件的 ``[mon]`` 下。
+一般来说我们不建议更改默认数据位置，如果要改，我们建议所有监\
+视器统一配置，加到配置文件的 ``[mon]`` 下。
 
 
 ``mon data``
@@ -250,6 +257,8 @@ Ceph 监视器有存储数据的默认路径，生产集群为实现更高性能
 
 .. index:: Ceph Storage Cluster; capacity planning, Ceph Monitor; capacity planning
 
+.. _Storage Capacity:
+
 存储容量
 --------
 

radosgw/config-ref.rst

@@ -640,10 +640,19 @@ Ceph 对象网关会把桶索引（ ``index_pool`` ）和桶数据（ ``data_poo
 ``rgw region root pool``
 
 :描述: 用于存储此 region 所有相关信息的存储池。
+       ``Jewel`` 版起不再使用。
 :类型: String
 :默认值: ``.rgw.root``
 
 
+.. versionadded:: Jewel
+
+``rgw zonegroup root pool``
+
+:描述: 用于存储此 zonegroup 所有相关信息的存储池。
+:类型: String
+:默认值: ``.rgw.root``
+
 
 .. versionadded:: v.67
 

radosgw/federated-config.rst

@@ -289,16 +289,22 @@ Apache 、 FastCGI 、 Ceph 对象网关守护进程（ ``radosgw`` ），还有
 
 在二级域上重复以上步骤。
 
-.. note:: 按照以上步骤配置二级 region 时，需把 ``us-`` 替换为 ``eu-`` 。\
-   创建主 region 和二级 region **后**\ ，你一共会拥有四个 FastCGI 脚本。
+.. note:: 按照以上步骤配置二级 region 时，需把 ``us-`` 替换为
+   ``eu-`` 。创建主 region 和二级 region **后**\ ，你一共会拥\
+   有四个 FastCGI 脚本。
+
 
+.. _Add Instances to Ceph Config File:
 
 把各例程加入 Ceph 配置文件
 --------------------------
 
-在管理节点上，把各例程的配置写入 Ceph 存储集群的配置文件。例如： ::
+在管理节点上，把各例程的配置写入 Ceph 存储集群的配置文件。\
+例如： ::
 
-	...
+	[global]
+	rgw region root pool = .us.rgw.root     # Deprecated in Jewel
+	rgw zonegroup root pool = .us.rgw.root  # From Jewel
 
 	[client.radosgw.us-east-1]
 	rgw region = us
@@ -312,33 +318,33 @@ Apache 、 FastCGI 、 Ceph 对象网关守护进程（ ``radosgw`` ），还有
 
 	[client.radosgw.us-west-1]
 	rgw region = us
-	rgw region root pool = .us.rgw.root
 	rgw zone = us-west
 	rgw zone root pool = .us-west.rgw.root
 	keyring = /etc/ceph/ceph.client.radosgw.keyring
 	rgw dns name = {hostname}
 	rgw socket path = /var/run/ceph/$name.sock
 	host = {host-name}
 
-
 然后，把更新过的 Ceph 配置文件推送到各 :term:`Ceph 节点`\ 如： ::
 
 	ceph-deploy --overwrite-conf config push {node1} {node2} {nodex}
 
+.. note:: 按照以上步骤配置二级 region 时，需把 region 、存储池\
+   和域的名字都从 ``us`` 替换为 ``eu`` 。创建主 region 和二级
+   region **后**\ ，你一共会有四条类似配置。
 
-.. note:: 按照以上步骤配置二级 region 时，需把 region 、存储池和域的名字都\
-   从 ``us`` 替换为 ``eu`` 。创建主 region 和二级 region **后**\ ，你一共\
-   会有四条类似配置。
 
+.. _Create a Region:
 
 创建 region
 -----------
 
 #. 为 ``us`` region 创建个 region 配置文件，名为 ``us.json`` 。
 
-   把下列实例的内容复制进文本编辑器，把 ``is_master`` 设置为 ``true`` ，用终\
-   结点的全资域名替换 ``{fqdn}`` 。这样，主域就是 ``us-east`` ，另外 \
-   ``zones`` 列表中还会有 ``us-west`` 。详情见\ `配置参考——region`_ 。 ::
+   把下列实例的内容复制进文本编辑器，把 ``is_master`` 设置为
+   ``true`` ，用终结点的全资域名替换 ``{fqdn}`` 。这样，主域就\
+   是 ``us-east`` ，另外 ``zones`` 列表中还会有 ``us-west`` 。\
+   详情见\ `配置参考——region`_ 。 ::
 
 	{ "name": "us",
 	  "api_name": "us",
@@ -365,7 +371,6 @@ Apache 、 FastCGI 、 Ceph 对象网关守护进程（ ``radosgw`` ），还有
 	  ],
 	  "default_placement": "default-placement"}
 
-
 #. 用刚刚创建的 ``us.json`` 输入文件创建 ``us`` region 。 ::
 
 	radosgw-admin region set --infile us.json --name client.radosgw.us-east-1
@@ -393,6 +398,8 @@ Apache 、 FastCGI 、 Ceph 对象网关守护进程（ ``radosgw`` ），还有
    创建主 region 和二级 region **后**\ ，你一共会有两个 region 。
 
 
+.. _Create Zones:
+
 创建域
 ------