Merge lp:~louis/serverguide/iscsi-install into lp:serverguide/trunk

[Louis Bouchard]

Added iSCSI installation section to Advanced Installation

[Doug Smythies (dsmythies)]

Thanks very much for this:

+ enter</para>
should be:
+ <keycap>ENTER</keycap></para>

in 5 spots total, including the above. I'll do the edits when I merge it.

review: Approve

[Louis Bouchard (louis)]

Hi,

Le 07/04/2016 00:08, Doug Smythies a écrit :
> Review: Approve
>
> Thanks very much for this:
>
> + enter</para>
> should be:
> + <keycap>ENTER</keycap></para>
>
> in 5 spots total, including the above. I'll do the edits when I merge it.
>

Thanks. I'll make a note of this for my future contributions.

I'm about to enhence the kdump section.

Kind regards,

...Louis

--
Louis Bouchard
Software engineer, Cloud & Sustaining eng.
Canonical Ltd
Ubuntu developer Debian Maintainer
GPG : 429D 7A3B DD05 B6F8 AF63 B9C4 8B3D 867C 823E 7A61

=== modified file 'serverguide/C/installation.xml'
--- serverguide/C/installation.xml	2016-03-19 02:00:31 +0000
+++ serverguide/C/installation.xml	2016-04-06 15:44:00 +0000
@@ -1186,6 +1186,181 @@
           </itemizedlist>
         </sect3>
       </sect2>     
+      <sect2 id="iscsi" status="review">
+        <title>iSCSI</title>
+
+        <para>The iSCSI protocol can be used to install Ubuntu on systems with
+        or without hard disks attached.</para>
+
+        <sect3>
+          <title>Installation on a diskless system</title>
+
+          <para>The first steps of a diskless iSCSI installation are identical
+          to the <xref linkend="installing-from-cd"/> section up to "Hard drive
+          layout".</para>
+
+          <procedure>
+            <step>
+              <para>The installer will display a warning with the following
+              message:</para>
+
+              <screen>No disk drive was detected. If you know the name of the driver needed by your disk drive, you can select it from the list.</screen>
+            </step>
+
+            <step>
+              <para>Select the item in the list titled <emphasis>login to iSCSI
+              targets.</emphasis></para>
+            </step>
+
+            <step>
+              <para>You will be prompted to Enter an IP address to scan for
+              iSCSI targets with a description of the format for the address.
+              Enter the IP address for the location of your iSCSI target and
+              navigate to <emphasis>&lt;continue&gt;</emphasis> then hit
+              enter</para>
+            </step>
+
+            <step>
+              <para>If authentication is required in order to access the iSCSI
+              device, provide the <emphasis>username</emphasis> in the next
+              field. Otherwise leave it blank.</para>
+            </step>
+
+            <step>
+              <para>If your system is able to connect to the iSCSI provider, you
+              should see a list of available iSCSI targets where the operating
+              system can be installed. The list should be similar to the
+              following :</para>
+
+              <screen>Select the iSCSI targets you wish to use.
+
+iSCSI targets on 192.168.1.29:3260:
+
+[ ] iqn.2016-03.TrustyS-iscsitarget:storage.sys0
+
+&lt;Go Back&gt;                          &lt;Continue&gt;
+
+</screen>
+            </step>
+
+            <step>
+              <para>Select the iSCSI target that you want to use with the space
+              bar. Use the arrow keys to navigate to the target that you want to
+              select.</para>
+            </step>
+
+            <step>
+              <para>Navigate to <emphasis>&lt;Continue&gt;</emphasis> and hit
+              Enter.</para>
+            </step>
+          </procedure>
+
+          <para>If the connection to the iSCSI target is successful, you will be
+          prompted with the <emphasis>[!!] Partition disks</emphasis>
+          installation menu. The rest of the procedure is identical to any
+          normal installation on attached disks. Once the installation is
+          completed, you will be asked to reboot.</para>
+        </sect3>
+
+        <sect3>
+          <title>Installation on a system with disk attached</title>
+
+          <para>Again, the iSCSI installation on a normal server with one or
+          many disks attached is identical to the <xref
+          linkend="installing-from-cd"/> section until we reach the disk
+          partitioning menu. Instead of using any of the Guided selection, we
+          need to perform the following steps :</para>
+
+          <procedure>
+            <step>
+              <para>Navigate to the Manual menu entry</para>
+            </step>
+
+            <step>
+              <para>Select the Configure iSCSI Volumes menu entry</para>
+            </step>
+
+            <step>
+              <para>Choose the Log into iSCSI targets</para>
+            </step>
+
+            <step>
+              <para>You will be prompted to Enter an IP address to scan for
+              iSCSI targets. with a description of the format for the address.
+              Enter the IP address and navigate to
+              <emphasis>&lt;continue&gt;</emphasis> then hit enter</para>
+            </step>
+
+            <step>
+              <para>If authentication is required in order to access the iSCSI
+              device, provide the <emphasis>username</emphasis> in the next
+              field or leave it blank.</para>
+            </step>
+
+            <step>
+              <para>If your system is able to connect to the iSCSI provider, you
+              should see a list of available iSCSI targets where the operating
+              system can be installed. The list should be similar to the
+              following :</para>
+
+            <screen>Select the iSCSI targets you wish to use.
+
+iSCSI targets on 192.168.1.29:3260:
+
+[ ] iqn.2016-03.TrustyS-iscsitarget:storage.sys0
+
+&lt;Go Back&gt;                          &lt;Continue&gt;
+</screen>
+            </step>
+
+            <step>
+              <para>Select the iSCSI target that you want to use with the space
+              bar. Use the arrow keys to navigate to the target that you want to
+              select</para>
+            </step>
+
+            <step>
+              <para>Navigate to &lt;Continue&gt; and hit Enter.</para>
+            </step>
+
+            <step>
+              <para>If successful, you will come back to the menu asking you to
+              Log into iSCSI targets. Navigate to Finish and hit
+              &lt;Enter&gt;</para>
+            </step>
+          </procedure>
+
+          <para>The newly connected iSCSI disk will appear in the overview
+          section as a device prefixed with SCSI. This is the disk that you
+          should select as your installation disk. Once identified, you can
+          choose any of the partitioning methods.</para>
+
+          <warning>
+            <para>Depending on your system configuration, there may be other
+            SCSI disks attached to the system. Be very careful to identify the
+            proper device before proceeding with the installation. Otherwise,
+            irreversible data loss may result from performing an installation on
+            the wrong disk.</para>
+          </warning>
+        </sect3>
+
+        <sect3>
+          <title>Rebooting to an iSCSI target</title>
+
+          <para>The procedure is specific to your hardware platform. As an
+          example, here is how to reboot to your iSCSI target using iPXE</para>
+
+          <screen>iPXE&gt; dhcp
+
+Configuring (net0 52:54:00:a4:f2:a9)....... ok
+
+iPXE&gt; sanboot iscsi:192.168.1.29::::iqn.2016-03.TrustyS-iscsitarget:storage.sys0
+</screen>
+
+          <para>If the procedure is successful, you should see the Grub menu
+          appear on the screen.</para>
+        </sect3>
+      </sect2>
     </sect1>
 
     <sect1 id="kernel-crash-dump" status="review">