Merge lp:~mfo/serverguide/ibft into lp:serverguide/trunk

[Mauricio Faria de Oliveira]

This commit updates the Server Guide -> Installation -> Advanced Installaion -> iSCSI section to describe the debian-installer support for iBFT and which parameters enable it.

[Doug Smythies (dsmythies)]

Thank you.

review: Approve

[Mauricio Faria de Oliveira (mfo)]

Hi Doug Smythies,

Thank you for merging this doc update.

I see the change is not yet 'live' on the webpage yet.

Is there something I should do to help with that,
or just wait some process/schedule to happen?

Thank you,
Mauricio

[Doug Smythies (dsmythies)]

I'll re-publish the 18.04 Ubuntu Serverguide soon. There were another couple of bug fixes desired to be included in the same point release / publication.

[Mauricio Faria de Oliveira (mfo)]

Ok, thanks for clarifying!

[Doug Smythies (dsmythies)]

I did a point release publication of the Serverguide last night.
(it is much easier now, as we are testing only publishing in U.S. English, so no translation cycle per point release.)
https://help.ubuntu.com/lts/serverguide/advanced-installation.html#iscsi

=== modified file 'serverguide/C/installation.xml'
--- serverguide/C/installation.xml	2018-09-26 15:27:33 +0000
+++ serverguide/C/installation.xml	2019-07-17 16:41:27 +0000
@@ -1289,7 +1289,8 @@
         <title>iSCSI</title>
 
         <para>The iSCSI protocol can be used to install Ubuntu on systems with
-        or without hard disks attached.</para>
+        or without hard disks attached, and iBFT can be used to automate iSCSI
+        setup on installation and boot.</para>
 
         <sect3>
           <title>Installation on a diskless system</title>
@@ -1443,6 +1444,26 @@
         </sect3>
 
         <sect3>
+          <title>Installation with iBFT</title>
+
+          <para>In order to setup iSCSI based on the iBFT (iSCSI Boot Firmware Table)
+          on the installation and boot, append these options at the installer prompt
+          (or to the preseed file):</para>
+
+          <screen>disk-detect/ibft/enable=true partman-iscsi/iscsi_auto=true</screen>
+
+          <para>This should probe for iBFT information and configure network interface(s)
+          and iSCSI target(s) accordingly during the installation, and configure system
+          boot (initramfs) to do that too in order to find the root device.</para>
+
+          <warning>
+            <para>The support for iBFT is available in the debian-installer on netboot
+            images as of 2019-06-20 and (expected) on ISO images for the 18.04.3 point
+            release and later.</para>
+          </warning>
+        </sect3>
+
+        <sect3>
           <title>Rebooting to an iSCSI target</title>
 
           <para>The procedure is specific to your hardware platform. As an