Merge lp:~ikepanhc/installation-guide/1730322-3 into lp:~ubuntu-core-dev/installation-guide/ubuntu

[Ike Panhc]

[dann frazier (dannf)]

Hi Ike - comments inline. Sorry for taking so long to get back to you!

review: Needs Fixing

[dann frazier (dannf)]

Thanks Ike - I've gone ahead and pushed this with a couple changes. 1) I split the arm server list change out into a separate commit. Technically this wasn't covered by LP: #1730322. I filed LP: ##1804306 for that. See inline comment for the other change.

review: Approve

=== modified file 'build/entities/urls.ent'
--- build/entities/urls.ent	2018-06-06 21:26:51 +0000
+++ build/entities/urls.ent	2018-11-13 09:36:18 +0000
@@ -49,12 +49,14 @@
 <!-- base for the current distribution -->
 <!ENTITY disturlftp "&url-debian-ftp;debian/dists/&releasename;/">
 <!ENTITY disturl    "&url-archive;dists/&releasename;/">
+<!ENTITY disturlhwe "&url-archive;dists/&releasename;-updates/">
 
 <!-- base for unstable -->
 <!ENTITY url-dist-unstable "&url-archive;dists/unstable/">
 
 <!-- where to get the current debian-installer -->
 <!ENTITY url-debian-installer "&disturl;main/installer-&architecture;/current/">
+<!ENTITY url-debian-installer-hwe "&disturlhwe;main/installer-&architecture;/current/">
 
 <!-- debian-installer WebSVN  -->
 <!ENTITY url-d-i-websvn "http://anonscm.debian.org/viewvc/d-i/">
 
=== modified file 'build/templates/docstruct.ent'
--- build/templates/docstruct.ent	2018-06-21 13:04:59 +0000
+++ build/templates/docstruct.ent	2018-11-13 09:36:18 +0000
@@ -41,6 +41,7 @@
  <!ENTITY preparing.xml     SYSTEM "##SRCPATH##/preparing/preparing.xml">
   <!ENTITY install-overview.xml        SYSTEM "##SRCPATH##/preparing/install-overview.xml">
   <!ENTITY backup.xml                  SYSTEM "##SRCPATH##/preparing/backup.xml">
+  <!ENTITY hwe.xml                     SYSTEM "##SRCPATH##/preparing/hwe.xml">
   <!ENTITY needed-info.xml             SYSTEM "##SRCPATH##/preparing/needed-info.xml">
   <!ENTITY minimum-hardware-reqts.xml  SYSTEM "##SRCPATH##/preparing/minimum-hardware-reqts.xml">
   <!ENTITY non-debian-partitioning.xml SYSTEM "##SRCPATH##/preparing/non-debian-partitioning.xml">
 
=== modified file 'debian/changelog'
--- debian/changelog	2018-07-06 16:09:02 +0000
+++ debian/changelog	2018-11-13 09:36:18 +0000
@@ -1,3 +1,9 @@
+installation-guide (20160121ubuntu8) cosmic; urgency=medium
+
+  * Describe HWE kernel, point release and url for supported arm64 platform
+
+ -- Ike Panhc <[e-mail]>  Tue, 13 Nov 2018 15:48:54 +0800
+
 installation-guide (20160121ubuntu7) cosmic; urgency=medium
 
   * Fixed some appearance issues and long lines - mainly visible in the PDFs 
 
=== modified file 'en/hardware/supported/arm.xml'
--- en/hardware/supported/arm.xml	2016-06-03 21:55:24 +0000
+++ en/hardware/supported/arm.xml	2018-11-13 09:36:18 +0000
@@ -104,64 +104,12 @@
     support merged in the mainline kernel version by the time of this
     release; this is the main requirement to have &d-i; working on
     them. </phrase>
-    The following platforms are known to be supported by
-    &debian;/arm64 in this release. There is only one kernel image,
-    which supports all the listed platforms.
+    Ubuntu provides generic arm64 kernel images for various supported
+    platforms listed in
+    <ulink url="https://wiki.ubuntu.com/ARM/Server/Install">Ubuntu Wiki</ulink>.
+    You can check that page for platform-specific installation notes.
   </para>
 
