Merge lp:~rodsmith/maas-cert-server/remove-redundant-documentation into lp:~hardware-certification/maas-cert-server/trunk

Proposed by Rod Smith
Status: Merged
Approved by: Jeff Lane 
Approved revision: 40
Merged at revision: 40
Proposed branch: lp:~rodsmith/maas-cert-server/remove-redundant-documentation
Merge into: lp:~hardware-certification/maas-cert-server/trunk
Diff against target: 5367 lines (+27/-5196)
13 files modified
debian/changelog (+7/-0)
debian/control (+2/-2)
debian/debinstall (+0/-10)
documentation/MAAS_Advanced_NUC_Installation_And_Configuration.rst (+0/-1132)
documentation/MAAS_Advanced_NUC_Installation_And_Configuration_Scripted.rst (+0/-870)
documentation/Makefile (+0/-36)
documentation/README (+0/-86)
documentation/Self-Test_Guide.rst (+0/-1255)
documentation/images/logo-ubuntu_su-white_orange-hex.svg (+0/-25)
documentation/images/maniac-network.fig (+0/-1157)
documentation/styles/cert-doc.style (+0/-603)
index.html (+11/-11)
usr/sbin/maniacs-setup (+7/-9)
To merge this branch: bzr merge lp:~rodsmith/maas-cert-server/remove-redundant-documentation
Reviewer Review Type Date Requested Status
Jeff Lane  Approve
Review via email: mp+277394@code.launchpad.net

Description of the change

Replaced documentation with a dependency on the certification-docs package. Made related changes in maniacs-setup and elsewhere.

To post a comment you must log in.
Revision history for this message
Jeff Lane  (bladernr) wrote :

Wheee, here it goes

review: Approve

Preview Diff

