~rvb/maas/transaction-1.7-bug-1409852

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
===========================
Setting kernel boot options
===========================

MAAS is able to send specific kernel options to booting nodes on both
a global basis and a per-node basis.

Global kernel options
---------------------

As an admin, click on the gear icon at the top right and scroll down to
the Global Kernel Parameters section, as shown here:

.. image:: media/global_kernel_opts.png

Whatever you set here is sent as-is to all booting nodes.

Per-node kernel options
-----------------------

Per-node kernel options are set using tags.  The easiest way of doing this
is to use the ``maas`` command.  You will need to :ref:`be
logged in to the API first <api-key>` and then you can add a tag which has its
``kernel_opts`` value set, like this::

  $ maas maas tags new name='nomodeset' \
    comment='nomodeset kernel option' kernel_opts='nomodeset vga'

Once the tag is defined, you can add it to a node or nodes::

  $ maas maas tag update-nodes nomodeset add=<system_id_1> \
    add=<system_id_2>

.. note::

  Any per-node kernel options set will completely override the global options.
  If multiple tags attached to a node have the kernel_opts defined, the first
  one ordered by name is used.