This project provides the common logic for creating and managing LIO gateways for ceph, together with a startup daemon
called rbd-target-gw which is responsible for restoring the state of LIO following a gateway reboot/outage.

This package should be installed on each node that is intended to be an iSCSI gateway. The config modules are used by

• the rbd-target-gw daemon to restore LIO state at boot time
• Ansible modules defined in the ceph-iscsi-ansible project at https://github.com/pcuzner/ceph-iscsi-ansible
• API/CLI configuration tools in the ceph-iscsi-cli project at https://github.com/pcuzner/ceph-iscsi-cli

Simply install the provided rpm with
rpm -ivh ceph-iscsi-config-<ver>.el7.noarch.rpm

The following packages are required by ceph-iscsi-config and must be installed before starting the rbd-target-gw service:

python-rados python-rbd python-netaddr python-netifaces python-rtslib python-crypto

To install the python package that provides the application logic, run the provided setup.py script
i.e. > python setup.py install

For the management daemon (rbd-target-gw), simply copy the following files into their equivalent places on each gateway

• <archive_root>/usr/lib/systemd/system/rbd-target-gw.service --> /lib/systemd/system
• <archive_root>/usr/bin/rbd-target-gw --> /usr/bin

Once the daemon is in place, reload the configuration with

systemctl daemon-reload
systemctl enable rbd-target-gw 
systemctl start rbd-target-gw

The functionality provided by each module in the python package is summarised below;

The rbd-target-gw daemon performs the following tasks;

1. At start up remove any osd blacklist entry that may apply to the running host
2. Read the configuration object from Rados
3. Process the configuration
   3.1 map rbd's to the host
   3.2 add rbd's to LIO
   3.3 Create the iscsi target, TPG's and port IP's
   3.4 Define clients (NodeACL's)
   3.5 add the required rbd images to clients