[H/L] Next/Prev Comment, [J/K] Next/Prev File, [N/P] Next/Prev Hunk
1=== modified file 'debian/changelog'
2--- debian/changelog 2015-11-10 20:19:05 +0000
3+++ debian/changelog 2015-11-12 21:04:52 +0000
4@@ -1,3 +1,10 @@
5+maas-cert-server (0.2.11-0ppa1) trusty; urgency=medium
6+
7+ * Replace documentation with dependency on certification-docs
8+ package; make related changes to maniacs-setup and other files.
9+
10+ -- Rod Smith <rod.smith@canonical.com> Thu, 12 Nov 2015 15:35:57 -0500
11+
12 maas-cert-server (0.2.10-0ppa1) trusty; urgency=medium
13
14 * Give maniacs-setup the ability to detect what Ubuntu point-release
15
16=== modified file 'debian/control'
17--- debian/control 2015-07-30 23:08:57 +0000
18+++ debian/control 2015-11-12 21:04:52 +0000
19@@ -2,7 +2,7 @@
20 Section: admin
21 Priority: optional
22 Maintainer: Rod Smith <rod.smith@canonical.com>
23-Build-Depends: debhelper (>= 9.0.0), rst2pdf, ttf-ubuntu-font-family, python-pil
24+Build-Depends: debhelper (>= 9.0.0), python-pil
25 Standards-Version: 3.9.5
26 Homepage: https://launchpad.net/maas-cert-server
27 #Vcs-Bzr: lp:maas-cert-server
28@@ -10,7 +10,7 @@
29
30 Package: maas-cert-server
31 Architecture: all
32-Depends: ${misc:Depends}, python3, maas (>= 1.7), amtterm, iperf, apt-mirror, ipcalc
33+Depends: ${misc:Depends}, python3, maas (>= 1.7), amtterm, iperf, apt-mirror, ipcalc, certification-docs
34 Description: Ubuntu certification support files for MAAS server
35 Support files used on a MAAS server configured for use in Ubuntu server
36 certification tasks.
37
38=== modified file 'debian/debinstall'
39--- debian/debinstall 2015-07-17 19:42:06 +0000
40+++ debian/debinstall 2015-11-12 21:04:52 +0000
41@@ -9,7 +9,6 @@
42 rm -rf $BUILD_ROOT
43
44 mkdir -p "$BUILD_ROOT/usr/sbin"
45-mkdir -p "$BUILD_ROOT/usr/share/doc/maas-cert-server"
46 mkdir -p "$BUILD_ROOT/usr/share/man/man8"
47 mkdir -p "$BUILD_ROOT/usr/share/maas-cert-server"
48 mkdir -p "$BUILD_ROOT/usr/share/maas-cert-server/etc/apt"
49@@ -24,12 +23,3 @@
50 cp -a etc/maas-cert-server/config "$BUILD_ROOT/etc/maas-cert-server/"
51 cp -a usr/share/man/man8/maniacs-setup.8 "$BUILD_ROOT/usr/share/man/man8/"
52 gzip -9 "$BUILD_ROOT/usr/share/man/man8/maniacs-setup.8"
53-
54-make -C documentation
55-cp -a "documentation/MAAS_Advanced_NUC_Installation_And_Configuration.pdf" "$BUILD_ROOT/usr/share/doc/maas-cert-server/"
56-cp -a "documentation/MAAS_Advanced_NUC_Installation_And_Configuration.html" "$BUILD_ROOT/usr/share/doc/maas-cert-server/"
57-cp -a "documentation/MAAS_Advanced_NUC_Installation_And_Configuration_Scripted.pdf" "$BUILD_ROOT/usr/share/doc/maas-cert-server/"
58-cp -a "documentation/MAAS_Advanced_NUC_Installation_And_Configuration_Scripted.html" "$BUILD_ROOT/usr/share/doc/maas-cert-server/"
59-cp -a "documentation/Self-Test_Guide.pdf" "$BUILD_ROOT/usr/share/doc/maas-cert-server/"
60-cp -a "documentation/Self-Test_Guide.html" "$BUILD_ROOT/usr/share/doc/maas-cert-server/"
61-cp -a "documentation/images" "$BUILD_ROOT/usr/share/doc/maas-cert-server/"
62
63=== removed directory 'documentation'
64=== removed file 'documentation/MAAS_Advanced_NUC_Installation_And_Configuration.rst'
65--- documentation/MAAS_Advanced_NUC_Installation_And_Configuration.rst 2015-08-20 15:46:56 +0000
66+++ documentation/MAAS_Advanced_NUC_Installation_And_Configuration.rst 1970-01-01 00:00:00 +0000
67@@ -1,1132 +0,0 @@
68-==================================================
69- MAAS Advanced NUC Installation and Configuration
70-==================================================
71------------------------
72- (The MANIAC Document)
73------------------------
74-
75-.. include:: <isonum.txt>
76-
77-.. header:: |ubuntu_logo|
78-
79-.. |ubuntu_logo| image:: images/logo-ubuntu_su-white_orange-hex.png
80- :scale: 20%
81-
82-.. footer:: |canonical_logo|
83-
84-.. |canonical_logo| image:: images/logo-canonical_no-tm-white-hex.png
85- :scale: 10%
86-
87-.. raw:: pdf
88-
89- PageBreak oneColumn
90-
91-.. contents::
92-
93-.. raw:: pdf
94-
95- PageBreak
96-
97-Purpose
98-=======
99-
100-This document describes how to install MAAS on a portable computer (such as
101-an Intel NUC or laptop) so that you can deploy systems in a test
102-environment as well as install the certification tools and perform
103-certification testing. Consult the Ubuntu Certified Hardware Self-Testing
104-Guide (available from https://certification.canonical.com) for detailed
105-information on running the certification tests themselves.
106-
107-Note that this document is based on using the Ubuntu Desktop image for
108-ease of use, and thus some bits, the Network Manager bits especially,
109-may not apply if you're using Server without a desktop.
110-
111-A device (referred to generically as a "portable computer") configured
112-as described here is not intended for general Internet use. Some
113-settings relax security in the interest of ease of use, so you should
114-limit use of the portable computer on the Internet at large.
115-
116-This document begins with information on the required hardware and then
117-moves on to details about Ubuntu's network configuration and then the
118-procedures for installing MAAS. (This document assumes that you know how
119-to install Ubuntu.) Because the purpose of this document is to help you
120-bring up a MAAS server for certification purposes, it then describes how
121-to install additional software and configure MAAS to automatically
122-install the certification packages on the system under test (SUT).
123-
124-Figure 1 illustrates the overall configuration that this document will
125-help you create. This document describes configuration of the Portable
126-Computer device in the figure. It presupposes the existence of a local
127-LAN that the portable computer can use for external connections, as well
128-as the availability of at least one SUT for testing at the end of the
129-process. (Note that the Internet connection is required for initial
130-setup, but a properly-configured MAAS server does not need this
131-connection to bring up SUTs.) Once configured, you will be able to move
132-the portable computer from one site to another, repopulating the MAAS
133-LAN at each site.
134-
135-.. figure:: images/maniac-network.png
136- :alt: This document describes configuring a server that manages its own
137- subnet and connects to a wider network on another interface.
138- :width: 100%
139-
140- Figure 1: Network structure in which the portable computer will reside
141-
142-Hardware Required
143-=================
144-
145-Before beginning, you should ensure that you have the following
146-hardware:
147-
148-* Portable computer
149-
150- - Ensure that the portable computer has two network interfaces. A
151- laptop with both Ethernet and wi-fi should suffice; or you can use a
152- USB network dongle to provide a second interface, particularly for a
153- NUC.
154-
155- - Because testing sessions can last for hours, ensure that you have a
156- power brick; you should *not* run on battery power!
157-
158- - You can install on a virtual machine in a more general-purpose
159- computer, but you'll have to pay careful attention to the network and
160- disk settings.
161-
162-* System Under Test (SUT) that supports one of the power types MAAS
163- supports:
164-
165- - IPMI
166- - AMT
167- - WOL
168- - Sentry PDU
169- - SeaMicro 15000
170- - HP Moonshot
171- - Cisco UCS manager
172-
173-* Small gigabit switch (8 ports should be enough)
174-
175- - For laptop with Wi-Fi: one Ethernet cable
176-
177- - For NUC or laptop with dongle: two Ethernet cables
178-
179- - For each SUT: one Ethernet cable for each NIC port including the BMC
180-
181-* Monitor and keyboard for SUT (helpful, but not strictly required)
182-
183-* Monitor, keyboard, and mouse for the MAAS system (a laptop's built-in
184- devices should be sufficient)
185-
186-* Video cable for NUC (HDMI, Mini DisplayPort, or a converter like a
187- MiniDP to VGA)
188-
189-* At least 1TB of disk space with which to mirror the Ubuntu archives,
190- if desired. (An external USB3 hard disk may be used for this, if
191- necessary.)
192-
193-Note that these hardware requirements are geared toward a typical
194-testing environment. You may need to expand this list in some cases. For
195-instance, if you test multiple servers simultaneously, you may need
196-additional Ethernet ports.
197-
198-Installing and Configuring Ubuntu
199-=================================
200-
201-Once you've assembled the basic hardware for your portable system, you can
202-begin preparing it. The initial steps involve installing Ubuntu and setting
203-up its most basic network settings:
204-
205-#. Install Ubuntu 14.04 (Trusty Tahr) to the portable system
206-
207- - The Desktop version of Ubuntu is recommended because it allows you to
208- easily access the MAAS Dashboard locally without needing a third
209- system.
210-
211- - If you choose to use the Server version, you will probably want to
212- install the desktop on top of that as it simplifies MAAS access.
213-
214- - This guide assumes the use of Ubuntu 14.04. Although another version
215- may work, some details will differ.
216-
217-2. Boot the portable computer and log in.
218-
219-3. Configure your portable computer's ``eth0`` as the *internal* port. This
220- guide assumes a static IP address of 192.168.0.2/16 on this port.
221-
222- - If possible, configure the computer's built-in Ethernet port, rather
223- than a plug-in dongle, as ``eth0``. (You can edit
224- ``/etc/udev/rules.d/70-persistent-net.rules`` to adjust network port
225- identifiers.)
226-
227- - You can either edit ``/etc/network/interfaces`` or use the GUI Network
228- tool in the System Settings panel to configure ``eth0``. An example
229- ``/etc/network/interfaces`` configuration resembles the following::
230-
231- auto eth0
232- iface eth0 inet static
233- address 192.168.0.2
234- broadcast 192.168.255.255
235- netmask 255.255.0.0
236- dns-nameservers 192.168.0.2
237- dns-search example.org
238-
239- The final two lines are necessary if you want to use the names that
240- MAAS assigns to the SUTs on the command line (for instance, when
241- using ``ssh`` to log in to them). You must adjust the values for your
242- network, of course.
243-
244- - If necessary or desired, you may use a different IP address on the
245- *internal* port.
246-
247- - Do not specify a gateway for the private internal LAN; doing so will
248- create confusion when trying to access the Internet via the external
249- port.
250-
251- - If you have issues installing packages, check ``route -n`` and make
252- sure you don't have a gateway route to the private LAN.
253-
254- - Once you've finished configuring this network port, be sure to
255- activate it. If you configured it by editing
256- ``/etc/network/interfaces``, type ``sudo ifup eth0`` to activate it.
257- (Depending on your starting configuration, you might need to type
258- ``sudo ifdown eth0`` or bring it down via your GUI tools before
259- bringing it up with its changed configuration.)
260-
261-4. Configure your *external* network port:
262-
263- - On a laptop, you can use the Wi-Fi (usually ``wlan0``) port as the
264- external port.
265-
266- - In theory, you can configure the external network either via
267- ``/etc/network/interfaces`` or by using the Desktop's Network Manager
268- tool. In practice, the latter sometimes causes problems with name
269- resolution, so if at all possible, you should use
270- ``/etc/network/interfaces`` for this task.
271-
272- - On a NUC or laptop with an Ethernet dongle, set ``eth1`` as the external
273- port.
274-
275- - *This ordering is important,* as you want to make sure that
276- ``resolvconf`` processes the DNS services of the internal network
277- (``eth0``) before the external one (``eth1`` or ``wlan0``). This
278- shows itself in ``/etc/resolv.conf``. ``resolvconf``'s order of
279- processing is in ``/etc/resolvconf/interface-order``.
280-
281- - In most cases, no explicit configuration of the external port is
282- necessary because the Ubuntu Desktop system will have set it up to
283- use DHCP, which is appropriate. You can adjust it if necessary,
284- though.
285-
286-.. _`Installing and Configuring MAAS`:
287-
288-Installing and Configuring MAAS
289-===============================
290-
291-Installing MAAS on the computer is quite straightforward; you simply use
292-APT. Configuring MAAS, though, takes more effort, because you must
293-customize it for your environment. You must also download Ubuntu images
294-that MAAS will ultimately deliver to your SUTs. For the network to function
295-as desired, you must also set up NAT on your MAAS server. In many cases,
296-you may need to mirror the Ubuntu archives, which is a time-consuming
297-process. If you do this, you must also tweak you Apache configuration
298-appropriately. The following procedure is therefore rather lengthy.
299-
300-Installing MAAS
301----------------
302-
303-Configuring MAAS is described in generic terms at
304-`http://maas.ubuntu.com/docs/install.html <http://maas.ubuntu.com/docs/install.html>`_.
305-The more specific procedure for using MAAS in certification testing is:
306-
307-#. Install the MAAS stable PPA
308- (`https://launchpad.net/~maas/+archive/ubuntu/stable <https://launchpad.net/~maas/+archive/ubuntu/stable>`_)::
309-
310- $ sudo add-apt-repository ppa:maas/stable
311-
312- Currently (late June, 2015), Ubuntu 14.04 installs MAAS 1.7 by default.
313- This PPA holds version 1.8 of MAAS, which is the recommended version for
314- certification testing, although MAAS 1.7 is also acceptable. This
315- document describes MAAS 1.8, so if you skip this step, some details will
316- differ.
317-
318-#. Several scripts and configuration files, some of which are quite
319- lengthy, are available in the ``maas-cert-server`` package in the
320- hardware certification PPA. You can install the scripts and configuration files
321- as follows::
322-
323- $ sudo apt-add-repository ppa:hardware-certification/public
324- $ sudo apt-get update
325- $ sudo apt-get install maas-cert-server
326-
327- As of version 0.1.2, the ``maas-cert-server`` package includes a
328- dependency on MAAS, so installing ``maas-cert-server`` will also install
329- MAAS, as well as all of MAAS's dependencies.
330-
331- Most of the ``maas-cert-server`` files will be installed in
332- subdirectories of ``/usr/share/maas-cert-server``, although a few
333- appear outside of that directory tree. (Subsequent steps describe how to
334- use these files.)
335-
336-#. Verify that you've installed MAAS 1.8 from the PPA, rather than MAAS
337- 1.5 or some other version::
338-
339- $ dpkg -p maas | grep Version
340-
341- If the wrong version is installed, fixing the problem (presumably a
342- misconfigured PPA) and upgrading may work. If you upgrade from an
343- earlier version of MAAS, be sure to select the option to upgrade all the
344- configuration files when the package manager asks about this.
345-
346-#. Reconfigure the region controller with the IP address of ``eth0``::
347-
348- $ sudo dpkg-reconfigure maas-region-controller
349-
350- Give it the static IP for ``eth0``, e.g. 192.168.0.2. Note that Apache
351- may complain that it "could not reliably determine the server's fully
352- qualified domain name." You can safely ignore this message, both here
353- and in the next step.
354-
355-#. Reconfigure the cluster controller with the URL for MAAS::
356-
357- $ sudo dpkg-reconfigure maas-cluster-controller
358-
359- Give it the URL (in the prompt) with the IP of ``eth0`` -- (e.g.
360- \http://192.168.0.2/MAAS).
361-
362-#. Create the MAAS superuser::
363-
364- $ sudo maas-region-admin createsuperuser
365-
366- You can use any name you like for the superuser. Your login name is
367- likely to be easy to remember.
368-
369-Configure SSH
370--------------
371-
372-Installing ``maas-cert-server`` should also install the ``openssh-client``
373-and ``openssh-server`` packages. You should make some configuration changes
374-for these packages, though:
375-
376-#. Edit ``/etc/ssh/ssh_config``:
377-
378- - Uncomment the line reading ``StrictHostKeyChecking ask`` and change
379- ``ask`` to ``no``.
380-
381- - This change eliminates the issues with reinstalling a SUT multiple
382- times and having to deal with the ``Incorrect Host Key`` warning
383- messages. You'll still see the message if there's a conflicting key
384- in ``~/.ssh/known_hosts`` but SSH will ignore that.
385-
386- - This change is *very* insecure, but since this is a test machine and
387- not something meant to sit on the Internet or connect to much outside
388- via SSH, it's an acceptable compromise.
389-
390- - If you want to completely eliminate the issue, add this to the
391- ``ssh_config`` file::
392-
393- UserKnownHostsFile /dev/null/
394-
395- Note that this is *very very* insecure
396-
397-#. Create an SSH key for MAAS::
398-
399- $ ssh-keygen
400-
401- Leave the filename as-is for the ID file or change it. If you change the
402- filename (say, to ``maas.id_rsa``), you can have both non-MAAS and
403- MAAS-only keys.
404-
405-Setting Up NAT and Routing
406---------------------------
407-
408-The Ubuntu configuration at this point is a good start, but it won't
409-provide your SUTs with access to the Internet. To correct this problem, you
410-can use the ``startnat.sh`` script, which is installed as part of the
411-``maas-cert-server`` package, in the ``/usr/sbin`` directory.
412-
413-As the name implies, ``startnat.sh`` will start NAT on the portable
414-computer, which will enable the SUTs to access the Internet. (This is
415-required for submitting certification results directly from the SUTs and is
416-also necessary to fully install and upgrade the SUTs *if* the portable
417-computer lacks a full Ubuntu archive mirror.)
418-
419-Note that this script reads ``/etc/maas-cert-server/config`` to determine
420-which network ports connect to the internal and external networks. By
421-default, ``eth0`` is assumed to be the *internal* port and ``eth1`` the
422-*external* port. If these are not the correct assignments, edit
423-``/etc/maas-cert-server/config`` appropriately.
424-
425-You can launch ``startnat.sh`` automatically when you boot by adding a
426-reference to it to the ``/etc/rc.local`` startup script; or you can launch
427-it manually on an as-needed basis. (If local security policies forbid use
428-of NAT, you'll have to disable this script, use a local archive mirror, and
429-bring server test suite results out via sneakernet.)
430-
431-If you need to disable NAT, the ``flushnat.sh`` script should do the job.
432-
433-On some networks, you may need to perform additional configuration
434-steps. Keep this fact in mind when moving your portable computer between
435-networks; you may need to reconfigure it to meet the needs of specific
436-networks.
437-
438-Mirroring the Ubuntu Archives
439------------------------------
440-
441-Mirroring the Ubuntu archives is *optional*. It is helpful as a means to
442-reduce network traffic and speed up installations and updates,
443-particularly at sites with slow Internet connections. It is required
444-only if you must run certifications at sites that are completely
445-disconnected from the Internet. If you want or need to create a local
446-mirror for these purposes, follow these steps:
447-
448-#. Ensure that you have sufficient disk space (a little over 50GB per
449- version and architecture of Ubuntu to be supported -- 1TB total
450- should be plenty) available at ``/srv`` on the portable MAAS server. You
451- can do this in various ways:
452-
453- - Use an internal hard disk that's big enough to hold all the files you
454- need.
455-
456- - Prepare a USB3 hard disk with ext4fs and add a line to ``/etc/fstab`` so
457- that it will mount to ``/srv``.
458-
459-2. Install the ``apt-mirror`` package::
460-
461- $ sudo apt-get install apt-mirror
462-
463-3. Copy the ``/var/spool/apt-mirror`` directory tree to ``/srv``::
464-
465- $ sudo cp -a /var/spool/apt-mirror/* /srv
466-
467-4. Edit the ``/etc/apt/mirror.list`` file to include a convenient mirror
468- site and the PPAs used by the certification software
469- (``ppa:hardware-certification/public`` and
470- ``ppa:firmware-testing-team/ppa-fwts-stable``). Also be sure to set the
471- ``base_path`` option to ``/srv``.
472-
473- - The ``maas-cert-server`` package includes a sample ``mirror.list``
474- file; it should be in the ``/usr/share/maas-cert-server/etc/apt/``
475- directory.
476-
477- - This example file pulls down source, AMD64, and i386 architectures
478- for both 12.04 (Precise) and 14.04 (Trusty). The total disk space
479- (and network bandwidth consumed) is on the order of 300GiB.
480-
481- - For comparison, HD video consumes 1-8GiB per hour -- usually on the
482- low end of that range for video streaming services. As should be
483- clear, the result will be significant network demand that will
484- *degrade a typical residential DSL or cable connection for hours,*
485- and possibly exceed your monthly bandwidth allocation.
486-
487- - You may want to adjust your file to support additional versions, if
488- you have sufficient disk space and network bandwidth. If you're
489- running on a residential network connection, you can mirror just one
490- architecture and one Ubuntu version to reduce bandwidth consumption.
491-
492- - You can adjust the source site from ``archive.ubuntu.com`` to a
493- closer site to speed up the mirror process. If you do so, you may
494- need to adjust some of the paths later in this document.
495-
496-5. Copy the ``postmirror.sh`` script from ``/usr/share/maas-cert-server/`` to
497- ``/srv/var/``. Edit the local path and URL as necessary for your
498- installation and the archive site from which you're mirroring your
499- system.
500-
501-6. Mirror the archives::
502-
503- $ sudo apt-mirror
504-
505- Note that this process is likely to take several hours, depending on the
506- quality of your network connection.
507-
508-In addition to mirroring the main Ubuntu archives, you may
509-*optionally* mirror the MAAS archives. Ordinarily, you download these
510-files just once for the architectures you need on the MAAS server, but
511-having a backup may be useful in case you need to install an unexpected
512-architecture or restore files should they be damaged. Mirroring these
513-files requires using a different tool from ``apt-mirror``:
514-
515-#. Install the ``simplestreams`` and ``ubuntu-cloud-keyring packages``::
516-
517- $ sudo apt-get install simplestreams ubuntu-cloudimage-keyring
518-
519-2. Change to the ``/srv/mirror`` directory.
520-
521-3. Mirror the site with the following command::
522-
523- $ sudo sstream-mirror --keyring \\
524- usr/share/keyrings/ubuntu-cloudimage-keyring.gpg --max=1 \\
525- http://maas.ubuntu.com/images/ephemeral/releases/ \\
526- -v maas.ubuntu.com
527-
528- - You can test this process without actually downloading files by
529- specifying ``\-\-no-item-download`` among the options.
530-
531- - Note that the ``simplestreams`` package is not part of Ubuntu 12.04.
532-
533-If you are planning to operate in locations with bad or no outside
534-network access, you will also need to obtain and bring a copy of a
535-bootable Ubuntu Cloud Image for the virtualization portion of the
536-certification test. You can obtain that here:
537-
538-`http://cloud-images.ubuntu.com/trusty/current/trusty-server-cloudimg-i386-disk1.img <http://cloud-images.ubuntu.com/trusty/current/trusty-server-cloudimg-i386-disk1.img>`_
539-
540-You can use another release of Ubuntu if this is convenient. An i386 image
541-is used even when you're testing 64-bit hardware. You can place this file
542-on the ``/srv`` volume and copy it to the SUTs before running the server
543-test suite.
544-
545-Configuring Apache
546-------------------
547-
548-Apache is used both for accessing the MAAS web UI and for delivering
549-archive mirrors, if you've created them. It should have already been
550-installed as a dependency of MAAS. If you've mirrored an Ubuntu archive
551-site, you must create symbolic links of the mirror archives to the default
552-Apache directory:
553-
554-#. Create symbolic links for the main Ubuntu mirror, for the PPA
555- mirrors, and for the MAAS mirror::
556-
557- $ sudo ln -s /srv/mirror/archive.ubuntu.com/ubuntu /var/www/html/ubuntu
558- $ sudo ln -s /srv/mirror/ppa.launchpad.net/\* /var/www/html/
559- $ sudo ln -s /srv/mirror/maas.ubuntu.com /var/www/html/
560-
561- Note that if you altered ``/etc/apt/mirror.list`` to mirror from a
562- regional repository (such as ``us.archive.ubuntu.com``) rather than from
563- the main Ubuntu repository (``archive.ubuntu.com``), you must adjust the
564- first command appropriately.
565-
566-2. Ensure that the mirrors are readable by Apache users::
567-
568- $ sudo chown -R www-data:www-data /srv/mirror/\*
569-
570-Of course, you should keep your mirrors up-to-date. You can do this
571-manually or by creating a ``cron`` job. In fact, the ``apt-mirror`` package
572-installs a suitable ``cron`` file, ``/etc/cron.d/apt-mirror``. Remove the
573-leading hash (``#``) from the following line in that file to activate it::
574-
575- #0 4 \* \* \* apt-mirror /usr/bin/apt-mirror > /var/spool/apt-mirror/var/cron.log
576-
577-Once activated, this job will run every day at 4:00 AM, provided the
578-computer is powered on at that time. If that won't be the case, you can
579-run it manually by typing ``sudo apt-mirror`` whenever is convenient. Runs
580-after the initial one should take much less time and bandwidth than the
581-original one.
582-
583-Similarly, you can re-run the ``sstream-mirror`` command (from the
584-``/srv/mirror`` directory) to update the MAAS files. As with
585-``apt-mirror``, you can do this manually or create a ``cron`` job.
586-
587-You can save a little time and network bandwidth in the following steps by
588-configuring your portable computer to use the archives you've just
589-downloaded. To do so, edit ``/etc/apt/sources.list`` and edit the lines
590-that are equivalent to those you entered in ``/etc/apt/mirror.list`` to
591-refer to ``localhost`` rather than ``archive.ubuntu.com`` (or whatever
592-mirror site your computer is set up to use by default). For instance, your
593-original file might include a line like the following::
594-
595- deb http://archive.ubuntu.com/ubuntu precise main restricted universe multiverse
596-
597-You would change that to read::
598-
599- deb http://localhost/ubuntu precise main restricted universe multiverse
600-
601-Be sure to change all the references to the standard archives that
602-you've mirrored. To test these changes, type::
603-
604- $ sudo apt-get update
605- $ sudo apt-get dist-upgrade
606-
607-You should see normal output for these commands, although chances are
608-the ``dist-upgrade`` command will report no need to update any files.
609-
610-Configuring the MAAS Web UI
611----------------------------
612-
613-With MAAS installed and (if desired) the Ubuntu archives mirrored, you can
614-proceed with further MAAS configuration via its web-based user interface.
615-To do so, follow these steps:
616-
617-#. Verify you can access the MAAS Dashboard:
618-
619- - Launch a browser and point it to \http://192.168.0.2/MAAS (your
620- internal port).
621-
622- - You should also be able to access this by default on the
623- external port, too.
624-
625- - If you provide the computer with a hostname in DNS or ``/etc/hosts``,
626- you should be able to access it via that name, as well.
627-
628- - You should see a login prompt.
629-
630-#. Log in to the Dashboard using the username and password you added
631- above for the superuser.
632-
633-#. Click on the down arrow next to the user name in the top right
634- corner. A drop-down menu will appear, as shown here:
635-
636- .. image:: images/maas-dropdown.png
637- :width: 100%
638-
639-#. Select Account (Preferences in MAAS 1.7) in this drop-down menu. A user
640- preferences screen will appear.
641-
642-#. Add your SSH key
643-
644- - Click on "+ Add SSH key"
645-
646- - Copy and paste the entire contents of your ``~/.ssh/id_rsa.pub`` (or
647- MAAS-specific public key) in the "Public key" box
648-
649- - click on "+ Add key"
650-
651- - You may optionally add more keys in the same way.
652-
653-#. Click Images near the top of the MAAS web page. This will bring you
654- to a page in which you can select the architectures and Ubuntu
655- versions to support. For certification, you should import a minimum
656- of Ubuntu 14.04 LTS for AMD64; however, you may want to add 12.04
657- LTS and i386 or other CPU types, depending on your anticipated
658- needs. (Note that custom point-release images are imported later, but
659- you must import at least one image for each CPU architecture hereJ.)
660-
661-#. In the Images page, select the images you want MAAS to support and
662- then click Import Images. A spinner will appear as the download
663- progresses. This process can take minutes to hours depending on your
664- Internet connection. MAAS needs to download PXE images for all
665- supported releases as well as ephemeral images for commissioning and
666- deployment.
667-
668-#. Check the Clusters page to verify the status of your image downloads. A
669- successful image import will show Synced under Images.
670-
671-#. Edit the ``/etc/maas/templates/dhcp/dhcpd.conf.template`` file. You can
672- customize your DHCP options here. Most defaults are fine for most
673- installations, but you might want to add entries for servers that are
674- not MAAS nodes and should have fixed IP addresses or customize certain
675- options. (Many values can be set via the MAAS web UI, as described
676- shortly.) A pair of options you may want to adjust are the default and
677- maximum lease times, which both default to 30 seconds. Such low settings
678- can create excessive DHCP traffic, so increasing them is advisable. A
679- value of 3600 (1 hour) works well for certification testing purposes.
680-
681-#. Click the Clusters link near the top of the web page so you can set
682- the DHCP options:
683-
684- #. Click the cluster name for the cluster controller (Cluster Master in
685- this example):
686-
687- .. image:: images/clusters-page.png
688- :width: 98%
689-
690- #. Mouse over the *internal* (normally ``eth0``) network
691- interface. (If you don't see your internal interface listed, click
692- the "Add Interface" button to add it.) You should see a pair of
693- icons appear, one to edit the interface and one to delete it. Click
694- the former, then change the following items:
695-
696- - Interface = ``eth0`` (or your *internal* port)
697-
698- - Management = *DHCP and DNS*
699-
700- - IP (required) = the IP address of the *internal* port
701-
702- - Subnet mask = appropriate mask (such as 255.255.0.0)
703-
704- - Broadcast IP = network IP (such as 192.168.255.255)
705-
706- - Router IP = IP of ``eth0`` (the *internal* port, such as
707- 192.168.0.2)
708-
709- - DHCP dynamic IP range low value = Start of the DHCP IP address
710- range used for enlistment, commissioning, and unknown devices
711- (such as 192.168.0.50)
712-
713- - DHCP dynamic IP range high value = end of the DHCP dynamic IP
714- address range (such as 192.168.0.99)
715-
716- - Static IP range low value = Start of the static IP address range
717- used for servers (SUTs) managed by MAAS (such as 192.168.0.100)
718-
719- - Static IP range high value = end of the static IP address range
720- (such as 192.168.0.200)
721-
722- - Click Save Interface
723-
724-#. If desired, change the DNS zone name field on the "Edit Cluster
725- Controller" page to some convenient value, such as ``example.org``. If
726- you set a search domain in ``/etc/network/interfaces``, using that value
727- is desirable. Click "Save Cluster Controller" when you're finished.
728-
729-#. Click Settings near the top of the page to load the MAAS Settings page,
730- where you set several miscellaneous MAAS details:
731-
732- - Click the associated "save" button for *each* of the following
733- sections you change. Unfortunately, each save button is
734- section-specific and won't save changes made in other sections of
735- that page.
736-
737- - There should be at least one MAAS Admin listed in Users and
738- Keys.
739-
740- - Scroll down to Commissioning and verify that the "Default Ubuntu
741- release used for commissioning" is set to what you need. This will
742- normally be Ubuntu 14.04 LTS "Trusty Tahr." (If MAAS claims there is
743- no usable release, you will need to wait for the ephemeral image
744- downloading step to complete and then refresh the page to see the
745- options.)
746-
747- - Set the options under "Deploy" to suitable values.
748-
749- - For Trusty certification, you should set the options to Ubuntu 14.04
750- LTS "Trusty Tahr."
751-
752- - If you must also certify 12.04, you can override this option on a
753- boot-by-boot basis. Set the default for whichever version you use
754- most frequently.
755-
756- - If you're using a local APT mirror or if you want to change the
757- mirror used by your SUTs from the default, change the URLs for Main
758- archive and Ports archive to the correct URLs for your
759- environment. If you mirrored your archives as described earlier, you
760- can adjust these values to obviate the need for Internet access by
761- the SUTs:
762-
763- - The Main Archive should refer to \http://192.168.0.2/ubuntu.
764-
765- - The Ports Archive can remain unchanged from the default.
766-
767- - Adjust 192.168.0.2 as appropriate for your network settings; the
768- reference should be to your portable computer's *internal* network
769- address.
770-
771- - Under *Network Configuration*, you may want to make some changes,
772- such as an HTTP proxy, an upstream DNS server, and an NTP server.
773- These settings help you deal with strict local firewalls. These
774- settings are most likely to be necessary if you did not mirror the
775- Ubuntu archives.
776-
777- - Under *Third Party Drivers Configuration*, ensure that *Enable the
778- installation of proprietary drivers (i.e. HPVSA)* is checked.
779-
780-Testing the MAAS Server
781-=======================
782-
783-At this point, your MAAS server should be set up and configured
784-correctly. If you continued preparing MAAS as your images downloaded,
785-though, wait until that process has finished before proceeding. To test
786-it, follow these steps:
787-
788-#. Prepare a computer by configuring it to boot via PXE. This computer
789- need not be a computer you plan to certify; anything that can
790- PXE-boot should work, although to fully test the MAAS server, the
791- test system should provide IPMI or some other power-control tool that
792- MAAS supports.
793-
794-#. Connect the test computer to the portable computer's *internal* network
795- and power it on.
796-
797- - The test computer should PXE-boot from the portable MAAS computer.
798-
799- - This first boot should be to the enlistment image, which provides
800- some very basic information to the MAAS server. Once the node powers
801- itself off you should see it listed in the MAAS nodes list
802- (\http://localhost/MAAS/#/nodes/ or, on MAAS 1.7,
803- \http://localhost/MAAS/nodes/) with a Status field of "New."
804-
805- - Note that you will have to refresh the nodes list as it does not
806- refresh itself to list new data.
807-
808-#. Click on the node's hostname to view the node's summary page.
809-
810-#. If desired, click the node's hostname near the upper-left corner of the
811- page. This will enable you to change the hostname to something
812- descriptive, such as the computer's model number. Click "Save" when
813- you've made your changes.
814-
815-#. If necessary, click "Edit" in the Machine Summary section to change the
816- architecture of the machine. Click "Save Changes" when you're done.
817-
818-#. If necessary, change the Power Type in the Power section of the page.
819- This may necessitate setting an IP address, MAC address, password, or
820- other information, depending on the power control technology in use.
821- Click "Save Changes" when you're done.
822-
823-#. Click "Take Action" near the top-right corner of the page, followed by
824- "Commission Node" from the resulting drop-down menu. You must then click
825- "Go."
826-
827- - The node should power on again. This time you'll see it PXE-boot the
828- commissioning image. Note that if your test system lacks a BMC or
829- other means to remotely control its power, you must manually power it
830- on.
831-
832- - The node should do a bit more work this time before powering off
833- again.
834-
835- - Once it's done, the UI will show a Status of "Ready."
836-
837-#. Once the system powers off after commissioning, click "Take Action"
838- followed by "Deploy." You must then click "Go" to confirm this action.
839-
840- - The node should power on again (or you will have to control it
841- manually if it lacks a BMC). This time it will take longer to finish
842- working, as MAAS will install Ubuntu on the system.
843-
844- - Once it's done, the computer will reboot into its installed image.
845-
846- - You could install and run certification software on the test system
847- at this point. The next section, `Installing Certification Packages
848- Automatically via MAAS`_, describes additional changes to MAAS to
849- simplify this task.
850-
851-If any of these steps fail, you may have run into a MAAS bug; your test
852-computer may have a buggy PXE, IPMI, or other subsystem; or you may have
853-misconfigured something in the MAAS setup. You may want to review the
854-preceding sections to verify that you configured everything correctly.
855-To help in debugging problems, the node status page includes a section
856-entitled Latest Node Events with a summary of the last few events
857-related to the node. (You must refresh the page to see new events.)
858-
859-Note that there are two methods of installing nodes:
860-
861-- **Standard** -- aka Debian or d-i, this installation method installs
862- Ubuntu using the same installation program used by an Ubuntu ISO file
863- that you might download from the Internet.
864-
865-- **Fastpath** -- aka curtin, this installation method places a pre-built
866- Ubuntu image onto the node's hard disk.
867-
868-A fastpath install is, as the name implies, faster than a standard
869-install. In MAAS 1.5, the standard install was the default, but in MAAS
870-1.7, the default has changed to the fastpath method. The fastpath method
871-is also preferred for certification testing because it permits the
872-certification suite to detect and report the MAAS version, whereas the
873-d-i method does not currently support this feature. The method to
874-deliver fixed point releases, described next, uses the fastpath install
875-procedures.
876-
877-Configuring MAAS to Deliver Fixed Point Releases
878-================================================
879-
880-By default, MAAS delivers whatever version of Ubuntu was packaged by the
881-MAAS team when you downloaded your MAAS installation images. This
882-version is likely to correspond to the current point release, possibly
883-plus some updates. For certification work, it's far better to install a
884-fixed point release, such as 14.04 GA or 14.04.1. This can be
885-accomplished with MAAS 1.7 by installing custom images:
886-
887-#. Download the custom images. They are currently hosted at
888- http://certification-static.canonical.com/fixed-point-releases/.
889- Retrieve whichever images you need and store them somewhere
890- convenient, such as your user's home directory on the portable
891- computer. Images are about 250-300MiB in size.
892-
893-#. Return to the terminal and login to the API using maas-cli::
894-
895- $ maas login <PROFILE_NAME> <API_URL> <KEY>
896-
897- - ``<PROFILE_NAME>`` is anything you wish. This guide uses ``maas`` for
898- simplicity.
899-
900- - ``<API_URL>`` refers to a URL on the MAAS server, as in
901- \http://192.168.0.2/MAAS/api/1.0.
902-
903- - ``<KEY>`` is a key displayed in the Dashboard
904- (\http://localhost/MAAS/account/prefs/) in the MAAS Keys section or
905- can be obtained by typing ``sudo maas-region-admin apikey
906- \-\-username {user}`` in a shell (substitute your MAAS username for
907- ``{user}``).
908-
909- - You should get a message saying "You are now logged in to the MAAS
910- server at ``<URL>`` with the profile name ``'<PROFILE_NAME>'``"
911-
912- - If you've previously run the maas command using sudo, you may need to
913- either use sudo with this command or change the ownership of
914- ``~/.maascli.db``.
915-
916-3. Tell MAAS about each image you want to import::
917-
918- $ maas maas boot-resources create name=custom_14041_amd64 \\
919- title="Ubuntu 14.04.1 (AMD64)" architecture=amd64/generic \\
920- content@=/home/ubuntu/ubuntu-14.04.1-server-amd64-curtin.tar.gz
921-
922- - Repeat this step once for each image.
923-
924- - Give each image a unique ``name``. The name *must not exceed 20
925- characters!*
926-
927- - Adjust the ``title`` to the value you want to see in the MAAS web UI.
928- Each image must have a unique ``title``.
929-
930- - Point ``content@=`` to the image you want to add.
931-
932-4. Check the MAAS boot images page (\http://localhost/MAAS/images/) to
933- see that the images have imported correctly. They should appear in
934- the Custom Images section. If an image has an active spinner next to
935- it, MAAS hasn't finished importing it. If the spinner becomes a
936- hollow pink circle, the import failed.
937-
938-5. You may optionally change the default OS to deploy on the MAAS
939- settings page (\http://localhost/MAAS/settings/) to point to one of
940- your custom images. Note that whenever you release a node, the OS
941- changes back to the default, so you may need to alter that setting
942- whenever you release and redeploy a node.
943-
944-Once the images have been imported, you can select them as you would any
945-other OS version in the MAAS web UI. Instead of appearing as an OS Type
946-of "Ubuntu," though, these images will appear with an OS Type of
947-"Custom."
948-
949-Once the images have been imported, you can select them as you would any
950-other OS version in the MAAS web UI:
951-
952-#. If a node is already running, select "Take Action" followed by "Release"
953- in its node summary page. Confirm this action by clicking "Go." It may
954- take a few seconds for MAAS to fully release the node.
955-
956-#. Select "Take Action" followed by "Deploy." An option to choose the
957- image you want to deploy should appear.
958-
959-#. Select the image. It will be a Custom image with the name you
960- specified when you loaded it, as shown here:
961-
962- .. image:: images/custom-image-selection.png
963- :width: 100%
964-
965-#. Click "Go" to deploy the image. Your node should start up and install
966- the point-release image you selected.
967-
968-In MAAS 1.7.0 and earlier, it was possible to set the OS prior to acquiring
969-a node, which enabled a streamlined process of setting the OS and then
970-using the "Acquire and Start" button; but as of version 1.7.1, you must set
971-the OS between acquiring and starting the node, as just described. If you
972-want to switch the OS of an already-running node, you must first release
973-it, then re-acquire it, set its OS, and finally start it. You can also set
974-a fixed point release to be your default OS on the Settings page
975-(\http://localhost/MAAS/settings/).
976-
977-Note that before you can install a custom image for any given architecture,
978-you must have first imported at least one image for that architecture via
979-the conventional means, as described earlier, in "Installing and
980-Configuring MAAS."
981-
982-.. _`Installing Certification Packages Automatically via MAAS`:
983-
984-Installing Certification Packages Automatically via MAAS
985-========================================================
986-
987-MAAS can automatically install the certification packages every time you
988-"Start" a node. This is how to do it:
989-
990-#. On the MAAS server, enter the ``/etc/maas/preseeds`` subdirectory::
991-
992- $ cd /etc/maas/preseeds
993-
994-2. Back up the ``generic`` file::
995-
996- $ sudo cp generic generic-orig
997-
998-3. Copy the ``stable-preseed-generic`` file from
999- ``/usr/share/maas-cert-server/preseed/`` to
1000- ``/etc/maas/preseeds/generic``::
1001-
1002- $ sudo cp /usr/share/maas-cert-server/preseed/stable-preseed-generic \
1003- ./generic
1004-
1005- .. Note to self: Documentation on finer-grained naming is at
1006- https://www.google.com/url?q=https%3A%2F%2Fmaas.ubuntu.com%2Fdocs%2Fdevelopment%2Fpreseeds.html&sa=D&sntz=1&usg=AFQjCNFARkFbhKDIyF6L8uyJvJUPqJ_6Ng
1007- This is currently delicate and I suspect the documentation is faulty.
1008- Not worth covering here, but maybe revisit in the future....
1009-
1010- This action creates a configuration file that causes nodes to install
1011- the certification suite after a standard/d-i install.
1012-
1013-4. Back up the original ``curtin_userdata`` and
1014- ``curtin_userdata_custom`` files::
1015-
1016- $ sudo cp curtin_userdata curtin_userdata-orig
1017- $ sudo cp curtin_userdata_custom curtin_userdata_custom-orig
1018-
1019-5. Copy ``curtin_userdata`` from ``/usr/share/maas-cert-server/preseed/`` to
1020- ``/etc/maas/preseeds``, as both ``cutin_userdata`` and as
1021- ``curtin_userdata_custom``::
1022-
1023- $ sudo cp /usr/share/maas-cert-server/preseed/curtin_userdata ./
1024- $ sudo cp /usr/share/maas-cert-server/preseed/curtin_userdata \
1025- ./curtin_userdata_custom
1026-
1027- The modified ``curtin_userdata`` file causes nodes started via the
1028- fastpath/curtin method to install the certification software. This file
1029- affects nodes of all architectures. The ``curtin_userdata_custom`` file
1030- does the same thing for the custom images used for testing with specific
1031- point releases.
1032-
1033-6. The preseed files each include two or three lines that refer to the
1034- ``ppa.launchpad.net`` repository. If you are relying on a mirrored
1035- archive, change these references to your own local repository (at
1036- 192.168.0.2, or whatever IP address you're using). Note that if you
1037- leave this file as-is, the SUT will attempt to access the Internet,
1038- and so will require Internet access to fully provision itself.
1039-
1040-7. Using the MAAS web user interface, enlist and commission a new node.
1041- Alternatively, you can click "Release Node" on the node you tested
1042- earlier, then wait a few seconds and refresh the page.
1043-
1044-8. Go back to the Node View and deploy a node, as described earlier. Your
1045- SUT should turn on, do an installation, and then install the
1046- certification tools.
1047-
1048-9. You can observe the installation process by connecting a monitor to the
1049- node and viewing the messages in real-time as they're being produced.
1050-
1051-10. Once the machine finishes installation and reboots, you can SSH into
1052- its ``ubuntu`` account from the MAAS server and you should be able to
1053- run the command::
1054-
1055- $ canonical-certification-server
1056-
1057- Note, however, that this works only on 14.04 (GA and point release)
1058- versions. If you are certifying a 12.04 release, you must manually
1059- install the certification suite.
1060-
1061-For more on the certification process itself, see the Ubuntu Server
1062-Hardware Self-Testing Guide, which is available from
1063-https://certification.canonical.com.
1064-
1065-.. raw:: pdf
1066-
1067- PageBreak
1068-
1069-Appendix A: Performing a Partial Restore
1070-========================================
1071-
1072-If the MAAS server's support files (the PXE boot images and related
1073-files) become damaged, PXE-booting SUTs may fail. The SUT may fail to
1074-retrieve PXE boot images or the boot may fail with any number of
1075-symptoms later in the process. If you're unable to discover a cause and
1076-solution through less drastic means, one possible recovery procedure is
1077-to restore those files to a fresh state; however, be aware that this
1078-procedure will *destroy all existing node definitions.* Thus (and because
1079-the solution involves downloading new boot images, which can be
1080-time-consuming), you should attempt this solution only as a last resort.
1081-Steps 1 and 6 of the following procedure are the minimum required;
1082-steps 2-5 make for a more thorough cleansing of the system. The overall
1083-procedure is:
1084-
1085-#. Click the Clusters link in the MAAS server's web interface (to reach
1086- the server's ``/MAAS/clusters/`` page).
1087-
1088-#. Click the small trash can icon that appear near the right side of the
1089- page associated with your malfunctioning cluster when you mouse over it,
1090- and then confirm the operation. This will delete the cluster
1091- controller's definition.
1092-
1093-#. Delete the contents, including all subdirectories, of the
1094- ``/var/lib/maas/boot-resources`` directory on the portable server.
1095-
1096-#. In a shell, reconfigure the ``maas-cluster-controller`` and
1097- ``maas-region-controller`` packages::
1098-
1099- $ sudo dpkg-reconfigure maas-cluster-controller
1100- $ sudo dpkg-reconfigure maas-region-controller
1101-
1102- You should not need to adjust the default values.
1103-
1104-5. Reset the cluster controller's DHCP and DNS options, as described in
1105- step #10 under `Configuring the MAAS Web UI`_,
1106- earlier.
1107-
1108-6. If necessary or desired, adjust the images you want to import, as
1109- described in steps #6 and #7 under `Configuring the MAAS Web UI`_,
1110- earlier.
1111-
1112-This procedure should restore your ability to PXE-boot your SUTs.
1113-
1114-.. raw:: pdf
1115-
1116- PageBreak
1117-
1118-Appendix B: Glossary
1119-====================
1120-
1121-The following definitions apply to terms used in this document.
1122-
1123-1Gbps
1124- 1 Gigabit - Network speed for Gigabit Ethernet (1000Mbps).
1125-
1126-10Gbps
1127- 10 Gigabit - Network speed for 10 Gigabit Ethernet (10,000Mbps).
1128-
1129-BMC
1130- Baseboard Management Controller - A device in many server models
1131- that allows remote in and out of band management of hardware.
1132-
1133-DHCP
1134- Dynamic Host Control Protocol - method for providing IP addresses
1135- to the SUT and Targets.
1136-
1137-Greylist test
1138- A test that must be performed but will not affect the
1139- granting of a certified status.
1140-
1141-KVM
1142- Kernel Virtual Machine - A system for running virtual machines on
1143- Ubuntu Server.
1144-
1145-IPMI
1146- Intelligent Platform Management Interface - A technology for
1147- remotely connecting to a system to perform management functions.
1148-
1149-LAN
1150- Local Area Network - the network to which your SUT and Targets are
1151- connected. The LAN does not need to be Internet accessible (though that
1152- is preferable if possible).
1153-
1154-MAAS
1155- Metal as a Service - a Canonical product for provisioning systems
1156- quickly and easily.
1157-
1158-NIC
1159- Network Interface Card - the network device(s).
1160-
1161-NUC
1162- A small form-factor PC product from Intel.
1163-
1164-.. raw:: pdf
1165-
1166- PageBreak
1167-
1168-PXE
1169- Pre-boot Execution Environment - A technology that allows you to
1170- boot a system using remote images for easy deployment or network-based
1171- installation.
1172-
1173-RAID
1174- Redundant Array of Independent Disks - multiple disk storage
1175- providing redundancy, parity checking and data integrity.
1176-
1177-RAM
1178- Random Access Memory - System Memory.
1179-
1180-SAN
1181- Storage Area Network - Usually FibreChannel.
1182-
1183-SUT
1184- System Under Test - The machine you are testing for certification.
1185-
1186-Target
1187- A system or systems on the test LAN that the SUT can use for
1188- network testing. The Target must be running an iperf server, but
1189- otherwise does not need any special configuration. The MAAS server may
1190- double as the Target.
1191-
1192-Test case
1193- A test to be executed as part of the certification test
1194- suite. Test cases include things such as "CPU Stress" and "CPU
1195- Topology."
1196-
1197-Whitelist test
1198- A test that MUST pass for the SUT to be granted a
1199- certified status.
1200
1201=== removed file 'documentation/MAAS_Advanced_NUC_Installation_And_Configuration_Scripted.rst'
1202--- documentation/MAAS_Advanced_NUC_Installation_And_Configuration_Scripted.rst 2015-11-10 20:19:05 +0000
1203+++ documentation/MAAS_Advanced_NUC_Installation_And_Configuration_Scripted.rst 1970-01-01 00:00:00 +0000
1204@@ -1,870 +0,0 @@
1205-=============================================================
1206- MAAS Advanced NUC Installation and Configuration -- Scripted
1207-=============================================================
1208------------------------
1209- (The MANIACS Document)
1210------------------------
1211-
1212-.. include:: <isonum.txt>
1213-
1214-.. header:: |ubuntu_logo|
1215-
1216-.. |ubuntu_logo| image:: images/logo-ubuntu_su-white_orange-hex.png
1217- :scale: 20%
1218-
1219-.. footer:: |canonical_logo|
1220-
1221-.. |canonical_logo| image:: images/logo-canonical_no-tm-white-hex.png
1222- :scale: 10%
1223-
1224-.. raw:: pdf
1225-
1226- PageBreak oneColumn
1227-
1228-.. contents::
1229-
1230-.. raw:: pdf
1231-
1232- PageBreak
1233-
1234-Purpose
1235-=======
1236-
1237-This document describes how to install MAAS on a portable computer (such as
1238-an Intel NUC or laptop) so that you can deploy systems in a test
1239-environment as well as install the certification tools and perform
1240-certification testing. Consult the Ubuntu Certified Hardware Self-Testing
1241-Guide (available from https://certification.canonical.com) for detailed
1242-information on running the certification tests themselves.
1243-
1244-Note that this document is based on using the Ubuntu Desktop image for
1245-ease of use, and thus some bits, the Network Manager bits especially,
1246-may not apply if you're using Server without a desktop.
1247-
1248-A device (referred to generically as a "portable computer") configured
1249-as described here is not intended for general Internet use. Some
1250-settings relax security in the interest of ease of use, so you should
1251-limit use of the portable computer on the Internet at large.
1252-
1253-This document begins with information on the required hardware and then
1254-moves on to details about Ubuntu's network configuration and then the
1255-procedures for installing MAAS. (This document assumes that you know how
1256-to install Ubuntu.) Because the purpose of this document is to help you
1257-bring up a MAAS server for certification purposes, it then describes how
1258-to install additional software and configure MAAS to automatically
1259-install the certification packages on the system under test (SUT).
1260-
1261-Figure 1 illustrates the overall configuration that this document will
1262-help you create. This document describes configuration of the Portable
1263-Computer device in the figure. It presupposes the existence of a local
1264-LAN that the portable computer can use for external connections, as well
1265-as the availability of at least one SUT for testing at the end of the
1266-process. (Note that the Internet connection is required for initial
1267-setup, but a properly-configured MAAS server does not need this
1268-connection to bring up SUTs.) Once configured, you will be able to move
1269-the portable computer from one site to another, repopulating the MAAS
1270-LAN at each site.
1271-
1272-.. figure:: images/maniac-network.png
1273- :alt: This document describes configuring a server that manages its own
1274- subnet and connects to a wider network on another interface.
1275- :width: 100%
1276-
1277- Figure 1: Network structure in which the portable computer will reside
1278-
1279-Hardware Required
1280-=================
1281-
1282-Before beginning, you should ensure that you have the following
1283-hardware:
1284-
1285-* Portable computer
1286-
1287- - Ensure that the portable computer has two network interfaces. A
1288- laptop with both Ethernet and wi-fi should suffice; or you can use a
1289- USB network dongle to provide a second interface, particularly for a
1290- NUC.
1291-
1292- - Because testing sessions can last for hours, ensure that you have a
1293- power brick; you should *not* run on battery power!
1294-
1295- - You can install on a virtual machine in a more general-purpose
1296- computer, but you'll have to pay careful attention to the network and
1297- disk settings.
1298-
1299-* System Under Test (SUT) that supports one of the power types MAAS
1300- supports:
1301-
1302- - American Power Conversion (APC) PDU
1303- - Cisco UCS Manager
1304- - Digital Loggers, Inc. PDU
1305- - HP Moonshot - iLO Chassis Manager
1306- - HP Moonshot - iLO (IPMI)
1307- - IPMI
1308- - Intel AMT
1309- - Microsoft OCS - Chassis Manager
1310- - SeaMicro 15000
1311- - Sentry Switch CDU
1312- - VMWare
1313- - Virsh (virtual systems)
1314-
1315-* Small gigabit switch (8 ports should be enough)
1316-
1317- - For laptop with Wi-Fi: one Ethernet cable
1318-
1319- - For NUC or laptop with dongle: two Ethernet cables
1320-
1321- - For each SUT: one Ethernet cable for each NIC port including the BMC
1322-
1323-* Monitor and keyboard for SUT (helpful, but not strictly required)
1324-
1325-* Monitor, keyboard, and mouse for the MAAS system (a laptop's built-in
1326- devices should be sufficient)
1327-
1328-* Video cable for NUC (HDMI, Mini DisplayPort, or a converter like a
1329- MiniDP to VGA)
1330-
1331-* At least 1TB of disk space with which to mirror the Ubuntu archives,
1332- if desired (an external USB3 hard disk may be used for this, if
1333- necessary)
1334-
1335-Note that these hardware requirements are geared toward a typical
1336-testing environment. You may need to expand this list in some cases. For
1337-instance, if you test multiple servers simultaneously, you may need
1338-additional Ethernet ports.
1339-
1340-Installing and Configuring Ubuntu
1341-=================================
1342-
1343-Once you've assembled the basic hardware for your portable system, you can
1344-begin preparing it. The initial steps involve installing Ubuntu and setting
1345-up its most basic network settings:
1346-
1347-1. Install Ubuntu 14.04 (Trusty Tahr) to the portable system
1348-
1349- - The Desktop version of Ubuntu is recommended because it enables you
1350- to easily access the MAAS Dashboard locally without needing a third
1351- system.
1352-
1353- - If you choose to use the Server version, you will probably want to
1354- install the desktop on top of that as it simplifies MAAS access.
1355-
1356- - This guide assumes the use of Ubuntu 14.04. Although another version
1357- may work, some details will differ.
1358-
1359-#. Boot the portable computer and log in.
1360-
1361-#. Configure your *external* network port:
1362-
1363- - On a laptop, you can use the Wi-Fi (usually ``wlan0``) port as the
1364- external port.
1365-
1366- - If you need to use both a built-in Ethernet port and an Ethernet
1367- dongle, it's best to use the latter as your external port.
1368-
1369- - In most cases, no explicit configuration of the external port is
1370- necessary because the Ubuntu Desktop system will have set it up to
1371- use DHCP, which is appropriate. You can adjust it if necessary,
1372- though.
1373-
1374- - In theory, you can configure the external network either via
1375- ``/etc/network/interfaces`` or by using the Desktop's Network Manager
1376- tool.
1377-
1378-#. Configure your portable computer's *internal* port. This guide assumes
1379- use of ``eth0`` and a static IP address of 172.16.0.1/22 on this port.
1380-
1381- - If possible, configure the computer's built-in Ethernet port, rather
1382- than a plug-in dongle, as the internal port.
1383-
1384- - You can either edit ``/etc/network/interfaces`` or use the GUI
1385- Network tool in the System Settings panel to configure the internal
1386- port. An example ``/etc/network/interfaces`` configuration resembles
1387- the following::
1388-
1389- auto eth0
1390- iface eth0 inet static
1391- address 172.16.0.1
1392- broadcast 172.16.3.255
1393- netmask 255.255.252.0
1394-
1395- - If necessary or desired, you may use a different IP address on the
1396- *internal* port. If your portable computer will move from one
1397- *external* network to another, be sure to consider all its likely
1398- *external* addresses when deciding on its *internal* address and
1399- netmask.
1400-
1401- - Do not specify a gateway for the private internal LAN; doing so will
1402- create confusion when trying to access the Internet via the external
1403- port.
1404-
1405- - If you have issues installing packages, check ``route -n`` and make
1406- sure you don't have a gateway route to the private LAN.
1407-
1408- - Using a /22 or wider network is advisable for the internal network.
1409- When so configured, the setup script will use the final two of the
1410- four resulting octet ranges (for instance, 172.16.2.x and 172.16.3.x
1411- from 172.16.0.0/22) for DHCP addresses, leaving the first two ranges
1412- (for instance, 172.16.0.x and 172.16.1.x) for static addresses -- for
1413- instance, for the MAAS server itself, as well as anything else you
1414- want to assign a static IP address (perhaps your BMCs).
1415-
1416- - If you use a /22 or wider network, the MAAS server's address can be
1417- anything within the first two ranges (for instance, 172.16.0.x or
1418- 172.16.1.x), which are not handled by the computer's own DHCP server.
1419- If you use a /23 or /24 network, the MAAS server must be within the
1420- first nine addresses of that range (for instance, 172.16.0.1 through
1421- 172.16.0.9), since the rest of the range is assigned by MAAS's DHCP
1422- server.
1423-
1424- - Once you've finished configuring this network port, be sure to
1425- activate it. If you configured it by editing
1426- ``/etc/network/interfaces``, type ``sudo ifup eth0`` to activate it.
1427- (Depending on your starting configuration, you might need to type
1428- ``sudo ifdown eth0`` or bring it down via your GUI tools before
1429- bringing it up with its changed configuration.)
1430-
1431-#. If you plan to mirror the Ubuntu archives locally, ensure you have
1432- enough space in the ``/srv`` directory to hold your mirrors. As a
1433- general rule of thumb, you should set aside about 150GB per release. If
1434- necessary, mount an extra disk at ``/srv`` to hold your repository
1435- mirror.
1436-
1437-#. Update the software on your system to the latest versions available::
1438-
1439- $ sudo apt-get update
1440- $ sudo apt-get dist-upgrade
1441-
1442-#. Reboot the computer. This enables you to begin using your updated kernel
1443- (if it was updated) and ensures that your network settings will survive a
1444- reboot.
1445-
1446-.. _`Installing and Configuring MAAS`:
1447-
1448-Installing and Configuring MAAS
1449-===============================
1450-
1451-Installing MAAS on the computer is quite straightforward; you simply use
1452-APT. With MAAS installed, you can run the ``maniacs-setup`` script to
1453-configure MAAS for use in an Ubuntu certification environment.
1454-
1455-Installing MAAS
1456----------------
1457-
1458-Configuring MAAS is described in generic terms at
1459-`http://maas.ubuntu.com/docs/install.html <http://maas.ubuntu.com/docs/install.html>`_.
1460-The more specific procedure for using MAAS in certification testing is:
1461-
1462-#. Install the MAAS stable PPA
1463- (`https://launchpad.net/~maas/+archive/ubuntu/stable <https://launchpad.net/~maas/+archive/ubuntu/stable>`_)::
1464-
1465- $ sudo apt-add-repository ppa:maas/stable
1466-
1467- Currently (July, 2015), Ubuntu 14.04 installs MAAS 1.5 by default. This
1468- PPA holds version 1.8 of MAAS, which is the recommended version for
1469- certification testing. (MAAS 1.7 is also acceptable.) Version 1.8 will
1470- eventually become standard for Ubuntu 14.04, at which point this step
1471- will become unnecessary.
1472-
1473-#. Several scripts and configuration files, some of which are quite
1474- lengthy, are available in the ``maas-cert-server`` package in the
1475- hardware certification PPA. You can install the scripts and configuration files
1476- as follows::
1477-
1478- $ sudo apt-add-repository ppa:hardware-certification/public
1479- $ sudo apt-get update
1480- $ sudo apt-get install maas-cert-server
1481-
1482- As of version 0.1.2, the ``maas-cert-server`` package includes a
1483- dependency on MAAS, so installing ``maas-cert-server`` will also install
1484- MAAS, as well as all of MAAS's dependencies.
1485-
1486- Most of the ``maas-cert-server`` files will be installed in
1487- subdirectories of ``/usr/share/maas-cert-server``, although a few
1488- appear outside of that directory tree. (Subsequent steps describe how to
1489- use these files.)
1490-
1491-#. Verify that you've installed MAAS 1.8 from the PPA, rather than MAAS
1492- 1.5 or some other version::
1493-
1494- $ dpkg -p maas | grep Version
1495-
1496- If the wrong version is installed, fixing the problem (presumably a
1497- misconfigured PPA) and upgrading may work. If you upgrade from an
1498- earlier version of MAAS, be sure to select the option to upgrade all the
1499- configuration files when the package manager asks about this.
1500-
1501-#. Edit the ``/etc/maas-cert-server/config`` file to be sure that the
1502- variables it contains are correct. Specifically:
1503-
1504- - ``INTERNAL_NET`` must point to your *internal* network device
1505- (``eth0`` in this document).
1506-
1507- - ``EXTERNAL_NET`` must point to your *external* network device
1508- (``eth1`` in this documnt, but this might be ``wlan0`` if you're
1509- using a laptop).
1510-
1511- - Do not adjust other values without consulting with the Server
1512- Certification Team.
1513-
1514- - Note that there must *not* be spaces surrounding the equal signs
1515- (``=``) in the assignments!
1516-
1517-Running the Setup Script
1518-------------------------
1519-
1520-The certification script is called ``maniacs-setup``, and was installed as part
1521-of the ``maas-cert-server`` package. Running this script will set up the MAAS
1522-server with reasonable defaults for certification work; however, the script
1523-will also ask you a few questions along the way::
1524-
1525- $ sudo maniacs-setup
1526-
1527- ***************************************************************************
1528- * Identified networks:
1529- * INTERNAL: 172.16.0.1 on eth0
1530- * EXTERNAL: 192.168.25.143 on eth1
1531- *
1532- * Is this correct (Y/n)?
1533-
1534-Be sure your network assignments are correct at this point! If the script
1535-complains about a problem, such as an inability to identify an IP address
1536-or a default route being present on your internal network, go back and
1537-review both your network settings and the contents of your
1538-``/etc/maas-cert-server/config`` file to identify the cause and correct the
1539-problem.
1540-
1541-If you approve the settings, the script will display additional messages as
1542-it begins to configure the MAAS server. Some of these messages are the
1543-output of the programs it calls. For the most part this output can be
1544-ignored, but if a problem occurs, be sure to report it in detail, including
1545-the script's output.
1546-
1547-Note that at all prompts for a "Y/N" response, the default value is
1548-capitalized; if you press Enter, that default will be used.
1549-
1550-The next question acquires a password for the administrative account, which
1551-will have the same name as your default login name::
1552-
1553- ***************************************************************************
1554- * A MAAS administrative account with a name of ubuntu is being
1555- * created.
1556- *
1557- * Please enter a password for this account:
1558- * Please re-enter the password for verification:
1559-
1560-In most cases, you should enable NAT on your MAAS server; however, if
1561-official policy at the site where the server will be used forbids the use
1562-of NAT, you may opt to leave it disabled::
1563-
1564- ***************************************************************************
1565- * NAT enables this computer to connect the nodes it controls to the Internet
1566- * for direct downloads of package updates and to submit certification results
1567- * to C3.
1568- *
1569- * You can configure this computer to automatically start NAT. If you do so, you
1570- * can disable it temporarily by using the 'flushnat.sh' script or permanently
1571- * by removing the reference to /usr/sbin/startnat.sh from /etc/rc.local.
1572- *
1573- * Do you want to set up this computer to automatically enable NAT (Y/n)?
1574-
1575-Note that you can enable NAT on a one-time basis by running the
1576-``startnat.sh`` script and disable it by running the ``flushnat.sh``
1577-script. Both of these scripts come with the ``maas-cert-server`` package.
1578-
1579-If your work site has poor Internet connectivity or forbids outgoing
1580-connections, you must create a local mirror of the Ubuntu archives on your
1581-MAAS server. These archives will be stored in the ``/srv`` directory, but
1582-creating them takes a long time because of the amount of data to be
1583-downloaded -- about 150 GB per release. For comparison, HD video consumes
1584-1-8GiB per hour -- usually on the low end of that range for video streaming
1585-services. As should be clear, the result will be significant network demand
1586-that will degrade a typical residential DSL or cable connection for hours,
1587-and possibly exceed your monthly bandwidth allocation. If you want to defer
1588-creating a mirror, you should respond ``N`` to the following prompt, then
1589-re-launch ``maniacs-setup`` with the ``\-\-mirror-archives`` (or ``-m``)
1590-option later. In any event, you make your selection at the following
1591-prompt::
1592-
1593- ***************************************************************************
1594- * Mirroring an archive site is necessary if you'll be doing testing while
1595- * disconnected from the Internet, and is desirable if your test site has
1596- * poor Internet connectivity. Performing the mirroring operation takes
1597- * time and disk space, though -- about 150 GiB per release mirrored.
1598- * To defer this task, respond 'N' to the following question.
1599- *
1600- * Do you want to mirror an archive site for local use (y/N)? Y
1601-
1602-If you opt to mirror the archive, the script will ask you to verify the
1603-upstream mirror site::
1604-
1605- * Identified upstream archive is:
1606- * http://us.archive.ubuntu.com/ubuntu/
1607- *
1608- * Is this correct (Y/n)? y
1609-
1610-If you respond ``n`` to this question, the script asks you to specify
1611-another archive site. The script then asks you which Ubuntu releases to
1612-mirror::
1613-
1614- * Do you want to mirror precise (Y/n)? n
1615- * Do you want to mirror trusty (Y/n)? y
1616- * Do you want to mirror vivid (Y/n)? n
1617- * Do you want to mirror wily (Y/N)? n
1618-
1619-The list of releases changes as new versions become available and as old
1620-ones drop out of supported status.
1621-When the mirror process is done, you'll be asked if you want to configure
1622-the computer to
1623-automatically update its mirror every day, by modifying the
1624-``/etc/cron.d/apt-mirror`` file. If you do not opt for automatic daily
1625-updates, you can update your mirror at any time by typing ``sudo
1626-apt-mirror``.
1627-
1628-::
1629-
1630- * Set up cron to keep your mirror up-to-date (Y/n)? y
1631- * Cron should update your mirror every morning at 4 AM.
1632- * You can adjust /etc/cron.d/apt-mirror manually, if you like.
1633-
1634-Note that ``maniacs-setup`` configures the system to mirror AMD64, i386,
1635-and source repositories because all three are required by the default APT
1636-configuration. If you want to tweak the mirror configuration, you can do so
1637-by editing the ``/etc/apt/mirror.list`` file -- but do so *after* finishing
1638-with the ``maniacs-setup`` script, and then type ``sudo apt-mirror`` to
1639-pull in any new directories you've specified. You can also configure the
1640-computer to use its own local mirror, if you like::
1641-
1642- * Adjust this computer to use the local mirror (Y/n)? y
1643-
1644-The script then gives you the option to retrieve an image used for
1645-virtualization testing. If your site has good Internet connectivity, you
1646-may not need this image; but it's not a bad idea to have it on hand
1647-just in case. Note that the script skips this prompt if it detects an image
1648-already exists in ``/srv``. Although downloading the cloud image isn't
1649-nearly as time-consuming as mirroring the archives, it can take long
1650-enough that you may want to defer this action. You can download the
1651-cloud image later by launching ``maniacs-setup`` with the
1652-``\-\-download-virtualization-image`` (or ``-d``) option.
1653-
1654-::
1655-
1656- ***************************************************************************
1657- * An Ubuntu cloud image is required for virtualization tests. Having such an
1658- * image on your MAAS server can be convenient, but downloading it can take
1659- * a while (it's about 250MiB).
1660- *
1661- * To defer this task, respond 'N' to the following question.
1662- *
1663- * Do you want to copy a cloud image for the vitualization tests (Y/n)?
1664-
1665-You can customize the site that MAAS tells nodes to use for their
1666-repositories. If you mirrored a repository, the script points nodes to
1667-itself (via its internal IP address); but if you did not mirror a
1668-repository, the script should point your nodes to the same site used by the
1669-MAAS server itself. In either case, you can press the Enter key to accept
1670-the default or enter a new value::
1671-
1672- ***************************************************************************
1673- * MAAS tells nodes to look to an Ubuntu repository on the Internet. You
1674- * can customize that site by entering it here, or leave this field blank
1675- * to use the default value of http://172.16.0.1/ubuntu.
1676- *
1677- * Type your repository's URL, or press the Enter key:
1678-
1679-At this point, the script gives you the option of telling MAAS to begin
1680-importing its boot resources -- images it uses to enlist, commission, and
1681-start nodes. This process can take several minutes to over an hour to
1682-complete, so the script gives you the option of deferring this process::
1683-
1684- ***************************************************************************
1685- * MAAS requires boot resource images to be useful; however, importing them
1686- * can take a LONG time. You can perform this task now or defer it until
1687- * later (or do it manually with the MAAS web UI).
1688- *
1689- * Do you want to import boot resources now? (Y/n)
1690-
1691-If you choose to defer this process, MAAS may begin it automatically in the
1692-background. If this fails and you want to initiate it manually later, you
1693-can use the MAAS web UI or launch ``maniacs-setup`` with the
1694-``\-\-import-boot-resources`` (or ``-i``) option.
1695-
1696-When MAAS has finished importing boot resources, the
1697-script helps you import the point-release images used for certification;
1698-however, you are first asked which series you want to import::
1699-
1700- ***************************************************************************
1701- * Ubuntu hardware certification is done using point-release images. These
1702- * can take a LONG time to download. You can do so now or defer this task.
1703- *
1704- * Do you want to import point-release images now (Y/n)? y
1705- *
1706- * Do you want to import 15.10 (1 image) (y/N)? n
1707- * Do you want to import the 14.04 series (4 images) (Y/n)? y
1708- * Do you want to import the 12.04 series (6 images) (y/N)? y
1709-
1710-Whenever you respond ``Y`` to a question about a particular version or
1711-series, the script proceeds to download and register the images. (The
1712-relevant output has been omitted from the preceding example.) If an image
1713-is already installed, ``maniacs-setup`` skips that image. Certification
1714-uses only LTS images; however, non-LTS images, such as 15.10, may be made
1715-available for testing and as a way to "preview" the features of
1716-future LTS series.
1717-
1718-If you're running MAAS 1.8.2 or later, ``maniacs-setup`` registers the most
1719-recent point-release image in any series you download as the default OS for
1720-deployments.
1721-
1722-Again, this process can take a while, especially if you opt to import the
1723-12.04 images. If you want to skip this step for now and return to it, you
1724-can; you should re-launch ``maniacs-setup`` with its
1725-``\-\-update-point-releases`` (or ``-u``) option when you're ready to
1726-download these images.
1727-
1728-Finally, the script announces it's finished its work::
1729-
1730- ***************************************************************************
1731- * The maniacs-setup script has finished!
1732-
1733-In addition to setting the options for which it prompts, ``maniacs-setup``
1734-adjusts some other details of which you should be aware:
1735-
1736-- SSH keys are generated for your user account and added to the MAAS
1737- server. These keys enable you to log in to nodes that MAAS deploys from
1738- your regular account on the MAAS server.
1739-
1740-- Any keys in your ``~/.ssh/authorized_keys`` file on the portable are also
1741- added to the MAAS setup. Again, this simplifies login.
1742-
1743-- The portable computer's SSH server configuration is relaxed so that
1744- changed host keys do not block outgoing connections. This change is
1745- *insecure*, but is a practical necessity because your internal network's
1746- nodes will be redeployed regularly. You should keep this setting in mind
1747- and minimize your use of this computer to SSH to external sites.
1748-
1749-- MAAS is configured to tell nodes to install the Canonical Certification
1750- Suite whenever they're deployed. This detail increases deployment time
1751- compared to a generic MAAS installation.
1752-
1753-Checking the MAAS Configuration
1754--------------------------------
1755-
1756-At this point, MAAS should be installed and configured; however, it's worth
1757-verifying the most important options in the MAAS Web UI. You may also want
1758-to modify a few settings. To do so, follow these steps:
1759-
1760-#. Verify you can access the MAAS Dashboard:
1761-
1762- - Launch a browser and point it to \http://172.16.0.1/MAAS (your
1763- internal port).
1764-
1765- - You should also be able to access this by default on the
1766- external port, too.
1767-
1768- - If you provide the computer with a hostname in DNS or ``/etc/hosts``,
1769- you should be able to access it via that name, as well.
1770-
1771- - You should see a login prompt.
1772-
1773-#. Log in to the Dashboard using your regular username and the password you
1774- gave to the setup script.
1775-
1776-#. Click Images near the top of the MAAS web page. This page will show the Ubuntu images that are available on the server. The setup script imports a 14.04 image for AMD64, as well as custom images for every 14.04 point release. You may need to take additional actions in some cases:
1777-
1778- - If you see a blue circle next to an image, it did not import
1779- correctly. You can also check the Clusters page to verify the status
1780- of your image downloads. A successful image import will show Synced
1781- under Images.
1782-
1783- - If you need to support architectures other than AMD64, you must check
1784- that architecture and click Apply Changes. This process will probably
1785- take several minutes to complete.
1786-
1787- - If you need to import i386 point-release images, you must import them
1788- manually, as described in Appendix B.
1789-
1790-#. Click the Clusters link near the top of the web page so you can review
1791- the DHCP options:
1792-
1793- #. Click the cluster name for the cluster controller (Cluster Master in
1794- this example):
1795-
1796- .. image:: images/clusters-page.png
1797- :width: 98%
1798-
1799- #. Mouse over the *internal* (normally ``eth0``) network
1800- interface. (If you don't see your internal interface listed, click
1801- the "Add Interface" button to add it.) You should see a pair of
1802- icons appear, one to edit the interface and one to delete it. Click
1803- the former, then review the following items:
1804-
1805- - Be sure that "Interface" is set to your internal port and that
1806- "Management" is set to "DHCP and DNS."
1807-
1808- - Review the various IP addresses and netmasks.
1809-
1810- - Click "Save Interface" if you made any changes.
1811-
1812-#. Click Settings near the top of the page to load the MAAS Settings page,
1813- where you review several miscellaneous MAAS details. If you change any
1814- settings, be sure to click the associated "Save" button within that
1815- section. Unfortunately, each save button is section-specific and won't
1816- save changes made in other sections of that page.
1817-
1818-Testing the MAAS Server
1819-=======================
1820-
1821-At this point, your MAAS server should be set up and configured correctly.
1822-To test it, follow these steps:
1823-
1824-#. Prepare a computer by configuring it to boot via PXE. This computer
1825- need not be a computer you plan to certify; anything that can
1826- PXE-boot should work, although to fully test the MAAS server, the
1827- test system should provide IPMI or some other power-control tool that
1828- MAAS supports.
1829-
1830-#. Connect the test computer to the portable computer's *internal* network
1831- and power it on.
1832-
1833- - The test computer should PXE-boot from the portable MAAS computer.
1834-
1835- - This first boot should be to the enlistment image, which provides
1836- some very basic information to the MAAS server. Once the node powers
1837- itself off you should see it listed in the MAAS nodes list
1838- (\http://localhost/MAAS/#/nodes/ or, on MAAS 1.7,
1839- \http://localhost/MAAS/nodes/) with a Status field of "New."
1840-
1841- - Note that you will have to refresh the nodes list as it does not
1842- refresh itself to list new data.
1843-
1844-#. Click on the node's hostname to view the node's summary page.
1845-
1846-#. If desired, click the node's hostname near the upper-left corner of the
1847- page. This will enable you to change the hostname to something
1848- descriptive, such as the computer's model number. Click "Save" when
1849- you've made your changes.
1850-
1851-#. If necessary, click "Edit" in the Machine Summary section to change the
1852- architecture of the machine. Click "Save Changes" when you're done.
1853-
1854-#. If necessary, change the Power Type in the Power section of the page.
1855- This may necessitate setting an IP address, MAC address, password, or
1856- other information, depending on the power control technology in use.
1857- Click "Save Changes" when you're done.
1858-
1859-#. Click "Take Action" near the top-right corner of the page, followed by
1860- "Commission Node" from the resulting drop-down menu. You must then click
1861- "Go."
1862-
1863- - The node should power on again. This time you'll see it PXE-boot the
1864- commissioning image. Note that if your test system lacks a BMC or
1865- other means to remotely control its power, you must manually power it
1866- on.
1867-
1868- - The node should do a bit more work this time before powering off
1869- again.
1870-
1871- - Once it's done, the UI will show a Status of "Ready."
1872-
1873-#. Once the system powers off after commissioning, click "Take Action"
1874- followed by "Deploy." You must then click "Go" to confirm this action.
1875-
1876- - The node should power on again (or you will have to control it
1877- manually if it lacks a BMC). This time it will take longer to finish
1878- working, as MAAS will install Ubuntu and the certification suite on
1879- the system.
1880-
1881- - Once it's done, the computer will reboot into its installed image.
1882-
1883- - Log into the node from the MAAS server by using SSH, as in ``ssh
1884- testnode`` if you've given the node the name ``testnode``.
1885-
1886- - In the node, type ``canonical-certification-server``. The
1887- certification suite software should run. You can type Ctrl+C to exit;
1888- at this point, it's sufficient to know that it installed correctly.
1889-
1890-If any of these steps fail, you may have run into a MAAS bug; your test
1891-computer may have a buggy PXE, IPMI, or other subsystem; or you may have
1892-misconfigured something in the MAAS setup. You may want to review the
1893-preceding sections to verify that you configured everything correctly.
1894-To help in debugging problems, the node status page includes a section
1895-entitled Latest Node Events with a summary of the last few events
1896-related to the node. (You must refresh the page to see new events.)
1897-
1898-.. raw:: pdf
1899-
1900- PageBreak
1901-
1902-Appendix A: Updating Fixed Point Release Images
1903-===============================================
1904-
1905-From time to time, Canonical updates the LTS versions of Ubuntu with new
1906-point releases, such as 14.04.1, 14.04.2, and so on. Because you must run
1907-the certification tests on the latest point release, updating your MAAS
1908-server with the latest point releases will become necessary, sooner or
1909-later. This task can be accomplished with MAAS 1.7 or 1.8 by installing
1910-custom images.
1911-
1912-The ``maniacs-setup`` script automatically downloads and installs all the
1913-available point-release images at the time you first run it. After a new
1914-point release is made, you can re-run the script with the
1915-``\-\-update-point-releases`` (or ``-u``) option to have the script install
1916-the new release::
1917-
1918- $ sudo apt-get install maas-cert-server
1919- $ sudo maniacs-setup --update-point-releases
1920-
1921-The script will skip most of the setup steps and proceed to asking you
1922-which point-release images to download and install. When you select a
1923-series, only those point-release images that have not yet been installed
1924-from that series will be downloaded. Note that if you're running
1925-``maas-cert-server`` version 0.2.9 or earlier, you should update to the
1926-latest version before updating your point releases. Version 0.2.10
1927-introduced the ability to dynamically determine what Ubuntu point-release
1928-images are available for download; earlier versions used a hard-coded list,
1929-and so will miss updates beyond Ubuntu 14.04.3.
1930-
1931-If a particular point release is giving you problems, you can delete it
1932-using the MAAS web UI and then update your point-release images as just
1933-described; this will refresh the image to the latest available version.
1934-Similarly, if the Server Certification Team releases new images, you should
1935-first delete the old ones using the web UI and then update your point
1936-releases.
1937-
1938-Note that before you can install a custom image for any given architecture,
1939-you must have first imported at least one image for that architecture via
1940-the conventional means. The ``maniacs-setup`` script detects whether you've
1941-installed the standard i386 images and will install i386 point-release
1942-images if and only if the standard i386 images are already installed.
1943-Currently, only AMD64 and i386 point-release images are available.
1944-
1945-
1946-.. raw:: pdf
1947-
1948- PageBreak
1949-
1950-Appendix B: Adding i386 Support
1951-===============================
1952-
1953-By default, the ``maniacs-setup`` script supports only AMD64 (64-bit,
1954-x86-64) nodes. (If you created a local mirror, it includes i386/x86
1955-binaries because they're needed by some 64-bit packages.) If you expect to
1956-run certification tests on i386 (32-bit, x86) computers, though, you must
1957-add support for such systems in MAAS:
1958-
1959-#. In the MAAS web UI, click the Images tab.
1960-
1961-#. Select "i386" in the "Architecture" column.
1962-
1963-#. Click "Apply changes." The standard MAAS i386 images will download. This
1964- process can take several minutes, and perhaps over an hour on a slow
1965- Internet connection.
1966-
1967-#. Re-run the ``maniacs-setup`` script, but add the
1968- ``\-\-update-point-releases`` option to the script, as described in
1969- Appendix A. This will cause the script to download and add the
1970- point-release images for i386 systems.
1971-
1972-That's it. You can add support for ppc64el, ARM64, or other architectures
1973-in a similar way; however, there are currently no point-release images for
1974-these architectures. Please consult the Server Certification Team if you
1975-need to certify systems using these CPUs.
1976-
1977-.. raw:: pdf
1978-
1979- PageBreak
1980-
1981-Appendix C: Performing a Partial Restore
1982-========================================
1983-
1984-If the MAAS server's support files (the PXE boot images and related
1985-files) become damaged, PXE-booting SUTs may fail. The SUT may fail to
1986-retrieve PXE boot images or the boot may fail with any number of
1987-symptoms later in the process. If you're unable to discover a cause and
1988-solution through less drastic means, one possible recovery procedure is
1989-to restore those files to a fresh state; however, be aware that this
1990-procedure will *destroy all existing node definitions.* Thus (and because
1991-the solution involves downloading new boot images, which can be
1992-time-consuming), you should attempt this solution only as a last resort.
1993-Steps 1 and 6-7 of the following procedure are the minimum required;
1994-steps 2-5 make for a more thorough cleansing of the system. The overall
1995-procedure is:
1996-
1997-#. Click the Clusters link in the MAAS server's web interface (to reach
1998- the server's ``/MAAS/clusters/`` page).
1999-
2000-#. Click the small trash can icon that appear near the right side of the
2001- page associated with your malfunctioning cluster when you mouse over it,
2002- and then confirm the operation. This will delete the cluster
2003- controller's definition.
2004-
2005-#. Delete the contents, including all subdirectories, of the
2006- ``/var/lib/maas/boot-resources`` directory on the portable server.
2007-
2008-#. In a shell, reconfigure the ``maas-cluster-controller`` and
2009- ``maas-region-controller`` packages::
2010-
2011- $ sudo dpkg-reconfigure maas-cluster-controller
2012- $ sudo dpkg-reconfigure maas-region-controller
2013-
2014- You should not need to adjust the default values.
2015-
2016-5. Reset the cluster controller's DHCP and DNS options.
2017-
2018-6. If necessary or desired, adjust the images you want to import.
2019-
2020-7. Re-run the ``maniacs-setup`` script with the
2021- ``\-\-update-point-releases`` option, as described in Appendix A, to
2022- refresh your point-release images.
2023-
2024-This procedure should restore your ability to PXE-boot your SUTs.
2025-
2026-.. raw:: pdf
2027-
2028- PageBreak
2029-
2030-Appendix D: Glossary
2031-====================
2032-
2033-The following definitions apply to terms used in this document.
2034-
2035-1Gbps
2036- 1 Gigabit - Network speed for Gigabit Ethernet (1000Mbps).
2037-
2038-10Gbps
2039- 10 Gigabit - Network speed for 10 Gigabit Ethernet (10,000Mbps).
2040-
2041-BMC
2042- Baseboard Management Controller -- A device in many server models
2043- that allows remote in- and out-of-band management of hardware.
2044-
2045-DHCP
2046- Dynamic Host Control Protocol -- method for providing IP addresses
2047- to the SUTs.
2048-
2049-IPMI
2050- Intelligent Platform Management Interface -- A technology for
2051- remotely connecting to a system to perform management functions.
2052-
2053-LAN
2054- Local Area Network -- the network to which your SUTs are connected. The
2055- LAN does not need to be Internet accessible (though that is preferable if
2056- possible).
2057-
2058-MAAS
2059- Metal as a Service -- a Canonical product for provisioning systems
2060- quickly and easily.
2061-
2062-NIC
2063- Network Interface Card -- the network device(s).
2064-
2065-NUC
2066- A small form-factor PC product from Intel.
2067-
2068-PXE
2069- Pre-boot Execution Environment -- A technology that allows you to
2070- boot a system using remote images for easy deployment or network-based
2071- installation.
2072-
2073-SUT
2074- System Under Test -- The machine you are testing for certification.
2075
2076=== removed file 'documentation/Makefile'
2077--- documentation/Makefile 2015-07-17 19:42:06 +0000
2078+++ documentation/Makefile 1970-01-01 00:00:00 +0000
2079@@ -1,36 +0,0 @@
2080-SHELL = /bin/sh
2081-RST2PDF=rst2pdf
2082-RST2HTML=rst2html
2083-DOC_NAMES=Self-Test_Guide MAAS_Advanced_NUC_Installation_And_Configuration MAAS_Advanced_NUC_Installation_And_Configuration_Scripted
2084-HTML_NAMES=$(DOC_NAMES:=.html)
2085-PDF_NAMES=$(DOC_NAMES:=.pdf)
2086-
2087-.SUFFIXES:
2088-.SUFFIXES: .pdf .rst
2089-
2090-all: html pdf
2091-
2092-html: $(HTML_NAMES)
2093-
2094-pdf: $(PDF_NAMES)
2095-
2096-%.pdf: %.rst
2097- $(RST2PDF) --smart-quotes 1 -s styles/cert-doc.style $< -o $@
2098-
2099-%.html: %.rst
2100- $(RST2HTML) --smart-quotes=yes $< $@
2101-
2102-maniac: MAAS_Advanced_NUC_Installation_And_Configuration.pdf
2103-
2104-maniacs: MAAS_Advanced_NUC_Installation_And_Configuration_Scripted.pdf
2105-
2106-stg: Self-Test_Guide.pdf
2107-
2108-maniach: MAAS_Advanced_NUC_Installation_And_Configuration.html
2109-
2110-maniacsh: MAAS_Advanced_NUC_Installation_And_Configuration_Scripted.html
2111-
2112-stgh: Self-Test_Guide.html
2113-
2114-clean:
2115- rm -f *.pdf *.html
2116
2117=== removed file 'documentation/README'
2118--- documentation/README 2015-07-17 19:42:06 +0000
2119+++ documentation/README 1970-01-01 00:00:00 +0000
2120@@ -1,86 +0,0 @@
2121-=========================================
2122- Server Certification Team Documentation
2123-=========================================
2124-
2125-Overview
2126-========
2127-
2128-This directory contains documentation for the Server Certification team in
2129-reStructuredText format. Specific documents are:
2130-
2131-* MAAS_Advanced_NUC_Installation_And_Configuration.rst -- The MANIAC
2132- document
2133-* MAAS_Advanced_NUC_Installation_And_Configuration_Scripted.rst -- The
2134- MANIACS (MANIAC - Scripted) document
2135-* Self-Test_Guide.rst -- The Server Self-Test Guide
2136-
2137-Support files and directories are:
2138-
2139-* Makefile -- A Makefile to generate .pdf and .html files from the .rst
2140- files.
2141-* images/ -- A subdirectory holding images. Note that some images are
2142- stored in both source form (.fig, .xcf, etc.) and the .png files that are
2143- mostly referenced in the .rst files.
2144-* styles/ -- Style files used in generating PDFs. Currently has just one
2145- style.
2146-
2147-Converting from .rst to .pdf form requires the ``rst2pdf`` package::
2148-
2149- sudo apt-get install rst2pdf
2150-
2151-Creating HTML and PDF Files
2152-===========================
2153-
2154-PDFs and HTML files can be generated by way of the ``make`` utility, as
2155-in::
2156-
2157- make stg
2158-
2159-This example builds the Self-Test Guide in PDF form. The complete set of
2160-targets are:
2161-
2162-* ``stg`` -- Builds the Self-Test Guide as a PDF
2163-* ``maniac`` -- Builds the MANIAC document as a PDF
2164-* ``maniacs`` -- Builds the MANIACS document as a PDF
2165-* ``stgh`` -- Builds the Self-Test Guide as an HTML file
2166-* ``maniach`` -- Builds the MANIAC document as an HTML file
2167-* ``maniacsh`` -- Builds the MANIACS document as an HTML file
2168-* ``pdf`` -- Builds all three documents as PDFs
2169-* ``html`` -- Builds all three documents as HTML files
2170-* ``all`` (default) -- Builds all three documents as both PDFs and as
2171- HTML files
2172-* ``clean`` -- Removes all ``.pdf`` and ``.html`` files
2173-
2174-Note that the primary intended output format is PDF; HTML output is rough
2175-at this time (July, 2015).
2176-
2177-Styles and Formatting
2178-=====================
2179-
2180-The general style for the document is based on the Canonical whitepaper
2181-template provided by Magdalena Mirowicz (magdalena.mirowicz@canonical.com)
2182-in March of 2015. This template was not directly usable because it was in
2183-ODF format and used a two-column layout. I've tried to stick close to the
2184-ODF template in reStructuredText, but there are some differences:
2185-
2186-* We're using a single-column layout.
2187-* Our default font is a darker shade of gray.
2188-* Our document uses letter-size paper rather than A4, since most of our
2189- readers are in the US.
2190-* Headers and footers were replicated "by eye" and so are not precise
2191- conversions.
2192-* The rst2pdf program creates a Contents list that is NOT capitalized
2193- (as in the sample template) and that provides hyperlinks to the
2194- referenced sections.
2195-
2196-Editing Tips
2197-============
2198-
2199-Some tips when editing the .rst files:
2200-
2201-* Use your favorite text editor.
2202-* If necessary, you can insert page breaks manually; but use this feature
2203- only if absolutely necessary.
2204-* Once a year, the images/cover-background.xcf file must be edited and
2205- re-exported to cover-background.png to update the copyright date that
2206- appears on the cover page.
2207
2208=== removed file 'documentation/Self-Test_Guide.rst'
2209--- documentation/Self-Test_Guide.rst 2015-07-17 19:42:06 +0000
2210+++ documentation/Self-Test_Guide.rst 1970-01-01 00:00:00 +0000
2211@@ -1,1255 +0,0 @@
2212-=================================================================
2213- Ubuntu Server Certified Hardware Self-Testing Guide (14.04 LTS)
2214-=================================================================
2215-
2216-.. header:: |ubuntu_logo|
2217-
2218-.. |ubuntu_logo| image:: images/logo-ubuntu_su-white_orange-hex.png
2219- :scale: 20%
2220-
2221-.. footer:: |canonical_logo|
2222-
2223-.. |canonical_logo| image:: images/logo-canonical_no-tm-white-hex.png
2224- :scale: 10%
2225-
2226-.. raw:: pdf
2227-
2228- PageBreak oneColumn
2229-
2230-.. contents::
2231-
2232-.. raw:: pdf
2233-
2234- PageBreak
2235-
2236-Introduction
2237-============
2238-
2239-The aim of this document is to provide the information needed to certify
2240-a server on-site using the Canonical Server Test Suite without requiring
2241-an Internet connection.
2242-
2243-Glossary
2244-========
2245-
2246-The following definitions apply to terms used in this document.
2247-
2248-1Gbps
2249- 1 Gigabit per second -- Network speed for Gigabit Ethernet (1000Mbps).
2250-
2251-10Gbps
2252- 10 Gigabits per second -- Network speed for 10 Gigabit Ethernet
2253- (10,000Mbps).
2254-
2255-BMC
2256- Baseboard Management Controller -- A device in many server models
2257- that enables remote in- and out-of-band management of hardware.
2258-
2259-DHCP
2260- Dynamic Host Control Protocol -- A method for providing IP
2261- addresses to the SUT and Targets.
2262-
2263-Greylist test
2264- A test that must be performed but will not affect the
2265- granting of a certified status.
2266-
2267-KVM
2268- Kernel Virtual Machine -- A system for running virtual machines on
2269- Ubuntu Server.
2270-
2271-IPMI
2272- Intelligent Platform Management Interface -- A technology for
2273- remotely connecting to a computer to perform management functions.
2274-
2275-JBOD
2276- Just a bunch of disks -- A non-RAID disk configuration.
2277-
2278-LAN
2279- Local Area Network -- The network to which your SUT and Targets are
2280- connected. The LAN does not need to be Internet accessible (though that
2281- is preferable if possible).
2282-
2283-.. raw:: pdf
2284-
2285- PageBreak
2286-
2287-MAAS
2288- Metal as a Service -- A Canonical product for provisioning systems
2289- quickly and easily.
2290-
2291-NIC
2292- Network Interface Card -- The network device(s).
2293-
2294-PXE
2295- Pre-boot Execution Environment -- A technology that enables you to
2296- boot a computer using remote images for easy deployment or network-based
2297- installation.
2298-
2299-RAID
2300- Redundant Array of Independent Disks - Multi-disk storage
2301- providing redundancy, parity checking, and data integrity.
2302-
2303-RAM
2304- Random Access Memory -- System memory.
2305-
2306-SAN
2307- Storage Area Network -- Usually FibreChannel.
2308-
2309-SUT
2310- System Under Test -- The machine you are testing for certification.
2311-
2312-Target
2313- A computer on the test LAN that the SUT can use for network testing. The
2314- Target must be running an ``iperf`` server, but otherwise does not need
2315- any special configuration. The MAAS server may double as the Target.
2316-
2317-Test case
2318- A test to be executed as part of the certification test
2319- suite. Test cases include things such as "CPU Stress" and "CPU
2320- Topology."
2321-
2322-Whitelist test
2323- A test that *must* pass for the SUT to be granted a certified status.
2324-
2325-Overview of the Certification Process
2326-=====================================
2327-
2328-The certification process has certain prerequisites and procedures with
2329-which you should be familiar before beginning. Specifically, you should
2330-be aware of hardware requirements and the needs of the network test
2331-environment. There are steps you should perform before running the
2332-certification tests and before uploading the results. The following
2333-sub-sections briefly describe these requirements. Detailed descriptions
2334-appear later in this document.
2335-
2336-Hardware Requirements
2337----------------------
2338-
2339-- SUTs must contain at least 4GiB of RAM and one hard disk, but using
2340- the maximum amount of RAM and the maximum number of disks is
2341- preferable. Likewise, if configurable, using the maximum number of
2342- CPUs is desirable.
2343-
2344-- CPUs should support virtualization (VMX/SVM), when supported by CPU
2345- architecture.
2346-
2347-- All firmware (BIOS/UEFI, NIC, storage controller, etc) should be
2348- shipping level, *not* development level.
2349-
2350-- A monitor and keyboard for the SUT are helpful because they will
2351- enable you to monitor its activities. If necessary, however,
2352- certification can be done without these items.
2353-
2354-Network Test Environment
2355-------------------------
2356-
2357-- In addition to the SUT, the network must contain at least one other
2358- machine, which will run MAAS and an ``iperf`` server. The MAAS Advanced
2359- NUC Installation and Configuration (MANIAC) document (available from
2360- https://certification.canonical.com) describes how to configure a MAAS
2361- server. This server may be a standard part of the testing network or
2362- something you bring with you for testing purposes alone. A laptop or a
2363- small portable computer such as an Intel NUC is sufficient. MAAS version
2364- 1.7 or later is strongly preferred for certification work; the older
2365- MAAS 1.5 lacks certain features that are becoming increasingly
2366- important. This document describes use of MAAS 1.8. If you use MAAS 1.7,
2367- some procedures will differ slightly.
2368-
2369-- The MAAS server computer should run Ubuntu 14.04 (Trusty Tahr), and
2370- should be configured to deliver Ubuntu 14.04 images to its clients.
2371- Testing with fixed point releases, as described in the "Configuring
2372- MAAS to Deliver Fixed Point Releases" section of the MANIAC document,
2373- is required.
2374-
2375-- Ideally, the network should have few or no other computers;
2376- extraneous network traffic can negatively impact the network tests.
2377-
2378-- Ideally, the MAAS server system should handle DNS and DHCP for the
2379- network. If other computers manage these tasks, be sure that they're
2380- configured to work with the MAAS server so that the SUT obtains its
2381- PXE-boot images from the MAAS server.
2382-
2383-- Network cabling, switches, and the ``iperf`` server should be capable of
2384- at least the SUT's best speed. For instance, if the SUT has 1Gbps
2385- Ethernet, the other network components should be capable of 1Gbps or
2386- faster speeds. If the local network used for testing is less capable
2387- than the best network interfaces on the SUT, those interfaces must be
2388- tested later on a more-capable network.
2389-
2390-- If desired, the MAAS server may be run inside a virtual machine;
2391- however, it is advisable to run the ``iperf`` server on "real" hardware
2392- so as to minimize the risk of network tests failing because of
2393- virtualization issues.
2394-
2395-Before Running Test Cases
2396--------------------------
2397-
2398-- The SUT must be properly configured and cabled.
2399-
2400-- The SUT must have Ubuntu 14.04 installed on it. (This must be done via
2401- MAAS.) See the `Installing Ubuntu on the System`_ section below for
2402- details on how to do this.
2403-
2404-- The ``canonical-certification-server`` package must be installed on the
2405- SUT together with all its dependencies. (This will normally be done via
2406- MAAS.) For more information about how to get all the packages, please
2407- refer to the `Installing the Server Test Suite Packages`_ section below.
2408-
2409-- Be sure to have all the items described in the `Equipment to
2410- Bring`_ section below.
2411-
2412-- Some manual configuration will be necessary to perform
2413- network testing. See the `Installing Ubuntu on the
2414- System`_ section below.
2415-
2416-Before Uploading Test Case Results
2417-----------------------------------
2418-
2419-Prior to uploading results to Canonical's certification site, you must
2420-handle some preliminary tasks:
2421-
2422-- You will need an account at the certification web site,
2423- https://certification.canonical.com.
2424-
2425- - The certification web site is the location where all the test case
2426- results will be uploaded once your testing session has finished.
2427-
2428- - *If you do not have an account for your company on the private
2429- certification web site, please contact your account manager who will
2430- work with the Server Certification Team to establish the account.*
2431-
2432-- You must create a hardware entry (unless one already exists for the
2433- SUT) at the certification web site with a secure ID.
2434-
2435- - The secure ID is a string made from 15 alphanumeric characters that
2436- is used to make sure that only authorized parties upload results to
2437- the site and also to associate the results to the hardware being
2438- tested. This can be found on the hardware entry page on the
2439- Certification web site:
2440-
2441- .. image:: images/secure_id.png
2442- :alt: The Secure ID can be obtained from the Ceritification web site.
2443- :align: left
2444- :width: 50%
2445-
2446- - For more information on creating the hardware entry, please see
2447- `Creating a Hardware Entry on C3` below.
2448-
2449-- If the SUT lacks Internet access, the package
2450- ``canonical-certification-submit`` should be installed on the system
2451- from which you plan to submit results. Please see the section below
2452- titled `Manually Uploading Test Results to the Certification Site`_ for
2453- more information on this topic.
2454-
2455-Initial Setup
2456-=============
2457-
2458-Before you certify the hardware, you must perform some initial setup
2459-steps. These steps are preparing the hardware you'll bring, configuring
2460-the SUT for testing, installing Ubuntu, and installing the Server Test
2461-Suite.
2462-
2463-Equipment to Bring
2464-------------------
2465-
2466-The requirements for running the tests for a server are minimal. Ensure
2467-that you have:
2468-
2469-- A writable USB stick with enough free space (> 256MB). It must contain a
2470- *single partition* with a *writable FAT* filesystem on it. If you need
2471- to test more than one computer then *bring one USB stick per system*.
2472- Note that a USB stick with multiple partitions may cause problems, so if
2473- necessary you should repartitition your device to have a single
2474- partition.
2475-
2476-- A data CD with some files written to it. This is required to test the
2477- system's optical drive read capabilities. Note that a movie DVD or an
2478- audio CD won't be useful in this case, as they are not in the right
2479- format for the test. If you need to test more than one computer then
2480- *bring one medium per system*.
2481-
2482-- A computer to function as a MAAS server and ``iperf`` target on the test
2483- LAN. This server will provision the SUT. The MAAS server can be a normal
2484- part of the test LAN or can be brought in specifically for testing SUTs
2485- on the test LAN. (Note, however, that the MAAS server for certification
2486- testing should ideally be configured to automatically install the Server
2487- Test Suite on the SUT, which will not be the case for a "generic" MAAS
2488- server.)
2489-
2490-- A USB flash drive that holds the Server Test Suite software. (This is a
2491- precautionary measure in case MAAS can't install the Server Test Suite
2492- packages and your LAN lacks Internet access.) The `Bringing the Server
2493- Test Suite Packages With You`_ section of Appendix A describes how to
2494- obtain the software.
2495-
2496-Hardware Setup
2497---------------
2498-
2499-The following should be considered the minimum requirements for setting
2500-up the SUT and test environment:
2501-
2502-- Minimum loadout
2503-
2504- - Minimum of 4GiB RAM
2505-
2506- - 1 HDD (2 with minimal RAID)
2507-
2508- - 1 CPU of a supported type
2509-
2510-- Recommended (preferred) loadout
2511-
2512- - Maximum supported number of HDDs or SSDs, especially if you can
2513- configure multiple RAID levels (e.g. 2 for RAID 0, 3 for RAID 5, and
2514- 6 for RAID 50)
2515-
2516- - Maximum amount of supported RAM
2517-
2518- - Maximum number of supported CPUs
2519-
2520-- The SUT should not contain any extraneous PCI devices that are not
2521- part of the certification.
2522-
2523- - This includes things like network, SAN and iSCSI cards.
2524-
2525- - Hardware RAID cards are allowed if they are used to provide RAID
2526- services to the SUT's onboard storage.
2527-
2528-- The SUT should be running a release level BIOS/UEFI configured using
2529- factory default settings, with the following exceptions:
2530-
2531- - If the hardware virtualization options in the BIOS/UEFI are not
2532- enabled, enable them, save the settings and allow the SUT to reboot.
2533-
2534- - The SUT must be configured to PXE-boot by default.
2535-
2536-- Storage should be properly configured.
2537-
2538- - If the SUT is to be tested using RAID, then the proper hardware RAID
2539- configuration should be set up prior to testing.
2540-
2541- - Software RAID, including firmware-supported software RAID (aka "fake
2542- RAID") should *not* be used. If hardware RAID is not available,
2543- configure the server for JBOD.
2544-
2545- - Any additional HDDs or logical drives should be partitioned and
2546- mounted prior to testing. Partitions on those additional HDDs should,
2547- preferably, be a single partition that spans the entire disk.
2548-
2549- - Some computers may have problems booting from disks over 2TiB in
2550- size. If the SUT fails for this reason, it may pass with smaller
2551- disks (or a smaller RAID array). In some cases, configuring the SUT
2552- to boot in UEFI mode may also solve this problem; but consult the
2553- Canonical Certification Team before changing firmware settings to
2554- overcome such a problem.
2555-
2556-- If possible, as many processors as the SUT will support should be
2557- installed.
2558-
2559- - Note that systems that ship with processors from different families
2560- (e.g Sandy Bridge vs. Haswell) will require extra testing.
2561-
2562- - CPU speed bumps and die shrinks do not require extra testing.
2563-
2564-- Disks with 4,096-byte *logical* sector sizes may require booting in
2565- EFI/UEFI mode, and MAAS's support for this is still new, so be alert to
2566- potential problems. For instance, some computers support EFI-mode
2567- booting but not EFI-mode PXE-booting. Note that disks with 4,096-byte
2568- *physical* sector sizes are fine, so long as the disk's firmware
2569- translates those sectors into 512-byte logical sectors.
2570-
2571-- The test environment should have a working network setup. Internet
2572- access is not required, and testing should work on any private or
2573- segregated LAN.
2574-
2575- - If possible, the test LAN's speed should match or exceed the network
2576- speed of the SUT. For instance, a SUT with 1Gbps onboard Ethernet
2577- should be connected to a LAN capable of at least 1Gbps and a system
2578- with 10Gbps Ethernet should be connected to a LAN capable of at least
2579- 10Gbps. Connecting a SUT to a network with greater network speed is
2580- acceptable.
2581-
2582- - If the primary test network cannot meet these requirements,
2583- re-running the network tests in an environment that does match these
2584- requirements will be necessary.
2585-
2586- - Every network port must be cabled to the LAN and properly configured
2587- with either DHCP or static addressing. If a SUT has 4 NIC ports, then
2588- all 4 must be connected to the LAN.
2589-
2590- - It is very strongly recommended that SUT and Target machines be on a
2591- clean network (that is, one that is not full of other traffic), as
2592- extraneous network traffic could impact the network testing results.
2593-
2594-- The test LAN must have a working MAAS server that can provision and run
2595- the tests on the SUT. The MAAS Advanced NUC Installation and
2596- Configuration (MANIAC) document, available at
2597- https://certification.canonical.com, describes the basics of the MAAS
2598- setup, but you may need to refer to additional documentation to complete
2599- the task if you're not already familiar with MAAS.
2600-
2601-- The test LAN must have one system available to act as a Target for
2602- network testing with ``iperf``. Note that accessing an ``iperf`` server
2603- that's reachable only via a router may not work, because routing tables
2604- are temporarily lost during network testing. The ``iperf`` server is
2605- normally the same as the MAAS server, but this does not need to be the
2606- case. If the SUT has a faster network interface than the MAAS server,
2607- you should set up another computer that matches the SUT's network
2608- interface speed to function as an ``iperf`` server.
2609-
2610-- The SUT's BMC, if present, may be configured via DHCP or with a static
2611- IP address. MAAS will set up its own BMC user account (``maas``) when
2612- enlisting the SUT.
2613-
2614-Installing Ubuntu on the System
2615--------------------------------
2616-
2617-Beginning with Ubuntu 14.04 (Trusty Tahr), server certification requires
2618-that the SUT be installable via MAAS. Therefore, the following procedure
2619-assumes the presence of a properly-configured MAAS server. The MAAS
2620-Advanced NUC Installation and Configuration (MANIAC) document describes how
2621-to set up a MAAS server for certification testing purposes. This document
2622-describes use of MAAS 1.8. Using MAAS 1.7 is also acceptable, but some user
2623-interface details differ.
2624-
2625-Once the SUT and MAAS server are both connected to the network, you can
2626-install Ubuntu on the SUT as follows:
2627-
2628-#. Unplug any USB flash drives or external hard disks from the SUT.
2629- (MAAS will attempt to install to a USB flash drive if it's detected
2630- before the hard disk. This is obviously undesirable.)
2631-
2632-#. Power on the SUT and allow it to PXE-boot.
2633-
2634- - The SUT should boot the MAAS enlistment image and then power off.
2635-
2636- - You should see the SUT appear as a newly-enlisted computer in your
2637- MAAS server's node list. (You may need to refresh your browser to see
2638- the new entry.)
2639-
2640-#. Check and verify the following items in the MAAS server's node details
2641- page:
2642-
2643- - If desired, set a node name for the SUT.
2644-
2645- - Check the SUT's power type and ensure it's set correctly (IPMI, AMT,
2646- etc.). If the SUT has no BMC, you can leave this section blank or
2647- enter "dummy" data. If the power control information was detected
2648- incorrectly or incompletely, you should consult the Canonical
2649- Certification Team for advice.
2650-
2651-#. Commission the node by clicking Take Action followed by Commission
2652- and then Go.
2653-
2654- - If the SUT has a BMC, the computer should power up, pass more
2655- information about itself to the MAAS server, and then power down
2656- again.
2657-
2658- - If the SUT does not have a BMC, you should manually power on the SUT
2659- after clicking the Commission Node button. The SUT should power up,
2660- pass more information about itself to the MAAS server, and then power
2661- down again.
2662-
2663- - Note that manual power control is acceptable only on low-end servers
2664- that lack BMCs. If MAAS fails to detect a BMC that is present or if
2665- MAAS cannot control a BMC that is present, please consult the
2666- Canonical Certification Team.
2667-
2668-#. On the MAAS server, verify that the SUT's Status is listed as Ready
2669- in the node list or on the node's details page. You may need to
2670- refresh the page to see the status update.
2671-
2672-#. Click Take Action followed by Deploy. Options to select the OS version
2673- to deploy should appear.
2674-
2675-#. Select the Ubuntu release you want to deploy. Normally, you'll pick a
2676- point release that you installed as described in the MANIAC document.
2677- This image will appear as an OS type of Custom" and a description that
2678- you gave it. The normal procedure is to test with 14.04 GA followed by
2679- the latest point release. `Appendix D - Point Release Testing`_,
2680- elaborates on this policy.
2681-
2682-#. Click Go to begin deployment.
2683-
2684- - If the SUT has a BMC, it should power up and install Ubuntu. This
2685- process can take several minutes.
2686-
2687- - If the SUT does not have a BMC, you should power it on manually after
2688- clicking Acquire and Start Node. The SUT should then boot and install
2689- Ubuntu. This process can take several minutes.
2690-
2691-If MAAS has problems in any of the preceding steps, the SUT might not
2692-pass certification. For instance, certification requires that MAAS be
2693-able to detect the SUT and set its power type information automatically.
2694-If you have problems with any of these steps, contact the
2695-Canonical Server Certification Team to learn how to proceed; you might
2696-have run into a simple misconfiguration, or the server might need
2697-enablement work.
2698-
2699-Logging Into the SUT
2700---------------------
2701-
2702-Once the SUT is installed, you should be able to log into it using SSH from
2703-the MAAS server. Check the node details page to learn its primary IP
2704-address. (Using a hostname will also work if DNS is properly configured,
2705-but this can be fragile.) The username on the node is ``ubuntu``, and you
2706-should require no password when logging in from the MAAS server or from any
2707-other computer and account whose SSH key you've registered with the MAAS
2708-server.
2709-
2710-You should keep some details in mind as you continue to access the SUT:
2711-
2712-- You should *not* install updates to the SUT unless they are absolutely
2713- necessary to pass the certification. In that case, the Canonical
2714- Certification Team will make the determination of what updates should be
2715- applied.
2716-
2717-- You should verify your SUT's version by typing ``lsb_release -a``. The
2718- result includes both the main release version (such as 14.04) and the
2719- point release version (such as 14.04.2, on the *Description* line). You
2720- can also check your kernel version by typing ``uname -r``. The kernel
2721- version changes with the Ubuntu release. Both 14.04 and 14.04.1 ship
2722- with 3.13-series kernels, while 14.04.2 ships with a 3.16-series kernel.
2723-
2724-- By default, MAAS provides a DHCP server, and the SUT should use it to
2725- obtain an IP address. If necessary for your environment, you may
2726- manually change these settings on the SUT to use a static IP address.
2727-
2728-- If you want to log in at the console or from another computer, you
2729- must set a password::
2730-
2731- $ sudo passwd ubuntu
2732-
2733- After prompting, this command changes the password for the user called
2734- ``ubuntu``, which is the default user created by MAAS. Testing at the
2735- console has certain advantages (described shortly).
2736-
2737-- A MAAS installation configured for certification testing should
2738- provision the SUT with the Server Test Suite and related packages. If
2739- you're using a more "generic" MAAS setup, you'll have to install the
2740- certification software yourself, as described in `Appendix A -
2741- Installing the Server Test Suite Manually`_.
2742-
2743-Ensure all network devices are configured in the file
2744-``/etc/network/interfaces``:
2745-
2746-.. figure:: images/interfaces.png
2747- :alt: The /etc/network/interfaces file must be properly configured
2748- for your system's interfaces.
2749- :width: 100%
2750-
2751-Be sure to start networking on all the interfaces. (The network tests will
2752-*not* bring up a network interface, even if it's defined in
2753-``/etc/network/interfaces``.) In most cases, typing ``sudo ifup eth1``, and
2754-so on for additional entries, will do the job. (The ``eth0`` interface is
2755-normally enabled by default on the first boot and so need not be explicitly
2756-brought up, but this isn't always the case.) Once you've done this, typing
2757-``ifconfig`` should show that all the interfaces have IP addresses.
2758-
2759-Installing the Server Test Suite Packages
2760------------------------------------------
2761-
2762-Three methods of installing the Server Test Suite exist:
2763-
2764-- Automatically by the MAAS server
2765-
2766-- Using APT to retrieve the Server Test Suite packages on a SUT with
2767- full Internet access
2768-
2769-- By loading the Server Test Suite Debian packages from a USB flash
2770- drive or other medium you bring with you to the test site
2771-
2772-If MAAS is fully configured as described in the `MAAS Advanced NUC
2773-Installation and Configuration (MANIAC)` document, it should deploy the
2774-Server Test Suite automatically. If MAAS doesn't deploy the Server Test
2775-Suite properly, you can do so manually, as described in `Appendix A -
2776-Installing the Server Test Suite Manually`_.
2777-
2778-Creating a Hardware Entry on C3
2779-===============================
2780-
2781-In order to upload test results to the certification web site
2782-(http://certification.canonical.com, or C3 for short) you need to create a
2783-hardware entry for the system which you will be certifying. If the SUT has
2784-no direct Internet connection, you can put off creating the C3 entry until
2785-after the test (although doing it before testing is fine, too). If you
2786-don't plan to submit the results, you should not create a C3 entry for the
2787-machine. To create an entry you can go directly to:
2788-
2789-https://certification.canonical.com/hardware/create-system
2790-
2791-If you have problems accessing this site, contact your account manager.
2792-
2793-When creating an entry, you must enter assorted pieces of information:
2794-
2795-#. Fill in the details:
2796-
2797- * **Account** -- The name of your account. If the account is incorrect
2798- or can't be set, please contact your account manager for assistance.
2799- This field is never published; it is for internal use only.
2800-
2801- * **Make** -- The manufacturer of the system, e.g. Dell, HP, as you
2802- would like it to appear on the public web site.
2803-
2804- * **Model** -- The name of the system itself, e.g ProLiant DL630 or
2805- PowerEdge R210, as you would like it to appear on the public web site.
2806-
2807- * **Aliases** -- This is used for alternate marketing names for a
2808- server. This field is only accessible to the Canonical Server
2809- Certification Team. If you need to add items to this field, please
2810- contact your account manager. These do appear publicly as separate
2811- entries in the database (e.g. Server1000, Alias1001 and Alias1002 all
2812- point to the same system, but appear as three separate entries on the
2813- public web site).
2814-
2815- * **Codenames** -- This is for your internal reference and use and is
2816- for the internal code name associated with the SUT. This data is
2817- *never* published and is visible only to you and to Canonical.
2818-
2819- * **Web site** -- Optional, link to the system info on the
2820- manufacturer's web site. This field is published publicly and is a way
2821- for potential customers to directly access information about your
2822- hardware on your own web site.
2823-
2824- * **Comment** -- Optional, any comment you want to make about the
2825- hardware, including things like tester name, test location, etc.
2826- These comments are never made public, they are for internal use only.
2827-
2828- * **Form factor** -- The type of system: Laptop, Server, etc. This is
2829- not published directly, but determines where your system is displayed
2830- on the public site. Client form factors appear in one place while
2831- server form factors appear elsewhere on the public certification site.
2832- You may select any of the Server form factors you like except for
2833- Server SoC, which is reserved for System on Chip certifications.
2834-
2835- * **Architecture** -- The CPU architecture of the SUT. This is used
2836- internally and is not published.
2837-
2838- * **Confidential** -- Defaults to False (unchecked). Check the box if
2839- the system has not been publicly announced yet or should remain
2840- unpublished for any reason. This will cause the entire entry to *not*
2841- be published to the public web site.
2842-
2843-#. Click Submit.
2844-
2845-#. Note the "Secure ID for testing purposes" value. You'll need this
2846- when submitting the test results. (Note that this value is unique for
2847- each machine.)
2848-
2849-Running the Certification Tests
2850-===============================
2851-
2852-To initiate a testing session in a server:
2853-
2854-#. Connect to the server via SSH or log in at the console. A standard MAAS
2855- installation creates a user called ``ubuntu``, as noted earlier. You can
2856- test using either a direct console login or SSH, but an SSH login may be
2857- disconnected by the network tests or for other reasons.
2858-
2859-#. Before testing you must ensure that all network ports are cabled to a
2860- working LAN and configured in ``/etc/network/interfaces`` using the
2861- appropriate configuration (static or DHCP) for your test environment.
2862- If you edit this file, either reboot or bring up the interfaces you
2863- add with ``ifup`` before running tests.
2864-
2865-#. If the SUT provides the suitable ports and drives, plug in a USB 2
2866- stick, plug in a USB 3 stick, and insert a suitable data CD in the
2867- optical drive. Note that USB testing is not required for blades that
2868- provide USB ports only via specialized dongles. These media must remain
2869- inserted *throughout the test run*, because the media tests will be
2870- kicked off partway through the run.
2871-
2872-#. If the system doesn't have Internet access:
2873-
2874- * Copy the image you downloaded from
2875- http://cloud-images.ubuntu.com/trusty/current/trusty-server-cloudimg-i386-disk1.img (as
2876- noted in `Appendix A`) to any directory of the SUT.
2877-
2878- * Supply the full path under the section labeled "environment" in
2879- ``/etc/xdg/canonical-certification.conf``. For example::
2880-
2881- [environment]
2882- KVM_TIMEOUT:
2883- KVM_IMAGE: /home/ubuntu/trusty-server-cloudimg-i386-disk1.img
2884-
2885-#. If necessary, edit the ``/etc/xdg/canonical-certification.conf`` file on
2886- the SUT so as to specify your ``iperf`` server. For example::
2887-
2888- TEST_TARGET_FTP = your-ftp-server.example.com
2889- TEST_USER = anonymous
2890- TEST_PASS =
2891- TEST_TARGET_IPERF = 192.168.0.2
2892-
2893- If you configured your MAAS server as described in the MANIAC document,
2894- the ``TEST_TARGET_IPERF`` line should point to your SUT's gateway address,
2895- which is normally also your MAAS server; but if your network
2896- configuration deviates from the one described in MANIAC, you may need to
2897- adjust this value. The Server Test Suite does not currently use FTP, but
2898- these lines must be uncommented. They may be left at their default
2899- values.
2900-
2901-#. While editing ``/etc/xdg/canonical-certification.conf``, you may
2902- optionally enter the SUT's Secure ID in the ``[sru]`` section. This can
2903- simplify submission of results at the end of the test; however, this
2904- will work only if the SUT has full Internet access.
2905-
2906-#. Launch ``iperf`` on the server identified in the SUT's
2907- ``/etc/xdg/canonical-certification.conf`` file by typing::
2908-
2909- $ iperf -s
2910-
2911-#. If you're running the test via SSH, type screen on the SUT to ensure
2912- that you can reconnect to your session should your link to the SUT go
2913- down, as may happen when running the network tests. If you're
2914- disconnected, you can reconnect to your session by logging in and
2915- typing ``screen -r``. This step is not important if you're running the
2916- Server Test Suite at the console.
2917-
2918-#. Run::
2919-
2920- $ canonical-certification-server
2921-
2922-#. A welcome message will be displayed. Make sure to read the message
2923- and follow its instructions.
2924-
2925-#. Press the Enter key. The system will display a Suite Selection
2926- screen:
2927-
2928- .. figure:: images/some_tests.png
2929- :alt: The suite selection screen enables you to pick which
2930- tests to run
2931- :width: 100%
2932-
2933-#. Select the *Server-full-14.04* item and deselect the other items.
2934- (These other suites exist to enable easy re-running of subsets of
2935- tests that often fail in some environments.)
2936-
2937-#. Use the arrow keys to highlight the *<OK>* option and then press
2938- Enter.
2939-
2940-#. After a few seconds, a test selection screen will appear, as shown
2941- below. You should ordinarily leave all the tests selected. (Tests that
2942- are irrelevant for a given computer, such as tests of the optical drive
2943- on computers that lack this hardware, are automatically ignored.) If a
2944- test is hanging or otherwise causing problems, please contact the
2945- Canonical Server Certification Team for advice on how to proceed. Using
2946- this screen is fairly straightforward, but `Appendix C - Using the Test
2947- Selection Screen`_ covers the details.
2948-
2949- .. figure:: images/ccs_tests.png
2950- :alt: The suite selection screen enables you to pick which
2951- tests to run
2952- :width: 100%
2953-
2954-#. Press the *T* key to start testing. The screen will begin displaying a
2955- scrolling set of technical details about the tests as they are
2956- performed.
2957-
2958-#. The full test suite can take several hours to complete, depending on
2959- the hardware configuration (amount of RAM, disk space, etc). During
2960- this time the computer may be unresponsive. This is due to the
2961- inclusion of some stress test cases. These are deliberately
2962- intensive and produce high load on the system's resources.
2963-
2964-#. If at any time during the execution you are *sure* the computer has
2965- crashed (or it reboots spontaneously) then after the system comes back
2966- up you should run the ``canonical-certification-server`` command again
2967- and respond `y` when asked if you want to resume the previous session.
2968-
2969-#. When the test run is complete, you should see a summary of tests run, a
2970- note about where the ``submission.xml``, ``results.html``, and
2971- ``results.xlsx`` files have been stored, and a prompt to submit the
2972- results to ``certification.canonical.com``. If you're connected to the
2973- Internet, typing ``y`` at this query should cause the results to be
2974- submitted. You will need either a Secure ID value or to have already
2975- entered this value in the ``/etc/xdg/canonical-certification.conf``
2976- file.
2977-
2978-#. Copying the results files off of the SUT is advisable. This is most
2979- important if the automatic submission of results fails; however,
2980- having the results available as a backup can be useful because it
2981- enables you to review the results off-line or in case of submission
2982- problems that aren't immediately obvious. The results are stored in
2983- the ``~/.local/share/plainbox`` directory.
2984-
2985-#. Copy the whole directory to an external medium and bring it with you
2986- after certifying the system. It contains a file called
2987- ``submission.xml`` which is the results of the testing as well as a file
2988- called ``results.html`` that, if loaded in a web browser, will show you
2989- the results.
2990-
2991-If you review your results by loading ``results.html`` in a web browser,
2992-you can quickly spot failed tests because they're highlighted in red with a
2993-"FAILED" notation in the Result column, whereas passed tests acquire a
2994-green color, with the word "PASSED." Note, however, that *a failed test
2995-does not necessarily denote a failed certification*. Reasons a test might
2996-fail but still enable a certification to pass include the following:
2997-
2998-- A test may be a greylist test, as described in the `Ubuntu Server
2999- Hardware Certification Coverage` document, available from
3000- https://certification.canonical.com.
3001-
3002-- Some tests are known to produce occasional false positives -- that
3003- is, they claim that problems exist when in fact they don't.
3004-
3005-- Some test environments are sub-optimal, necessitating that specific
3006- tests be re-run. This can happen with network tests or if the tester
3007- forgot to insert a removable medium. In such cases, the specific test
3008- can be re-run rather than the entire test suite.
3009-
3010-Consult your account manager if you have questions about specific test
3011-results.
3012-
3013-Manually Uploading Test Results to the Certification Site
3014-=========================================================
3015-
3016-If you can't upload test results to the certification site from the
3017-certification program itself, you must do so manually, perhaps from
3018-another computer. To upload the results, you should have the Server Test
3019-Suite and ``canonical-certification-submit`` installed on the system from
3020-which you plan to submit results. The Server Test Suite is part of the
3021-default install on all Ubuntu Desktop systems. At this time, there is no
3022-mechanism for submitting results from an OS other than Ubuntu.
3023-
3024-To add the Hardware Certification PPA, install
3025-``canonical-certification-submit``, and submit the results, follow these
3026-instructions:
3027-
3028-#. Add the Hardware Certification PPA::
3029-
3030- $ sudo apt-add-repository ppa:hardware-certification/public
3031- $ sudo apt-get update
3032-
3033-#. Install the package::
3034-
3035- $ sudo apt-get install canonical-certification-submit
3036-
3037-#. Run the following command::
3038-
3039- $ canonical-certification-submit --secure_id <SUT_SECURE_ID> \
3040- <PATH_TO>/submission.xml
3041-
3042- where:
3043-
3044- - ``<SUT_SECURE_ID>`` can be found on your system's page on the
3045- certification web site (http://certification.canonical.com) by
3046- looking next to "Secure ID for testing purposes":
3047-
3048- .. image:: images/secure_id.png
3049- :alt: The Secure ID can be obtained from the Ceritification web site.
3050- :align: left
3051- :width: 50%
3052-
3053- - ``<PATH_TO>`` refers to the location of the ``submission.xml file``
3054- (which should be contained in the ``~/.local/share/plainbox``
3055- directory you copied to the USB key).
3056-
3057- - Older versions of this tool used ``\-\-hwid`` rather than
3058- ``\-\-secure_id``.
3059-
3060-You should see output similar to the following for a successful
3061-submission::
3062-
3063- $ canonical-certification-submit --hwid a00D000000LU9Ji \
3064- ~/.local/share/plainbox/submission.xml
3065- 2012-03-28 11:05:30,575 INFO Preparing to submit results using Hardware
3066- ID: a00D000000LU9Ji
3067- 2012-03-28 11:05:30,576 INFO Getting messages
3068- 2012-03-28 11:05:56,726 INFO Exchanged 8 of 8 messages
3069- 2012-03-28 11:05:56,726 INFO Results have been successfully submitted.
3070- To review your test results now, please
3071- go to the following URL:
3072- https://certification.canonical.com/submission/eFXnst3rVbBvdu2
3073-
3074-Once results submission is complete, use the provided link in the output
3075-to review the results and confirm that they are correct.
3076-
3077-Requesting a Certificate
3078-========================
3079-
3080-Once you've uploaded the data to the certification site, you should
3081-review it in the web interface. If you're satisfied that there are no
3082-problems, you can request a certificate:
3083-
3084-#. Click the date link under the Created column in the Submissions
3085- section. The result should be a page showing most of the same
3086- information as the previous page, but in a different format, and
3087- restricted to that one test run.
3088-
3089-#. Click the Request Certificate link. The result should be a page with
3090- a few radio buttons in which you can enter information:
3091-
3092- - Status is fixed at In Progress.
3093-
3094- - Release indicates the Ubuntu release used for testing, and for which
3095- the certificate will be issued.
3096-
3097- - Level indicates the type of certification:
3098-
3099- - Certified is for for hardware that's ready to be deployed with
3100- Ubuntu.
3101-
3102- - Certified Pre-installed is for hardware that ships with a (possibly
3103- customized) version of Ubuntu.
3104-
3105- - Is Private should be checked if the certification should be kept
3106- private. Note that this check box affects the certificate only, not
3107- the entry for the computer as a whole on
3108- http://certification.canonical.com. Other public pre-existing
3109- certificates, or those issued in the future, will remain public.
3110-
3111-#. Click Submit. You'll see a new screen in which you can (and in one
3112- case *must*) enter more information. In particular, you can click:
3113-
3114- - Link Bug to link to a bug on https://bugs.launchpad.net.
3115- This option is available only to Canonical engineers.
3116-
3117- - Create Note or Create Note from Template to create a note. Most
3118- systems will have at least two notes:
3119-
3120- - *A note titled "Tester" with the name of the person who did the
3121- testing is required.*
3122-
3123- - A note titled "Test Notes" is usually present. It describes
3124- test-specific quirks, such as why a failure should be ignored
3125- (say, if a network test failed because of local network problems
3126- but succeeded on re-testing). If the
3127- *miscellanea/get-maas-version* test fails, be sure to specify the
3128- version of MAAS used to deploy the SUT.
3129-
3130- In most cases, the "Private" check box should be checked for your
3131- notes.
3132-
3133-.. raw:: pdf
3134-
3135- PageBreak
3136-
3137-Appendix A - Installing the Server Test Suite Manually
3138-======================================================
3139-
3140-Ordinarily, MAAS will install the Server Test Suite onto the SUT as part
3141-of the provisioning process, as described in the main body of this
3142-document. If the MAAS server is not configured to do this, though, you
3143-have two additional options for installing the Server Test Suite: You
3144-may use APT if the SUT has full Internet access or you may install
3145-the Server Test Suite from a tarball that you bring with you.
3146-
3147-Installing the Server Test Suite via APT
3148-----------------------------------------
3149-
3150-If your lab setup has Internet access, getting the testing tools is a
3151-pretty straightforward process, because you can install the necessary
3152-tools from the Ubuntu Hardware Certification PPA.
3153-
3154-Log in to the server locally or via SSH or KVM and run the following
3155-commands::
3156-
3157- $ sudo apt-add-repository ppa:hardware-certification/public
3158- $ sudo apt-add-repository ppa:firmware-testing-team/ppa-fwts-stable
3159- $ sudo apt-get update
3160- $ sudo apt-get install canonical-certification-server
3161-
3162-.. The ppa:hardware-certification/public should be stable. For
3163- the development PPA, instead use ppa:checkbox-dev/ppa.
3164-
3165-If for some reason you want to run the test suite from an Ubuntu live
3166-medium, you must also enable the universe repository::
3167-
3168- $ sudo apt-add-repository universe
3169-
3170-Note that running the test suite from a live medium is not accepted for any
3171-certification attempt; this information is provided to help in unusual
3172-situations or when debugging problems that necessitate booting in this way.
3173-
3174-During the installation, you may be prompted for a password for ``mysql``.
3175-This can be set to anything you wish; it will not be used during testing.
3176-
3177-At this point, you should have the test suite and dependencies installed
3178-and be ready to begin testing.
3179-
3180-Bringing the Server Test Suite Packages With You
3181-------------------------------------------------
3182-
3183-If you do not have Internet access from your LAN, you can find the
3184-pre-built tarball including the Server Test Suite packages under:
3185-
3186-https://certification.canonical.com/offline
3187-
3188-Note that you will be asked for your account credentials when you access
3189-that URL.
3190-
3191-Copy the appropriate ``.tar.gz`` file to a USB stick and bring this with
3192-you when testing the system. You will also need to obtain and bring a copy
3193-of a bootable Ubuntu Cloud Image for the virtualization portion of the
3194-certification test. You can obtain that here:
3195-
3196-http://cloud-images.ubuntu.com/trusty/current/trusty-server-cloudimg-i386-disk1.img
3197-
3198-You can use another release of Ubuntu if this is convenient. An i386
3199-image is used even when you're testing 64-bit hardware. The point is to
3200-test that virtualization features work, not that a specific Ubuntu
3201-version or architecture is supported. Because the i386 image is more
3202-general, it's the one that we use in testing.
3203-
3204-To install the server certification packages from the copied tarball,
3205-perform the following steps on the SUT:
3206-
3207-#. Insert the USB drive on which you placed the tarball.
3208-
3209-#. Extract the contents of the ``.tar.gz`` file from the USB stick to a
3210- temporary directory (such as ``/tmp/``)::
3211-
3212- $ tar -C /tmp -xzf ubuntu-14.04-server-amd64.tar.gz
3213- $ cd /tmp
3214-
3215-#. Look for a directory whose name begins with ``apt-repo`` and switch to
3216- it (note this is just an example, your exact directory name may be
3217- different)::
3218-
3219- $ cd apt-repo-ubuntu-14.04.1-server-amd64.iso-20140901-canonical-certification-ser
3220-
3221-4. Use a provided helper script to add a local package repository::
3222-
3223- $ sudo ./add_offline_repository -u
3224-
3225-5. Install the Server Test Suite::
3226-
3227- $ sudo apt-get install canonical-certification-server
3228-
3229-During the installation, you may be prompted for a password for ``mysql``.
3230-This can be set to anything you wish; it will not be used during testing.
3231-If you're asked about mail server configuration, respond that the mail
3232-server should not be configured.
3233-
3234-.. raw:: pdf
3235-
3236- PageBreak
3237-
3238-Appendix B - Re-Testing and Installing Updated Tests
3239-====================================================
3240-
3241-Occasionally, a test will fail, necessitating re-testing a feature. For
3242-instance, if you forget to insert a USB flash drive, the relevant USB
3243-tests will fail. The same thing will happen if a USB flash drive is
3244-defective or improperly prepared. Another common source of problems is
3245-network tests, which can fail because of busy LANs, flaky switches, bad
3246-cables, and so on. When this happens, you must re-run the relevant
3247-test(s).
3248-
3249-Although it's often possible to re-run a test by directly executing a
3250-single test script, the preferred method is:
3251-
3252-#. Re-run ``canonical-certification-server``.
3253-
3254-#. Use one of the abbreviated testing whitelists (such as *Network-only*)
3255- or adjust the set of tests to be run (as described in `Appendix C`).
3256-
3257-#. Submit the resulting ``submission.xml`` file to the C3 site.
3258-
3259-You can then request a certificate based on the main results (the one with
3260-the most passed tests) and refer to the secondary set of results in the
3261-certificate notes. This procedure ensures that all the necessary data will
3262-be present on C3. It also ensures that (sometimes subtle) problems will be
3263-avoided; for instance, network tests may not be valid if network ports that
3264-are not being tested are active. The ``canonical-certification-server``
3265-framework ensures that such potential problems are avoided.
3266-
3267-From time to time, a test will be found to contain a bug or need to be
3268-updated to deal with a problem. In such cases, it is often impractical
3269-to wait for the fix to work its way down through Ubuntu's packaging
3270-system, or even through the PPAs in which some of the relevant tools are
3271-distributed. In such cases, the usual procedure for replacing the script
3272-or file is as follows:
3273-
3274-#. Consult with the Server Certification Team about the problem; *do
3275- not* install an updated script from some other source!
3276-
3277-#. Obtain the updated file (typically a script) from the Server
3278- Certification Team. Store it on the SUT in the home directory of the
3279- test account. For instance, the new script might be
3280- ``/home/ubuntu/newscript``. If necessary, give the new file execute
3281- permissions.
3282-
3283-#. On the SUT, rename or delete the original file, as in::
3284-
3285- $ sudo rm /usr/lib/2013.canonical.com\:checkbox/bin/oldscript
3286-
3287-#. Create a symbolic link from the new script to the original name, as
3288- in::
3289-
3290- $ sudo ln -s /home/ubuntu/newscript \
3291- /usr/lib/2013.canonical.com\:checkbox/bin/oldscript
3292-
3293-#. Run the tests again, using the ``canonical-certification-server`` user
3294- interface.
3295-
3296-In some cases, another procedure might be necessary; for instance, a bug
3297-fix might require installing a new Debian package with the dpkg command,
3298-or you might need to edit a configuration file. The Canonical Server
3299-Certification Team can advise you about such requirements.
3300-
3301-.. raw:: pdf
3302-
3303- PageBreak
3304-
3305-Appendix C - Using the Test Selection Screen
3306-============================================
3307-
3308-It may be necessary for you to deselect some of the tests which are to
3309-be run for certification. This is unlikely, though, and you should only
3310-do it when so instructed.
3311-
3312-The test selection screen looks like this:
3313-
3314-.. figure:: images/ccs_tests2.png
3315- :alt: The test selection screen enables you to select the tests
3316- you want to run.
3317- :width: 100%
3318-
3319-Every test suite name is preceded by a brackets that contain either an
3320-*X* character or nothing to identify whether the test suite has been
3321-selected or not.
3322-
3323-Tests are arranged hierarchically. When a top-level test is highlighted,
3324-you can hide or reveal the details by pressing the Enter key; or you can
3325-select or deselect all the tests in that category by pressing the
3326-Spacebar. For instance, with *Benchmark tests* highlighted, as in the
3327-figure, pressing Enter will hide the lines up to *CPU tests*; and pressing
3328-the Spacebar will deactivate (or re-activate) all of the benchmark
3329-tests. You can select or de-select an individual test, such as the
3330-*hdparm-read_sda* test, by highlighting it and pressing the Spacebar.
3331-
3332-Once you've selected all the tests, press the *T* key to begin the testing
3333-process.
3334-
3335-.. raw:: pdf
3336-
3337- PageBreak
3338-
3339-Appendix D - Point Release Testing
3340-==================================
3341-
3342-Ordinarily, 14.04 certification requires testing two releases:
3343-
3344-- Ubuntu 14.04 GA -- That is, the version that was released in April of
3345- 2014.
3346-
3347-- The current point release -- That is, version 14.04.2 or whatever is
3348- the latest release in the 14.04 series.
3349-
3350-In theory, compatibility will only improve with time, so a server might
3351-fail testing with 14.04 GA because it uses new hardware that had not
3352-been supported in April of 2014, but pass with the latest version. Such
3353-a server would be certified for that latest version, but not for the
3354-original GA release. If such a situation arises, testing should also be
3355-done with intervening releases so as to determine the earliest working
3356-version of Ubuntu.
3357-
3358-If a server fails certification with a more recent release but works
3359-with an earlier one, this situation is treated as a regression; a bug
3360-report should be filed and note made of the problem in the certificate
3361-request. Please notify your TPM about such problems to facilitate their
3362-resolution.
3363-
3364-Because Ubuntu 14.04.1 uses the same 3.13 kernel series as 14.04 GA,
3365-testing 14.04.1 is required only if 14.04 GA fails. (Although 14.04 GA
3366-and 14.04.1 use the same kernel series, 14.04.1 ships with a later
3367-kernel within that series, so it might fix a bug that blocks 14.04 GA
3368-certification.)
3369-
3370-If the procedure for installing point releases, as described in
3371-the MANIAC document (available from https://certification.canonical.com),
3372-fails, then you should consult the Server Certification Team.
3373-
3374-.. raw:: pdf
3375-
3376- PageBreak
3377-
3378-Appendix E - Troubleshooting Tips
3379-=================================
3380-
3381-Submitting Results
3382-------------------
3383-
3384-If submitting results from the Server Test Suite itself fails, you can use
3385-the ``canonical-certification-submit`` program, as described earlier, in
3386-`Manually Uploading Test Results to the Certification Site`. You can try
3387-this on the SUT, but if network problems prevented a successful submission,
3388-you may need to bring the files out on a USB flash drive or other removable
3389-medium and submit them from a computer with better Internet connectivity.
3390-
3391-Inconsistent Message when Submitting Results
3392---------------------------------------------
3393-
3394-If you receive a message that looks like the following when using
3395-``canonical-certification-submit``, please be sure to save the
3396-``submission.xml`` file and contact your account manager::
3397-
3398- 2014-04-28 10:55:33,894 CRITICAL Error: Inconsistent message
3399-
3400-Network Problems
3401-----------------
3402-
3403-Network problems are common in testing. These problems can manifest as
3404-complete failures of all network tests or as failures of just some
3405-tests. Specific suggestions for fixing these problems include:
3406-
3407-- **Check cables and other hardware** -- Yes, this is very basic; but bad
3408- cables can cause problems. For instance, one bad cable at Canonical
3409- resulted in connections at 100Mbps rather than 1Gbps, and therefore
3410- failures. Some of these failures were identified in the output as the
3411- lack of a route to the host. Similarly, if a switch connecting the SUT
3412- to the ``iperf`` server is deficient, it will affect the network test
3413- results.
3414-
3415-- **Use the simplest possible network** -- Complex network setups and those
3416- with heavy traffic from computers uninvolved in the testing or those
3417- with multiple switches, bridges, etc., can create problems for
3418- network testing. Simplifying the network in whatever way is practical
3419- can improve matters.
3420-
3421-- **Check the iperf server** -- Ensure that the server computer is up and
3422- that the ``iperf`` server program is running on it. Also ensure that the
3423- computer has no issues. For instance, some versions of ``iperf``, when
3424- run in daemon mode, cause the load average to go up every time a client
3425- disconnects. This can bring even a powerful computer to its knees quite
3426- quickly!
3427-
3428-- **Ensure the iperf server is on the SUT's local network** -- The
3429- network tests temporarily remove the default route from the routing
3430- table, so the ``iperf`` server must be on the same network segment as
3431- the SUT.
3432-
3433-- **Check the SUT's network configuration** -- A failure to configure the
3434- network ports in ``/etc/network/interfaces`` will cause a failure of the
3435- network tests. Likewise, a failure to bring up a network interface
3436- before testing will cause the test to fail, even if
3437- ``canonical-certification-server`` detects the interface.
3438-
3439-- **Check your DHCP server** -- A sluggish or otherwise malfunctioning
3440- DHCP server can delay bringing up the SUT's network interfaces (which
3441- repeatedly go down and come up during testing). This in turn can cause
3442- network testing failures.
3443-
3444-If you end up having to re-run the network tests, either do so from within
3445-``canonical-certification-server`` or be sure to bring down all the network
3446-interfaces except the one you're testing before using ``iperf`` manually.
3447-The way Linux manages network interfaces makes it difficult to ensure that
3448-network traffic will be restricted to a single network port if more than
3449-one is active.
3450-
3451-Issues During Testing
3452----------------------
3453-
3454-The testing process should be straightforward and complete without issue.
3455-Should you encounter issues during testing, please contact your account
3456-manager. Be sure to save the ``~/.local/share/plainbox`` and
3457-``~/.cache/plainbox`` directory trees as they will contain logs and other
3458-data that will help the Server Certification Team determine if the issue is
3459-a testing issue or a hardware issue that will affect the certification
3460-outcome.
3461-
3462-If possible, please also save a copy of any terminal output or
3463-tracebacks you notice to a text file and save that along with the
3464-previously-noted directories. (Feel free to send us a photo of the
3465-screen taken with a digital camera.)
3466-
3467
3468=== removed directory 'documentation/images'
3469=== removed file 'documentation/images/ccs_tests.png'
3470Binary files documentation/images/ccs_tests.png 2015-07-17 19:42:06 +0000 and documentation/images/ccs_tests.png 1970-01-01 00:00:00 +0000 differ
3471=== removed file 'documentation/images/ccs_tests2.png'
3472Binary files documentation/images/ccs_tests2.png 2015-07-17 19:42:06 +0000 and documentation/images/ccs_tests2.png 1970-01-01 00:00:00 +0000 differ
3473=== removed file 'documentation/images/clusters-page.png'
3474Binary files documentation/images/clusters-page.png 2015-07-17 19:42:06 +0000 and documentation/images/clusters-page.png 1970-01-01 00:00:00 +0000 differ
3475=== removed file 'documentation/images/cover-background.png'
3476Binary files documentation/images/cover-background.png 2015-07-17 19:42:06 +0000 and documentation/images/cover-background.png 1970-01-01 00:00:00 +0000 differ
3477=== removed file 'documentation/images/cover-background.xcf'
3478Binary files documentation/images/cover-background.xcf 2015-07-17 19:42:06 +0000 and documentation/images/cover-background.xcf 1970-01-01 00:00:00 +0000 differ
3479=== removed file 'documentation/images/custom-image-selection.png'
3480Binary files documentation/images/custom-image-selection.png 2015-07-17 19:42:06 +0000 and documentation/images/custom-image-selection.png 1970-01-01 00:00:00 +0000 differ
3481=== removed file 'documentation/images/interfaces.png'
3482Binary files documentation/images/interfaces.png 2015-07-17 19:42:06 +0000 and documentation/images/interfaces.png 1970-01-01 00:00:00 +0000 differ
3483=== removed file 'documentation/images/logo-canonical_no-tm-white-hex.png'
3484Binary files documentation/images/logo-canonical_no-tm-white-hex.png 2015-07-17 19:42:06 +0000 and documentation/images/logo-canonical_no-tm-white-hex.png 1970-01-01 00:00:00 +0000 differ
3485=== removed file 'documentation/images/logo-ubuntu_su-white_orange-hex.png'
3486Binary files documentation/images/logo-ubuntu_su-white_orange-hex.png 2015-07-17 19:42:06 +0000 and documentation/images/logo-ubuntu_su-white_orange-hex.png 1970-01-01 00:00:00 +0000 differ
3487=== removed file 'documentation/images/logo-ubuntu_su-white_orange-hex.svg'
3488--- documentation/images/logo-ubuntu_su-white_orange-hex.svg 2015-07-17 19:42:06 +0000
3489+++ documentation/images/logo-ubuntu_su-white_orange-hex.svg 1970-01-01 00:00:00 +0000
3490@@ -1,25 +0,0 @@
3491-<?xml version="1.0" encoding="UTF-8"?>
3492-<!-- Generator: Adobe Illustrator 15.0.2, SVG Export Plug-In . SVG Version: 6.00 Build 0) -->
3493-<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
3494-<svg version="1.1" id="ubuntu__x5F__white_x26_orange" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px" width="425.197px" height="209.764px" viewBox="0 0 425.197 209.764" enable-background="new 0 0 425.197 209.764" xml:space="preserve">
3495-<g>
3496-</g>
3497-<g>
3498-</g>
3499-<g>
3500-</g>
3501-<g>
3502-</g>
3503-<g>
3504- <circle fill="#DD4814" cx="337.365" cy="90.017" r="16.966"/>
3505- <path fill="#FFFFFF" d="M326.783,87.978c-1.127,0-2.036,0.912-2.036,2.039c0,1.123,0.909,2.037,2.036,2.037 c1.128,0,2.039-0.914,2.039-2.037C328.822,88.89,327.911,87.978,326.783,87.978z M341.338,97.244 c-0.976,0.559-1.308,1.807-0.747,2.779c0.563,0.977,1.809,1.309,2.784,0.748c0.975-0.562,1.31-1.809,0.747-2.783 C343.559,97.013,342.312,96.679,341.338,97.244z M331.213,90.017c0-2.016,0.998-3.797,2.529-4.873l-1.488-2.498 c-1.784,1.191-3.112,3.014-3.664,5.148c0.646,0.525,1.055,1.324,1.055,2.223c0,0.893-0.408,1.691-1.055,2.219 c0.552,2.133,1.88,3.955,3.664,5.146l1.488-2.496C332.211,93.81,331.213,92.031,331.213,90.017z M337.165,84.06 c3.112,0,5.663,2.385,5.931,5.43l2.905-0.047c-0.144-2.244-1.124-4.26-2.631-5.742c-0.776,0.291-1.672,0.25-2.445-0.199 c-0.773-0.447-1.26-1.199-1.394-2.02c-0.754-0.207-1.547-0.322-2.366-0.322c-1.408,0-2.741,0.332-3.922,0.918l1.415,2.537 C335.42,84.259,336.271,84.06,337.165,84.06z M337.165,95.968c-0.895,0-1.745-0.197-2.507-0.553l-1.415,2.537 c1.181,0.588,2.514,0.916,3.922,0.916c0.819,0,1.612-0.111,2.366-0.32c0.134-0.82,0.62-1.572,1.394-2.021 c0.775-0.447,1.669-0.49,2.445-0.195c1.507-1.484,2.487-3.5,2.631-5.746l-2.905-0.041 C342.828,93.585,340.277,95.968,337.165,95.968z M341.338,82.789c0.974,0.561,2.221,0.229,2.782-0.748 c0.563-0.971,0.229-2.219-0.745-2.781c-0.976-0.562-2.221-0.229-2.784,0.746C340.03,80.98,340.362,82.226,341.338,82.789z"/>
3506- <g>
3507- <path fill="#FFFFFF" d="M104.798,134.53c-1.725,0.432-3.999,0.889-6.826,1.374c-2.83,0.483-6.102,0.726-9.817,0.726 c-3.23,0-5.952-0.472-8.159-1.413c-2.209-0.941-3.986-2.274-5.332-3.998c-1.348-1.724-2.316-3.757-2.908-6.101 c-0.594-2.341-0.889-4.939-0.889-7.795V93.734h7.513v21.973c0,5.117,0.808,8.779,2.424,10.986 c1.616,2.211,4.334,3.314,8.159,3.314c0.809,0,1.642-0.029,2.505-0.083c0.86-0.053,1.67-0.122,2.425-0.202 c0.752-0.081,1.439-0.161,2.059-0.242c0.619-0.08,1.064-0.173,1.334-0.283V93.734h7.514V134.53z"/>
3508- <path fill="#FFFFFF" d="M123.134,95.591c0.915-0.592,2.304-1.211,4.161-1.857s3.999-0.969,6.422-0.969 c3.016,0,5.696,0.539,8.039,1.615c2.342,1.078,4.322,2.584,5.938,4.523c1.614,1.939,2.839,4.256,3.675,6.947 c0.834,2.695,1.253,5.656,1.253,8.888c0,3.392-0.5,6.45-1.494,9.168c-0.999,2.72-2.412,5.021-4.242,6.907 c-1.832,1.885-4.039,3.34-6.625,4.362c-2.584,1.023-5.493,1.535-8.725,1.535c-3.502,0-6.598-0.244-9.289-0.728 c-2.693-0.485-4.902-0.97-6.625-1.454V74.347l7.513-1.293V95.591z M123.134,129.197c0.755,0.216,1.818,0.42,3.192,0.605 c1.373,0.191,3.082,0.284,5.129,0.284c4.039,0,7.271-1.334,9.693-3.999c2.425-2.666,3.637-6.45,3.637-11.349 c0-2.153-0.216-4.173-0.646-6.062c-0.432-1.883-1.132-3.514-2.102-4.885c-0.969-1.375-2.222-2.451-3.756-3.232 s-3.38-1.172-5.533-1.172c-2.049,0-3.932,0.352-5.654,1.051c-1.727,0.701-3.045,1.428-3.96,2.182V129.197z"/>
3509- <path fill="#FFFFFF" d="M194.546,134.53c-1.725,0.432-4,0.889-6.826,1.374c-2.827,0.483-6.1,0.726-9.816,0.726 c-3.23,0-5.95-0.472-8.158-1.413c-2.209-0.941-3.986-2.274-5.331-3.998c-1.348-1.724-2.315-3.757-2.909-6.101 c-0.593-2.341-0.889-4.939-0.889-7.795V93.734h7.512v21.973c0,5.117,0.809,8.779,2.424,10.986 c1.617,2.211,4.336,3.314,8.159,3.314c0.81,0,1.644-0.029,2.505-0.083c0.859-0.053,1.668-0.122,2.424-0.202 c0.754-0.081,1.44-0.161,2.061-0.242c0.618-0.08,1.062-0.173,1.331-0.283V93.734h7.514V134.53z"/>
3510- <path fill="#FFFFFF" d="M205.37,94.947c1.723-0.432,4.01-0.889,6.867-1.375c2.852-0.484,6.138-0.727,9.854-0.727 c3.34,0,6.113,0.473,8.32,1.414c2.208,0.943,3.972,2.262,5.293,3.959c1.317,1.695,2.246,3.729,2.786,6.098 c0.538,2.373,0.808,4.984,0.808,7.837v23.588h-7.513v-21.973c0-2.584-0.176-4.791-0.525-6.624 c-0.351-1.833-0.929-3.313-1.737-4.442c-0.808-1.133-1.885-1.953-3.231-2.465c-1.346-0.514-3.018-0.768-5.007-0.768 c-0.811,0-1.645,0.027-2.504,0.08c-0.862,0.055-1.686,0.121-2.464,0.203c-0.784,0.08-1.481,0.176-2.102,0.281 c-0.62,0.109-1.063,0.189-1.333,0.242v35.464h-7.512V94.947z"/>
3511- <path fill="#FFFFFF" d="M256.665,93.734h15.914v6.301h-15.914v19.388c0,2.1,0.161,3.84,0.485,5.212s0.809,2.451,1.454,3.229 c0.646,0.781,1.452,1.333,2.423,1.656c0.97,0.324,2.1,0.487,3.392,0.487c2.314,0,4.147-0.258,5.494-0.771 c1.345-0.511,2.262-0.874,2.748-1.09l1.614,6.141c-0.755,0.378-2.088,0.863-3.999,1.453c-1.912,0.593-4.078,0.889-6.502,0.889 c-2.856,0-5.212-0.362-7.07-1.089c-1.856-0.729-3.351-1.817-4.482-3.273c-1.131-1.453-1.925-3.243-2.382-5.372 c-0.46-2.126-0.688-4.59-0.688-7.391V82.021l7.513-1.293V93.734z"/>
3512- <path fill="#FFFFFF" d="M313.455,134.53c-1.726,0.432-3.999,0.889-6.826,1.374c-2.827,0.483-6.101,0.726-9.814,0.726 c-3.232,0-5.952-0.472-8.161-1.413s-3.986-2.274-5.33-3.998c-1.348-1.724-2.316-3.757-2.91-6.101 c-0.592-2.341-0.889-4.939-0.889-7.795V93.734h7.515v21.973c0,5.117,0.808,8.779,2.424,10.986 c1.614,2.211,4.334,3.314,8.159,3.314c0.807,0,1.641-0.029,2.504-0.083c0.859-0.053,1.667-0.122,2.422-0.202 c0.754-0.081,1.441-0.161,2.061-0.242c0.617-0.08,1.063-0.173,1.334-0.283V93.734h7.513V134.53z"/>
3513- </g>
3514-</g>
3515-</svg>
3516\ No newline at end of file
3517
3518=== removed file 'documentation/images/maas-dropdown.png'
3519Binary files documentation/images/maas-dropdown.png 2015-07-17 19:42:06 +0000 and documentation/images/maas-dropdown.png 1970-01-01 00:00:00 +0000 differ
3520=== removed file 'documentation/images/maniac-network.fig'
3521--- documentation/images/maniac-network.fig 2015-07-17 19:42:06 +0000
3522+++ documentation/images/maniac-network.fig 1970-01-01 00:00:00 +0000
3523@@ -1,1157 +0,0 @@
3524-#FIG 3.2 Produced by xfig version 3.2.5c
3525-Landscape
3526-Center
3527-Metric
3528-A4
3529-70.00
3530-Single
3531--2
3532-1200 2
3533-0 32 #c6b797
3534-0 33 #eff8ff
3535-0 34 #dccba6
3536-0 35 #404040
3537-0 36 #808080
3538-0 37 #c0c0c0
3539-0 38 #e0e0e0
3540-0 39 #8e8f8e
3541-0 40 #aaaaaa
3542-0 41 #555555
3543-0 42 #c7c3c7
3544-0 43 #565151
3545-0 44 #8e8e8e
3546-0 45 #d7d7d7
3547-0 46 #85807d
3548-0 47 #d2d2d2
3549-0 48 #3a3a3a
3550-0 49 #4573aa
3551-0 50 #aeaeae
3552-0 51 #7b79a5
3553-0 52 #444444
3554-0 53 #73758c
3555-0 54 #f7f7f7
3556-0 55 #414541
3557-0 56 #635dce
3558-0 57 #bebebe
3559-0 58 #515151
3560-0 59 #e7e3e7
3561-0 60 #000049
3562-0 61 #797979
3563-0 62 #303430
3564-0 63 #414141
3565-0 64 #c7b696
3566-0 65 #9e9e9e
3567-0 66 #868286
3568-0 67 #717571
3569-0 68 #aeaaae
3570-0 69 #c7c7c7
3571-0 70 #757575
3572-0 71 #f3f3f3
3573-# Drawn by Markus Laner 2010 March
3574-6 180 2520 2205 3735
3575-3 2 0 2 0 7 50 -1 -1 0.000 0 0 0 3
3576- 999 2810 1343 2596 1728 2939
3577- 0.000 -1.000 0.000
3578-3 2 0 2 0 7 50 -1 -1 0.000 0 0 0 3
3579- 1684 2853 2071 2853 2114 3281
3580- 0.000 -1.000 0.000
3581-3 2 0 2 0 7 50 -1 -1 0.000 0 0 0 3
3582- 1170 3581 828 3710 657 3496
3583- 0.000 -1.000 0.000
3584-3 2 0 2 0 7 50 -1 -1 0.000 0 0 0 3
3585- 657 3496 228 3281 571 3024
3586- 0.000 -1.000 0.000
3587-3 2 0 2 0 7 50 -1 -1 0.000 0 0 0 3
3588- 2068 3248 2156 3410 1939 3462
3589- 0.000 -1.000 0.000
3590-3 2 0 2 0 7 50 -1 -1 0.000 0 0 0 3
3591- 1942 3453 1684 3710 1128 3539
3592- 0.000 -1.000 0.000
3593-3 2 0 2 0 7 50 -1 -1 0.000 0 0 0 3
3594- 486 3068 574 2714 1088 2842
3595- 0.000 -1.000 0.000
3596--6
3597-# Laptop computer
3598-6 3629 2475 4905 3870
3599-1 1 0 1 0 7 50 0 -1 0.000 1 0.0000 4202 3830 30 18 4202 3830 4232 3849
3600-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 8
3601- 3717 2483 3711 3191 3879 3191 3879 3123 4592 3123 4592 3198
3602- 4754 3198 4768 2479
3603-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 16
3604- 3715 3194 3636 3767 3910 3814 3916 3803 4619 3794 4640 3805
3605- 4688 3804 4891 3767 4903 3757 4900 3744 4744 3198 4648 3198
3606- 4648 3210 3808 3208 3808 3190 3715 3190
3607-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 9
3608- 3638 3769 3644 3820 3913 3863 3924 3856 4610 3849 4629 3858
3609- 4662 3858 4870 3811 4902 3760
3610-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
3611- 4767 2479 3721 2483 3719 2482
3612-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
3613- 3752 2521 4722 2517 4716 3090 3745 3095 3752 2519
3614-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
3615- 3760 3348 3760 3363 3840 3363 3841 3350
3616-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
3617- 3763 3345 3835 3345 3836 3358 3762 3358 3763 3344
3618-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
3619- 3774 3232 4105 3233 4105 3257 3773 3257 3775 3232
3620-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
3621- 3700 3394 4782 3395 4872 3732 3661 3747 3700 3395
3622-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
3623- 4180 3799 4182 3760 4375 3759 4377 3795
3624-2 2 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
3625- 4207 3775 4350 3775 4350 3787 4207 3787 4207 3775
3626-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
3627- 3711 3375 3731 3375 3731 3389 3711 3388 3711 3375
3628-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
3629- 3974 3686 3974 3719 4331 3718 4332 3684 3974 3686
3630-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 6
3631- 3973 3719 3953 3742 3954 3680 4351 3677 4351 3739 4331 3719
3632-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
3633- 3865 3686 3865 3717 3937 3717 3937 3685 3865 3685
3634-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 6
3635- 3865 3686 3849 3680 3849 3744 3950 3744 3950 3679 3849 3679
3636-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3637- 3849 3744 3865 3717
3638-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3639- 3949 3743 3937 3718
3640-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3641- 3938 3684 3949 3680
3642-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
3643- 3769 3741 3769 3679 3850 3679
3644-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3645- 3769 3743 3848 3743
3646-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3647- 3787 3686 3769 3679
3648-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3649- 3834 3687 3848 3680
3650-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3651- 3833 3714 3848 3743
3652-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3653- 3788 3714 3770 3742
3654-2 2 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
3655- 3772 3293 3837 3293 3837 3320 3772 3320 3772 3293
3656-2 2 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
3657- 3787 3686 3834 3686 3834 3714 3787 3714 3787 3686
3658-2 2 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
3659- 3686 3688 3754 3688 3754 3720 3686 3720 3686 3688
3660-2 2 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
3661- 3673 3679 3769 3679 3769 3742 3673 3742 3673 3679
3662-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3663- 3673 3742 3686 3720
3664-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 1
3665- 3686 3718
3666-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3667- 3673 3679 3686 3688
3668-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3669- 3769 3680 3754 3688
3670-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3671- 3768 3742 3754 3719
3672-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3673- 3954 3682 3973 3686
3674-2 2 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
3675- 4352 3678 4427 3678 4427 3737 4352 3737 4352 3678
3676-2 2 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
3677- 4427 3678 4514 3678 4514 3737 4427 3737 4427 3678
3678-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
3679- 4515 3677 4579 3677 4590 3735
3680-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 1
3681- 4590 3735
3682-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
3683- 4584 3677 4595 3735 4632 3735 4620 3678 4584 3678
3684-2 2 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
3685- 4367 3686 4419 3686 4419 3718 4367 3718 4367 3686
3686-2 2 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
3687- 4444 3686 4503 3686 4503 3719 4444 3719 4444 3686
3688-2 2 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
3689- 4534 3689 4579 3689 4579 3723 4534 3723 4534 3689
3690-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3691- 4352 3738 4366 3717
3692-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3693- 4351 3679 4367 3686
3694-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 1
3695- 4368 3686
3696-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3697- 4428 3678 4418 3686
3698-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3699- 4428 3738 4418 3718
3700-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3701- 4429 3737 4444 3719
3702-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3703- 4427 3678 4445 3686
3704-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3705- 4515 3678 4503 3686
3706-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3707- 4514 3737 4503 3719
3708-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3709- 4516 3737 4535 3722
3710-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3711- 4515 3678 4535 3689
3712-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3713- 4579 3678 4578 3690
3714-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3715- 4588 3734 4578 3722
3716-2 3 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 6
3717- 4592 3619 4607 3675 4693 3673 4676 3614 4590 3615 4592 3619
3718-2 3 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 6
3719- 4614 3627 4621 3659 4678 3659 4670 3624 4613 3625 4614 3627
3720-2 3 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 6
3721- 4626 3681 4639 3735 4709 3733 4696 3678 4626 3679 4626 3681
3722-2 3 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 6
3723- 4652 3689 4659 3719 4698 3719 4691 3686 4652 3687 4652 3689
3724-2 3 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 6
3725- 4687 3614 4702 3671 4767 3670 4754 3612 4687 3613 4687 3614
3726-2 3 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 6
3727- 4705 3679 4718 3733 4788 3732 4771 3675 4705 3675 4705 3679
3728-2 3 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 6
3729- 4709 3624 4716 3654 4756 3653 4749 3621 4710 3621 4709 3624
3730-2 3 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 6
3731- 4727 3685 4734 3711 4775 3711 4766 3681 4727 3681 4727 3685
3732-2 3 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 6
3733- 4778 3675 4793 3733 4864 3732 4848 3669 4777 3671 4778 3675
3734-2 3 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 6
3735- 4799 3684 4805 3711 4847 3711 4841 3681 4799 3682 4799 3684
3736-2 3 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 6
3737- 4762 3614 4775 3668 4845 3666 4831 3612 4762 3613 4762 3614
3738-2 3 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 6
3739- 4781 3627 4787 3649 4832 3649 4827 3623 4781 3624 4781 3627
3740-2 3 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 6
3741- 4515 3621 4525 3671 4600 3671 4587 3616 4517 3616 4515 3621
3742-2 3 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 6
3743- 4442 3615 4449 3670 4520 3669 4509 3616 4442 3616 4442 3615
3744-2 3 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 6
3745- 4460 3627 4463 3653 4504 3652 4500 3624 4460 3626 4460 3627
3746-2 3 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 6
3747- 4535 3627 4540 3647 4584 3647 4577 3622 4533 3623 4535 3627
3748-2 3 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 6
3749- 4618 3565 4631 3607 4752 3607 4739 3558 4617 3556 4618 3565
3750-2 3 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 6
3751- 4639 3566 4646 3588 4738 3588 4732 3566 4639 3565 4639 3566
3752-2 3 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 6
3753- 4749 3564 4759 3607 4828 3604 4818 3560 4749 3560 4749 3564
3754-2 3 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 6
3755- 4735 3508 4746 3556 4816 3555 4802 3500 4734 3501 4735 3508
3756-2 3 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 6
3757- 4722 3457 4730 3497 4801 3497 4789 3453 4721 3452 4722 3457
3758-2 3 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
3759- 4663 3503 4727 3503 4738 3552 4674 3552 4663 3503
3760-2 3 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 6
3761- 4591 3501 4653 3503 4666 3549 4601 3550 4590 3503 4591 3501
3762-2 3 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
3763- 4764 3570 4769 3592 4818 3592 4813 3568 4764 3570
3764-2 3 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 6
3765- 4755 3514 4759 3537 4806 3537 4800 3509 4754 3511 4755 3514
3766-2 3 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 6
3767- 4743 3462 4745 3482 4791 3482 4787 3460 4743 3460 4743 3462
3768-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3769- 4450 3670 4463 3653
3770-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3771- 4442 3616 4460 3626
3772-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3773- 4509 3616 4499 3625
3774-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3775- 4521 3669 4503 3651
3776-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3777- 4527 3673 4540 3646
3778-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3779- 4516 3616 4535 3624
3780-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3781- 4588 3616 4577 3623
3782-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3783- 4599 3673 4584 3647
3784-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3785- 4608 3675 4621 3659
3786-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3787- 4590 3616 4614 3626
3788-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3789- 4676 3615 4671 3626
3790-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3791- 4694 3674 4677 3658
3792-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3793- 4704 3672 4717 3654
3794-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3795- 4689 3614 4710 3623
3796-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3797- 4755 3614 4749 3621
3798-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3799- 4766 3671 4756 3653
3800-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3801- 4776 3668 4788 3648
3802-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3803- 4764 3614 4782 3624
3804-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3805- 4832 3614 4828 3624
3806-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3807- 4846 3667 4833 3648
3808-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3809- 4759 3607 4769 3591
3810-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3811- 4750 3561 4765 3570
3812-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3813- 4819 3561 4813 3569
3814-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3815- 4829 3605 4819 3591
3816-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3817- 4638 3734 4659 3719
3818-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3819- 4625 3680 4653 3688
3820-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3821- 4710 3732 4699 3719
3822-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3823- 4697 3680 4692 3685
3824-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3825- 4705 3676 4728 3683
3826-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3827- 4718 3734 4735 3711
3828-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3829- 4788 3732 4774 3711
3830-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3831- 4772 3676 4766 3682
3832-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3833- 4777 3672 4800 3683
3834-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3835- 4795 3733 4806 3711
3836-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3837- 4863 3732 4847 3711
3838-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3839- 4848 3671 4842 3682
3840-2 3 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 6
3841- 4608 3512 4650 3512 4655 3538 4612 3539 4607 3512 4608 3512
3842-2 3 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 6
3843- 4678 3513 4722 3512 4726 3541 4686 3542 4678 3514 4678 3513
3844-2 3 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 8
3845- 4612 3455 4622 3497 4723 3497 4719 3470 4714 3449 4629 3449
3846- 4613 3454 4612 3455
3847-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
3848- 4629 3451 4633 3472 4718 3470
3849-2 3 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 7
3850- 4540 3452 4549 3501 4618 3499 4609 3456 4602 3449 4550 3451
3851- 4540 3452
3852-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
3853- 4551 3450 4557 3478 4603 3476 4602 3450
3854-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3855- 4634 3473 4623 3496
3856-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3857- 4557 3479 4551 3499
3858-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3859- 4605 3477 4617 3497
3860-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
3861- 4515 3506 4525 3555 4592 3553 4580 3503 4516 3502
3862-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
3863- 4532 3509 4535 3535 4578 3534 4573 3510 4533 3510
3864-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3865- 4533 3512 4515 3504
3866-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3867- 4537 3535 4526 3555
3868-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3869- 4578 3535 4591 3552
3870-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3871- 4574 3510 4578 3503
3872-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
3873- 4543 3561 4554 3612 4625 3611 4611 3558 4543 3559
3874-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
3875- 4555 3612 4567 3588 4607 3587 4625 3610
3876-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
3877- 4567 3587 4562 3565 4608 3563 4608 3586
3878-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3879- 4561 3565 4545 3561
3880-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3881- 4608 3565 4611 3559
3882-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
3883- 4472 3452 4480 3500 4547 3500 4538 3449 4471 3450
3884-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
3885- 4481 3499 4493 3482 4536 3483 4545 3499
3886-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
3887- 4493 3482 4486 3454 4472 3451
3888-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
3889- 4488 3455 4533 3454 4539 3451
3890-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3891- 4533 3456 4535 3482
3892-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
3893- 4445 3505 4452 3558 4525 3556 4512 3503 4444 3503
3894-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
3895- 4453 3557 4466 3533 4508 3532 4524 3556
3896-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
3897- 4467 3532 4461 3510 4446 3504
3898-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
3899- 4462 3510 4509 3510 4513 3503
3900-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3901- 4509 3510 4509 3532
3902-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
3903- 4470 3562 4478 3612 4552 3613 4538 3560 4470 3560
3904-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
3905- 4478 3612 4493 3591 4533 3589 4552 3612
3906-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
3907- 4494 3589 4493 3572 4472 3561
3908-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
3909- 4494 3571 4533 3571 4538 3561
3910-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3911- 4534 3572 4534 3589
3912-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
3913- 4364 3621 4369 3675 4446 3675 4437 3620 4363 3620
3914-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 1
3915- 4366 3627
3916-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
3917- 4369 3675 4387 3652 4429 3652 4446 3676
3918-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
3919- 4389 3651 4385 3633 4365 3620
3920-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
3921- 4385 3632 4426 3631 4437 3620
3922-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3923- 4429 3651 4426 3630
3924-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 1
3925- 4426 3633
3926-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
3927- 4395 3562 4400 3615 4472 3612 4465 3558 4394 3559
3928-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
3929- 4400 3614 4418 3596 4457 3596 4472 3612 4470 3612
3930-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
3931- 4395 3559 4418 3571 4418 3596
3932-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
3933- 4418 3571 4456 3570 4465 3558
3934-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3935- 4457 3570 4456 3595
3936-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
3937- 4399 3449 4406 3500 4473 3499 4467 3449 4398 3449
3938-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
3939- 4408 3501 4420 3477 4459 3476 4473 3500
3940-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
3941- 4400 3450 4419 3461 4421 3478
3942-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
3943- 4419 3461 4460 3461 4460 3477
3944-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3945- 4460 3461 4468 3449
3946-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
3947- 4369 3506 4376 3558 4450 3557 4442 3504 4369 3504
3948-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
3949- 4377 3558 4392 3535 4434 3535 4451 3557
3950-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
3951- 4393 3535 4391 3517 4369 3504
3952-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
3953- 4391 3516 4432 3516 4443 3504
3954-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3955- 4433 3516 4433 3535
3956-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3957- 4633 3608 4647 3588
3958-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3959- 4601 3551 4613 3540
3960-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3961- 4617 3558 4640 3566
3962-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3963- 4739 3558 4731 3566
3964-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3965- 4666 3549 4655 3538
3966-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3967- 4654 3502 4651 3513
3968-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3969- 4591 3503 4608 3512
3970-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3971- 4664 3502 4678 3512
3972-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3973- 4674 3552 4686 3542
3974-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3975- 4739 3551 4726 3542
3976-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3977- 4727 3502 4722 3512
3978-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 1
3979- 4724 3512
3980-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3981- 4730 3497 4745 3481
3982-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3983- 4722 3453 4744 3461
3984-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3985- 4791 3453 4787 3460
3986-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3987- 4802 3497 4792 3481
3988-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3989- 4752 3606 4738 3588
3990-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3991- 4749 3557 4760 3536
3992-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3993- 4736 3502 4756 3511
3994-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3995- 4804 3500 4801 3510
3996-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
3997- 4817 3555 4806 3536
3998-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
3999- 4321 3562 4325 3614 4398 3615 4391 3560 4321 3560
4000-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4001- 4326 3614 4339 3596 4383 3595 4398 3614
4002-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4003- 4339 3596 4339 3571 4323 3560
4004-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4005- 4339 3572 4382 3572 4390 3560
4006-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4007- 4382 3572 4383 3596
4008-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4009- 4286 3618 4291 3678 4367 3676 4362 3619 4285 3618
4010-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4011- 4290 3677 4305 3658 4350 3659 4367 3676
4012-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4013- 4351 3658 4350 3632 4362 3620
4014-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4015- 4350 3631 4303 3632 4304 3658
4016-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4017- 4303 3632 4287 3619
4018-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4019- 4246 3560 4248 3614 4322 3614 4316 3560 4246 3560
4020-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4021- 4249 3614 4264 3596 4304 3595 4323 3614
4022-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4023- 4264 3596 4263 3571 4246 3560
4024-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4025- 4265 3571 4304 3570 4316 3561
4026-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4027- 4304 3571 4304 3596
4028-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4029- 4210 3618 4210 3675 4288 3675 4283 3619 4210 3618
4030-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4031- 4210 3675 4227 3655 4273 3655 4286 3675 4285 3675
4032-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4033- 4228 3654 4225 3633 4210 3618
4034-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4035- 4224 3632 4273 3632 4283 3620
4036-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4037- 4273 3632 4273 3655
4038-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4039- 4296 3505 4301 3557 4373 3556 4364 3503 4295 3505
4040-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4041- 4303 3556 4315 3537 4359 3537 4372 3556
4042-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4043- 4315 3537 4313 3516 4297 3505
4044-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4045- 4314 3514 4360 3513 4364 3504
4046-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4047- 4360 3515 4359 3537
4048-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 6
4049- 4327 3452 4332 3499 4400 3499 4393 3449 4327 3449 4327 3452
4050-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4051- 4333 3499 4344 3483 4388 3482 4401 3498
4052-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4053- 4388 3482 4386 3459 4392 3449
4054-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4055- 4385 3459 4340 3459 4344 3482
4056-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4057- 4339 3458 4327 3449
4058-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4059- 4254 3445 4259 3498 4327 3498 4318 3446 4254 3446
4060-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4061- 4258 3498 4272 3483 4311 3482 4326 3497
4062-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4063- 4254 3447 4269 3454 4272 3483
4064-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4065- 4271 3454 4311 3454 4320 3445
4066-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4067- 4313 3454 4313 3482
4068-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4069- 4220 3504 4223 3557 4299 3556 4290 3504 4221 3505
4070-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4071- 4224 3557 4239 3538 4283 3538 4299 3555
4072-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4073- 4239 3538 4237 3517 4221 3505
4074-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4075- 4239 3517 4283 3518 4290 3504
4076-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4077- 4283 3519 4282 3538
4078-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4079- 4182 3450 4183 3498 4254 3497 4248 3448 4182 3449
4080-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4081- 4183 3497 4195 3483 4242 3482 4253 3497
4082-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4083- 4195 3484 4193 3456 4182 3448
4084-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4085- 4195 3456 4242 3456 4248 3449
4086-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4087- 4242 3458 4244 3482
4088-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4089- 4147 3505 4149 3556 4219 3556 4215 3504 4147 3503
4090-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4091- 4149 3556 4161 3543 4208 3542 4219 3556
4092-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4093- 4162 3542 4159 3516 4149 3504
4094-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4095- 4159 3515 4208 3515 4214 3504
4096-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4097- 4208 3516 4207 3542
4098-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4099- 4165 3561 4165 3610 4244 3612 4239 3560 4165 3559
4100-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4101- 4165 3612 4180 3599 4232 3598 4243 3611
4102-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4103- 4180 3599 4180 3571 4166 3561
4104-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4105- 4177 3569 4233 3569 4239 3561
4106-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 1
4107- 4239 3561
4108-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4109- 4233 3571 4233 3598
4110-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4111- 4128 3618 4132 3675 4205 3674 4201 3617 4128 3617
4112-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4113- 4133 3674 4146 3659 4193 3659 4203 3673
4114-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4115- 4146 3659 4144 3629 4128 3617
4116-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4117- 4146 3629 4191 3629 4201 3617
4118-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4119- 4191 3630 4193 3659
4120-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4121- 4107 3451 4111 3496 4178 3496 4172 3449 4106 3449
4122-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4123- 4111 3494 4122 3482 4167 3482 4177 3495
4124-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4125- 4123 3482 4121 3460 4108 3450
4126-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4127- 4122 3460 4165 3460 4172 3450
4128-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4129- 4167 3460 4167 3482
4130-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4131- 4071 3502 4073 3555 4146 3556 4140 3504 4071 3503
4132-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4133- 4074 3555 4087 3537 4131 3536 4146 3555
4134-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4135- 4088 3535 4087 3516 4072 3503
4136-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4137- 4088 3516 4131 3516 4140 3504
4138-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4139- 4131 3516 4131 3536
4140-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4141- 4089 3561 4090 3613 4161 3612 4160 3561 4089 3559
4142-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4143- 4091 3614 4104 3599 4151 3599 4161 3612
4144-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4145- 4105 3598 4105 3571 4089 3560
4146-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4147- 4105 3571 4153 3571 4160 3561
4148-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4149- 4154 3571 4152 3599
4150-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4151- 4051 3618 4053 3676 4127 3675 4124 3618 4051 3618
4152-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4153- 4053 3676 4070 3658 4115 3657 4127 3675
4154-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4155- 4072 3658 4069 3631 4051 3618
4156-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4157- 4070 3630 4115 3630 4124 3617
4158-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4159- 4115 3630 4115 3658
4160-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4161- 4036 3447 4036 3499 4102 3499 4098 3446 4036 3446
4162-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4163- 4035 3499 4048 3483 4089 3483 4102 3498
4164-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4165- 4050 3483 4050 3456 4036 3445
4166-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4167- 4050 3455 4090 3455 4098 3446
4168-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4169- 4090 3455 4089 3484
4170-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4171- 3998 3503 3997 3555 4068 3555 4065 3503 3998 3502
4172-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4173- 3997 3555 4012 3538 4056 3538 4068 3555
4174-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4175- 4013 3538 4013 3513 3999 3502
4176-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4177- 4016 3512 4056 3512 4066 3503
4178-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4179- 4057 3513 4056 3538
4180-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4181- 4013 3559 4013 3614 4083 3614 4084 3560 4014 3559
4182-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4183- 4013 3613 4026 3599 4074 3599 4084 3613
4184-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4185- 4028 3599 4027 3573 4014 3559
4186-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4187- 4028 3573 4074 3573 4084 3560
4188-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4189- 4074 3573 4074 3599
4190-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 6
4191- 3975 3618 3975 3676 4047 3676 4047 3618 3975 3618 3976 3617
4192-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4193- 3976 3674 3990 3651 4036 3651 4047 3676
4194-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4195- 3990 3651 3991 3630 3976 3618
4196-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4197- 3991 3630 4033 3630 4047 3620
4198-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4199- 4034 3630 4035 3651
4200-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4201- 3956 3498 4031 3498 4028 3448 3957 3447 3958 3497
4202-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4203- 3958 3498 3976 3479 4015 3478 4031 3497
4204-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4205- 3976 3479 3975 3451 3957 3447
4206-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4207- 3976 3451 4020 3452 4029 3448
4208-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 1
4209- 4029 3450
4210-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4211- 4020 3453 4016 3479
4212-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4213- 3894 3616 3895 3676 3969 3676 3969 3617 3894 3615
4214-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4215- 3896 3676 3911 3658 3952 3658 3969 3675
4216-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4217- 3952 3658 3952 3624 3969 3616
4218-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4219- 3951 3623 3909 3624 3895 3616
4220-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4221- 3910 3625 3912 3659
4222-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4223- 3936 3561 3936 3612 4010 3612 4006 3559 3936 3558
4224-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4225- 3937 3612 3949 3596 3997 3596 4010 3612
4226-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4227- 3997 3595 3998 3563 4006 3560
4228-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4229- 3949 3595 3948 3563 3936 3559
4230-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4231- 3949 3564 3997 3564
4232-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4233- 3922 3507 3922 3553 3993 3553 3993 3504 3921 3504
4234-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4235- 3921 3552 3933 3536 3982 3536 3994 3552
4236-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4237- 3982 3535 3982 3509 3993 3504
4238-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4239- 3982 3509 3933 3508 3921 3504
4240-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4241- 3933 3535 3933 3508
4242-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4243- 3885 3445 3885 3499 3955 3499 3952 3446 3887 3446
4244-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4245- 3885 3499 3900 3479 3940 3479 3954 3499
4246-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4247- 3940 3479 3941 3450 3953 3446
4248-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4249- 3941 3449 3900 3449 3885 3446
4250-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4251- 3899 3450 3900 3479
4252-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4253- 3815 3448 3814 3498 3880 3498 3879 3446 3815 3446
4254-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4255- 3815 3497 3826 3479 3868 3478 3880 3498
4256-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4257- 3868 3478 3868 3449 3879 3446
4258-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4259- 3868 3450 3828 3449 3828 3478
4260-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4261- 3828 3449 3814 3446
4262-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4263- 3847 3503 3845 3558 3915 3558 3917 3503 3847 3501
4264-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4265- 3844 3557 3859 3537 3903 3537 3915 3558
4266-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4267- 3903 3537 3903 3510 3917 3503
4268-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4269- 3903 3510 3857 3510 3858 3536
4270-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4271- 3858 3510 3846 3502
4272-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4273- 3861 3561 3861 3611 3932 3611 3932 3560 3861 3560
4274-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4275- 3862 3611 3876 3594 3921 3594 3931 3610
4276-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4277- 3922 3594 3921 3564 3931 3560
4278-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4279- 3923 3564 3873 3564 3876 3595
4280-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4281- 3874 3564 3861 3560
4282-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 6
4283- 3819 3621 3819 3674 3891 3673 3891 3619 3819 3618 3819 3623
4284-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 1
4285- 3819 3630
4286-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4287- 3819 3674 3832 3654 3878 3654 3890 3672
4288-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 1
4289- 3887 3669
4290-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4291- 3878 3655 3879 3624 3891 3618
4292-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4293- 3880 3625 3829 3624 3831 3654
4294-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4295- 3831 3625 3819 3618
4296-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4297- 3781 3562 3782 3614 3859 3615 3855 3561 3781 3561
4298-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4299- 3783 3615 3796 3594 3845 3594 3859 3614
4300-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4301- 3845 3594 3845 3567 3856 3561
4302-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4303- 3845 3567 3793 3567 3796 3593
4304-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4305- 3794 3567 3781 3562
4306-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 6
4307- 3770 3507 3769 3559 3844 3558 3843 3502 3770 3502 3770 3507
4308-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4309- 3771 3558 3781 3538 3827 3538 3845 3558
4310-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4311- 3827 3538 3827 3510 3843 3503
4312-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4313- 3827 3510 3781 3510 3782 3538
4314-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4315- 3783 3510 3770 3501
4316-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4317- 3740 3448 3737 3497 3808 3497 3806 3447 3740 3446
4318-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4319- 3738 3496 3752 3479 3791 3479 3808 3497
4320-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4321- 3791 3479 3791 3454 3807 3446
4322-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4323- 3791 3454 3753 3454 3753 3479
4324-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4325- 3753 3455 3740 3447
4326-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 1
4327- 3740 3445
4328-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4329- 3682 3621 3674 3676 3812 3674 3814 3620 3682 3620
4330-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4331- 3675 3675 3689 3655 3789 3654 3812 3673
4332-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4333- 3789 3654 3792 3628 3814 3620
4334-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 1
4335- 3814 3620
4336-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4337- 3793 3628 3691 3628 3689 3655
4338-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4339- 3691 3629 3683 3621
4340-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4341- 3687 3561 3683 3615 3779 3615 3776 3561 3686 3561
4342-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4343- 3685 3615 3701 3600 3765 3600 3779 3614
4344-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4345- 3765 3601 3765 3571 3776 3562
4346-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4347- 3765 3572 3700 3572 3701 3601
4348-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4349- 3701 3572 3688 3562
4350-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4351- 3690 3556 3767 3556 3765 3503 3699 3502 3688 3557
4352-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4353- 3691 3556 3705 3533 3739 3531 3768 3556
4354-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4355- 3704 3533 3709 3509 3699 3502
4356-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
4357- 3710 3509 3739 3509 3739 3531
4358-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4359- 3739 3509 3763 3504
4360-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4361- 3703 3442 3738 3442 3734 3500 3699 3500 3704 3441
4362-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4363- 3709 3404 3705 3438 3776 3440 3780 3406 3710 3405
4364-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4365- 3707 3437 3714 3420 3764 3420 3776 3439
4366-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4367- 3765 3420 3766 3407
4368-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4369- 3715 3420 3720 3406
4370-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4371- 3792 3407 3789 3440 3862 3440 3866 3408 3794 3407
4372-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4373- 3789 3441 3800 3430 3854 3428 3864 3440
4374-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4375- 3801 3428 3801 3409
4376-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4377- 3854 3430 3856 3408
4378-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4379- 3874 3410 3872 3439 3930 3440 3932 3409 3873 3409
4380-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4381- 3872 3440 3884 3427 3917 3427 3930 3440
4382-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4383- 3918 3427 3919 3411
4384-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4385- 3884 3427 3886 3409
4386-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4387- 3938 3410 3938 3442 3998 3443 3999 3410 3939 3409
4388-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4389- 3940 3442 3947 3430 3987 3430 3999 3442
4390-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4391- 3948 3430 3949 3409
4392-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4393- 3987 3430 3987 3411
4394-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4395- 4005 3410 4005 3442 4064 3442 4065 3409 4005 3407
4396-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 1
4397- 4007 3407
4398-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4399- 4005 3442 4018 3428 4055 3429 4065 3442
4400-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4401- 4018 3429 4017 3407
4402-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4403- 4055 3429 4055 3409
4404-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4405- 4078 3409 4077 3442 4135 3442 4135 3409 4077 3409
4406-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4407- 4077 3442 4086 3428 4123 3428 4135 3442
4408-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4409- 4086 3428 4086 3409
4410-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4411- 4122 3428 4122 3408
4412-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4413- 4139 3409 4139 3444 4199 3444 4199 3409 4140 3409
4414-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 1
4415- 4139 3407
4416-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4417- 4139 3444 4146 3433 4189 3433 4199 3444
4418-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4419- 4189 3432 4189 3409
4420-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4421- 4146 3433 4146 3409
4422-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4423- 4204 3410 4204 3444 4260 3444 4259 3409 4203 3409
4424-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4425- 4204 3444 4212 3433 4249 3433 4260 3444
4426-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4427- 4213 3433 4213 3408
4428-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4429- 4249 3433 4249 3409
4430-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4431- 4266 3409 4265 3443 4326 3444 4326 3409 4266 3409
4432-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4433- 4267 3444 4276 3432 4318 3432 4325 3444
4434-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4435- 4333 3409 4333 3444 4395 3444 4395 3408 4333 3408
4436-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4437- 4333 3444 4340 3433 4389 3433 4394 3444
4438-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4439- 4341 3433 4340 3407
4440-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4441- 4389 3432 4389 3407
4442-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4443- 4276 3433 4276 3409
4444-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4445- 4320 3432 4320 3409
4446-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4447- 4401 3408 4401 3444 4464 3444 4463 3408 4401 3407
4448-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4449- 4401 3444 4411 3433 4454 3432 4464 3443
4450-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4451- 4412 3432 4412 3408
4452-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4453- 4455 3433 4455 3407
4454-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4455- 4468 3409 4468 3444 4533 3444 4532 3407 4468 3409
4456-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4457- 4469 3445 4477 3435 4523 3435 4534 3444
4458-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4459- 4479 3434 4479 3408
4460-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4461- 4524 3435 4524 3407
4462-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4463- 4537 3406 4538 3445 4597 3444 4595 3406 4537 3406
4464-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4465- 4538 3444 4548 3433 4587 3433 4597 3444
4466-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4467- 4587 3433 4587 3406
4468-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4469- 4550 3433 4549 3407
4470-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4471- 4603 3406 4603 3445 4662 3445 4662 3406 4603 3406
4472-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4473- 4603 3445 4614 3432 4653 3432 4662 3444
4474-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4475- 4615 3432 4615 3407
4476-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4477- 4654 3432 4654 3407
4478-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4479- 4666 3407 4666 3445 4719 3445 4719 3408 4666 3408
4480-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4481- 4667 3445 4676 3432 4713 3432 4718 3445
4482-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4483- 4678 3432 4678 3408
4484-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4485- 4714 3433 4714 3408
4486-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4487- 4725 3410 4725 3446 4789 3446 4781 3407 4725 3409
4488-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4489- 4727 3446 4736 3434 4782 3434 4790 3445
4490-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4491- 4782 3434 4776 3409
4492-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4493- 4738 3433 4736 3409
4494-2 2 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
4495- 4760 3375 4784 3375 4784 3387 4760 3387 4760 3375
4496-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
4497- 4081 2482 4085 2510 4409 2507 4410 2480
4498-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
4499- 4331 3685 4352 3678
4500--6
4501-6 7065 2430 11430 3510
4502-6 10752 2603 10922 2754
4503-6 10752 2603 10922 2678
4504-1 3 0 1 0 4 50 0 25 0.000 1 0.0000 10790 2641 27 27 10790 2641 10809 2660
4505-1 3 0 1 0 4 50 0 25 0.000 1 0.0000 10884 2641 27 27 10884 2641 10904 2660
4506--6
4507-6 10752 2678 10922 2754
4508-1 3 0 1 0 14 50 0 25 0.000 1 0.0000 10790 2715 27 27 10790 2715 10809 2735
4509-1 3 0 1 0 14 50 0 25 0.000 1 0.0000 10884 2715 27 27 10884 2715 10904 2735
4510--6
4511--6
4512-6 7517 2623 8894 3297
4513-6 7517 2623 8894 2869
4514-5 1 0 1 0 38 49 0 1 0.000 0 1 0 0 8194.000 1223.581 7517 2623 8216 2778 8871 2623
4515-2 2 0 1 0 38 50 0 6 0.000 0 0 7 0 0 5
4516- 7517 2623 8894 2623 8894 2869 7517 2869 7517 2623
4517--6
4518-6 7517 3050 8894 3297
4519-5 1 0 1 0 38 49 0 1 0.000 0 1 0 0 8194.000 1670.395 7517 3050 8216 3207 8871 3050
4520-2 2 0 1 0 38 50 0 6 0.000 0 0 7 0 0 5
4521- 7517 3050 8894 3050 8894 3297 7517 3297 7517 3050
4522--6
4523--6
4524-6 9073 2623 10453 3297
4525-6 9073 2623 10453 2869
4526-5 1 0 1 0 38 49 0 1 0.000 0 1 0 0 9751.000 1219.355 9073 2623 9774 2778 10429 2623
4527-2 2 0 1 0 38 50 0 6 0.000 0 0 7 0 0 5
4528- 9073 2623 10453 2623 10453 2869 9073 2869 9073 2623
4529--6
4530-6 9073 3050 10453 3297
4531-5 1 0 1 0 38 49 0 1 0.000 0 1 0 0 9751.000 1666.223 9073 3050 9774 3207 10429 3050
4532-2 2 0 1 0 38 50 0 6 0.000 0 0 7 0 0 5
4533- 9073 3050 10453 3050 10453 3297 9073 3297 9073 3050
4534--6
4535--6
4536-2 2 0 1 0 7 49 -1 20 0.000 0 0 -1 0 0 5
4537- 7065 2475 7965 2475 7965 2970 7065 2970 7065 2475
4538-2 4 0 1 0 7 50 0 -1 0.000 0 0 3 0 0 5
4539- 10959 3373 10959 2565 10734 2565 10734 3373 10959 3373
4540-2 4 0 1 0 43 50 0 9 0.000 0 0 3 0 0 5
4541- 11354 3410 11354 2490 11053 2490 11053 3410 11354 3410
4542-2 4 0 1 0 43 50 0 27 0.000 0 0 3 0 0 5
4543- 10922 3317 10922 3053 10771 3053 10771 3317 10922 3317
4544-2 2 0 1 0 42 53 0 15 0.000 0 0 7 0 0 5
4545- 7065 2453 11411 2453 11411 3467 7065 3467 7065 2453
4546-2 4 0 1 0 43 50 0 9 0.000 0 0 3 0 0 5
4547- 7442 3410 7442 2490 7141 2490 7141 3410 7442 3410
4548-4 0 0 40 -1 16 20 0.0000 4 240 735 7155 2835 BMC\001
4549--6
4550-6 7065 3870 11430 4995
4551-# Rack mounted PC
4552-# Drawn by Andre Esser
4553-6 7065 3870 11430 4961
4554-6 10752 4043 10922 4194
4555-6 10752 4043 10922 4118
4556-1 3 0 1 0 4 50 0 25 0.000 1 0.0000 10790 4081 27 27 10790 4081 10809 4100
4557-1 3 0 1 0 4 50 0 25 0.000 1 0.0000 10884 4081 27 27 10884 4081 10904 4100
4558--6
4559-6 10752 4118 10922 4194
4560-1 3 0 1 0 14 50 0 25 0.000 1 0.0000 10790 4155 27 27 10790 4155 10809 4175
4561-1 3 0 1 0 14 50 0 25 0.000 1 0.0000 10884 4155 27 27 10884 4155 10904 4175
4562--6
4563--6
4564-6 7517 4063 8894 4737
4565-6 7517 4063 8894 4309
4566-5 1 0 1 0 38 49 0 1 0.000 0 1 0 0 8194.000 2663.581 7517 4063 8216 4218 8871 4063
4567-2 2 0 1 0 38 50 0 6 0.000 0 0 7 0 0 5
4568- 7517 4063 8894 4063 8894 4309 7517 4309 7517 4063
4569--6
4570-6 7517 4490 8894 4737
4571-5 1 0 1 0 38 49 0 1 0.000 0 1 0 0 8194.000 3110.395 7517 4490 8216 4647 8871 4490
4572-2 2 0 1 0 38 50 0 6 0.000 0 0 7 0 0 5
4573- 7517 4490 8894 4490 8894 4737 7517 4737 7517 4490
4574--6
4575--6
4576-6 9073 4063 10453 4737
4577-6 9073 4063 10453 4309
4578-5 1 0 1 0 38 49 0 1 0.000 0 1 0 0 9751.000 2659.355 9073 4063 9774 4218 10429 4063
4579-2 2 0 1 0 38 50 0 6 0.000 0 0 7 0 0 5
4580- 9073 4063 10453 4063 10453 4309 9073 4309 9073 4063
4581--6
4582-6 9073 4490 10453 4737
4583-5 1 0 1 0 38 49 0 1 0.000 0 1 0 0 9751.000 3106.223 9073 4490 9774 4647 10429 4490
4584-2 2 0 1 0 38 50 0 6 0.000 0 0 7 0 0 5
4585- 9073 4490 10453 4490 10453 4737 9073 4737 9073 4490
4586--6
4587--6
4588-2 4 0 1 0 7 50 0 -1 0.000 0 0 3 0 0 5
4589- 10959 4813 10959 4005 10734 4005 10734 4813 10959 4813
4590-2 4 0 1 0 43 50 0 9 0.000 0 0 3 0 0 5
4591- 7442 4850 7442 3930 7141 3930 7141 4850 7442 4850
4592-2 4 0 1 0 43 50 0 9 0.000 0 0 3 0 0 5
4593- 11354 4850 11354 3930 11053 3930 11053 4850 11354 4850
4594-2 4 0 1 0 43 50 0 27 0.000 0 0 3 0 0 5
4595- 10922 4757 10922 4493 10771 4493 10771 4757 10922 4757
4596-2 2 0 1 0 42 53 0 15 0.000 0 0 7 0 0 5
4597- 7065 3893 11411 3893 11411 4907 7065 4907 7065 3893
4598--6
4599-2 2 0 1 0 7 49 -1 20 0.000 0 0 -1 0 0 5
4600- 7065 3915 7965 3915 7965 4410 7065 4410 7065 3915
4601-4 0 0 40 -1 16 20 0.0000 4 240 735 7155 4275 BMC\001
4602--6
4603-6 7065 900 11430 2025
4604-# Rack mounted PC
4605-# Drawn by Andre Esser
4606-6 7065 900 11430 1991
4607-6 10752 1073 10922 1224
4608-6 10752 1073 10922 1148
4609-1 3 0 1 0 4 50 0 25 0.000 1 0.0000 10790 1111 27 27 10790 1111 10809 1130
4610-1 3 0 1 0 4 50 0 25 0.000 1 0.0000 10884 1111 27 27 10884 1111 10904 1130
4611--6
4612-6 10752 1148 10922 1224
4613-1 3 0 1 0 14 50 0 25 0.000 1 0.0000 10790 1185 27 27 10790 1185 10809 1205
4614-1 3 0 1 0 14 50 0 25 0.000 1 0.0000 10884 1185 27 27 10884 1185 10904 1205
4615--6
4616--6
4617-6 7517 1093 8894 1767
4618-6 7517 1093 8894 1339
4619-5 1 0 1 0 38 49 0 1 0.000 0 1 0 0 8194.000 -306.419 7517 1093 8216 1248 8871 1093
4620-2 2 0 1 0 38 50 0 6 0.000 0 0 7 0 0 5
4621- 7517 1093 8894 1093 8894 1339 7517 1339 7517 1093
4622--6
4623-6 7517 1520 8894 1767
4624-5 1 0 1 0 38 49 0 1 0.000 0 1 0 0 8194.000 140.395 7517 1520 8216 1677 8871 1520
4625-2 2 0 1 0 38 50 0 6 0.000 0 0 7 0 0 5
4626- 7517 1520 8894 1520 8894 1767 7517 1767 7517 1520
4627--6
4628--6
4629-6 9073 1093 10453 1767
4630-6 9073 1093 10453 1339
4631-5 1 0 1 0 38 49 0 1 0.000 0 1 0 0 9751.000 -310.645 9073 1093 9774 1248 10429 1093
4632-2 2 0 1 0 38 50 0 6 0.000 0 0 7 0 0 5
4633- 9073 1093 10453 1093 10453 1339 9073 1339 9073 1093
4634--6
4635-6 9073 1520 10453 1767
4636-5 1 0 1 0 38 49 0 1 0.000 0 1 0 0 9751.000 136.223 9073 1520 9774 1677 10429 1520
4637-2 2 0 1 0 38 50 0 6 0.000 0 0 7 0 0 5
4638- 9073 1520 10453 1520 10453 1767 9073 1767 9073 1520
4639--6
4640--6
4641-2 4 0 1 0 7 50 0 -1 0.000 0 0 3 0 0 5
4642- 10959 1843 10959 1035 10734 1035 10734 1843 10959 1843
4643-2 4 0 1 0 43 50 0 9 0.000 0 0 3 0 0 5
4644- 7442 1880 7442 960 7141 960 7141 1880 7442 1880
4645-2 4 0 1 0 43 50 0 9 0.000 0 0 3 0 0 5
4646- 11354 1880 11354 960 11053 960 11053 1880 11354 1880
4647-2 4 0 1 0 43 50 0 27 0.000 0 0 3 0 0 5
4648- 10922 1787 10922 1523 10771 1523 10771 1787 10922 1787
4649-2 2 0 1 0 42 53 0 15 0.000 0 0 7 0 0 5
4650- 7065 923 11411 923 11411 1937 7065 1937 7065 923
4651--6
4652-2 2 0 1 0 7 49 -1 20 0.000 0 0 -1 0 0 5
4653- 7065 945 7965 945 7965 1440 7065 1440 7065 945
4654-4 0 0 40 -1 16 20 0.0000 4 240 735 7155 1305 BMC\001
4655--6
4656-2 1 0 3 0 7 50 -1 -1 0.000 0 0 -1 0 0 2
4657- 6390 3150 4770 3150
4658-2 1 0 3 0 7 50 -1 -1 0.000 0 0 -1 0 0 2
4659- 3690 3150 2115 3150
4660-2 1 0 3 0 7 50 -1 -1 0.000 0 0 -1 0 0 2
4661- 7065 2700 6390 2700
4662-2 1 0 3 0 7 50 -1 -1 0.000 0 0 -1 0 0 2
4663- 7065 1665 6390 1665
4664-2 1 0 3 0 7 50 -1 -1 0.000 0 0 -1 0 0 2
4665- 7065 3330 6390 3330
4666-2 1 0 3 0 7 50 -1 -1 0.000 0 0 -1 0 0 4
4667- 7065 1170 6390 1170 6390 4185 7065 4185
4668-2 1 0 3 0 7 50 -1 20 0.000 0 0 -1 0 0 3
4669- 6390 4185 6390 4635 7065 4635
4670-4 0 0 50 -1 16 24 0.0000 4 300 1395 495 4185 Internet\001
4671-4 0 0 50 -1 16 24 0.0000 4 300 2040 135 4635 or site LAN\001
4672-4 0 0 50 -1 16 24 0.0000 4 300 795 5130 2925 eth0\001
4673-4 0 0 50 -1 16 24 0.0000 4 375 3435 2610 4320 Portable Computer\001
4674-4 0 0 50 -1 16 24 0.0000 4 300 2475 3015 4770 MAAS Server\001
4675-4 0 0 50 -1 16 24 0.0000 4 300 1065 2385 2880 wlan0\001
4676-4 0 0 50 -1 16 24 0.0000 4 300 1275 2295 2385 eth1 or\001
4677-4 0 0 50 -1 16 24 0.0000 4 300 1170 11610 1620 SUT 1\001
4678-4 0 0 50 -1 16 24 0.0000 4 300 1170 11610 3060 SUT 2\001
4679-4 0 0 50 -1 16 24 0.0000 4 300 1170 11610 4545 SUT 3\001
4680-4 0 0 50 -1 16 24 0.0000 4 300 2070 8100 5670 MAAS LAN\001
4681
4682=== removed file 'documentation/images/maniac-network.png'
4683Binary files documentation/images/maniac-network.png 2015-07-17 19:42:06 +0000 and documentation/images/maniac-network.png 1970-01-01 00:00:00 +0000 differ
4684=== removed file 'documentation/images/secure_id.png'
4685Binary files documentation/images/secure_id.png 2015-07-17 19:42:06 +0000 and documentation/images/secure_id.png 1970-01-01 00:00:00 +0000 differ
4686=== removed file 'documentation/images/some_tests.png'
4687Binary files documentation/images/some_tests.png 2015-07-17 19:42:06 +0000 and documentation/images/some_tests.png 1970-01-01 00:00:00 +0000 differ
4688=== removed directory 'documentation/styles'
4689=== removed file 'documentation/styles/cert-doc.style'
4690--- documentation/styles/cert-doc.style 2015-07-17 19:42:06 +0000
4691+++ documentation/styles/cert-doc.style 1970-01-01 00:00:00 +0000
4692@@ -1,603 +0,0 @@
4693-
4694- # List any fonts you would like to embed in the PDF here
4695- embeddedFonts: [ ["Ubuntu-R.ttf", "Ubuntu-B.ttf", "Ubuntu-RI.ttf",
4696- "Ubuntu-BI.ttf" ],
4697- ["UbuntuMono-R.ttf", "UbuntuMono-B.ttf",
4698- "UbuntuMono-RI.ttf", "UbuntuMono-BI.ttf"] ]
4699- # Default page setup. Can be overridden by including other
4700- # stylesheets with -s
4701-
4702- pageSetup:
4703- size: letter
4704- width: null
4705- height: null
4706- margin-top: 2cm
4707- margin-bottom: 2cm
4708- margin-left: 2cm
4709- margin-right: 2cm
4710- margin-gutter: 0cm
4711- spacing-header: 5mm
4712- spacing-footer: 10mm
4713-
4714- # The first template is one of the 'pageTemplates"
4715- # (See next section)
4716-
4717- firstTemplate: coverPage
4718-
4719- # pageTemplates can be accessed with the .. raw:: pdf PageBreak command
4720-
4721- pageTemplates:
4722- coverPage:
4723- background: images/cover-background.png
4724- frames: []
4725- [0cm, 0cm, 100%, 100%]
4726- showHeader : false
4727- showFooter : false
4728-
4729- emptyPage:
4730- frames: []
4731- [0cm, 0cm, 100%, 100%]
4732- showHeader : false
4733- showFooter : false
4734-
4735- oneColumn:
4736- frames: []
4737- [0cm, 0cm, 100%, 100%]
4738- showHeader : true
4739- showFooter : true
4740-
4741- twoColumn:
4742- frames: []
4743- [0cm, 0cm, 49%, 100%]
4744- [51%, 0cm, 49%, 100%]
4745- showHeader : true
4746- showFooter : true
4747-
4748- threeColumn:
4749- frames: []
4750- [2%, 0cm, 29.333%, 100%]
4751- [35.333%, 0cm, 29.333%, 100%]
4752- [68.666%, 0cm, 29.333%, 100%]
4753- showHeader : true
4754- showFooter : true
4755-
4756- cutePage:
4757- frames: []
4758- [0%, 0%, 100%, 100%]
4759- showHeader : true
4760- showFooter : true
4761- defaultFooter : ###Page###
4762- defaultHeader : ###Section###
4763-
4764- fontsAlias:
4765- stdFont: Ubuntu-R
4766- stdBold: Ubuntu-B
4767- stdItalic: Ubuntu-RI
4768- stdBoldItalic: Ubuntu-BI
4769- stdSans: Ubuntu-R
4770- stdSansBold: Ubuntu-B
4771- stdSansItalic: Ubuntu-RI
4772- stdSansBoldItalic: Ubuntu-BI
4773- stdMono: UbuntuMono-R
4774- stdMonoItalic: UbuntuMono-RI
4775- stdMonoBold: UbuntuMono-B
4776- stdMonoBoldItalic: UbuntuMono-BI
4777- stdSerif: Times-Roman
4778-
4779- linkColor: #606060
4780-
4781- styles:
4782- base:
4783- parent: null
4784- fontName: stdFont
4785- fontSize: 12
4786- leading: 15
4787- leftIndent: 0
4788- rightIndent: 0
4789- firstLineIndent: 0
4790- alignment: TA_LEFT
4791- spaceBefore: 0
4792- spaceAfter: 0
4793- bulletFontName: stdFont
4794- bulletFontSize: 12
4795- bulletIndent: 0
4796- textColor: #303030
4797- backColor: null
4798- wordWrap: null
4799- borderWidth: 0
4800- borderPadding: 0
4801- borderColor: null
4802- borderRadius: null
4803- allowWidows: false
4804- allowOrphans: false
4805- hyphenation: false
4806- kerning: false
4807- underline: false
4808- strike: false
4809- commands: []
4810-
4811- normal:
4812- parent: base
4813-
4814- aubergine:
4815- textColor: 6c0149
4816-
4817- aubergine-right:
4818- textColor: ff0050
4819- alignment: TA_CENTER
4820-
4821- title-reference:
4822- parent: normal
4823- fontName: stdItalic
4824-
4825- bodytext:
4826- parent: normal
4827- spaceBefore: 6
4828- alignment: TA_LEFT
4829- hyphenation: true
4830-
4831- toc:
4832- parent: normal
4833-
4834- blockquote:
4835- parent: bodytext
4836- leftIndent: 20
4837-
4838- lineblock:
4839- parent: bodytext
4840-
4841- line:
4842- parent: lineblock
4843- spaceBefore: 0
4844-
4845- toc1:
4846- parent: toc
4847- fontName: stdBold
4848-
4849- toc2:
4850- parent: toc
4851- leftIndent: 20
4852-
4853- toc3:
4854- parent: toc
4855- leftIndent: 40
4856-
4857- toc4:
4858- parent: toc
4859- leftIndent: 60
4860-
4861- toc5:
4862- parent: toc
4863- leftIndent: 80
4864-
4865- toc6:
4866- parent: toc
4867- leftIndent: 100
4868-
4869- toc7:
4870- parent: toc
4871- leftIndent: 100
4872-
4873- toc8:
4874- parent: toc
4875- leftIndent: 100
4876-
4877- toc9:
4878- parent: toc
4879- leftIndent: 100
4880-
4881- toc10:
4882- parent: toc
4883- leftIndent: 100
4884-
4885- toc11:
4886- parent: toc
4887- leftIndent: 100
4888-
4889- toc12:
4890- parent: toc
4891- leftIndent: 100
4892-
4893- toc13:
4894- parent: toc
4895- leftIndent: 100
4896-
4897- toc14:
4898- parent: toc
4899- leftIndent: 100
4900-
4901- toc15:
4902- parent: toc
4903- leftIndent: 100
4904-
4905- footer:
4906- parent: normal
4907- fontSize: 32
4908- alignment: TA_RIGHT
4909- backColor: 6c0149
4910-
4911- header:
4912- parent: normal
4913- fontSize: 24
4914- alignment: TA_LEFT
4915- backColor: black
4916-
4917-
4918- attribution:
4919- parent: bodytext
4920- alignment: TA_RIGHT
4921-
4922- image:
4923- parent: bodytext
4924- alignment: TA_CENTER
4925-
4926- figure:
4927- parent: bodytext
4928- alignment: TA_CENTER
4929- commands: []
4930- [VALIGN, [ 0, 0 ], [ -1, -1 ], TOP ]
4931- [ALIGN, [ 0, 0 ], [ -1, -1 ], CENTER ]
4932- colWidths: [100%]
4933-
4934- figure-caption:
4935- parent: bodytext
4936- fontName: stdItalic
4937- textColor: 6c0149
4938- alignment: TA_LEFT
4939-
4940- figure-legend:
4941- parent: bodytext
4942-
4943- bullet-list:
4944- parent: bodytext
4945- spaceBefore: 0
4946- commands: []
4947- [VALIGN, [ 0, 0 ], [ -1, -1 ], TOP ]
4948- [RIGHTPADDING, [ 0, 0 ], [ 1, -1 ], 0 ]
4949- colWidths: ["20", null]
4950-
4951- bullet-list-item:
4952- parent: bodytext
4953-
4954- item-list:
4955- parent: bodytext
4956- commands: []
4957- [VALIGN, [ 0, 0 ], [ -1, -1 ], TOP ]
4958- [RIGHTPADDING, [ 0, 0 ], [ 1, -1 ], 0 ]
4959- colWidths: [25pt,null]
4960-
4961- item-list-item:
4962- parent: bodytext
4963-
4964- definition-list-term:
4965- parent: normal
4966- fontName: stdBold
4967- spaceBefore: 4
4968- spaceAfter: 0
4969- keepWithNext: false
4970-
4971- definition-list-classifier:
4972- parent: normal
4973- fontName: stdItalic
4974-
4975- definition:
4976- parent: bodytext
4977- firstLineIndent: 0
4978- bulletIndent: 0
4979- spaceBefore: 0
4980- colWidths: [20pt,null]
4981- commands: []
4982- [VALIGN, [ 0, 0 ], [ -1, -1 ], TOP ]
4983- [LEFTPADDING, [ 0, 0 ], [ -1, -1 ], 0 ]
4984- [BOTTOMPADDING, [ 0, 0 ], [ -1, -1 ], 0 ]
4985- [RIGHTPADDING, [ 0, 0 ], [ -1, -1 ], 0 ]
4986-
4987- fieldname:
4988- parent: bodytext
4989- alignment: TA_RIGHT
4990- fontName: stdBold
4991-
4992- fieldvalue:
4993- parent: bodytext
4994-
4995- rubric:
4996- parent: bodytext
4997- textColor: darkred
4998- alignment: TA_CENTER
4999-
5000- italic:
The diff has been truncated for viewing.

Subscribers

People subscribed via source and target branches

to status/vote changes: