Metadata-Version: 2.1
Name: rbd-iscsi-client
Version: 0.1.9.dev4
Summary: "REST client to talk to rbd-target-api"
Home-page: http://opendev.org/openstack/rbd-iscsi-client
Author: OpenStack
Author-email: openstack-discuss@lists.openstack.org
License: UNKNOWN
Platform: UNKNOWN
Classifier: Environment :: OpenStack
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Requires-Python: >=3.6
Requires-Dist: Babel (!=2.4.0,>=2.3.4)
Requires-Dist: oslo.i18n (>=3.24.0)
Requires-Dist: oslo.log (>=3.44.0)
Requires-Dist: oslo.utils (>=3.36.0)
Requires-Dist: pbr (!=2.1.0,>=5.4.1)
Requires-Dist: requests (!=2.20.0,>=2.14.2)

================
RBD iSCSI Client
================


.. image:: https://img.shields.io/pypi/v/rbd-iscsi-client.svg
        :target: https://pypi.python.org/pypi/rbd-iscsi-client

.. image:: https://img.shields.io/pypi/pyversions/rbd-iscsi-client.svg
        :target: https://pypi.python.org/pypi/rbd-iscsi-client

.. image:: https://img.shields.io/:license-apache-blue.svg
   :target: http://www.apache.org/licenses/LICENSE-2.0


Overview
--------
This python package is a client that talks to the ceph-iscsi rbd-target-api.
The rbd-target-api coordinates the rbd volume exports via iSCSI.

Requirements
------------
This package requires a running ceph cluster that has the ceph-iscsi
gateway tools installed properly and running.  The rbd-target-api must
be configured and running.

Installation
------------
``pip install rbd-iscsi-client``

Features
--------

This is a REST client that talks to ceph-iscsi's rbd-target-api to export
rbd images/volumes to an iSCSI initiator.

* get_api - Get all the api endpoints
* get_config - get the entire gateway config
* get_targets - Get all of the target_iqn's defined in the gateways
* create_target_iqn - create a new target_iqn
* delete_target_iqn - delete a target_iqn
* get_clients - get the clients (initiators) defined in the gateways
* get_client_info - get the client information
* create_client - Register a new client (initiator) with the gateways
* delete_client - unregister a client (initiator) from the gateways
* set_client_auth - set CHAP credentials for the client (initiator)
* get_disks - get list of volumes defined to the gateways
* create_disk - create a new volume/disk that the gateways can export
* find_disk - Find a disk that the gateway knows about
* delete_disk - delete a disk from the gateway and pool
* register_disk - Make the disk available to export to a client.
* unregister_disk - Make a disk unavailable to export to a client.
* export_disk - Export a registered disk to a client (initiator)
* unexport_disk - unexport a disk from a client (initiator)

Credits
-------

This package makes use of the rbd-target-api from ceph-iscsi_ package.

.. _ceph-iscsi: https://github.com/ceph/ceph-iscsi

This package was originally created with Cookiecutter_ and the
`audreyr/cookiecutter-pypackage`_ project template.

.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage



