Merge lp:~allenap/maas/docs-and-man-tidy into lp:~maas-committers/maas/trunk
- docs-and-man-tidy
- Merge into trunk
Status: | Merged | ||||
---|---|---|---|---|---|
Approved by: | Gavin Panella | ||||
Approved revision: | no longer in the source branch. | ||||
Merged at revision: | 1357 | ||||
Proposed branch: | lp:~allenap/maas/docs-and-man-tidy | ||||
Merge into: | lp:~maas-committers/maas/trunk | ||||
Prerequisite: | lp:~evilnick/maas/rm-import-pxe-references | ||||
Diff against target: |
1491 lines (+382/-265) 14 files modified
.bzrignore (+1/-2) INSTALL.txt (+120/-50) Makefile (+3/-5) docs/about.rst (+24/-8) docs/configure.rst (+9/-3) docs/index.rst (+9/-5) docs/juju-quick-start.rst (+0/-2) docs/maascli.rst (+84/-88) docs/man/maas-cli.8.rst (+6/-5) docs/man/maas.8.rst (+13/-9) docs/nodes.rst (+22/-13) docs/orientation.rst (+33/-16) docs/tags.rst (+37/-42) docs/troubleshooting.rst (+21/-17) |
||||
To merge this branch: | bzr merge lp:~allenap/maas/docs-and-man-tidy | ||||
Related bugs: |
|
Reviewer | Review Type | Date Requested | Status |
---|---|---|---|
Nick Veitch (community) | Approve | ||
Julian Edwards (community) | Approve | ||
Review via email: mp+135248@code.launchpad.net |
Commit message
Wrap and tidy documentation, and address many doc generation errors.
Description of the change
Nick Veitch (evilnick) wrote : | # |
I think this looks okay. The only thing that worries me slightly is that references and some of the directives don't work if you break the lines, but I guess you have checked the output
Gavin Panella (allenap) wrote : | # |
On 21 November 2012 09:08, Nick Veitch <email address hidden> wrote:
> Review: Approve
>
> I think this looks okay. The only thing that worries me slightly is
> that references and some of the directives don't work if you break
> the lines, ...
Gah, really? I half remember that now you mention it.
> but I guess you have checked the output
Oh... yeeees, yes, of course.
/me scuttles to check output some more
Gavin Panella (allenap) wrote : | # |
To sanity check things, I've used the following to compare the docs
generated in trunk to those generated in this branch:
for file in docs/_build/
do
echo === $file
diff -u <(hxnormalize ../trunk/$file) <(hxnormalize $file)
done
(hxnormalize comes from the html-xml-utils package.)
Preview Diff
1 | === modified file '.bzrignore' | |||
2 | --- .bzrignore 2012-11-20 16:45:09 +0000 | |||
3 | +++ .bzrignore 2012-11-21 11:51:34 +0000 | |||
4 | @@ -10,7 +10,6 @@ | |||
5 | 10 | ./acceptance/source | 10 | ./acceptance/source |
6 | 11 | ./bin | 11 | ./bin |
7 | 12 | ./build | 12 | ./build |
8 | 13 | ./celerybeat-schedule | ||
9 | 14 | ./db | 13 | ./db |
10 | 15 | ./develop-eggs | 14 | ./develop-eggs |
11 | 16 | ./dist | 15 | ./dist |
12 | @@ -22,6 +21,7 @@ | |||
13 | 22 | ./lib | 21 | ./lib |
14 | 23 | ./local | 22 | ./local |
15 | 24 | ./logs/* | 23 | ./logs/* |
16 | 24 | ./man | ||
17 | 25 | ./media/demo/* | 25 | ./media/demo/* |
18 | 26 | ./media/development | 26 | ./media/development |
19 | 27 | ./parts | 27 | ./parts |
20 | @@ -31,4 +31,3 @@ | |||
21 | 31 | ./TAGS | 31 | ./TAGS |
22 | 32 | ./tags | 32 | ./tags |
23 | 33 | dropin.cache | 33 | dropin.cache |
24 | 34 | ./man | ||
25 | 35 | 34 | ||
26 | === modified file 'INSTALL.txt' | |||
27 | --- INSTALL.txt 2012-11-20 16:45:09 +0000 | |||
28 | +++ INSTALL.txt 2012-11-21 11:51:34 +0000 | |||
29 | @@ -1,16 +1,18 @@ | |||
30 | 1 | .. -*- mode: rst -*- | 1 | .. -*- mode: rst -*- |
31 | 2 | 2 | ||
33 | 3 | 3 | ||
34 | 4 | Installing MAAS | 4 | Installing MAAS |
35 | 5 | =============== | 5 | =============== |
36 | 6 | 6 | ||
37 | 7 | There are two main ways to install MAAS | 7 | There are two main ways to install MAAS |
38 | 8 | 8 | ||
42 | 9 | * :ref:`From Ubuntu's package archive on an existing Ubuntu install. <pkg-install>` | 9 | * :ref:`From Ubuntu's package archive on an existing Ubuntu |
43 | 10 | * :ref:`As a fresh install from Ubuntu Server install media. <disc-install>` | 10 | install. <pkg-install>` |
44 | 11 | 11 | * :ref:`As a fresh install from Ubuntu Server install | |
45 | 12 | media. <disc-install>` | ||
46 | 12 | 13 | ||
48 | 13 | If you are interested in testing the latest development version you can also check out the very latest source and build MAAS yourself. | 14 | If you are interested in testing the latest development version you |
49 | 15 | can also check out the very latest source and build MAAS yourself. | ||
50 | 14 | 16 | ||
51 | 15 | 17 | ||
52 | 16 | .. _pkg-install: | 18 | .. _pkg-install: |
53 | @@ -18,17 +20,34 @@ | |||
54 | 18 | Installing MAAS from the archive | 20 | Installing MAAS from the archive |
55 | 19 | -------------------------------- | 21 | -------------------------------- |
56 | 20 | 22 | ||
58 | 21 | Installing MAAS from packages is thankfully straightforward. There are actually several packages that go into making up a working MAAS install, but for convenience, many of these have been gathered into a virtual package called 'maas' which will install the necessary components for a 'seed cloud', that is a single server that will directly control a group of nodes. The main packages are: | 23 | Installing MAAS from packages is thankfully straightforward. There are |
59 | 24 | actually several packages that go into making up a working MAAS | ||
60 | 25 | install, but for convenience, many of these have been gathered into a | ||
61 | 26 | virtual package called 'maas' which will install the necessary | ||
62 | 27 | components for a 'seed cloud', that is a single server that will | ||
63 | 28 | directly control a group of nodes. The main packages are: | ||
64 | 22 | 29 | ||
66 | 23 | * ``maas`` - seed cloud setup, which includes both the region controller and the cluster controller below. | 30 | * ``maas`` - seed cloud setup, which includes both the region |
67 | 31 | controller and the cluster controller below. | ||
68 | 24 | * ``maas-region-controller`` - includes the web UI, API and database. | 32 | * ``maas-region-controller`` - includes the web UI, API and database. |
70 | 25 | * ``maas-cluster-controller`` - controls a group ("cluster") of nodes including DHCP management. | 33 | * ``maas-cluster-controller`` - controls a group ("cluster") of nodes |
71 | 34 | including DHCP management. | ||
72 | 26 | * ``maas-dhcp``/``maas-dns`` - required when managing dhcp/dns. | 35 | * ``maas-dhcp``/``maas-dns`` - required when managing dhcp/dns. |
73 | 27 | 36 | ||
78 | 28 | If you need to separate these services or want to deploy an additional cluster controller, you should install the corresponding packages individually (see :ref:`the description of a typical setup <setup>` for more background on how a typical hardware setup might be arranged). | 37 | If you need to separate these services or want to deploy an additional |
79 | 29 | 38 | cluster controller, you should install the corresponding packages | |
80 | 30 | There are two suggested additional packages 'maas-dhcp' and 'maas-dns'. These set up MAAS-controlled DHCP and DNS services which greatly simplify deployment if you are running a typical setup where the MAAS controller can run the network (Note: These **must** be installed if you later set the options in the web interface to have MAAS manage DHCP/DNS). If you need to integrate your MAAS setup under an existing DHCP setup, see :ref:`manual-dhcp` | 39 | individually (see :ref:`the description of a typical setup <setup>` |
81 | 31 | 40 | for more background on how a typical hardware setup might be | |
82 | 41 | arranged). | ||
83 | 42 | |||
84 | 43 | There are two suggested additional packages 'maas-dhcp' and | ||
85 | 44 | 'maas-dns'. These set up MAAS-controlled DHCP and DNS services which | ||
86 | 45 | greatly simplify deployment if you are running a typical setup where | ||
87 | 46 | the MAAS controller can run the network (Note: These **must** be | ||
88 | 47 | installed if you later set the options in the web interface to have | ||
89 | 48 | MAAS manage DHCP/DNS). If you need to integrate your MAAS setup under | ||
90 | 49 | an existing DHCP setup, see :ref:`manual-dhcp` | ||
91 | 50 | |||
92 | 32 | 51 | ||
93 | 33 | Install packages | 52 | Install packages |
94 | 34 | ^^^^^^^^^^^^^^^^ | 53 | ^^^^^^^^^^^^^^^^ |
95 | @@ -37,83 +56,118 @@ | |||
96 | 37 | 56 | ||
97 | 38 | $ sudo apt-get install maas maas-dhcp maas-dns | 57 | $ sudo apt-get install maas maas-dhcp maas-dns |
98 | 39 | 58 | ||
100 | 40 | You will see a list of packages and a confirmation message to proceed. The exact list will obviously depend on what you already have installed on your server, but expect to add about 200MB of files. | 59 | You will see a list of packages and a confirmation message to |
101 | 60 | proceed. The exact list will obviously depend on what you already have | ||
102 | 61 | installed on your server, but expect to add about 200MB of files. | ||
103 | 41 | 62 | ||
105 | 42 | The configuration for the MAAS controller will automatically run and pop up this config screen: | 63 | The configuration for the MAAS controller will automatically run and |
106 | 64 | pop up this config screen: | ||
107 | 43 | 65 | ||
108 | 44 | .. image:: media/install_cluster-config.* | 66 | .. image:: media/install_cluster-config.* |
109 | 45 | 67 | ||
111 | 46 | Here you will need to enter the hostname for where the region controller can be contacted. In many scenarios, you may be running the region controller (i.e. the web and API interface) from a different network address, for example where a server has several network interfaces. | 68 | Here you will need to enter the hostname for where the region |
112 | 69 | controller can be contacted. In many scenarios, you may be running the | ||
113 | 70 | region controller (i.e. the web and API interface) from a different | ||
114 | 71 | network address, for example where a server has several network | ||
115 | 72 | interfaces. | ||
116 | 47 | 73 | ||
118 | 48 | Once the configuration scripts have run you should see this message telling you that the system is ready to use: | 74 | Once the configuration scripts have run you should see this message |
119 | 75 | telling you that the system is ready to use: | ||
120 | 49 | 76 | ||
121 | 50 | .. image:: media/install_controller-config.* | 77 | .. image:: media/install_controller-config.* |
122 | 51 | 78 | ||
124 | 52 | The web server is started last, so you have to accept this message before the service is run and you can access the Web interface. Then there are just a few more setup steps :ref:`post_install` | 79 | The web server is started last, so you have to accept this message |
125 | 80 | before the service is run and you can access the Web interface. Then | ||
126 | 81 | there are just a few more setup steps :ref:`post_install` | ||
127 | 82 | |||
128 | 53 | 83 | ||
129 | 54 | .. _disc-install: | 84 | .. _disc-install: |
130 | 55 | 85 | ||
131 | 56 | Installing MAAS from Ubuntu Server boot media | 86 | Installing MAAS from Ubuntu Server boot media |
132 | 57 | --------------------------------------------- | 87 | --------------------------------------------- |
133 | 58 | 88 | ||
136 | 59 | If you are installing MAAS as part of a fresh install it is easiest to choose the "Multiple Server install with MAAS" option from the installer and have pretty much everything set up for you. | 89 | If you are installing MAAS as part of a fresh install it is easiest to |
137 | 60 | Boot from the Ubuntu Server media and you will be greeted with the usual language selection screen: | 90 | choose the "Multiple Server install with MAAS" option from the |
138 | 91 | installer and have pretty much everything set up for you. Boot from | ||
139 | 92 | the Ubuntu Server media and you will be greeted with the usual | ||
140 | 93 | language selection screen: | ||
141 | 61 | 94 | ||
142 | 62 | .. image:: media/install_01.* | 95 | .. image:: media/install_01.* |
143 | 63 | 96 | ||
145 | 64 | On the next screen, you will see there is an entry in the menu called "Multiple server install with MAAS". Use the cursor keys to select this and then press Enter. | 97 | On the next screen, you will see there is an entry in the menu called |
146 | 98 | "Multiple server install with MAAS". Use the cursor keys to select | ||
147 | 99 | this and then press Enter. | ||
148 | 65 | 100 | ||
149 | 66 | .. image:: media/install_02.* | 101 | .. image:: media/install_02.* |
150 | 67 | 102 | ||
153 | 68 | The installer then runs through the usual language and keyboard options. Make your selections using Tab/Cursor keys/Enter to proceed through the install. | 103 | The installer then runs through the usual language and keyboard |
154 | 69 | The installer will then load various drivers, which may take a moment or two. | 104 | options. Make your selections using Tab/Cursor keys/Enter to proceed |
155 | 105 | through the install. The installer will then load various drivers, | ||
156 | 106 | which may take a moment or two. | ||
157 | 70 | 107 | ||
158 | 71 | .. image:: media/install_03.* | 108 | .. image:: media/install_03.* |
159 | 72 | 109 | ||
162 | 73 | The next screen asks for the hostname for this server. Choose something appropriate for your network. | 110 | The next screen asks for the hostname for this server. Choose |
163 | 74 | 111 | something appropriate for your network. | |
164 | 75 | 112 | ||
165 | 76 | .. image:: media/install_04.* | 113 | .. image:: media/install_04.* |
166 | 77 | 114 | ||
168 | 78 | Finally we get to the MAAS part! Here there are just two options. We want to "Create a new MAAS on this server" so go ahead and choose that one. | 115 | Finally we get to the MAAS part! Here there are just two options. We |
169 | 116 | want to "Create a new MAAS on this server" so go ahead and choose that | ||
170 | 117 | one. | ||
171 | 79 | 118 | ||
172 | 80 | .. image:: media/install_05.* | 119 | .. image:: media/install_05.* |
173 | 81 | 120 | ||
175 | 82 | The install now continues as usual. Next you will be prompted to enter a username. This will be the admin user for the actual server that MAAS will be running on (not the same as the MAAS admin user!) | 121 | The install now continues as usual. Next you will be prompted to enter |
176 | 122 | a username. This will be the admin user for the actual server that | ||
177 | 123 | MAAS will be running on (not the same as the MAAS admin user!) | ||
178 | 83 | 124 | ||
179 | 84 | .. image:: media/install_06.* | 125 | .. image:: media/install_06.* |
180 | 85 | 126 | ||
182 | 86 | As usual you will have the chance to encrypt your home directory. Continue to make selections based on whatever settings suit your usage. | 127 | As usual you will have the chance to encrypt your home |
183 | 128 | directory. Continue to make selections based on whatever settings suit | ||
184 | 129 | your usage. | ||
185 | 87 | 130 | ||
186 | 88 | .. image:: media/install_07.* | 131 | .. image:: media/install_07.* |
187 | 89 | 132 | ||
189 | 90 | After making selections and partitioning storage, the system software will start to be installed. This part should only take a few minutes. | 133 | After making selections and partitioning storage, the system software |
190 | 134 | will start to be installed. This part should only take a few minutes. | ||
191 | 91 | 135 | ||
192 | 92 | .. image:: media/install_09.* | 136 | .. image:: media/install_09.* |
193 | 93 | 137 | ||
195 | 94 | Various packages will now be configured, including the package manager and update manager. It is important to set these up appropriately so you will receive timely updates of the MAAS server software, as well as other essential services that may run on this server. | 138 | Various packages will now be configured, including the package manager |
196 | 139 | and update manager. It is important to set these up appropriately so | ||
197 | 140 | you will receive timely updates of the MAAS server software, as well | ||
198 | 141 | as other essential services that may run on this server. | ||
199 | 95 | 142 | ||
200 | 96 | .. image:: media/install_10.* | 143 | .. image:: media/install_10.* |
201 | 97 | 144 | ||
203 | 98 | The configuration for MAAS will ask you to configure the host address of the server. This should be the IP address you will use to connect to the server (you may have additional interfaces e.g. to run node subnets) | 145 | The configuration for MAAS will ask you to configure the host address |
204 | 146 | of the server. This should be the IP address you will use to connect | ||
205 | 147 | to the server (you may have additional interfaces e.g. to run node | ||
206 | 148 | subnets) | ||
207 | 99 | 149 | ||
208 | 100 | .. image:: media/install_cluster-config.* | 150 | .. image:: media/install_cluster-config.* |
209 | 101 | 151 | ||
211 | 102 | The next screen will confirm the web address that will be used to the web interface. | 152 | The next screen will confirm the web address that will be used to the |
212 | 153 | web interface. | ||
213 | 103 | 154 | ||
214 | 104 | .. image:: media/install_controller-config.* | 155 | .. image:: media/install_controller-config.* |
215 | 105 | 156 | ||
217 | 106 | After configuring any other packages the installer will finally come to and end. At this point you should eject the boot media. | 157 | After configuring any other packages the installer will finally come |
218 | 158 | to and end. At this point you should eject the boot media. | ||
219 | 107 | 159 | ||
220 | 108 | .. image:: media/install_14.* | 160 | .. image:: media/install_14.* |
221 | 109 | 161 | ||
224 | 110 | After restarting, you should be able to login to the new server with the information you supplied during the install. The MAAS software will run automatically. | 162 | After restarting, you should be able to login to the new server with |
225 | 111 | 163 | the information you supplied during the install. The MAAS software | |
226 | 164 | will run automatically. | ||
227 | 112 | 165 | ||
228 | 113 | .. image:: media/install_15.* | 166 | .. image:: media/install_15.* |
229 | 114 | 167 | ||
232 | 115 | 168 | **NOTE:** The maas-dhcp and maas-dns packages are not installed by | |
233 | 116 | **NOTE:** The maas-dhcp and maas-dns packages are not installed by default. If you want to have MAAS run DHCP and DNS services, you should install these packages:: | 169 | default. If you want to have MAAS run DHCP and DNS services, you |
234 | 170 | should install these packages:: | ||
235 | 117 | 171 | ||
236 | 118 | $ sudo apt-get install maas-dhcp maas-dns | 172 | $ sudo apt-get install maas-dhcp maas-dns |
237 | 119 | 173 | ||
238 | @@ -121,13 +175,19 @@ | |||
239 | 121 | 175 | ||
240 | 122 | .. _post_install: | 176 | .. _post_install: |
241 | 123 | 177 | ||
242 | 178 | |||
243 | 124 | Post-Install tasks | 179 | Post-Install tasks |
244 | 125 | ================== | 180 | ================== |
246 | 126 | If you now use a web browser to connect to the region controller, you should see that MAAS is running, but there will also be some errors on the screen: | 181 | |
247 | 182 | If you now use a web browser to connect to the region controller, you | ||
248 | 183 | should see that MAAS is running, but there will also be some errors on | ||
249 | 184 | the screen: | ||
250 | 127 | 185 | ||
251 | 128 | .. image:: media/install_web-init.* | 186 | .. image:: media/install_web-init.* |
252 | 129 | 187 | ||
254 | 130 | The on screen messages will tell you that there are no boot images present, and that you can't login because there is no admin user. | 188 | The on screen messages will tell you that there are no boot images |
255 | 189 | present, and that you can't login because there is no admin user. | ||
256 | 190 | |||
257 | 131 | 191 | ||
258 | 132 | Create a superuser account | 192 | Create a superuser account |
259 | 133 | -------------------------- | 193 | -------------------------- |
260 | @@ -137,29 +197,37 @@ | |||
261 | 137 | 197 | ||
262 | 138 | $ sudo maas createsuperuser | 198 | $ sudo maas createsuperuser |
263 | 139 | 199 | ||
265 | 140 | Follow the prompts to create the account which you will need to login to the web interface. Unless you have a special need, it is best to accept the default login name of `root`, as it is rather annoying if you forget the username (although you can simply run this command again to create a new superuser). | 200 | Follow the prompts to create the account which you will need to login |
266 | 201 | to the web interface. Unless you have a special need, it is best to | ||
267 | 202 | accept the default login name of `root`, as it is rather annoying if | ||
268 | 203 | you forget the username (although you can simply run this command | ||
269 | 204 | again to create a new superuser). | ||
270 | 141 | 205 | ||
271 | 142 | 206 | ||
272 | 143 | Import the boot images | 207 | Import the boot images |
273 | 144 | ---------------------- | 208 | ---------------------- |
274 | 145 | 209 | ||
275 | 146 | MAAS will check for and download new Ubuntu images once a week. | 210 | MAAS will check for and download new Ubuntu images once a week. |
280 | 147 | However, you'll need to download them manually the first time. To do this you will need to | 211 | However, you'll need to download them manually the first time. To do |
281 | 148 | connect to the MAAS API using the maas-cli tool. (see :ref:`api_key` for details of logging | 212 | this you will need to connect to the MAAS API using the maas-cli |
282 | 149 | in). | 213 | tool. (see :ref:`Logging in <api-key>` for details). Then you need to |
283 | 150 | Then you need to run the command:: | 214 | run the command:: |
284 | 151 | 215 | ||
285 | 152 | $ maas-cli maas node-groups import-boot-images | 216 | $ maas-cli maas node-groups import-boot-images |
286 | 153 | 217 | ||
290 | 154 | (substitute in a different profile name for 'maas' if you have called yours something else) | 218 | (substitute in a different profile name for 'maas' if you have called |
291 | 155 | This will initiate downloading the required image files. Note that this may take some time | 219 | yours something else) This will initiate downloading the required |
292 | 156 | depending on your network connection. | 220 | image files. Note that this may take some time depending on your |
293 | 221 | network connection. | ||
294 | 157 | 222 | ||
295 | 158 | 223 | ||
296 | 159 | Login to the server | 224 | Login to the server |
297 | 160 | ------------------- | 225 | ------------------- |
298 | 161 | 226 | ||
300 | 162 | To check that everything is working properly, you should try and login to the server now. Both the error messages should have gone (it can take a few minutes for the boot image files to register) and you can see that there are currently 0 nodes attached to this controller. | 227 | To check that everything is working properly, you should try and login |
301 | 228 | to the server now. Both the error messages should have gone (it can | ||
302 | 229 | take a few minutes for the boot image files to register) and you can | ||
303 | 230 | see that there are currently 0 nodes attached to this controller. | ||
304 | 163 | 231 | ||
305 | 164 | .. image:: media/install-login.* | 232 | .. image:: media/install-login.* |
306 | 165 | 233 | ||
307 | @@ -167,7 +235,9 @@ | |||
308 | 167 | Configure DHCP | 235 | Configure DHCP |
309 | 168 | -------------- | 236 | -------------- |
310 | 169 | 237 | ||
313 | 170 | If you are using MAAS to control DHCP, you need to set this via the web interface. | 238 | If you are using MAAS to control DHCP, you need to set this via the |
314 | 171 | However, if you are manually configuring a DHCP server, you should take a look at :ref:`manual-dhcp` | 239 | web interface. However, if you are manually configuring a DHCP |
315 | 240 | server, you should take a look at :ref:`manual-dhcp` | ||
316 | 172 | 241 | ||
318 | 173 | Once everything is set up and running, you are ready to :doc:`start enlisting nodes <nodes>` | 242 | Once everything is set up and running, you are ready to :doc:`start |
319 | 243 | enlisting nodes <nodes>` | ||
320 | 174 | 244 | ||
321 | === modified file 'Makefile' | |||
322 | --- Makefile 2012-11-21 10:26:41 +0000 | |||
323 | +++ Makefile 2012-11-21 11:51:34 +0000 | |||
324 | @@ -153,13 +153,13 @@ | |||
325 | 153 | $(MAKE) -C acceptance $@ | 153 | $(MAKE) -C acceptance $@ |
326 | 154 | find . -type f -name '*.py[co]' -print0 | xargs -r0 $(RM) | 154 | find . -type f -name '*.py[co]' -print0 | xargs -r0 $(RM) |
327 | 155 | find . -type f -name '*~' -print0 | xargs -r0 $(RM) | 155 | find . -type f -name '*~' -print0 | xargs -r0 $(RM) |
328 | 156 | find . -type f -name dropin.cache -print0 | xargs -r0 $(RM) | ||
329 | 156 | $(RM) -r media/demo/* media/development | 157 | $(RM) -r media/demo/* media/development |
330 | 157 | $(RM) $(js_enums) | 158 | $(RM) $(js_enums) |
331 | 158 | $(RM) *.log | 159 | $(RM) *.log |
332 | 159 | $(RM) celerybeat-schedule | ||
333 | 160 | $(RM) docs/api.rst | 160 | $(RM) docs/api.rst |
336 | 161 | $(RM) -r docs/_autosummary | 161 | $(RM) -r docs/_autosummary docs/_build |
337 | 162 | $(RM) -r man/ | 162 | $(RM) -r man |
338 | 163 | 163 | ||
339 | 164 | distclean: clean stop | 164 | distclean: clean stop |
340 | 165 | $(RM) -r bin include lib local | 165 | $(RM) -r bin include lib local |
341 | @@ -167,9 +167,7 @@ | |||
342 | 167 | $(RM) -r build dist logs/* parts | 167 | $(RM) -r build dist logs/* parts |
343 | 168 | $(RM) tags TAGS .installed.cfg | 168 | $(RM) tags TAGS .installed.cfg |
344 | 169 | $(RM) -r *.egg *.egg-info src/*.egg-info | 169 | $(RM) -r *.egg *.egg-info src/*.egg-info |
345 | 170 | $(RM) -r docs/_build | ||
346 | 171 | $(RM) -r run/* services/*/supervise | 170 | $(RM) -r run/* services/*/supervise |
347 | 172 | $(RM) twisted/plugins/dropin.cache | ||
348 | 173 | 171 | ||
349 | 174 | harness: bin/maas bin/database | 172 | harness: bin/maas bin/database |
350 | 175 | $(dbrun) bin/maas shell --settings=maas.demo | 173 | $(dbrun) bin/maas shell --settings=maas.demo |
351 | 176 | 174 | ||
352 | === modified file 'docs/about.rst' | |||
353 | --- docs/about.rst 2012-10-03 20:16:24 +0000 | |||
354 | +++ docs/about.rst 2012-11-21 11:51:34 +0000 | |||
355 | @@ -1,19 +1,35 @@ | |||
356 | 1 | About this documentation | 1 | About this documentation |
357 | 2 | ======================== | 2 | ======================== |
358 | 3 | 3 | ||
361 | 4 | This is the documentation for Canonical's MAAS software. If you aren't sure what that is, you should probably skip everything else and head straight to the :ref:`orientation` section where it is explained. | 4 | This is the documentation for Canonical's MAAS software. If you aren't |
362 | 5 | Like any software though, it can be frustrating if you don't know how bits of it work, how to achieve certain goals or what to do when things go wrong. Amongst its various sections, this manual aims to answer all those questions and plenty more you haven't even thought of yet. | 5 | sure what that is, you should probably skip everything else and head |
363 | 6 | straight to the :ref:`orientation` section where it is explained. | ||
364 | 7 | Like any software though, it can be frustrating if you don't know how | ||
365 | 8 | bits of it work, how to achieve certain goals or what to do when | ||
366 | 9 | things go wrong. Amongst its various sections, this manual aims to | ||
367 | 10 | answer all those questions and plenty more you haven't even thought of | ||
368 | 11 | yet. | ||
369 | 12 | |||
370 | 6 | 13 | ||
371 | 7 | Getting it | 14 | Getting it |
372 | 8 | ---------- | 15 | ---------- |
373 | 9 | 16 | ||
376 | 10 | In a cunning move, the current documentation always lives, and is built from, the main MAAS source code. That means that whatever MAAS package you have installed, or even if you are really living life on the edge and have checked out a development version from Launchpad, this documentation should be the latest and most appropriate version for the software you are running. | 17 | In a cunning move, the current documentation always lives, and is |
377 | 11 | However, it is also possible that there have been further sections or more helpful, or clearer bits added since the package you are using was made. For this reason you can always find the latest documentation online here: http://maas.ubuntu.com | 18 | built from, the main MAAS source code. That means that whatever MAAS |
378 | 19 | package you have installed, or even if you are really living life on | ||
379 | 20 | the edge and have checked out a development version from Launchpad, | ||
380 | 21 | this documentation should be the latest and most appropriate version | ||
381 | 22 | for the software you are running. However, it is also possible that | ||
382 | 23 | there have been further sections or more helpful, or clearer bits | ||
383 | 24 | added since the package you are using was made. For this reason you | ||
384 | 25 | can always find the latest documentation online here: | ||
385 | 26 | http://maas.ubuntu.com | ||
386 | 27 | |||
387 | 12 | 28 | ||
388 | 13 | Contributing | 29 | Contributing |
389 | 14 | ------------ | 30 | ------------ |
390 | 15 | 31 | ||
395 | 16 | If you have some extra information to add, or think you have spotted an error or something out of date, we really want to hear about it. File a bug report or contact us via the MAAS homepage at http://maas.ubuntu.com | 32 | If you have some extra information to add, or think you have spotted |
396 | 17 | 33 | an error or something out of date, we really want to hear about | |
397 | 18 | 34 | it. File a bug report or contact us via the MAAS homepage at | |
398 | 19 | 35 | http://maas.ubuntu.com | |
399 | 20 | 36 | ||
400 | === modified file 'docs/configure.rst' | |||
401 | --- docs/configure.rst 2012-10-03 20:16:24 +0000 | |||
402 | +++ docs/configure.rst 2012-11-21 11:51:34 +0000 | |||
403 | @@ -1,14 +1,19 @@ | |||
404 | 1 | Additional Configuration | 1 | Additional Configuration |
405 | 2 | ======================== | 2 | ======================== |
406 | 3 | 3 | ||
407 | 4 | |||
408 | 4 | .. _manual-dhcp: | 5 | .. _manual-dhcp: |
409 | 5 | 6 | ||
410 | 6 | Manual DHCP configuration | 7 | Manual DHCP configuration |
411 | 7 | ------------------------- | 8 | ------------------------- |
412 | 8 | 9 | ||
414 | 9 | There are some circumstances under which you may not wish the master MAAS worker to handle DHCP for the network. In these instances, the existing DHCP server for the network will need its configuration altered to allow MAAS to enlist and control nodes automatically. | 10 | There are some circumstances under which you may not wish the master |
415 | 11 | MAAS worker to handle DHCP for the network. In these instances, the | ||
416 | 12 | existing DHCP server for the network will need its configuration | ||
417 | 13 | altered to allow MAAS to enlist and control nodes automatically. | ||
418 | 10 | 14 | ||
420 | 11 | At the very least the next-server should point to the MAAS controller host address and the filename should be set to pxelinux.0 | 15 | At the very least the next-server should point to the MAAS controller |
421 | 16 | host address and the filename should be set to pxelinux.0 | ||
422 | 12 | 17 | ||
423 | 13 | The configuration entry may look something like this:: | 18 | The configuration entry may look something like this:: |
424 | 14 | 19 | ||
425 | @@ -21,7 +26,9 @@ | |||
426 | 21 | range dynamic-bootp 192.168.122.5 192.168.122.135; | 26 | range dynamic-bootp 192.168.122.5 192.168.122.135; |
427 | 22 | } | 27 | } |
428 | 23 | 28 | ||
429 | 29 | |||
430 | 24 | .. _ssl: | 30 | .. _ssl: |
431 | 31 | |||
432 | 25 | SSL Support | 32 | SSL Support |
433 | 26 | ----------- | 33 | ----------- |
434 | 27 | 34 | ||
435 | @@ -43,4 +50,3 @@ | |||
436 | 43 | the default SSL certificate is insecure. Please generate your own and then | 50 | the default SSL certificate is insecure. Please generate your own and then |
437 | 44 | edit ``/etc/apache2/conf.d/maas-http.conf`` to set the location of the | 51 | edit ``/etc/apache2/conf.d/maas-http.conf`` to set the location of the |
438 | 45 | certificate. | 52 | certificate. |
439 | 46 | |||
440 | 47 | 53 | ||
441 | === modified file 'docs/index.rst' | |||
442 | --- docs/index.rst 2012-10-16 14:54:36 +0000 | |||
443 | +++ docs/index.rst 2012-11-21 11:51:34 +0000 | |||
444 | @@ -4,12 +4,12 @@ | |||
445 | 4 | Metal As A Service: MAAS | 4 | Metal As A Service: MAAS |
446 | 5 | ######################## | 5 | ######################## |
447 | 6 | 6 | ||
448 | 7 | |||
449 | 8 | This is the documentation for the MAAS project http://maas.ubuntu.com | 7 | This is the documentation for the MAAS project http://maas.ubuntu.com |
450 | 9 | 8 | ||
451 | 9 | |||
452 | 10 | ************ | 10 | ************ |
453 | 11 | Introduction | 11 | Introduction |
455 | 12 | ************ | 12 | ************ |
456 | 13 | 13 | ||
457 | 14 | .. toctree:: | 14 | .. toctree:: |
458 | 15 | :maxdepth: 2 | 15 | :maxdepth: 2 |
459 | @@ -17,6 +17,7 @@ | |||
460 | 17 | about | 17 | about |
461 | 18 | orientation | 18 | orientation |
462 | 19 | 19 | ||
463 | 20 | |||
464 | 20 | *************** | 21 | *************** |
465 | 21 | Getting started | 22 | Getting started |
466 | 22 | *************** | 23 | *************** |
467 | @@ -27,7 +28,7 @@ | |||
468 | 27 | install | 28 | install |
469 | 28 | configure | 29 | configure |
470 | 29 | nodes | 30 | nodes |
472 | 30 | 31 | ||
473 | 31 | 32 | ||
474 | 32 | ****************** | 33 | ****************** |
475 | 33 | Deploying services | 34 | Deploying services |
476 | @@ -38,7 +39,8 @@ | |||
477 | 38 | 39 | ||
478 | 39 | juju-quick-start | 40 | juju-quick-start |
479 | 40 | tags | 41 | tags |
481 | 41 | 42 | ||
482 | 43 | |||
483 | 42 | ****************************** | 44 | ****************************** |
484 | 43 | Using the maas-cli commandline | 45 | Using the maas-cli commandline |
485 | 44 | ****************************** | 46 | ****************************** |
486 | @@ -48,6 +50,7 @@ | |||
487 | 48 | 50 | ||
488 | 49 | maascli | 51 | maascli |
489 | 50 | 52 | ||
490 | 53 | |||
491 | 51 | ********** | 54 | ********** |
492 | 52 | Appendices | 55 | Appendices |
493 | 53 | ********** | 56 | ********** |
494 | @@ -56,11 +59,12 @@ | |||
495 | 56 | :maxdepth: 2 | 59 | :maxdepth: 2 |
496 | 57 | 60 | ||
497 | 58 | troubleshooting | 61 | troubleshooting |
499 | 59 | hacking | 62 | hacking |
500 | 60 | api | 63 | api |
501 | 61 | models | 64 | models |
502 | 62 | enum | 65 | enum |
503 | 63 | 66 | ||
504 | 67 | |||
505 | 64 | Indices and tables | 68 | Indices and tables |
506 | 65 | ================== | 69 | ================== |
507 | 66 | 70 | ||
508 | 67 | 71 | ||
509 | === modified file 'docs/juju-quick-start.rst' | |||
510 | --- docs/juju-quick-start.rst 2012-08-16 11:56:16 +0000 | |||
511 | +++ docs/juju-quick-start.rst 2012-11-21 11:51:34 +0000 | |||
512 | @@ -156,5 +156,3 @@ | |||
513 | 156 | Note that each charm runs on its own host, so each deployment will | 156 | Note that each charm runs on its own host, so each deployment will |
514 | 157 | actually take as long as it took to bootstrap. Have a beer, drown your | 157 | actually take as long as it took to bootstrap. Have a beer, drown your |
515 | 158 | sorrows in liquor, or, my preference, have another cup of tea. | 158 | sorrows in liquor, or, my preference, have another cup of tea. |
516 | 159 | |||
517 | 160 | ---- | ||
518 | 161 | 159 | ||
519 | === modified file 'docs/maascli.rst' | |||
520 | --- docs/maascli.rst 2012-11-13 11:30:52 +0000 | |||
521 | +++ docs/maascli.rst 2012-11-21 11:51:34 +0000 | |||
522 | @@ -1,9 +1,9 @@ | |||
523 | 1 | |||
524 | 2 | As well as the web interface, many tasks can be performed by accessing | 1 | As well as the web interface, many tasks can be performed by accessing |
525 | 3 | the MAAS API directly through the maas-cli command. This section | 2 | the MAAS API directly through the maas-cli command. This section |
526 | 4 | details how to login with this tool and perform some common | 3 | details how to login with this tool and perform some common |
527 | 5 | operations. | 4 | operations. |
528 | 6 | 5 | ||
529 | 6 | |||
530 | 7 | .. _api-key: | 7 | .. _api-key: |
531 | 8 | 8 | ||
532 | 9 | Logging in | 9 | Logging in |
533 | @@ -19,8 +19,9 @@ | |||
534 | 19 | .. only:: html | 19 | .. only:: html |
535 | 20 | .. image:: media/maascli-prefs.* | 20 | .. image:: media/maascli-prefs.* |
536 | 21 | 21 | ||
538 | 22 | A new page will load... | 22 | A new page will load... |
539 | 23 | 23 | ||
540 | 24 | .. only:: html | ||
541 | 24 | .. image:: media/maascli-key.* | 25 | .. image:: media/maascli-key.* |
542 | 25 | 26 | ||
543 | 26 | The very first item is a list of MAAS keys. One will have already been | 27 | The very first item is a list of MAAS keys. One will have already been |
544 | @@ -30,21 +31,21 @@ | |||
545 | 30 | 31 | ||
546 | 31 | $ maas-cli login <profile-name> <hostname> <key> | 32 | $ maas-cli login <profile-name> <hostname> <key> |
547 | 32 | 33 | ||
550 | 33 | The profile created is an easy way of associating your credentials with any | 34 | The profile created is an easy way of associating your credentials |
551 | 34 | subsequent call to the API. So an example login might look like this:: | 35 | with any subsequent call to the API. So an example login might look |
552 | 36 | like this:: | ||
553 | 35 | 37 | ||
554 | 36 | $ maas-cli login maas http://10.98.0.13/MAAS/api/1.0 AWSCRMzqMNy:jjk...5e1FenoP82Qm5te2 | 38 | $ maas-cli login maas http://10.98.0.13/MAAS/api/1.0 AWSCRMzqMNy:jjk...5e1FenoP82Qm5te2 |
555 | 37 | 39 | ||
566 | 38 | which creates the profile 'maas' and registers it with the given key at the | 40 | which creates the profile 'maas' and registers it with the given key |
567 | 39 | specified API endpoint. | 41 | at the specified API endpoint. If you omit the credentials, they will |
568 | 40 | If you omit the credentials, they will be prompted for in the console. It is | 42 | be prompted for in the console. It is also possible to use a hyphen, |
569 | 41 | also possible to use a hyphen, '-' in place of the credentials. In this case a | 43 | '-' in place of the credentials. In this case a single line will be |
570 | 42 | single line will be read from stdin, stripped of any whitespace and used as the | 44 | read from stdin, stripped of any whitespace and used as the |
571 | 43 | credentials, which can be useful if you are devolping scripts for specific | 45 | credentials, which can be useful if you are devolping scripts for |
572 | 44 | tasks. | 46 | specific tasks. If an empty string is passed instead of the |
573 | 45 | If an empty string is passed instead of the credentials, the profile will be | 47 | credentials, the profile will be logged in anonymously (and |
574 | 46 | logged in anonymously (and consequently some of the API calls will not be | 48 | consequently some of the API calls will not be available) |
565 | 47 | available) | ||
575 | 48 | 49 | ||
576 | 49 | 50 | ||
577 | 50 | maas-cli commands | 51 | maas-cli commands |
578 | @@ -76,7 +77,7 @@ | |||
579 | 76 | Logs in to the MAAS controller API at the given URL, using the key | 77 | Logs in to the MAAS controller API at the given URL, using the key |
580 | 77 | provided and associates this connection with the given profile name. | 78 | provided and associates this connection with the given profile name. |
581 | 78 | 79 | ||
583 | 79 | :samp:`logout <profile>` | 80 | :samp:`logout <profile>` |
584 | 80 | 81 | ||
585 | 81 | Logs out from the given profile, flushing the stored credentials. | 82 | Logs out from the given profile, flushing the stored credentials. |
586 | 82 | 83 | ||
587 | @@ -107,12 +108,12 @@ | |||
588 | 107 | :samp:`-d, --debug` | 108 | :samp:`-d, --debug` |
589 | 108 | 109 | ||
590 | 109 | Displays debug information listing the API responses. | 110 | Displays debug information listing the API responses. |
592 | 110 | 111 | ||
593 | 111 | :samp:`-h, --help` | 112 | :samp:`-h, --help` |
594 | 112 | 113 | ||
595 | 113 | Display usage information. | 114 | Display usage information. |
596 | 114 | 115 | ||
598 | 115 | :samp:`-k, --insecure` | 116 | :samp:`-k, --insecure` |
599 | 116 | 117 | ||
600 | 117 | Disables the SSL certificate check. | 118 | Disables the SSL certificate check. |
601 | 118 | 119 | ||
602 | @@ -126,8 +127,6 @@ | |||
603 | 126 | Removes the given key from the list of authorisation tokens. | 127 | Removes the given key from the list of authorisation tokens. |
604 | 127 | 128 | ||
605 | 128 | 129 | ||
606 | 129 | |||
607 | 130 | |||
608 | 131 | .. boot-images - not useful in user context | 130 | .. boot-images - not useful in user context |
609 | 132 | .. ^^^^^^^^^^^ | 131 | .. ^^^^^^^^^^^ |
610 | 133 | 132 | ||
611 | @@ -158,51 +157,50 @@ | |||
612 | 158 | Releases the node given by *<system_id>* | 157 | Releases the node given by *<system_id>* |
613 | 159 | 158 | ||
614 | 160 | :samp:`start <system_id>` | 159 | :samp:`start <system_id>` |
616 | 161 | 160 | ||
617 | 162 | Powers up the node identified by *<system_id>* (where MAAS has | 161 | Powers up the node identified by *<system_id>* (where MAAS has |
618 | 163 | information for power management for this node). | 162 | information for power management for this node). |
619 | 164 | 163 | ||
620 | 165 | :samp:`stop <system_id>` | 164 | :samp:`stop <system_id>` |
622 | 166 | 165 | ||
623 | 167 | Powers off the node identified by *<system_id>* (where MAAS has | 166 | Powers off the node identified by *<system_id>* (where MAAS has |
624 | 168 | information for power management for this node). | 167 | information for power management for this node). |
625 | 169 | 168 | ||
626 | 170 | :samp:`delete <system_id>` | 169 | :samp:`delete <system_id>` |
628 | 171 | 170 | ||
629 | 172 | Removes the given node from the MAAS database. | 171 | Removes the given node from the MAAS database. |
630 | 173 | 172 | ||
631 | 174 | :samp:`read <system_id>` | 173 | :samp:`read <system_id>` |
633 | 175 | 174 | ||
634 | 176 | Returns all the current known information about the node specified | 175 | Returns all the current known information about the node specified |
635 | 177 | by *<system_id>* | 176 | by *<system_id>* |
636 | 178 | 177 | ||
637 | 179 | :samp:`update <system_id> [parameters...]` | 178 | :samp:`update <system_id> [parameters...]` |
639 | 180 | 179 | ||
640 | 181 | Used to change or set specific values for the node. The valid | 180 | Used to change or set specific values for the node. The valid |
641 | 182 | parameters are listed below:: | 181 | parameters are listed below:: |
642 | 183 | 182 | ||
643 | 184 | hostname=<value> | 183 | hostname=<value> |
644 | 185 | The new hostname for this node. | 184 | The new hostname for this node. |
645 | 186 | 185 | ||
647 | 187 | architecture=<value> | 186 | architecture=<value> |
648 | 188 | Sets the architecture type, where <value> | 187 | Sets the architecture type, where <value> |
649 | 189 | is a string containing a valid architecture type, | 188 | is a string containing a valid architecture type, |
650 | 190 | e.g. "i386/generic" | 189 | e.g. "i386/generic" |
651 | 191 | 190 | ||
654 | 192 | power_type=<value> | 191 | power_type=<value> |
655 | 193 | Apply the given dotted decimal value as the broadcast IP address | 192 | Apply the given dotted decimal value as the broadcast IP address |
656 | 194 | for this subnet. | 193 | for this subnet. |
657 | 195 | 194 | ||
660 | 196 | power_parameters_{param1}... =<value> | 195 | power_parameters_{param1}... =<value> |
661 | 197 | Set the given power parameters. Note that the valid options for these | 196 | Set the given power parameters. Note that the valid options for these |
662 | 198 | depend on the power type chosen. | 197 | depend on the power type chosen. |
663 | 199 | 198 | ||
666 | 200 | power_parameters_skip_check 'true' | 'false' | 199 | power_parameters_skip_check 'true' | 'false' |
667 | 201 | Whether to sanity check the supplied parameters against this node's | 200 | Whether to sanity check the supplied parameters against this node's |
668 | 202 | declared power type. The default is 'false'. | 201 | declared power type. The default is 'false'. |
669 | 203 | 202 | ||
670 | 204 | 203 | ||
671 | 205 | |||
672 | 206 | .. _cli-power: | 204 | .. _cli-power: |
673 | 207 | 205 | ||
674 | 208 | Example: Setting the power parameters for an ipmi enabled node:: | 206 | Example: Setting the power parameters for an ipmi enabled node:: |
675 | @@ -214,8 +212,6 @@ | |||
676 | 214 | power_parameters_power_pass=ubuntu; | 212 | power_parameters_power_pass=ubuntu; |
677 | 215 | 213 | ||
678 | 216 | 214 | ||
679 | 217 | |||
680 | 218 | |||
681 | 219 | nodes | 215 | nodes |
682 | 220 | ^^^^^ | 216 | ^^^^^ |
683 | 221 | 217 | ||
684 | @@ -295,7 +291,6 @@ | |||
685 | 295 | $ maas-cli maas nodes list architecture="i386/generic" | 291 | $ maas-cli maas nodes list architecture="i386/generic" |
686 | 296 | 292 | ||
687 | 297 | 293 | ||
688 | 298 | |||
689 | 299 | node-groups | 294 | node-groups |
690 | 300 | ^^^^^^^^^^^ | 295 | ^^^^^^^^^^^ |
691 | 301 | Usage: maas-cli <profile> node-groups [-d --debug] [-h --help] [-k | 296 | Usage: maas-cli <profile> node-groups [-d --debug] [-h --help] [-k |
692 | @@ -306,7 +301,7 @@ | |||
693 | 306 | :samp:`-d, --debug` | 301 | :samp:`-d, --debug` |
694 | 307 | 302 | ||
695 | 308 | Displays debug information listing the API responses. | 303 | Displays debug information listing the API responses. |
697 | 309 | 304 | ||
698 | 310 | :samp:`-h, --help` | 305 | :samp:`-h, --help` |
699 | 311 | 306 | ||
700 | 312 | Display usage information. | 307 | Display usage information. |
701 | @@ -316,7 +311,7 @@ | |||
702 | 316 | Disables the SSL certificate check. | 311 | Disables the SSL certificate check. |
703 | 317 | 312 | ||
704 | 318 | :samp:`register uuid=<value> name=<value> interfaces=<json_string>` | 313 | :samp:`register uuid=<value> name=<value> interfaces=<json_string>` |
706 | 319 | 314 | ||
707 | 320 | Registers a new node group with the given name and uuid. The | 315 | Registers a new node group with the given name and uuid. The |
708 | 321 | interfaces parameter must be supplied in the form of a JSON string | 316 | interfaces parameter must be supplied in the form of a JSON string |
709 | 322 | comprising the key/value data for the interface to be used, for | 317 | comprising the key/value data for the interface to be used, for |
710 | @@ -327,7 +322,7 @@ | |||
711 | 327 | 322 | ||
712 | 328 | :samp:`list` | 323 | :samp:`list` |
713 | 329 | 324 | ||
715 | 330 | Returns a JSON list of all currently defined node groups. | 325 | Returns a JSON list of all currently defined node groups. |
716 | 331 | 326 | ||
717 | 332 | :samp:`refresh_workers` | 327 | :samp:`refresh_workers` |
718 | 333 | 328 | ||
719 | @@ -338,7 +333,7 @@ | |||
720 | 338 | nodes. | 333 | nodes. |
721 | 339 | 334 | ||
722 | 340 | :samp:`accept <uuid>` | 335 | :samp:`accept <uuid>` |
724 | 341 | 336 | ||
725 | 342 | Accepts a node-group or number of nodegroups indicated by the | 337 | Accepts a node-group or number of nodegroups indicated by the |
726 | 343 | supplied UUID | 338 | supplied UUID |
727 | 344 | 339 | ||
728 | @@ -348,10 +343,9 @@ | |||
729 | 348 | supplied UUID | 343 | supplied UUID |
730 | 349 | 344 | ||
731 | 350 | 345 | ||
732 | 351 | |||
733 | 352 | node-group-interface | 346 | node-group-interface |
734 | 353 | ^^^^^^^^^^^^^^^^^^^^ | 347 | ^^^^^^^^^^^^^^^^^^^^ |
736 | 354 | For managing the interfaces. See also :ref:`node_group_interfaces` | 348 | For managing the interfaces. See also :ref:`node-group-interfaces` |
737 | 355 | 349 | ||
738 | 356 | Usage: maas-cli *<profile>* node-group-interfaces [-d --debug] [-h | 350 | Usage: maas-cli *<profile>* node-group-interfaces [-d --debug] [-h |
739 | 357 | --help] [-k --insecure] read | update | delete [parameters...] | 351 | --help] [-k --insecure] read | update | delete [parameters...] |
740 | @@ -359,50 +353,50 @@ | |||
741 | 359 | ..program:: maas-cli node-group-interface | 353 | ..program:: maas-cli node-group-interface |
742 | 360 | 354 | ||
743 | 361 | :samp:`read <uuid> <interface>` | 355 | :samp:`read <uuid> <interface>` |
745 | 362 | 356 | ||
746 | 363 | Returns the current settings for the given UUID and interface | 357 | Returns the current settings for the given UUID and interface |
747 | 364 | 358 | ||
748 | 365 | :samp:`update [parameters]` | 359 | :samp:`update [parameters]` |
750 | 366 | 360 | ||
751 | 367 | Changes the settings for the interface according to the given | 361 | Changes the settings for the interface according to the given |
752 | 368 | parameters:: | 362 | parameters:: |
753 | 369 | 363 | ||
754 | 370 | management= 0 | 1 | 2 | 364 | management= 0 | 1 | 2 |
756 | 371 | The service to be managed on the interface ( 0= none, 1=DHCP, 2=DHCP | 365 | The service to be managed on the interface ( 0= none, 1=DHCP, 2=DHCP |
757 | 372 | and DNS). | 366 | and DNS). |
758 | 373 | 367 | ||
759 | 374 | subnet_mask=<value> | 368 | subnet_mask=<value> |
760 | 375 | Apply the given dotted decimal value as the subnet mask. | 369 | Apply the given dotted decimal value as the subnet mask. |
761 | 376 | 370 | ||
762 | 377 | broadcast_ip=<value> | 371 | broadcast_ip=<value> |
764 | 378 | Apply the given dotted decimal value as the broadcast IP address for | 372 | Apply the given dotted decimal value as the broadcast IP address for |
765 | 379 | this subnet. | 373 | this subnet. |
766 | 380 | 374 | ||
767 | 381 | router_ip=<value> | 375 | router_ip=<value> |
769 | 382 | Apply the given dotted decimal value as the default router address | 376 | Apply the given dotted decimal value as the default router address |
770 | 383 | for this subnet. | 377 | for this subnet. |
771 | 384 | 378 | ||
772 | 385 | ip_range_low=<value> | 379 | ip_range_low=<value> |
773 | 386 | The lowest value of IP address to allocate via DHCP | 380 | The lowest value of IP address to allocate via DHCP |
774 | 387 | 381 | ||
775 | 388 | ip_range_high=<value> | 382 | ip_range_high=<value> |
777 | 389 | The highest value of IP address to allocate via DHCP | 383 | The highest value of IP address to allocate via DHCP |
778 | 390 | 384 | ||
779 | 391 | :samp:`delete <uuid> <interface>` | 385 | :samp:`delete <uuid> <interface>` |
780 | 392 | 386 | ||
781 | 393 | Removes the entry for the given UUID and interface. | 387 | Removes the entry for the given UUID and interface. |
783 | 394 | 388 | ||
784 | 395 | .. _cli-dhcp: | 389 | .. _cli-dhcp: |
785 | 396 | 390 | ||
786 | 397 | Example: | 391 | Example: |
787 | 398 | Configuring DHCP and DNS. | 392 | Configuring DHCP and DNS. |
788 | 399 | 393 | ||
790 | 400 | To enable MAAS to manage DHCP and DNS, it needs to be supplied with the relevant | 394 | To enable MAAS to manage DHCP and DNS, it needs to be supplied with the relevant |
791 | 401 | interface information. To do this we need to first determine the UUID of the | 395 | interface information. To do this we need to first determine the UUID of the |
792 | 402 | node group affected:: | 396 | node group affected:: |
793 | 403 | 397 | ||
794 | 404 | $ uuid=$(maas-cli <profile> node-groups list | grep uuid | cut -d\" -f4) | 398 | $ uuid=$(maas-cli <profile> node-groups list | grep uuid | cut -d\" -f4) |
796 | 405 | 399 | ||
797 | 406 | Once we have the UUID we can use this to update the node-group-interface for | 400 | Once we have the UUID we can use this to update the node-group-interface for |
798 | 407 | that nodegroup, and pass it the relevant interface details:: | 401 | that nodegroup, and pass it the relevant interface details:: |
799 | 408 | 402 | ||
800 | @@ -413,12 +407,13 @@ | |||
801 | 413 | broadcast_ip=192.168.123.255 \ | 407 | broadcast_ip=192.168.123.255 \ |
802 | 414 | router_ip=192.168.123.1 \ | 408 | router_ip=192.168.123.1 \ |
803 | 415 | 409 | ||
810 | 416 | Replacing the example values with those required for this network. The only | 410 | Replacing the example values with those required for this network. The |
811 | 417 | non-obvious parameter is 'management' which takes the values 0 (no management), 1 | 411 | only non-obvious parameter is 'management' which takes the values 0 |
812 | 418 | (manage DHCP) and 2 (manage DHCP and DNS). | 412 | (no management), 1 (manage DHCP) and 2 (manage DHCP and DNS). |
813 | 419 | 413 | ||
814 | 420 | 414 | ||
815 | 421 | .. _node-group-interfaces | 415 | .. _node-group-interfaces: |
816 | 416 | |||
817 | 422 | node-group-interfaces | 417 | node-group-interfaces |
818 | 423 | ^^^^^^^^^^^^^^^^^^^^^ | 418 | ^^^^^^^^^^^^^^^^^^^^^ |
819 | 424 | 419 | ||
820 | @@ -433,7 +428,7 @@ | |||
821 | 433 | :samp:`-d, --debug` | 428 | :samp:`-d, --debug` |
822 | 434 | 429 | ||
823 | 435 | Displays debug information listing the API responses. | 430 | Displays debug information listing the API responses. |
825 | 436 | 431 | ||
826 | 437 | :samp:`-h, --help` | 432 | :samp:`-h, --help` |
827 | 438 | 433 | ||
828 | 439 | Display usage information. | 434 | Display usage information. |
829 | @@ -447,25 +442,24 @@ | |||
830 | 447 | Lists the current stored configurations for the given identifier | 442 | Lists the current stored configurations for the given identifier |
831 | 448 | <label> in a key:value format which should be easy to decipher. | 443 | <label> in a key:value format which should be easy to decipher. |
832 | 449 | 444 | ||
833 | 450 | |||
834 | 451 | :samp:`new <label> ip=<value> interface=<if_device> [parameters...]` | 445 | :samp:`new <label> ip=<value> interface=<if_device> [parameters...]` |
836 | 452 | 446 | ||
837 | 453 | Creates a new interface group. The required parameters are the IP | 447 | Creates a new interface group. The required parameters are the IP |
838 | 454 | address and the network interface this appies to (e.g. eth0). In | 448 | address and the network interface this appies to (e.g. eth0). In |
839 | 455 | order to do anything useful, further parameters are required:: | 449 | order to do anything useful, further parameters are required:: |
840 | 456 | 450 | ||
842 | 457 | management= 0 | 1 | 2 | 451 | management= 0 | 1 | 2 |
843 | 458 | The service to be managed on the interface | 452 | The service to be managed on the interface |
844 | 459 | ( 0= none, 1=DHCP, 2=DHCP and DNS). | 453 | ( 0= none, 1=DHCP, 2=DHCP and DNS). |
845 | 460 | 454 | ||
846 | 461 | subnet_mask=<value> | 455 | subnet_mask=<value> |
847 | 462 | Apply the given dotted decimal value as the subnet mask. | 456 | Apply the given dotted decimal value as the subnet mask. |
848 | 463 | 457 | ||
850 | 464 | broadcast_ip=<value> | 458 | broadcast_ip=<value> |
851 | 465 | Apply the given dotted decimal value as the | 459 | Apply the given dotted decimal value as the |
852 | 466 | broadcast IP address for this subnet. | 460 | broadcast IP address for this subnet. |
853 | 467 | 461 | ||
855 | 468 | router_ip=<value> | 462 | router_ip=<value> |
856 | 469 | Apply the given dotted decimal value as the | 463 | Apply the given dotted decimal value as the |
857 | 470 | default router address for this subnet. | 464 | default router address for this subnet. |
858 | 471 | 465 | ||
859 | @@ -476,18 +470,16 @@ | |||
860 | 476 | The highest value of IP address to allocate via DHCP | 470 | The highest value of IP address to allocate via DHCP |
861 | 477 | 471 | ||
862 | 478 | 472 | ||
866 | 479 | 473 | tag | |
864 | 480 | |||
865 | 481 | tag | ||
867 | 482 | ^^^ | 474 | ^^^ |
868 | 483 | 475 | ||
869 | 484 | Usage: maas-cli <profile> tag read | update-nodes | rebuild | update | | 476 | Usage: maas-cli <profile> tag read | update-nodes | rebuild | update | |
871 | 485 | nodes | delete | 477 | nodes | delete |
872 | 486 | 478 | ||
873 | 487 | .. program:: maas-cli tag | 479 | .. program:: maas-cli tag |
874 | 488 | 480 | ||
875 | 489 | :samp:`read <tag_name>` | 481 | :samp:`read <tag_name>` |
877 | 490 | 482 | ||
878 | 491 | Returns information on the tag specified by <name> | 483 | Returns information on the tag specified by <name> |
879 | 492 | 484 | ||
880 | 493 | :samp:`update-nodes <tag_name> [add=<system_id>] [remove=<system_id>] [nodegroup=<system_id>]` | 485 | :samp:`update-nodes <tag_name> [add=<system_id>] [remove=<system_id>] [nodegroup=<system_id>]` |
881 | @@ -500,10 +492,10 @@ | |||
882 | 500 | 492 | ||
883 | 501 | :samp:`rebuild` | 493 | :samp:`rebuild` |
884 | 502 | 494 | ||
886 | 503 | Triggers a rebuild of the tag to node mapping. | 495 | Triggers a rebuild of the tag to node mapping. |
887 | 504 | 496 | ||
888 | 505 | :samp:`update <tag_name> [name=<value>] | [comment=<value>]|[definition=<value>]` | 497 | :samp:`update <tag_name> [name=<value>] | [comment=<value>]|[definition=<value>]` |
890 | 506 | 498 | ||
891 | 507 | Updates the tag identified by tag_name. Any or all of name,comment | 499 | Updates the tag identified by tag_name. Any or all of name,comment |
892 | 508 | and definition may be supplied as parameters. If no parameters are | 500 | and definition may be supplied as parameters. If no parameters are |
893 | 509 | supplied, this command returns the current values. | 501 | supplied, this command returns the current values. |
894 | @@ -516,12 +508,17 @@ | |||
895 | 516 | 508 | ||
896 | 517 | Deletes the given tag. | 509 | Deletes the given tag. |
897 | 518 | 510 | ||
904 | 519 | tags | 511 | |
905 | 520 | ^^^^ | 512 | tags |
906 | 521 | Tags are a really useful way of identifying nodes with particular | 513 | ^^^^ |
907 | 522 | characteristics. | 514 | |
908 | 523 | 515 | Tags are a really useful way of identifying nodes with particular | |
909 | 524 | .. only:: html For more information on how to use them effectively, please see :ref:`deploy-tags` | 516 | characteristics. |
910 | 517 | |||
911 | 518 | .. only:: html | ||
912 | 519 | |||
913 | 520 | For more information on how to use them effectively, please see | ||
914 | 521 | :ref:`deploy-tags` | ||
915 | 525 | 522 | ||
916 | 526 | Usage: maas-cli <profile> tag [-d --debug] [-h --help] [-k | 523 | Usage: maas-cli <profile> tag [-d --debug] [-h --help] [-k |
917 | 527 | --insecure] list | new | 524 | --insecure] list | new |
918 | @@ -531,39 +528,38 @@ | |||
919 | 531 | :samp:`-d, --debug` | 528 | :samp:`-d, --debug` |
920 | 532 | 529 | ||
921 | 533 | Displays debug information listing the API responses. | 530 | Displays debug information listing the API responses. |
923 | 534 | 531 | ||
924 | 535 | :samp:`-h, --help` | 532 | :samp:`-h, --help` |
925 | 536 | 533 | ||
926 | 537 | Display usage information. | 534 | Display usage information. |
927 | 538 | 535 | ||
929 | 539 | :samp:`-k, --insecure` | 536 | :samp:`-k, --insecure` |
930 | 540 | 537 | ||
931 | 541 | Disables the SSL certificate check. | 538 | Disables the SSL certificate check. |
932 | 542 | 539 | ||
933 | 543 | :samp:`list` | 540 | :samp:`list` |
935 | 544 | 541 | ||
936 | 545 | Returns a JSON object listing all the current tags known by the MAAS server | 542 | Returns a JSON object listing all the current tags known by the MAAS server |
937 | 546 | 543 | ||
938 | 547 | :samp:`create name=<value> definition=<value> [comment=<value>]` | 544 | :samp:`create name=<value> definition=<value> [comment=<value>]` |
939 | 548 | 545 | ||
940 | 549 | Creates a new tag with the given name and definition. A comment is | 546 | Creates a new tag with the given name and definition. A comment is |
941 | 550 | optional. Names must be unique, obviously - an error will be | 547 | optional. Names must be unique, obviously - an error will be |
946 | 551 | returned if the given name already exists. The definition is in the form of | 548 | returned if the given name already exists. The definition is in the |
947 | 552 | an XPath expression which parses the XML returned by running ``lshw`` on the | 549 | form of an XPath expression which parses the XML returned by |
948 | 553 | node. | 550 | running ``lshw`` on the node. |
949 | 554 | 551 | ||
950 | 555 | Example: | 552 | Example: |
951 | 556 | Adding a tag to all nodes which have an Intel GPU:: | 553 | Adding a tag to all nodes which have an Intel GPU:: |
952 | 557 | 554 | ||
953 | 558 | $ maas-cli maas tags new name='intel-gpu' \ | 555 | $ maas-cli maas tags new name='intel-gpu' \ |
954 | 559 | comment='Machines which have an Intel display driver' \ | 556 | comment='Machines which have an Intel display driver' \ |
955 | 560 | definition='contains(//node[@id="display"]/vendor, "Intel") | 557 | definition='contains(//node[@id="display"]/vendor, "Intel") |
960 | 561 | 558 | ||
961 | 562 | 559 | ||
962 | 563 | unused commands | 560 | unused commands |
963 | 564 | ^^^^^^^^^^^^^^^ | 561 | ^^^^^^^^^^^^^^^ |
964 | 562 | |||
965 | 565 | Because the ``maas-cli`` command exposes all of the API, it also lists | 563 | Because the ``maas-cli`` command exposes all of the API, it also lists |
966 | 566 | some command options which are not really intended for end users, such | 564 | some command options which are not really intended for end users, such |
967 | 567 | as the "file" and "boot-images" options. | 565 | as the "file" and "boot-images" options. |
968 | 568 | |||
969 | 569 | |||
970 | 570 | 566 | ||
971 | === modified file 'docs/man/maas-cli.8.rst' | |||
972 | --- docs/man/maas-cli.8.rst 2012-11-20 16:45:09 +0000 | |||
973 | +++ docs/man/maas-cli.8.rst 2012-11-21 11:51:34 +0000 | |||
974 | @@ -1,4 +1,3 @@ | |||
975 | 1 | |||
976 | 2 | maas-cli | 1 | maas-cli |
977 | 3 | -------- | 2 | -------- |
978 | 4 | 3 | ||
979 | @@ -7,9 +6,9 @@ | |||
980 | 7 | ^^^^^ | 6 | ^^^^^ |
981 | 8 | 7 | ||
982 | 9 | $ maas-cli <profile> <command> [parameters] | 8 | $ maas-cli <profile> <command> [parameters] |
984 | 10 | 9 | ||
985 | 11 | The available commands are dependent on the API you are connecting to and the | 10 | The available commands are dependent on the API you are connecting to and the |
987 | 12 | profile you use. The currently available options are explained below. | 11 | profile you use. The currently available options are explained below. |
988 | 13 | 12 | ||
989 | 14 | 13 | ||
990 | 15 | Description | 14 | Description |
991 | @@ -17,12 +16,14 @@ | |||
992 | 17 | 16 | ||
993 | 18 | .. include:: ../maascli.rst | 17 | .. include:: ../maascli.rst |
994 | 19 | 18 | ||
995 | 19 | |||
996 | 20 | Further Documentation | 20 | Further Documentation |
997 | 21 | ^^^^^^^^^^^^^^^^^^^^^ | 21 | ^^^^^^^^^^^^^^^^^^^^^ |
998 | 22 | |||
999 | 22 | For more documentation of MAAS, please see https://maas.ubuntu.com/docs | 23 | For more documentation of MAAS, please see https://maas.ubuntu.com/docs |
1000 | 23 | 24 | ||
1001 | 25 | |||
1002 | 24 | See Also | 26 | See Also |
1003 | 25 | ^^^^^^^^ | 27 | ^^^^^^^^ |
1004 | 28 | |||
1005 | 26 | `maas` | 29 | `maas` |
1006 | 27 | |||
1007 | 28 | |||
1008 | 29 | 30 | ||
1009 | === modified file 'docs/man/maas.8.rst' | |||
1010 | --- docs/man/maas.8.rst 2012-11-20 16:45:09 +0000 | |||
1011 | +++ docs/man/maas.8.rst 2012-11-21 11:51:34 +0000 | |||
1012 | @@ -1,23 +1,25 @@ | |||
1013 | 1 | maas | 1 | maas |
1014 | 2 | ---- | 2 | ---- |
1015 | 3 | 3 | ||
1017 | 4 | USAGE | 4 | |
1018 | 5 | Usage | ||
1019 | 5 | ^^^^^ | 6 | ^^^^^ |
1020 | 6 | 7 | ||
1021 | 7 | maas [-h, --help] createsuperuser | changepassword | shell | 8 | maas [-h, --help] createsuperuser | changepassword | shell |
1022 | 8 | 9 | ||
1024 | 9 | DESCRIPTION | 10 | |
1025 | 11 | Description | ||
1026 | 10 | ^^^^^^^^^^^ | 12 | ^^^^^^^^^^^ |
1027 | 11 | 13 | ||
1031 | 12 | The `maas` command is part of Canonical's Metal As A Service software. It is | 14 | The `maas` command is part of Canonical's Metal As A Service software. It is |
1032 | 13 | derived from and can be used similarly to the `django-admin` command, and must | 15 | derived from and can be used similarly to the `django-admin` command, and must |
1033 | 14 | be run with root privileges. | 16 | be run with root privileges. |
1034 | 15 | 17 | ||
1035 | 16 | For the end user, there are only three subcommands of interest. | 18 | For the end user, there are only three subcommands of interest. |
1036 | 17 | 19 | ||
1037 | 18 | **createsuperuser** | 20 | **createsuperuser** |
1038 | 19 | This subcommand is used to create a superuser for the | 21 | This subcommand is used to create a superuser for the |
1040 | 20 | MAAS install. The suggested username is "root". This command usually only | 22 | MAAS install. The suggested username is "root". This command usually only |
1041 | 21 | needs to be run when installing MAAS for the first time. | 23 | needs to be run when installing MAAS for the first time. |
1042 | 22 | 24 | ||
1043 | 23 | **changepassword** | 25 | **changepassword** |
1044 | @@ -26,16 +28,18 @@ | |||
1045 | 26 | enter it once again to verify. | 28 | enter it once again to verify. |
1046 | 27 | 29 | ||
1047 | 28 | **shell** | 30 | **shell** |
1049 | 29 | This subcommand may be useful for debugging installed systems. It | 31 | This subcommand may be useful for debugging installed systems. It |
1050 | 30 | will open a new python shell environment with the correct django environment | 32 | will open a new python shell environment with the correct django environment |
1051 | 31 | for working with the installed MAAS software. | 33 | for working with the installed MAAS software. |
1052 | 32 | 34 | ||
1054 | 33 | 35 | ||
1055 | 34 | Further Documentation | 36 | Further Documentation |
1056 | 35 | ^^^^^^^^^^^^^^^^^^^^^ | 37 | ^^^^^^^^^^^^^^^^^^^^^ |
1057 | 38 | |||
1058 | 36 | For more documentation of MAAS, please see https://maas.ubuntu.com/docs | 39 | For more documentation of MAAS, please see https://maas.ubuntu.com/docs |
1059 | 37 | 40 | ||
1060 | 41 | |||
1061 | 38 | See Also | 42 | See Also |
1062 | 39 | ^^^^^^^^ | 43 | ^^^^^^^^ |
1063 | 44 | |||
1064 | 40 | `maas-cli` | 45 | `maas-cli` |
1065 | 41 | |||
1066 | 42 | 46 | ||
1067 | === modified file 'docs/nodes.rst' | |||
1068 | --- docs/nodes.rst 2012-10-11 13:23:54 +0000 | |||
1069 | +++ docs/nodes.rst 2012-11-21 11:51:34 +0000 | |||
1070 | @@ -1,10 +1,10 @@ | |||
1071 | 1 | |||
1072 | 2 | |||
1073 | 3 | Adding nodes to the system | 1 | Adding nodes to the system |
1074 | 4 | ========================== | 2 | ========================== |
1075 | 5 | 3 | ||
1078 | 6 | Now that the MAAS controller is running, we need to make the nodes aware of MAAS and vice-versa. If you have set up DHCP correctly, and your nodes can boot via PXE then things really couldn't be much easier and you can use :ref:`the automatic discovery procedure <auto-enlist>` | 4 | Now that the MAAS controller is running, we need to make the nodes |
1079 | 7 | 5 | aware of MAAS and vice-versa. If you have set up DHCP correctly, and | |
1080 | 6 | your nodes can boot via PXE then things really couldn't be much easier | ||
1081 | 7 | and you can use :ref:`the automatic discovery procedure <auto-enlist>` | ||
1082 | 8 | 8 | ||
1083 | 9 | 9 | ||
1084 | 10 | .. _auto-enlist: | 10 | .. _auto-enlist: |
1085 | @@ -12,21 +12,29 @@ | |||
1086 | 12 | Automatic Discovery | 12 | Automatic Discovery |
1087 | 13 | ------------------- | 13 | ------------------- |
1088 | 14 | 14 | ||
1095 | 15 | With nodes set to boot from a PXE image, they will start, look for a DHCP server, receive the PXE boot details, boot the image, contact the MAAS server and shut down. | 15 | With nodes set to boot from a PXE image, they will start, look for a |
1096 | 16 | 16 | DHCP server, receive the PXE boot details, boot the image, contact the | |
1097 | 17 | During this process, the MAAS server will be passed information about the node, including the architecture, MAC address and other details which will be stored in the database of nodes. You can accept and comission the nodes via the web interface. | 17 | MAAS server and shut down. |
1098 | 18 | When the nodes have been accepted the selected series of Ubuntu will be installed. | 18 | |
1099 | 19 | 19 | During this process, the MAAS server will be passed information about | |
1100 | 20 | To save time, you can also accept and commission all nodes from the commandline. This requires that you first login with the API key, which :ref:`you can retrieve from the web interface <api-key>`:: | 20 | the node, including the architecture, MAC address and other details |
1101 | 21 | which will be stored in the database of nodes. You can accept and | ||
1102 | 22 | comission the nodes via the web interface. When the nodes have been | ||
1103 | 23 | accepted the selected series of Ubuntu will be installed. | ||
1104 | 24 | |||
1105 | 25 | To save time, you can also accept and commission all nodes from the | ||
1106 | 26 | commandline. This requires that you first login with the API key, | ||
1107 | 27 | which :ref:`you can retrieve from the web interface <api-key>`:: | ||
1108 | 21 | 28 | ||
1109 | 22 | $ maas-cli maas nodes accept-all | 29 | $ maas-cli maas nodes accept-all |
1110 | 23 | 30 | ||
1111 | 24 | 31 | ||
1112 | 25 | |||
1113 | 26 | Enlist nodes via boot media | 32 | Enlist nodes via boot media |
1114 | 27 | --------------------------- | 33 | --------------------------- |
1115 | 28 | 34 | ||
1117 | 29 | Using Boot media such as an AVAHI boot image or the Ubuntu Server install disk, it is possible to perform the discovery and enlistment process without using DHCP/PXE. | 35 | Using Boot media such as an AVAHI boot image or the Ubuntu Server |
1118 | 36 | install disk, it is possible to perform the discovery and enlistment | ||
1119 | 37 | process without using DHCP/PXE. | ||
1120 | 30 | 38 | ||
1121 | 31 | Boot from the media and follow the instructions. | 39 | Boot from the media and follow the instructions. |
1122 | 32 | 40 | ||
1123 | @@ -34,4 +42,5 @@ | |||
1124 | 34 | Manually add nodes | 42 | Manually add nodes |
1125 | 35 | ------------------ | 43 | ------------------ |
1126 | 36 | 44 | ||
1128 | 37 | If you know the MAC address of a node, you can manually enter details about the node through the web interface. | 45 | If you know the MAC address of a node, you can manually enter details |
1129 | 46 | about the node through the web interface. | ||
1130 | 38 | 47 | ||
1131 | === modified file 'docs/orientation.rst' | |||
1132 | --- docs/orientation.rst 2012-10-04 15:14:12 +0000 | |||
1133 | +++ docs/orientation.rst 2012-11-21 11:51:34 +0000 | |||
1134 | @@ -1,30 +1,46 @@ | |||
1135 | 1 | .. _orientation: | 1 | .. _orientation: |
1137 | 2 | 2 | ||
1138 | 3 | Orientation | 3 | Orientation |
1139 | 4 | =========== | 4 | =========== |
1140 | 5 | 5 | ||
1141 | 6 | |||
1142 | 6 | MAAS in Brief | 7 | MAAS in Brief |
1143 | 7 | ------------- | 8 | ------------- |
1144 | 8 | 9 | ||
1150 | 9 | Canonical’s MAAS brings the dynamism of cloud computing to the world of physical provisioning and Ubuntu. Connect, commission and deploy physical servers in record time, re-allocate nodes between services dynamically, and keep them up to date and in due course, retire them from use. | 10 | Canonical’s MAAS brings the dynamism of cloud computing to the world |
1151 | 10 | 11 | of physical provisioning and Ubuntu. Connect, commission and deploy | |
1152 | 11 | MAAS is a new way of thinking about physical infrastructure. Compute, storage and network are commodities in the virtual world, and for large-scale deployments the same is true of the metal. “Metal as a service” lets you treat farms of servers as a malleable resource for allocation to specific problems, and re-allocation on a dynamic basis. | 12 | physical servers in record time, re-allocate nodes between services |
1153 | 12 | 13 | dynamically, and keep them up to date and in due course, retire them | |
1154 | 13 | In conjunction with the Juju service orchestration software (see https://juju.ubuntu.com/docs/), MAAS will enable you to get the most out of your physical hardware and dynamically deploy complex services with ease and confidence. | 14 | from use. |
1155 | 15 | |||
1156 | 16 | MAAS is a new way of thinking about physical infrastructure. Compute, | ||
1157 | 17 | storage and network are commodities in the virtual world, and for | ||
1158 | 18 | large-scale deployments the same is true of the metal. “Metal as a | ||
1159 | 19 | service” lets you treat farms of servers as a malleable resource for | ||
1160 | 20 | allocation to specific problems, and re-allocation on a dynamic basis. | ||
1161 | 21 | |||
1162 | 22 | In conjunction with the Juju service orchestration software (see | ||
1163 | 23 | https://juju.ubuntu.com/docs/), MAAS will enable you to get the most | ||
1164 | 24 | out of your physical hardware and dynamically deploy complex services | ||
1165 | 25 | with ease and confidence. | ||
1166 | 26 | |||
1167 | 14 | 27 | ||
1168 | 15 | Do I Need MAAS? | 28 | Do I Need MAAS? |
1169 | 16 | --------------- | 29 | --------------- |
1170 | 17 | 30 | ||
1172 | 18 | MAAS certainly isn't for everyone, but why not ask yourself these questions? | 31 | MAAS certainly isn't for everyone, but why not ask yourself these |
1173 | 32 | questions? | ||
1174 | 19 | 33 | ||
1176 | 20 | You probably *SHOULD* use MAAS if any or all of the following statements are true: | 34 | You probably *SHOULD* use MAAS if any or all of the following |
1177 | 35 | statements are true: | ||
1178 | 21 | 36 | ||
1179 | 22 | * You are trying to manage many physical servers. | 37 | * You are trying to manage many physical servers. |
1180 | 23 | * You want to deploy services with the minimum fuss. | 38 | * You want to deploy services with the minimum fuss. |
1181 | 24 | * You need to get the most from your resources. | 39 | * You need to get the most from your resources. |
1182 | 25 | * You want things to work, repeatably and reliably. | 40 | * You want things to work, repeatably and reliably. |
1183 | 26 | 41 | ||
1185 | 27 | You probably don't need MAAS if any or all of these statements are true: | 42 | You probably don't need MAAS if any or all of these statements are |
1186 | 43 | true: | ||
1187 | 28 | 44 | ||
1188 | 29 | * You don't need to manage physical hardware | 45 | * You don't need to manage physical hardware |
1189 | 30 | * You relish time spent in the server room | 46 | * You relish time spent in the server room |
1190 | @@ -36,17 +52,18 @@ | |||
1191 | 36 | A Typical MAAS setup | 52 | A Typical MAAS setup |
1192 | 37 | -------------------- | 53 | -------------------- |
1193 | 38 | 54 | ||
1195 | 39 | MAAS is designed to work with your physical hardware, whether your setup includes thousands of server boxes or only a few. The key components of the MAAS software are: | 55 | MAAS is designed to work with your physical hardware, whether your |
1196 | 56 | setup includes thousands of server boxes or only a few. The key | ||
1197 | 57 | components of the MAAS software are: | ||
1198 | 40 | 58 | ||
1199 | 41 | * Region controller | 59 | * Region controller |
1200 | 42 | * Cluster controller(s) | 60 | * Cluster controller(s) |
1201 | 43 | * Nodes | 61 | * Nodes |
1202 | 44 | 62 | ||
1204 | 45 | For small (in terms of number of nodes) setups, you will probably just install the Region controller and a cluster controller on the same server - it is only worth having multiple region controllers if you need to organise your nodes into different subnets (e.g. if you have a lot of nodes). | 63 | For small (in terms of number of nodes) setups, you will probably just |
1205 | 64 | install the Region controller and a cluster controller on the same | ||
1206 | 65 | server - it is only worth having multiple region controllers if you | ||
1207 | 66 | need to organise your nodes into different subnets (e.g. if you have a | ||
1208 | 67 | lot of nodes). | ||
1209 | 46 | 68 | ||
1210 | 47 | .. image:: media/orientation_architecture-diagram.* | 69 | .. image:: media/orientation_architecture-diagram.* |
1211 | 48 | |||
1212 | 49 | |||
1213 | 50 | |||
1214 | 51 | |||
1215 | 52 | |||
1216 | 53 | 70 | ||
1217 | === modified file 'docs/tags.rst' | |||
1218 | --- docs/tags.rst 2012-10-25 13:09:16 +0000 | |||
1219 | +++ docs/tags.rst 2012-11-21 11:51:34 +0000 | |||
1220 | @@ -1,65 +1,69 @@ | |||
1221 | 1 | |||
1222 | 2 | .. _deploy-tags: | 1 | .. _deploy-tags: |
1223 | 2 | |||
1224 | 3 | Making use of Tags | 3 | Making use of Tags |
1225 | 4 | ================== | 4 | ================== |
1226 | 5 | 5 | ||
1234 | 6 | MAAS implements a system of tags based on the physical properties of the nodes. | 6 | MAAS implements a system of tags based on the physical properties of |
1235 | 7 | The idea behind this is that you can use the tags to identify nodes with | 7 | the nodes. The idea behind this is that you can use the tags to |
1236 | 8 | particular abilities which may be useful when it comes to deploying services. | 8 | identify nodes with particular abilities which may be useful when it |
1237 | 9 | 9 | comes to deploying services. | |
1238 | 10 | A real world example of this might be to identify nodes which have fast GPUs | 10 | |
1239 | 11 | installed, if you were planning on deploying software which used CUDA or | 11 | A real world example of this might be to identify nodes which have |
1240 | 12 | OpenCL which would make use of this hardware. | 12 | fast GPUs installed, if you were planning on deploying software which |
1241 | 13 | used CUDA or OpenCL which would make use of this hardware. | ||
1242 | 14 | |||
1243 | 13 | 15 | ||
1244 | 14 | Tag definitions | 16 | Tag definitions |
1245 | 15 | --------------- | 17 | --------------- |
1246 | 16 | 18 | ||
1247 | 17 | |||
1248 | 18 | Before we can create a tag we need to know how we will select which nodes it | 19 | Before we can create a tag we need to know how we will select which nodes it |
1252 | 19 | gets applied to. MAAS collects hardware information from the nodes using the | 20 | gets applied to. MAAS collects hardware information from the nodes using the |
1253 | 20 | `"lshw" utility <http://ezix.org/project/wiki/HardwareLiSter>`_ to return | 21 | `"lshw" utility <http://ezix.org/project/wiki/HardwareLiSter>`_ to return |
1254 | 21 | detailed information in XML format. The definitions used in creating a tag are | 22 | detailed information in XML format. The definitions used in creating a tag are |
1255 | 22 | then constructed using XPath expressions. | 23 | then constructed using XPath expressions. |
1257 | 23 | If you are unfamiliar with XPath expressions, it is well worth checking out the | 24 | If you are unfamiliar with XPath expressions, it is well worth checking out the |
1258 | 24 | `w3schools documentation <http://www.w3schools.com/xpath/xpath_syntax.asp>`_. | 25 | `w3schools documentation <http://www.w3schools.com/xpath/xpath_syntax.asp>`_. |
1259 | 25 | For the lshw XML, we will just check all the available nodes for some properties. | 26 | For the lshw XML, we will just check all the available nodes for some properties. |
1261 | 26 | In our example case, we might want to find GPUs with a clock speed of over 1GHz. | 27 | In our example case, we might want to find GPUs with a clock speed of over 1GHz. |
1262 | 27 | In this case, the relevant XML node from the output will be labelled "display" | 28 | In this case, the relevant XML node from the output will be labelled "display" |
1263 | 28 | and does have a property called clock, so it will look like this:: | 29 | and does have a property called clock, so it will look like this:: |
1265 | 29 | 30 | ||
1266 | 30 | //node[@id="display"]/clock > 1000000000 | 31 | //node[@id="display"]/clock > 1000000000 |
1267 | 31 | 32 | ||
1268 | 32 | Now we have a definition, we can go ahead and create a tag. | 33 | Now we have a definition, we can go ahead and create a tag. |
1269 | 33 | 34 | ||
1270 | 35 | |||
1271 | 34 | Creating a tag | 36 | Creating a tag |
1272 | 35 | -------------- | 37 | -------------- |
1273 | 36 | 38 | ||
1276 | 37 | Once we have sorted out what definition we will be using, creating the tag is | 39 | Once we have sorted out what definition we will be using, creating the |
1277 | 38 | easy using the ``maas-cli`` command. You will need to :ref:`be logged in to the API first <api-key>`:: | 40 | tag is easy using the ``maas-cli`` command. You will need to :ref:`be |
1278 | 41 | logged in to the API first <api-key>`:: | ||
1279 | 39 | 42 | ||
1280 | 40 | $ maas-cli maas tags new name='gpu' \ | 43 | $ maas-cli maas tags new name='gpu' \ |
1281 | 41 | comment='GPU with clock speed >1GHz for running CUDA type operations.' \ | 44 | comment='GPU with clock speed >1GHz for running CUDA type operations.' \ |
1282 | 42 | definition='//node[@id="display"]/clock > 1000000000' | 45 | definition='//node[@id="display"]/clock > 1000000000' |
1283 | 43 | 46 | ||
1286 | 44 | The comment is really for your benefit. It pays to keep the actual tag name | 47 | The comment is really for your benefit. It pays to keep the actual tag name |
1287 | 45 | short and to the point as you will be using it frequently in commands, but it | 48 | short and to the point as you will be using it frequently in commands, but it |
1288 | 46 | may subsequently be hard to work out what exactly was the difference between | 49 | may subsequently be hard to work out what exactly was the difference between |
1290 | 47 | tags like "gpu" and "fastgpu" unless you have a good comment. Something which | 50 | tags like "gpu" and "fastgpu" unless you have a good comment. Something which |
1291 | 48 | explains the definition in plain language is always a good idea! | 51 | explains the definition in plain language is always a good idea! |
1292 | 49 | 52 | ||
1293 | 50 | To check which nodes this tag applies to we can use the tag command:: | 53 | To check which nodes this tag applies to we can use the tag command:: |
1294 | 51 | 54 | ||
1296 | 52 | $ maas-cli maas tag nodes gpu | 55 | $ maas-cli maas tag nodes gpu |
1297 | 53 | 56 | ||
1300 | 54 | The process of updating the tags does take some time - not a lot of time, but | 57 | The process of updating the tags does take some time - not a lot of time, but |
1301 | 55 | if nothing shows up straight away, try running the command again after a minute | 58 | if nothing shows up straight away, try running the command again after a minute |
1302 | 56 | or so. | 59 | or so. |
1303 | 57 | 60 | ||
1304 | 61 | |||
1305 | 58 | Using the tag | 62 | Using the tag |
1306 | 59 | ------------- | 63 | ------------- |
1307 | 60 | 64 | ||
1310 | 61 | You can use the tag in the web interface to discover applicable nodes, but the | 65 | You can use the tag in the web interface to discover applicable nodes, but the |
1311 | 62 | real significance of it is when using juju to deploy services. Tags can be used | 66 | real significance of it is when using juju to deploy services. Tags can be used |
1312 | 63 | with juju constraints to make sure that a particular service only gets deployed | 67 | with juju constraints to make sure that a particular service only gets deployed |
1313 | 64 | on hardware with the tag you have created. | 68 | on hardware with the tag you have created. |
1314 | 65 | 69 | ||
1315 | @@ -68,12 +72,11 @@ | |||
1316 | 68 | 72 | ||
1317 | 69 | $ juju deploy --constraints maas-tags=gpu cuda | 73 | $ juju deploy --constraints maas-tags=gpu cuda |
1318 | 70 | 74 | ||
1320 | 71 | You could list several tags if required, and mix in other juju constraints if | 75 | You could list several tags if required, and mix in other juju constraints if |
1321 | 72 | needed:: | 76 | needed:: |
1322 | 73 | 77 | ||
1323 | 74 | $ juju deploy --constraints "mem=1024 maas-tags=gpu,intel" cuda | 78 | $ juju deploy --constraints "mem=1024 maas-tags=gpu,intel" cuda |
1326 | 75 | 79 | ||
1325 | 76 | |||
1327 | 77 | 80 | ||
1328 | 78 | Manually assigning tags | 81 | Manually assigning tags |
1329 | 79 | ----------------------- | 82 | ----------------------- |
1330 | @@ -81,7 +84,7 @@ | |||
1331 | 81 | MAAS supports the creation of arbitrary tags which don't depend on XPath | 84 | MAAS supports the creation of arbitrary tags which don't depend on XPath |
1332 | 82 | definitions ("nodes which make a lot of noise" perhaps). If a tag is created | 85 | definitions ("nodes which make a lot of noise" perhaps). If a tag is created |
1333 | 83 | without specifying the definition parameter then it will simply be ignored by | 86 | without specifying the definition parameter then it will simply be ignored by |
1335 | 84 | tag refresh mechanism, but the MAAS administrator will be able to manually add | 87 | tag refresh mechanism, but the MAAS administrator will be able to manually add |
1336 | 85 | and remove the tag from specific nodes. | 88 | and remove the tag from specific nodes. |
1337 | 86 | 89 | ||
1338 | 87 | In this example we are assuming you are using the 'maas' profile and you want | 90 | In this example we are assuming you are using the 'maas' profile and you want |
1339 | @@ -90,10 +93,10 @@ | |||
1340 | 90 | $ maas-cli maas tags new name='my_tag' comment='nodes which go ping' | 93 | $ maas-cli maas tags new name='my_tag' comment='nodes which go ping' |
1341 | 91 | $ maas-cli maas tag update-nodes my_tag add="<system_id>" | 94 | $ maas-cli maas tag update-nodes my_tag add="<system_id>" |
1342 | 92 | 95 | ||
1345 | 93 | The first line creates a new tag but omits the definition, so no nodes are | 96 | The first line creates a new tag but omits the definition, so no nodes are |
1346 | 94 | automatically added to it. The second line applies that tag to a specific node | 97 | automatically added to it. The second line applies that tag to a specific node |
1347 | 95 | referenced by its system id property. | 98 | referenced by its system id property. |
1349 | 96 | 99 | ||
1350 | 97 | You can easily remove a tag from a particular node, or indeed add | 100 | You can easily remove a tag from a particular node, or indeed add |
1351 | 98 | and remove them at the same time:: | 101 | and remove them at the same time:: |
1352 | 99 | 102 | ||
1353 | @@ -105,7 +108,7 @@ | |||
1354 | 105 | subsequently edit it to remove the definition. From this point the tag behaves | 108 | subsequently edit it to remove the definition. From this point the tag behaves |
1355 | 106 | as if you had manually created it, but it still retains all the existing | 109 | as if you had manually created it, but it still retains all the existing |
1356 | 107 | associations it has with nodes. This is particularly useful if you have some | 110 | associations it has with nodes. This is particularly useful if you have some |
1358 | 108 | hardware which is conceptually similar but doesn't easily fit within a single | 111 | hardware which is conceptually similar but doesn't easily fit within a single |
1359 | 109 | tag definition:: | 112 | tag definition:: |
1360 | 110 | 113 | ||
1361 | 111 | $ maas-cli maas tag new name='my_tag' comment='nodes I like ' \ | 114 | $ maas-cli maas tag new name='my_tag' comment='nodes I like ' \ |
1362 | @@ -113,15 +116,7 @@ | |||
1363 | 113 | $ maas-cli maas tag update my_tag definition='' | 116 | $ maas-cli maas tag update my_tag definition='' |
1364 | 114 | $ maas-cli mass tag update-nodes my_tag add=<system_id> | 117 | $ maas-cli mass tag update-nodes my_tag add=<system_id> |
1365 | 115 | 118 | ||
1366 | 116 | |||
1367 | 117 | .. tip:: | 119 | .. tip:: |
1368 | 120 | |||
1369 | 118 | If you add and remove the same node in one operation, it ends up having | 121 | If you add and remove the same node in one operation, it ends up having |
1370 | 119 | the tag removed (even if the tag was in place before the operation). | 122 | the tag removed (even if the tag was in place before the operation). |
1371 | 120 | |||
1372 | 121 | |||
1373 | 122 | |||
1374 | 123 | |||
1375 | 124 | |||
1376 | 125 | |||
1377 | 126 | |||
1378 | 127 | |||
1379 | 128 | 123 | ||
1380 | === modified file 'docs/troubleshooting.rst' | |||
1381 | --- docs/troubleshooting.rst 2012-10-12 12:51:17 +0000 | |||
1382 | +++ docs/troubleshooting.rst 2012-11-21 11:51:34 +0000 | |||
1383 | @@ -1,6 +1,7 @@ | |||
1384 | 1 | ******************** | 1 | ******************** |
1385 | 2 | MAAS Troubleshooting | 2 | MAAS Troubleshooting |
1386 | 3 | ******************** | 3 | ******************** |
1387 | 4 | |||
1388 | 4 | Some parts of MAAS may still be a little confusing, and sometimes you might be | 5 | Some parts of MAAS may still be a little confusing, and sometimes you might be |
1389 | 5 | trying to do things that are just plain impossible. This section covers some of | 6 | trying to do things that are just plain impossible. This section covers some of |
1390 | 6 | the most commonly encountered problems and tries its best to make them gone. | 7 | the most commonly encountered problems and tries its best to make them gone. |
1391 | @@ -13,8 +14,10 @@ | |||
1392 | 13 | **Nodes hang on "Commissioning"** | 14 | **Nodes hang on "Commissioning"** |
1393 | 14 | ================================= | 15 | ================================= |
1394 | 15 | 16 | ||
1395 | 17 | |||
1396 | 16 | Possible Cause: Timing issues | 18 | Possible Cause: Timing issues |
1397 | 17 | ----------------------------- | 19 | ----------------------------- |
1398 | 20 | |||
1399 | 18 | Various parts of MAAS rely on OAuth to negotiate a connection to nodes. If the | 21 | Various parts of MAAS rely on OAuth to negotiate a connection to nodes. If the |
1400 | 19 | current time reported by the hardware clock on your node differs significantly | 22 | current time reported by the hardware clock on your node differs significantly |
1401 | 20 | from that on the MAAS server, the connection will not be made. | 23 | from that on the MAAS server, the connection will not be made. |
1402 | @@ -23,6 +26,7 @@ | |||
1403 | 23 | adjust them. This can usually be done from within the system BIOS, without | 26 | adjust them. This can usually be done from within the system BIOS, without |
1404 | 24 | needing to install an OS | 27 | needing to install an OS |
1405 | 25 | 28 | ||
1406 | 29 | |||
1407 | 26 | Possible Cause: Network drivers | 30 | Possible Cause: Network drivers |
1408 | 27 | ------------------------------- | 31 | ------------------------------- |
1409 | 28 | 32 | ||
1410 | @@ -34,17 +38,21 @@ | |||
1411 | 34 | network adaptor. It *is* theoretically possible to modify the boot image to | 38 | network adaptor. It *is* theoretically possible to modify the boot image to |
1412 | 35 | include proprietary drivers, but it is not a straightforward task. | 39 | include proprietary drivers, but it is not a straightforward task. |
1413 | 36 | 40 | ||
1414 | 41 | |||
1415 | 37 | **Nodes fail to PXE boot** | 42 | **Nodes fail to PXE boot** |
1416 | 38 | ========================== | 43 | ========================== |
1417 | 39 | 44 | ||
1418 | 45 | |||
1419 | 40 | Possible Cause: Using an incorrectly configured VM | 46 | Possible Cause: Using an incorrectly configured VM |
1420 | 41 | -------------------------------------------------- | 47 | -------------------------------------------------- |
1421 | 48 | |||
1422 | 42 | Some Virtual Machine setups include emulation of network hardware that does not | 49 | Some Virtual Machine setups include emulation of network hardware that does not |
1423 | 43 | support PXE booting, and in most setups, you will need to explicitly set up the | 50 | support PXE booting, and in most setups, you will need to explicitly set up the |
1425 | 44 | VM to boot via PXE. | 51 | VM to boot via PXE. |
1426 | 45 | 52 | ||
1427 | 46 | **SOLUTION**: Consult the VM docs for details of PXE booting. | 53 | **SOLUTION**: Consult the VM docs for details of PXE booting. |
1428 | 47 | 54 | ||
1429 | 55 | |||
1430 | 48 | Possible Cause: DHCP conflict | 56 | Possible Cause: DHCP conflict |
1431 | 49 | ----------------------------- | 57 | ----------------------------- |
1432 | 50 | If you are using MAAS in a setup with an existing DHCP, *DO NOT SET UP THE MAAS | 58 | If you are using MAAS in a setup with an existing DHCP, *DO NOT SET UP THE MAAS |
1433 | @@ -53,7 +61,6 @@ | |||
1434 | 53 | 61 | ||
1435 | 54 | **SOLUTION**: You will need to either: | 62 | **SOLUTION**: You will need to either: |
1436 | 55 | 63 | ||
1437 | 56 | |||
1438 | 57 | * Configure your existing DHCP server to point to the MAAS server. | 64 | * Configure your existing DHCP server to point to the MAAS server. |
1439 | 58 | 65 | ||
1440 | 59 | or | 66 | or |
1441 | @@ -62,30 +69,31 @@ | |||
1442 | 62 | this, please see https://wiki.ubuntu.com/ServerTeam/MAAS/AvahiBoot | 69 | this, please see https://wiki.ubuntu.com/ServerTeam/MAAS/AvahiBoot |
1443 | 63 | 70 | ||
1444 | 64 | 71 | ||
1445 | 65 | |||
1446 | 66 | **Can't log in to node** | 72 | **Can't log in to node** |
1447 | 67 | ======================== | 73 | ======================== |
1448 | 68 | 74 | ||
1456 | 69 | Sometimes you may wish to login directly to a node on your system. If you have | 75 | Sometimes you may wish to login directly to a node on your system. If |
1457 | 70 | set up Juju and MAAS, the attached nodes will automatically receive existing ssh | 76 | you have set up Juju and MAAS, the attached nodes will automatically |
1458 | 71 | keys and sets up ssh on the node to authenticate via key, so you can just login | 77 | receive existing ssh keys and sets up ssh on the node to authenticate |
1459 | 72 | with no password from the server. | 78 | via key, so you can just login with no password from the server. |
1460 | 73 | There is also an option in the MAAS web interface to add new ssh keys to the | 79 | There is also an option in the MAAS web interface to add new ssh keys |
1461 | 74 | nodes (via Preferences in the drop down menu which appears when clicking your | 80 | to the nodes (via Preferences in the drop down menu which appears when |
1462 | 75 | username in the top-right of the page). | 81 | clicking your username in the top-right of the page). |
1463 | 82 | |||
1464 | 76 | 83 | ||
1465 | 77 | **Forgot MAAS superuser password** | 84 | **Forgot MAAS superuser password** |
1466 | 78 | ================================== | 85 | ================================== |
1467 | 79 | 86 | ||
1471 | 80 | As long as you have sudo privileges, this is not a disaster. You can use the | 87 | As long as you have sudo privileges, this is not a disaster. You can |
1472 | 81 | ``maas`` command to change the password for the MAAS superuser on the MAAS | 88 | use the ``maas`` command to change the password for the MAAS superuser |
1473 | 82 | server: | 89 | on the MAAS server: |
1474 | 83 | 90 | ||
1475 | 84 | ``sudo maas changepassword root`` | 91 | ``sudo maas changepassword root`` |
1476 | 85 | 92 | ||
1477 | 86 | 93 | ||
1478 | 87 | **Need to reconfigure server IP address** | 94 | **Need to reconfigure server IP address** |
1479 | 88 | ========================================= | 95 | ========================================= |
1480 | 96 | |||
1481 | 89 | If you made a mistake during setup or you just need to reconfigure your MAAS | 97 | If you made a mistake during setup or you just need to reconfigure your MAAS |
1482 | 90 | server, you can simply run the setup again: | 98 | server, you can simply run the setup again: |
1483 | 91 | 99 | ||
1484 | @@ -109,7 +117,3 @@ | |||
1485 | 109 | #. If you are still getting "404 - Page not found" errors, check that the MAAS | 117 | #. If you are still getting "404 - Page not found" errors, check that the MAAS |
1486 | 110 | web interface has been installed in the right place. There should be a file | 118 | web interface has been installed in the right place. There should be a file |
1487 | 111 | present called /usr/share/maas/maas/urls.py | 119 | present called /usr/share/maas/maas/urls.py |
1488 | 112 | |||
1489 | 113 | |||
1490 | 114 | |||
1491 | 115 |
Looks pretty mechanical, so approving on that basis.