Commit id 'bb74a7ffe' forgot to adjust the storage docs to describe the new fields. Signed-off-by: John Ferlan <jferlan(a)redhat.com&gt; --- docs/formatstorage.html.in | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/docs/formatstorage.html.in b/docs/formatstorage.html.in index a7273ed..f6887ae 100644 --- a/docs/formatstorage.html.in +++ b/docs/formatstorage.html.in @@ -237,6 +237,23 @@ the scsi_hostN of some existing storage pool. <span class="since">Since 1.0.4</span> </dd> + <dt><code>parent_wwnn</code> and <code>parent_wwpn</code></dt> + <dd>Instead of the <code>parent</code> to specify which scsi_host + to use by name, it's possible to provide the wwnn and wwpn of + the parent to be used for the vHBA in order to ensure that + between reboots or after a hardware configuration change that + the scsi_host parent name doesn't change. Both the parent_wwnn + and parent_wwpn must be provided. + <span class="since">Since 3.0.0</span> + </dd> + <dt><code>parent_fabric_wwn</code></dt> + <dd>Instead of the <code>parent</code> to specify which scsi_host + to use by name, it's possible to provide the fabric_wwn on which + the scsi_host exists. This provides flexibility for choosing + a scsi_host that may be available on the fabric rather than + requiring a specific parent by wwnn or wwpn to be available. + <span class="since">Since 3.0.0</span> + </dd> <dt><code>managed</code></dt> <dd>An optional attribute to instruct the SCSI storage backend to manage destroying the vHBA when the pool is destroyed. For -- 2.7.4

Add "Improvements" for commit id 'bb74a7ffe' and '78be2e8b7' which add support for using the parent wwnn/wwpn or fabric_name rather than just using the parent by scsi_hostX name. Signed-off-by: John Ferlan <jferlan(a)redhat.com&gt; --- docs/news.xml | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/docs/news.xml b/docs/news.xml index 300e553..13f6965 100644 --- a/docs/news.xml +++ b/docs/news.xml @@ -118,6 +118,18 @@ of units in bytes rather than default of human readable output. </description> </change> + <change> + <summary> + scsi: Add parent wwnn/wwpn or fabric capability for createVport + </summary> + <description> + Improve the algorithm searching for the parent scsi_host device + for vHBA/NPIV scsi_host creation. Rather than supplying the + "parent" by name, it's now possible to define the parent by + it's wwnn/wwpn or fabric_wwn in the node device create XML or + the storage pool XML. + </description> + </change> </section> <section title="Bug fixes"> <change> -- 2.7.4

On Wed, Jan 11, 2017 at 07:25:54AM -0500, John Ferlan wrote: This is pretty long and confusing sentence, especially without any punctuation. ACK to this, but I'd be also fine with it being reworde slightly.