update sources to ceph Nautilus 14.2.1

[ceph.git] / ceph / doc / rbd / iscsi-target-cli.rst

diff --git a/ceph/doc/rbd/iscsi-target-cli.rst b/ceph/doc/rbd/iscsi-target-cli.rst
index ec67a04c007f80733db332ded76c7f8ceb57a8a6..f7719d2ae8bbc218ce141c3ea6d92dfdc98cf6bb 100644 (file)
--- a/ceph/doc/rbd/iscsi-target-cli.rst
+++ b/ceph/doc/rbd/iscsi-target-cli.rst
@@ -11,7 +11,7 @@ install, and configure the Ceph iSCSI gateway for basic operation.
 
 -  A running Ceph Luminous or later storage cluster
 
--  RHEL/CentOS 7.5; Linux kernel v4.17 or newer; or the `Ceph iSCSI client test kernel <https://shaman.ceph.com/repos/kernel/ceph-iscsi-test>`_
+-  Red Hat Enterprise Linux/CentOS 7.5 (or newer); Linux kernel v4.16 (or newer)
 
 -  The following packages must be installed from your Linux distribution's software repository:
 
@@ -21,9 +21,7 @@ install, and configure the Ceph iSCSI gateway for basic operation.
 
    -  ``tcmu-runner-1.3.0`` or newer package
 
-   -  ``ceph-iscsi-config-2.4`` or newer package
-
-   -  ``ceph-iscsi-cli-2.5`` or newer package
+   -  ``ceph-iscsi-2.7`` or newer package
 
      .. important::
         If previous versions of these packages exist, then they must
@@ -43,11 +41,16 @@ to the *Installing* section:
 
 #. If needed, open TCP ports 3260 and 5000 on the firewall.
 
+   .. note::
+      Access to port 5000 should be restricted to a trusted internal network or
+      only the individual hosts where ``gwcli`` is used or ``ceph-mgr`` daemons
+      are running.
+
 #. Create a new or use an existing RADOS Block Device (RBD).
 
 **Installing:**
 
-If you are using the upstream ceph-iscsi-cli package follow the
+If you are using the upstream ceph-iscsi package follow the
 `manual install instructions`_.
 
 .. _`manual install instructions`: ../iscsi-target-cli-manual-install
@@ -60,11 +63,11 @@ If you are using the upstream ceph-iscsi-cli package follow the
 For rpm based instructions execute the following commands:
 
 #. As ``root``, on all iSCSI gateway nodes, install the
-   ``ceph-iscsi-cli`` package:
+   ``ceph-iscsi`` package:
 
    ::
 
-       # yum install ceph-iscsi-cli
+       # yum install ceph-iscsi
 
 #. As ``root``, on all iSCSI gateway nodes, install the ``tcmu-runner``
    package:
@@ -127,7 +130,7 @@ For rpm based instructions execute the following commands:
           # api_port = 5001
           # trusted_ip_list = 192.168.0.10,192.168.0.11
 
-      ..note::
+      .. note::
         trusted_ip_list is a list of IP addresses on each iscsi gateway that
         will be used for management operations like target creation, lun
         exporting, etc. The IP can be the same that will be used for iSCSI
@@ -179,7 +182,7 @@ to create a iSCSI target and export a RBD image as LUN 0.
 
    ::
 
-       > /iscsi-target> cd iqn.2003-01.com.redhat.iscsi-gw:ceph-igw/gateways
+       > /iscsi-target> cd iqn.2003-01.com.redhat.iscsi-gw:iscsi-igw/gateways
        > /iscsi-target...-igw/gateways>  create ceph-gw-1 10.172.19.21
        > /iscsi-target...-igw/gateways>  create ceph-gw-2 10.172.19.22
 
@@ -189,7 +192,7 @@ to create a iSCSI target and export a RBD image as LUN 0.
 
    ::
 
-       > /iscsi-target> cd iqn.2003-01.com.redhat.iscsi-gw:ceph-igw/gateways
+       > /iscsi-target> cd iqn.2003-01.com.redhat.iscsi-gw:iscsi-igw/gateways
        > /iscsi-target...-igw/gateways>  create ceph-gw-1 10.172.19.21 skipchecks=true
        > /iscsi-target...-igw/gateways>  create ceph-gw-2 10.172.19.22 skipchecks=true
 
@@ -200,14 +203,11 @@ to create a iSCSI target and export a RBD image as LUN 0.
        > /iscsi-target...-igw/gateways> cd /disks
        > /disks> create pool=rbd image=disk_1 size=90G
 
-   .. warning::
-       There can not be any periods (.) in the pool name or in the image name.
-
 #. Create a client with the initiator name iqn.1994-05.com.redhat:rh7-client:
 
    ::
 
-       > /disks> cd /iscsi-target/iqn.2003-01.com.redhat.iscsi-gw:ceph-igw/hosts
+       > /disks> cd /iscsi-target/iqn.2003-01.com.redhat.iscsi-gw:iscsi-igw/hosts
        > /iscsi-target...eph-igw/hosts>  create iqn.1994-05.com.redhat:rh7-client
 
 #. Set the client's CHAP username to myiscsiusername and password to
@@ -215,7 +215,7 @@ to create a iSCSI target and export a RBD image as LUN 0.
 
    ::
 
-       > /iscsi-target...at:rh7-client>  auth chap=myiscsiusername/myiscsipassword
+       > /iscsi-target...at:rh7-client>  auth username=myiscsiusername password=myiscsipassword
 
    .. warning::
       CHAP must always be configured. Without CHAP, the target will
@@ -225,6 +225,6 @@ to create a iSCSI target and export a RBD image as LUN 0.
 
    ::
 
-       > /iscsi-target...at:rh7-client> disk add rbd.disk_1
+       > /iscsi-target...at:rh7-client> disk add rbd/disk_1
 
 The next step is to configure the iSCSI initiators.