libvirt/docs
John Ferlan 2b13361bc7 nodedev: Add the ability to create vHBA by parent wwnn/wwpn or fabric_wwn
https://bugzilla.redhat.com/show_bug.cgi?id=1349696

When creating a vHBA, the process is to feed XML to nodeDeviceCreateXML
that lists the <parent> scsi_hostX to use to create the vHBA. However,
between reboots, it's possible that the <parent> changes its scsi_hostX
to scsi_hostY and saved XML to perform the creation will either fail or
create a vHBA using the wrong parent.

So add the ability to provide "wwnn" and "wwpn" or "fabric_wwn" to
the <parent> instead of a name of the scsi_hostN that is the parent.
The allowed XML will thus be:

  <parent>scsi_host3</parent>  (current)

or

  <parent wwnn='$WWNN' wwpn='$WWPN'/>

or

  <parent fabric_wwn='$WWNN'/>

Using the wwnn/wwpn or fabric_wwn ensures the same 'scsi_hostN' is
selected between hardware reconfigs or host reboots. The fabric_wwn
Using the wwnn/wwpn pair will provide the most specific search option,
while fabric_wwn will at least ensure usage of the same SAN, but maybe
not the same scsi_hostN.

This patch will add the new fields to the nodedev.rng for input purposes
only since the input XML is essentially thrown away, no need to Format
the values since they'd already be printed as part of the scsi_host
data block.

New API virNodeDeviceGetParentHostByWWNs will take the parent "wwnn" and
"wwpn" in order to search the list of devices for matching capability
data fields wwnn and wwpn.