-  <variablelist>
-      <varlistentry>
-        <term>Applied Micro (APM) Mustang/X-Gene</term>
-        <listitem>
-          <para>
-	    The APM Mustang was the first Linux-capable ARMv8 system
-	    available. It uses the X-gene SoC, which has since also
-	    been used in other machines. It is an 8-core CPU, with
-	    ethernet, USB and serial. A common form-factor looks just
-	    like a desktop PC box, but many other versions are
-	    expected in the future. Most of the hardware is supported
-	    in the mainline kernel, but at this point USB support is
-	    lacking in the &releasename-cap; kernel.
-          </para>
-        </listitem>
-      </varlistentry>
-
-      <varlistentry>
-        <term>ARM Juno Development Platform</term>
-        <listitem>
-          <para>	    
-	    Juno is a capable development board with a 6-core (2xA57,
-	    4xA53) ARMv8-A 800Mhz CPU, Mali (T624) graphics, 8GB DDR3
-	    RAM, Ethernet, USB, Serial. It was designed for system
-	    bring-up and power testing so is neither small nor cheap,
-	    but was one of the first boards available. All the
-	    on-board hardware is supported in the mainline kernel and
-	    in &releasename-cap;.
-          </para>
-        </listitem>
-      </varlistentry>
-
-      <varlistentry>
-        <term>Cavium ThunderX Reference Platforms CN8800-1S-CDK &amp; CN8800-2S-CDK</term>
-        <listitem>
-          <para>
-	    The ThunderX 1S Reference Platform is a 1U rack mount chassis with a
-	    Micro-ATX single socket motherboard supporting 10GE &amp; 40GE
-	    networking, x8 PCIe, 4 HDD drive slots and 8 DDR3 memory slots. The
-	    ThunderX 2S Reference Platform is a 2U rack mount chassis with a ½ SSI
-	    dual socket motherboard supporting 10GE &amp; 40GE networking, x8 PCIe,
-	    6 HDD drive slots and 8 DDR4 memory slots. The 2U chassis can
-	    accommodate 4 sleds and each of the sleds has a dual 48 core socket
-	    design (96 cores per sled).  The &releasename-cap; kernel has support
-	    for nearly all on-board hardware. Certain exceptions, such as the IPMI
-	    system interface (<filename>/dev/ipmi</filename>), may be supported in a
-	    future &releasename-cap; update.
-          </para>
-        </listitem>
-      </varlistentry>
-
-  </variablelist>
-
   <para>
     When using &d-i; on non-UEFI systems, you may have to manually
     make the system bootable at the end of the installation, e.g. by
 
=== modified file 'en/install-methods/downloading-files.xml'
--- en/install-methods/downloading-files.xml	2015-12-19 21:18:18 +0000
+++ en/install-methods/downloading-files.xml	2018-11-13 09:36:18 +0000
@@ -26,6 +26,10 @@
 lists each image and its purpose.
 </para>
 
+<para>
+The HWE installation images are located on each Ubuntu mirror in the directory <ulink url="&url-debian-installer-hwe;images/hwe-netboot/">ubuntu/dists/&releasename;-updates/main/installer-arm64/current/images/hwe-netboot/</ulink>. The image will be available soon after HWE kernel is available and before second point release.
+</para>
+
 &download-arm.xml;
 &download-powerpc.xml;
 
 
=== added file 'en/preparing/hwe.xml'
--- en/preparing/hwe.xml	1970-01-01 00:00:00 +0000
+++ en/preparing/hwe.xml	2018-11-13 09:36:18 +0000
@@ -0,0 +1,21 @@
+ <sect1 id="point">
+ <title>Point release and HWE kernel</title>
+<para>
+
+The LTS release’s kernel is refreshed with a new, optional kernel at
+some point releases. This kernel is referred to as the Hardware
+Enablement (HWE) kernel, and provides support for new hardware that
+has been introduced after the LTS’s GA. New hardware components are
+supported by HWE kernels and on an installed system with proper
+networking you can install it by an apt command which you can find it
+at <ulink url="https://wiki.ubuntu.com/Kernel/LTSEnablementStack">LTSEnablementStack</ulink> on Ubuntu wiki.
+
+</para><para>
+
+The LTS point releases also provide an updated installation kernel for
+scenarios where kernel support for key components, such as NIC or RAID
+cards, is required during the installation process.
+
+</para>
+
+ </sect1>
 
=== modified file 'en/preparing/preparing.xml'
--- en/preparing/preparing.xml	2015-12-19 21:18:18 +0000
+++ en/preparing/preparing.xml	2018-11-13 09:36:18 +0000
@@ -13,6 +13,7 @@
 
 &install-overview.xml;
 &backup.xml;
+&hwe.xml;
 &needed-info.xml;
 &minimum-hardware-reqts.xml;
 &non-debian-partitioning.xml;