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

Proposed by Ike Panhc on 2018-11-13
Status: Superseded
Proposed branch: lp:~ikepanhc/installation-guide/1730322-2
Merge into: lp:~ubuntu-core-dev/installation-guide/ubuntu
Diff against target: 170 lines (+39/-56)
7 files modified
build/entities/urls.ent (+2/-0)
build/templates/docstruct.ent (+1/-0)
debian/changelog (+6/-0)
en/hardware/supported/arm.xml (+4/-56)
en/install-methods/downloading-files.xml (+4/-0)
en/preparing/hwe.xml (+21/-0)
en/preparing/preparing.xml (+1/-0)
To merge this branch: bzr merge lp:~ikepanhc/installation-guide/1730322-2
Reviewer Review Type Date Requested Status
dann frazier 2018-11-13 Pending
Review via email: mp+358691@code.launchpad.net

This proposal supersedes a proposal from 2018-06-14.

This proposal has been superseded by a proposal from 2018-11-13.

To post a comment you must log in.
dann frazier (dannf) wrote : Posted in a previous version of this proposal

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

review: Needs Fixing
dann frazier (dannf) : Posted in a previous version of this proposal

Unmerged revisions

554. By Ike Panhc on 2018-11-13

Describe HWE kernel, point release and url for supported arm64 platform

Preview Diff