New API virNodeDeviceGetParentHostByFabricWWN will take the parent "fabric_wwn"
in order to search the list of devices for matching capability data field
fabric_wwn.
2017-01-06 17:14:12 -05:00
..
api_extension xen_xs: name xendConfigVersion magic numbers 2012-02-01 16:28:17 -07:00
devhelp maint: consolidate several .gitignore files 2012-02-03 15:27:16 -07:00
fonts docs: Add monospaced Overpass fonts 2016-11-21 13:15:12 +01:00
html maint: consolidate several .gitignore files 2012-02-03 15:27:16 -07:00
internals Fix minor typos 2016-12-02 09:25:13 +01:00
js docs: rewrite content on front page to be more useful 2016-11-11 12:15:05 +00:00
logos docs: add master SVG for libvirt logo 2016-11-11 09:31:10 +00:00
schemas nodedev: Add the ability to create vHBA by parent wwnn/wwpn or fabric_wwn 2017-01-06 17:14:12 -05:00
32favicon.png * docs/site.xsl docs/*.png docs/*.html: update the images from Diana, 2006-01-23 22:55:41 +00:00
404.html.in docs: redo style of front page 2016-11-11 12:15:03 +00:00
acl.html.in docs: Correct invalid hyperlinks 2014-12-02 07:30:10 +01:00
aclpolkit.html.in aclpolkit.html.in: Kill useless spaces in <pre/> 2016-11-14 11:03:34 +01:00
api_extension.html.in maint: improve VIR_ERR_INVALID_CONN usage 2014-01-06 21:41:02 -07:00
api.html.in docs: Rename 'parallels' to 'vz' 2015-08-25 07:21:33 -04:00
apibuild.py Unbreak rebuilding docs with release tarballs 2016-11-07 20:04:28 +01:00
apps.html.in docs: provide new style logos for the apps page 2016-11-11 12:15:05 +00:00
architecture.fig Remove trailing whitespace from all xfig files 2011-10-28 10:11:16 +01:00
architecture.gif * docs/architecture.* docs/*: added a section on the architecture 2005-12-21 16:59:34 +00:00
architecture.html.in Fix multiple formatting problems in HTML docs 2013-05-03 15:56:15 +01:00
auditlog.html.in audit: Audit information about shmem devices 2016-09-12 19:41:43 +02:00
auth.html.in docs: Reference the right config option 2017-01-05 16:12:36 +01:00
bindings.html.in Point to the new libvirt-go bindings 2016-12-19 10:26:22 +00:00
bugs.html.in Fix common misspellings 2015-03-23 09:01:30 +01:00
cgroups.html.in cgroups.html.in: Kill useless spaces in <pre/> 2016-11-14 11:03:34 +01:00
compiling.html.in compiling.html.in: Kill useless spaces in <pre/> 2016-11-14 11:03:34 +01:00
contact.html.in docs: add some improved styling to contact page 2016-11-11 12:15:06 +00:00
contribute.html.in docs: add page describing contribution to libvirt 2016-11-11 12:15:05 +00:00
csharp.html.in Fix multiple formatting problems in HTML docs 2013-05-03 15:56:15 +01:00
devguide.html.in devguide.html.in: Kill useless spaces in <pre/> 2016-11-14 11:03:34 +01:00
docs.html.in Point to the new libvirt-go bindings 2016-12-19 10:26:22 +00:00
downloads.html.in docs: link to news file and other resources 2016-12-19 10:58:55 +00:00
drivers.html.in docs: Rename 'parallels' to 'vz' 2015-08-25 07:21:33 -04:00
drvbhyve.html.in drvbhyve.html.in: Kill useless spaces in <pre/> 2016-11-14 11:03:34 +01:00
drvesx.html.in drvesx.html.in: Kill useless spaces in <pre/> 2016-11-14 11:03:34 +01:00
drvhyperv.html.in Fix multiple formatting problems in HTML docs 2013-05-03 15:56:15 +01:00
drvlxc.html.in drvlxc.html.in: Kill useless spaces in <pre/> 2016-11-14 11:03:34 +01:00
drvopenvz.html.in Fix multiple formatting problems in HTML docs 2013-05-03 15:56:15 +01:00
drvphyp.html.in Fix multiple formatting problems in HTML docs 2013-05-03 15:56:15 +01:00
drvqemu.html.in qemu: really remove last traces of Xenner support 2015-11-10 10:38:15 +00:00
drvremote.html.in Fix multiple formatting problems in HTML docs 2013-05-03 15:56:15 +01:00
drvtest.html.in Fix multiple formatting problems in HTML docs 2013-05-03 15:56:15 +01:00
drvuml.html.in docs: typo fix 2014-03-03 17:41:26 +04:00
drvvbox.html.in Move VirtualBox driver into libvirtd 2013-05-16 16:28:53 +01:00
drvvirtuozzo.html.in Rename page about vz driver 2015-08-25 07:36:37 -04:00
drvvmware.html.in VMware: Initial VMware Fusion support 2013-09-29 18:40:36 +08:00
drvxen.html.in Fix multiple formatting problems in HTML docs 2013-05-03 15:56:15 +01:00
errors.html.in docs: Correct invalid hyperlinks 2014-12-02 07:30:10 +01:00
firewall.html.in Fix typos in various docs 2013-12-02 10:21:26 +08:00
format.html.in format.html.in: Kill useless spaces in <pre/> 2016-11-14 11:03:34 +01:00
formatcaps.html.in formatcaps.html.in: Kill useless spaces in <pre/> 2016-11-14 11:03:34 +01:00
formatdomain.html.in docs: document cpu host-passthrough migration issue 2016-12-16 09:09:44 +01:00
formatdomaincaps.html.in Show host model in domain capabilities 2016-09-22 15:40:08 +02:00
formatnetwork.html.in network: Add support for local PTR domains 2016-12-19 09:03:29 +01:00
formatnode.html.in nodedev: Expose PCI header type 2016-03-18 17:35:06 +01:00
formatnwfilter.html.in formatnwfilter.html.in: Kill useless spaces in <pre/> 2016-11-14 11:03:34 +01:00
formatsecret.html.in formatsecret.html.in: Kill useless spaces in <pre/> 2016-11-14 11:03:34 +01:00
formatsnapshot.html.in Revert "syntax-check: Enforce <code> inside <dt> elements" 2016-11-11 12:15:05 +00:00
formatstorage.html.in conf: Display <physical> in output of voldef 2016-12-20 13:52:39 -05:00
formatstorageencryption.html.in formatstorageencryption.html.in: Kill useless spaces in <pre/> 2016-11-14 11:03:34 +01:00
genaclperms.pl Add documentation for access control system 2013-08-09 17:13:02 +01:00
generic.css docs: Use Overpass Mono as the monospace font 2016-11-21 14:04:05 +01:00
goals.html.in Fix multiple formatting problems in HTML docs 2013-05-03 15:56:15 +01:00
governance.html.in Fix minor typo in governance doc 2014-02-04 10:43:15 -07:00
hacking1.xsl maint: tweak use of <a> in HACKING 2013-07-09 11:49:20 -06:00
hacking2.xsl HACKING: Reduce vertical whitespace 2017-01-04 16:06:04 +01:00
hacking.html.in HACKING: Regenerate 2017-01-04 14:53:11 +01:00
hooks.html.in libxl: add hooks support 2016-08-02 14:20:31 +02:00
hvsupport.pl docs: remove navigation sidebar from pages 2016-11-11 12:15:06 +00:00
index.html.in docs: link to news file and other resources 2016-12-19 10:58:55 +00:00
index.py Test for object identity when checking for None in Python 2013-08-23 08:12:26 +02:00
internals.html.in docs: Document our event loop 2016-06-06 17:35:44 +02:00
java.html.in docs: Correct invalid hyperlinks 2014-12-02 07:30:10 +01:00
libvirt-daemon-arch.fig Remove trailing whitespace from all xfig files 2011-10-28 10:11:16 +01:00
libvirt-daemon-arch.png build: regenerate .png files 2012-07-23 16:07:13 -06:00
libvirt-driver-arch.fig Remove trailing whitespace from all xfig files 2011-10-28 10:11:16 +01:00
libvirt-driver-arch.png build: regenerate .png files 2012-07-23 16:07:13 -06:00
libvirt-object-model.fig Remove trailing whitespace from all xfig files 2011-10-28 10:11:16 +01:00
libvirt-object-model.png build: regenerate .png files 2012-07-23 16:07:13 -06:00
libvirt-virConnect-example.fig internals: Update to include RPC and Lock links and add new data 2013-03-04 17:36:03 -05:00
libvirt-virConnect-example.png internals: Update to include RPC and Lock links and add new data 2013-03-04 17:36:03 -05:00
libvirt.css docs: remove navigation sidebar from pages 2016-11-11 12:15:06 +00:00
locking-lockd.html.in locking-lockd.html.in: Kill useless spaces in <pre/> 2016-11-14 11:03:34 +01:00
locking-sanlock.html.in locking-sanlock.html.in: Kill useless spaces in <pre/> 2016-11-14 11:03:34 +01:00
locking.html.in docs: Use <code> inside <dt> for symbols 2016-04-22 10:36:14 +02:00
logging.html.in logging.html.in: Kill useless spaces in <pre/> 2016-11-14 11:03:34 +01:00
main.css docs: use overpass font for website 2016-11-11 09:31:10 +00:00
Makefile.am docs: Rebuild apihtml docs when source changes 2016-12-07 06:07:16 -05:00
migration-managed-direct.fig Remove trailing whitespace from all xfig files 2011-10-28 10:11:16 +01:00
migration-managed-direct.png Add documentation about migration. 2011-10-28 10:07:45 +01:00
migration-managed-p2p.fig Remove trailing whitespace from all xfig files 2011-10-28 10:11:16 +01:00
migration-managed-p2p.png Add documentation about migration. 2011-10-28 10:07:45 +01:00
migration-native.fig Remove trailing whitespace from all xfig files 2011-10-28 10:11:16 +01:00
migration-native.png Add documentation about migration. 2011-10-28 10:07:45 +01:00
migration-tunnel.fig Remove trailing whitespace from all xfig files 2011-10-28 10:11:16 +01:00
migration-tunnel.png Add documentation about migration. 2011-10-28 10:07:45 +01:00
migration-unmanaged-direct.fig Remove trailing whitespace from all xfig files 2011-10-28 10:11:16 +01:00
migration-unmanaged-direct.png Add documentation about migration. 2011-10-28 10:07:45 +01:00
migration.html.in migration.html.in: Kill useless spaces in <pre/> 2016-11-14 11:03:34 +01:00
newapi.xsl docs: generate links from plain text documentation 2013-10-30 17:30:12 +01:00
news-2005.html.in NEWS: Split releases by year 2015-10-20 17:29:03 +02:00
news-2006.html.in NEWS: Split releases by year 2015-10-20 17:29:03 +02:00
news-2007.html.in NEWS: Split releases by year 2015-10-20 17:29:03 +02:00
news-2008.html.in NEWS: Split releases by year 2015-10-20 17:29:03 +02:00
news-2009.html.in NEWS: Split releases by year 2015-10-20 17:29:03 +02:00
news-2010.html.in NEWS: Split releases by year 2015-10-20 17:29:03 +02:00
news-2011.html.in NEWS: Split releases by year 2015-10-20 17:29:03 +02:00
news-2012.html.in NEWS: Split releases by year 2015-10-20 17:29:03 +02:00
news-2013.html.in NEWS: Split releases by year 2015-10-20 17:29:03 +02:00
news-2014.html.in NEWS: Split releases by year 2015-10-20 17:29:03 +02:00
news-2015.html.in NEWS: Don't prefix version numbers with 'v' 2016-01-18 10:53:22 +01:00
news-2016.html.in NEWS: Archive 2016 releases 2016-11-22 14:05:24 +01:00
news.html.in NEWS: Remove spurious period 2017-01-04 18:05:16 +01:00
news.xsl NEWS: Update XSLT stylesheet 2016-11-22 14:05:24 +01:00
node.fig Remove trailing whitespace from all xfig files 2011-10-28 10:11:16 +01:00
node.gif * doc/*: augment and try to complete the doc in its current state 2006-01-23 13:24:07 +00:00
nss.html.in nss: Introduce libvirt-guest module 2016-12-06 13:34:00 +01:00
page.xsl docs: Use href_base in absolute links 2017-01-04 15:10:06 +01:00
php.html.in docs: php: remove reference to Red Hat 2015-06-04 10:00:59 +02:00
python.html.in docs: Correct invalid hyperlinks 2014-12-02 07:30:10 +01:00
remote.html.in docs: fix default value for sshauth option of libssh2/libssh 2016-11-15 15:50:51 +01:00
search.php.code.in better patch for the XSS search issue 2015-07-03 21:04:24 +08:00
search.php.in docs: redo style of front page 2016-11-11 12:15:03 +00:00
secureusage.html.in Add some notes about secure usage of libvirt 2013-10-15 11:33:01 +01:00
securityprocess.html.in Fix common misspellings 2015-03-23 09:01:30 +01:00
site.xsl Fix docs generator regression in previous commit 2013-05-03 16:58:46 +01:00
storage.html.in storage.html.in: Kill useless spaces in <pre/> 2016-11-14 11:03:34 +01:00
structures.fig Remove trailing whitespace from all xfig files 2011-10-28 10:11:16 +01:00
subsite.xsl virCommand: docs for usage of new command APIs 2010-12-02 16:00:47 -07:00
testapi.html.in Fix multiple formatting problems in HTML docs 2013-05-03 15:56:15 +01:00
testsuites.html.in Fix multiple formatting problems in HTML docs 2013-05-03 15:56:15 +01:00
testtck.html.in Fix multiple formatting problems in HTML docs 2013-05-03 15:56:15 +01:00
uri.html.in docs: Correct invalid hyperlinks 2014-12-02 07:30:10 +01:00
virshcmdref.html.in Fix multiple formatting problems in HTML docs 2013-05-03 15:56:15 +01:00
windows.html.in Point users to Virt-Viewer MSI installers for Windows builds 2013-05-07 15:29:37 +01:00
wrapstring.xsl Generate HACKING from docs/hacking.html.in 2010-11-12 19:47:20 +01:00