← Back to branch summary

~andreserl/maas/refactor_debconf_selections_preseed

« back to all changes in this revision

Viewing changes to docs/hardware-enablement-kernels.rst

  • Committer: LaMont Jones
  • Date: 2017-02-17 14:23:04 UTC
  • mfrom: (5747 maas)
  • mto: This revision was merged to the branch mainline in revision 5748.
  • Revision ID: lamont@canonical.com-20170217142304-djxqtuvefc1sdfnb
Merge trunk

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/hardware-enablement-kernels.rst
1
 
.. -*- mode: rst -*-
2
 
 
3
 
.. _hardware-enablement-kernels:
4
 
 
5
 
=================================
6
 
Using hardware-enablement kernels
7
 
=================================
8
 
 
9
 
.. note::
10
 
 
11
 
  As of MAAS 1.9 this feature is configured by setting the hwe_kernel variable
12
 
  instead of the architecture variable.
13
 
 
14
 
MAAS allows you to use hardware enablement kernels when booting nodes
15
 
with Ubuntu that require them.
16
 
 
17
 
What are hardware-enablement kernels?
18
 
-------------------------------------
19
 
 
20
 
Brand new hardware gets released all the time. We want that hardware to
21
 
work well with Ubuntu and MAAS, even if it was released after the latest
22
 
release of MAAS or Ubuntu. Hardware Enablement (HWE) is all about keeping
23
 
pace with the new hardware.
24
 
 
25
 
Ubuntu's solution to this is to offer newer kernels for older releases.
26
 
There are at least two kernels on offer for Ubuntu releases: the
27
 
"generic" kernel -- i.e. the kernel released with the current series --
28
 
and the Hardware Enablement kernel, which is the most recent kernel
29
 
release.
30
 
 
31
 
There are separate HWE kernels for each release of Ubuntu, referred to
32
 
as ``hwe-<release letter>``. So, the 14.04 / Trusty Tahr HWE kernel is
33
 
called ``hwe-t``, the 12.10 / Quantal Quetzal HWE kernel is called
34
 
``hwe-q`` and so on. This allows you to use newer kernels with older
35
 
releases, for example running Precise with a Saucy (hwe-s) kernel.
36
 
 
37
 
For more information see the `LTS Enablement Stack`_ page on the Ubuntu
38
 
wiki.
39
 
 
40
 
.. _LTS Enablement Stack:
41
 
   https://wiki.ubuntu.com/Kernel/LTSEnablementStack
42
 
 
43
 
 
44
 
Booting hardware-enablement kernels
45
 
-----------------------------------
46
 
 
47
 
MAAS imports hardware-enablement kernels along with its generic boot
48
 
images. These hardware-enablement kernels are specified by using min_hwe_kernel
49
 
or hwe_kernel variables.
50
 
 
51
 
The min_hwe_kernel variable is used to instruct MAAS to ensure the release to
52
 
be deployed uses a kernel version at or above the value of min_hwe_kernel. For
53
 
example if min_hwe_kernel is set to hwe-t when deploying any release before
54
 
Trusty the hwe-t kernel will be used. For any release after Trusty the default
55
 
kernel for that release will be used. If hwe-t or newer is not availible for
56
 
the specified release MAAS will not allow that release to be deployed and throw
57
 
an error.
58
 
 
59
 
min_hwe_kernel can be set by running the command::
60
 
 
61
 
  $ maas <profile-name> node update <system-id>
62
 
    min_hwe_kernel=hwe-<release letter>
63
 
 
64
 
It's also possible to set the min_hwe_kernel from the MAAS web UI, by visiting
65
 
the Node's page and clicking ``Edit node``. Under the Minimum Kernel field, you
66
 
will be able to select any HWE kernels that have been imported onto that node's
67
 
cluster controller.
68
 
 
69
 
.. image:: media/min_hwe_kernel.png
70
 
 
71
 
You can also set the hwe_kernel during deployment. MAAS checks that the
72
 
specified kernel is avalible for the release specified before deploying the
73
 
node. You can set the hwe_kernel when deploying by using the command::
74
 
 
75
 
  $ maas <profile-name> node start <system-id> distro_series=<distro>
76
 
  hwe_kernel=hwe-<release letter>
77
 
 
78
 
Or through the web interface as seen below.
79
 
 
80
 
.. image:: media/hwe_kernel.png