Remove Ceph iSCSI content

This has been moved to the Charmed Ceph
documentation:

https://ubuntu.com/ceph/docs/integration-vmware

Change-Id: Iaba5bbfe76d0d8791a68f5015c9fbcffcda8a5be
This commit is contained in:
Peter Matulis 2020-12-15 13:43:41 -05:00
parent c57a525583
commit 678d2c126b
5 changed files with 1 additions and 105 deletions

View File

@ -1,104 +0,0 @@
======================
Appendix W: Ceph iSCSI
======================
Overview
--------
This section contains information on the usage of Ceph-backed iSCSI targets in
a Charmed Ceph environment. See the `ceph-iscsi charm README`_ for essential
information.
VMware integration
~~~~~~~~~~~~~~~~~~
Ceph can be used to back iSCSI targets for VMware initiators.
Begin by accessing the VMware admin web UI.
.. note::
These instructions were written using VMware ESXi 6.7.0.
.. figure:: ./media/ceph-iscsi_wmware-ui.png
:scale: 60 %
:alt: WMware web UI - login
Accessing the WMware web UI.
Create a Ceph pool
^^^^^^^^^^^^^^^^^^
If desired, create a Ceph pool to back the VMware targets with the ceph-mon
charm's ``create-pool`` action. To create one called 'vmware-iscsi':
.. code-block:: none
juju run-action --wait ceph-mon/0 create-pool name=vmware-iscsi
Enable the initiator
^^^^^^^^^^^^^^^^^^^^
From the web UI select the ``Adapters`` tab in the ``Storage`` context. Click
``Configure iSCSI`` and enable iSCSI.
Take a note of the initiator's name, also called its IQN (iSCSI Qualified
Name). Here the IQN we'll use is
``iqn.1998-01.com.vmware:node-gadomski-6a5e962a``.
.. figure:: ./media/ceph-iscsi_wmware-ui-iqn.png
:scale: 63 %
:alt: WMware web UI - IQN
Determining the IQN for the initiator.
Create an iSCSI target
^^^^^^^^^^^^^^^^^^^^^^
With the ``create-target`` action create a target for VMware to use. Use the
pool that may have been created previously (such as 'vmware-iscsi'):
.. code-block:: none
juju run-action --wait ceph-iscsi/0 create-target \
client-initiatorname=iqn.1998-01.com.vmware:node-gadomski-6a5e962a \
client-username=vmwareclient \
client-password=12to16characters \
image-size=5G \
image-name=disk-1 \
pool-name=vmware-iscsi
.. note::
VMware imposes a policy on credentials. The username should be more than
eight characters and the password between twelve and sixteen characters.
Add a target to VMware
^^^^^^^^^^^^^^^^^^^^^^
Follow the `Ceph iSCSI gateway for VMware`_ documentation to use the new
target. Use the (CHAP) username and password passed to the ``create-target``
action.
.. note::
At the time of writing, the redundant task of setting the credentials via
the ESX CLI is still a necessity. This will require you to enable SSH under
``Manage`` > ``Services`` > ``TSM-SSH`` > ``Actions`` (Start).
When finished, under the ``Devices`` tab you should see the created target. To
make more devices available to VMware simply create more targets (use a
different image name and optionally a different image size). You may need to
``Rescan`` and ``Refresh`` for the new devices to appear.
Clicking on one of the target devices will show its details:
.. figure:: ./media/ceph-iscsi_wmware-ui-target.png
:scale: 65 %
:alt: WMware web UI - target device
Inspecting target device details.
.. LINKS
.. _Ceph iSCSI gateway for VMware: https://docs.ceph.com/docs/master/rbd/iscsi-initiator-esx/
.. _ceph-iscsi charm README: https://opendev.org/openstack/charm-ceph-iscsi/src/branch/master/README.md

View File

@ -60,7 +60,7 @@ contribution`_.
Ceph erasure coding <app-erasure-coding>
Ceph RADOS Gateway multisite replication <app-rgw-multisite>
Ceph RBD mirroring <app-ceph-rbd-mirror>
Ceph iSCSI <app-ceph-iscsi>
Ceph charm deprecation <app-ceph-migration>
Masakari <app-masakari>
OVN <app-ovn>
Managing power events <app-managing-power-events>

Binary file not shown.

Before

Width:  |  Height:  |  Size: 3.8 MiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 1.5 MiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 1.5 MiB