From Fedora Project Wiki
 
(13 intermediate revisions by 2 users not shown)
Line 4: Line 4:
Improve anaconda's iSCSI support.
Improve anaconda's iSCSI support.


This is a complete iscsi rewrite replacing iscsiadm with the new libiscsi and adding python bindings.
This is a complete iscsi rewrite that also adds the new libiscsi and associated python bindings.


== Owner ==
== Owner ==
Line 11: Line 11:
== Current status ==
== Current status ==
* Targeted release: [Fedora 11]  
* Targeted release: [Fedora 11]  
* Last updated: (02/10/09)
* Last updated: (04/17/09)
* Percentage of completion: 95%
* Percentage of completion: 100%
* We did not submit this as an official F11 feature since FESCO thought that it was more in the nature of cleanup, but the work is complete in F11


== Detailed Description ==
== Detailed Description ==
iSCSI support in anaconda needed extensive cleanup.
iSCSI support in anaconda needed extensive cleanup.
This patch replaces the iscsi.py code with new code using libiscsi.
This feature replaces existing code with new code using libiscsi.


Fixes:
Fixes:
Line 24: Line 25:
* Make ibft work with chap and 2-way chap
* Make ibft work with chap and 2-way chap
* Make ibft configured disks available for upgrades and in rescue mode
* Make ibft configured disks available for upgrades and in rescue mode
* Make ibft boot work even when iscsi-initiator-utils is installed after the
* Make ibft boot work even when iscsi-initiator-utils is installed after the kernel in the transaction
kernel in the transaction
 
Limitations:
* For non ibft discovered devices, the sendtargets discovery authentication information (username and secret) must be identical to the authentication information for the portal to the target.


== Benefit to Fedora ==
== Benefit to Fedora ==
Fewer anaconda bugs and easier maintenance
Fewer anaconda bugs and easier maintenance. Additional support for ibft, CHAP, reverse CHAP.


== Scope ==
== Scope ==
Line 35: Line 38:


== Test Plan ==
== Test Plan ==
=== iSCSI ===


* Test install to a regular disk with /home on iscsi using no authentication
* Test install to a regular disk with /home on iscsi using 1-way CHAP
* Test install to a regular disk with /home on iscsi using 2-way CHAP
* Test install with / on iscsi using an iBFT capable system using no authentication
* Test install with / on iscsi using an iBFT capable system using 1-way CHAP
* Test install with / on iscsi using an iBFT capable system using 2-way CHAP
* Test install with / on 1 iscsi target and /home on a different target using an iBFT capable system
* Test install with / on 1 iscsi lun and /home on a different lun of the same target using an iBFT capable system
=== Known Issues ===
* When using NetworkManager for network configuration and using an iscsi /, other iscsi based file systems (ie /boot) will not be brought up automatically.


== User Experience ==
== User Experience ==
Line 42: Line 56:


== Dependencies ==
== Dependencies ==
none
None


== Contingency Plan ==
== Contingency Plan ==
none; this is a necessary revision of existing (broken) support  
None; this is a necessary revision of existing (broken) support


== Documentation ==
== Documentation ==
See http://people.atrpms.net/~hdegoede/html/index.html for details of the libiscsi API


== Release Notes ==
== Release Notes ==

Latest revision as of 17:34, 17 April 2009

Anaconda iSCSI Cleanup

Summary

Improve anaconda's iSCSI support.

This is a complete iscsi rewrite that also adds the new libiscsi and associated python bindings.

Owner

  • Hans DeGoede <hdegoede@redhat.com>

Current status

  • Targeted release: [Fedora 11]
  • Last updated: (04/17/09)
  • Percentage of completion: 100%
  • We did not submit this as an official F11 feature since FESCO thought that it was more in the nature of cleanup, but the work is complete in F11

Detailed Description

iSCSI support in anaconda needed extensive cleanup. This feature replaces existing code with new code using libiscsi.

Fixes:

  • Report error when we cannot add a disk instead of silently failing (461830)
  • Report error when trying to use iscsi from kickstart without having an iscsiname directive first (463156)
  • Better feedback while scanning iscsi disks
  • Make ibft work with chap and 2-way chap
  • Make ibft configured disks available for upgrades and in rescue mode
  • Make ibft boot work even when iscsi-initiator-utils is installed after the kernel in the transaction

Limitations:

  • For non ibft discovered devices, the sendtargets discovery authentication information (username and secret) must be identical to the authentication information for the portal to the target.

Benefit to Fedora

Fewer anaconda bugs and easier maintenance. Additional support for ibft, CHAP, reverse CHAP.

Scope

  • Review and fix numerous reported problems
  • Include latest ibft, CHAP and reverse CHAP support

Test Plan

  • Test install to a regular disk with /home on iscsi using no authentication
  • Test install to a regular disk with /home on iscsi using 1-way CHAP
  • Test install to a regular disk with /home on iscsi using 2-way CHAP
  • Test install with / on iscsi using an iBFT capable system using no authentication
  • Test install with / on iscsi using an iBFT capable system using 1-way CHAP
  • Test install with / on iscsi using an iBFT capable system using 2-way CHAP
  • Test install with / on 1 iscsi target and /home on a different target using an iBFT capable system
  • Test install with / on 1 iscsi lun and /home on a different lun of the same target using an iBFT capable system

Known Issues

  • When using NetworkManager for network configuration and using an iscsi /, other iscsi based file systems (ie /boot) will not be brought up automatically.

User Experience

Dependencies

None

Contingency Plan

None; this is a necessary revision of existing (broken) support

Documentation

See http://people.atrpms.net/~hdegoede/html/index.html for details of the libiscsi API

Release Notes

Not user visible so none needed

Comments and Discussion