From 7da45d65be36d36b880cc55c5036e96c24b53f00 Mon Sep 17 00:00:00 2001 From: Qiaowei Ren Date: Thu, 1 Mar 2018 14:38:11 +0800 Subject: remove ceph code This patch removes initial ceph code, due to license issue. Change-Id: I092d44f601cdf34aed92300fe13214925563081c Signed-off-by: Qiaowei Ren --- src/ceph/doc/rbd/iscsi-monitoring.rst | 103 ---------------------------------- 1 file changed, 103 deletions(-) delete mode 100644 src/ceph/doc/rbd/iscsi-monitoring.rst (limited to 'src/ceph/doc/rbd/iscsi-monitoring.rst') diff --git a/src/ceph/doc/rbd/iscsi-monitoring.rst b/src/ceph/doc/rbd/iscsi-monitoring.rst deleted file mode 100644 index d425232..0000000 --- a/src/ceph/doc/rbd/iscsi-monitoring.rst +++ /dev/null @@ -1,103 +0,0 @@ ------------------------------ -Monitoring the iSCSI gateways ------------------------------ - -Ceph provides an additional tool for iSCSI gateway environments -to monitor performance of exported RADOS Block Device (RBD) images. - -The ``gwtop`` tool is a ``top``-like tool that displays aggregated -performance metrics of RBD images that are exported to clients over -iSCSI. The metrics are sourced from a Performance Metrics Domain Agent -(PMDA). Information from the Linux-IO target (LIO) PMDA is used to list -each exported RBD image with the connected client and its associated I/O -metrics. - -**Requirements:** - -- A running Ceph iSCSI gateway - -**Installing:** - -#. As ``root``, install the ``ceph-iscsi-tools`` package on each iSCSI - gateway node: - - :: - - # yum install ceph-iscsi-tools - -#. As ``root``, install the performance co-pilot package on each iSCSI - gateway node: - - :: - - # yum install pcp - -#. As ``root``, install the LIO PMDA package on each iSCSI gateway node: - - :: - - # yum install pcp-pmda-lio - -#. As ``root``, enable and start the performance co-pilot service on - each iSCSI gateway node: - - :: - - # systemctl enable pmcd - # systemctl start pmcd - -#. As ``root``, register the ``pcp-pmda-lio`` agent: - - :: - - cd /var/lib/pcp/pmdas/lio - ./Install - -By default, ``gwtop`` assumes the iSCSI gateway configuration object is -stored in a RADOS object called ``gateway.conf`` in the ``rbd`` pool. -This configuration defines the iSCSI gateways to contact for gathering -the performance statistics. This can be overridden by using either the -``-g`` or ``-c`` flags. See ``gwtop --help`` for more details. - -The LIO configuration determines which type of performance statistics to -extract from performance co-pilot. When ``gwtop`` starts it looks at the -LIO configuration, and if it find user-space disks, then ``gwtop`` -selects the LIO collector automatically. - -**Example ``gwtop`` Outputs** - -For kernel RBD-based devices: - -:: - - gwtop 2/2 Gateways CPU% MIN: 4 MAX: 5 Network Total In: 2M Out: 3M 10:20:09 - Capacity: 8G Disks: 8 IOPS: 500 Clients: 1 Ceph: HEALTH_OK OSDs: 3 - Pool.Image Src Device Size r/s w/s rMB/s wMB/s await r_await w_await Client - iscsi.t1703 rbd0 500M 0 0 0.00 0.00 0.00 0.00 0.00 - iscsi.testme1 rbd5 500M 0 0 0.00 0.00 0.00 0.00 0.00 - iscsi.testme2 rbd2 500M 0 0 0.00 0.00 0.00 0.00 0.00 - iscsi.testme3 rbd3 500M 0 0 0.00 0.00 0.00 0.00 0.00 - iscsi.testme5 rbd1 500M 0 0 0.00 0.00 0.00 0.00 0.00 - rbd.myhost_1 T rbd4 4G 500 0 1.95 0.00 2.37 2.37 0.00 rh460p(CON) - rbd.test_2 rbd6 1G 0 0 0.00 0.00 0.00 0.00 0.00 - rbd.testme rbd7 500M 0 0 0.00 0.00 0.00 0.00 0.00 - -For user backed storage (TCMU) devices: - -:: - - gwtop 2/2 Gateways CPU% MIN: 4 MAX: 5 Network Total In: 2M Out: 3M 10:20:00 - Capacity: 8G Disks: 8 IOPS: 503 Clients: 1 Ceph: HEALTH_OK OSDs: 3 - Pool.Image Src Size iops rMB/s wMB/s Client - iscsi.t1703 500M 0 0.00 0.00 - iscsi.testme1 500M 0 0.00 0.00 - iscsi.testme2 500M 0 0.00 0.00 - iscsi.testme3 500M 0 0.00 0.00 - iscsi.testme5 500M 0 0.00 0.00 - rbd.myhost_1 T 4G 504 1.95 0.00 rh460p(CON) - rbd.test_2 1G 0 0.00 0.00 - rbd.testme 500M 0 0.00 0.00 - -In the *Client* column, ``(CON)`` means the iSCSI initiator (client) is -currently logged into the iSCSI gateway. If ``-multi-`` is displayed, -then multiple clients are mapped to the single RBD image. -- cgit 1.2.3-korg