[H/L] Next/Prev Comment, [J/K] Next/Prev File, [N/P] Next/Prev Hunk
1=== modified file 'build/entities/urls.ent'
2--- build/entities/urls.ent 2018-06-06 21:26:51 +0000
3+++ build/entities/urls.ent 2018-11-13 09:12:25 +0000
4@@ -49,12 +49,14 @@
5 <!-- base for the current distribution -->
6 <!ENTITY disturlftp "&url-debian-ftp;debian/dists/&releasename;/">
7 <!ENTITY disturl "&url-archive;dists/&releasename;/">
8+<!ENTITY disturlhwe "&url-archive;dists/&releasename;-updates/">
9
10 <!-- base for unstable -->
11 <!ENTITY url-dist-unstable "&url-archive;dists/unstable/">
12
13 <!-- where to get the current debian-installer -->
14 <!ENTITY url-debian-installer "&disturl;main/installer-&architecture;/current/">
15+<!ENTITY url-debian-installer-hwe "&disturlhwe;main/installer-&architecture;/current/">
16
17 <!-- debian-installer WebSVN -->
18 <!ENTITY url-d-i-websvn "http://anonscm.debian.org/viewvc/d-i/">
19
20=== modified file 'build/templates/docstruct.ent'
21--- build/templates/docstruct.ent 2018-06-21 13:04:59 +0000
22+++ build/templates/docstruct.ent 2018-11-13 09:12:25 +0000
23@@ -41,6 +41,7 @@
24 <!ENTITY preparing.xml SYSTEM "##SRCPATH##/preparing/preparing.xml">
25 <!ENTITY install-overview.xml SYSTEM "##SRCPATH##/preparing/install-overview.xml">
26 <!ENTITY backup.xml SYSTEM "##SRCPATH##/preparing/backup.xml">
27+ <!ENTITY hwe.xml SYSTEM "##SRCPATH##/preparing/hwe.xml">
28 <!ENTITY needed-info.xml SYSTEM "##SRCPATH##/preparing/needed-info.xml">
29 <!ENTITY minimum-hardware-reqts.xml SYSTEM "##SRCPATH##/preparing/minimum-hardware-reqts.xml">
30 <!ENTITY non-debian-partitioning.xml SYSTEM "##SRCPATH##/preparing/non-debian-partitioning.xml">
31
32=== modified file 'debian/changelog'
33--- debian/changelog 2018-07-06 16:09:02 +0000
34+++ debian/changelog 2018-11-13 09:12:25 +0000
35@@ -1,3 +1,9 @@
36+installation-guide (20160121ubuntu8) cosmic; urgency=medium
37+
38+ * Describe HWE kernel, point release and url for supported arm64 platform
39+
40+ -- Ike Panhc <ike.pan@canonical.com> Tue, 13 Nov 2018 15:48:54 +0800
41+
42 installation-guide (20160121ubuntu7) cosmic; urgency=medium
43
44 * Fixed some appearance issues and long lines - mainly visible in the PDFs
45
46=== modified file 'en/hardware/supported/arm.xml'
47--- en/hardware/supported/arm.xml 2016-06-03 21:55:24 +0000
48+++ en/hardware/supported/arm.xml 2018-11-13 09:12:25 +0000
49@@ -104,64 +104,12 @@
50 support merged in the mainline kernel version by the time of this
51 release; this is the main requirement to have &d-i; working on
52 them. </phrase>
53- The following platforms are known to be supported by
54- &debian;/arm64 in this release. There is only one kernel image,
55- which supports all the listed platforms.
56+ Ubuntu provides generic arm64 kernel images for various supported
57+ platforms listed in
58+ <ulink url="https://wiki.ubuntu.com/ARM/Server/Install">Ubuntu Wiki</ulink>.
59+ You can check that page for platform-specific installation note.
60 </para>
61
62- <variablelist>
63- <varlistentry>
64- <term>Applied Micro (APM) Mustang/X-Gene</term>
65- <listitem>
66- <para>
67- The APM Mustang was the first Linux-capable ARMv8 system
68- available. It uses the X-gene SoC, which has since also
69- been used in other machines. It is an 8-core CPU, with
70- ethernet, USB and serial. A common form-factor looks just
71- like a desktop PC box, but many other versions are
72- expected in the future. Most of the hardware is supported
73- in the mainline kernel, but at this point USB support is
74- lacking in the &releasename-cap; kernel.
75- </para>
76- </listitem>
77- </varlistentry>
78-
79- <varlistentry>
80- <term>ARM Juno Development Platform</term>
81- <listitem>
82- <para>
83- Juno is a capable development board with a 6-core (2xA57,
84- 4xA53) ARMv8-A 800Mhz CPU, Mali (T624) graphics, 8GB DDR3
85- RAM, Ethernet, USB, Serial. It was designed for system
86- bring-up and power testing so is neither small nor cheap,
87- but was one of the first boards available. All the
88- on-board hardware is supported in the mainline kernel and
89- in &releasename-cap;.
90- </para>
91- </listitem>
92- </varlistentry>
93-
94- <varlistentry>
95- <term>Cavium ThunderX Reference Platforms CN8800-1S-CDK &amp; CN8800-2S-CDK</term>
96- <listitem>
97- <para>
98- The ThunderX 1S Reference Platform is a 1U rack mount chassis with a
99- Micro-ATX single socket motherboard supporting 10GE &amp; 40GE
100- networking, x8 PCIe, 4 HDD drive slots and 8 DDR3 memory slots. The
101- ThunderX 2S Reference Platform is a 2U rack mount chassis with a ½ SSI
102- dual socket motherboard supporting 10GE &amp; 40GE networking, x8 PCIe,
103- 6 HDD drive slots and 8 DDR4 memory slots. The 2U chassis can
104- accommodate 4 sleds and each of the sleds has a dual 48 core socket
105- design (96 cores per sled). The &releasename-cap; kernel has support
106- for nearly all on-board hardware. Certain exceptions, such as the IPMI
107- system interface (<filename>/dev/ipmi</filename>), may be supported in a
108- future &releasename-cap; update.
109- </para>
110- </listitem>
111- </varlistentry>
112-
113- </variablelist>
114-
115 <para>
116 When using &d-i; on non-UEFI systems, you may have to manually
117 make the system bootable at the end of the installation, e.g. by
118
119=== modified file 'en/install-methods/downloading-files.xml'
120--- en/install-methods/downloading-files.xml 2015-12-19 21:18:18 +0000
121+++ en/install-methods/downloading-files.xml 2018-11-13 09:12:25 +0000
122@@ -26,6 +26,10 @@
123 lists each image and its purpose.
124 </para>
125
126+<para>
127+The HWE installation images are located on each Ubuntu mirror in the directory <ulink url="&url-debian-installer-hwe;images/hwe-netboot/">ubuntu/dists/xenial-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.
128+</para>
129+
130 &download-arm.xml;
131 &download-powerpc.xml;
132
133
134=== added file 'en/preparing/hwe.xml'
135--- en/preparing/hwe.xml 1970-01-01 00:00:00 +0000
136+++ en/preparing/hwe.xml 2018-11-13 09:12:25 +0000
137@@ -0,0 +1,21 @@
138+ <sect1 id="point">
139+ <title>Point release and HWE kernel</title>
140+<para>
141+
142+The LTS release’s kernel is refreshed with a new, optional kernel at
143+some point releases. This kernel is referred to as the Hardware
144+Enablement (HWE) kernel, and provides support for new hardware that
145+has been introduced after the LTS’s GA. New hardware components are
146+supported by HWE kernels and on an installed system with proper
147+networking you can install it by an apt command which you can find it
148+at <ulink url="https://wiki.ubuntu.com/Kernel/LTSEnablementStack">LTSEnablementStack</ulink> on Ubuntu wiki.
149+
150+</para><para>
151+
152+The LTS point releases also provide an updated installation kernel for
153+scenarios where kernel support for key components, such as NIC or RAID
154+cards, is required during the installation process.
155+
156+</para>
157+
158+ </sect1>
159
160=== modified file 'en/preparing/preparing.xml'
161--- en/preparing/preparing.xml 2015-12-19 21:18:18 +0000
162+++ en/preparing/preparing.xml 2018-11-13 09:12:25 +0000
163@@ -13,6 +13,7 @@
164
165 &install-overview.xml;
166 &backup.xml;
167+&hwe.xml;
168 &needed-info.xml;
169 &minimum-hardware-reqts.xml;
170 &non-debian-partitioning.xml;

Subscribers

People subscribed via source and target branches

to all changes: