~andreserl/maas/lp1665143

« back to all changes in this revision

Viewing changes to docs/os-support.rst

Merged specify_scripts_commissioning into test_api.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
.. -*- mode: rst -*-
2
 
 
3
 
.. _os-support:
4
 
 
5
 
=========================
6
 
Operating Systems Support
7
 
=========================
8
 
 
9
 
.. note::
10
 
 
11
 
  This feature is available in MAAS versions 1.7 and above.
12
 
 
13
 
Besides Ubuntu, MAAS allows users to deploy different operating
14
 
systems, such as CentOS. Ubuntu Advantage customers can
15
 
additionally deploy Redhat Enterprise Linux (RHEL), OpenSUSE, SLES,
16
 
Window Server and Windows HyperV.
17
 
 
18
 
 
19
 
Generated Images vs. Custom Images
20
 
----------------------------------
21
 
 
22
 
MAAS supports two different classes of OS images, `Generated images`
23
 
and `Custom images`.
24
 
 
25
 
`Generated images` are images of the OS' that MAAS team fully
26
 
supports. Currently supported OS' are CentOS and Windows.
27
 
 
28
 
`Custom images` are images that MAAS can deploy, but may have been
29
 
customized and differ from those that the MAAS team supports. Custom
30
 
images can include any Ubuntu, CentOS or Windows image. Additionally,
31
 
Redhat Enterprise Linux (RHEL), OpenSUSE and SLES images also fall
32
 
under this category.
33
 
 
34
 
 
35
 
Installing MAAS Images
36
 
----------------------
37
 
 
38
 
Installing Generated Images
39
 
^^^^^^^^^^^^^^^^^^^^^^^^^^^
40
 
 
41
 
Installing MAAS Generated Images (CentOS or Windows) can be done with
42
 
the command::
43
 
 
44
 
    $ maas admin boot-resources create name=<os/series>
45
 
      architecture=<architecture> [filetype=ddtgz]
46
 
      content@=<image-name>
47
 
 
48
 
The list of supported Operating Systems under `Generated Images` is:
49
 
 
50
 
 * CentOS 6.5 (centos/centos65)
51
 
 * CentOS 7 (centos/centos7)
52
 
 * Windows Server 2012 (windows/win2012)
53
 
 * Windows Server 2012 R2 (windows/win2012r2)
54
 
 * Windows Hyper-V (windows/win2012hv)
55
 
 * Windows Hyper-V R2 (windows/win2012hvr2)
56
 
 
57
 
Examples::
58
 
 
59
 
    $ maas admin boot-resources create name=centos/centos7
60
 
      architecture=amd64/generic content@=centos7-amd64-root-tgz
61
 
 
62
 
    $ maas admin boot-resources create name=windows/win2012
63
 
      architecture=amd64/generic filetype=ddtgz
64
 
      content@=win2012-amd64-ddtgz
65
 
 
66
 
Installing Custom Images
67
 
^^^^^^^^^^^^^^^^^^^^^^^^
68
 
 
69
 
Installing custom images require the user to specify a unique
70
 
identifier for the OS and Release, as well as the title of the
71
 
Image::
72
 
 
73
 
    $ maas admin boot-resources create name=custom/<os-release-id>
74
 
      title=<title> architecture=amd64/generic content@=<image-name>
75
 
 
76
 
Examples::
77
 
 
78
 
    $ maas admin boot-resources create name=custom/rhel7
79
 
      title="RedHat Enterprise Linux 7" architecture=amd64/generic
80
 
      content@=rhel7-amd64-root-tgz
81
 
 
82
 
The list of tested Operating Systems under `Custom Images` is:
83
 
 
84
 
 * OpenSUSE
85
 
 * SLES 11 and SLES 12
86
 
 * Redhat Enterprise Linux 7 (RHEL7)
87
 
 
88
 
 
89
 
MAAS Image Builder
90
 
------------------
91
 
 
92
 
The MAAS Image Builder is a script that allows users to generate their
93
 
own images. However, ``maas-image-builder`` only supports the generation
94
 
of CentOS and RHEL images. To install ``maas-image-builder``, please
95
 
follow the instructions::
96
 
 
97
 
  $ sudo apt-add-repository ppa:maas-maintainers/stable
98
 
  $ sudo apt-get install maas-image-builder
99
 
 
100
 
 
101
 
Creating and Installing CentOS MAAS Images
102
 
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
103
 
 
104
 
.. note::
105
 
 
106
 
  Supported CentOS versions are CentOS 6.5 (centos65) and CentOS 7 (centos7).
107
 
 
108
 
 
109
 
To create a MAAS CentOS image, no ISO is needed as all of the required
110
 
software to create the image is downloaded (from CentOS repositories) as part
111
 
of the image generation process. To create the MAAS CentOS image,
112
 
``maas-image-builder`` can be used as::
113
 
 
114
 
    $ maas-image-builder -a amd64 -o centos7-amd64-root-tgz centos --edition 7
115
 
 
116
 
The created image, ``centos7-amd64-root-tgz``, needs to be uploaded into the
117
 
MAAS Region Controller. This image will be listed under the `Generated` Image
118
 
Section in the `MAAS Image` page. This image can be uploaded with::
119
 
 
120
 
    $ maas admin boot-resources create name=centos/centos7
121
 
      architecture=amd64/generic content@=./build-output/centos7-amd64-root-tgz