From c021c2ead2970ba474eba9f68a7bc230e3c29b93 Mon Sep 17 00:00:00 2001 From: Jose Lamego Date: Fri, 8 Jun 2018 13:47:25 -0500 Subject: [PATCH 01/63] kata-containers: add tutorial This tutorial describes how to install, configure and run Kata Containers on Clear Linux. Signed-off-by: Jose Lamego --- source/clear-linux/tutorials/kata.rst | 81 ++++++++++++++++++++++ source/clear-linux/tutorials/tutorials.rst | 1 + 2 files changed, 82 insertions(+) create mode 100644 source/clear-linux/tutorials/kata.rst diff --git a/source/clear-linux/tutorials/kata.rst b/source/clear-linux/tutorials/kata.rst new file mode 100644 index 00000000..7f886e58 --- /dev/null +++ b/source/clear-linux/tutorials/kata.rst @@ -0,0 +1,81 @@ + .. _kata: + +Install Kata Containers +####################### + +This tutorial describes how to install, configure and run Kata Containers on +|CLOSIA|. Kata Containers is an open source project and community working to +build a standard implementation of lightweight Virtual Machines (VMs) that feel +and perform like containers, but provide the workload isolation and security +advantages of VMs. Kata Containers is available in Clear Linux versions above 22860. + +Prerequisites +************* + +This tutorial assumes you have installed |CL| on your host system. +For detailed instructions on installing |CL| on a bare metal system, visit +the :ref:`bare metal installation tutorial`. + +Before you install any new packages, update |CL| with the following command: + +.. code-block:: bash + + sudo swupd update + +Install Kata Containers +*********************** + +Kata Containers is included in the :file:`containers-virt` bundle. To install the +framework, enter: + +.. code-block:: bash + + sudo swupd bundle-add containers-virt + +Configure Docker to use Kata Containers by default + +.. code-block:: bash + + sudo mkdir -p /etc/systemd/system/docker.service.d/ + cat < Date: Sun, 10 Jun 2018 19:51:13 -0700 Subject: [PATCH 02/63] mixin: add --bundle flag information Add information for latest functionality of the mixin package subcommand. The --bundle flag allows users to specify the name of the bundle they add their package to. Signed-off-by: Matthew Johnson --- source/clear-linux/guides/maintenance/mixin.rst | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/source/clear-linux/guides/maintenance/mixin.rst b/source/clear-linux/guides/maintenance/mixin.rst index b4ed23d5..c5b23d69 100644 --- a/source/clear-linux/guides/maintenance/mixin.rst +++ b/source/clear-linux/guides/maintenance/mixin.rst @@ -78,13 +78,15 @@ package. .. code-block:: console - $ sudo mixin package add [package-name] [--build] + $ sudo mixin package add [package-name] [--bundle bundle-name] [--build] This command will add package-name to a bundle that is named after its parent repository. For example, if the RPM was provided locally, it will be added to the 'local' bundle. If it came from a repo that was added with :command:`mixin -repo add` it will be added to a bundle named after the repo-name. The `--build` -flag tells :command:`mixin` to run a `mixer` build after adding the package. +repo add` it will be added to a bundle named after the repo-name. If the +`--bundle bundle-name` flag is provided the package will be added to +`bundle-name` instead. The `--build` flag tells :command:`mixin` to run a +`mixer` build after adding the package. To add more than one RPM to your previously-created bundle, repeat the :command:`mixin package add` command and change the package name. Do not add From d167321df166fdf73a83c599d50f87520bd27d26 Mon Sep 17 00:00:00 2001 From: Jose Lamego Date: Mon, 11 Jun 2018 13:48:00 -0500 Subject: [PATCH 03/63] Update kata.rst --- source/clear-linux/tutorials/kata.rst | 34 +++++++++++++-------------- 1 file changed, 17 insertions(+), 17 deletions(-) diff --git a/source/clear-linux/tutorials/kata.rst b/source/clear-linux/tutorials/kata.rst index 7f886e58..841dc083 100644 --- a/source/clear-linux/tutorials/kata.rst +++ b/source/clear-linux/tutorials/kata.rst @@ -1,13 +1,13 @@ .. _kata: -Install Kata Containers +Install Kata Containers\* ####################### -This tutorial describes how to install, configure and run Kata Containers on -|CLOSIA|. Kata Containers is an open source project and community working to +This tutorial describes how to install, configure and run Kata Containers\* on +|CLOSIA|. Kata Containers\* is an open source project and community working to build a standard implementation of lightweight Virtual Machines (VMs) that feel and perform like containers, but provide the workload isolation and security -advantages of VMs. Kata Containers is available in Clear Linux versions above 22860. +advantages of VMs. Kata Containers\* is available in Clear Linux versions above 22860. Prerequisites ************* @@ -22,17 +22,17 @@ Before you install any new packages, update |CL| with the following command: sudo swupd update -Install Kata Containers +Install Kata Containers\* *********************** -Kata Containers is included in the :file:`containers-virt` bundle. To install the +Kata Containers\* is included in the :file:`containers-virt` bundle. To install the framework, enter: .. code-block:: bash sudo swupd bundle-add containers-virt -Configure Docker to use Kata Containers by default +Configure Docker to use Kata Containers\* by default .. code-block:: bash @@ -43,14 +43,14 @@ Configure Docker to use Kata Containers by default ExecStart=/usr/bin/dockerd -D --add-runtime kata-runtime=/usr/bin/kata-runtime --default-runtime=kata-runtime EOF -Restart the Docker\* and Kata Containers systemd services +Restart the Docker\* and Kata Containers\* systemd services .. code-block:: bash sudo systemctl daemon-reload sudo systemctl restart docker -Run Kata Containers +Run Kata Containers\* ******************* .. code-block:: bash @@ -59,19 +59,19 @@ Run Kata Containers **Congratulations!** -You successfully installed and set up Kata Containers on |CLOSIA|. +You successfully installed and set up Kata Containers\* on |CLOSIA|. -More information about Docker in |CLOSIA|. +More information about Docker\* in |CLOSIA|. ############################################# -Docker on |CLOSIA| provides a docker.service service file to start the docker +Docker\* on |CLOSIA| provides a docker.service service file to start the Docker\* daemon. The daemon will use runc or cc-runtime depending on the environment: -If you are running Clear Linux on baremetal or on a VM with Nested -Virtualization activated, docker will use cc-runtime as the default runtime. -If you are running Clear Linux on a VM without Nested Virtualization, docker -will use runc as the default runtime. It is not necessary to configure Docker -to use cc-runtime manually since Docker itself will automatically use this +If you are running |CL| on baremetal or on a VM with Nested +Virtualization activated, Docker\* will use cc-runtime as the default runtime. +If you are running |CL| on a VM without Nested Virtualization, Docker\* +will use runc as the default runtime. It is not necessary to configure Docker\* +to use cc-runtime manually since Docker\* itself will automatically use this runtime on systems that support it. To check which runtime your system is using, run: From 98a160e42987f35e0bb45df25763e48601e65cec Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Wed, 13 Jun 2018 13:23:29 -0700 Subject: [PATCH 04/63] added mixer concept page --- source/clear-linux/concepts/mixer-about.rst | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) create mode 100644 source/clear-linux/concepts/mixer-about.rst diff --git a/source/clear-linux/concepts/mixer-about.rst b/source/clear-linux/concepts/mixer-about.rst new file mode 100644 index 00000000..31e7798f --- /dev/null +++ b/source/clear-linux/concepts/mixer-about.rst @@ -0,0 +1,16 @@ +.. _mixer-about: + +Mixer +####### + +Mixing refers to composing a custom, versioned image of |CLOSIA| for a specific use case. While upstream |CL| provides options to install bundles for various capabilities, some developers and OSVs may wish to either augment the operating system with functionality from their own packages or modify the structure of current bundles. Mixing offers a method to add capabilities while retaining the version consistency and controlled update stream of |CL| by creating a new distributable image. + +Mixing is a multi-step process that starts with installing the mixer bundle using swupd. You will also need a working knowledge of :abbr:`RPMs (RPM Package Manager files)` and how |CL| bundles work. For a detailed guide on how to create a |CL| mix, visit :ref:`mixer`. + +Related Concepts +================ + +# :ref:`swupd_about` +# :ref:`bundles_about` + + From 266c4938fe66302194d385b1f01243d161e3f759 Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Wed, 13 Jun 2018 13:34:46 -0700 Subject: [PATCH 05/63] corrected error in list syntax --- source/clear-linux/concepts/mixer-about.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/clear-linux/concepts/mixer-about.rst b/source/clear-linux/concepts/mixer-about.rst index 31e7798f..c1e85feb 100644 --- a/source/clear-linux/concepts/mixer-about.rst +++ b/source/clear-linux/concepts/mixer-about.rst @@ -10,7 +10,7 @@ Mixing is a multi-step process that starts with installing the mixer bundle usin Related Concepts ================ -# :ref:`swupd_about` -# :ref:`bundles_about` +* :ref:`swupd_about` +* :ref:`bundles_about` From 5f1968ff8363428f12ff839e569bd403ffaf5ecf Mon Sep 17 00:00:00 2001 From: Michael Vincerra Date: Wed, 13 Jun 2018 15:19:13 -0700 Subject: [PATCH 06/63] Adds punctuation for clarity and fixes sphinx syntax. Signed-off-by: Michael Vincerra --- source/clear-linux/guides/maintenance/mixin.rst | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/source/clear-linux/guides/maintenance/mixin.rst b/source/clear-linux/guides/maintenance/mixin.rst index c5b23d69..862332b2 100644 --- a/source/clear-linux/guides/maintenance/mixin.rst +++ b/source/clear-linux/guides/maintenance/mixin.rst @@ -82,16 +82,16 @@ package. This command will add package-name to a bundle that is named after its parent repository. For example, if the RPM was provided locally, it will be added to -the 'local' bundle. If it came from a repo that was added with :command:`mixin -repo add` it will be added to a bundle named after the repo-name. If the -`--bundle bundle-name` flag is provided the package will be added to -`bundle-name` instead. The `--build` flag tells :command:`mixin` to run a -`mixer` build after adding the package. +the 'local' bundle. If it came from a repo that was added with +:command:`mixin repo add`, it will be added to a bundle named after the +repo-name. If the `--bundle bundle-name` flag is provided, the package will +be added to `bundle-name` instead. The `--build` flag tells :command:`mixin` +to run a `mixer` build after adding the package. To add more than one RPM to your previously-created bundle, repeat -the :command:`mixin package add` command and change the package name. Do not add -the `--build` flag until all packages have been added. Once done adding packages -run the following to create your local mix. +the :command:`mixin package add` command and change the package name. Do not +add the `--build` flag until all packages have been added. Once done adding +packages, run the following to create your local mix. .. code-block:: console From 5d66e6b749537a4c6b69ee5ea55f3ff974cc7276 Mon Sep 17 00:00:00 2001 From: Matthew Johnson Date: Thu, 14 Jun 2018 08:56:26 -0700 Subject: [PATCH 07/63] swupd: fix autoupdate documentation The autoupdate subcommand has been around for a very long time now and should be used instead of the systemctl masking commands. Signed-off-by: Matthew Johnson --- source/clear-linux/concepts/swupd-about.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/clear-linux/concepts/swupd-about.rst b/source/clear-linux/concepts/swupd-about.rst index 77b9ffaf..17bce34d 100644 --- a/source/clear-linux/concepts/swupd-about.rst +++ b/source/clear-linux/concepts/swupd-about.rst @@ -95,11 +95,11 @@ patches. Clear Linux OS will automatically check for updates and apply them. This default can be disabled by running:: - # systemctl mask swupd-update.timer + # swupd autoupdate --disable And reenabled by running:: - # systemctl unmask swupd-update.timer + # swupd autoupdate --enable Update speed From db0250a59becc14819514369223bb511e3d10579 Mon Sep 17 00:00:00 2001 From: Matthew Johnson Date: Thu, 14 Jun 2018 09:00:25 -0700 Subject: [PATCH 08/63] swupd: they really are called binary-deltas Signed-off-by: Matthew Johnson --- source/clear-linux/concepts/swupd-about.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/clear-linux/concepts/swupd-about.rst b/source/clear-linux/concepts/swupd-about.rst index 77b9ffaf..e63f2ad3 100644 --- a/source/clear-linux/concepts/swupd-about.rst +++ b/source/clear-linux/concepts/swupd-about.rst @@ -107,7 +107,7 @@ Update speed Software updates with Clear Linux OS for Intel Architecture are also efficient. Bundles simply describe a set of files, and the update -technology updates *only* files that actually changed by using so-called +technology updates *only* files that actually changed by using binary-delta technology for efficiency [1]_. Operating systems that use packages as the unit of deployment require full package updates (thus hogging resources), even when one small file in that package has changed. From 2a10118cd787f48ae41111f9c7817e484cadfff7 Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Thu, 14 Jun 2018 10:49:27 -0700 Subject: [PATCH 09/63] improved wording of first paragraph for clarity --- source/clear-linux/concepts/mixer-about.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/clear-linux/concepts/mixer-about.rst b/source/clear-linux/concepts/mixer-about.rst index c1e85feb..9be35835 100644 --- a/source/clear-linux/concepts/mixer-about.rst +++ b/source/clear-linux/concepts/mixer-about.rst @@ -3,7 +3,7 @@ Mixer ####### -Mixing refers to composing a custom, versioned image of |CLOSIA| for a specific use case. While upstream |CL| provides options to install bundles for various capabilities, some developers and OSVs may wish to either augment the operating system with functionality from their own packages or modify the structure of current bundles. Mixing offers a method to add capabilities while retaining the version consistency and controlled update stream of |CL| by creating a new distributable image. +Mixing refers to composing a custom, versioned image of |CLOSIA| for a specific use case. While upstream |CL| provides options to install bundles for various capabilities, some developers and OSVs may wish to either augment the operating system with functionality from their own packages or modify the structure of current bundles. Mixing offers a method to add capabilities while retaining the ability to stay up to date with an upstream version of |CL| and independently manage their new distributable image. Mixing is a multi-step process that starts with installing the mixer bundle using swupd. You will also need a working knowledge of :abbr:`RPMs (RPM Package Manager files)` and how |CL| bundles work. For a detailed guide on how to create a |CL| mix, visit :ref:`mixer`. From e1ff924c5b6e1a927e8060b7067f64ed76ca1179 Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Thu, 14 Jun 2018 12:31:40 -0700 Subject: [PATCH 10/63] added mixer-about.rst to the concepts TOC --- source/clear-linux/concepts/concepts.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/source/clear-linux/concepts/concepts.rst b/source/clear-linux/concepts/concepts.rst index a1f9e881..476b5c8f 100644 --- a/source/clear-linux/concepts/concepts.rst +++ b/source/clear-linux/concepts/concepts.rst @@ -11,5 +11,6 @@ details relevant to the |CL| features. :maxdepth: 2 swupd-about + mixer-about bundles-about restart From 36bb6e864002bef66aafc80292157a0fe361b8f0 Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Thu, 14 Jun 2018 16:35:01 -0700 Subject: [PATCH 11/63] final revision to mixer-about --- source/clear-linux/concepts/mixer-about.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/clear-linux/concepts/mixer-about.rst b/source/clear-linux/concepts/mixer-about.rst index 9be35835..7de26f0c 100644 --- a/source/clear-linux/concepts/mixer-about.rst +++ b/source/clear-linux/concepts/mixer-about.rst @@ -3,7 +3,7 @@ Mixer ####### -Mixing refers to composing a custom, versioned image of |CLOSIA| for a specific use case. While upstream |CL| provides options to install bundles for various capabilities, some developers and OSVs may wish to either augment the operating system with functionality from their own packages or modify the structure of current bundles. Mixing offers a method to add capabilities while retaining the ability to stay up to date with an upstream version of |CL| and independently manage their new distributable image. +Mixing refers to composing a custom, versioned image of |CLOSIA| for a specific use case. While upstream |CL| provides options to install bundles for various capabilities, some developers and OSVs may wish to either augment the operating system with functionality from their own packages or modify the structure of current bundles. Mixing offers a method to add capabilities while retaining the ability to stay up to date with an upstream version of |CL|. Mixing is a multi-step process that starts with installing the mixer bundle using swupd. You will also need a working knowledge of :abbr:`RPMs (RPM Package Manager files)` and how |CL| bundles work. For a detailed guide on how to create a |CL| mix, visit :ref:`mixer`. From cccbf3f8257e89e9ebaca24cf501ea1345530648 Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Fri, 15 Jun 2018 12:46:35 -0700 Subject: [PATCH 12/63] fixed mixer-about.rst typos --- source/clear-linux/concepts/mixer-about.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/clear-linux/concepts/mixer-about.rst b/source/clear-linux/concepts/mixer-about.rst index 7de26f0c..09e5c4ca 100644 --- a/source/clear-linux/concepts/mixer-about.rst +++ b/source/clear-linux/concepts/mixer-about.rst @@ -10,7 +10,7 @@ Mixing is a multi-step process that starts with installing the mixer bundle usin Related Concepts ================ -* :ref:`swupd_about` -* :ref:`bundles_about` +* :ref:`swupd-about` +* :ref:`bundles-about` From 2eade889b659df6a1ff4caafaec370f9373ab174 Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Fri, 15 Jun 2018 19:57:51 +0000 Subject: [PATCH 13/63] removed some trailing carriage returns from mixer-about.rst --- source/clear-linux/concepts/mixer-about.rst | 2 -- 1 file changed, 2 deletions(-) diff --git a/source/clear-linux/concepts/mixer-about.rst b/source/clear-linux/concepts/mixer-about.rst index 09e5c4ca..7515a995 100644 --- a/source/clear-linux/concepts/mixer-about.rst +++ b/source/clear-linux/concepts/mixer-about.rst @@ -12,5 +12,3 @@ Related Concepts * :ref:`swupd-about` * :ref:`bundles-about` - - From 874ba35b07387ce995b25a1889ab7e7e1857abd4 Mon Sep 17 00:00:00 2001 From: "Sethi, Puneet" Date: Mon, 18 Jun 2018 09:47:34 -0700 Subject: [PATCH 14/63] Update bootable USB for Windows for Rufus 3.0 Rufus 3.0 has a new GUI and has defaults which simplify the documentation a bit. --- .../bootable-usb/bootable-usb-windows.rst | 41 +++++++++--------- .../figures/bootable-usb-windows-1.png | Bin 23498 -> 20554 bytes .../figures/bootable-usb-windows-2.png | Bin 30045 -> 20901 bytes .../figures/bootable-usb-windows-3.png | Bin 24688 -> 16973 bytes 4 files changed, 20 insertions(+), 21 deletions(-) diff --git a/source/clear-linux/get-started/bootable-usb/bootable-usb-windows.rst b/source/clear-linux/get-started/bootable-usb/bootable-usb-windows.rst index 422af7ff..9b884c6d 100644 --- a/source/clear-linux/get-started/bootable-usb/bootable-usb-windows.rst +++ b/source/clear-linux/get-started/bootable-usb/bootable-usb-windows.rst @@ -27,36 +27,35 @@ Burn the Clear Linux image onto a USB drive |CAUTION-BACKUP-USB| -#. Download the `Rufus`_ tool to burn the image onto a USB drive. -#. Plug in the USB drive. -#. Click the :guilabel:`CD-ROM` icon button. See Figure 1. +#. Download the `Rufus`_ utility to burn the image onto a USB drive. +#. Plug in the USB drive and open Rufus. +#. Click the :guilabel:`SELECT` button. See Figure 1. - .. figure:: figures/bootable-usb-windows-1.png - :scale: 80 % - :alt: Rufus utility - Click CD-ROM button + .. figure:: figures/bootable-usb-windows-1.png + :scale: 80 % + :alt: Rufus utility - Click the SELECT button - Figure 1: Rufus utility - Click CD-ROM button + Figure 1: Rufus utility - Click the SELECT button -#. By default, Rufus only shows ISO files. To find and select a compressed |CL| - image file, you must click the file-type dropdown and select :guilabel:`All files`. - See Figure 2. - .. figure:: figures/bootable-usb-windows-2.png - :scale: 80 % - :alt: Rufus utility - Show and select |CL| image file +#. Find and select the previously extracted |CL| image file. + Then, click the :guilabel:`Open` button. See Figure 2. - Figure 2: Rufus utility - Show and select |CL| image file + .. figure:: figures/bootable-usb-windows-2.png + :scale: 80 % + :alt: Rufus utility - Show and select |CL| image file + + Figure 2: Rufus utility - Show and select |CL| image file -#. Verify that :guilabel:`Create a bootable disk using DD Image` checkbox is - checked. See Figure 3. - .. figure:: figures/bootable-usb-windows-3.png - :scale: 80 % - :alt: Rufus utility - Create a bootable disk using DD Image +#. Click the :guilabel:`START` button. See Figure 3. - Figure 3: Rufus utility - Create a bootable disk using DD Image + .. figure:: figures/bootable-usb-windows-3.png + :scale: 80 % + :alt: Rufus utility - Click the START button + + Figure 3: Rufus utility - Click START button -#. Click :guilabel:`Start`. Next steps ********** diff --git a/source/clear-linux/get-started/bootable-usb/figures/bootable-usb-windows-1.png b/source/clear-linux/get-started/bootable-usb/figures/bootable-usb-windows-1.png index 39152060769d1caba6e2b04233d5ebb5df77d357..b7e64c7cd9a74a0e4a1a3f3a4c427d5b5b22ac7d 100644 GIT binary patch literal 20554 zcmb@t2UHVZzb+gE0i^|0K#?M%s5AvBf)FD?P>~|N_f81XA|(MqG=fs3H$g;tM}l+& zloE_*omV0;lMHxetRHKD8!I z(`&>`P)k(W($n*_j`f>UnCVOQLIF)*UUyAcGkfl`T1LD{k-u5V79+^<5b1EvYNC?x z^M1Q!gWD93*0mCiSf*phx=z7+p9JJhc(hoj-i{snP%y?AlO_1F1CrUl(Q`X()^{tj zue7+Yx42>B_0#)`+nKimWhJ&luGJK8Og9kA8`(i1hbn02Kikc3Fz}6|?Ts=wO#5j2 zpu@y{3fP7VPyK7m&DEPoFuen^A5l*=$i8uSpf0Siiy{#h5r-5+G|%OuEq{I361sy7 z-9;`QDj(=?OCSz7wo4FHsqOr=LqyQFMgL|jy02+}OF~2HUnfx97De_#4{@P4LjPL0dXRXD zLXXnuh|JXlWz-|N<3lACEzau8#NAm$%id^3Iv4s6S6>BP=J4D8J>GkW(4~!x!xfw6 zp4$hVT+#S>G3ZVC1%69`P6GoW+bs2xCqdtC|H23Q&uV`lq>$ zq`KO)jf=nneljyii8K2u@>Y$6o@X0skx%MZ@#oCtvwk|Xe-OW$jtKcBu*d@W`>Z~Q zTwD)f%S#CLsiD?w{I!9zqR2C}D16n`^I--NAxi#bibOHey>P8#k3YVfD$3i4;(<@x zPpbWNb(?RuW=<57nyTQwDr>rXD`)rC*JI+?(%2#cuqtg$w~uf*y^&5^ZyXF+QklJB zQf^tb-sIsvv)L+m<8a@mrDuPoNQSr8zyN$jRw;!M!LQ(DePE-y+RL(GXhp66^+7Q$ z+}qng>M0L->pnJ%RkYUHA;V`$41zm6A$mFgO?m_S1d3}FrK9|GXAq@Z2Hp7}e3%r7 zo3ERc5o@BM4qsA#rVQZ0%E&?0MP%q<^JLcdiu6;$hpo~0M+w5$4(4V~OFwdwEuwz= z-YtG2a*tBtHY5^No9$%~UbC!nw2Ds*QlP<@XU&5>$G_`c5HoN9tL{zg_E#Ka%zm1U z3EoCDm+jlPZ!{5ADLTtG`&$)hyQn{hpKKPqvJGuV)Uw@9X5`DJwFg+V*v?%(!B~+M zVty0Td%rf@eb_<=kN|m|g^UT_lAGMH>3m1<{m)Gce+cluTCB|rvj+iW(&y0K;Kh^! zaz)xKda1GRaM$M0qv{^vHwy-$q!{_gAWeHdWCoiV*Ry{G_%83QGJP>%<3_xNi-%vy z=%svsue%WMNsF~(Ub#8s`*Vr%-Q5bM`_3Bt5**47*)muh&Zd@9BM$%A`F5zF2VZPPZVH2>2|#a`vTUFC$*?hy&1OuFaJphprTPTWr}B8d?O z^IbFC|M}*;R%LB>RSS1-$RF1+m~2Ym$W_^Bs!8oH@E9+jtZ+WO$tFNerz}AZ1Gn24 zxl&`%YnQiit$V~pmRN}Xh@(BQJ$NK*imY-^XtMKKO-a0;)spWDzW*1{TR%e9eY54b zAp4cnvAPzgmfhx!Gavs^Q`+=L3YhiJ9}YYMtwT07dX*ROd$R<|KFO?D3+lSZ7jAgIaT}O0zX#; zM;LnN6pW_gOyGE+e@gC6*|_@|W|h&G7*ZC!TRFpicFmKIX0CF;#0?A-f+ZB$C}f?E zNSc_rK`ZuDHDoO3Q&tWc_i1f#Jt+!W?wW(1POg{@OJ)_lk@cH)T7tj|oH#Efj*+FQ z5WeO#!viSM3(7gi0&HVHSxnn$2<=|l(}!EEgzyc6VO3oQaGGJM0LdUfVBc^;9Jj;PQhjdffa0q#W4bF!dVm;6P+JU`+Jdqg+I1;2#-1WK%Ug?W59G{#(9Hppr^;Ok7hd*h2F&7;9_(e zP!X%(0DZt%Wx$hpVMB<@&hmZ*+zC+# z6sKrgn^B(%$+LQLYrY;fr;yd6RJ`9b+IVoFM5SQl2B>l$lgadX=&<^(S}~ zG?%k{731f9`b%ea5HrZ{`W>*-n$@E}1s@qe82-x`bPFN?JDMG59BQn5XfO<|kAom9 zn;j?~qy_(JhgQFgay5``mgEIY_?D#inu`|C?bXd`Kc158I)lT$t3&xFETBqGX7*hB zH009bN(M1vy-M1eOR%Eh{u=(F>d%MRvm=b4(%S;Cy6FImPn8*3;1$sQ$otNrE`*t$ z&xcF6MrQq{N1(Q#DySc2ZPL|F(GJ|xbg(a;9jm6CaA)$JBT`-2&@cE=>>}@ex)R9t z(uBy~_m^s?rPeNUMXug3^G1rT3BE2iP`fA5f|*k_9)|v2Eb;$kW6Vkbfl8x=)Gi(a z*`if%r!xXS|7AhhScayNvm7AP+zHdBfuIw)F4-tvP$d(SJ`Ju=vZo`!|ot#>{V^;m2g(jn3fH6hfQ;%0zGi|UW!|TcExZ3L-_LRTcx3A-4_3( z<*xPF)$Ui`N+=9no_Oajb8qYk(IuDktrt(2Q3>ew6jV!~Pc_@Pa4Oak@wXgfNJR@+ z8>o%k595~RoP(JgzFK4_;`bXhF1UvC8+!qu(t??AEf(!@5%hhm_Oj+;2B3~9T{D|qtH`q< z({t&rif7LiHKuq6K5T6VC6X>hVAa8sA_9FNC*%3yzCNU+P0q8CrU ziX;wxw!|9{B!q{L)9fG})m@{bNdZ$;yz|({1eVH^_I8OUFWi8E{cD|}r#a^sXwtKh z(9#z6zhA3!%OTyDnN6n4>9-U>CD`VLqf1^(sZF}HcTSpX!*MFa58^i)j>hjb2p0j% zbVm7g`duwBjNA9P{O@XHm`DA1y!1mUn;MZH z*=Eaa`Zyf&&<>@F$zT2=KkD`6g}%|uX>T&3zbK#s9SJp@`BJEyyzYVX5fJ@KF{ga+ zg(LtA6!U^T7dvP6LB!mlr!ie&emYSh01Sq;U0#vE91tM;`SpLhQ$ZSBKCn_Ec{w#5~((lM%%Kzy>NN z)YrZ&oc%YSBUAeC#{y88b%d+Yk+j`YxPeiltk-b^`_jO^R|uhzk4qHPw$=IVr#}TN z0I4+vGk_{Fz|Nct3~*8G=Vc^7ph{Li3a?-L-<#st>CbZz*W(~t?hup!=z8&RG$cJE z{nhTvNo=3vxe`U@6#{m0GB&B-HMGlfca#^DGhzTPV!(4woRTXW&Csx6sMb%_ zfvlq)qHF3C#@py5RN{g3ejyJ?!9*9D$Ly(kg^*2$K2^TT{3pNKob^gTvxriZlM#P| zh#o0#6}A`8MgwCLTNO-I}mh}1g;nlTym97?)Y{MW#tr7M<-e7yJ2}+a z3RHi{cE)UH_|%Q&?Ew|ieuA!=Te(fEkm^AUJs7qnxNd64=W|SrwpIh;tbD{OdiExS zzM`8kh^Ew}b|71}1#yA~fj=%UMM?%Qrn&UtWLnRoI64b{&vF9~!CQ3|D#o~~&ZX)o zZPW7lY^Jh*@9l%Xzmiq*-%8w#DU%FcuV3l|V(@b)!8M5MB@FO!CWLD-k97$Jm!3Br zTBi^YiVz?;kwj{5H1Asfwf5QT2X)`W8 zgVox-_QbwxXJE3Q)yN|Tlz1NeqXGi~*>=HUHa_W8+D7Xvn)^3x_D~J*B}`GwLu@il zwjGP~jnLNmg=CAqBngu>#fsZ2A{j)G4E0A1xjEui7irK3Qhx&axFCBW;b^Uu)b8*N<>a9=y z-RB9zMAvGx0aY}Q)Uo(F1LA8+Hjt`FI!?=}T_04U#0bh-yc~3dysUV+PK@hn;G&Z^ z`sQDZgV~4@nBUTx#};eHt)r7Y9&4`lDpzeuv*w~pUBQtNRtg|IRDb;8Ss(92Y;;={ zLvFix1|%T=@8pZP^$x(GxxQhRovc&u>U)>98(Y9p2%B6r%L|=v*g99f)ly!k1}wc~ z;O{X%@!#F852>56p`OHEWgelbAb2tlY)G-m2i@RQ-x08XKWn>aPe<)u(!y7HX++zO zvd*l-=>3p~3hSgp_Y|mF7YX4QV^z!x?$}}%D z-hV-UWBH>8 zC2qZ*zIWX@iSUHCJ{e!82@Z^Cl-@OHvX+LpI8}Z5p!D~kLDc5(&-_|esFYG(pA?Qz z-YmzeoB4QE(0^ifZAs2(HqVA4otFyOf|;^qlp!tPO5hH2Woo2;XLox~$userdE@3AHA( zx?PKK-nZC1Uik3P*}OviaBXXX_;E}s<)gKF=kj&;lNW}N;2sCX6M}q7 zvSES{bQAAg``QSt--zVjnPoHG`Q^BYK!Tplz~QpMl3wvNy7cH>Ycx-(HWY`82^3Z{ zd{FD=6^$6Y3r(y-RT6Nz>8sDL`knjJ4p;08CKWMM2iSicyC1*TpfkZzrcNkA^DfMI zj2DI0dlCEb5Gm~Jd=*rH@7|*eVtcHjflZX@4fObdq}|2XS+Uo@iIdXLt%FuR;)ALO zdezd0*Xr>KI{lxUw&hdY>x4bPFxd(g%3p@~XIDd0ER!C7?%aq9S7_$DID@XW*5By6 zVI1;NQZ>{S@=o>rh-04hu2CT2t!msRChd+;h9vdPdedg}nb_b`{QgG$C z@6)=C(KP=+^nuAQj|cAbBPFn6(e1r7%CIR!?F<)#bPsXS)^hj>_l6l#WSa%+(3hKN zTYF*i>l=(JX)VuEZgkbR?(#w}@NXPaXw2 z7zUJ`|AXj%ZxZll6zL+^t=zQD)h%*;D)Q-fGB@n*x~BqB_|qQZ?PJ6{*crVVNg3>^ zmir}EhfLhOwzH#y+}B1ghCQW19bzwbIb25_=WhM!qRI^u&{REHlEj72dZ5e2nU(Y}3*J!?@A$QRp z9Y@xf%^7~i7%(}B^@94(B*HTXb4u<}bm!VGv!wlqxLeF}85Z2bZ zR{L!Mzpeo9c1<92jc7{v29?WNCKgvW*9ez!m6p5JqY^(S& zrwg`Y$KBp|F~vL1^%IEmsXEwvf8&+k3wPW3lLKcs>ZQtsJ2`}4GruBxMoQ$;9Fe-K z@#;ohwHFR`lg$$H_oTd+$Pq9CBWXU|K`084y64pXzSl1p<7Xr2@owVQ?! zP?mD0!OblCdqbJ!DcOmmJ-_SpD+q@9(oDgRX-*3#Wcai^ZBrIrv6Z8%`QQ!oZ9My4 zTG9fsYfK-GbpMdr#c(E*ucvz7a=W5rb+4Pn$4b$^%a@2ygukPUEF5g*J`ZCwk-dOtKze_ zfHZuXU;Sx&axhIhh4^4VeB+T_imz0)RDo$%qp>H7e6JTSW2U&AJ=2m(PQOa{rc9*A zbUWzYM855{dQqZ?do`xFSeu=33v+TEJ6kT`rl@FPV?KUjDFHrb%Qlc!KAtqkXsD3NA8?DR61DQ}2N7wVVa zb;A0$Qw;@_Cc=H4^NGD&?1$?`IO@5j$e10w;J4EpU&l*UztQR@fTzCh30~onY(7=n zqC=hc_&wHCB-sj%_NnOi7I=jYidEWalq=du7M~fCr(BX7ba>$^P%h1x|0i<=ZMCx9 zNX4B@`w6UW-BXMCi%%P4%CieCJQ`y?m^~_90tp`8wH)E#(^#bwsariv*Dr>%Dv7L3 zV|LT@b;aghxbm?uLzz4!$*hB`G_UU3K?hmM7b3?%uX~w?f@ikhxn2N))GhwTEPr7U zW*U32cH3H`s)eycGC&A9^bl;-9CXH%E!t8N_pLV4|1Ow85D3Jsvx?>bv+x7g^#dfS zLj)5R!zyaaU*tjTOOyL(S}%g}&H+NZ>*?iEiXYouKZ`W@;m@o3be?|_^G+efbMlt& zV;P9gNM=i7h3|Tvwe_u_y|=Rp*9*v;qV)mA#E&hKP1u;!gr%RjZI1`Z**BM(;D*v! zYVI+axA~+5zFqR&D_nKC;oUFd zLce6H6zRSz?t3S>_dI%pVXvABJ>BS)o-7`&RX&gRzm@azjfYU?X!Wox0%r)B-m-6v z5qd<*c%Ceg5EnhFZi6qELMndB6X~5DeJY+P-gL#D@4n|*y}G(OJ}YT^Cno*Rw}oI^ z%ufQ5U@3%Fsr*L zL7(`TQU)V`KnaSAjah-3CHTt-OFA`ms$;?U@9Uj+9 z?_s-Zld1E>a+idOkv|{P3lvs@}{tzJ%AN_=Y}$|M~EC#7R7|w zfnj$vnYgdBhqEqYM2@|<5d>x+iUkN&Y>ZyTSG)*%)8(sv{yB$%_5q)S$FNHUc(%qMbFY|xWOFjLK8Y*N8T=C~@BDI>v&|1~6t zOY}tcZtEd^kpuBGf_~^}mw4{Z&Q?wgYOUG{D@#yO>8UO&dzBUhU(7#c@-9ugq}sI+ zuwubD?fl|5E1jP3ja0g$g+?f{I>;%QHo6BHB=|Ww5sF$ANfpVZDZ4JRlhSzquA0DE ze5}*ZfFWX>^_W-YegMJCjDrxff zgz0lItA&b`q05=y&;`$8?8&l|Ijbyp3LP3{l}g&){wd-zCu4j49qG1zN_HhicVD1K z#}LZWXSYKncV+S9w0X_!nx%A zvX^7&x2h3E2Z^Lce|n2pgk<$>PeX&`WUP1A3&6sB-3n?u#&0eI-RYI6c>3O#zUSX~ zn_aw!ubf!Ib(g&GCFkuq?~4&uZ%j1Tb(BA4^y36yu$!(QzJZTYiqwTOlDW>otSC~K zJWU|0Y`vnSj}cn632U0$YJuBQw70XW4J{zk7c=V^FCegA&WdF_a#lwzg!ni`sut!4 zM|0x2MA2ryR4nTwHfP94x4Obc)t+_!k+89eWb^S1M9|F?>vwA=1woJKJ)IP(NnxqN zUmSm{;Kg5BjO&WBMxMA$h$GZS?`g!CY_}X+Hb6kdtb<9lY02Y}j9Q+7dYY=79tYKT zH(9@VC~_UMaAui}AvKVjD39Thw9^?fW4ON&zO_wL#tyBCj?LHuV2a@&$?bq0KIUFj z5&Yt>T9XakrY!H~*CfqmRDH*ThS10FJF1 z6L%0`%2K)hcUk&xQO41BsNeGU_i118450Jc%}hg*r+_oR8;f9gT7P^!c=0{ya;?m>Q@$Y%bgSkcUR>YgoV%zt>SU|X%2Ixq!TeE4JxigC!x#XaR zDkz}zCCIM%u{+@rYPHydAe(*sF=_AyfL+{51%iF`8Jp{GMqUjJHiq!Zead2g05TPp zI1dY|-}~U3)??UPOdSz++a`?Qw#XKTKMI(PcVaG%p;3X&(xZW4Q?<5$_(@vwJ5nm~i`LalYNq@^(jcJz*fe=&m+ zJw>@A$Q;*lnrM6>b+A$G<{@>%JCGk{*Qi0C`+NV6F|kmgCMbaJ2x7c*ICc>eg(Mva zYP&ZZn&qO00{m>TPF3(cte|8HgQ^FCtFT+4sq48Q0V{^#Aq4^2nQe4!X?a=?dhAM2 z6N4>3ksJ24df)2;_cr5 zF7GpmK&kyjPUg2-H(B-*+A@xypr>03>FXg)bH~CMO0~d6n(7N}h0KpPxJ~5al5LnV z=y&lf+V$3?a`mJn;!D)4M!VKt9y$3;E%5|Mq|mYA$5Hs`^3^ zK546SlR4}{=^Y@i%vo(6?rK~W00OZLw*y~Jo9L0sF8sf3csX-ROezK>$2dWAwyT#g z&S}7zVc5q|zrbD0t?J-g=En7&0kN6amn!;A0|Lj--+Egc`m?D%fYfv=-qQgZq*ApN z*>^&n(Y^49(ZtoO-l09=BxuR$1oW+rT(g`X0uP_VoJ>$q?^a zehb)}2vwDVG}`v47x3mOhlmvhwGcc)`wh}#zRJpz9nS121qd%rwPbo^_@unPC&2?- zoz`8Ot`cOOcF5g6xIb;^+@mokbg>>uS#M{ZArYa*wHB)AUScD5pFstiRhjiCe&R$; zW3Z@2`TF(DWOBnsE9=;%wD(mBEP@cV^EDWmzTt9H$yv?0{PwbMS=IzGG1A0L++nu> ztxfu6T@iziF*=`t+fy>8@!HrRG?P;NqZBF@x~^Fpd$yAN)v`$*`T!pMEdRi`!X|`v zK$V-N5G%4i{aTcB%Ek{wzy2gYanY;v?I^40#&b57{C!w}crjh_OQY#yCv)%3KtLQC zZKvkWjtnxZ1#@Ft)T7~=R*n?WQNkmuDL9b|_alVL^C!|)dZVbnBeS{AIfaghJeC@! z_xAbqwI9InSBWcoP%D*LKW%}SH@nPYMuSpZb*Hd`WAJMpYLH$B@vb2i9r$CE76K9g z@5iF11HJ{5Mz;RE(Rf>`h*NX0BCW5-2*c(-oDGJ4X3J4fDo$u9Dz)Ub5b7gDOP&XB zJ;RF8uO=7B2KCTt8}ERx#Inc9kO1P&tk1qXZ3h*&8%!+%+z%yAu8#=sd8PEgbJ%l zFUQtjJWGNK11G1rd+wjhY)U?NUh_omPUPEG-x0>#Q=bIfTrP!oH+IC!)=4#6x+w`Q zWW0!sNi(k~$})@S_K=V-ls}*Gdryi$UKHpRr8Ve*{a1krW+JXo@W+XliII-Y(&WnZ zZ(O2hEt{gD%MAKD-`xN7u-rsd<@J90Bl=@|-4S_+#H9-hc4Glv56O_eEz?$6KIX65 zYQ03SBdsWmeDz`pmbdZzFg1=_GNMt5i7Cg)qCdN|xl%<(V~7Ro75nGQOBTuX3#1xe zPhDZ+zix-n+we|!J_J^9kY8uhirt|od$zjD9N<^{$$`Uqx|H_{3bv=-0MP_zCHgKe zpT-}pdn0Obh-(rbrLP@^R}yxl9sOTkM(GoxATnHa04DT`3>_V9C?5|zw6dt8grhbo z1{{e_sL|x$H=UMUl015~0o8vVHtF~rBoc}Rhxf^~3q7Id;wnD0KGh>3-09vb{dCtg zhox=xe%y^WoZqeX1U_Zl4qco?Uk>1O#L*o@{697qTci6fq9lk832#C*nY!oX@hY?4 zZB{7RLK=cI$X;FSz!@swNfSCTN)EER-uf?1=Uo|yY81a!2|Gici{LuuaS4b@fy9o)1L?I1 z2rG**;6QtdgtHPIM?|9h3m=sVg4B+BJ0j^$Z}$L&`^KP%6+@y*_yhiz@lb>CU-4L=BKeH%K1 zay#|OB16}WShAWyD)Ev#)W~pp`aCp9Bm-ijLTTtX&93?N`B`gGnn=5{nG!}POBn#3 z?kZo$iIM3F?awaNdKydnJ~*z}9ygHDiaIq~Q{tFi6R za6whL^w(aC9&Bv-aLTIFlFq<)E_Sbu4a~lckqxJNz@H~LhX}pz<%)BW1i$UALwAe7 zr+KTrgRfeW{2Ci#tKV6y<4^R~xqeEOEjumEkeT z^W0+z)V2M}3k%6#f0K3IMJM@xtP`aCdV33Xb0}1DS`_*zqxq^0No0$;UaP*(#ebDC z4FCzut@7)NmNI(7sjjo1ip%+UWbY6}PSlm`5jp0dX6_jc5FhR8FEfHEtAkHo64-a8 zJZ2*^Kk;$A#kTNnFQ6M_#o1%7eg9>bi!UXcosScF+sG#W7bo~|E2fR@?f&`~=DS@A z`wMm;$2_|1_s62d{?e-$*)In>t6Q$r_grkyctP&S`lqv-do0^>I-u z!ZNN=PNR2H-A65=SW-o7ni#6cqs#;hATh z=ylm_Q)^<$$y`?(|IpJG5Z)`r{jS+Oq_XbN<7&u86})XR%$AXI(%U9LHqTxwvI?UliUS&+BzQuMSLY|N%pdi^8XG$8*b_b`4N zBO0OQ2*S168M8m`VbIxTDP4`pv0fZhO!~SQ(Q*d2>K{#)?6@GwMM&DKYCE~B;oBu! zV#BN#koo(mKi-)T;vP6*vWs6{c+f#~iFMj}6j>s?Vo6eeOI*)QxliAWt8 zZ1D0VEJw3_0B9KkKqCEaEg%J3-eJiL?s~~>C)P2Zb7F+=?TxQ1-}RL=R@kcvxw@-P zixap^@`bn0keg7^bj!Gazpq`rdF}v@bdM|73Q@N(7BI|eWtb0${ zB0{BCgJNgh;UiS!gTU{J@JKrm&&opOAx+;v8#r|+VKI+WWwhX;cuh6zZ=y|rH|-*E z1=Znt55VXy++kS>_CkqTGr z{^|+jASQx5T>jyK-W;@5%NmJ&Qwz{IFOprxMj+v=ZSJe8n9IXj)NiSZ7(>?Q?>}_7 z&4-y@zrtY4#5AP6cy@VIxkyDFrCF~R2E3fH!7I>Dtuj?2t;l?+~%2kw4?#+u`h@qf2v=n{2VSH=y_?238**ZJQ=O=uZti;pSVBrH^ zvDIVzd~RxI&W0`5J8ql#tG#XXbCa2Z&a77@6)7M0$Dh81yuuATM8}c($yQChGz2-%R&AncFFt_%T)-1crUNV>Y_65aXJx z59+NCm(c55T9NdZ)vIpI%megz$o#dIIu3;{88#Igg2?|B_Er#GJ21-`-EJ_h%^0KROZKQhHq*{BfOi1k`K`4n&?QY784e zE3o4?9d7+|FOtAx2&#iJJd2=-=jRL}2mtkWLzhgF39YwTltJWS1t>-5n&jr&N@Jq0 z#J({X5=wDAd|NT}y5hcjV7?H{j1_^%fD5*95E+$Hlh4C$h2|hdH*#6HMBlUgOugP0Eg9Dv@{#HmCE?{YeU`k^I5fPgzxmwFw zO7e%#ZUX`oXK@>|W^*tSYG=s2fNeE@08Htl8gei3u!yw9sWp3{2%;-h+$g5%{W9Wd zp6BXeng?CHuDL6GhGK8GjKI;hCl;)%P#Giw>n;Q6yOE5Iah$Dpgg@C-huP(fS^$Xa zSU$zKR8rti9kQ<_@l0rT0XwrwHfuy_DP__KZc(-HMInJckVw#~WdpemKLk&H!E;Xe zAPw2O13-IX_#(he0g1rb*?M z6N~=Zlg#AeiesO!9OUI2^>4fdL3d14kL#1`ACZ-`nV0?yWeRkX+XShvizL}t{^nCd zg2`P^(u-vX_tnq_q>(*A!i#klkS%ZX@pwoo(P{lgvNRjB7aij%tM4=qnw8yv>*C#k z1Q|rXkjN z7nm~pR#^OkQ8yrEqCd)k^cwO3C@ih}Q#*9Tr^{}`*pfdlywKEmgsd*bo*V9!q9O|7 zPt=ZP8e)xI3>hEDzS0s0F3M)-7Uzbg6;F3&>3R@AVbYGk@+BWSMQ*#B3Gq;ul)8^{d5}w%THnz{iob3LIsHC zK%h?9T(+K^NMLx_5%>2$K;?gs<$u@wgEmj%Wi5Is11;2}Z2b&gL4{TxLp$5%N$DTJ zHhjYZf??GXKAwb}W}MzR4TFo%RLk&(a|yI_u30$Cl2b?%RE+`Oa_&;V;+dLJv*P&f z3Wc*~*tLoLz(pv3ZEV`t@95NSCO<#CVlVr~GH&?(CPuVWf>69zcX_x8?U$j^ns1cm z=@9DDXgRCq>_=cq?s->JMeK0<{H=-lwIaR;R{p9|#;(x_HCf&gQ~HfGCqlf68R#(W!dpV(f?4*o9MVl9Lx$$CRIhiP=WHczFv9*^ zxrFL$hdd8TeXPi;u8#}57hq|19)@eZxHZFZrahs)@K<)um!380?~YcZ1-}&{g37kr zcqX^8D{tb|AOZu^))m|zA2z0KJ^El?(2`ZG#`!KjypUk^qOle!Ue$-Yzj2UVF0ga8 zzQ1wh`#;m%Hyb0SWFGKl$z% zDXtl~XH*3}+HQN>bH|!Y$oVM7~zZ%Uf@n{KkWg=os(efkdW=w0{9&=MK}~ z_@6PXEGPea?5WBg>Nk*i8^CMzW8SqGCTFXpNvQ-5WOJ>W5G`d3VvTV+?@F*A#)nBS z0aVu9vjQM(4P^C=-wMK8MkUp~g$v6U$c*9~AC4 zM-51`jjsopeGz$(*_NV{@j+8JJwel9p^7|^<|`fIXoZXif>mktB6#pR6FaddBp|$4 z?=_CN0?y2u37FtIL4X|&H3HDzNT6Ypol2UOg)(MG{sR%&fPRe2=&R8=HolHG%Mf{s zRNCTfr_ajhR+uEQY*0#fdgc(~KU$FQ^FNVG*rxC0sRoXZ1?gV^>Y-$g$mL_on5Hkc zLN(X9st@FOtX(#V(*E>5-aa+#!IKYp3E>KPL`7dpxc!-TlF3z`d?Hk-|Q{{zLK?-dqRVbKD>}W;J_a zlRWTM_Z$8=|0!!vJDRMp7la}$WvaUoty*PeRtceGrAQ3JpVPawRBC@knEeZP2C7s4 zD8IGc95lIA#}kojT{lcVWyv*fix`~zBTzYCFZhXDpUouN13Ai$f=gY(tnz6Ov|PL< zgXxUU%(7kQ?9IBeo|TyF-fAvQBKn8JU)ct45@`E*wF~o+uDZ5$`^#F++}FtU@qx3q2K~S*zAff6q`jU&v%t)yRYS(mfp=X{VfUqgwe%n3_eGWJ z1I7oVjt`wQi$+S!H$vFmrXyUFx^vFIFhG0`80UnJw6)MI=8=+B$RvKCmvD*cI3SQf z>=nbBt5M%&F?FI1C>i>9WDkB-Oqf59O00=~=|m z7#z?zfT3=C`t&Bte@3kTdz5YU_>iAH7K=T3O0E`H;9PwacttdPFsnUK;-LF<`3HBc zy>!YrB41Vf_BfW)|1vhTv{fXCR6Fi$ZtcKwicgKYKVXQyjA^(}ewd6%d!?G}!2k1U z*{TP~)|e8r{CD%$P`lZb4^HYI5_2GRA*FdiRtAS?CL1FH6Pr9@TO4d^p)N)&UkqEn zt#5z{HlyR9wo*^)qQuVuSigGwH_Cv{&{)glBWjncD9+2rv-_|9LxuE z@lw9Xhm>tjIyJu7gC)oQ&f6fbIUIUsW=5Jt@T?XYWM06c5Gp_wIX`*t8yBQtCVAbY zR)*R#PWw1M*xgdda0_3NPmUlrIT$Azp}Lpo4i&x42OdEg^ORajOCq5>X+@y}kkYd% z2U|5kQVf!s0M5H3_+4Q3@3&ibwW=as3TU5W7PJ@?X2o5PtKM1{E0NhKB{i}CZBYHl z@9OI=;B_5v`E(<5%lSM!zM-n39Q13G;u&hHY|JZfS7%+jBd|B_)H19lAxHk`09l%D z{i&qb3T60SXC0ySJoeY($@k%?mx$T-11ig(+j>@07!pU5{F@k>=4wB-7aPxR#5Oi= ztye#W_kWflW5X9pPQ$Wx&C-fwek_JT4M+MnB&|>&b)qWf`SZagwcT5^&(g;45~r)4 zN9d?kDsl*I)ttK-4()!St{~D77Dw&rRK;H#d-8j_Nnir5vI+mqn6w%@(tpfL^ul;i z*+|PWDqx{pCn&Jm#=6-%qsW1`gz%(gTg~I~*a%D%-Ov;N)=(h#2Plk!2{dI zv4A%=4eFch{!}tP`m3as66sH5)RpEsMu_3yHPTh}DGt4wV>(C+xiD%>xU($G7<#=d zIfdZ9mU7DLV!~}_tG$$TU13Q5#m&94+MP>>KVjC^Lb0!BoxfKEQgj7zf0wL5FDmV! zOs;mWpb1zYn7$eOA+qf=tLU6aC3Huk^)A>BC>Lmh+D0rdOUEt(DHGsuSI9kpZ~~y_ zfD9iU`|uNY5^!NBMewS7lz+HmHPFtZYM9rN|0enJ4;KX>nr;5-`f#Ka`kCYR#f@1( zZQuVF_!-2JyV6N-KK$OP4bK9~U92QCv^|K(aT66#SQYtS<+_nEeC#~@1n1xkV3JOt zPB@t2`KeOi%t?ZZGsL{>D8JM4@%YfeK!A0@w`r-5M9+;iq*uYU3cP=>=1VB#7u+i& z3l)k2-8l?m6+NtZ-*eMieB4|7m(a#aT&hlQfIq){t(*tg2*t%1FLEr*Y55YS$yV$6 zoigh#P4~^l)RrUu4AzU^4;1FKausuOmGd&+j8UHuY||E~Uoup&{>}hO{x~b*vs1SW zJIgB=e#NrxCJgN4K5u5j1-cHfvkLW42S3$R+*w6sz{M&>b{m+)>v6oF)wl2rVT@u5 zm$7GWVs@q<9h}v^cE_0`nIXLUJ{p>HFnQ#fUIsC5-1)W#I`%@llRBUaBHcBz3a`4ZQX{|K#2NOZn6P zkKN+Ph~=MOqd_2;TyC^=_;UTyJ4VoX+y7Ef`5)cuDTF=_3k&Cm_48P1r+R`{ck--v zMx7*fhN!lsXC_Tt4kTg)L`fhb@F6aWzTZ^dj(-^yc;b1PKp(uS`n$UDjf&uDj>Q+_ zk^b%EC|e)sMPd>G%#{{9f(MNORFJ+)yyv`HZefJ>x`}I9Z)l-Lyk;`2!W-q7#tWW6 zAz11|@Hw876*NrX72`#Hi@n=jjdCY?cYfWJ z32E2#06v9_NDajhG4>m_C_ua{4P8gn8ebiMARTgEeA@`~G5pH^XywYIn!56Es0+$s zpw%Lc5EeT`5ki4NHIg*Sh)V@JQWjaF0)jvS!xji6)KFO~5h%NmiWWt}j-jlP0tHDB zsRBljs3b8ZBmn|}ge>#0oj-b}Gjryg`RASY?mOq6ckg|7`F+3d`+P5>C~t5(DgaEB z|0Xj7YFBGkz*D#%=nl@I`RE?bkAV7m0MxJ&JH3@u3t0D9{yvq!X7cjFW21TOA?Lh|(tLADg|W6;5<9Trg^ZbqvAdED-grvu@s?}_+}=>iu? zvd8~Vg#T~%`#-#(HEBar4dQZ4#+>jRqBDOtqAC#RES*BF)%l6K(s2v)%0lbdr4!aB zu0Ez|BQxu7ISz~!D{#4nZ^>!mhWRD(vhP+4S1!^-IYvQ*M++qBefcr|wUP!mAqc2R zYMxab`Ek17nh~ZYT@6A0eY{(w3ohdvj$?Pnt3rkIV5-xQIC(&MJ9usShzLRLvN_2cvF~vvuL+ZjGt|<=h9Hm3igJ-8I&bdhRwo@0rMQ_e>&X zrYhRm+fBJ3H^Nr-(jgE5HEpR=bezV@elRg%A%u5g4;i5yq2%xmZ`&*`?)W=-lLLpq z9de4tsrlfM^#rNl=M?Tx8hFwrcMhk;9Q&$7Acg3{<>154IZym9i8nb;G0#D4(J_L)?kN%%IA#8AdcR9=``P7K-21 z^0>&VN;W@QJ%i)A3+C{s5aiN?^#fjPSeqa*m>YKs9+33xX6O1n)nV_jFLS@yiEaz} zy*vH}keNPSX0tF0s8F>Win^etQjwA(Oqx7Y3P;Ip;->HiEGE?}#hR6@!`&O6Sowri13RIg7x<`idGH%wzlHIe(#5%4 zYn7#^S2I;;!6S6*&c9S4+2NWI{+ki1yz)(iGx{E@3svNSGw;)YNuT3YElf%bFiJuIV7=5_&19Ete9>nz+`C|?1 z1afSNY0>xk8b#-amR`j^n8NrMtzFfEz+Av!V|?`|#1E;nntd?vy?KY~8nXb_>23L` zS6&rzl34zK!4#>blA~ADLksRF)nC>g+UUc$1V0wL;AWQwnTcwTUiC>Z#(S|{=(ufs zR2Sz1d2?pxf!8muEB`sz$SfV1wA$|5`94ErUZMP8j2CgbN}URWtrf3HF1$26K=0MP zy@lYmpMkWJ2}DIcL65{_+tQ&%RYJ!?Gt>pEWx9E&ec2Uwg<{jC;Cn* zRz=(BbvAR(2S5955&@PL#wah>z5DDN#Yv}aW0VRJ)m%S}M~1EXc^ugDQTFObWUS=5 zd27P@7c!}qzJ)p7N(^o545g^njUh)mXE8|G9hF{fW18>5>FcU=Z~4zNgDR!r_fOxV z!V~b2YG$-o%q46BZ*ocl9xN6nG?{MKuig-Q-nxORj?~K<7kOml3tTF`tft!&b?# zbE$(bbc+sob`m4qGxMH(McrBX=ml(wnQje7JVfuO+?#1!&rhQ%e9~0T{3+B1m34Ma zL3v!IeiSEL8|5(~!j|0pa9!`)H6tvCG<#4gmt*hx_qXO|^jH>L@WeaWP=6g}Xy*`{ zZ*>;l*S>CJ-7oxFJ0E6RSwx*q0&p~&u_O#~QC;bol)0N0Dao*4I;_GSSAu!ulfxi5 z9m9cuj}M>^_Th3&eCcwriaJXM;T!673o>Hk%)PEisey9d3oCnYN#KEIy&&}gTU{j zw~nU*sNMNr0VT%X-`3R4gr{W||G0sT5kOF}`_n>W&rbm4AoE2b>m8F}+?Vm>?YA&~| z65^hcXtY7~S^lcD0n$R8wfApiJX#nUNojvb+Vc6=W(P$T6+u*ee&H#nVO#Sof+g{} zec=^a6b$gjQ5(2^YCqiIZ(!2}{{0ciaYJiE@$O|)ocKbNSzU{ADTq|Uds#mm?6|SR zW*;jT(Q-)@TY0{sq4$Q<{e+;jr=$>*9@Qp|VqISI<`XIo9^OjlfSN$$dndMYfvo-( z2ITo#G=b=3r@f^EacM{qUR7u*esZSYr??)9ijeI&s!4r_l;;5NkE3<|Mz&aI!|jTql7Dg=W9`f$V3m z;Gwl{Udeu{alfB;aSIo4C)?|^r8RDG*-mFVO`M^~^0;YzWGk>X#%ll_F)>%-3<4B8 zK-KN9Z3lME%7a_@aBIO(_@I$t_fSOhRmS-#a6v?}@OH++vRBE2S8O^&@$(SkCULja-FkBJGqJq}wfA$a;QrfeJYe+)I`vm~ K*M?&k$o~Mf;617U literal 23498 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 diff --git a/source/clear-linux/get-started/bootable-usb/figures/bootable-usb-windows-2.png b/source/clear-linux/get-started/bootable-usb/figures/bootable-usb-windows-2.png index 2441ff678f5659c76ebd0d2b71cc19371e3926cb..f0a66050ddd206a31f91fa2546a7488370fcf329 100644 GIT binary patch literal 20901 zcmc$`c{r4B|39phLa0=-x1t4w$T~4evb9NwsSsjJ!e}frDN)ImvNKJ}RAM6gHYDp< zMwY=a$To~Ima)v3<#*}xx$paPf1l?$e#i5B{&?m%I>vR)b)C!me7|4kdwHF`xNL1E zCL$vuARr)Se)0TO0fEh20f9{?whIAwtjrB6fUiw{SItZW^4jI5fr~Bf##Y7x0{O9` zoI6{AYvBhM?fnD<#OpTxZEA#las_Vg_BXxhe+_oeKk&{&HvzMUZf-t)9x#7r+wH(B zSLDpk8()9qOs^76mg_-aLCr=KZ*AGe=I<5S{b&2q+Cc4kI{>&9Qr?yK*s09U#bqZ%$f+86vReYEiVm3v0OzC(xZ zT5xHRRe97i7kX&X&cRHX4>QXbaaJpOA4w;Jxdo)}#3J!sQD-oUfJ6iYgd|Ns8{ajL z!PIRVf9!v-9S}9}5fuOHk=r!~nSvWPcAO1IZhSx9gw4V5-`Y9HcWxbyujA9VmyQ1t zMy&L^C+KecE^x};UzN!iD6-%U4`xlkjDjAAtc`7JiF}V&WK)%0=Q+EvZ>P zaPVNs;KQh|(Lea+%CRk=kd-B+c}U^p>kn{orFq=z3+<>&+PR0;HbhjzRN6B~7Uo8+f`nMS!5tUN6x<9pR8z*PZMoHBM z`r1|$w;R8IV@S94Mk6?ILHw^9RJ=R6YH>jttp(}jV(WOOiE55MoB7Xj>J0L6%QrQ7e`~cRjjv}u?lO=Op6Ns+B5YO1s;AaC${Mhgd4$PwI_Pqh7=upxn?w{ zEFd$IHR3}{iDL}y>=T;99~WM2)>t{bMKk=ljrgB&&vY&kamKtcO(VA_)k3^jejQd8 z|7$5_7lHvnoi_@dmm056a=w)4Vf;1|DLZ=@Xrt_46LV2HRhp;K2Hj{wfT^!NPlK%b z+8$qJqC;9X>n`hKn@RT+4{i&E|J=gE$9C7?KqS_9g6->ol+#?~?ZCw5D$fIdl(eQ> zY0n~AjQ7@rFDPMfz)S)0!JATP?^8M|lyWmTMJ}Z2q~zN0daXqBQwhU2-Cxgj5oN`w zbNfSJ<rTVs)dLnmuNI&?}!v2nX!Rk6^qIH^ExZ zy#4IhjxyF{+C-{XUc4i$>P(8G@)r2UTB+g1f7!2qrTqWiZX^F{=hR3t5&v+a#dY^auL441l5D%L zH{&h;7+1|ZOa=!$l@aKyA^hj(rxEZ)iHzX6vgRXyu6M{NG0^}N{rgg{z}_wh+cVtsb2~9n`*aG(jQX>v0hYi z775MQ8Jz(%ZKl3@_1gP%_<(1_ms)&}Ib}6jY_Tya&^5&DI>;&cXDz#auQCU+r0z z1@e-R$*a-hsi6fUwSNY+hY(CeGRmVawbyP{R;HaVL&& z*E1L)W|=4+>jT^<*Lsn0eiMHv3hv6GYn$MOs04NVE$7hXo(~^nFvPyx1JfmA)?@{w z&b-~np->4r+Nf6}!%lffuQ>5vl5WkmO8fNX%~$T%;?W| zi4^82r$2Zy=+|MmSf|J%R@xmWm%wy%HaRq6^N2W-4c%BmETc2-3+U=^iSZp)c3gzpEjL6mR$*zj)bn0-FTDgiU zfWJAvCg||+MB!XBVR_Mdr+atr9)ha-TfPhRKN}m9ALtjcu`HyQnGr~xTS-NZ;REg8 z6Gj+9+--^>L{5>8fGtt#bM@(g8XUDS^m})KX8YMXOPZ7Ot~qnwOrH>I8JBkkLtzIi z4;{v%CSzVXtfUPO#<3IY)Dlt7S3?fJvoR2>Dz~C<;a?W$EvQ-DIOX%bXXacK=m2;08%zA?C_zMti!=9{xL$q^1sIJ?Ep+C92t3;jDQc28A5#cX8e1I zM(-({x>8j2{A}9CyWnrtr}vDa$5Ahy@L_G_lZ=-?LZ$hz>#N`Pg$)-3ug)>Y$X>WA z?PIEuvMQ>`6h%F{i>)A5tjb9H-9V;0(Edxc9D3h0+|wOUyKhuPPuk832(Q>PxpygV zX}0a<$_x#AP>(yFV3SQ)r&n~%xtxI+zT_1(whIOKRM{_*Pv|KM5YeTh6e0fQ6dUJc zB3nirOfpvOTD8m_yXH?O&naIYIsb)d+Ex&!T$nVI%qHAEC+DxezX5 z40CSeUc!RuWKX^?CFo_0DP>+kO0|S6*z-UT&+Bmxm2c0QaWUNHmi&f@V}j?=m%<>O zQppZ)-zR*<@O0ik;KyhJ+XDZ6fx7K>&dZ1&<*2I047j4#d|{o<%EO4cnl7*s=@{;Fs2)bHHwO=|Q~Wc7 z2Zz)bi#ODo-#0RReEtN2Bwf{@5X$U)$XRG4I0X*5<$eFM0c+TRkQos!U`Yp$4@5yb z<7UJcIuY8fv_heiT(u0ba-ZinIK^kStS_4oj`0dG#IIfObq|W++mJGoiCzbW-f#^cZsb`-~Fa<4-mP@a_ z1vc=P5%lKmoPAEK*SB*nIROe9$M-UWX(Qun0KaRmM?glWxRHEAmSH_Gy#fQkxjU4m z1DkUgu~RZ+g1K)Dn;|y~YqtXq)-#`NK7fz)N{H{X1^J8!5*vx$DIhQtPLv?>3+36% zDALo=B?CU>hDR(U_rDLJ&B6RAb-KxU;PZ3S8)7Wb!Sk~t zyV<)oKHF}YfDQql-;XV*W*d*lJrL$@Jn>vm4Wqd6gm2AJ=HZP;te@C<4<1Kn1jcY0 zUS&<-dG&U${`dtRDe%7@v36-}Y)sqHQ#Z$I8nYpo@uBgY*>#?+vyRJW4pS=c4W`Z~ zrqUc4G%kV|3bS~Rh)mOS(CNNl`&XA;H^o?LPxr86b&*K3h=JMbVhii?94IRVuWygM z-y0;&E{NcsotKc8(X|*-0R=QIFKR04Hh0r6%;VIVkfL+Q+lGZa?EIKa8 zFuG+uv@coba$Zv1dzXsUc$(nEnOW3B>s8+P)`Bxypdt_M8K^8Ux#Evvz&4BuXL*77 zBs_2VRWZ^T0g@3}H08~+ms9WZ&wr=a9O~35Mdlt{-R5p$_O3M>_S~q72>6g|cbQ2^%YM z)>e+0$ukUI`QWVKYk$vy+ww8C83ZW+i&s6044Gb!Z8;bZxykiV#XuUTX>khpNJwW5 zo&|D#r8vC)RhTnl6FM5X_#K6K)ab(T+RpW@fr&(BuZD)*nn}D9skDjxh1z#7XqYC# zbt50ySVrr;XU5kfW~@vJ;Ycx#;w|>ON?5btBBfrU39TA*PP}>~-oXTqG`4G;Uk3*n z6;PcuKe$sZWZjm)zVkX5ew>&FvtDemTyS5S8yK2cw2lGk4AR;jiv|16>(4gTxxpMs zC*31AJH-h{Bq{XoSL)v1@;bb+KKjo2Xq(+KwGU~(>$+Ge6B)}N$vfvM>xwNW897T} z!g50ca^|!M9iJjTo6`#$Ox`-<9aN4ddh$m z^~po2=rcUYB~k>hGJhR0k(>U?z!os%I0c<~zIikTf_nX3WuENJ<;$`=1cJT~w?&N7FYjPXYTZaa^q70hPX=^-2k-!?jAQ>*m z>G&%{{?FrrGjCM|Y;E@&+aFBp&@U;Qs&$kC6ukGIdJsFes(nLPF{6QkC@u!CJ5Ni3 zFN;H zuc%SuOIif?lXF+uw;-BGA=#NK0Zl7W+gKMXF;+DuXs93w@x_u#Qm2=P;oFI@h}BoO zI`^yvaH^4r!0CvL+8TbB=DP2r*e?h5B`39h?tP_eGr2ADv4^9!R%)C_l4#McRBSBw zwlofxF?u*bKVp~!5{jSP&q6;BU+vj3wh*x_2Y01hRz^AbR`lE0%=*G<_h@G%7{bsr z{GV}HZ0JWMvdHewI36>EczR$w>kuQ%B6Tx<{i72gKHU16edwC0bB^W_v$hq^Hj|8N zpmn#7(p3infDoH?zuvXMuNaZxW7>nV+p(4P^O-y?xtQ;@dKxf@rp}eH=~rO^y7YU! zQ=~S-lK5JvC}Ts^aEL6sgf|CE!)r6AqK7(8FwE9fnT?=+L@6t_gi`}s5aip0`Z(cv zuI^G=#;3Gq1vh}UV%n9-Tx}`9fL!G3|qP}y2k zD%fMc_gVZ?v8fWx?OdXyiE;JIeI}qc^%9(YPx#D;|JycHq9WJMvImeh69g}qsv~S382GofyHc*#BKSf68FDk#Nkip_D7eGD z&0t>TRVF{!rIS_VduL_P0ZY-%tS;P!8kkd&iFDTEKTPtd&?m5?8UIszVZ7 zY!k+;HBk~~^>PQ`!We%Hpaw$L_2i#LX2)zoBZE4c$cc|21&jdOX)JfgHMMRgA9*hM z$CB5N(A~_p9znKd9jmoZ|7sKS7-Ww@_2hQSK3fSn`tjCI0imS(7|;)i-Nx)`!^1Gg z^89EnpK_6^=q=KLTUm6^n-~F8BQr-L*D4=?j$uGSW2D$nS;d8W>f2Ld!@CslA7Ut{ zjw}^!qhrosKLlthN~ew7CVTEZAn;D@cqFp_SWdc)VA`;Rzcl{j`w6e=gw>t6MoLN` zH8r5!sE^z1<1(06frseG?KnqL<0*Bfi(QWk!l|U zb2zwXJjdhn3FZ_CzCb$<6EC(qC~cNp-Jk5a-Y{Au)#in~w)wF$(US@r!7G*$-Xhw( zGLAD2wreLp{+(BGT3!4MhQ3(**~7WK$`rb)+yh31D|oqYPonhIugft|K{2T@!PI2q zj6x&)0?ig;5l#9Un76}0o152Z3+5k;lry15&iv8n^;-7OKq1|6QWkNBL2_o=|LpPl0c~ zUEa~Qo~Ap8aS93X(!9%gJs6$L}z=m}sI)G6FSyOM)bOeJ> zKTzlK3buBoXbard_$u@8>=pBfMcigVd zx~o(B%dOrL?;E9Pj1K9?dTxXK(9%l+CWeVrxb*LdMew#S{U+&iKinFYn>Fod{l3g~ zi^^X1^+-P`z)S_y1xe2~eDane;ZQXRCX8D((%piUpck9ly-<&AC^xBi>#9EHA3gpDyF%$+5E?p@rwCdus9gA<@5-+aR607* zXQX!$3j7H%t-NICxl>X%#o!xj(6mtzTEa&4M=wU$T|CW$| z0MQYMLnY(`qBxuvfi3DW6jl6#Urvi`$&!`|HH0n2_j6N6=7S1Ot8WPbm04mMA&$R5 zIW-m8d{sg6aG4={fDH0}U9LDVL7i9uHt~)V#p&^kh zn|gVu5*`fxN5_^_UrXCUh&EY@HeOKzo3{j%jeg>`s&9KXaQ$IRn-w@~aIn%fLi{Lt3ox^b zz|4x$Feq{{bi=jl`eB`1n8_;%33eHeR+@Fx<~M#{j40D-;$er=-xQk5q*u*LI33v)uemm(_9t*V3GY-9lD@ z$IG26jBTwxq=nO0)2rd>b;ZqUuD|@i5lN}C$>KaVZP$nr-`)+&8eDzZUtrU=o@$sW zuRzZ9R<}M%QcFJi{oZFkH_inZZ(ys2SM9(o^Xt|E?OeaCR~L6{WB}99TTq&7qz*;#Lc(_xNIw+`+$+EfnhREJWWo1?q@Jyl9C-4)~FqdD*b}_Ty`)NE~v?VuG+&;T~ zPky(b##GT|)^ajVh_x2_p{KxMAJpOn5giI!9QZ}DYhTKf+)ojNZeaJuJR#Ga>a+Jp zAm8srdsi@!WvE8+vUN&ruAsSs$10S8&*$!eCy;^^5u-QO>}Ah8LiFXxwN7j zs2*8<2lX?hK$Wz&0&bl1Zp<5XyBexfsqW`y+>PuCYAg0UVAE?K1 zgOSX`{YAmCgR3J?3y!7+HgZ=90VRWnXe8Jv44=GYv!l54l-7p^(d=x}P;b5=wf~@A zbez0;aLuN5*O|$jWx?h25z3x{1cWW23kXin8R>sP&)Q|l^Urz?H55Ye)Z{H-)O=q< zz>mgL#NPK8WP^DAe7d%4%+v3Aq4zr4eYRN}cEx?JBD7V(CN~f5$<7e1#0A#c)j>Z+ z!#TH!gE4q(oxwfcv8VMxflh3lArus(s}w(4bFI+XeZ5ll%_H56q!Jr=wJPK1Wygi; z`l+88=%J|wUBZcy^7Z(_k{hs-GRszvEwYDPro~m8(_wxtcWJTitFbyiK;X6y*lBv5 z!;wG`E5?<=m7Oof>_1T%6)hj-Z_ zdm~Ba5Zz{GfMNc#vEN?D+Hm>D^sS3&AnOiM+x|tZ?lVr|O9M@LIRQ=E3&*w;&09S? zQ{g>V&V*grxnSbDauadSB-&5#cD5|t%?NWbNf?JS1VbmndAFaxq)pCYuaLhr+9{e% z{hX^nAax08)5N9Pq4rX-;9I|^67@U!(Vwa&p%%rp`JNCzMKd9Cy39T!<>+$U&?Ce0 zd+1>nL2p?EjG}mzpH|ndRJ^YY1i-2repJgTF2`;||?`0uB=oW{;ulWt!Po1)&mCv>re^ay8cU-4nd?P(?X`IfF-WlJRKZ|odbcVNUU_h6Zug%2})FqXM*sK|>K(_lp#L5Q) zv1MCA!t~d<6*ietsXmYxvBbG^IXC9TQfcdgdioUUL~?JyF7`GH{@qOLidv%19yuB9 zA6}oL)8SQg4-s*S-ic?sQNfORIsLyw7kicw2Y>AsX)q6#dH8GRcsrx}oTJjoXT?Wv z#76qy`iCut42q&FS46Tkq56$Q$97JtCSdXHmk~YM>-`!X<~egE6*zjeg6vFXt61Oz zd-?Z!A6aQ_MNL(D=%+xJJ92!2*Y4r}VLQC8>UAecHX1Q$uM4XeVNpz_2&sg;I6_{z zgIeql{#L152W$+vuY|dca{B6k1@(^_hUv+Cg+A9B?a3WJWEq61yi(mHT;qJ(s?K-Y zgeN&~E(GuMsK3D~TnFEMdO@*7kH_<;jNRyBCyyFF{RouK)ZWX4Uy7s_jf(nximrT+ zDeTOvA4)8vy&CY{3@%otkQ}vPPR?ncv#YNuua+JWBKr!yEI~PdM9xLiCFrOMHgvjB z_RSC4{qV|16;ZI4h0&FMcBkkH%B%a+^rE4!U?v4i4zSpY_RD4bQromp@02OmFLODo zdiQC|9%6%9Z|rZ-!kxXGL;dEuf}9;wrYw7{4=}-we|tMN+;-1Q^gg^2gO%I(7^1BmBBlgrlkTc6eVHuwJwg|^lafpyq%Tbc-i3oSz_?#5^AtbJ)Zm-4&^>5b6get;Oje{TkKdKu zUc3htuTwBRxK7*gHaNhcxF0`hq^#NDo--FXHh2SRs9lr-RX*7`#TJm=L8LU{trDSn0Rc$3v3 zv-2qT;X{kdX{J24tR{@k%MjnHrdm=|Yo+!0J1VD zRXW#=cGC6iE<{As8!-EUXdJPWN`w!tfC1}63|Xol*%mMe)kIh ztVlcR(dQ=QFcnQiXT$`rX@;RvcZw|97IyDt2V9I5=4#KooA7-A2eJbV>*iNU0qx$7 zoA#vgNh(xF`XiqGl@UHCC|<%WjNkFT29Mga!apL?iQ4mwJK6*)JwNUQVH{xE{4`vM zz5{AEP%b57blWynA7G|A^Ws0bvUmNfuO0XZ-eiqpBrgdn`gO3-ZH{1fIgMmUQ5@Op`{*O8ho1q7o51%rFZz{OhsYYYz$!v@b)MCN91d8om4D6Qx~in zjuzCz|MVKDEgUoGSajB3V2>@%do`jIj*{=foJsKxx)&;2VBeCO+`O92riH-5f3d(q(gu7}YvdReknLM{$NUC2RDq%&TD_ zRrA-XY?LEnfD)CNQrK_=PtwLn*Zzx$yinH-*NEq3wA46Z$IPNf7>QjbEtll%xvq!g!K zBls}~?ZUj1LAO#(Oy^d%5nWEJI|K%CPA)uLN^RMjfep)kH}ukVrOx}>iqe6j{(i0= z`RE9ZfZK~r!K$vE-xTmtg+W#oM>_1M5PL)Du9=4s9ZBAZm8xdP>uv>JQPl0GCHL)}Kz*e*T2LMr)|TYmh1-9k{m3Fc>gKTn`|Xui5NA^#IMdpQ-_b-VZe(B20zwmjco(BrA3`@t>UVa<)e z^qbP`3N1MXiWP$>L!nI3kIvttr{as#xZTaD7*^L1#vLeb!uXvBbOv}{y+ zM;fV*;;K=vx;jHOB2Qf(EeoUk268j+r%>|CiHMkqMVRqs=! z_kX- zeCAlYo_4-?YRxU|K-_1=ZDE!Ir^0F3R8vrSlY8F6l?NlF;Fm=J3N8n(jS&^MaxMF8 zUTwyUaU0R|bl1;2otrFg2NjWdsm2J84xi0m^bj$gTZ~@O zsLGhu7+nsyV4OC2c3-Yd5;VNDVF6BV4gQ*-duO-OCPN(zDT^=HgEggi4g5ZtfT*r` z)bT74XP=AK!2@v-r~211Ls72jS3KRvWu5x07k_r$ZLVdvi6zW%s5*^m4iF^Wc=k$ee7jIgk-iGifI zfpzh>2V%(64pa#ri*~O@Vu)M;nMR8BKv<@dy}M(z8nuZ&m#iHlo_IRhO%^$Ri*Z$) z^(>}}r9y-fo-5`JO%Hxcl#)B-&q@qapA+^coQOoKyM{-K+$_=i)o|xA z!x9|rSy{+{8?uq#Hx^@&D017xJ%y0-lft>$_!Dt!a!n_`D-mY`nsgimu7mQd`b|ulPkUSER^ubU}*Ym)`slZJ`kgnpq6S9S^Z5OR? zdc~C(`jjp8h39jowpl6#Wu|sS8%aEb80~7?IDyhJPws^sW!4b_n7|hdKiOsKsKqlC{YvG_X5e>X@k*8D z%YHvT992JOO?|gJO6q3UgF$1&&cJGjPNnyl(vLLAO!8W+qde-P2dgsZC8T86_*hy} zrS@`PKi)^0DK+=3yX^VCWloCQ;LfU}A$P=!;-%U(jXUwBCwO|$xS|Bpsvb%Kg0?td zd3rfRFZb$&Z}K|t9<5`Svue8gctl=_#lvfN$oCQH;PDLCd zyN)u>WJDU_S}NfV)%U*BS}1RV$fLzWra}AI=#WX>eqPPtf`u69^n=VB_nn+BBt84f zT?O_SG&`fK^-(Bj7QZLALkKC$jy0O>bNy`a`;R$oUke-(_j^v^uj6eYnSk)j_l+|wCxJyCv=tjIX#8nCHmDD2ZH+3 z&iQ4&PfNbCN@%`6DJhtIy|rF*`m@DmsBZ`QPpCtGh|z8}9sHb=EyX*+`O-%75kHYq zyr`r79??Hiu7Nq9WIh0&+2eyUp@==V@6{RyLY?xBP^To;Cko~5ox-BgqdIfYct98I z8iTF(pcSd|L75z)q6z_FvN&PKT{>|>aEL7ke2(u}K$QTA>d*|C9 zCIUcz{7(#%adIoMCd9-z)=;2E>s;^v*G5=K;!mRcFP|QSVD4E0(PvPVAMtfK5aBca zR~BTT=QKy}gIVy}nR!K4Th{B3w}ZxZ7;5|?01ow2L5$)?_5V-pdE>y>Il+H52apMX z>raaRAFt6JA(NV1SvIE+kpnXS4D80@%g;9T5`M(4PU3W(JtKw8{z&i>*a&R`iq z?7-?uN3~(rhma*Ri6$uqKp?AH-NkAN)t`9msPI}47J6R19Ez1gFf<=dNUEFZY{eb5 zFvbc0Mce=eEwJ1LkjmbhDZH*@R9+J=5BT0%NmpYHW{~~B{8lphO$RjeM)ji((T9VA z7306noG&_rIsfqx|1}7h34f~u=!n^1Xi`Yf(mq{}rQSpg|8ZJi)4Usb0{+k84)Tuqz^|GNfAxV+yEi-U5ykgL-Tm;cx>)CAtx|Dp%L7W~G0TmR>u-6YtA)9; zXyjF&Ahu`O8Ika$*$|T${%WLKZxv96Ka1gmNyF;v)`M#Jv(;B38hoNFEh6>}tAa&K zj^?geHie6^l|sn;8^aRQ%~t2e@(x4^b9}gK_ulW~h?=0xx_f-4{^q3sVtC9>3G_gR z#FNChX=sGC4{Bv=KYP%kU~XD!{8eM-TS(~$Krp1VX%w=>r5&VotBcN413LvWq}Ycw zbhfGiw7+simC6@Dq4du&NoqR6g8dCUEXG|mz*``hKYXOi7pr#Qv#paO<)2@z>rwH zvLP2SN`6;MR*(AhtBY|`|MYLl&Lc}2Rh$fFnd!_-^vwtp}1Xnf_aV3!+Vja<5ttY}s z`|^zULRk4?#ijv?El1yoZUe>w@L9)@<&@qW-I;9bC|( z-^X;9YvmWGgB9L@@MD`;OSuvR;#6!RMjd?;+?X!)j1!Z`R;G8dlP?s#QDONSZ4DFV+xHa740| zm^QPI&c_TRaUsmaw#7NIv~dYo`8D2JZ?GF*l~38ujg(UdM`j)ZL+n++{Nh^?G5GTl z)!&UH+WS%qf5mzvqX!>5Z~Gr@q8~Aa7BOP7<4&MTW8Q6UZZ4QVN^tdX*u=_Ps(8`QD>Vn?)TK+=T^DAe&q zkZKeUd03rk)6_(a+o3BS>ti!%Yf6?$ES6F{^-mF7ekS5JLF%e`+z$6BPSV67kSwbl zU=wB=QSq&ATf2epmYV&w!-LRUrS-h&Tkhb#QTsf8!vN0GF0m zcwP8?cyLSKC}`#0fjpPUE%gCI#ms!<-BY{yMFST!p?b6esHN6q324yc;eYJ`APj$= zFy1z-Zz!^kI?NAV-u4RS#6_~|incW?IxU(bx?W~w)$l(|_wyN7`cT(^&Pl98uozDL z;Q=u&h4Ui*Y`7UJEmEMroMHv;((@m{fBv>Kh5!Qybz^NQd*6S}Rf)+jVJQ>%&da2f z8h*P4=paq8!nVDNahFwOtN7{(uXK8dKk@buzWma7?yw{aB=wvVTV@MJU7cKRl0B2F zJkjsGR+>AiG9TH}b?Cb{e2w_?V!PFa^DdO`KRfi_xMedO&Vwkdrwgyc%I3KRtIrsk z82-3^<9NNHddt`7#tRdS1RWH^qJZ=g>&8%-=R53KL5-Qj^D7)&aj;_DY|u`k6ObR% zuk$O+Rhc)_+0k#aNl%!|!wOxC+=xt`{W(*685AnX9QlbK*=Bp?=27apKx9mcU z*UJ}7hAB3YtNA*e26Qgyln4)`9mdxIL`jxZ z1ql{wTmL#|o0SA!h!=S4WWn&!Lon8jE7ZV9M(LC}-< z!|80AF1S}r&PIVxojiPaL3#Vk_1Ou#|LWC>iW+-uzt}4}tj;LobUh?X2Bs9ak=5To z9J#gr>3rNtz01hy?~N^dPIrhVzYYC@&qKQ`nxOEbl(YXANaL#yJDd#0t$mWN;OBc) zdq*r+GFqOt6;4m^DZ@>&W;Un)cE+Z1haKEE^I@%rnX9S)L*@|R^rkL@C*05YEoj-q zkB*YTk1wtCD8{n_W1203vxCmb4H7{Bhc&z4{lg7f=-&W;0>>M-WsSx-j*H61B!a3r z*A~~4+T)()>EEj6*XZ>xA0PdOo(ES(1cOE*TfPFE)W3FLTWaLzr;5L!H6;g!(JMuN zdq961Sq|lu&MTp=G~{H{|R5_V3bPoL4enB z=yx{>sNE`SNdjqjfJagtj@+OH|J?L{Mlv2N3|N`%2gobR5fp4x<;WA!o!Dp$=^Svx zqyo`#r!?ndqgPT;TsAN(#b;;+rN8h#!ZBji@oO3X9+wQN>o z2W%#x1p%{TpEvklp2-x5-^tz^;0}Yw* z!(Z(XBT!dd3xt#|$Vj0_{Y}Yk{-sxpG~)N1kUSj5-epS&-SBV!L2?o3wjzP?!WiqD zvDs6vj>cMz1lBq2p{}%v@)&>~m%BGU1ZLS6;mTH=Cs8FE)vwz_n+2kw~!>^Hc4;F9dlzf(36c z!**X?S7&-{Z`;x_el03Hbf&np2ZZ zdB-v>?cds4Tg`N&rF5G|>^Qn)*H%cl(0=Q!(>>cPdP+`ayw%c*Xz{MW2-{BfN}6(- zw|ob3W*YYH@BC=3Q!qWlhYz@}zKqbG#XR7D9C@4!9B5UFO%-mV1yOZk1*;0mMx9|o zCSe^g%`ckS(4Qn(v9N6AvngWFVDYq*tL-m^J<6t%w*O-xgd30HnTjg zgZgn7^nomHd9)`P*?GG8>tU$2zxSBlsLOs2ulJo1c~@75eZZ4v&(dTRD&XYa_G$1C&P-6U+ZZR7d4%fcIxy> zZo3nh87e1TMDp)?-JhwU2c20d(@~rbVXT!dKW#kzp@Qz4HW70T&P^G+;>M*^Pm9?N z-t%xQubfMVr_#>s*vhZ0!R-cwQ6(UMGEl)is86zs!X_4kO&=jP3iWn=iM~oEdizmh zpL#3pmk}|!zvrDJ33fV$Vhk>D)Din?eUSmB2KMF>`u`u&lKKWR8Ri+?^ngU58uHmI z@Sst9d-hu4rkgJbpdTryLBL^p=(sL?`dip#YQ4X8;x1w@nUP=y%Lqy)S zm}Sg52t~$0g?U+O@{mz$%1cXR6=Ti2H7a4lSZsEhwmrY0=kt7?^L(D?@89S8-Jkoq z@9Vy=>$<<+uYoXK+Ie@!P`b&o#r6_Y0gEv^OR2%Jtqu}hpTp~&DXm;$hc9@vx635I zJx^y$YE#OJUEuaohE;mJ;zew0^<(|VX!{QuR2`bZSCi>Fb=K8oM09x!A2^>65OgD% z8pDK3_7^kJJpZ#w2`yj2#Z3W$dy2;NVmIi)B>Y6uZxWi0O}y5-To6z(m_kNa0Y z(TL-Pt4(4pxIwx@n}$icZ z@7)}d9JFR@Zz?02h9_30F>fh?k6X^#c*<5AX`c8s$S7_-jal zYV1($^EVHRe->0O|}#mAa;_C z#=q*!A1||LpqZ+V5;(Ex@gLPdf^kMhiFX zz~fe_G)kcL^|1(3-n?SKC#Bnd&6?us$|CfTrYkPtOibK={(KHtU*X$h2= z77aooPi_WWu0B1G?Zw7Y1%?aJorB7d?1UJMtYoKMw3(eyUcXeUp}ma#``f-M6uge- zah(kJ|L>c(QyqYHD+rW-$Bl`G=WYouAkiEu}5O?CN!s;a7y5Z-4= zyGF`hfM{H5voaFgzWiQWj7gk-$7qakTBFvw=|}4gUTKaPJn)orC%eI=Jf7*y{VZ46 z@=N(LbxFiVbx-2#b!>LjYk4@zsthSWt|3o^9>j2lE75WtC@*jStNwg)zncqg5qRf! z<@f=hq<2`EWT{ireN$g%5n}?g#-O!`7CKTh2DM|J95IU;xw5AjQ05Z+5n*>4dAqL+ zHLj1dS<12z4tTc5-PtB?`8E!LLHZ5Zee)m~AGDf_!&TEz^b*sDXko-tKoW)Ch~c*@ zZ%$fOm9W<{vi_k~28keavKQy?x}M6bnaFRTi2&ej;p52RH^^asNYg}$H37SAjc)pp z{8&#Ac@cCKVpyF4PfAAm;8OCvX@a@NzY9dauKVXK#8!Z#=Me~m0nCh_cD=b$nH52H zrub3pmk&Mk}ia_5qMw2Jzeg3W{P1IO-qZ^xizu8aR0xfY`FpWKa0hE67Fj)u>6U3-Q`Rp#u-_&=0m$nCe%bnL>J_Vjgmog_s>`DLl zoXO?k&L)s?00r4+DhE^4wPSrbIjwKy217h1Q1aKCJHe7#r!Ck!3xHs ze#LWJ&0H!-;tl^InGRT@(}c06mgF$Uut3{q^LOE%Y&36`QGrsgD-QOHhfc$HWJpbB zYV9^QNm(mHcN8W#u2^Xe>nx3F-lu1rb2pQ~Y?3)*&oc`uRHbhbX4LVjP_#&$Sp|c#K-Wfi3H&f~WF={|{=mQ7MwY50JQ?`lc3K$as8_RlvLvnY(VmB-z zv6<4Eg9Ivd9?g*rG_G4{ZCE7O3aB#PqDHU0V3;>ol>p-`8nx(%agqU68dP3Rthzd2 z0pjDT%f?oV)_aMLh6sX1pgnU5@C;G%0SkHE(Kw-|bb9`om!thk6Ig(qQhW9)8$iH& z(pDE*`qG(22HtXjjccVZfIaq0oGK#jwnha7r84XfmoP}O^iX*nvr>h#6W@QAz={SJ z&Tdhmo78%fZUQk;VltmA#;7{T0)Jlff<8AGXA4G6V476#jX?noAMb7;YAz5Plg8uw zUDKud)6K}aoS0qfr$8MbHTUGpOC8WXKxrwT6-#B?bS5mgc3YTc*)6@= z4=xPC*nQ=90DmxCw{3N|6&9-A^&z40jx=3JKohE>e51JfCIdkK#_d0{j25wJ098mn zm5{L!FC!_Xv594Rr&=hK%ZnIb=+ZYi%%MGRE23eLyej@CN_rv4KZ<=s61 literal 30045 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 diff --git a/source/clear-linux/get-started/bootable-usb/figures/bootable-usb-windows-3.png b/source/clear-linux/get-started/bootable-usb/figures/bootable-usb-windows-3.png index f9e32fe3629ab645f89d536b26cbc3214c84bb05..e6ae1cb5ea6aa72cbaecd1d5f7712f9767a0c6a4 100644 GIT binary patch literal 16973 zcmbWf2{c>Xzc(JO)>Km`Z3!u!>V%@Djj5>=9Z=NJn&&aJNX+3eRMb>0S|zl!=6OhJ zo~!1nAqYYdnjkGgBf|ga@80*lcfHSh@BhAgt*oq^v(GvE?EM`--_K6;16?g%?lasV z5Qz7VHrxONV#@-74xHgU3>>iyxI+QH*t`w2Zh=brMScK3*qvZHFc7FbfoI3&5b&Gp ziS{FJ5QwjB|HIblnP(3iJnD1X)W^`%(Z|=u%K@b2<>27q?d<7eX~YR!0&BkmhduPO zT$$Qi7wHTpF$OZdbGv14Xfri*)#tsQ>c$^?6mK^kb|ElZHa?p@{$e8a`|ks998$$* zyZ?stWI4mKti!y-i#hMUzh!XlCYQc8w|Lc#_=BVlS-y`FTmp~_goW>3jHpKct@{J@ zb-96#C|^|I*1Es$NOqaR(9n>A@=)o@_@T0`kFvpCpt@xXnyOttR$1w}S;(TXH@WvT zNZ39c6TROqbixJX_L~EiQ~Vsza*B?@+V@)$QXKPUzg6ho;~2Esqg$m7h5U>nlXfFOSVwo}50Qs0XqJB7@ulCd3`v>k?T8i_GQ zQc&`2v`n`B(I>2}wM%#)aECLb6H3UNSk(bONhrWwv_j zsl5j!uPL`*iCifdpAa4Gl9nT^W7)08+&;zX=1{la1xBdrO;4qnd~CZD=IlsO`!o`rnplvYfMLE8}322#bBZ|JZ_!FIl>v7lw)caZ^VF zx?HYImy-gkY}3aKJq1`Z188UT>{8$g|IuAW(~b#wJtV0A*;hs&?V8x{ub#&x-e+DD zV~y=uB(J{RdGJeltK`X#$5OA}(vHM=y?o$IYf3fd%`#>Efc|y85O)lI|2~JunQtzo z*>+;yUTjq*0x$CwFd0D;WT=g_;VwBnFAKXIKr<=hScR^w(T+uO00= z-v1ieb11bp!8PF5tq=DFREh z!%Ac&gnZ}kmD>AhNLJcgX;Q$~(+KXIECbjrZFDVbn;PSjYQbiJ#v5*pxLzHcE-7?Z zxP5TGL&(T^DPY9Svnu7hpTU4W?A#X&AX zbwMvEj2`C|=gKt9)lF4i{nVzi`+JU@M%u|?tok;Y6+8T~9A`Z5s=cj4vubO$rUU!5 z)Yb&Oe|-Dsdg0i98~S9pm~g^=yRd1ykaFT*hkgSh`NvAh6?^|LqsA_{f6{O?8d!Xw zbwj7NmGMUbQ3Dzy$9u6q8Mg5%bB7%i8dpaxspAv}-Be>21VJu^ae`i)fU$$VJck?r z+20mm167D)K%hs0a8PK`emCR)z8g*j>i?sNGjgquLKj7s4YmrG0OJZ|O-5rBh6Jr!UN-_Z05bOUWS7e~Cn57>z1 zS`>t)X<}z^H0mnT_;7+PH0=DQUjgk+0U{f5v8q3lyDkrY^9Yn2kIOMyRDD{4eZQ!J z79GBJV5XU9D)2)d86|>>u*p4BXoBpWZJap!QEkvyhAMvg_wkVD zk+uVJ*ATA0xIrWo(|QH79P-|7ReA3o``}NOZ@LL6s(X}Oze?fphsr`_2ST*3PZpMX zE1J(RG8A9G{w82kn5cLXRb7VQ5%nf9Xa%y{)0Znku8Hx&Kv5l1{a9iHVs(sP;lha4k(8?lF(f6>vDY|8UoQ3Rz;)^OrKK!MnZ3zZdV5ZW7 zr`J;O?&mOBO(-grvyOrYetUBJ7~M1hz1=GD)&D*iT!%prPr!@U{tVgbI>uOKk)jIr zDLLq224b|Y_Nk?v7R=}SY(^poqDBkVf=ybXwdhkpZG|5)#!AG}j1->t2(5_%12qICF3E zC#`_3+2-lme3x99Hiy=U`#UBBpinm5Of^-Mz=`F&bH7VJvVkzBdIBtaK))zWFO2t! zeHd0c9Ms4iUyfJ73Z5e-DaZuYH)QP^DAc0jZwU9O(BF1V8ZT$`6KIY@ri_Y=O<&z; zXoEa(y6iKgAjMze^>bdxcz>Mza{}t>!v+-nqv)@{s7JclK)C7cCW*U|cWfHf%Oy^4 zIn@L?3v^J~LCY!E*b{rHw2*GbQnmtDQdiX}-X9MJ=}6VLX1|=igF=h17zq66v~O9` z9uthcXsE7Ph{nvQ8V|wd$!Ul=bz@E{2(GAu zt=^N0f76id6hmkuA~&5)8cH%G$nAesPvR~)yTK?Iw}g_Kd|E~H5#!2Ut>zWfXX&&} zG|2kC*(o?o>Y}?=0kqwAH)7>V+nQ0QYg@B4&z;nQ68nZjL_un;Z0a#B=q(M(8ua)3 zm6rh$o$mR##}2}q@uIvbzU*&RHJf%TJ2n?^Fy*%O!3lLxtfx|#_O17;^VQl6W2Z9) zShtGlindZM4qdG&`7^Fz)-9+z%2{WVxx=3L%Qby@I^2r-Og@G<92&t~t&^=aZy#OJ z6c}G9*V`#y(|}qLYR*w~o@u&n9F?KDn4Ai&XtMvx$0;ssFMs!=e9fqWg^qZdRR8Ya={frKmF3f?m;xjK)3dX-kYvOAw9nF#D=&W{H=m z4goFYwB=ojXkR^~-?E2%{6OurxNfaCf?|{{WO441ujyje%H3+0nYD)k9TT(CJcOuD zEHIZF-ZsN0ZrLh@EiFeIJ3T^|9!q)6&<^!`xcIinWVCBeW{T@I65o`2bQY77Yhi## zUzIw0BKUaT#6*obZGivP+Eep_BD94yoZZ^~=uL~WlEz$FucY)!n9Abd>#qK+AL^G& zl?RVc)#Ol$$F8`J`W`Z8ns^sXms!{dj7Xd^`uq*C^2kHu!-Unq(<2^EUVES`8Af4C zC3UN3lrbn%uZKfYB04TL;h~TNWoY(6%v;)sny-mwnd;vA2S3sj(}cVMGM4z`}-Ii^u#n)3|^T(p4R`Cj*3X~a~HCZ zqF?K&uPv$>&x{}*udkiNTy{3AishunR=+Ql2{t#XVSQJ5NIl0~cLjqWRnKS`9}cUM z^|n?dIhgt|w=@#wbZ8+)-eIxyb#8ak*f^KT##X{+@=~tZEQQ@1d3Euai`E5q4O7BboUaHE$Qn!%OqPh9E_;-x z;F(6#bAR)JauFF7b`n4XbWA{@?P?3 z>Y#bS%B%|LrdgXW9G2^*{G)@=#n~pq-^5=*s`-Q%&TB91K?p_MtcopKPiQ$5OL|sP z>qBgt;aX$^O>hG7RP)+D1W&FDkXj&`1VI4N)QCL_mu=WM8mh7Ujy;jj`0_cFS`-j^ z6}gYZJDYvYlm@)V3oy**6JXma%(Mh78n^2i#j+uUo#DAv3Z**V{DPE%gQSN!A%+(kfp>m`hdt&UfdFA(G(3Q`9Y2?h^U-&*x(s~3|oz?s* zJMOtAzc{VU^M)1LT6d~4Mn-lln7w5__=*s9MFMvfW1G+xc1#~zUvYn3)1S-IcV_{o zl_2`7JLe8V`^JfL#gP0_>Du~?ttGo+%gpoLCY>Y0$1-wYd3H{z?Dbbm2 z+7?b}(0SIYIbX!j{_qJx;xVZml(m%VdanX`iiXDD@Fw4P!(M)cG|-e4lfcXiJzZ;y z7=td7`v`rdB;>x+L#Qm+@lk5@NMx2K0D4X4rXu+u`V+YUL*N@e|U%QZm=0 z2laNuPlTN?^L;en3_Fg9@$mFxs~QL=O_v3|-%78dx_1jL*TfB*-5VZxEY#c6Sg#jo z!E7!W{A2f*Aul^U)_(ULijVlJuIxJ=1mQeeJ_VC}D<#(V<@V}{;LOk4eA4=jNdBCn zt?9{G$n&IMDLrY6x|1(n<@MxtId@qekZP+5b zLDXwknGm@EB|BKL5B^PV-FHx@V3G-hl7|UoN%#3*X|bUtQ=eSa9!9)~jj+6A8AY`4 zcZ?D1bJ?7}KeuUh5Z-pmoJ`bMB=?}gjfo-6UEpv@71nSxf9PeAJr05vX z{XA#5d#JV78q_WelW<%(Yt}pOqm80#=ij+8AJ&*Y672)~{P9npIkVO}x%EcYk808` zwJv%FFTc0vj2_xjFK+;1tFgcj>s%dKJw3a)(=H!B;KVvl9!@;3d|oN`e#kcy4IL&q zNou5D?1pQ+%oTC3Z0d>#9?@Cq!P{415f1sC z&rW8)Z*whz96fqjzB^INW9_xk0*$LncCLNSB*a+_y>|?SO**X*!48-@z+{idorcHn zRH`0TT#LER@W;I%RJa$>B5nb9J&OU^6Ks=FDnC?B~z6thSQGISjID z2}fZz0nWG?_CEYXOf+`j{Xh7C|1!`1mv`O{IXs#6hUH&0d4SAxd|8m|HZ{>zPM%QW zOB;VkGKuTj_1lxUP{ymtot5LALDTDAMBm|Nr55Gx}> zd~L=#CKIh%?52bBU5~7_l&Y8NW{@*3^gd_ysR?rRoTG@&Wwi7YXR>ctl+>S3i|H!O zw!pbzYXz5Yuap+b`qjW}!F8AQCZDXtG!zVhGfkYn_S;(21iK3xZM}mQ_=^~{AQR0^ zEZug4M<&G_v`Tt%N(k+Z^N)FH$=0dtAEvB|+zVGr6pu7GJrO9H?c{DbWMBdR*sk;S z2C2ONa6(hlw&v25*2ir)8TmUg;9f9daPhshXL}>+NPb&#$Lw)Sg~+p8$>w^~QLSeQ zkL|5=tK)o2$JQv}Nkpp(_pfRVA>~V|hJ-i^+%qlj=M7&cZ(qzlV&aj=Q*4Jd32~W) z6nwI2no>0IbScMecpU4OqBhT-G*{4|UAjOx4c7p05SnE^`L8FFnLjElI^RbkmeM*) z%sd6UausREUS7g~i5$h3)STVnsdKCQMAoDPTqR7Ubl|ua4UscXcuGEDcW*NWXgz=PC`GnJ1$WIm5(_7sfe+PdorLBrxI$q$`*F^e`j7*qWQLGKh z0%lWg_4IN*kdHO%mSNG$`ePJHYl_sd<}gn2nHOc*f;8pqMD6C{Y)g?dQhFJZn9%S$ zs;!luMR{ws{qH{;nM4vS_5mcZ{pb`(-ZtVqgAR^eD5v@fcTDiPSB@c7+Rwv$7P?PZ zOBH!lx}VuPiQAAt+7QDFjX2L<8H0Rr&mo9u#RqU?fK1Yqn%T9j#M;HJAY&Qbt= z{UN8gwQB9Ew9>~`=U|x6FJ14QF*)zv8|d5`X989!cVo@2vkxoOgXquv)+5|Wt6w7U zUUtEUYp-I-Xct)?TCp8@nDKjUE#u`vZm++mSX_*+s8XjcHlf5UA%@&PSAa!k>R%7J zTTQC2ftJ995zInwiC`YqmjK=xyd=h+`*o=l#+{R))XOm3{_Zk59&_93NuqqSDIZ#( zV>PX0AsX^B@DtLiM4#SLeWc%U94qfh$Vb&Kj64OaXFwIXr1849WQ_Uje$?S7ot-sc z577m`WX|jP8Mb@89Fu>y^6lfj!3A+#JcRpoXSlW+#KVJqaLDP4^Z7H+7oK9FCtM2M z4TFBub7^1zTe69Ct!nHL18Xr3bBeqnl`B zM>5OT^6C!=({31F@P4cc-<0JO?Xx*iE_@D|jR_Zn>p-d+@9Dp##oMw8$duxIv$>eT zaaO)yHN}Tvn{d40;Y08nuC5a@A9lU0*1#_ahs~@i8!w0{Teimrdm_{@k3DgXkb;=X zlXX{Gc{sI)lcv@O?dZ&sT>_;W4Z zpee8C#D|LM&2cXAHM= z2y3RDB8M$MHDtUdT!cfz<QG_&NA#u%|z`a8k+D;_QS?;KG~)`<{vS>}E?nuNZzH z-m44sus(o$`irKt-r>^pv|)~!u#G!(+$rM4tRKzFx@O-NaYB>8qR}0#sPXo58CRX#o z!W+|dsHN>Rs5DdUlihNG#4k0_sVQfPEFgdJd+)t6am`ar*bwWg~7Jl_yi`O0|V~lFzN4)Hp@-cbv ziYp@XqDhI{X8vZf3hrTGfq!8Ufxo0AxM2O{g|rf>(RfokSaSN+e`Qz&S;QT2iJ=Ah?ODH5OBq$;?%FCV%y?24hR~`* zpSJmn&`Ei)SjgbxZ-%-*5}2LAMD!VaF5qa!iDSyn0kNlzZidPo0UIz7U$&*I1-}I} zbsos({~u~M{}`b{ugM@kP(vUqu3|tjM;XZKh923o{w{YH$QR($(25%BW-GUSaNy=)_Q6{zKbA%m^Aq2T z>X#gc0PisM>MsnL`KqGwNEL3yZ(eCU(^rLZ)KFmvT#26~=@qD=#8e$@=`MY!sRUBi z0yLrYU26_LSe2&l$}}E7G%?>!6{S9v47I?|LcX=UgFYFl`O)8W0&XLNgb`?dU)>_8Ps*Ls)|wkVf*ciP-y2 zAqnKL^W!bKP<%Cqe!Xg6Y17WaE;Phns+v@$qqAtisqBcfga>;Jul=l-B)$$xI2oj8 z(8IF=xp>P@UhWvU8B9EQJzY@*{#R4BuXtt_K@@(=w_VO=CQne;C-|)pRD<#Wi@LvK zE;T_|7v)9ko#f4`m60}(4b^ZeMFJ?EejEw^vOAEu9dasJ zw}uuX{n!36!A6OTdxa|j>>sqWDNVU2`_A9-owSh>eWbL$m*&Q@@(4^g)WGU!{YrYh zMY1Dg*KVpYw**BGf~@oO(M6D!8K9n6p6=6sG02@ml>I&x>25JNs|S=!M~(K>^}t6^ zYJ!J5YDaxdii0~+IGFcwbq{C~MzWxH1LtA(%5KD`Jxh6%7YL5kgu6R0?)t2T6ArCU zYk&N<-2yKQKH>gxSk0*J71P=CAn251I>d`jGNH0Qu{|gJ{N{Dtd&wqj6BAJZ8*e7H zKJfx0N({?mOy~HEoWpwmcJ4=hubqnz>U>zrqx`#s;T5vd`Sk5YS>_!zv?0A}0!)nZ z-~d?*W*ZI0~45<0R+#x{_=pN+%EJ_z9hc9&}Ujl*P3bq)1pm-0oA5Zkm1mWdKP-wW`x&53Y z?*4xIA)LBz=M?1;E&{5K{UXYa@fVy#3rAH^n$qfaqW6;amP|4Y=^bAbJ(#zurpIc} zA`gO|y>N*MU&;_@Zrh3l-nBt{Gjy`WL-T(1#@z;jJ~a39NJmMT<)U zbSnIQ-3j2u2P&{XhH{lu#SNC7 zJ0f8hF$E4rkJN`-Aq7hTrv=%XA9q#V6}WSFfhVig+lu8(50B7h*ki6oLoQyWpVL%p z_}4onL%M(3MV1ygIA|x4s1XYejkLj3?kxL;3SIQIT#ekKG^;+gW{Um9cZgTQx4Sws zc?!Z{~HynP1%889AK%PmTT|c2gon}qwD!kB!oBtxPrnI;E1~ILp;#(B&Amk z(c_tQ@~hWEJ9_(e;Zt@%T@&Af|Jk^<8fg6nkV;xBaf4Um=WJ*hn3<8E5Z)~O)4FYi8quF83$>4Emp%F6EV0}MWj+M~!n=Z)Bqw=d+I+p>41FOCJ8B=@JFhvM~8kqc8V%zAEfL+vt zo%?1(AaQi~Oqv9sBLXG2|8{@S;E^ikzQO{s^H@c7@ijGGqt=+3i*r`*S~`|JzS=(; z$(dIR_i9*gK0HpvQNv#}swtOD>C*%qv>PI~HL@pi8ZvWK_%iRquDU19KHFRsPw}r= zngT!vSlUbG5#qEGzq`SFVwILvCX29oeM{TSsbMzH^)^1goWn*w3d@55z=wuE1b&#S>>jsU~}7=?WU(X4B_;5dGDReJeo80RSr)W8sssQCzy}h>Y0Cd^r|p2Mas3VC@|znuB2DYI4ZAz}w&VHhyFm{c$H`eW z>wcBX!wg6D0A-7irSI6zLKYHVIK(hqQ0$~#6|$oSb~PrXDa+yrT|mu`!x*;?n=k1Y zqq`BX@{49Y6AMgQ=Ek+U3zKzq4m{!KpR!ri4~eLwyVIefW@5zE`Wv)XEgVwm(XZ`( zXwvrPqD*sHdasaB9(Tv5igdn~jvv8MD=*4)s>HI1E0DVuS|c1d!;XfJ;o2mH+MRby zsp|S3d7|VK+G;wMOPmoQkqMd1+}++l^=;1#Wh6JA+F`*dTOPwnjVRvtRLrnc=0t$! z#dh;rp9_C#$36o7SZ_x3B+Z@`C|N)7eanKf`-ogCHfMR^DUFQp3UmvHeUSM*^NccG z@-nE+q3$f(i9)OHytHx4$%U^?LG5RWpBRp(O2pi*BDkr9_0?)Cs|LhI(7SO7qlUKXIhYwY=S=BBu_E zai=9d@UR3R*(Sw~ZhH znRyp+!HFyGX685WGM94~4NJiz@d2lweftApprDvAJ(3RSx)*|hwPnFdK9O~?-?nC6 zFgu&hv6`PUFIW-~+_*bah9h39Q!DuVKsODTWY6$z18Ut^P+#1Y`M%fN0TjH@6C=&0 zO?IOHf{$|RHa&<^Eh9`+dgk@7hupwCP8fYG5wl8l{>9XKorrilQBa*rUoe#Q7HzCqdM^3fra_G0zZJH5c&7Gi_jccUK zVyL|&LXk?px5L}`Ci~L4cf7@J$|$`bOi96XK)IZH!klB4+jEnD4vCGr5W=0)v~xwC z4LN`E_2q*Nx1hI)-}Nq+>m{3tg*i(Kb8@dvP2KtfloWa;;7@Ti1GvIJ!jGGf1E@R8 z&}q$b+(F`H6qx^MC)l^>N4t&(>R>W;lkm>M$fuXGBt8PaJ6QNkd3cKM-_tZ3UImC=~5EOIfFN|df3n{GV z8NwtsT=6YU*E3eDVMw}aRj4kyC#43A7Y-5a?MN#E8uK(S9g5jW2fZB z;Sm$srKkPo%$%V+<>s41YFh@VMp z4+Obgo4_o6juWV@6s6B`n0;e@4R2++6&Yp?N94fhoFT9bmHbz|eMiiPieHbNzFd=NVpr&sWj$T8Y zUu1cgjs~s}Hq_c!ZY)Ip*3{!%>X9viq0{nCj~m_cz*ww)lf*ZPcfR#=;Cm4-Y?b*5 zsXjhXTslc`)CNMO4BpYVRC`49|M3$Ue0O9pWmwJJ$vG06!F}68#+VS+X=}8Ym0t(} zJ37@>S^L|o>x81JJiqL`vok*F+S81Z2@D$XU)>EoVC|lLIFVDVQ~JcM6HG1=`j!Q5 z=;_~vNu>w#{s1X{{{cu@(|nX)dr~C@Wzn*R;Ld94EV?{=GT%E6_ApsmE2Tsw6e+BV ziHJzp5u0E8B!g4SKUE%q)g3SQMT)LHMxKF5*|)u460o@WWygmiiZCKxUvmM(;}3We zfA{|ao>0T=l!_ATSo-UY6%YNi<|?v5lanw|Mevx1qQ80N}*sU%*NF6S2to z8^Yfjhl93vx-ji-_|c)1wWwnY+uK3Mcc9@YY40G4`RAss17&<>C*h$dpB)Yj$3R+7 z0)S{+=>PiuPXXqB==y(UxzZU#bpSdAtuYqx^^yA!%leR~KY*HozAXNhjs@b~)4%Kv z{ToBJaI1-CxF3pS?%DNP_4Vbf?lJjw`g&7R(^z+^-Jxy>^+{7Y2;?QaI5-J#ZOoVa zS|ESR$-M%q9UzSGS)Hjtvj2S`Dl;Qb3CMwdn5zpPJR!aP*9{BvRw z;5r7!nnM z=Zo>?tsM;4=7`?oX>=5u%ErdmvVpRN|H6E?c@ITb*ZZ5l=1g%OFAFLV6)e0bdubT< zuxfC(hyUW6m$1Vi)2KwzzC+-KZ|M4u2k%O@X8m;}{h{hX$~V|?vjNiC1EFz`Xug1P z-uNF|<^MiE`QPGmiDNL5M+gMMIJOI9vkzV>tv>*|-u~wfK-!i$xqA{wM$69ZXQclk zCMH9^D~pTR`lgv}ZuVw)^-O7uCa*SrG)4DJO;?PeJR9hV0S)fii^X-G(ZdIqfy+&w zM|?KxD^7U0ev~s1|EA84dMjblb$WZ$tXJBTw= zb-N3-0_ln^Ue-}S{mnq~>hRW$=`WI|xnjBgv&YmP3k$#xojx(;<#x)pc@>DGKjwXP z4)#69lVtGwx-L0Q;NBtqvR<@UhchP!pe>g>_<7Z>4S;xtu6;p7?l#UXGF^Lwe;G*6 zP4AvM9H1t6e0obe9=&n0P(g9+&M^P-`TaA>N0#jrg|9k1af`eTU~yyN2_TynGuy)Z;z&_tGe`PkIUU^ zS=kyB>SlfJ#=N#_@aT!HCYfsOQRu=r-g2aFQOSGbar8*AowqGa61!}ur|O_=_#t?f z$Lfmu_FzK2w;!!x>+Syjj|}xkLc%8mf$0DqKKP8iH_fxrrIFE|IsWwqi%uJ%(t_s$ z$xgd7X{d%56;1So8k0_W`=+B;400`Zzs?Q3;W5der`$PxLHRRUL;j2{JVNe6m^O4` zF*9UZ&GuG$Q0_U{T>q>FzpA~c-wfM&v1f3P3TtDCeeetJBBn8z?$2DJE>M;FXnTuN zy`)`M4B4Bs(`Z8G7kiUNYRu&dHF=&G?(WS<6{`1&$=eb>%@w?yq1D?}YVINZI&rXo z8J9?lRAYX9MfMiTs4BH{Fs{D)MgU%yeF^iSG7iakz9xPUtKlyxrEdHJzyx*#;d2uO zkeB+=K}zen>x+FP#uk5?`d;~79ZR@FcyB24cMjuQw))SMknev>nVi9XVtpP(-e~xa zjxy~`5CX_DHWB~Wb;Px$-wsJUlT zisoubQ=Ya}i2+xo?9+@kFSYioo!gv?G_}wuu3!}~Ka-180jV!kPwZ@0t^gS6W4d2i zsWK#`CN-iE+`;dImSn#7t1;auy|v)U9fsxT5^Nrw6TF#bvXXFgn$dNSJT4UCP8i6P zZtC%0c)RCTZFKOglK}k@F#YClmee)M7XpOco2oeySMq8_6FZ>tKTZ`od^;Tgwtmn! z0`q9Jn|ur5){>Tv_I@>~+rZzo^>lqP@KLt<+q$DF;>@vNy*D8b*uQ0>w+5DXey!`h zX`+|&kUe)-34I~8<}$)_gXW*CaxYza`*`$u~vA6ua z)c+s}Y|FyJHNW!0*MX4G|+HK8`U@)r(F?}rE%h$3HOONkM*G)vXJ01GA?^&oT3c)vZD`ot zrgofPI_piZ*)x_6q;SZ-*<0C?efzqUbUs9r#S&^joSfafq~66xpzj6+MzUPfehZyQ zH)@T5On`x+QJC08@#Qb}mLaWt>MqO$W|PL_%wnFbQOE+GB}J9)Bs=kSaG{YkT)C!A1 znEIUREwj#qqXx!Y$HJU_0SPVOD;6E!2+EZR5&OblU_g+1Qdh!P+UL8!m{|cn#+lx< z$-IR_G;@=)hM8lAix`{?Cc@{Z{KN|_D}bdM!V(ixDxC_N+P!avhWw1?$S9+J z=zU}JZtGIWBct7n7d!I0DrkDtW?dd~*+e^-x+`=-M5*w_BeNrfc{$!u*(t{MYqCmPJoD=1?(hA0~qui$6-|}Va}BR zbtzOFlcFVnI0<7Hc~Ek!gTk3b2LhRc7f0XQ-iTorOgWa(a~p8yCj$ZR?Jl+5A&VYN zSN84y(r__>G9Mz6yl{%V%cO}Nhkx0}mB#@8?wSGkaAI_Ku5OJ9;3F)VB+DN8BT}St zK{ye>!*P>zDxt4(K+R2ApW(CjvyDH^Gni_I5{+T>`!;F_AkG2-1Dle^WLZ zf9{u4OxVZX|7p9xesc0(!w~;D8ZrXI*Q^8&g34Tg`Z|XMP(M*qd3!KaT2dl%Y%N?f z{uSgvsPrGa|37RP%$fjbAJdK=XsntaSOXbF@c8*gs^0Vg74!b)Fv4hJh4F3&PJAF+@&ae;|-weq%R!rSag^ z;a-aTHqsDXzF;T(*mn$vtmYUKW!INR4Gjry5a(~a)PLY^_3hck`}RHx*byoj-%u>F zu+Q8T8~D2Zq30=U_6Y>zTApSp8>7no+~*AbFVXcey%i4zBAV}<0jX$Qck=?+p$N_T zeb=`L%QT{H`e^Oqh`o~t+7D%pNK>;WIpk_xhV}{2csTn(^`%Kol zPem7O{dMAUj7;gG>IzPaMEfUh_IrZiBivrVq0caZkuYIZbK~G!8=k*^Y7&SX!~krd zyVdMk{I>17QKvycith@6>0@yR)qKdTQR;UsCAL~t<*;X9L+L|KWA`Zs)$Bw1RnoN$ zFrvib+2G=b0RwmH`g4L>GKks@)o_bqWJ~?B+gCbwY&fLgj+4-&`zCoynY1?ao>_JM zr>0nt9e@j-47Y5B-D24jwb+90O3=*bYKCnE(>%3?rwQvSTvlHY$=uBy@6 z5^6~BAlm$Z8Ze~^)ldtI*ILk?u{=25?IyN(vxdM0dvLYKsld>f?g!rd-&|@%^!{^R z{X~)&`~YanBrnikP*0rVfX!b}CT-0TL zfYfffDL1<+p9MFrLd@(lbr>5`tattP%vL+sOUf`KtCoHGw0W*ezMZ9uKfqicLtQJS z3?-bRib)+&lWI}RTEu08Es*rSLc5txZd0YO^BlzYSHZ)d=O<)Q!UW#YSV%V{i2c)r zn$4K0&&Y5jVA90>=JDlvum9~x-+xd&KtcES>Vkv~I0Vajrs>lPWFUG6p}yT%-#bVl XyhsqgePjQRBS3d<>%vQJS%>|94v{bk literal 24688 zcmce;cUV*3x-J?-MMXfRBZ5)|q)C%5A|+Jm(wl&x_ZBIFfOP2)st{Tz0g+B9BE2W{ zD!qgB8giz;wf9)hv_^9N5JX66`U&hdTY{ob!7^o@!f(H)vQAP|TMEdN>^ z1iHou0^y6_x&~ZnSzM|GKJZ-Btp-$@OPJE8HBZc_PtQzj0VT<1?H(cy*J#u)xm8lkg{1fN9US%5cc8l$$Kodw+mCiXbYwvN&VC}r4u7}0-vfaN6=AHI-W#nUK1vq7qH`!)Yu^_Sud_)A6Rhx;l$d)h9veIAXRF-Q7n zwQrp?o)mRJiN#J)1U|pBq>247Q*&MesFTSd5RbKBe@HsUiCz8F7i+S+zOlcnv`W1~KY0$r7-dG2UsAywp!IL&T=tt!lU89&??O-c(P;0W6o#H&;z?BC#i?>K4MNXaPD1g zEnDT7DMra)4J4~_HA2LtJ+Ed7l$yV)1Juo zaa@`{x9(lYY`|>pba}y;r8lW=9YKXA=B0_KZoiEPUFyc+q-v{yDzbiacEF^`()-{J1T~uI z9c5RS5OCq`A7tbAYef`xa9f($mbzvZ>~d5&wp(?P0d2CvRcL2a_+rnMQw3+7Iv#Cw zO;*~dp0z`EFMfU9)pP%~REkWOfCQy~c|b>XAlgf@$^>~aiXeLJ{(wJaj6zZ}b>n&i zw%5x3;C2b&XDst#bznNfJk>ZP>t+=V0l$skilun^LCg?C<|>8}!d3TfBz3l` zW9nquYQSf%{^Z+<&sv$E$o3(hR{JF&50SHBB>m}E=@UKotaAaEpZO98XhrS`VYc~? z^WQ%aM7g}Faeetr8$)maj?Dj5A6+KPou>2PjO zD|yJdTl1PB9sH)Kbt46kaE3ea+-k&*?h6i_!h?Rw%|E_Ny1UR1o@wG$+~UpQXYQ-+ zmskbPGuCc*`XYVTD9&Rqo<`n+{0g8qzV%qC8;- z*%D6O`1vc9o~!Z)o(Bzds1?LBYK&$yN4 zB;%`g>N)S6&=m1wuK}aoiKeiW6I##Tz#-l8`yF!Py&HcnP;mk!_B^L-D#O4g@Cz3n z-M%Wk|9wr-NlzepEZmFm(9->BqWqq_I`6}>$!8e|4eLqO5B5IM(1r+;x(qfNrLPMD zp5nn?xyy=V=87tQpNb*v=Yh+hJ+XpKdoE9{=2y>x;Du(E$xV=9hj;)Ys=E_Te10)P zQLCV%K-snk?}B7Cl1F?!c}7Rk4&!zw9@wQJx$U%!G-)a0ntVmi7hasRylAmmvCM%& zbHQQffNIiKsMP#s_~#L}qe)eaK}iSE;7tE<*pc;!(#-ut-etRwowp_oIgT~i^Ivzg zZ-z*tCu)j=ku7e?x2;Yva6Nz;G9^!LA zn+_0T4fFJKhohV)4wX4mzloWA*i<7k@;^6{9YCYFwRzG^znYm`Fm_LcE;LawPa8ij z)_7l$Ic(6f^_W-oL^u^=Biq3u;#$FZkNSRt=Pq*>TgzKz!O=ivn}UquVAwM2jmh+y%D8B79vj=)M;NAFJ%j=0?HzFxf^BV#Xx54O z0vbvABUf=3m4F-IP0EDrTH}I4KPrTXy|$7kwTx zKAY!LTZ3oL#1XO3u!N8(_azz^EqeAC7bfx93`_0(Q>T!TF!nr?clPgCVfspG!P}es zyK-S$EvdA+Z_qh1x;_&;tqq?PYStaCD<3*>6IvIinR##3>o^-Bjhhg*p2#N+8qFUH zbE?Ee^AA`=j+&M)4>EC=mj?rqixGShM}?}`&8Dl(L{9zD68&oDVts_k=@hmr8^@+uOXcJB+0q!-yv)Ic`4V6jsfo*S#~Z%)4OgLtlG z0J1o+LQbyMNzXaX>t@b*uCxdl?A4B>MxnNzJE-E)A{N@Et#7_NbgrRc- zVQe!}Xi)R57khOFS1ZA|%NT%E?KfWd?Qd;UI@Ci?9`5*@Om1T;Bt^ZB`nl7gt2(7k z3x|EI#?@CHID6;C+g1+Mn7WT}Jpa=ArK(ClH!SX;PV{Q+BHDoG1Ra%RbTwfo2|Wy- zqQ`DvxQ(!#6_Va-NkVgHKS_2c8~5g+jV@j3nc~YGxV@u?e&-eW+e^d%!OX%`Ngl2h z_4_Sm_FY|6Ph)YV*uJ5uRXXDn^se7w(OlY9&uZh*;jX>k{#oeQw7{N61u5<*DipUX zN9yNw@iWsQ`LyC_wsn-|0l-Z~wgYTNar3#jc@pI1iC@Khw8Yt3O6F;wVp4x!NqXwV z{_aZS-Z0^2rl(3TVsbWv&#pk)cTMedr{5mSRQcd$3z?`vAcj` ztj&*veAtkDblD;~u~^r1j)pa1uSTo;uRb6ze9KqGo5r`RGJVWi2e=w8R;z8XZ8A1= z;s*hC9$Pi$n-1EzU-KN?xFI)Hv9rU6l4WOpQ%COl76pJ_t$lCuo$11@XPsbI1Ea6v zq`7gaNUY<&s7KSrxAc0Wy}>!-?^w>c8SkG#B(yk`9nN{da2NZV)41+(*kRW1G#@E) zxIkYzd0_5=3(;{HceKKGyqA8B2EEKj*;nu4=>JCS$Me%m$xxByOG1;p`GZK<~HRq0{TTwFI4W|9RdTohiN< zK!7yFjtdA~Ero5;*X$=w6zMo%GjZP7$tn7Z1B@;F=lFg6SAU+^$6;kwa(4L#Zc}yO zq7_Br+2%apm~`0sIgCHt~C{jxpvZzcEw$?%l)j5Nn1YEnR( zG%dMMxJanMIjlA6YVd>@WwLm}%Hoig+^{p(c(!n`bAAQoK3~Pp9}wOzN>xQUZm!Sy z{o1n0IPF?g?c;!uJ$&wECQEIAe$kQ@XJ%$*-EMRZM6t6fiEAsgn)UfTFXXe0R-EIy`n$N%Hc_L!>VvDEzB4n~ zu6X{ivvlcEP_zFB?BQmU-*Oes?PL=-^RQH}avSY;(B8uuU9%sczl&YSm8@TzU5ygo z{kSmKeaVfi+lK0hzgu;cZiMgQZYf>fPPH4x+LLMVU6w8gsegS&O>y0yx612ag*@Ld z=iAbwOrxWcDQy(=d^8mI&9pCF)fc-l5vT2o%MRC>@m!1)nsLPdE(vxiPIXdv<_jO> zCz6KM6+soc3>I(P;Zym9y4xZsU)+%g`f^^*7rLZqc0EhC9!SXzNR7WN;`A> zd0HVsNGdMYu&n!g4+vqw0U(~zMz_7FP)U6p!XlMeWMg*WYerFGq=yjJ0nb$mSo;+N zj3UT7&sRMf62l(~49E*JxJ^$l>>mDTNb4+CHvgj?W~S@io5f)sq4%%jU#|)RJGfUd z-`}BCKzlYqKedV0Cz-emYeJzkaP)%GUa{>=A2Vr>DzVk)iBYh^LNIIL1{~aL$9@ZB zE{AnIqrWo4`jDLBs&MF$=z{C#fatf}Sc$kGv{xjwZSMk?-BTy*i1Wp%WPS_;(||zg|GsJa=b(YhZIB6Dc|K0;D3zZC50rTG zPcY$Mnb7~VjKFZ^{1O8}-twOP%47CdByX$GMxd9hZVZr7t~m<^_iTjuu){E`P08Lp zuA>(beG5`w%@oNecHKtO?Nog(EM&g15IY z`%|s7&h4C>WtfF&+f1!>R3n-4kyiq#3>k)WE~M7WKGT{VnJ#J)95%TjQY#8#g!6$b zdiIw$zB`jpcoD-io{IH6=!=!O5yu$D{NqVmBBHMo&q$}l>8pBq7V2|?^J zv^FA?o>?Q!)*(DRUi^L?hj&GB@P(~N>dLjZAL@7NHYcny?YKX2>Q`-5jv2A0IR>EI z-JU{5Z+67Kz@S+Zp)X|kiJt1*A~ra=?piv{^>tMx-nr#fLwu>ZetN98YhfBQ0U36v zM0aQ7#t6lnD}wRqgCafoSwxuVkB3OER4e?qwl-s>M6G$BQ&c}JkRFQ+7Q%T$5?@$v zFc!~uTCcIM!9qcflwShV5cWY!0Yroe!v?|vMhexFud?A9KFiLcMfM{D*;5aOlTAJw zan{)gycpRbW2-U|G%WC5+%KTD4=&mlgpq-iQx&fMuRmVvy6LOWp%iW-kuS9axY zE!ucqYhwKs2HWV3NP1B64em=v+g_)JiwvgV%_$ffTK*v`Lu8-MuOeNEJMD3S%{)2p zMnxzQ4Bn6#->RCj7dMw(H$e|uCB47|EEZ=&X`&~7f?N=12fxL4hLs~QI2lUA>EADwJ$J-$(>!4Dny@Hzfz<;O}(^tN;i1k_(hs1 zhS4lH4O6>1yA7IoFc&W!NlZ{!JCrhO#36ORNy>I$s|U$&p1ulmDd9@{0g}~}i_3fQ zihQV8uC^nQ8guXrofE*wR|U6qz34+PTeu=93_EjIx(j{TDx!+jk__rU=nA~4o`g8R z+$~efX}yo&t=kNCM}F3=qun%!=k7|$O6|URHcjl#g-QTL!24O0oj#xUtvp4@sJ_Z9 zWGsZ$aXNoa+0QGe{$kLzix4pm0rt;1P}CxxtMd@^#M zgQ1#Iw`u%s2_4!oQ`xFD9FOO@NDRLsxI;zN2i+0K@<=K?7>?KebDSv>N1s~xgg*Xu zt7MCfGV}=qboW*hB=}{%8NrXd4nfyy!T44q+$hcD0_bMMKhyTVFef+>h<4_-W?UT% z>i~p)kn~^h`~L}?{xcx@zre76@3u$Eu$02k(5`h|=<@ruZiN!j2nzy;ySMX_F~0wO z{$%)&T=MXVlPr4aB^pE(*21jp^NGBcPr#g8AM)b5sIx?r6Z+Z8qyDMYHIZ6Kn!f9<8%l1=GmPp# zzAkJWRSxCrc1sU%=FL|!%pJF$v9Rnd3XqQY;*x3%!HTftTMbh+RcQ<#vrwS>to=*g zPd(fSe;!lk3}?Pjc5uSCLzz^XS8MPE1I?X{ zaO;|<)G6x5H|ry{zNicFeG9{A871G?)VjV)T2SNIwS2$(9672x1&nhTM^|g%#pwR zGOdqOm;KfQD7=E1>z5w)th;J|zB}q#!4Q%s*G@S3Aj%A`)8#j!)#iFb_0Uq=qS#u? z;cOg0{_UY4h6~jZ)u!xWIxLco*=?Vzl3#-l>Pget0E2ynpifE6# zA+8d*d{>EkY0Rd8JHIvn%)9gW;@XI$x0dTl?#ZvlpC*d#;+c}q8p};ato6Jlo5y=n z`1gw}GDLM|Jx``~4RY%b59)f(*o(NVZd89>#??EBwsPxVMfz*Dta-}Z9lF%vWY1$C zMhj`g^KNMM)gT6n=ZQH-G+-2Ho&LkT^A$vKp{zDizLc4HmQdMHMMb&GuPBCQi(*Wt zT)ZZyx91B|k(-r^W0qeg+EvIhEL5w{!YgL-&*riyA605-B2Tm1+mpo0Qc*B&Uo z2#FKEzI12ydqCP2F-eag<*-h!b#irHDVt&qc@8<;TM?lj@808C6gH-IiJE=CZk@cY z%t@9yt0}n`mR4zR&u{+odumgaJ4F4v(J6C|wgFuN7pyvY`P2h_ApfY|SJn>&s zMgI?EylFlX)=DC|Qap0pJv5k*pyxr=Q>UHj);m8Lrd5U4{9rf~&K8w(YPxisK#;VY z20wr8@oZ&X7X5P#aJK6Qf9J_j3@TT4K5`_ud#v%mr{&ualyl@}pt~re-aRVeM+&gD z+JZ(%2dzuQflNto3gn1MTvKy!ZYaW7-HNp|xU_9)Ci)50VB~vG%uL|;p)d!G}rpUJ1?Yw&V8FFd`jQ#)~%_QtP}QgY2}n@>w3v zjHxSD$`M|Z{%${0$736oTzk3Sv+b584c55I$u2!g;y#l(Y7E*?|Dbc!dFnBI_?c8L ziH%!3vof1~9=S>PtY76vODGq%p>$zu$W`lL`lEoZ?INNAVOR8OB=%T_pKO?N#8K_} z^W4U}?hlK8IXZk|(;;#}q=b7CwXrRhY8lts2)|33cx`QB(W39>Vb#?>EU2+P6wvJG zWs2dmjOSvGJTn?G=5RA@gkDiEsN70yD*(U)N*y0;)dcP_1k28@p-o8n!%Hh2~b)u{EG# zr;3maS`QVN>cS}Jx51m{MKOi;=GNW_alLzM0SvZWHNOHffQ6qy4mA#fIBVGRED&B%tVUS~}zya$0BK zcM3CPvqoLJ||kXVO@#s#gfrk%bU<#YsZpmPfhBhQMZV{Inw1Bwr(st|Ql^ ziU9qe`?&Ui^!X%Coa{@4iE9Hx@cXMG3UUo{+MN%6VV>JDQyeuY%j{`clqrVU_+@$C zbU;N|1p%Z*|0thg%YmC$}wm-0SxMVAtp$RPQQtbaw6hF0*x!^3g&Bd)aKjzJ1c?)oYm_P;ERm z$&&6z|0G5cam<=jYuM{5B5RvVXm%*3Tdr)_Jd)WTHoi0=1Kd*zo$!ilAf6Y0&zb)P zgf_QXh(IQ4|6q{PiZq~Rw5cl2Yl8!b9j}G{3r_lP;_?6PZO8^NAD;j(udukjcqWWj z6%VA?X%cG*@Xa4u@9qG+m&yPg9~%4Z6pXRd0r^k=HNRJ!Y+iU0zjs)IJU(wW)dNc{ zRH@`!qcM)xl$?K~c+O6X_d)Ibj<&fm7m(};^WZOGM*YW)#kk&3}J&5pG)qve}I@1ND`t80F%_IH=pe@`L&LqYyoe~OUsGrWJqP#yv@!~Zut6qeKxt4A(1Rb~lx$w^uq6e6S` zkvvkcMn;!_Q#-8RykF0byYD`&spX5H2A9c{G0)&sc2jX_Texl$I0lBC(s#H9s>|X7 z$BBq*Wj@#>9#|N$O4l+Rb22T~n-9@qzj^rc8~1o}N=h0#KMJnBRCEwlSlXz7-@LHl zjV8-Sh`DnN$$l-AoY8sqp4;pp#x8P`MmVnB;A9#Pba(c@v5{hsZWl@SDnaH@wC5=6 zs)$rv!B^I?67L9$hce-2iB2#?kXzAoPy?688U;s^7Rs3c^eoD4b2P|Q<7Y3B6t+j= zu8r%y;Ma>c@Pdhyb?lvT7aOR@_ONh{sHTKgAo^c(n$hHcbR)ZM9XgoV`d7Hmy(k3p|(Z> zXAklHqc*J3uVI(6CmJnR^HMAb$jQ@+oa+jg z4YYzJsMfr z(l0JEOK5xwoz~GI=1{Dgy6&&C`5NsSDuQ8jLUTTk0c9P?!(OiXasLjy+5G+qgkf5; zb|aB%mk5;oFR;tzJ)qccMYh%@RehL=Kp^q|?o9lb?A!kzw^dU84H^O0T10x++Sz;5 z2oK~;ZHr#R0C9aF>Cmh$SoSBdUtH0aoSwl>yzd(;o5V~4GKnX83Ze0P41i5pJP{Mb z`{zdhanRTq#?m7ha8lfu+n3N$Z{?YS(nAG>dp5onC9?_XT16YOW7j~vJ&$AC=?;$B zhq)j>pStndZF*H6Wo@8~iaODio)-C)Oi79*H$cfr{Y=W)pD|m}PFDG`kJW@@A34AC z<^(l2xULFCQd3;=CTL7WIg+LK>3`NHj%_cAF(L%e}+iKXZR%iWFYMtbTj(9sBxo=Bimd-xE}Xv5-uJOX9Ih9^}t5 zcUd4?En9S>LpX^@7yr$ueFRNOr_0>!PiC@ix&sge*lP>5x1~CNdsZptNYnlmJ+WtD zO3(8w4`qg!VKe4UTVF;LMru~zq1vVH%iDS!9uE!wJR`m`5L~|Y&xrSLO85U0Fd}o) z_=^TaR(}5hK%{Jv@1s91h^diw$=fw0(EEHoa1MzWhwly$hA(T%wSK+IS9b+4=2nFnd~+49 zPh1|jveo+J+wQ^4>yHmnPf+S+4-qymk>t&>qoMGakn{zkM4hYhRb^`tXYAL}SH$a$ zB*$R~-ewkV`nFT0jY3QgQN~Kf0A~6#FEt$W*YCAI+zu)O9E+5c6dNRJ)Tq8Llb?C@ zT~vD69z-v@BXJN{ww2}BKwW1hBk+cek`mMA`?{!FxyMJ?o#Pk*KT)d=ChU^gib~Jh z5LnYb3s`bHGn+A6{)W&|xnA}Y$f9%IO=Ym;YPxiWK3aQ?PSz+Dn_6<|5{HEc4hdhM zanXG`pq?qNUnJ~?=O^p4z1^={LATs%?56!r0}(ZCb14%(mi)Fev-Z50e8h!Ufdp}! z^B*W{(sl47&#L$7j697DJw*HRod#<*^wtLBH#(bA28|gt;tKc{f<*76lUz~s(N4jF z-q^tuqh{A>H! zKeI0u)B3czVS|GLh}x?13A)bq^+uy?r3Hc>;)6&9bqw7SQ1AH#!HgsWo*(_`$Z4C8 z`0KOIL#P(--oEpiscJzxG75d)WQv9&mhULSJN_>WUq0v*)QoH51tn(^GbuYUjdrAX z=&G}3Pt}|kS0FUB(z=h?eYr$?U+wU2Dq%P_njBW*oozOY&c9ur>|He_MbnPV;+2ja zBh&kSQa)GROxY(V`v=UY6G~Us5P^7%4drP{USNyYhVo=G=~cSaoL5%P2f5 zPA26~#MB47d|LvbERuf)g8%#WU@TVtuYhbJHMIP#-ZK$VabbWg+aM>YyKV6NeE}Ri zj1j&s%s*28VlIxK0LWzpzyAUzwIl+Yb1wiEP4UOCSW9Pby+;8%EnxI`_>0(^&9OY4 z@DzcLEHM!joXzk2Y1M?N5bA8ckj8;6|MR(&F0?SD^V)tLl{O{sc6MGGr57iiRgu~E zF$BwiP3Ui8(8~@YLCAFAoPidlimIED2tj`1XQBs}Rp*mRrFFe*hDM>_I>Y{?vAkE6 zADpxdZ{B!VUD&w-@LA{Ywn73Z1?RKz2j8B7B0fp6DmxlX<~x7VPXE30#QN%%iqh=? z&FVLm{`T&2;UCS2nhF|5TYu6WUIB}o&^53m^GZ-*?B}fE^4}0yZfeF z$@LpIv}~NM5gA|4j@r~XRadhZC6xAzSy+wY3_Nzmgl*Moo1G`?k5$FsmF|LFpmt@ z<-C=`!Yb08-I(h>JtG7$n(_dA=j9*2>%Z0${R>6|6kz`exW$iS{4&m!fm-cmG*2(Q zoD$@}_m4WHe>E;7&JvpvLhmsl2z^p;tUkzn9%0>F)e}{rEc=}Y^f*L?MLB_Tk4e}C zg>oj-T{tYv+t)j(E0-PzH7~3I&NTlJ-q)-3T&W4tul2BRKw6<)0p#DZvE%@I^@ZQ` zFus8{)KTt`js!#%e_sK%;PLq^4*6a_S2%kusn#MBplirWYR zs*t#-a^X$~KM5&a)>Xbh7Ffcml?Fl0*;IvawXm1G4B)RgGUfemGQa(BAdvIABj8)L zU;FoV_iwIx=O6xg=l@_r$nv^D>_<)_&{+&W7yg#!Kyo?yKoLzI~>L{;*y3=)w@S_-TqBWi}PJ;WRNiOCqqfU!qFq zHQU$NCf&?I*tSje?|dszut|Abd)hLyQ{EKYadd@ih_8r%Mzm01o2!F! z?t2edKpz}eQ}k9#vO@HZc7$drD|O5^m36Ylo1K^ax81dwBc0C-MU7p$sut}px_X*? zc7j%YF~4-!Ei*3qdbq_r4of7xFbIOuhMub|H2|c;As@j9FC(^#h#^od46C!xA*{8s z;TvlSlq+1Lx(308s?``V+aFZ5W1M+XzZHdWs{3YOMD`^d7OBnMO6F9D@N&+2_Pe*& z)v)$)oUE`1CaT(?4qKq_`~0MS)#$^OZo<Q6>hyxWzgf* zL?As5;@mSmPxQDI@9~$?6pdkFHzFsKko5DzBNZ3kmr8D-(xSpF6HiX=Z^`%W-x;>K z8MpL?RrOu84%aW{$bHmAIudtQT7%^k=nbb10wN0( zSx_)(M%t`YQLWr}QD!eLO3mt;VU&O@TBp9RxQg6pGr?+tZP}G* zmeV3dja<5pk#-+!ciL7nT`E>;SABD6nw&2dk@`o?9zqj-LW}^$P?)f>MhfQ^aq)6C z5-F1?oE*-^jOloM9#K@u*WjTlen^IV$pDFWupQs4>Y*3&InH1JEMxWr)E7e>p{N!@a9XkDwc`ratH zbP=ciEXOm?+(=FI(|lm&Nv){?)T$M`q3^|(!?3it@MdXd<8iE=@!Y*=Y5*q?j?ahRZyAJpKNNmq(!g4~Px|?u?X41ifBFL37 z#L?lkIr=Ht})|%LpNZ`aX1)e<4FR z7bf|VcFIk8WI>4oI^9iPOD$8JM@HB`ES+Yb@BFSP_h(|HHLN1K(E7cy$T<=3nJu?_Y6NWdQZu(4N5EhRcsL$Z_9GPH{8Y zKj#z#=5u6B=%R#O5^^0TmG=dcn~bnugD~ zgI_=7?QbYsr{=o@UK|AKaH?!!8SE-NZfkdc{WKb!7w{*oQw^MG0U?+a__bIddaRNC zchB(K5!pWnm>DNOJLv=|r~Z+lR3=AP+!y#dlz>TDmQa;OirBUOXEaS4CzajLagHCB z)ids!e-_bLcOs?$=Md=j-)5Sep*b&RPoeYjB(KO0A3XrF^wa4y%ff$*LJw7ty$rd#GCECvWx@zaZV@B&g0F)|{xvUw2~=lI!PWnQXI2==2RX zxz_|?XAwoX`z&9g%ZC=O&O-&wE{pYnz7RgsiVtVb(7i!vkB7%UWYFT+1%om{x_>^@S> zO{6G+awJoo-I=mqPv)aHV?thcmv!5-e0Qy^v%Xm7%#;+a)DY`0;6>T+GbhsP@~)N) zHK5o$xGJoZTH8s5Qg}ME0NMA_A=pCyNRj~+ELq;BXCK1;#^|%2uP&$VAalt2>JHV= zL-#vU`Oi2;M3v|6$Z0Isz2;H48$OeU(85U{vIz1T1S-*_aIVy%_Hh~hDb#k?4VaV* z$M(LeJj|~bf%Wn(4KWtsam|PcPdL(rkj@+o>Kt}%7paYCZ<l>wng!Z1C>!kg=?N6Fr@uJ+PW;EbghHa88=B|=jx z0X50Oi!@8ClGoVa?jfs$Z*1t?^_9caTxddP!xMQHqCq?+Wo3Gub#v)Q9Q{rj>B@zW zPy|;&R%rVXh1Q;*gm9C z-7s$ytvR5Ul)=*QC5j<-MastY`ed~Om7MP-~fm!1yRN6^@tO5 zdZfl+pRNZmI}n75DDb>t7dbN4tjd05R?7jva)wd)eNDfoa%e? z{{mj^PaqV%i6Gg`a~6C7t|r}iCULcptHfqd!6}6EQMd> zo^|BJJk=ZY_dZ4tl_X;(KfC4duZf9?)eNYLVS8-eslb!PAK$;LrplH)f6e_O>uANH zARNE>GixLzpF%P}i`I{)^85qz0K@H*eF6EAtQG(VlgP{xDoXmii9EO|${lx$li4q@Al*PIOm`7fuRW+)CNt6jp& zS*uab$`kzAoM+s*=y zWo}|ncnJo4@Pm-MfHjO#urOIovz}A!y@*8-<}Jwst9lpCC|fV@G25amIrv!Y)ZoBO zOt#S0a8Mh^@6ni`M`jgWyr8nDvcH5PqiF665&>m9CAjzCW8JVk6~+0Dl+yh8su z*fA}WgswJHKD~}@8YwhQpH`a+MiPmy=u$! z^ zm*cT(ibrC0OW5^<&5sNJH@B_ z(2jcDWCJ04PQBV@P5iE!gFF!io~d_fw`zMO7nQ=F;S^UCZf7k-R06n;ZpGXYScrmjJ6or!U=J*a4Bu{*^*eR`FAr{>-2l{B+ zfzG4tHTQNV$d+LWaL5-w!F6FbQ~C4LoV!b^XRV_E`VVMc4AtQyH~stTUasBxUjNWEpbfxh;M_SFY1vC z01|B(&>dl9Q7ZUF(>i=soMV^!-rNQc-G8qo8@U@Wy6^w zNgs(kduMP+`#6R_U7#5*yjff!Xghv>x_ImW!=6*R(4Te6kq9q+VT^jQpffNGb~#_y zX~1qfG~uo;w!c#(YNLU6%fPwI6(LF6E2if#{__YIl2T=iMxcoE{<|N)imHmn`K|rI z7>y`6wG1j&mRHieyLn9*a8xK-O6zyL0mYail)`$C|D9aYn4k?l>;aCDUmIieT5|1f zW38Nfznv~_*n)EU{4_Ct#aHrVtKvMmUlUF1cPXTaE;yJ_u`#{P{0DQHAkT4fy0Ll8 zv6gsxOv*7-Rh6qCFpKiu^ru+U$xX!+`Roxzc0+hs&wj#=%1?NwO8Yp_dE8pYX0}3_ zdHM-Oe3u7O>}19R*GwQ`viiM3 zGnOTSnpqx3x0<>=N|0(cAUN|rv@pApcAa0#d=Zl?&lXMhl_mURe_8Oga<2S7dv>E& z)p?^wDt^2yd(Xq!g1XjIvRy}Zigm+?o}LE^xK@luL1&8cyh~x5YW7FNRg}g>aNc}R zr==6x$7f)T5dX-CeRN8b``I_^k6Ew81-?X>(czig}Xt3qqF@T(=WQ)&R{9% zFe+)U*;`;NoDl7Mn6vR%d^uiY>yvvsJH+=r*+B05-lx9kwF>xpTA5Yki}FJ@jlO#! zahLc)UY1@Q@I1vr^?;cqjlzb(flXn{cU~id%iDbAAx4|sL1|JW*#a|L&*(Xql`>L@ zZ?0LH%?TK)m9m#YN1kQWPdU|h6M9UABel?@h9VuTiib$%^^_VD|LbH>dL@$1Y# z`90!`bCKz80=S?q@Va{9qb%HgZLZVs(Xl>(z}2wi`6GB3XRJ1uQ4dP|`vXm^w__ijoJvspy88F{dpq@Fc-Xi%kRkFS zswru2LtM&$UrLMRJIDkiJg7)T<-BEm@aP?~L1mN-Kdm33O8oqX=(l7&=ExVzz2Y$7q?+JBVrPxr~!WfadF%h`mjsx1Hg#h4-`I*Y0@@R_Lb zjA)tS+8^bIkSDeLI6@pf{yyS|Ht@q9B^mpk35*#WU^1@`Dcj>zB?^5P3h222WZtQ6 z!fpc>ypA?T01s~p=twTQLUt$r=~V?fr#B+_8tb=y`^^0g7W%NMKliQjK|3cTp4~Pc zkkK$mKO3%kXZQMpOBW`ANpb(Br}?iA%z|9mp1dzjyv_Q3-8n;W>&eq6c_VQFYWMrS zVHrk(HJeF4Dtlk4B*2hs65G5(mvZwaQUKs(I zq$2JVglj*KGWj>gVnqbUkj8$kL_!8`BU&3)e=OZO&?8mQpcYbgp6k|5ZS~=( z$QZTX&B0ywenlfwWMwT!^~Kex1FhR|7+?R36PQh@4{(PM8q7MOciTLfU*W!BA8*bl zum&yNEJO`^@%xtvFRP-DSpvQ?(UjhBT!^-~1h1j>Q>_D$r8JXJcf)=Oi|C4Ym-}p7 znL3o#Z%?0x*N&hBND)1C@i-yUty{t`6JrAUDoY_5q5>M54^1GbD1 zOjG*_;6kBo;Y~c8?8#;2u;c4FIJnxn^Gb>pVvYk)uA1dUefx$zS#m*2L)Vz|CU(m| zWTOb#sAtjDA#u!2k2{SqzFa8G#BPPMW}F_Si+UhxB>}KbvPVBn6|}RCqGnFymvwrl z*$h6q)fXsd2E&EZ`Eyc63(6nPS9(~PXl;|*bDqx`&hBXFGd#zN?ft5?H zt=Kt0rvM<85-4BAJtqR=-|cn`wEPq+E2D_bcUT!1x&;f`l!V-2cNiY{AJtuVI9%Pj zPZ5&flMr2`5JVS)hzy?unTZy4bU~C+LkI>#ir#`K8A9|3^%Z~uqF``6kj$6c zmYaLm+R6&B|GZ=rK>K`o7O1YKhF*{;mfl-R2lU?^iGpty?S@QTI5%FGw|f*GkzNvXTjh52pJyh%Z zA!IE~yzhaWoyq>#Fdo1rfO#J>z2 zykA^6eHDIG)W-tExii5b&rM4Qfb_7o=Hx^!niWtEF;uv63 zoU-|GvgL-)`67BQ@6JdZwManS!SvikI7CxgIK7Pd35Tph*FH~g?^#DWmbYjR7(}?D z@=7+Aiynu;bNdo!aiu%kSb+!3Zt=CHK0aN}@r5u81*dWpMl^GlBP#9HFwVXJk4ejy zvCRBNPwl(L=-Y}=GZrfGh{RI&8Hwu`Efoq=h8mPA*q?dVU6TxwlL}eX1X*2>gA;el zmc8H&4fu~5{pYOxj<5{K;|G=z!{s^@rBoCar+fx4a^82KI7omR2?k#@sD1S-V&WMofXF<9?H#d$S#{W9c{W zX*t6akftF9Aev1ZIM7bU@l}};UOlnmJM{1os!^T|CG^;c*PDf{X<}E7_pK9+7WrH# z5#TfdeIan`d}RL6MTBjguFJNoK9pv&Ewl-F&9_&xCLuMuI(%6|Q`zI9i!NybfJ<)b zrF^1ne}C>?5y0)Ph}0M3hF{q2Bt7N_sZ|;XUdb*mC`Kgt6Cq{IIB2eLLf&W5)_Gb% zNmKq?O}XgL1 z9%Z4VQUBp(W4nux~3Pyxq`K_{T;+GgpX zmasI+5&CPSQ|i7Fq;y_jYd!IEYt0g~WhI*$Ru(u}eJ)O)dM|D|2v)qCXV82BRuSZp z72NcZO=n{Whb+-_IWx&%KkTYw7wf9NMIDUix4#e@lkYXr+o1v0-K}!-ixOpnre81{ z?5wOHrSp9&Igk$9!|21(_>=SJ9}I;iF&KE)2#94(g_h+%-PWnyx`orXs#UAl zyP;7C51A7(r+x!?rt1SZ;th;n$3_FZr1n^gHW~=ai>s{NWS@jZ=}l(xVo#D7=buzR za8}28X@v#VQ@(3f;(=elP64C^;WS&cMX{!U4b!Q!L?;_O5yImssSTe0wB)LOQ>k(& zUA4hDRmTUrRFFw^N=CcSh)_RgQ?YQJu^IxF4=<1j$=$O?={R%+72#KnA%dyxGPO?@ z`uF|$%+4G;i(1@LD4tT$GZ2%@%9K6b1o zHT_6QvHyjV`iGA0zv;4n-puawk*&klp0a1~L<~^5BM#7Yf680_pM2_Hj8^+wGa%~Q zk>Z%(@tsemImnm=v15&TT)&v`zuAxBbzrEXJFBS;5B}}pl|QBg7`g6=V{MZY6G>nq zbKZ1DNk3p+4f&H*^gm_cui1bAiZ-mPs5zDTDBXMrR6^L%36VG37w-qWEubeEBWFz# z%~2NDo~d1d`_Y^&8shxJ^~JRKa-}rQ!-z@ zc*AL9zBNKHHarfvoy#!#K|lP_2k4<%Qrjvh{tIbbF;QlvJd8GbA(ucbwA{3xlv(IZ zly5d(OXH5?@5~VMS4>)ZwsQkab>uT!YNe)sG9@F&3xMfCAxzq9weW}Ug)@u0eNS)! zg;Wp&?KKxTHV*wnFCM&exle?!Wp{_YMa@#tDgkjI#90M@D5Hp7ouKonxAH?o2&%(e zp6e4Fpcxv^X!aR&P4zs@6)~WeQ%O?^@pw%*@WC^EUUGIAC`06_K?8NjwQ#APt8h^S zgza6tD5Q=C!lTO1IPratKM7x`0mV|(0CI>3J{7!G#uE#oO}(7`5^BMtq#O-mQ9K$L z2=a&}VPqpm@G+)?_g1K8ghvNpmQ$hwR?EK-qB8s{Mo9>W1MxZ%Z8U%!{EjfhziVAx zh5N~)#@DHCGi{j>WR7@4*(pQiIfoqCk8lLMm-3r^@|@L|cF^hLfDiN4&Ew2eyPoBM zW$?1|3E|)HTR?cSpZqL^5y!;h0LBSp^!#JVZaK3IVr13v%USitVD;&CiwAUG>f_hK zNg3wnR>8(O$GLm&vb@|OSTf^1$tiWtjLCje`km=1f%VyiF>Oebft14r0=Fux+*hRb zasNJfERv2Rs^uG!Z$RQJCpo5HS)7`=oTZeL)@&%>QKm~4k)tmaFDgDnNt zT631k`?B=V^t;y}jL|%18nOc<-_151j}uJy<{l#lm*`%Imhw(QNLj(tuF+Xr(DWOM z8y1%9Q1OXXTe8Vc)gpKAgP;7Y4C;BtD|bd9{!RWV-@d^8Q>?)m1C<^1%XaZ10*rf!qO z;+bZG^t#f!Jd3v{xHyq)+8jh{J z<(-{ZE8L*BFs>0U!L=3(YpMR+AGpqA07wbv?!>-AJZ86L?FJZ3xciH*(l340EvAOo z3yHFe*h>Vy%`z?Tb949LL8hB}U>6#uNq9?>v$3}|B1=6r*Osm$Qk3VDBOEn~y6m4S|^u=2e}0A%r4o zEgr&rei_tXNvrn!HxwJ)mWJCdxMa1;UQyuTvV=qW`^G-!}egWW9R*&B4}1t8C$FAeV#boQIRLr#5c9|+)#-q zXqYR43$~0$Jxq>UsZ!sx`LU)Jw65!jGtCnS3J z(Cr`S(r4387U=@VN%=Xy`u=}WrRF8-zN96)n~~!)SkwM`tKmH9IpTF6BUl7HJ_%u? z38~Mn9~o%2az6?4IDxRf7K!BCN&cYr;{i3+33Ke#Sd!n;rT=zk1TtY>XutKl&9wN> zH`#yV*8kVQG5#pKBv`M$RdEtLaLg2Fzu&IQUjDt{is|xI^u?vLHi&3SUU@)2J2agJ$X%{1*Zgn~ z-8M@)o7csbSGF7~vfou0wA@NLXWjh$a>sAQ%F7kB(zSTe!rV36C`A%xqwBs)^M^Yn z^I2Gd8g0GtTB;IBA*>@s?2F;-)-mo;r<6n;>ZzVtH$$vY?5dUG8O6Hi9WD#iJiI`- zN`YSI_$$MVI^)&{>3RmbOo?JGUtHciJa5?Ob#ZUZC)NM)tuzD0=QV@#w2bPBuRvYD zN4MQBZtqcvoj&$mNX+zmb9S}sPt2&i z?5dhd7plvimbwfEtR3RIz{_2DNmbg)I~mX?alcW-PBNQG3_srQl{|nMGP&a8@%g%E zhaJ$*T&nY$uM@P(Yd1|3u7xJR&22QwW@7YJasK7HC29hnq4;%W|+3Fy@;^8`poBS=G185y(&q-tp9q1Mhhr zOl2?m*VS09)!cVxy`Il(rzeoZQO6@hsyX{HKjwvHE737+Ef$Ws5?(XMV z_dU%Ls^yhOFQ*uq1*15Nc2nCG0zj&YDxr{1QdsnE@Hi(Bn+arnd2+H39SG42MHTC% z4Mh962>3GzwI(YIRSsBXo;JR6D@%B?*2T4XCSuYo%5vN9iv*LuAeP+V zvd<951%Le%%1|AJd_q$52%irGAG8IiYE+a*DYj)EAm~s1-WR8z0xN+$Y)8NXmn+Pw zPlxtH&bg1(E~^5;CW@GsDNnaFm@4%TDpJfJOG|FoeJM|nz@b{{55rJN?8q`U!=C$= z)+MXAKg{&#<~3j+1xPx;)Iv#c9(mB{Kq`@1BVM^1q`{Xu?&Pe z(MH#ebjrEq+&>jE*~O zhfw%9wK_bNrJx1+rh~C*b$>U9jGmNrCeK%@$%=dvT97ec-g&H~y5m1x$SGugMaN=l z{1dH2c8+-8R}}%P@0nj?6D3z+ORB@0Rvoa_NvZCzAU8-`!_YiC z{Cv~2Yi6lK@;zu{!|*n@s_aEIHWK4Xqc7Xa&zlOsO~B~By)yk>c3EWP9NO&SC}kXv zEV5Y@;0* Date: Mon, 18 Jun 2018 15:15:23 -0700 Subject: [PATCH 15/63] Add bundle search and help command -Add command to search for bundles and reference to online bundle-list - Add swupd help as additional information - Reformat commands with switches but no parameters as commands instead of code-blocks --- .../clear-linux/reference/bundle-commands.rst | 45 ++++++++++++++++--- 1 file changed, 38 insertions(+), 7 deletions(-) diff --git a/source/clear-linux/reference/bundle-commands.rst b/source/clear-linux/reference/bundle-commands.rst index 40ddf99f..849c42c5 100644 --- a/source/clear-linux/reference/bundle-commands.rst +++ b/source/clear-linux/reference/bundle-commands.rst @@ -3,20 +3,51 @@ Useful bundle commands ###################### -To see a list of currently-installed bundles, enter: -.. code-block:: console - # swupd bundle-list +To see a list of currently installed bundles, enter: + + :command:`swupd` :option:`bundle-list` + To see the list of all available bundles, enter: -.. code-block:: console + :command:`swupd` :option:`bundle-list --all` + + + Alternatively, you may reference the `available bundle list`_ webpage. + + +To search for bundles and their contents, enter: + + .. code-block:: console + + # swupd search [bundle name] - # swupd bundle-list --all To add a bundle, enter: -.. code-block:: console + .. code-block:: console - # swupd bundle-add [bundle name] \ No newline at end of file + # swupd bundle-add [bundle name] + + + + +Additional information +====================== + +For additional :command:`swupd` commands, enter: + + .. code-block:: console + + # swupd --help + +or reference the :command:`swupd` man page, enter: + + .. code-block:: console + + # man swupd + + +.. _available bundle list: https://clearlinux.org/documentation/clear-linux/reference/bundles/available-bundles#bundle-list From a05e77266d9893811c5b6e7790652dca911c0070 Mon Sep 17 00:00:00 2001 From: Michael Vincerra Date: Tue, 19 Jun 2018 17:35:13 -0700 Subject: [PATCH 16/63] Corrects Sphinx syntax for accurate rendering. Signed-off-by: Michael Vincerra --- .../bootable-usb/bootable-usb-windows.rst | 37 +++++++++---------- 1 file changed, 18 insertions(+), 19 deletions(-) diff --git a/source/clear-linux/get-started/bootable-usb/bootable-usb-windows.rst b/source/clear-linux/get-started/bootable-usb/bootable-usb-windows.rst index 9b884c6d..424c7ebb 100644 --- a/source/clear-linux/get-started/bootable-usb/bootable-usb-windows.rst +++ b/source/clear-linux/get-started/bootable-usb/bootable-usb-windows.rst @@ -27,35 +27,34 @@ Burn the Clear Linux image onto a USB drive |CAUTION-BACKUP-USB| -#. Download the `Rufus`_ utility to burn the image onto a USB drive. -#. Plug in the USB drive and open Rufus. -#. Click the :guilabel:`SELECT` button. See Figure 1. +#. Download the `Rufus`_ utility to burn the image onto a USB drive. - .. figure:: figures/bootable-usb-windows-1.png - :scale: 80 % - :alt: Rufus utility - Click the SELECT button +#. Plug in the USB drive and open Rufus. - Figure 1: Rufus utility - Click the SELECT button +#. Click the :guilabel:`SELECT` button. See Figure 1. + .. figure:: figures/bootable-usb-windows-1.png + :scale: 80 % + :alt: Rufus utility - Click the SELECT button -#. Find and select the previously extracted |CL| image file. - Then, click the :guilabel:`Open` button. See Figure 2. + Figure 1: Rufus utility - Click the SELECT button - .. figure:: figures/bootable-usb-windows-2.png - :scale: 80 % - :alt: Rufus utility - Show and select |CL| image file +#. Find and select the previously extracted |CL| image file. + Then, click the :guilabel:`Open` button. See Figure 2. - Figure 2: Rufus utility - Show and select |CL| image file + .. figure:: figures/bootable-usb-windows-2.png + :scale: 80 % + :alt: Rufus utility - Show and select |CL| image file + + Figure 2: Rufus utility - Show and select |CL| image file - #. Click the :guilabel:`START` button. See Figure 3. - .. figure:: figures/bootable-usb-windows-3.png - :scale: 80 % - :alt: Rufus utility - Click the START button + .. figure:: figures/bootable-usb-windows-3.png + :scale: 80 % + :alt: Rufus utility - Click the START button - Figure 3: Rufus utility - Click START button - + Figure 3: Rufus utility - Click START button Next steps ********** From 6ad227259c7118118997b39179eaa6796adfc5e8 Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Wed, 20 Jun 2018 10:24:01 -0700 Subject: [PATCH 17/63] Initial add of docker tutorial --- .../clear-linux/tutorials/docker/docker.rst | 163 ++++++++++++++++++ 1 file changed, 163 insertions(+) create mode 100644 source/clear-linux/tutorials/docker/docker.rst diff --git a/source/clear-linux/tutorials/docker/docker.rst b/source/clear-linux/tutorials/docker/docker.rst new file mode 100644 index 00000000..7378c5f9 --- /dev/null +++ b/source/clear-linux/tutorials/docker/docker.rst @@ -0,0 +1,163 @@ +.. _docker: + +Docker* on |CL| +###################################################### + +|CLOSIA| supports many containerization platforms, including Docker*. |CL| has many `unique features`_ including a minimal default installation +which makes it compelling to use as a host for container management, orchestration, and workloads. + + +This tutorial will go over: + +#. Installing the required bundle for Docker +#. Additional Docker* configuration on |CL| +#. Integration with Kata Containers + + + +.. note:: + This tutorial focuses on the installaton of the Docker* ecosystem. + If you want to use |CL| as a Docker* container image, + refer to the official |CL| `DockerHub image`_ and `building a custom Clear Linux docker image`_ . + + +Prerequisites +============= + +* You have a basic understanding of Linux and Docker. + +* You have successfully installed :ref:`Clear Linux on bare metal` + +* Your |CL| installation has transparent network access to the Internet. If you are behind a HTTP proxy server, in a corporate setting for example, please refer to the `Docker* proxy instructions`_ . + + + + + +Installing the required bundle +=============================== + +Software in Clear Linux is offered in the form of `bundles`_ to provide a complete function. +The *containers-basic* provides all the required software packages to run Docker images as containers. + +#. Install the *containers-basic* bundle by running this :command:`swupd` command: + + .. code-block:: bash + + sudo swupd bundle-add containers-basic + + +#. Start the Docker* daemon through systemd manager by running this command: + + .. code-block:: bash + + sudo systemctl start docker + + + If you want Docker* to start automatically on boot, enable the systemd service by running this command: + + .. code-block:: bash + + sudo systemctl enable docker + + +#. Verify :command:`docker` has been installed by running this command and checking the version output for both *client* and *server*: + + .. code-block:: bash + + sudo docker version + + +Congratulations! At this point, you have a working installation of Docker* on |CL| and are ready to start using container images on your system. + +.. note:: + The proceeding sections of this tutorial are standard to Docker* setup and configuration. + If you are familiar with Docker basics, you do not need to continue reading. The following sections are provided here for sake of completeness. + + + + +Additional Docker configuration +=============================== + +Additional Docker* daemon configuration done can be via a configuration file typically located at :file:`/etc/docker/daemon.json` . +|CL| features a `stateless system`_ so the configuration file :file:`daemon.json` will *NOT* exist by default. + + +Create the :file:`daemon.json` by running this command: + .. code-block:: bash + + touch /etc/docker/daemon.json + +Refer to the `Docker daemon configuration documentation`_ for the full list of available configuration options and examples. + +Once you've made any required changes, be sure to restart the Docker* daemon through systemd manager by running this command: + + .. code-block:: bash + + sudo systemctl restart docker + + + +Example run of a container +========================== + + + + + + + + +Integration with Kata Containers +================================ +`Kata Containers`_, formerly known and Intel Clear Containers, is an open source project aiming to increase security of containers by using lightweight virtual machine technology. +You can take advantage of Kata Containers in |CL| by simply installing the *containers-virt* bundle by running the command below: + + .. code-block:: bash + + sudo swupd bundle-add containers-virt + +Restart the Docker* daemon through systemd manager by running this command: + + .. code-block:: bash + + sudo systemctl restart docker + +After restarting, the Docker daemon will seamlessly use katacontainers to launch containers. The default runtime for Docker containers is *runc*. +You can see the runtime has changed to :command:`cc-runtime` by running this command: + + .. code-block:: bash + + sudo docker info | grep Runtime + +You should see the following output: + + .. code-block:: bash + + Runtimes: cc-runtime runc + Default Runtime: cc-runtime + + + +Also see: +========= +* `Docker Home`_ +* `Docker Documentation`_ +* `DockerHub`_ +* `Kata Containers`_ + + + + +.. _`unique features`: https://clearlinux.org/features +.. _`DockerHub image`: https://hub.docker.com/_/clearlinux/ +.. _`building a custom Clear Linux docker image`: https://clearlinux.org/documentation/clear-linux/guides/network/custom-clear-container +.. _`Docker proxy instructions`: https://docs.docker.com/config/daemon/systemd/#httphttps-proxy +.. _`bundles`: https://clearlinux.org/documentation/clear-linux/concepts/bundles-about#related-concepts +.. _`stateless system`: https://clearlinux.org/features/stateless +.. _`Docker daemon configuration documentation`: https://docs.docker.com/engine/reference/commandline/dockerd/#daemon-configuration-file +.. _`Kata Containers`: https://katacontainers.io/ +.. _`Docker Home`: https://www.docker.com/ +.. _`Docker Documentation`: https://docs.docker.com/ +.. _`DockerHub`: https://hub.docker.com/ \ No newline at end of file From 1e3cab5c97c6cc2c0c0389503ca5104f73322bcb Mon Sep 17 00:00:00 2001 From: Michael Vincerra Date: Wed, 20 Jun 2018 11:23:24 -0700 Subject: [PATCH 18/63] Applies grammatical and trademark edits: - Linux kernels are updated per clr/bundles active status - Fulfills JIRA CLEAR 3107 Signed-off-by: Michael Vincerra --- .../reference/compatible-kernels.rst | 19 +++++++++---------- 1 file changed, 9 insertions(+), 10 deletions(-) diff --git a/source/clear-linux/reference/compatible-kernels.rst b/source/clear-linux/reference/compatible-kernels.rst index caa5fe28..0524c57d 100644 --- a/source/clear-linux/reference/compatible-kernels.rst +++ b/source/clear-linux/reference/compatible-kernels.rst @@ -1,6 +1,6 @@ .. _compatible-kernels: -Compatible Clear Linux kernels +Compatible Clear Linux\* kernels ############################## The |CLOSIA| provides the following Linux kernels with a respective bundle. @@ -44,11 +44,10 @@ The *kernel-kvm* bundle focuses on the Linux :abbr:`KVM (Kernel-based Virtual Machine)`. It is optimized for fast booting and performs best on Virtual Machines running on the Intel® architectures described on the :ref:`supported hardware list`. -Use this kernel when running |CL| as the guest OS -on top of *qemu/kvm*. Use this kernel with **cloud orchestrators** using -*qemu/kvm* internally as their **hypervisor**. -This kernel can be used as a stand alone Linux VM, see our -:ref:`instructions on using KVM` for more information. The +Use this kernel when running |CL| as the guest OS on top of *qemu/kvm*. Use +this kernel with **cloud orchestrators** using *qemu/kvm* internally as +their **hypervisor**. This kernel can be used as a standalone |CL| VM, see +our :ref:`instructions on using KVM` for more information. The optimization patches are found in our `Linux-KVM`_ GitHub repo. Kernel Hyper-V\* @@ -59,8 +58,8 @@ Hyper-V. It is optimized for fast booting and performs best on Virtual Machines running on the Intel® architectures described on the :ref:`supported hardware list`. Use this kernel when running |CL| as the guest OS of **Cloud Instances** in -projects such as Microsoft `Azure`_\*. This kernel can be used as a stand -alone Linux VM, see our :ref:`instructions on using Hyper-V` for +projects such as Microsoft `Azure`_\*. This kernel can be used in a +standalone |CL| VM, see our :ref:`instructions on using Hyper-V` for more information. The optimization patches are found in our `Linux-HyperV`_ GitHub repo. @@ -73,8 +72,8 @@ is optimized for fast booting and performs best on Virtual Machines running on the Intel® architectures described on the :ref:`supported hardware list`. Use this kernel when running |CL| as the guest OS of **Cloud Instances** in -projects such as Microsoft `Azure`_. This kernel can be used as a stand -alone Linux VM, see our :ref:`instructions on using Hyper-V` for +projects such as Microsoft `Azure`_. This kernel can be used in a standalone +|CL| VM, see our :ref:`instructions on using Hyper-V` for more information. The optimization patches are found in our `Linux-HyperV-LTS`_ GitHub repo. From 0475eb046f1e58ca305337c7f059afc80e4add9d Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Wed, 20 Jun 2018 13:30:16 -0700 Subject: [PATCH 19/63] Add content for running an example image --- .../clear-linux/tutorials/docker/docker.rst | 53 ++++++++++++++++--- 1 file changed, 45 insertions(+), 8 deletions(-) diff --git a/source/clear-linux/tutorials/docker/docker.rst b/source/clear-linux/tutorials/docker/docker.rst index 7378c5f9..2312f240 100644 --- a/source/clear-linux/tutorials/docker/docker.rst +++ b/source/clear-linux/tutorials/docker/docker.rst @@ -11,6 +11,7 @@ This tutorial will go over: #. Installing the required bundle for Docker #. Additional Docker* configuration on |CL| +#. Pulling and Running an image from Docker* Hub #. Integration with Kata Containers @@ -40,7 +41,7 @@ Installing the required bundle Software in Clear Linux is offered in the form of `bundles`_ to provide a complete function. The *containers-basic* provides all the required software packages to run Docker images as containers. -#. Install the *containers-basic* bundle by running this :command:`swupd` command: +#. First, install the *containers-basic* bundle by running this :command:`swupd` command: .. code-block:: bash @@ -54,14 +55,14 @@ The *containers-basic* provides all the required software packages to run Docker sudo systemctl start docker - If you want Docker* to start automatically on boot, enable the systemd service by running this command: + If you want Docker* to start automatically on boot, also enable the systemd service by running this command: .. code-block:: bash sudo systemctl enable docker -#. Verify :command:`docker` has been installed by running this command and checking the version output for both *client* and *server*: +#. Finally, verify :command:`docker` has been installed by running this command and checking the version output for both *client* and *server*: .. code-block:: bash @@ -84,14 +85,15 @@ Additional Docker* daemon configuration done can be via a configuration file typ |CL| features a `stateless system`_ so the configuration file :file:`daemon.json` will *NOT* exist by default. -Create the :file:`daemon.json` by running this command: +#. Create the :file:`daemon.json` by running this command: + .. code-block:: bash touch /etc/docker/daemon.json Refer to the `Docker daemon configuration documentation`_ for the full list of available configuration options and examples. -Once you've made any required changes, be sure to restart the Docker* daemon through systemd manager by running this command: +#. Once you've made any required changes, be sure to restart the Docker* daemon through systemd manager by running this command: .. code-block:: bash @@ -99,19 +101,52 @@ Once you've made any required changes, be sure to restart the Docker* daemon thr -Example run of a container +Pulling and Running an image from Docker* Hub ========================== +#. First, Pull a container image from DockerHub using the :command:`docker pull` command. Download the latest nginx Docker container image by running this command: + + .. code-block:: bash + + sudo docker pull nginx + +#. Create and launch a new container using the :command:`docker run` command. Launch a nginx container by running this command: + + .. code-block:: bash + + sudo docker run --name test-nginx -d -p 8080:80 nginx + + .. note:: + + Below is an explaination of switches used in the command above. For detailed :command:`docker run` switches and syntax, refer to the `Docker Documentation`_ . + + The :option:`--name` switch lets you provide a friendly name to target the container for future operations + + The :option:`-d` switch launches the container in the background + + The :option:`-p` switch allows the container's HTTP port (80) to be accessible from the Clear Linux host on port 8080 +#. You can access the Welcome to Nginx! splash page running in the container by browsing to http://127.0.0.1:8080 or by running this :command:`curl` command from your Clear Linux machine: + + .. code-block:: bash + + curl 127.0.0.1:8080 +# Finally, stop and delete the nginx container by running the :command:`docker stop` and :command:`docker rm` commands. + .. code-block:: bash + + sudo docker stop test-nginx + sudo docker rm test-nginx + +Congratulations! At this point, you have successfully pulled a nginx container image from `DockerHub`_ and ran an example container. Integration with Kata Containers ================================ -`Kata Containers`_, formerly known and Intel Clear Containers, is an open source project aiming to increase security of containers by using lightweight virtual machine technology. +`Kata Containers`_, formerly known as Intel Clear Containers, is an open source project aiming to increase security of containers by using lightweight virtual machine technology. You can take advantage of Kata Containers in |CL| by simply installing the *containers-virt* bundle by running the command below: .. code-block:: bash @@ -131,13 +166,15 @@ You can see the runtime has changed to :command:`cc-runtime` by running this com sudo docker info | grep Runtime -You should see the following output: +You should see the following output indicating the *cc-runtime* is the Default Runtime: .. code-block:: bash Runtimes: cc-runtime runc Default Runtime: cc-runtime +Congratulations! At this point, you have successfully replaced the default container runtime with Kata. +You can repeat the steps from :ref:`Pulling and Running an image from Docker* Hub` without changing anything special. Also see: From 11d1b948cc560e337bd99b372f36439868628e44 Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Wed, 20 Jun 2018 13:57:42 -0700 Subject: [PATCH 20/63] Refactor and formatting Moved kata containers section above the other optional sections to improve reader flow. --- .../clear-linux/tutorials/docker/docker.rst | 122 +++++++++++------- 1 file changed, 75 insertions(+), 47 deletions(-) diff --git a/source/clear-linux/tutorials/docker/docker.rst b/source/clear-linux/tutorials/docker/docker.rst index 2312f240..32b1b4d0 100644 --- a/source/clear-linux/tutorials/docker/docker.rst +++ b/source/clear-linux/tutorials/docker/docker.rst @@ -3,16 +3,18 @@ Docker* on |CL| ###################################################### -|CLOSIA| supports many containerization platforms, including Docker*. |CL| has many `unique features`_ including a minimal default installation +|CLOSIA| supports many containerization platforms, including Docker*. +|CL| has many `unique features`_ including a minimal default installation which makes it compelling to use as a host for container management, orchestration, and workloads. This tutorial will go over: #. Installing the required bundle for Docker +#. Integration with Kata Containers (optional) #. Additional Docker* configuration on |CL| #. Pulling and Running an image from Docker* Hub -#. Integration with Kata Containers + @@ -27,18 +29,23 @@ Prerequisites * You have a basic understanding of Linux and Docker. -* You have successfully installed :ref:`Clear Linux on bare metal` - -* Your |CL| installation has transparent network access to the Internet. If you are behind a HTTP proxy server, in a corporate setting for example, please refer to the `Docker* proxy instructions`_ . - +* You have successfully installed + :ref:`Clear Linux on bare metal` +* Your |CL| installation has transparent network access to the Internet. + If you are behind a HTTP proxy server, in a corporate setting for example, + please refer to the `Docker* proxy instructions`_ . + | + | + | Installing the required bundle =============================== -Software in Clear Linux is offered in the form of `bundles`_ to provide a complete function. +Software in Clear Linux is offered in the form +of `bundles`_ to provide a complete function. The *containers-basic* provides all the required software packages to run Docker images as containers. #. First, install the *containers-basic* bundle by running this :command:`swupd` command: @@ -62,7 +69,8 @@ The *containers-basic* provides all the required software packages to run Docker sudo systemctl enable docker -#. Finally, verify :command:`docker` has been installed by running this command and checking the version output for both *client* and *server*: +#. Finally, verify :command:`docker` has been installed by running this + command and checking the version output for both *client* and *server*: .. code-block:: bash @@ -71,13 +79,53 @@ The *containers-basic* provides all the required software packages to run Docker Congratulations! At this point, you have a working installation of Docker* on |CL| and are ready to start using container images on your system. + | + | + | + + +Integration with Kata Containers (optional) +================================ +`Kata Containers`_, formerly known as Intel Clear Containers, is an open source project aiming to increase security of containers by using lightweight virtual machine technology. +The Docker* package from |CL| will automatically use the runtime required for Kata Containers if it is available on your Clear Linux system. + +#. You can take advantage of Kata Containers in |CL| by simply installing the *containers-virt* bundle by running the command below: + + .. code-block:: bash + + sudo swupd bundle-add containers-virt + +#. Restart the Docker* daemon through systemd manager by running this command: + + .. code-block:: bash + + sudo systemctl restart docker + +#. After restarting, the Docker* daemon will seamlessly use katacontainers to launch containers. The default runtime for Docker containers is *runc*. You can see the runtime has changed to :command:`cc-runtime` by running this command: + + .. code-block:: bash + + sudo docker info | grep Runtime + +#. You should see the following output indicating the *cc-runtime* is the Default Runtime: + + .. code-block:: bash + + Runtimes: cc-runtime runc + Default Runtime: cc-runtime + +Congratulations! At this point, you have successfully replaced the default container runtime with Kata. + +| +| +| + .. note:: The proceeding sections of this tutorial are standard to Docker* setup and configuration. If you are familiar with Docker basics, you do not need to continue reading. The following sections are provided here for sake of completeness. - Additional Docker configuration =============================== @@ -91,7 +139,7 @@ Additional Docker* daemon configuration done can be via a configuration file typ touch /etc/docker/daemon.json -Refer to the `Docker daemon configuration documentation`_ for the full list of available configuration options and examples. + Refer to the `Docker* daemon configuration documentation`_ for the full list of available configuration options and examples. #. Once you've made any required changes, be sure to restart the Docker* daemon through systemd manager by running this command: @@ -100,6 +148,10 @@ Refer to the `Docker daemon configuration documentation`_ for the full list of a sudo systemctl restart docker + | + | + | + Pulling and Running an image from Docker* Hub ========================== @@ -111,6 +163,7 @@ Pulling and Running an image from Docker* Hub sudo docker pull nginx + #. Create and launch a new container using the :command:`docker run` command. Launch a nginx container by running this command: .. code-block:: bash @@ -119,7 +172,7 @@ Pulling and Running an image from Docker* Hub .. note:: - Below is an explaination of switches used in the command above. For detailed :command:`docker run` switches and syntax, refer to the `Docker Documentation`_ . + Below is an explaination of switches used in the command above. For detailed :command:`docker run` switches and syntax, refer to the `Docker* Documentation`_ . The :option:`--name` switch lets you provide a friendly name to target the container for future operations @@ -135,52 +188,27 @@ Pulling and Running an image from Docker* Hub curl 127.0.0.1:8080 -# Finally, stop and delete the nginx container by running the :command:`docker stop` and :command:`docker rm` commands. +#. Finally, stop and delete the nginx container by running the :command:`docker stop` and :command:`docker rm` commands. .. code-block:: bash sudo docker stop test-nginx sudo docker rm test-nginx + Congratulations! At this point, you have successfully pulled a nginx container image from `DockerHub`_ and ran an example container. + + | + | + | -Integration with Kata Containers -================================ -`Kata Containers`_, formerly known as Intel Clear Containers, is an open source project aiming to increase security of containers by using lightweight virtual machine technology. -You can take advantage of Kata Containers in |CL| by simply installing the *containers-virt* bundle by running the command below: - .. code-block:: bash - - sudo swupd bundle-add containers-virt - -Restart the Docker* daemon through systemd manager by running this command: - - .. code-block:: bash - - sudo systemctl restart docker - -After restarting, the Docker daemon will seamlessly use katacontainers to launch containers. The default runtime for Docker containers is *runc*. -You can see the runtime has changed to :command:`cc-runtime` by running this command: - - .. code-block:: bash - - sudo docker info | grep Runtime - -You should see the following output indicating the *cc-runtime* is the Default Runtime: - - .. code-block:: bash - - Runtimes: cc-runtime runc - Default Runtime: cc-runtime - -Congratulations! At this point, you have successfully replaced the default container runtime with Kata. -You can repeat the steps from :ref:`Pulling and Running an image from Docker* Hub` without changing anything special. Also see: ========= -* `Docker Home`_ -* `Docker Documentation`_ +* `Docker* Home`_ +* `Docker* Documentation`_ * `DockerHub`_ * `Kata Containers`_ @@ -190,11 +218,11 @@ Also see: .. _`unique features`: https://clearlinux.org/features .. _`DockerHub image`: https://hub.docker.com/_/clearlinux/ .. _`building a custom Clear Linux docker image`: https://clearlinux.org/documentation/clear-linux/guides/network/custom-clear-container -.. _`Docker proxy instructions`: https://docs.docker.com/config/daemon/systemd/#httphttps-proxy +.. _`Docker* proxy instructions`: https://docs.docker.com/config/daemon/systemd/#httphttps-proxy .. _`bundles`: https://clearlinux.org/documentation/clear-linux/concepts/bundles-about#related-concepts .. _`stateless system`: https://clearlinux.org/features/stateless .. _`Docker daemon configuration documentation`: https://docs.docker.com/engine/reference/commandline/dockerd/#daemon-configuration-file .. _`Kata Containers`: https://katacontainers.io/ -.. _`Docker Home`: https://www.docker.com/ -.. _`Docker Documentation`: https://docs.docker.com/ +.. _`Docker* Home`: https://www.docker.com/ +.. _`Docker* Documentation`: https://docs.docker.com/ .. _`DockerHub`: https://hub.docker.com/ \ No newline at end of file From 5d61a12854f9e3a9a82609f92667f8f96e20c20d Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Wed, 20 Jun 2018 14:17:08 -0700 Subject: [PATCH 21/63] more RST formatting and syntax --- .../clear-linux/tutorials/docker/docker.rst | 57 ++++++++++++------- 1 file changed, 35 insertions(+), 22 deletions(-) diff --git a/source/clear-linux/tutorials/docker/docker.rst b/source/clear-linux/tutorials/docker/docker.rst index 32b1b4d0..8e7ee246 100644 --- a/source/clear-linux/tutorials/docker/docker.rst +++ b/source/clear-linux/tutorials/docker/docker.rst @@ -5,7 +5,7 @@ Docker* on |CL| |CLOSIA| supports many containerization platforms, including Docker*. |CL| has many `unique features`_ including a minimal default installation -which makes it compelling to use as a host for container management, orchestration, and workloads. +which makes it compelling to use as a host for container workloads, management, and orchestration. This tutorial will go over: @@ -21,7 +21,7 @@ This tutorial will go over: .. note:: This tutorial focuses on the installaton of the Docker* ecosystem. If you want to use |CL| as a Docker* container image, - refer to the official |CL| `DockerHub image`_ and `building a custom Clear Linux docker image`_ . + refer to the official `|CL| image on Docker* Hub`_ and `building a custom Clear Linux docker image`_ . Prerequisites @@ -85,8 +85,12 @@ Congratulations! At this point, you have a working installation of Docker* on |C Integration with Kata Containers (optional) -================================ -`Kata Containers`_, formerly known as Intel Clear Containers, is an open source project aiming to increase security of containers by using lightweight virtual machine technology. +=========================================== + +`Kata Containers`_, +formerly known as Intel Clear Containers, is an open source +project aiming to increase security of containers by using lightweight virtual machine technology. + The Docker* package from |CL| will automatically use the runtime required for Kata Containers if it is available on your Clear Linux system. #. You can take advantage of Kata Containers in |CL| by simply installing the *containers-virt* bundle by running the command below: @@ -101,13 +105,18 @@ The Docker* package from |CL| will automatically use the runtime required for Ka sudo systemctl restart docker -#. After restarting, the Docker* daemon will seamlessly use katacontainers to launch containers. The default runtime for Docker containers is *runc*. You can see the runtime has changed to :command:`cc-runtime` by running this command: +#. After restarting, the Docker* daemon + will seamlessly use katacontainers to launch containers. + The default runtime for Docker containers is *runc*. + You can see the runtime has changed to :command:`cc-runtime` + by running this command: .. code-block:: bash sudo docker info | grep Runtime -#. You should see the following output indicating the *cc-runtime* is the Default Runtime: +#. You should see the following output + indicating the *cc-runtime* is the Default Runtime: .. code-block:: bash @@ -129,7 +138,8 @@ Congratulations! At this point, you have successfully replaced the default conta Additional Docker configuration =============================== -Additional Docker* daemon configuration done can be via a configuration file typically located at :file:`/etc/docker/daemon.json` . +Additional Docker* daemon configuration done can be via a +configuration file typically located at :file:`/etc/docker/daemon.json` . |CL| features a `stateless system`_ so the configuration file :file:`daemon.json` will *NOT* exist by default. @@ -139,9 +149,11 @@ Additional Docker* daemon configuration done can be via a configuration file typ touch /etc/docker/daemon.json - Refer to the `Docker* daemon configuration documentation`_ for the full list of available configuration options and examples. + Refer to the `Docker* daemon configuration documentation`_ for the + full list of available configuration options and examples. -#. Once you've made any required changes, be sure to restart the Docker* daemon through systemd manager by running this command: +#. Once you've made any required changes, be sure to restart the + Docker* daemon through systemd manager by running this command: .. code-block:: bash @@ -154,17 +166,17 @@ Additional Docker* daemon configuration done can be via a configuration file typ Pulling and Running an image from Docker* Hub -========================== +============================================= - -#. First, Pull a container image from DockerHub using the :command:`docker pull` command. Download the latest nginx Docker container image by running this command: +#. First, Pull a container image from Docker* Hub using the :command:`docker pull` command. Download the latest nginx Docker container image by running this command: .. code-block:: bash sudo docker pull nginx -#. Create and launch a new container using the :command:`docker run` command. Launch a nginx container by running this command: +#. Create and launch a new container using the :command:`docker run` command. + Launch a nginx container by running this command: .. code-block:: bash @@ -174,11 +186,11 @@ Pulling and Running an image from Docker* Hub Below is an explaination of switches used in the command above. For detailed :command:`docker run` switches and syntax, refer to the `Docker* Documentation`_ . - The :option:`--name` switch lets you provide a friendly name to target the container for future operations + * The :option:`--name` switch lets you provide a friendly name to target the container for future operations - The :option:`-d` switch launches the container in the background + * The :option:`-d` switch launches the container in the background - The :option:`-p` switch allows the container's HTTP port (80) to be accessible from the Clear Linux host on port 8080 + * The :option:`-p` switch allows the container's HTTP port (80) to be accessible from the Clear Linux host on port 8080 #. You can access the Welcome to Nginx! splash page running in the container by browsing to http://127.0.0.1:8080 or by running this :command:`curl` command from your Clear Linux machine: @@ -188,7 +200,8 @@ Pulling and Running an image from Docker* Hub curl 127.0.0.1:8080 -#. Finally, stop and delete the nginx container by running the :command:`docker stop` and :command:`docker rm` commands. +#. Finally, stop and delete the nginx container by running the + :command:`docker stop` and :command:`docker rm` commands. .. code-block:: bash @@ -196,7 +209,7 @@ Pulling and Running an image from Docker* Hub sudo docker rm test-nginx -Congratulations! At this point, you have successfully pulled a nginx container image from `DockerHub`_ and ran an example container. +Congratulations! At this point, you have successfully pulled a nginx container image from `Docker* Hub`_ and ran an example container. | | @@ -209,20 +222,20 @@ Also see: ========= * `Docker* Home`_ * `Docker* Documentation`_ -* `DockerHub`_ +* `Docker* Hub`_ * `Kata Containers`_ .. _`unique features`: https://clearlinux.org/features -.. _`DockerHub image`: https://hub.docker.com/_/clearlinux/ +.. _`|CL| image on Docker* Hub`: https://hub.docker.com/_/clearlinux/ .. _`building a custom Clear Linux docker image`: https://clearlinux.org/documentation/clear-linux/guides/network/custom-clear-container .. _`Docker* proxy instructions`: https://docs.docker.com/config/daemon/systemd/#httphttps-proxy .. _`bundles`: https://clearlinux.org/documentation/clear-linux/concepts/bundles-about#related-concepts .. _`stateless system`: https://clearlinux.org/features/stateless -.. _`Docker daemon configuration documentation`: https://docs.docker.com/engine/reference/commandline/dockerd/#daemon-configuration-file +.. _`Docker* daemon configuration documentation`: https://docs.docker.com/engine/reference/commandline/dockerd/#daemon-configuration-file .. _`Kata Containers`: https://katacontainers.io/ .. _`Docker* Home`: https://www.docker.com/ .. _`Docker* Documentation`: https://docs.docker.com/ -.. _`DockerHub`: https://hub.docker.com/ \ No newline at end of file +.. _`Docker* Hub`: https://hub.docker.com/ \ No newline at end of file From 2ea34e21da2d0ba349edd9e6a5b7f712f4f8f66a Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Wed, 20 Jun 2018 14:33:34 -0700 Subject: [PATCH 22/63] minor language edits --- source/clear-linux/tutorials/docker/docker.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/clear-linux/tutorials/docker/docker.rst b/source/clear-linux/tutorials/docker/docker.rst index 8e7ee246..dd6d95ed 100644 --- a/source/clear-linux/tutorials/docker/docker.rst +++ b/source/clear-linux/tutorials/docker/docker.rst @@ -3,7 +3,7 @@ Docker* on |CL| ###################################################### -|CLOSIA| supports many containerization platforms, including Docker*. +|CLOSIA| supports multiple containerization platforms, including Docker*. |CL| has many `unique features`_ including a minimal default installation which makes it compelling to use as a host for container workloads, management, and orchestration. @@ -149,7 +149,7 @@ configuration file typically located at :file:`/etc/docker/daemon.json` . touch /etc/docker/daemon.json - Refer to the `Docker* daemon configuration documentation`_ for the + Refer to the `Docker* documentation on daemon configuration `_ for the full list of available configuration options and examples. #. Once you've made any required changes, be sure to restart the @@ -234,7 +234,7 @@ Also see: .. _`Docker* proxy instructions`: https://docs.docker.com/config/daemon/systemd/#httphttps-proxy .. _`bundles`: https://clearlinux.org/documentation/clear-linux/concepts/bundles-about#related-concepts .. _`stateless system`: https://clearlinux.org/features/stateless -.. _`Docker* daemon configuration documentation`: https://docs.docker.com/engine/reference/commandline/dockerd/#daemon-configuration-file +.. _`Docker* documentation on daemon configuration`: https://docs.docker.com/engine/reference/commandline/dockerd/#daemon-configuration-file .. _`Kata Containers`: https://katacontainers.io/ .. _`Docker* Home`: https://www.docker.com/ .. _`Docker* Documentation`: https://docs.docker.com/ From f9b7daac80e6e5f616b639cc05ae1ddba9219dd1 Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Wed, 20 Jun 2018 15:31:00 -0700 Subject: [PATCH 23/63] Rename Kata reference to Clear Containers --- .../clear-linux/tutorials/docker/docker.rst | 34 +++++++++++-------- 1 file changed, 20 insertions(+), 14 deletions(-) diff --git a/source/clear-linux/tutorials/docker/docker.rst b/source/clear-linux/tutorials/docker/docker.rst index dd6d95ed..e7a63f4f 100644 --- a/source/clear-linux/tutorials/docker/docker.rst +++ b/source/clear-linux/tutorials/docker/docker.rst @@ -11,7 +11,7 @@ which makes it compelling to use as a host for container workloads, management, This tutorial will go over: #. Installing the required bundle for Docker -#. Integration with Kata Containers (optional) +#. Integration with Clear Containers (optional) #. Additional Docker* configuration on |CL| #. Pulling and Running an image from Docker* Hub @@ -84,16 +84,19 @@ Congratulations! At this point, you have a working installation of Docker* on |C | -Integration with Kata Containers (optional) -=========================================== +Integration with Clear Containers (optional) +============================================ -`Kata Containers`_, -formerly known as Intel Clear Containers, is an open source -project aiming to increase security of containers by using lightweight virtual machine technology. +`Clear Containers`_, +is an open source project +aiming to increase security of containers by using a +hardware-backed virtual machine container runtime, +instead of software namespace containers +that are provided by the standard Docker *runc* runtime. -The Docker* package from |CL| will automatically use the runtime required for Kata Containers if it is available on your Clear Linux system. +The Docker* package from |CL| will automatically use the *cc-runtime* required for Clear Containers if it is available on your Clear Linux system. -#. You can take advantage of Kata Containers in |CL| by simply installing the *containers-virt* bundle by running the command below: +#. You can take advantage of Clear Containers in |CL| by simply installing the *containers-virt* bundle by running the command below: .. code-block:: bash @@ -106,8 +109,7 @@ The Docker* package from |CL| will automatically use the runtime required for Ka sudo systemctl restart docker #. After restarting, the Docker* daemon - will seamlessly use katacontainers to launch containers. - The default runtime for Docker containers is *runc*. + will seamlessly use Clear Containers to launch containers. You can see the runtime has changed to :command:`cc-runtime` by running this command: @@ -123,7 +125,7 @@ The Docker* package from |CL| will automatically use the runtime required for Ka Runtimes: cc-runtime runc Default Runtime: cc-runtime -Congratulations! At this point, you have successfully replaced the default container runtime with Kata. +Congratulations! At this point, you have successfully replaced the default container runtime with Clear Containers. | | @@ -167,6 +169,9 @@ configuration file typically located at :file:`/etc/docker/daemon.json` . Pulling and Running an image from Docker* Hub ============================================= +`Docker Hub`_ is a publically available container image repository which comes preconfigured with Docker*. +In the example below we will pull and run nginx, an open source reverse proxy server. + #. First, Pull a container image from Docker* Hub using the :command:`docker pull` command. Download the latest nginx Docker container image by running this command: @@ -223,7 +228,7 @@ Also see: * `Docker* Home`_ * `Docker* Documentation`_ * `Docker* Hub`_ -* `Kata Containers`_ +* `Clear Containers`_ @@ -235,7 +240,8 @@ Also see: .. _`bundles`: https://clearlinux.org/documentation/clear-linux/concepts/bundles-about#related-concepts .. _`stateless system`: https://clearlinux.org/features/stateless .. _`Docker* documentation on daemon configuration`: https://docs.docker.com/engine/reference/commandline/dockerd/#daemon-configuration-file -.. _`Kata Containers`: https://katacontainers.io/ +.. _`Clear Containers`: https://github.com/clearcontainers .. _`Docker* Home`: https://www.docker.com/ .. _`Docker* Documentation`: https://docs.docker.com/ -.. _`Docker* Hub`: https://hub.docker.com/ \ No newline at end of file +.. _`Docker* Hub`: https://hub.docker.com/ + From ee85257df2ceb51c5805eee4110789e66852a3c4 Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Wed, 20 Jun 2018 15:36:50 -0700 Subject: [PATCH 24/63] minor syntax bugs --- source/clear-linux/tutorials/docker/docker.rst | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/source/clear-linux/tutorials/docker/docker.rst b/source/clear-linux/tutorials/docker/docker.rst index e7a63f4f..ba1974ff 100644 --- a/source/clear-linux/tutorials/docker/docker.rst +++ b/source/clear-linux/tutorials/docker/docker.rst @@ -151,7 +151,7 @@ configuration file typically located at :file:`/etc/docker/daemon.json` . touch /etc/docker/daemon.json - Refer to the `Docker* documentation on daemon configuration `_ for the + Refer to the `Docker* documentation on daemon configuration`_ for the full list of available configuration options and examples. #. Once you've made any required changes, be sure to restart the @@ -169,7 +169,8 @@ configuration file typically located at :file:`/etc/docker/daemon.json` . Pulling and Running an image from Docker* Hub ============================================= -`Docker Hub`_ is a publically available container image repository which comes preconfigured with Docker*. +`Docker* Hub`_ is a publically available container image repository +which comes preconfigured with Docker*. In the example below we will pull and run nginx, an open source reverse proxy server. From 88472e1771a1f7e59a66be2f50b2e49b739b9c83 Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Wed, 20 Jun 2018 15:43:55 -0700 Subject: [PATCH 25/63] minor clarification of nginx Docker image --- source/clear-linux/tutorials/docker/docker.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/clear-linux/tutorials/docker/docker.rst b/source/clear-linux/tutorials/docker/docker.rst index ba1974ff..6de14a49 100644 --- a/source/clear-linux/tutorials/docker/docker.rst +++ b/source/clear-linux/tutorials/docker/docker.rst @@ -171,7 +171,7 @@ Pulling and Running an image from Docker* Hub ============================================= `Docker* Hub`_ is a publically available container image repository which comes preconfigured with Docker*. -In the example below we will pull and run nginx, an open source reverse proxy server. +In the example below we will pull and run an the official Docker image for nginx, an open source reverse proxy server. #. First, Pull a container image from Docker* Hub using the :command:`docker pull` command. Download the latest nginx Docker container image by running this command: From be1fb1a2b5eb75d349591651e0bd2175e4a69385 Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Wed, 20 Jun 2018 16:04:47 -0700 Subject: [PATCH 26/63] Add section on Docker swarm --- source/clear-linux/tutorials/docker/docker.rst | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/source/clear-linux/tutorials/docker/docker.rst b/source/clear-linux/tutorials/docker/docker.rst index 6de14a49..d9dce909 100644 --- a/source/clear-linux/tutorials/docker/docker.rst +++ b/source/clear-linux/tutorials/docker/docker.rst @@ -221,7 +221,16 @@ Congratulations! At this point, you have successfully pulled a nginx container i | | +Creating a Docker* swarm cluster +========================================= +Clusters of Docker* hosts are referred to as swarms. +The process in this tutorial can be repeated to install Docker* +on multiple Clear Linux hosts with the intent to form a Docker* swarm cluster. + +The `Docker* documentation on swarm key concepts`_ and +`Docker* documentation on creating a swarm`_ can be referenced +for further instructions on setting up a swarm. Also see: @@ -245,4 +254,6 @@ Also see: .. _`Docker* Home`: https://www.docker.com/ .. _`Docker* Documentation`: https://docs.docker.com/ .. _`Docker* Hub`: https://hub.docker.com/ +.. _`Docker* documentation on swarm key concepts`: https://docs.docker.com/engine/swarm/key-concepts/ +.. _`Docker* documentation on creating a swarm`: https://docs.docker.com/engine/swarm/swarm-tutorial/create-swarm/ From 14c47506fcafc08d979f7f5d88fe95c9d98997a7 Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Wed, 20 Jun 2018 16:06:41 -0700 Subject: [PATCH 27/63] Update ToC --- source/clear-linux/tutorials/docker/docker.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/source/clear-linux/tutorials/docker/docker.rst b/source/clear-linux/tutorials/docker/docker.rst index d9dce909..3527bba5 100644 --- a/source/clear-linux/tutorials/docker/docker.rst +++ b/source/clear-linux/tutorials/docker/docker.rst @@ -14,6 +14,7 @@ This tutorial will go over: #. Integration with Clear Containers (optional) #. Additional Docker* configuration on |CL| #. Pulling and Running an image from Docker* Hub +#. Creating a Docker* swarm cluster @@ -222,7 +223,7 @@ Congratulations! At this point, you have successfully pulled a nginx container i | Creating a Docker* swarm cluster -========================================= +================================ Clusters of Docker* hosts are referred to as swarms. The process in this tutorial can be repeated to install Docker* From 078ee76f1d6f3ae3dc3d5311404f14d3345dcd23 Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Thu, 21 Jun 2018 13:12:53 -0700 Subject: [PATCH 28/63] Reorder methods to find partition size The lsblk approach is more likely to be used on an already deployed system, while the config.json is more of a reference point. --- .../increase-virtual-disk-size.rst | 40 ++++++++++--------- 1 file changed, 22 insertions(+), 18 deletions(-) diff --git a/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst b/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst index 7b991faa..5c87482c 100644 --- a/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst +++ b/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst @@ -13,7 +13,28 @@ Determine the prebuilt image size There are two methods to find the virtual disk size of your prebuilt |CL| image. -The first method is to check the config.JSON file of the image, located in the +The first method is to boot up your :abbr:`VM (Virtual Machine)` and +execute the :command:`lsblk` command as shown below: + +.. code-block:: bash + + sudo lsblk + +An example output of the :command:`lsblk` command: + +.. code-block:: console + + NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT + sda 8:0 0 8.5G 0 disk + ├─sdd1 8:1 0 512M 0 part + ├─sdd2 8:2 0 32M 0 part [SWAP] + └─sdd3 8:3 0 8G 0 part / + +In this example, both methods show the prebuilt Hyper-V image is about 8.5 GB. + + + +The second method is to check the config.JSON file of the image, located in the `releases`_ repository. For example, to find the size of the Hyper-V\* image version number 20450, follow these steps: @@ -39,24 +60,7 @@ version number 20450, follow these steps: "size" : "8G", "type" : "linux" } ], -The second method is to boot up your :abbr:`VM (Virtual Machine)` and -execute the :command:`lsblk` command as shown below: -.. code-block:: bash - - sudo lsblk - -An example output: - -.. code-block:: console - - NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT - sda 8:0 0 8.5G 0 disk - ├─sdd1 8:1 0 512M 0 part - ├─sdd2 8:2 0 32M 0 part [SWAP] - └─sdd3 8:3 0 8G 0 part / - -In this example, both methods show the prebuilt Hyper-V image is about 8.5 GB. Increase virtual disk size ************************** From 53ad59e18d4242c8eb8af0d0ba111eb363e2f3bb Mon Sep 17 00:00:00 2001 From: Michael Vincerra Date: Thu, 21 Jun 2018 13:22:13 -0700 Subject: [PATCH 29/63] Corrects syntax, adds internal TOC, and adds link to tutorials.rst Signed-off-by: Michael Vincerra --- .../clear-linux/tutorials/docker/docker.rst | 299 ++++++++---------- source/clear-linux/tutorials/tutorials.rst | 1 + 2 files changed, 137 insertions(+), 163 deletions(-) diff --git a/source/clear-linux/tutorials/docker/docker.rst b/source/clear-linux/tutorials/docker/docker.rst index 3527bba5..75c00e35 100644 --- a/source/clear-linux/tutorials/docker/docker.rst +++ b/source/clear-linux/tutorials/docker/docker.rst @@ -1,260 +1,233 @@ .. _docker: -Docker* on |CL| -###################################################### - -|CLOSIA| supports multiple containerization platforms, including Docker*. -|CL| has many `unique features`_ including a minimal default installation -which makes it compelling to use as a host for container workloads, management, and orchestration. - - -This tutorial will go over: - -#. Installing the required bundle for Docker -#. Integration with Clear Containers (optional) -#. Additional Docker* configuration on |CL| -#. Pulling and Running an image from Docker* Hub -#. Creating a Docker* swarm cluster +Run Docker\* on Clear Linux\* +############################# +|CLOSIA| supports multiple containerization platforms, including a Docker\* +solution.|CL| has many `unique features`_ including a minimal default +installation which makes it compelling to use as a host for container +workloads, management, and orchestration. +This tutorial covers: +.. contents:: :local: + :depth: 1 .. note:: - This tutorial focuses on the installaton of the Docker* ecosystem. - If you want to use |CL| as a Docker* container image, - refer to the official `|CL| image on Docker* Hub`_ and `building a custom Clear Linux docker image`_ . - + + This tutorial focuses on the installaton of the Docker ecosystem. + If you want to use |CL| as a Docker container image, refer to the + official `Clear Linux image on Docker Hub`_ + and `building a custom Clear Linux docker image`_ . Prerequisites -============= +************* -* You have a basic understanding of Linux and Docker. +* Basic understanding of Linux and Docker. -* You have successfully installed - :ref:`Clear Linux on bare metal` +* Successful completion: :ref:`bare-metal-install` -* Your |CL| installation has transparent network access to the Internet. +* |CL| environment that has transparent network access to the Internet. If you are behind a HTTP proxy server, in a corporate setting for example, - please refer to the `Docker* proxy instructions`_ . + please refer to the `Docker proxy instructions`_ . - | - | - | +Install the containers-basic bundle +*********************************** +Software in |CL| is offered in the form of `bundles`_ to provide a +complete function. The *containers-basic* provides all the required software +packages to run Docker images as containers. -Installing the required bundle -=============================== +#. First, install the *containers-basic* bundle by running this + :command:`swupd` command: -Software in Clear Linux is offered in the form -of `bundles`_ to provide a complete function. -The *containers-basic* provides all the required software packages to run Docker images as containers. + .. code-block:: bash -#. First, install the *containers-basic* bundle by running this :command:`swupd` command: + sudo swupd bundle-add containers-basic - .. code-block:: bash +#. Start the Docker daemon through systemd manager by running this command: - sudo swupd bundle-add containers-basic + .. code-block:: bash + sudo systemctl start docker -#. Start the Docker* daemon through systemd manager by running this command: + If you want Docker to start automatically on boot, enable the + systemd service by running this command: - .. code-block:: bash - - sudo systemctl start docker - - - If you want Docker* to start automatically on boot, also enable the systemd service by running this command: - - .. code-block:: bash - - sudo systemctl enable docker + .. code-block:: bash + sudo systemctl enable docker #. Finally, verify :command:`docker` has been installed by running this - command and checking the version output for both *client* and *server*: + command and checking the version output for both *client* and *server*: - .. code-block:: bash + .. code-block:: bash - sudo docker version - - -Congratulations! At this point, you have a working installation of Docker* on |CL| and are ready to start using container images on your system. - - | - | - | + sudo docker version +Congratulations! At this point, you have a working installation of Docker +on |CL|. You are ready to start using container images on your system. Integration with Clear Containers (optional) -============================================ +******************************************** -`Clear Containers`_, -is an open source project -aiming to increase security of containers by using a -hardware-backed virtual machine container runtime, -instead of software namespace containers -that are provided by the standard Docker *runc* runtime. +`Clear Containers`_, is an open source project aiming to increase security +of containers by using a hardware-backed virtual machine container runtime, +instead of software namespace containers that are provided by the standard +Docker *runc* runtime. -The Docker* package from |CL| will automatically use the *cc-runtime* required for Clear Containers if it is available on your Clear Linux system. +The Docker package from |CL| will automatically use the *cc-runtime* +required for Clear Containers if it is available on your Clear Linux system. -#. You can take advantage of Clear Containers in |CL| by simply installing the *containers-virt* bundle by running the command below: +#. To take advantage of Clear Containers in |CL|, install the + *containers-virt* bundle by running this command: - .. code-block:: bash + .. code-block:: bash - sudo swupd bundle-add containers-virt + sudo swupd bundle-add containers-virt -#. Restart the Docker* daemon through systemd manager by running this command: +#. Restart the Docker daemon through systemd manager by running this command: - .. code-block:: bash + .. code-block:: bash - sudo systemctl restart docker + sudo systemctl restart docker -#. After restarting, the Docker* daemon - will seamlessly use Clear Containers to launch containers. - You can see the runtime has changed to :command:`cc-runtime` - by running this command: +#. After restarting, the Docker daemon will seamlessly use Clear Containers + to launch containers. You can see the runtime has changed to + :command:`cc-runtime` by running this command: - .. code-block:: bash + .. code-block:: bash - sudo docker info | grep Runtime + sudo docker info | grep Runtime -#. You should see the following output - indicating the *cc-runtime* is the Default Runtime: +#. You should see the following output indicating the *cc-runtime* is the + Default Runtime: - .. code-block:: bash + .. code-block:: console - Runtimes: cc-runtime runc - Default Runtime: cc-runtime + Runtimes: cc-runtime runc + Default Runtime: cc-runtime -Congratulations! At this point, you have successfully replaced the default container runtime with Clear Containers. - -| -| -| +Congratulations! At this point, you have successfully replaced the default +container runtime with Clear Containers. .. note:: - The proceeding sections of this tutorial are standard to Docker* setup and configuration. - If you are familiar with Docker basics, you do not need to continue reading. The following sections are provided here for sake of completeness. - + The proceeding sections of this tutorial are standard to Docker setup + and configuration. If you are familiar with Docker basics, you do not + need to continue reading. The following sections are provided here for + sake of completeness. Additional Docker configuration -=============================== - -Additional Docker* daemon configuration done can be via a -configuration file typically located at :file:`/etc/docker/daemon.json` . -|CL| features a `stateless system`_ so the configuration file :file:`daemon.json` will *NOT* exist by default. +******************************* +Perform additional Docker daemon configuration via a configuration file +typically located at :file:`/etc/docker/daemon.json`. |CL| features a +`stateless system`_ so the configuration file :file:`daemon.json` does *NOT* +exist by default. #. Create the :file:`daemon.json` by running this command: - .. code-block:: bash + .. code-block:: bash - touch /etc/docker/daemon.json + touch /etc/docker/daemon.json - Refer to the `Docker* documentation on daemon configuration`_ for the - full list of available configuration options and examples. + .. note:: + + Refer to the `Docker documentation on daemon configuration`_ for the + full list of available configuration options and examples. #. Once you've made any required changes, be sure to restart the - Docker* daemon through systemd manager by running this command: + Docker daemon through systemd manager by running this command: - .. code-block:: bash + .. code-block:: bash - sudo systemctl restart docker + sudo systemctl restart docker +Pulling and Running an image from Docker Hub +******************************************** - | - | - | +`Docker Hub`_ is a publically available container image repository which +comes preconfigured with Docker. In the example below we will pull and run +an the official Docker image for nginx, an open source reverse proxy server. +#. First, pull a container image from Docker Hub using the + :command:`docker pull` command. Download the latest nginx Docker + container image by running this command: -Pulling and Running an image from Docker* Hub -============================================= -`Docker* Hub`_ is a publically available container image repository -which comes preconfigured with Docker*. -In the example below we will pull and run an the official Docker image for nginx, an open source reverse proxy server. + .. code-block:: bash + sudo docker pull nginx -#. First, Pull a container image from Docker* Hub using the :command:`docker pull` command. Download the latest nginx Docker container image by running this command: +#. Create and launch a new container using the :command:`docker run` + command. Launch a nginx container by running this command: - .. code-block:: bash + .. code-block:: bash - sudo docker pull nginx + sudo docker run --name test-nginx -d -p 8080:80 nginx - -#. Create and launch a new container using the :command:`docker run` command. - Launch a nginx container by running this command: - - .. code-block:: bash - - sudo docker run --name test-nginx -d -p 8080:80 nginx - - .. note:: + .. note:: - Below is an explaination of switches used in the command above. For detailed :command:`docker run` switches and syntax, refer to the `Docker* Documentation`_ . + Below is an explaination of switches used in the command above. For + detailed :command:`docker run` switches and syntax, refer to the + `Docker Documentation`_ . - * The :option:`--name` switch lets you provide a friendly name to target the container for future operations + * The :option:`--name` switch lets you provide a friendly name to + target the container for future operations - * The :option:`-d` switch launches the container in the background + * The :option:`-d` switch launches the container in the background - * The :option:`-p` switch allows the container's HTTP port (80) to be accessible from the Clear Linux host on port 8080 + * The :option:`-p` switch allows the container's HTTP port (80) to be + accessible from the Clear Linux host on port 8080 +#. You can access the Welcome to Nginx! splash page running in the container + by browsing to http://127.0.0.1:8080 or by running this :command:`curl` + command from your Clear Linux machine: -#. You can access the Welcome to Nginx! splash page running in the container by browsing to http://127.0.0.1:8080 or by running this :command:`curl` command from your Clear Linux machine: - - .. code-block:: bash - - curl 127.0.0.1:8080 + .. code-block:: bash + curl 127.0.0.1:8080 #. Finally, stop and delete the nginx container by running the :command:`docker stop` and :command:`docker rm` commands. - .. code-block:: bash + .. code-block:: bash - sudo docker stop test-nginx - sudo docker rm test-nginx + sudo docker stop test-nginx + sudo docker rm test-nginx +Congratulations! At this point, you have successfully pulled a nginx +container image from `Docker Hub`_ and ran an example container. -Congratulations! At this point, you have successfully pulled a nginx container image from `Docker* Hub`_ and ran an example container. - - | - | - | +Creating a Docker swarm cluster +******************************* -Creating a Docker* swarm cluster -================================ -Clusters of Docker* hosts are referred to as swarms. +Clusters of Docker hosts are referred to as swarms. -The process in this tutorial can be repeated to install Docker* -on multiple Clear Linux hosts with the intent to form a Docker* swarm cluster. +The process in this tutorial can be repeated to install Docker on multiple +Clear Linux hosts with the intent to form a Docker swarm cluster. -The `Docker* documentation on swarm key concepts`_ and -`Docker* documentation on creating a swarm`_ can be referenced +The `Docker documentation on swarm key concepts`_ and +`Docker documentation on creating a swarm`_ can be referenced for further instructions on setting up a swarm. - Also see: -========= -* `Docker* Home`_ -* `Docker* Documentation`_ -* `Docker* Hub`_ +--------- +* `Docker Home`_ +* `Docker Documentation`_ +* `Docker Hub`_ * `Clear Containers`_ - - - .. _`unique features`: https://clearlinux.org/features -.. _`|CL| image on Docker* Hub`: https://hub.docker.com/_/clearlinux/ +.. _`Clear Linux image on Docker Hub`: https://hub.docker.com/_/clearlinux/ .. _`building a custom Clear Linux docker image`: https://clearlinux.org/documentation/clear-linux/guides/network/custom-clear-container -.. _`Docker* proxy instructions`: https://docs.docker.com/config/daemon/systemd/#httphttps-proxy +.. _`Docker proxy instructions`: https://docs.docker.com/config/daemon/systemd/#httphttps-proxy .. _`bundles`: https://clearlinux.org/documentation/clear-linux/concepts/bundles-about#related-concepts .. _`stateless system`: https://clearlinux.org/features/stateless -.. _`Docker* documentation on daemon configuration`: https://docs.docker.com/engine/reference/commandline/dockerd/#daemon-configuration-file +.. _`Docker documentation on daemon configuration`: https://docs.docker.com/engine/reference/commandline/dockerd/#daemon-configuration-file .. _`Clear Containers`: https://github.com/clearcontainers -.. _`Docker* Home`: https://www.docker.com/ -.. _`Docker* Documentation`: https://docs.docker.com/ -.. _`Docker* Hub`: https://hub.docker.com/ -.. _`Docker* documentation on swarm key concepts`: https://docs.docker.com/engine/swarm/key-concepts/ -.. _`Docker* documentation on creating a swarm`: https://docs.docker.com/engine/swarm/swarm-tutorial/create-swarm/ - +.. _`Docker Home`: https://www.docker.com/ +.. _`Docker Documentation`: https://docs.docker.com/ +.. _`Docker Hub`: https://hub.docker.com/ +.. _`Docker documentation on swarm key concepts`: https://docs.docker.com/engine/swarm/key-concepts/ +.. _`Docker documentation on creating a swarm`: https://docs.docker.com/engine/swarm/swarm-tutorial/create-swarm/ diff --git a/source/clear-linux/tutorials/tutorials.rst b/source/clear-linux/tutorials/tutorials.rst index 3cbb1f17..34f0d9a0 100644 --- a/source/clear-linux/tutorials/tutorials.rst +++ b/source/clear-linux/tutorials/tutorials.rst @@ -12,6 +12,7 @@ specific |CLOSIA| use cases. wordpress flatpak/flatpak machine-learning/machine-learning + docker/docker azure/azure multi-boot/multi-boot hadoop From 746bef2d0d332b2c16bc056ca29103b31d3f0ef1 Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Thu, 21 Jun 2018 13:53:20 -0700 Subject: [PATCH 30/63] Add second level headers --- .../increase-virtual-disk-size.rst | 53 +++++++++++++------ 1 file changed, 38 insertions(+), 15 deletions(-) diff --git a/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst b/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst index 5c87482c..005d436b 100644 --- a/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst +++ b/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst @@ -1,40 +1,51 @@ .. _increase-virtual-disk-size: -Increase Clear Linux image virtual disk size -############################################ +Increase virtual disk size of a Clear Linux image +################################################# Prebuilt |CLOSIA| images come in different sizes, ranging from 300 MB to 20 GB. This guide describes how to increase the size of your prebuilt |CL| image if you need more capacity. -Determine the prebuilt image size -********************************* +.. contents:: This guide will cover: + + +Determine the partition sizes of the prebuilt image +*************************************************** There are two methods to find the virtual disk size of your prebuilt |CL| image. +In both examples, the prebuilt Hyper-V image used starting off at about 8.5 GB +with /dev/sdd3 being the partition + + +Checking :command:`lsblk` on the VM +----------------------------------- + The first method is to boot up your :abbr:`VM (Virtual Machine)` and execute the :command:`lsblk` command as shown below: -.. code-block:: bash + .. code-block:: bash - sudo lsblk + sudo lsblk An example output of the :command:`lsblk` command: -.. code-block:: console + .. code-block:: console - NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT - sda 8:0 0 8.5G 0 disk - ├─sdd1 8:1 0 512M 0 part - ├─sdd2 8:2 0 32M 0 part [SWAP] - └─sdd3 8:3 0 8G 0 part / - -In this example, both methods show the prebuilt Hyper-V image is about 8.5 GB. + NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT + sda 8:0 0 8.5G 0 disk + ├─sdd1 8:1 0 512M 0 part + ├─sdd2 8:2 0 32M 0 part [SWAP] + └─sdd3 8:3 0 8G 0 part / -The second method is to check the config.JSON file of the image, located in the + +Checking :file:`config.json` used to build the image +---------------------------------------------------- +The second method is to check the :file:`config.json` file used to create prebuilt image, located in the `releases`_ repository. For example, to find the size of the Hyper-V\* image version number 20450, follow these steps: @@ -65,12 +76,20 @@ version number 20450, follow these steps: Increase virtual disk size ************************** +Power off VM and increase virtual disk size: +-------------------------------------------- + To increase the virtual disk size for a prebuilt image, perform the steps below: #. Shut down your VM if it is running. #. Use an appropriate hypervisor tool to increase the virtual disk size of your VM. #. Power up the VM. + + +Resize the partition of the virtual disk: +----------------------------------------- + #. Log in to an account with root privileges. #. Open a terminal emulator. #. Add the |CL| `storage-utils` bundle to install the `parted` and @@ -114,6 +133,10 @@ To increase the virtual disk size for a prebuilt image, perform the steps below: #. Enter :command:`q` to exit `parted` when you are finished resizing the image. + +Resize the filesytem +-------------------- + #. Enter :command:`sudo resize2fs -p /dev/[modified partition name]` where *[modified partition name]* is the partition that was changed in `parted`. From 54cfae7152335e3d51ab5f2e714fec3d81542e30 Mon Sep 17 00:00:00 2001 From: Michael Vincerra Date: Thu, 21 Jun 2018 13:55:49 -0700 Subject: [PATCH 31/63] Corrects Sphinx syntax, URL; and prepends commands with sudo. Signed-off-by: Michael Vincerra --- .../clear-linux/reference/bundle-commands.rst | 36 ++++++++----------- 1 file changed, 15 insertions(+), 21 deletions(-) diff --git a/source/clear-linux/reference/bundle-commands.rst b/source/clear-linux/reference/bundle-commands.rst index 849c42c5..81c8edd8 100644 --- a/source/clear-linux/reference/bundle-commands.rst +++ b/source/clear-linux/reference/bundle-commands.rst @@ -3,51 +3,45 @@ Useful bundle commands ###################### - - To see a list of currently installed bundles, enter: - :command:`swupd` :option:`bundle-list` +.. code-block:: bash + sudo swupd bundle-list To see the list of all available bundles, enter: - :command:`swupd` :option:`bundle-list --all` +.. code-block:: bash + sudo swupd bundle-list --all - Alternatively, you may reference the `available bundle list`_ webpage. - +Alternatively, you may reference the `available bundle list`_ webpage. To search for bundles and their contents, enter: - .. code-block:: console - - # swupd search [bundle name] +.. code-block:: bash + sudo swupd search [bundle name] To add a bundle, enter: - .. code-block:: console - - # swupd bundle-add [bundle name] - - +.. code-block:: bash + sudo swupd bundle-add [bundle name] Additional information ====================== For additional :command:`swupd` commands, enter: - .. code-block:: console +.. code-block:: bash - # swupd --help + swupd --help -or reference the :command:`swupd` man page, enter: +To reference the :command:`swupd` man page, enter: - .. code-block:: console +.. code-block:: bash - # man swupd + man swupd - -.. _available bundle list: https://clearlinux.org/documentation/clear-linux/reference/bundles/available-bundles#bundle-list +.. _available bundle list: https://clearlinux.org/documentation/clear-linux/reference/bundles/available-bundles From b8af0eb051a5c1c5d5c72d7d7287a51409d211e5 Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Fri, 22 Jun 2018 10:36:26 -0700 Subject: [PATCH 32/63] Split figure into two and minor clarifications --- .../figures/increase-virtual-disk-size-1.png | Bin 32439 -> 22657 bytes .../figures/increase-virtual-disk-size-2.png | Bin 0 -> 11026 bytes .../increase-virtual-disk-size.rst | 155 ++++++++++-------- 3 files changed, 87 insertions(+), 68 deletions(-) create mode 100644 source/clear-linux/guides/maintenance/figures/increase-virtual-disk-size-2.png diff --git a/source/clear-linux/guides/maintenance/figures/increase-virtual-disk-size-1.png b/source/clear-linux/guides/maintenance/figures/increase-virtual-disk-size-1.png index db5a2f3f413ead2268e9a55c7c053d6e3831f4e4..a4692c9affcf3f1040252b177910d34bd7aba681 100755 GIT binary patch literal 22657 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 W?YdTw_!{!-?|1EeNA~s~|Mb6RM4_1g literal 0 HcmV?d00001 diff --git a/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst b/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst index 005d436b..755a327f 100644 --- a/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst +++ b/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst @@ -10,14 +10,15 @@ if you need more capacity. .. contents:: This guide will cover: -Determine the partition sizes of the prebuilt image +Determine the partition order and sizes of the prebuilt image *************************************************** -There are two methods to find the virtual disk size of your prebuilt |CL| +There are two methods to find the order and sizes of partitions virtual disk of your prebuilt |CL| image. -In both examples, the prebuilt Hyper-V image used starting off at about 8.5 GB -with /dev/sdd3 being the partition +In both examples, the prebuilt Hyper-V image +has a disk size of 8.5 GB with /dev/sdd3 being the partition +for the root filesystem (/) Checking :command:`lsblk` on the VM @@ -26,26 +27,28 @@ Checking :command:`lsblk` on the VM The first method is to boot up your :abbr:`VM (Virtual Machine)` and execute the :command:`lsblk` command as shown below: - .. code-block:: bash + .. code-block:: bash - sudo lsblk + sudo lsblk An example output of the :command:`lsblk` command: - .. code-block:: console - - NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT - sda 8:0 0 8.5G 0 disk - ├─sdd1 8:1 0 512M 0 part - ├─sdd2 8:2 0 32M 0 part [SWAP] - └─sdd3 8:3 0 8G 0 part / + .. code-block:: console + NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT + sda 8:0 0 8.5G 0 disk + ├─sdd1 8:1 0 512M 0 part + ├─sdd2 8:2 0 32M 0 part [SWAP] + └─sdd3 8:3 0 8G 0 part / +An example of this can also be seen in Figure 1. Checking :file:`config.json` used to build the image ---------------------------------------------------- -The second method is to check the :file:`config.json` file used to create prebuilt image, located in the + +The second method to determine partition to check the :file:`config.json` +file used to create prebuilt image, located in the `releases`_ repository. For example, to find the size of the Hyper-V\* image version number 20450, follow these steps: @@ -53,101 +56,117 @@ version number 20450, follow these steps: #. Drill down into the `20450 > clear > config > image` directory. #. Open the :file:`hyperv-config.json` file. #. Locate the `PartitionLayout` key. - The example shows 512 MB for the EFI partition, 32 MB for the swap - partition, and 8 GB for the root partition. - .. code-block:: console + The example shows 512 MB for the EFI partition, 32 MB for the swap + partition, and 8 GB for the root partition. - "PartitionLayout" : [ { "disk" : "hyperv.img", - "partition" : 1, - "size" : "512M", - "type" : "EFI" }, - { "disk" : "hyperv.img", - "partition" : 2, - "size" : "32M", - "type" : "swap" }, - { "disk" : "hyperv.img", - "partition" : 3, - "size" : "8G", - "type" : "linux" } ], + + .. code-block:: console + + "PartitionLayout" : [ { "disk" : "hyperv.img", + "partition" : 1, + "size" : "512M", + "type" : "EFI" }, + { "disk" : "hyperv.img", + "partition" : 2, + "size" : "32M", + "type" : "swap" }, + { "disk" : "hyperv.img", + "partition" : 3, + "size" : "8G", + "type" : "linux" } ], Increase virtual disk size ************************** +Once you have determined the disk and partition to be increased, you are ready to perform the actual increase. + Power off VM and increase virtual disk size: -------------------------------------------- To increase the virtual disk size for a prebuilt image, perform the steps below: -#. Shut down your VM if it is running. -#. Use an appropriate hypervisor tool to increase the virtual disk size of - your VM. -#. Power up the VM. +#. Shut down your VM if it is running. +#. Use the process defined by your hypervisor to + increase the virtual disk size of your |CL| VM. +#. Power up the VM. Resize the partition of the virtual disk: ----------------------------------------- -#. Log in to an account with root privileges. -#. Open a terminal emulator. -#. Add the |CL| `storage-utils` bundle to install the `parted` and - `resize2fs` tools. +#. Log in to an account with root privileges. +#. Open a terminal emulator. +#. Add the |CL| `storage-utils` bundle to install the :command:`parted` and :command:`resize2fs` tools. - .. code-block:: bash + .. code-block:: bash - sudo swupd bundle-add storage-utils + sudo swupd bundle-add storage-utils #. Launch the `parted` tool. - .. code-block:: bash + .. code-block:: bash - sudo parted + sudo parted #. In the `parted` tool, perform these steps: - #. Press :command:`p` to print the partitions table. - #. If the warning message below is displayed, enter :command:`Fix`. + #. Press :command:`p` to print the partitions table. + #. If the warning message below is displayed, enter :command:`Fix`. - .. code-block:: console + .. code-block:: console - Warning: Not all of the space available to /dev/sda appears to be - used, you can fix the GPT to use all of the space (an extra ... - blocks) or continue with the current setting? + Warning: Not all of the space available to /dev/sda appears to be + used, you can fix the GPT to use all of the space (an extra ... + blocks) or continue with the current setting? - Fix/Ignore? + Fix/Ignore? - #. Enter :command:`resizepart [partition number]` where - *[partition number]* is the partition number to modify. - #. Enter :command:`yes` when prompted. - #. Enter the new `End` size. + #. Enter :command:`resizepart [partition number]` where + *[partition number]* is the partition number of the partition to modify. + #. Enter :command:`yes` when prompted. + #. Enter the new `End` size. - .. note:: + .. note:: - If you want a partition to take up the remaining disk space, then - enter the total size of the disk. When you print the partitions - table with the :command:`p` command, the total disk size is shown - after the `Disk` label. + If you want a partition to take up the remaining disk space, then + enter the total size of the disk. When you print the partitions + table with the :command:`p` command, the total disk size is shown + after the `Disk` label. - #. Enter :command:`q` to exit `parted` when you are finished resizing the - image. + An example of this can be seen in Figure 1. + + + + #. Enter :command:`q` to exit `parted` when you are finished resizing the + image. + + +Figure 1 depicts the described steps to resize the partition of the virtual disk from 8.5GB to 20GB. + +.. figure:: figures/increase-virtual-disk-size-1.png + :scale: 100 % + :alt: Increase root partition size + + Figure 1: Increase root partition size. Resize the filesytem -------------------- -#. Enter :command:`sudo resize2fs -p /dev/[modified partition name]` where - *[modified partition name]* is the partition that was changed in `parted`. +#. Enter :command:`sudo resize2fs -p /dev/[modified partition name]` where + *[modified partition name]* is the partition that was changed in `parted`. -Figure 1 shows how to increase the size of a |CL| Hyper-V image from 8.5 -GB to 20 GB. Before the steps shown in Figure 1, we used the Hyper-V Manager -to increase the VM virtual disk size from 8.5 GB to 20 GB. +#. Run the :command:`df -h` to verify that the filesystem size has increased. -.. figure:: figures/increase-virtual-disk-size-1.png - :scale: 100 % - :alt: Increase root partition size example +Figure 2 depicts the described steps to resize the partition of the virtual disk from 8.5GB to 20GB. - Figure 1: Increase root partition size example. +.. figure:: figures/increase-virtual-disk-size-2.png + :scale: 100 % + :alt: Increase root filesystem with resize2fs + + Figure 2: Increase root filesystem size after partition has been expanded. .. _releases: https://download.clearlinux.org/releases/ From 63a862b615f73e9060dccec1f46f654a73e1f357 Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Mon, 25 Jun 2018 10:33:42 -0700 Subject: [PATCH 33/63] Minor formatting and clarifications. --- .../increase-virtual-disk-size.rst | 42 ++++++++++--------- 1 file changed, 23 insertions(+), 19 deletions(-) diff --git a/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst b/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst index 755a327f..76765100 100644 --- a/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst +++ b/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst @@ -3,7 +3,7 @@ Increase virtual disk size of a Clear Linux image ################################################# -Prebuilt |CLOSIA| images come in different sizes, ranging from 300 MB to 20 +|CLOSIA| prebuilt images come in different sizes, ranging from 300 MB to 20 GB. This guide describes how to increase the size of your prebuilt |CL| image if you need more capacity. @@ -47,7 +47,7 @@ An example of this can also be seen in Figure 1. Checking :file:`config.json` used to build the image ---------------------------------------------------- -The second method to determine partition to check the :file:`config.json` +The second method to determine partition to check the :file:`config.json` file used to create prebuilt image, located in the `releases`_ repository. For example, to find the size of the Hyper-V\* image version number 20450, follow these steps: @@ -80,7 +80,7 @@ version number 20450, follow these steps: Increase virtual disk size ************************** -Once you have determined the disk and partition to be increased, you are ready to perform the actual increase. +Once you have determined the disk and partition to be increased, you are ready to perform the actual increase of the disk, partition, and filesystem. Power off VM and increase virtual disk size: @@ -89,8 +89,9 @@ Power off VM and increase virtual disk size: To increase the virtual disk size for a prebuilt image, perform the steps below: #. Shut down your VM if it is running. -#. Use the process defined by your hypervisor to - increase the virtual disk size of your |CL| VM. +#. Use the process defined by your hypervisor + or cloud provider to increase + the virtual disk size of your |CL| VM. #. Power up the VM. @@ -144,29 +145,32 @@ Resize the partition of the virtual disk: image. -Figure 1 depicts the described steps to resize the partition of the virtual disk from 8.5GB to 20GB. + Figure 1 depicts the described steps to resize the partition of the virtual disk from 8.5GB to 20GB. -.. figure:: figures/increase-virtual-disk-size-1.png - :scale: 100 % - :alt: Increase root partition size + .. figure:: figures/increase-virtual-disk-size-1.png + :scale: 100 % + :alt: Increase root partition size - Figure 1: Increase root partition size. + Figure 1: Increase root partition size. Resize the filesytem -------------------- -#. Enter :command:`sudo resize2fs -p /dev/[modified partition name]` where - *[modified partition name]* is the partition that was changed in `parted`. + #. Enter :command:`sudo resize2fs -p /dev/[modified partition name]` where + *[modified partition name]* is the partition that was changed in `parted`. -#. Run the :command:`df -h` to verify that the filesystem size has increased. + #. Run the :command:`df -h` to verify that the filesystem size has increased. -Figure 2 depicts the described steps to resize the partition of the virtual disk from 8.5GB to 20GB. + Figure 2 depicts the described steps to resize the partition of the virtual disk from 8.5GB to 20GB. -.. figure:: figures/increase-virtual-disk-size-2.png - :scale: 100 % - :alt: Increase root filesystem with resize2fs + .. figure:: figures/increase-virtual-disk-size-2.png + :scale: 100 % + :alt: Increase root filesystem with resize2fs - Figure 2: Increase root filesystem size after partition has been expanded. + Figure 2: Increase root filesystem size after partition has been expanded. -.. _releases: https://download.clearlinux.org/releases/ + .. _releases: https://download.clearlinux.org/releases/ + + +Congratulations! You have resized the disk, partition, and filesystem. At this point, the increase in disk capacity is usable. \ No newline at end of file From be55e1bcf569beae0a3bb85edb0ed0a70712e1b0 Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Mon, 25 Jun 2018 11:32:44 -0700 Subject: [PATCH 34/63] Add reference back to VMware player install. --- .../vmware-esxi-preconfigured-cl-image.rst | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst b/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst index 92dcf185..75b67d8f 100644 --- a/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst +++ b/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst @@ -5,7 +5,7 @@ Run preconfigured Clear Linux image as a VMware\* ESXi guest OS `VMware ESXi`_ is a type 1 bare-metal hypervisor which runs directly on top of server hardware. With VMware ESXi, you can create, configure, manage, -and run |CLOSIA| virtual machines in the cloud. +and run |CLOSIA| virtual machines at scale. This section shows you how to deploy a preconfigured |CL| VMware image on VMware ESXi 6.5 Update 1 using these steps: @@ -18,14 +18,18 @@ VMware ESXi 6.5 Update 1 using these steps: #. Create and configure a new VM. #. Power on the VM and boot |CL|. -If you would prefer to perform a fresh installation of |CL| into a new VMware +If you would prefer to perform a manual installation of |CL| into a new VMware ESXi :abbr:`VM (Virtual Machine)` instead, see :ref:`vmware-esxi-install-cl`. +Visit :ref:`image-types` to learn more about the available images. + + .. note:: VMware also offers a type 2 hypervisor called `VMware Workstation Player`_ which is designed for the desktop environment. + See :ref:`vmw-player-preconf` or see :ref:`vmw-player`. + -Visit :ref:`image-types` to learn more about the available images. Download the latest Clear Linux VMware image ******************************************** From f014bc5c0112102e6290d74a54738bd7ac45c1b3 Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Mon, 25 Jun 2018 11:47:22 -0700 Subject: [PATCH 35/63] Change to ToC directive with page anchors --- .../vmware-esxi-preconfigured-cl-image.rst | 16 +++++----------- 1 file changed, 5 insertions(+), 11 deletions(-) diff --git a/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst b/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst index 75b67d8f..b149e4fd 100644 --- a/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst +++ b/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst @@ -8,19 +8,10 @@ of server hardware. With VMware ESXi, you can create, configure, manage, and run |CLOSIA| virtual machines at scale. This section shows you how to deploy a preconfigured |CL| VMware image on -VMware ESXi 6.5 Update 1 using these steps: - -#. Download the latest Clear Linux VMware image. -#. Verify the integrity of the |CL| image. -#. Uncompress the |CL| image. -#. Upload the Clear Linux image to the VMware server. -#. Convert the Clear Linux image to an ESXi-supported format. -#. Create and configure a new VM. -#. Power on the VM and boot |CL|. +VMware ESXi 6.5. If you would prefer to perform a manual installation of |CL| into a new VMware ESXi :abbr:`VM (Virtual Machine)` instead, see :ref:`vmware-esxi-install-cl`. - Visit :ref:`image-types` to learn more about the available images. @@ -30,6 +21,9 @@ Visit :ref:`image-types` to learn more about the available images. See :ref:`vmw-player-preconf` or see :ref:`vmw-player`. +.. contents:: + :depth: 2 + Download the latest Clear Linux VMware image ******************************************** @@ -243,7 +237,7 @@ After configuring the settings above, power on the VM. Figure 13: VMware ESXi - Navigator > Virtual Machines > Power on VM Also see: -********* +--------- * :ref:`vmware-esxi-install-cl` From 371b823e2ebb1c4856e582252e524a69daa93996 Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Mon, 25 Jun 2018 14:06:52 -0700 Subject: [PATCH 36/63] Recommend using vMA and add VMware doc references vMA is the official recommendation from VMware for running vmkfstools. --- .../vmware-esxi-preconfigured-cl-image.rst | 42 +++++++++++++++---- 1 file changed, 35 insertions(+), 7 deletions(-) diff --git a/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst b/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst index b149e4fd..5e8fcbf0 100644 --- a/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst +++ b/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst @@ -28,7 +28,7 @@ Visit :ref:`image-types` to learn more about the available images. Download the latest Clear Linux VMware image ******************************************** -Get the latest |CL| VMware image from the `image`_ repository. +Get the latest |CL| VMware prebuilt image from the `image`_ repository. Look for :file:`clear-[version number]-vmware.vmdk.xz`. You can also use this command: @@ -48,10 +48,17 @@ For alternative instructions on other operating systems, see: Upload the Clear Linux image to the VMware server ************************************************* -#. Connect to the VMware server and login to an account with sufficient +Once the |CL| VMware prebuilt image has been downloaded and uncompressed on your local system, +it must be uploaded to a datastore on the VMware ESXi server. + +The steps in this section can also be referenced from the `VMware documentation on Using the Datastore File Browser`_ + +#. Connect to the VMware ESXi server and login to an account with sufficient permission to create and manage VMs. -#. Under the :guilabel:`Navigator` window, select :guilabel:`Storage`. - See Figure 1. + +#. Under the :guilabel:`Navigator` window on the left side, select :guilabel:`Storage`. + See Figure 1 + #. Under the :guilabel:`Datastores` tab, click the :guilabel:`Datastore browser` button. @@ -85,14 +92,28 @@ Upload the Clear Linux image to the VMware server Convert the Clear Linux image to an ESXi-supported format ********************************************************* -#. SSH into the VMware server and login to an account with root privileges. -#. Locate the uploaded image, which is typically found in `/vmfs/volumes/datastore1`. +Once the |CL| VMware prebuilt image has been uploaded to the VMware ESXi datastore, +it must be converted to a format for usable with VMware's ESXi hypervisor. + +The steps in this section can also be referenced from the `VMware documentation on Cloning and converting virtual machine disks with vmkfstools`_ + +#. SSH into the `vSphere Management Assistant`_ appliance that is managing the ESXi host. + + .. note:: + If there is no :abbr:`vMA (vSphere Management Assistant)` appliance configured and available, you can temporarily enable SSH directly on the ESXi host by referencing + the `VMware documentation on Enable the Secure Shell (SSH)`_ . + + As a security best practice, remember to disable SSH access after following the steps in this section. + + +#. Locate the uploaded image, which is typically found in :file:`/vmfs/volumes/datastore1`. + #. Use the :command:`vmkfstools` command to perform the conversion, as shown below: .. code-block:: console - # vmkfstools -i clear-[version number]-vmware.vmdk -d zeroedthick clear-[version number]-esxi.vmdk + vmkfstools -i clear-[version number]-vmware.vmdk -d zeroedthick clear-[version number]-esxi.vmdk Two files should result from this: @@ -102,6 +123,8 @@ Convert the Clear Linux image to an ESXi-supported format The :file:`clear-[version number]-esxi.vmdk` file will be used in the next section when you create a new VM. + + Create and configure a new VM ***************************** @@ -242,5 +265,10 @@ Also see: * :ref:`vmware-esxi-install-cl` .. _VMware ESXi: https://www.vmware.com/products/esxi-and-esx.html +.. _`VMware documentation on Using the Datastore File Browser`: https://docs.vmware.com/en/VMware-vSphere/6.7/com.vmware.vsphere.html.hostclient.doc/GUID-7533A767-8396-4844-A3F2-206047D254EA.html +.. _`vSphere Management Assistant appliance`: https://www.vmware.com/support/developer/vima/ +.. _`VMware documentation on Cloning and converting virtual machine disks with vmkfstools`: https://kb.vmware.com/kb/1028042 +.. _`VMware documentation on Enable the Secure Shell (SSH)`: https://docs.vmware.com/en/VMware-vSphere/6.7/com.vmware.vsphere.html.hostclient.doc/GUID-B649CB74-832F-467B-B6A4-8BA67AD5C1F0.html +.. _`VMware documentation on General ESXi Security Recommendations`: https://docs.vmware.com/en/VMware-vSphere/6.7/com.vmware.vsphere.security.doc/GUID-B39474AF-6778-499A-B8AB-E973BE6D4899.html .. _VMware Workstation Player: https://www.vmware.com/products/workstation-player.html .. _image: https://download.clearlinux.org/image From fcc3d3095cc2b26583245189d8950016b3c9a690 Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Mon, 25 Jun 2018 14:08:51 -0700 Subject: [PATCH 37/63] Fix broken link reference --- .../vmware-esxi-preconfigured-cl-image.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst b/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst index 5e8fcbf0..82c4edf4 100644 --- a/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst +++ b/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst @@ -266,7 +266,7 @@ Also see: .. _VMware ESXi: https://www.vmware.com/products/esxi-and-esx.html .. _`VMware documentation on Using the Datastore File Browser`: https://docs.vmware.com/en/VMware-vSphere/6.7/com.vmware.vsphere.html.hostclient.doc/GUID-7533A767-8396-4844-A3F2-206047D254EA.html -.. _`vSphere Management Assistant appliance`: https://www.vmware.com/support/developer/vima/ +.. _`vSphere Management Assistant`: https://www.vmware.com/support/developer/vima/ .. _`VMware documentation on Cloning and converting virtual machine disks with vmkfstools`: https://kb.vmware.com/kb/1028042 .. _`VMware documentation on Enable the Secure Shell (SSH)`: https://docs.vmware.com/en/VMware-vSphere/6.7/com.vmware.vsphere.html.hostclient.doc/GUID-B649CB74-832F-467B-B6A4-8BA67AD5C1F0.html .. _`VMware documentation on General ESXi Security Recommendations`: https://docs.vmware.com/en/VMware-vSphere/6.7/com.vmware.vsphere.security.doc/GUID-B39474AF-6778-499A-B8AB-E973BE6D4899.html From 79511445b03513c42ed218dd3314831c62d1374f Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Mon, 25 Jun 2018 20:00:14 -0700 Subject: [PATCH 38/63] Fix minor syntax error blocking substitution No space after period was causing |CL| substitution not to expand --- source/clear-linux/tutorials/docker/docker.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/clear-linux/tutorials/docker/docker.rst b/source/clear-linux/tutorials/docker/docker.rst index 75c00e35..4b1200ed 100644 --- a/source/clear-linux/tutorials/docker/docker.rst +++ b/source/clear-linux/tutorials/docker/docker.rst @@ -4,7 +4,7 @@ Run Docker\* on Clear Linux\* ############################# |CLOSIA| supports multiple containerization platforms, including a Docker\* -solution.|CL| has many `unique features`_ including a minimal default +solution. |CL| has many `unique features`_ including a minimal default installation which makes it compelling to use as a host for container workloads, management, and orchestration. From 5d3058169266c8ed018a15b3f8c3ce6381a87b36 Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Tue, 26 Jun 2018 11:47:00 -0700 Subject: [PATCH 39/63] Add vCLI option to connect vMA is being deprecated --- .../vmware-esxi-preconfigured-cl-image.rst | 20 ++++++++++++------- 1 file changed, 13 insertions(+), 7 deletions(-) diff --git a/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst b/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst index 82c4edf4..5f60534e 100644 --- a/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst +++ b/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst @@ -48,15 +48,17 @@ For alternative instructions on other operating systems, see: Upload the Clear Linux image to the VMware server ************************************************* -Once the |CL| VMware prebuilt image has been downloaded and uncompressed on your local system, -it must be uploaded to a datastore on the VMware ESXi server. +Once the |CL| VMware prebuilt image has been downloaded and +uncompressed on your local system, it must be uploaded to a datastore +on the VMware ESXi server. The steps in this section can also be referenced from the `VMware documentation on Using the Datastore File Browser`_ #. Connect to the VMware ESXi server and login to an account with sufficient permission to create and manage VMs. -#. Under the :guilabel:`Navigator` window on the left side, select :guilabel:`Storage`. +#. Under the :guilabel:`Navigator` window on the left side, + select :guilabel:`Storage`. See Figure 1 #. Under the :guilabel:`Datastores` tab, click @@ -97,16 +99,18 @@ it must be converted to a format for usable with VMware's ESXi hypervisor. The steps in this section can also be referenced from the `VMware documentation on Cloning and converting virtual machine disks with vmkfstools`_ -#. SSH into the `vSphere Management Assistant`_ appliance that is managing the ESXi host. +#. SSH into the `vSphere Management Assistant`_ appliance that is managing the ESXi host or connect to the vSphere hosting using the `vSphere CLI`_. .. note:: - If there is no :abbr:`vMA (vSphere Management Assistant)` appliance configured and available, you can temporarily enable SSH directly on the ESXi host by referencing + If there is no :abbr:`vMA (vSphere Management Assistant)` appliance or :abbr:`vCLI (vSphere CLI)` configured and available, + you can temporarily enable SSH directly on the ESXi host by referencing the `VMware documentation on Enable the Secure Shell (SSH)`_ . As a security best practice, remember to disable SSH access after following the steps in this section. -#. Locate the uploaded image, which is typically found in :file:`/vmfs/volumes/datastore1`. +#. Locate the uploaded image, which is typically found in + :file:`/vmfs/volumes/datastore1`. #. Use the :command:`vmkfstools` command to perform the conversion, as shown below: @@ -132,7 +136,8 @@ In this section, you will create a new VM, configure its basic parameters such as number of CPUs, memory size, and then attach the converted |CL| VMware image. Also, in order to boot |CL|, you must enable UEFI support. -#. Under the :guilabel:`Navigator` window, select :guilabel:`Virtual Machines`. See Figure 4. +#. Under the :guilabel:`Navigator` window, select + :guilabel:`Virtual Machines`. See Figure 4. #. In the right window, click the :guilabel:`Create / Register VM` button. @@ -267,6 +272,7 @@ Also see: .. _VMware ESXi: https://www.vmware.com/products/esxi-and-esx.html .. _`VMware documentation on Using the Datastore File Browser`: https://docs.vmware.com/en/VMware-vSphere/6.7/com.vmware.vsphere.html.hostclient.doc/GUID-7533A767-8396-4844-A3F2-206047D254EA.html .. _`vSphere Management Assistant`: https://www.vmware.com/support/developer/vima/ +.. _`vSphere CLI`: https://www.vmware.com/support/developer/vcli/ .. _`VMware documentation on Cloning and converting virtual machine disks with vmkfstools`: https://kb.vmware.com/kb/1028042 .. _`VMware documentation on Enable the Secure Shell (SSH)`: https://docs.vmware.com/en/VMware-vSphere/6.7/com.vmware.vsphere.html.hostclient.doc/GUID-B649CB74-832F-467B-B6A4-8BA67AD5C1F0.html .. _`VMware documentation on General ESXi Security Recommendations`: https://docs.vmware.com/en/VMware-vSphere/6.7/com.vmware.vsphere.security.doc/GUID-B39474AF-6778-499A-B8AB-E973BE6D4899.html From b16660a9f051b0557bcaf1e2c8cc261a64403a14 Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Tue, 26 Jun 2018 12:21:29 -0700 Subject: [PATCH 40/63] added a reference to validate-signatures.rst to download-verify-uncompress-linux.rst for uniformity (issue 163). made a couple wording changes to validate-signatures.rst and added a label to help with navigation --- .../maintenance/download-verify-uncompress-linux.rst | 3 +++ .../guides/maintenance/validate-signatures.rst | 8 +++++--- 2 files changed, 8 insertions(+), 3 deletions(-) diff --git a/source/clear-linux/guides/maintenance/download-verify-uncompress-linux.rst b/source/clear-linux/guides/maintenance/download-verify-uncompress-linux.rst index f497148c..95cb27bd 100644 --- a/source/clear-linux/guides/maintenance/download-verify-uncompress-linux.rst +++ b/source/clear-linux/guides/maintenance/download-verify-uncompress-linux.rst @@ -42,6 +42,9 @@ checksum, a warning is displayed with a message indicating the computed checksum does **not** match. Otherwise, the name of the image is printed on the screen followed by `OK`. +For a more in-depth discussion of image verification including checking the +certificate see :ref:`image-content-validation`. + Uncompress the Clear Linux image ******************************** diff --git a/source/clear-linux/guides/maintenance/validate-signatures.rst b/source/clear-linux/guides/maintenance/validate-signatures.rst index 190e4f59..94a7763e 100644 --- a/source/clear-linux/guides/maintenance/validate-signatures.rst +++ b/source/clear-linux/guides/maintenance/validate-signatures.rst @@ -1,7 +1,7 @@ .. _validate-signatures: -Validate signatures -################### +Validating signatures +##################### |CLOSIA| offers a way to validate the content of an image or an update. All validation of content works by creating and signing a hash. A valid signature @@ -9,9 +9,11 @@ creates a chain of trust. A broken chain of trust, seen as an invalid signature, means the content is not valid. This guide covers how to validate the contents of an image, which is a manual -process, and describes the automatic process ``swupd`` performs internally to +process and is the same process ``swupd`` performs internally to validate an update. +.. _image-content-validation: + Image content validation ======================== From a19a19e48d5916ff307d794ab9ec411c8c018905 Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Tue, 26 Jun 2018 15:43:23 -0700 Subject: [PATCH 41/63] Fix lsblk output --- .../guides/maintenance/increase-virtual-disk-size.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst b/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst index 76765100..a700a7d9 100644 --- a/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst +++ b/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst @@ -17,7 +17,7 @@ There are two methods to find the order and sizes of partitions virtual disk of image. In both examples, the prebuilt Hyper-V image -has a disk size of 8.5 GB with /dev/sdd3 being the partition +has a disk size of 8.5 GB with /dev/sda3 being the partition for the root filesystem (/) @@ -37,9 +37,9 @@ An example output of the :command:`lsblk` command: NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT sda 8:0 0 8.5G 0 disk - ├─sdd1 8:1 0 512M 0 part - ├─sdd2 8:2 0 32M 0 part [SWAP] - └─sdd3 8:3 0 8G 0 part / + ├─sda1 8:1 0 512M 0 part + ├─sda2 8:2 0 32M 0 part [SWAP] + └─sda3 8:3 0 8G 0 part / An example of this can also be seen in Figure 1. From 5b6c781c69e88640f63aefb3bc50ad87ca2d32b0 Mon Sep 17 00:00:00 2001 From: Michael Vincerra Date: Tue, 26 Jun 2018 16:26:00 -0700 Subject: [PATCH 42/63] Fixes syntax on figures and code blocks for proper rendering. Signed-off-by: Michael Vincerra --- .../increase-virtual-disk-size.rst | 173 +++++++++--------- 1 file changed, 83 insertions(+), 90 deletions(-) diff --git a/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst b/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst index a700a7d9..0436d965 100644 --- a/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst +++ b/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst @@ -1,6 +1,6 @@ .. _increase-virtual-disk-size: -Increase virtual disk size of a Clear Linux image +Increase virtual disk size of a Clear Linux\* image ################################################# |CLOSIA| prebuilt images come in different sizes, ranging from 300 MB to 20 @@ -9,17 +9,14 @@ if you need more capacity. .. contents:: This guide will cover: - Determine the partition order and sizes of the prebuilt image *************************************************** -There are two methods to find the order and sizes of partitions virtual disk of your prebuilt |CL| -image. - -In both examples, the prebuilt Hyper-V image -has a disk size of 8.5 GB with /dev/sda3 being the partition -for the root filesystem (/) +There are two methods to find the order and sizes of partitions virtual disk +of your prebuilt |CL| image. +In both examples, the prebuilt Hyper-V image has a disk size of 8.5 GB with / +dev/sda3 being the partition for the root filesystem (/) Checking :command:`lsblk` on the VM ----------------------------------- @@ -27,66 +24,64 @@ Checking :command:`lsblk` on the VM The first method is to boot up your :abbr:`VM (Virtual Machine)` and execute the :command:`lsblk` command as shown below: - .. code-block:: bash +.. code-block:: bash - sudo lsblk + sudo lsblk An example output of the :command:`lsblk` command: - .. code-block:: console +.. code-block:: console - NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT - sda 8:0 0 8.5G 0 disk - ├─sda1 8:1 0 512M 0 part - ├─sda2 8:2 0 32M 0 part [SWAP] - └─sda3 8:3 0 8G 0 part / + NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT + sda 8:0 0 8.5G 0 disk + ├─sda1 8:1 0 512M 0 part + ├─sda2 8:2 0 32M 0 part [SWAP] + └─sda3 8:3 0 8G 0 part / An example of this can also be seen in Figure 1. - Checking :file:`config.json` used to build the image ---------------------------------------------------- The second method to determine partition to check the :file:`config.json` -file used to create prebuilt image, located in the -`releases`_ repository. For example, to find the size of the Hyper-V\* image -version number 20450, follow these steps: +file used to create prebuilt image, located in the `releases`_ repository. +For example, to find the size of the Hyper-V\* image version number 20450, +follow these steps: -#. Go to the `releases`_ repository. -#. Drill down into the `20450 > clear > config > image` directory. -#. Open the :file:`hyperv-config.json` file. -#. Locate the `PartitionLayout` key. +#. Go to the `releases`_ repository. +#. Drill down into the `20450 > clear > config > image` directory. +#. Open the :file:`hyperv-config.json` file. +#. Locate the `PartitionLayout` key. - The example shows 512 MB for the EFI partition, 32 MB for the swap - partition, and 8 GB for the root partition. + The example shows 512 MB for the EFI partition, 32 MB for the swap + partition, and 8 GB for the root partition. - .. code-block:: console - - "PartitionLayout" : [ { "disk" : "hyperv.img", - "partition" : 1, - "size" : "512M", - "type" : "EFI" }, - { "disk" : "hyperv.img", - "partition" : 2, - "size" : "32M", - "type" : "swap" }, - { "disk" : "hyperv.img", - "partition" : 3, - "size" : "8G", - "type" : "linux" } ], - + .. code-block:: console + "PartitionLayout" : [ { "disk" : "hyperv.img", + "partition" : 1, + "size" : "512M", + "type" : "EFI" }, + { "disk" : "hyperv.img", + "partition" : 2, + "size" : "32M", + "type" : "swap" }, + { "disk" : "hyperv.img", + "partition" : 3, + "size" : "8G", + "type" : "linux" } ], Increase virtual disk size ************************** -Once you have determined the disk and partition to be increased, you are ready to perform the actual increase of the disk, partition, and filesystem. - +Once you have determined the disk and partition to be increased, you are +ready to perform the actual increase of the disk, partition, and filesystem. Power off VM and increase virtual disk size: -------------------------------------------- -To increase the virtual disk size for a prebuilt image, perform the steps below: +To increase the virtual disk size for a prebuilt image, perform the steps +below: #. Shut down your VM if it is running. #. Use the process defined by your hypervisor @@ -100,77 +95,75 @@ Resize the partition of the virtual disk: #. Log in to an account with root privileges. #. Open a terminal emulator. -#. Add the |CL| `storage-utils` bundle to install the :command:`parted` and :command:`resize2fs` tools. +#. Add the |CL| `storage-utils` bundle to install the + :command:`parted` and :command:`resize2fs` tools. - .. code-block:: bash + .. code-block:: bash - sudo swupd bundle-add storage-utils + sudo swupd bundle-add storage-utils -#. Launch the `parted` tool. +#. Launch the `parted` tool. - .. code-block:: bash + .. code-block:: bash - sudo parted + sudo parted -#. In the `parted` tool, perform these steps: +#. In the `parted` tool, perform these steps: - #. Press :command:`p` to print the partitions table. - #. If the warning message below is displayed, enter :command:`Fix`. + #. Press :command:`p` to print the partitions table. + #. If the warning message below is displayed, enter :command:`Fix`. - .. code-block:: console + .. code-block:: console - Warning: Not all of the space available to /dev/sda appears to be - used, you can fix the GPT to use all of the space (an extra ... - blocks) or continue with the current setting? + Warning: Not all of the space available to /dev/sda appears to be + used, you can fix the GPT to use all of the space (an extra ... + blocks) or continue with the current setting? - Fix/Ignore? + Fix/Ignore? - #. Enter :command:`resizepart [partition number]` where - *[partition number]* is the partition number of the partition to modify. - #. Enter :command:`yes` when prompted. - #. Enter the new `End` size. + #. Enter :command:`resizepart [partition number]` where + *[partition number]* is the partition number of the partition to modify. + #. Enter :command:`yes` when prompted. + #. Enter the new `End` size. - .. note:: + .. note:: - If you want a partition to take up the remaining disk space, then - enter the total size of the disk. When you print the partitions - table with the :command:`p` command, the total disk size is shown - after the `Disk` label. + If you want a partition to take up the remaining disk space, then + enter the total size of the disk. When you print the partitions + table with the :command:`p` command, the total disk size is shown + after the `Disk` label. - An example of this can be seen in Figure 1. + An example of this can be seen in Figure 1. + #. Enter :command:`q` to exit `parted` when you are finished resizing the + image. + Figure 1 depicts the described steps to resize the partition of the virtual disk from 8.5GB to 20GB. - #. Enter :command:`q` to exit `parted` when you are finished resizing the - image. - - - Figure 1 depicts the described steps to resize the partition of the virtual disk from 8.5GB to 20GB. - - .. figure:: figures/increase-virtual-disk-size-1.png - :scale: 100 % - :alt: Increase root partition size - - Figure 1: Increase root partition size. + .. figure:: figures/increase-virtual-disk-size-1.png + :scale: 100 % + :alt: Increase root partition size + Figure 1: Increase root partition size. Resize the filesytem -------------------- - #. Enter :command:`sudo resize2fs -p /dev/[modified partition name]` where - *[modified partition name]* is the partition that was changed in `parted`. +#. Enter :command:`sudo resize2fs -p /dev/[modified partition name]` where + *[modified partition name]* is the partition that was changed in `parted`. - #. Run the :command:`df -h` to verify that the filesystem size has increased. +#. Run the :command:`df -h` to verify that the filesystem size has + increased. - Figure 2 depicts the described steps to resize the partition of the virtual disk from 8.5GB to 20GB. + Figure 2 depicts the described steps to resize the partition of the virtual disk from 8.5GB to 20GB. - .. figure:: figures/increase-virtual-disk-size-2.png - :scale: 100 % - :alt: Increase root filesystem with resize2fs + .. figure:: figures/increase-virtual-disk-size-2.png + :scale: 100 % + :alt: Increase root filesystem with resize2fs - Figure 2: Increase root filesystem size after partition has been expanded. + Figure 2: Increase root filesystem size after partition has been expanded. - .. _releases: https://download.clearlinux.org/releases/ +Congratulations! You have resized the disk, partition, and filesystem. At +this point, the increase in disk capacity is usable. - -Congratulations! You have resized the disk, partition, and filesystem. At this point, the increase in disk capacity is usable. \ No newline at end of file +.. _releases: https://download.clearlinux.org/releases/ \ No newline at end of file From d1542099f307753a8a2b1223cc79460c94ff0efb Mon Sep 17 00:00:00 2001 From: Michael Vincerra Date: Tue, 26 Jun 2018 17:25:33 -0700 Subject: [PATCH 43/63] Corrects syntax for: - Figures and labels - Internal TOC - External references to URLs - Relative paths to files Signed-off-by: Michael Vincerra --- .../vmware-esxi-preconfigured-cl-image.rst | 268 +++++++++--------- 1 file changed, 138 insertions(+), 130 deletions(-) diff --git a/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst b/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst index 5f60534e..23751b7d 100644 --- a/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst +++ b/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst @@ -1,6 +1,6 @@ .. _vmware-esxi-preconfigured-cl-image: -Run preconfigured Clear Linux image as a VMware\* ESXi guest OS +Run preconfigured Clear Linux\* image as a VMware\* ESXi guest OS ############################################################### `VMware ESXi`_ is a type 1 bare-metal hypervisor which runs directly on top @@ -10,21 +10,20 @@ and run |CLOSIA| virtual machines at scale. This section shows you how to deploy a preconfigured |CL| VMware image on VMware ESXi 6.5. -If you would prefer to perform a manual installation of |CL| into a new VMware -ESXi :abbr:`VM (Virtual Machine)` instead, see :ref:`vmware-esxi-install-cl`. -Visit :ref:`image-types` to learn more about the available images. - +If you would prefer to perform a manual installation of |CL| into a new +VMware ESXi :abbr:`VM (Virtual Machine)` instead, see +:ref:`vmware-esxi-install-cl`. Visit :ref:`image-types` to learn more about +the available images. .. note:: - VMware also offers a type 2 hypervisor called `VMware Workstation Player`_ which is designed for the desktop environment. + VMware also offers a type 2 hypervisor called `VMware Workstation Player` + which is designed for the desktop environment. See :ref:`vmw-player-preconf` or see :ref:`vmw-player`. - -.. contents:: +.. contents:: :local: :depth: 2 - Download the latest Clear Linux VMware image ******************************************** @@ -54,80 +53,81 @@ on the VMware ESXi server. The steps in this section can also be referenced from the `VMware documentation on Using the Datastore File Browser`_ -#. Connect to the VMware ESXi server and login to an account with sufficient - permission to create and manage VMs. +#. Connect to the VMware ESXi server and login to an account with sufficient + permission to create and manage VMs. -#. Under the :guilabel:`Navigator` window on the left side, - select :guilabel:`Storage`. - See Figure 1 +#. Under the :guilabel:`Navigator` window on the left side, + select :guilabel:`Storage`. + See Figure 1 -#. Under the :guilabel:`Datastores` tab, click - the :guilabel:`Datastore browser` button. +#. Under the :guilabel:`Datastores` tab, click + the :guilabel:`Datastore browser` button. - .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-1.png + .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-1.png :scale: 100 % :alt: VMware ESXi - Navigator > Storage Figure 1: VMware ESXi - Navigator > Storage -#. Click the :guilabel:`Create directory` button and name the directory - `Clear Linux VM`. See Figure 2. +#. Click the :guilabel:`Create directory` button and name the directory + `Clear Linux VM`. See Figure 2. - .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-2.png + .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-2.png :scale: 100 % :alt: VMware ESXi - Datastore > Create directory Figure 2: VMware ESXi - Datastore > Create directory -#. Select the newly-created directory and click the :guilabel:`Upload` - button. See Figure 3. +#. Select the newly-created directory and click the :guilabel:`Upload` + button. See Figure 3. - .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-3.png + .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-3.png :scale: 100 % :alt: VMware ESXi - Datastore > Upload VMware image Figure 3: VMware ESXi - Datastore > Upload VMware image -#. Select the uncompressed |CL| VMware image file - :file:`clear-[version number]-vmware.vmdk` and upload it. +#. Select the uncompressed |CL| VMware image file + :file:`clear-[version number]-vmware.vmdk` and upload it. Convert the Clear Linux image to an ESXi-supported format ********************************************************* -Once the |CL| VMware prebuilt image has been uploaded to the VMware ESXi datastore, -it must be converted to a format for usable with VMware's ESXi hypervisor. +Once the |CL| VMware prebuilt image has been uploaded to the VMware ESXi +datastore, it must be converted to a format for usable with VMware's ESXi +hypervisor. The steps in this section can also be referenced from the `VMware documentation on Cloning and converting virtual machine disks with vmkfstools`_ -#. SSH into the `vSphere Management Assistant`_ appliance that is managing the ESXi host or connect to the vSphere hosting using the `vSphere CLI`_. +#. SSH into the `vSphere Management Assistant`_ appliance that is managing + the ESXi host or connect to the vSphere hosting using the `vSphere CLI`_. - .. note:: - If there is no :abbr:`vMA (vSphere Management Assistant)` appliance or :abbr:`vCLI (vSphere CLI)` configured and available, - you can temporarily enable SSH directly on the ESXi host by referencing - the `VMware documentation on Enable the Secure Shell (SSH)`_ . + .. note:: + + If there is no :abbr:`vMA (vSphere Management Assistant)` appliance or :abbr:`vCLI (vSphere CLI)` configured and available, + you can temporarily enable SSH directly on the ESXi host by referencing + the `VMware documentation on Enable the Secure Shell (SSH)`_ . - As a security best practice, remember to disable SSH access after following the steps in this section. + As a security best practice, remember to disable SSH access after following the steps in this section. -#. Locate the uploaded image, which is typically found in - :file:`/vmfs/volumes/datastore1`. +#. Locate the uploaded image, which is typically found in + :file:`/vmfs/volumes/datastore1`. -#. Use the :command:`vmkfstools` command to perform the conversion, as - shown below: +#. Use the :command:`vmkfstools` command to perform the conversion, as + shown below: - .. code-block:: console + .. code-block:: console - vmkfstools -i clear-[version number]-vmware.vmdk -d zeroedthick clear-[version number]-esxi.vmdk + vmkfstools -i clear-[version number]-vmware.vmdk -d zeroedthick clear-[version number]-esxi.vmdk - Two files should result from this: - - * :file:`clear-[version number]-esxi-flat.vmdk` - * :file:`clear-[version number]-esxi.vmdk` - - The :file:`clear-[version number]-esxi.vmdk` file will be used in the - next section when you create a new VM. + Two files should result from this: + * :file:`clear-[version number]-esxi-flat.vmdk` + * :file:`clear-[version number]-esxi.vmdk` + The :file:`clear-[version number]-esxi.vmdk` file will be used in the + next section when you create a new VM. Create and configure a new VM ***************************** @@ -136,145 +136,153 @@ In this section, you will create a new VM, configure its basic parameters such as number of CPUs, memory size, and then attach the converted |CL| VMware image. Also, in order to boot |CL|, you must enable UEFI support. -#. Under the :guilabel:`Navigator` window, select - :guilabel:`Virtual Machines`. See Figure 4. +#. Under the :guilabel:`Navigator` window, select + :guilabel:`Virtual Machines`. See Figure 4. -#. In the right window, click the :guilabel:`Create / Register VM` button. +#. In the right window, click the :guilabel:`Create / Register VM` button. - .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-4.png + .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-4.png :scale: 100 % :alt: VMware ESXi - Navigator > Virtual Machines Figure 4: VMware ESXi - Navigator > Virtual Machines -#. On the :guilabel:`Select creation type` step: +#. On the :guilabel:`Select creation type` step: - #. Select the :guilabel:`Create a new virtual machine` option. See - Figure 5. + #. Select the :guilabel:`Create a new virtual machine` option. See + Figure 5. - #. Click the :guilabel:`Next` button. + #. Click the :guilabel:`Next` button. - .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-5.png - :scale: 100 % - :alt: VMware ESXi - Create a new virtual machine + .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-5.png + :scale: 100 % + :alt: VMware ESXi - Create a new virtual machine - Figure 5: VMware ESXi - Create a new virtual machine + Figure 5: VMware ESXi - Create a new virtual machine -#. On the :guilabel:`Select a name and guest OS` step: +#. On the :guilabel:`Select a name and guest OS` step: - #. Give the new VM a name in the :guilabel:`Name` field. See Figure 6. - #. Set the :guilabel:`Compatability` option to :guilabel:`ESXi 6.5 virtual machine`. - #. Set the :guilabel:`Guest OS family` option to :guilabel:`Linux`. - #. Set the :guilabel:`Guest OS version` option to :guilabel:`Other 3.x or later Linux (64-bit)`. - #. Click the :guilabel:`Next` button. +#. Give the new VM a name in the :guilabel:`Name` field. See Figure 6. - .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-6.png - :scale: 100 % - :alt: VMware ESXi - Give a name and select guest OS type +#. Set the :guilabel:`Compatability` option to + :guilabel:`ESXi 6.5 virtual machine`. +#. Set the :guilabel:`Guest OS family` option to :guilabel:`Linux`. +#. Set the :guilabel:`Guest OS version` option to + :guilabel:`Other 3.x or later Linux (64-bit)`. +#. Click the :guilabel:`Next` button. - Figure 6: VMware ESXi - Give a name and select guest OS type + .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-6.png + :scale: 100 % + :alt: VMware ESXi - Give a name and select guest OS type -#. On the :guilabel:`Select storage` step: + Figure 6: VMware ESXi - Give a name and select guest OS type - #. Accept the default option. - #. Click the :guilabel:`Next` button. +#. On the :guilabel:`Select storage` step: -#. On the :guilabel:`Customize settings` step: + #. Accept the default option. + #. Click the :guilabel:`Next` button. - #. Click the :guilabel:`Virtual Hardware` button. See Figure 7. - #. Expand the :guilabel:`CPU` setting and enable :guilabel:`Hardware virtualization` by - checking :guilabel:`Expose hardware assisted virtualization to the guest OS`. +#. On the :guilabel:`Customize settings` step: - .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-7.png - :scale: 100 % - :alt: VMware ESXi - Enable hardware virtualization + #. Click the :guilabel:`Virtual Hardware` button. See Figure 7. + #. Expand the :guilabel:`CPU` setting and enable + :guilabel:`Hardware virtualization` by checking + :guilabel:`Expose hardware assisted virtualization to the guest OS`. - Figure 7: VMware ESXi - Enable hardware virtualization + .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-7.png + :scale: 100 % + :alt: VMware ESXi - Enable hardware virtualization - #. Remove the default :guilabel:`Hard drive 1` setting by clicking - the `X` icon on the right side. See Figure 8. + Figure 7: VMware ESXi - Enable hardware virtualization - .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-8.png - :scale: 100 % - :alt: VMware ESXi - Remove hard drive + #. Remove the default :guilabel:`Hard drive 1` setting by clicking + the `X` icon on the right side. See Figure 8. - Figure 8: VMware ESXi - Remove hard drive + .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-8.png + :scale: 100 % + :alt: VMware ESXi - Remove hard drive - #. Since a preconfigured image will be used, - the :guilabel:`CD/DVD Drive 1` setting will not be needed. Disable it by unchecking the :guilabel:`Connect` checkbox. See Figure 9. + Figure 8: VMware ESXi - Remove hard drive - .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-9.png - :scale: 100 % - :alt: VMware ESXi - Disconnect the CD/DVD drive + #. Since a preconfigured image will be used, + the :guilabel:`CD/DVD Drive 1` setting will not be needed. Disable it + by unchecking the :guilabel:`Connect` checkbox. See Figure 9. - Figure 9: VMware ESXi - Disconnect the CD/DVD drive + .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-9.png + :scale: 100 % + :alt: VMware ESXi - Disconnect the CD/DVD drive - #. Attach the :file:`clear-[version number]-esxi.vmdk` file that was - converted from the preconfigured |CL| VMware image. + Figure 9: VMware ESXi - Disconnect the CD/DVD drive - #. Click the :guilabel:`Add hard disk` button and select the - :guilabel:`Existing hard drive` option. See Figure 10. + #. Attach the :file:`clear-[version number]-esxi.vmdk` file that was + converted from the preconfigured |CL| VMware image. - .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-10.png - :scale: 100 % - :alt: VMware ESXi - Add an existing hard drive + #. Click the :guilabel:`Add hard disk` button and select the + :guilabel:`Existing hard drive` option. See Figure 10. - Figure 10: VMware ESXi - Add an existing hard drive + .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-10.png + :scale: 100 % + :alt: VMware ESXi - Add an existing hard drive - #. Select the converted :file:`clear-[version number]-esxi.vmdk` - file. Do not use the original unconverted :file:`clear-[version number]-vmware.vmdk` file. See Figure 11. + Figure 10: VMware ESXi - Add an existing hard drive - .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-11.png - :scale: 100 % - :alt: VMware ESXi - Select the converted `vmdk` file + #. Select the converted :file:`clear-[version number]-esxi.vmdk` + file. Do not use the original unconverted + :file:`clear-[version number]-vmware.vmdk` file. See Figure 11. - Figure 11: VMware ESXi - Select the converted :file:`clear-[version number]-esxi.vmdk` file + .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-11.png + :scale: 100 % + :alt: VMware ESXi - Select the converted `vmdk` file -#. |CL| needs UEFI support in order to boot. Enable UEFI boot support. + Figure 11: VMware ESXi - Select the converted + :file:`clear-[version number]-esxi.vmdk` file - #. Click the :guilabel:`VM Options` button. See Figure 12. - #. Expand the :guilabel:`Boot Options` setting. - #. For the :guilabel:`Firmware` setting, click the drop-down list to - the right of it and select the :guilabel:`EFI` option. +#. |CL| needs UEFI support in order to boot. Enable UEFI boot support. - .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-12.png - :scale: 100 % - :alt: VMware ESXi - Set boot firmware to EFI + #. Click the :guilabel:`VM Options` button. See Figure 12. + #. Expand the :guilabel:`Boot Options` setting. + #. For the :guilabel:`Firmware` setting, click the drop-down list to + the right of it and select the :guilabel:`EFI` option. - Figure 12: VMware ESXi - Set boot firmware to EFI + .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-12.png + :scale: 100 % + :alt: VMware ESXi - Set boot firmware to EFI -#. Click the :guilabel:`Save` button. -#. Click the :guilabel:`Next` button. -#. Click the :guilabel:`Finish` button. + Figure 12: VMware ESXi - Set boot firmware to EFI + +#. Click the :guilabel:`Save` button. +#. Click the :guilabel:`Next` button. +#. Click the :guilabel:`Finish` button. Power on the VM and boot Clear Linux ************************************ After configuring the settings above, power on the VM. -#. Under the :guilabel:`Navigator` window, select :guilabel:`Virtual Machines`. See Figure 13. -#. In the right window, select the newly-created VM. -#. Click the :guilabel:`Power on` button. -#. Click on the icon representing the VM to bring it into view and maximize - its window. +#. Under the :guilabel:`Navigator` window, select + :guilabel:`Virtual Machines`. See Figure 13. +#. In the right window, select the newly-created VM. +#. Click the :guilabel:`Power on` button. +#. Click on the icon representing the VM to bring it into view and maximize + its window. - .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-13.png + .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-13.png :scale: 100 % :alt: VMware ESXi - Navigator > Virtual Machines > Power on VM Figure 13: VMware ESXi - Navigator > Virtual Machines > Power on VM Also see: ---------- +========= * :ref:`vmware-esxi-install-cl` .. _VMware ESXi: https://www.vmware.com/products/esxi-and-esx.html -.. _`VMware documentation on Using the Datastore File Browser`: https://docs.vmware.com/en/VMware-vSphere/6.7/com.vmware.vsphere.html.hostclient.doc/GUID-7533A767-8396-4844-A3F2-206047D254EA.html -.. _`vSphere Management Assistant`: https://www.vmware.com/support/developer/vima/ -.. _`vSphere CLI`: https://www.vmware.com/support/developer/vcli/ -.. _`VMware documentation on Cloning and converting virtual machine disks with vmkfstools`: https://kb.vmware.com/kb/1028042 -.. _`VMware documentation on Enable the Secure Shell (SSH)`: https://docs.vmware.com/en/VMware-vSphere/6.7/com.vmware.vsphere.html.hostclient.doc/GUID-B649CB74-832F-467B-B6A4-8BA67AD5C1F0.html -.. _`VMware documentation on General ESXi Security Recommendations`: https://docs.vmware.com/en/VMware-vSphere/6.7/com.vmware.vsphere.security.doc/GUID-B39474AF-6778-499A-B8AB-E973BE6D4899.html +.. _VMware documentation on Using the Datastore File Browser: https://docs.vmware.com/en/VMware-vSphere/6.7/com.vmware.vsphere.html.hostclient.doc/GUID-7533A767-8396-4844-A3F2-206047D254EA.html +.. _vSphere Management Assistant: https://www.vmware.com/support/developer/vima/ +.. _vSphere CLI: https://www.vmware.com/support/developer/vcli/ +.. _VMware documentation on Cloning and converting virtual machine disks with vmkfstools: https://kb.vmware.com/kb/1028042 +.. _VMware documentation on Enable the Secure Shell (SSH): https://docs.vmware.com/en/VMware-vSphere/6.7/com.vmware.vsphere.html.hostclient.doc/GUID-B649CB74-832F-467B-B6A4-8BA67AD5C1F0.html +.. _VMware documentation on General ESXi Security Recommendations: https://docs.vmware.com/en/VMware-vSphere/6.7/com.vmware.vsphere.security.doc/GUID-B39474AF-6778-499A-B8AB-E973BE6D4899.html .. _VMware Workstation Player: https://www.vmware.com/products/workstation-player.html .. _image: https://download.clearlinux.org/image From 23364b05a3d31a240a144467aa9ffa34eaf4a0df Mon Sep 17 00:00:00 2001 From: Michael Vincerra Date: Wed, 27 Jun 2018 13:40:57 -0700 Subject: [PATCH 44/63] Removes external hyperlink from Intel Clear Containers: - Reason: Previous page to which it was linked was removed. Signed-off-by: Michael Vincerra --- source/clear-linux/reference/compatible-kernels.rst | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/source/clear-linux/reference/compatible-kernels.rst b/source/clear-linux/reference/compatible-kernels.rst index 0524c57d..ab1303fb 100644 --- a/source/clear-linux/reference/compatible-kernels.rst +++ b/source/clear-linux/reference/compatible-kernels.rst @@ -19,7 +19,7 @@ Kernel Container ================ The *kernel-container* bundle contains the kernel used by the -`Intel® Clear Containers`_ project. This kernel is optimized for +Intel® Clear Containers project. This kernel is optimized for fast booting and performs best on |CC| running on the Intel® architectures described on the :ref:`supported hardware list`. The optimization patches are found in our `Linux-Container`_ GitHub repo. @@ -88,5 +88,4 @@ more information. The optimization patches are found in our .. _CIAO: https://github.com/01org/ciao .. _Azure: https://azuremarketplace.microsoft.com/en-us/marketplace/apps/clear-linux-project.clear-linux-os -.. _Intel® Clear Containers: - https://clearlinux.org/features/intel®-clear-containers + From aa9baaad2a109eab84c9e5265dc3ed0f63c82036 Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Wed, 27 Jun 2018 15:17:16 -0700 Subject: [PATCH 45/63] fixed title to align with project standards --- source/clear-linux/guides/maintenance/validate-signatures.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/clear-linux/guides/maintenance/validate-signatures.rst b/source/clear-linux/guides/maintenance/validate-signatures.rst index 94a7763e..73b131e0 100644 --- a/source/clear-linux/guides/maintenance/validate-signatures.rst +++ b/source/clear-linux/guides/maintenance/validate-signatures.rst @@ -1,6 +1,6 @@ .. _validate-signatures: -Validating signatures +Validate signatures ##################### |CLOSIA| offers a way to validate the content of an image or an update. All From 48fda098504b35c60df56c35c00fbb8348980bcc Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Wed, 27 Jun 2018 15:26:23 -0700 Subject: [PATCH 46/63] trimmed header underline to match header --- source/clear-linux/guides/maintenance/validate-signatures.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/clear-linux/guides/maintenance/validate-signatures.rst b/source/clear-linux/guides/maintenance/validate-signatures.rst index 73b131e0..1001369a 100644 --- a/source/clear-linux/guides/maintenance/validate-signatures.rst +++ b/source/clear-linux/guides/maintenance/validate-signatures.rst @@ -1,7 +1,7 @@ .. _validate-signatures: Validate signatures -##################### +################### |CLOSIA| offers a way to validate the content of an image or an update. All validation of content works by creating and signing a hash. A valid signature From 1e9b5ce1070a98bc4d48b59cd4d280457acff691 Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Thu, 28 Jun 2018 10:51:48 -0700 Subject: [PATCH 47/63] Remove hyperv-mini image hyperv-mini image is being deprecated --- source/clear-linux/guides/maintenance/image-types.rst | 2 -- 1 file changed, 2 deletions(-) diff --git a/source/clear-linux/guides/maintenance/image-types.rst b/source/clear-linux/guides/maintenance/image-types.rst index e3a119f5..c0d6c1e6 100644 --- a/source/clear-linux/guides/maintenance/image-types.rst +++ b/source/clear-linux/guides/maintenance/image-types.rst @@ -42,8 +42,6 @@ Table 1 lists the currently available images. - Optimized image used by Clear Containers runtime * - hyperv.vhdx - Image for Microsoft Hyper-V\* - * - hyperv-mini.vhdx - - Minimal image with fewer bundles for Microsoft Hyper-V * - installer.img - Interactive installer image * - installer.iso From 85e87d3b16af7b9c03907a76bad168fd3fd61c16 Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Thu, 28 Jun 2018 11:24:29 -0700 Subject: [PATCH 48/63] Add preference to use IMG over ISO --- source/clear-linux/guides/maintenance/image-types.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/clear-linux/guides/maintenance/image-types.rst b/source/clear-linux/guides/maintenance/image-types.rst index c0d6c1e6..85b1d96a 100644 --- a/source/clear-linux/guides/maintenance/image-types.rst +++ b/source/clear-linux/guides/maintenance/image-types.rst @@ -42,10 +42,10 @@ Table 1 lists the currently available images. - Optimized image used by Clear Containers runtime * - hyperv.vhdx - Image for Microsoft Hyper-V\* - * - installer.img - - Interactive installer image + * - installer.img + - Preferred interactive installer image * - installer.iso - - ISO of the interactive installer image + - ISO of the interactive installer image. Only on special cases where ISO image format is required (not for use with a USB key) * - kvm.img - Image for booting in a simple VM with start_qemu.sh * - live.img From 353f967c3d675fe6f3afafb8680fac6d39cfced0 Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Thu, 28 Jun 2018 12:20:33 -0700 Subject: [PATCH 49/63] More descriptive description and file readability Add some consistency to dscriptions, references to images with optimized kernels. --- .../guides/maintenance/image-types.rst | 36 ++++++++++++------- 1 file changed, 24 insertions(+), 12 deletions(-) diff --git a/source/clear-linux/guides/maintenance/image-types.rst b/source/clear-linux/guides/maintenance/image-types.rst index 85b1d96a..5653e763 100644 --- a/source/clear-linux/guides/maintenance/image-types.rst +++ b/source/clear-linux/guides/maintenance/image-types.rst @@ -29,28 +29,40 @@ Table 1 lists the currently available images. * - Image Type - Description + * - azure.vhd - - Image for Microsoft\* Azure\* + - Virtual Hard Disk for use on Microsoft\* Azure\* cloud platform + * - azure-docker.vhd - - Image with Docker\* installed for Microsoft Azure + - Virtual Hard Disk for use on Microsoft\* Azure\* cloud platform with Docker\* pre-installed + * - azure-machine-learning.vhd - - Image with the `machine-learning-basic` bundle installed for Microsoft - Azure + - Virtual Hard Disk for use on Microsoft\* Azure\* cloud platform with the `machine-learning-basic` bundle installed + * - cloud.img - - Image for cloud deployment such as OpenStack\* + - Image for use by cloud deployments such as OpenStack\* + * - containers.img - - Optimized image used by Clear Containers runtime + - Image for use by Clear Containers runtime. Includes `optimized kernel`_ for Clear Containers. + * - hyperv.vhdx - - Image for Microsoft Hyper-V\* + - Virtual Hard Disk for use with Microsoft Hyper-V\* hypervisor. Includes `optimized kernel`_ for Hyper-V. + * - installer.img - - Preferred interactive installer image + - Preferred image of Clear Linux with interactive installer. + * - installer.iso - - ISO of the interactive installer image. Only on special cases where ISO image format is required (not for use with a USB key) + - ISO of Clear Linux with interactive installer. Only for special cases where ISO image format is required (not for use with a USB key) + * - kvm.img - - Image for booting in a simple VM with start_qemu.sh + - Image for booting in a simple VM with start_qemu.sh. Includes `optimized kernel`_ for KVM. + * - live.img - - Live boot image + - image for live booting into memory, without requiring installaton. + * - vmware.vmdk - - Image for VMware\* + - Virtual Machine Disk for VMware\* platforms inclduing Player, Workstation, and ESXi. .. _images: https://download.clearlinux.org/image +.. _`optimized kernel`: https://clearlinux.org/documentation/clear-linux/reference/compatible-kernels + From 27273f7aeabf2272112a34cea8f91548ad05f2ba Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Thu, 28 Jun 2018 12:32:24 -0700 Subject: [PATCH 50/63] Split table into 2 This helps understand the difference between images by catagorizingthem and highlights what users are most likely looking for. --- .../guides/maintenance/image-types.rst | 34 ++++++++++++------- 1 file changed, 22 insertions(+), 12 deletions(-) diff --git a/source/clear-linux/guides/maintenance/image-types.rst b/source/clear-linux/guides/maintenance/image-types.rst index 5653e763..d1cfcdab 100644 --- a/source/clear-linux/guides/maintenance/image-types.rst +++ b/source/clear-linux/guides/maintenance/image-types.rst @@ -21,10 +21,29 @@ file format. The *[compression type]* field specifies the compression type. Two types of compressions are used: GNU\* zip (*.gz*) and XZ (*.xz*). -Table 1 lists the currently available images. +Table 1 lists the currently available images which are platform independant. +Table 2 lists the currently available images which are platform specific. -.. list-table:: Table 1: Types of Clear Linux images - :widths: 20, 60 +.. list-table:: Table 1: Types of platform independant Clear Linux images + :widths: 15, 85 + :header-rows: 1 + + * - Image Type + - Description + + * - installer.img + - Preferred image of Clear Linux with interactive installer. + + * - installer.iso + - ISO of Clear Linux with interactive installer. Only for special cases where ISO image format is required (not for use with a USB key) + + * - live.img + - image for live booting into memory, without requiring installaton. + + + +.. list-table:: Table 2: Types of platform specific Clear Linux images + :widths: 15, 85 :header-rows: 1 * - Image Type @@ -48,18 +67,9 @@ Table 1 lists the currently available images. * - hyperv.vhdx - Virtual Hard Disk for use with Microsoft Hyper-V\* hypervisor. Includes `optimized kernel`_ for Hyper-V. - * - installer.img - - Preferred image of Clear Linux with interactive installer. - - * - installer.iso - - ISO of Clear Linux with interactive installer. Only for special cases where ISO image format is required (not for use with a USB key) - * - kvm.img - Image for booting in a simple VM with start_qemu.sh. Includes `optimized kernel`_ for KVM. - * - live.img - - image for live booting into memory, without requiring installaton. - * - vmware.vmdk - Virtual Machine Disk for VMware\* platforms inclduing Player, Workstation, and ESXi. From 053d57c682798b1b4c01f2769a5cc692b747af51 Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Thu, 28 Jun 2018 12:35:44 -0700 Subject: [PATCH 51/63] Move image types document from guide to reference --- .../clear-linux/{guides/maintenance => reference}/image-types.rst | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename source/clear-linux/{guides/maintenance => reference}/image-types.rst (100%) diff --git a/source/clear-linux/guides/maintenance/image-types.rst b/source/clear-linux/reference/image-types.rst similarity index 100% rename from source/clear-linux/guides/maintenance/image-types.rst rename to source/clear-linux/reference/image-types.rst From daa1a459971f45b2b44c13135c55457ab21eb8c9 Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Thu, 28 Jun 2018 13:28:43 -0700 Subject: [PATCH 52/63] first commit of swupd-guide.rst --- .../guides/maintenance/swupd_guide.rst | 81 +++++++++++++++++++ 1 file changed, 81 insertions(+) create mode 100644 source/clear-linux/guides/maintenance/swupd_guide.rst diff --git a/source/clear-linux/guides/maintenance/swupd_guide.rst b/source/clear-linux/guides/maintenance/swupd_guide.rst new file mode 100644 index 00000000..398ea209 --- /dev/null +++ b/source/clear-linux/guides/maintenance/swupd_guide.rst @@ -0,0 +1,81 @@ +.. _swupd_guide: + +swupd guide +########### + +*swupd* manages the software update capability of |CLOSIA|. It can check for +valid system updates and, if found, download and install them. It can also +perform verification of the system software. + +|CL| uses :ref:`bundles-about` as the base abstraction for +installing functionality on top of the core operating system. Use the `swupd` +tool to install and remove bundles. + +.. contents:: + :local: + :depth: 2 + +For a full listing of commands and options please see the man page in |CL| + +.. code-block:: bash + + man swupd + +OS Update and Verification +************************** + +|CL| is designed to promote a regular update cadence. `swupd` helps to +make sure that process is simple and secure. + +Automatic Updates +================= + +|CL| updates can be toggled to happen automatically or on demand. Enable +automatic updates like this: + +.. code-block:: bash + + sudo swupd autoupdate --enable + +To disable use the `--disable` flag instead. + +System Software Verification +============================ + +`swupd` can determine whether the system software has been overwritten, removed, or modified in any way. + +.. code-block:: bash + + sudo swupd verify + +Bundles +******* + +Listing installed bundles +========================= + +You can list all of the bundles currently installed on the system + +.. code-block:: bash + + sudo swupd bundle-list --all + +Adding a bundle +=============== + +Start by selecting a bundle from the list of :ref:`available-bundles`. In +this example we're adding dev-utils-dev, which is useful for development. + +.. code-block:: bash + + sudo swupd bundle-add dev-utils-dev + +Removing a bundle +================= + +Dependencies common to other bundles will not be removed + +.. code-block:: bash + + sudo swupd bundle-remove dev-utils-dev + From 5379715cf971e2a1e7b1fc68f57262119b98668e Mon Sep 17 00:00:00 2001 From: Michael Vincerra Date: Fri, 29 Jun 2018 13:40:53 -0700 Subject: [PATCH 53/63] Corrects Sphinx syntax, spelling, and document formatting. Signed-off-by: Michael Vincerra --- source/clear-linux/reference/image-types.rst | 33 ++++++++++---------- 1 file changed, 16 insertions(+), 17 deletions(-) diff --git a/source/clear-linux/reference/image-types.rst b/source/clear-linux/reference/image-types.rst index d1cfcdab..25d375ef 100644 --- a/source/clear-linux/reference/image-types.rst +++ b/source/clear-linux/reference/image-types.rst @@ -1,6 +1,6 @@ .. _image-types: -Clear Linux image types +Clear Linux\* image types ####################### .. _image-types-content: @@ -9,22 +9,22 @@ Clear Linux image types The naming convention of a |CL| image filename is: - .. code-block:: console +.. code-block:: console - clear-[version number]-[image type].[compression type] + clear-[version number]-[image type].[compression type] -The *[version number]* field specifies the version number. +* The *[version number]* field specifies the version number. -The *[image type]* field specifies the type of image and its corresponding -file format. +* The *[image type]* field specifies the type of image and its corresponding + file format. -The *[compression type]* field specifies the compression type. Two types of -compressions are used: GNU\* zip (*.gz*) and XZ (*.xz*). +* The *[compression type]* field specifies the compression type. Two types of + compressions are used: GNU\* zip (*.gz*) and XZ (*.xz*). -Table 1 lists the currently available images which are platform independant. -Table 2 lists the currently available images which are platform specific. +Table 1 lists the currently available images that are platform independent. +Table 2 lists the currently available images that are platform specific. -.. list-table:: Table 1: Types of platform independant Clear Linux images +.. list-table:: Table 1: Types of platform-independent Clear Linux images :widths: 15, 85 :header-rows: 1 @@ -40,9 +40,7 @@ Table 2 lists the currently available images which are platform specific. * - live.img - image for live booting into memory, without requiring installaton. - - -.. list-table:: Table 2: Types of platform specific Clear Linux images +.. list-table:: Table 2: Types of platform-specific Clear Linux images :widths: 15, 85 :header-rows: 1 @@ -53,10 +51,10 @@ Table 2 lists the currently available images which are platform specific. - Virtual Hard Disk for use on Microsoft\* Azure\* cloud platform * - azure-docker.vhd - - Virtual Hard Disk for use on Microsoft\* Azure\* cloud platform with Docker\* pre-installed + - Virtual Hard Disk for use on Microsoft Azure cloud platform with Docker\* pre-installed * - azure-machine-learning.vhd - - Virtual Hard Disk for use on Microsoft\* Azure\* cloud platform with the `machine-learning-basic` bundle installed + - Virtual Hard Disk for use on Microsoft Azure cloud platform with the `machine-learning-basic` bundle installed * - cloud.img - Image for use by cloud deployments such as OpenStack\* @@ -68,7 +66,8 @@ Table 2 lists the currently available images which are platform specific. - Virtual Hard Disk for use with Microsoft Hyper-V\* hypervisor. Includes `optimized kernel`_ for Hyper-V. * - kvm.img - - Image for booting in a simple VM with start_qemu.sh. Includes `optimized kernel`_ for KVM. + - Image for booting in a simple VM with start_qemu.sh. Includes + `optimized kernel`_ for KVM. * - vmware.vmdk - Virtual Machine Disk for VMware\* platforms inclduing Player, Workstation, and ESXi. From dea47748b551341e814aceca49d6067effb99208 Mon Sep 17 00:00:00 2001 From: Jose Lamego Date: Mon, 2 Jul 2018 11:08:03 -0500 Subject: [PATCH 54/63] Update kata.rst --- source/clear-linux/tutorials/kata.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/clear-linux/tutorials/kata.rst b/source/clear-linux/tutorials/kata.rst index 841dc083..615f9e1e 100644 --- a/source/clear-linux/tutorials/kata.rst +++ b/source/clear-linux/tutorials/kata.rst @@ -7,7 +7,7 @@ This tutorial describes how to install, configure and run Kata Containers\* on |CLOSIA|. Kata Containers\* is an open source project and community working to build a standard implementation of lightweight Virtual Machines (VMs) that feel and perform like containers, but provide the workload isolation and security -advantages of VMs. Kata Containers\* is available in Clear Linux versions above 22860. +advantages of VMs. Kata Containers\* is available in Clear Linux versions above 23380. Prerequisites ************* From 7386f26245e964fd274a1610a58795f7f372afba Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Mon, 2 Jul 2018 12:21:18 -0700 Subject: [PATCH 55/63] added more material --- .../guides/maintenance/swupd_guide.rst | 102 ++++++++++++++++-- 1 file changed, 95 insertions(+), 7 deletions(-) diff --git a/source/clear-linux/guides/maintenance/swupd_guide.rst b/source/clear-linux/guides/maintenance/swupd_guide.rst index 398ea209..dad8f797 100644 --- a/source/clear-linux/guides/maintenance/swupd_guide.rst +++ b/source/clear-linux/guides/maintenance/swupd_guide.rst @@ -15,6 +15,8 @@ tool to install and remove bundles. :local: :depth: 2 +.. _man_swupd: + For a full listing of commands and options please see the man page in |CL| .. code-block:: bash @@ -27,27 +29,103 @@ OS Update and Verification |CL| is designed to promote a regular update cadence. `swupd` helps to make sure that process is simple and secure. -Automatic Updates -================= +OS Info +======= -|CL| updates can be toggled to happen automatically or on demand. Enable -automatic updates like this: +Current OS version and update server info: .. code-block:: bash - sudo swupd autoupdate --enable + swupd info -To disable use the `--disable` flag instead. +.. code-block:: console + Installed version: 23330 + Version URL: https://download.clearlinux.org/update/ + Content URL: https://cdn.download.clearlinux.org/update/ + +Disable Automatic Updates +========================= + +|CL| updates are automatic by default but can be toggled to occur only +on demand. Disable automatic updates: + +.. code-block:: bash + + sudo swupd autoupdate --disable + +To re-enable automatic updates use the `--enable` flag. + +Check for Updates +================= + +.. code-block:: bash + + sudo swupd check-update + +Perform a Manual Update +======================= + +You can update to a specific verion or accept the +latest as the default with no arguments. + +Initiate a manual update: + +.. code-block:: bash + + sudo swupd update -m 23330 + +Output from a successful update: + +.. code-block:: console + + Update started. + Version on server (23330) is not newer than system version (23330) + Update complete. System already up-to-date at version 23330 System Software Verification ============================ -`swupd` can determine whether the system software has been overwritten, removed, or modified in any way. +`swupd` can determine whether system directories and files have been added +to, overwritten, removed, or modified (eg., permissions). .. code-block:: bash sudo swupd verify +All directories that are watched by `swupd` are verified according to +the manifest data and hash mismatches are flagged as follows: + +.. code-block:: console + + Verifying version 23300 + Verifying files + ...0% + Hash mismatch for file: /usr/bin/chardetect + ... + ... + Hash mismatch for file: /usr/lib/python3.6/site-packages/urllib3/util/wait.py + ...100% + Inspected 237180 files + 423 files did not match + Verify successful + +In this case, python packages that were installed on top of the default +install were flagged as mismatched. `swupd` can be directed to ignore +or fix issues based on :ref:`command line options `. + +Fixing Hash Mixmatches +====================== + +`swupd` can correct any issues it detects. Additional directives can be +added including a white list of directories that will be ignored, if +desired. + +The following command will repair issues, remove unknown items, and ignore files or directories matching `/usr/lib/python`: + +.. code-block:: bash + + sudo swupd verify --fix --picky --picky-whitelist=/usr/lib/python + Bundles ******* @@ -60,6 +138,16 @@ You can list all of the bundles currently installed on the system sudo swupd bundle-list --all +Finding a bundle containing a binary +==================================== + +Run the following to display a list of bundles that contain a particular +binary. Note that it may be present in multiple bundles: + +.. code-block:: bash + + swupd search -b + Adding a bundle =============== From 598d4fda9a8c5adc7bbe952c9a28664f062155b7 Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Mon, 2 Jul 2018 12:22:55 -0700 Subject: [PATCH 56/63] added swupd-guide to toc --- source/clear-linux/guides/maintenance/maintenance.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/source/clear-linux/guides/maintenance/maintenance.rst b/source/clear-linux/guides/maintenance/maintenance.rst index 8775a909..b5cbc720 100644 --- a/source/clear-linux/guides/maintenance/maintenance.rst +++ b/source/clear-linux/guides/maintenance/maintenance.rst @@ -14,6 +14,7 @@ maintaining |CLOSIA| after :ref:`installation ` is completed. bulk-provision mixer mixin + swupd validate-signatures telemetry-enable time From b9dbe660769576280eb688021af4499aba29468c Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Mon, 2 Jul 2018 12:33:07 -0700 Subject: [PATCH 57/63] corrected some linking problems and renamed the swupd guide file --- .../guides/maintenance/maintenance.rst | 2 +- .../guides/maintenance/swupd_guide.rst | 169 ------------------ 2 files changed, 1 insertion(+), 170 deletions(-) delete mode 100644 source/clear-linux/guides/maintenance/swupd_guide.rst diff --git a/source/clear-linux/guides/maintenance/maintenance.rst b/source/clear-linux/guides/maintenance/maintenance.rst index b5cbc720..6cbf1034 100644 --- a/source/clear-linux/guides/maintenance/maintenance.rst +++ b/source/clear-linux/guides/maintenance/maintenance.rst @@ -14,7 +14,7 @@ maintaining |CLOSIA| after :ref:`installation ` is completed. bulk-provision mixer mixin - swupd + swupd-guide validate-signatures telemetry-enable time diff --git a/source/clear-linux/guides/maintenance/swupd_guide.rst b/source/clear-linux/guides/maintenance/swupd_guide.rst deleted file mode 100644 index dad8f797..00000000 --- a/source/clear-linux/guides/maintenance/swupd_guide.rst +++ /dev/null @@ -1,169 +0,0 @@ -.. _swupd_guide: - -swupd guide -########### - -*swupd* manages the software update capability of |CLOSIA|. It can check for -valid system updates and, if found, download and install them. It can also -perform verification of the system software. - -|CL| uses :ref:`bundles-about` as the base abstraction for -installing functionality on top of the core operating system. Use the `swupd` -tool to install and remove bundles. - -.. contents:: - :local: - :depth: 2 - -.. _man_swupd: - -For a full listing of commands and options please see the man page in |CL| - -.. code-block:: bash - - man swupd - -OS Update and Verification -************************** - -|CL| is designed to promote a regular update cadence. `swupd` helps to -make sure that process is simple and secure. - -OS Info -======= - -Current OS version and update server info: - -.. code-block:: bash - - swupd info - -.. code-block:: console - Installed version: 23330 - Version URL: https://download.clearlinux.org/update/ - Content URL: https://cdn.download.clearlinux.org/update/ - -Disable Automatic Updates -========================= - -|CL| updates are automatic by default but can be toggled to occur only -on demand. Disable automatic updates: - -.. code-block:: bash - - sudo swupd autoupdate --disable - -To re-enable automatic updates use the `--enable` flag. - -Check for Updates -================= - -.. code-block:: bash - - sudo swupd check-update - -Perform a Manual Update -======================= - -You can update to a specific verion or accept the -latest as the default with no arguments. - -Initiate a manual update: - -.. code-block:: bash - - sudo swupd update -m 23330 - -Output from a successful update: - -.. code-block:: console - - Update started. - Version on server (23330) is not newer than system version (23330) - Update complete. System already up-to-date at version 23330 - -System Software Verification -============================ - -`swupd` can determine whether system directories and files have been added -to, overwritten, removed, or modified (eg., permissions). - -.. code-block:: bash - - sudo swupd verify - -All directories that are watched by `swupd` are verified according to -the manifest data and hash mismatches are flagged as follows: - -.. code-block:: console - - Verifying version 23300 - Verifying files - ...0% - Hash mismatch for file: /usr/bin/chardetect - ... - ... - Hash mismatch for file: /usr/lib/python3.6/site-packages/urllib3/util/wait.py - ...100% - Inspected 237180 files - 423 files did not match - Verify successful - -In this case, python packages that were installed on top of the default -install were flagged as mismatched. `swupd` can be directed to ignore -or fix issues based on :ref:`command line options `. - -Fixing Hash Mixmatches -====================== - -`swupd` can correct any issues it detects. Additional directives can be -added including a white list of directories that will be ignored, if -desired. - -The following command will repair issues, remove unknown items, and ignore files or directories matching `/usr/lib/python`: - -.. code-block:: bash - - sudo swupd verify --fix --picky --picky-whitelist=/usr/lib/python - -Bundles -******* - -Listing installed bundles -========================= - -You can list all of the bundles currently installed on the system - -.. code-block:: bash - - sudo swupd bundle-list --all - -Finding a bundle containing a binary -==================================== - -Run the following to display a list of bundles that contain a particular -binary. Note that it may be present in multiple bundles: - -.. code-block:: bash - - swupd search -b - -Adding a bundle -=============== - -Start by selecting a bundle from the list of :ref:`available-bundles`. In -this example we're adding dev-utils-dev, which is useful for development. - -.. code-block:: bash - - sudo swupd bundle-add dev-utils-dev - -Removing a bundle -================= - -Dependencies common to other bundles will not be removed - -.. code-block:: bash - - sudo swupd bundle-remove dev-utils-dev - From 93a1f5621d7cbb3dbd6d1ab4c724dd67991a737b Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Mon, 2 Jul 2018 12:33:39 -0700 Subject: [PATCH 58/63] added the changes swupd guide file --- .../guides/maintenance/swupd-guide.rst | 169 ++++++++++++++++++ 1 file changed, 169 insertions(+) create mode 100644 source/clear-linux/guides/maintenance/swupd-guide.rst diff --git a/source/clear-linux/guides/maintenance/swupd-guide.rst b/source/clear-linux/guides/maintenance/swupd-guide.rst new file mode 100644 index 00000000..2a25fc6d --- /dev/null +++ b/source/clear-linux/guides/maintenance/swupd-guide.rst @@ -0,0 +1,169 @@ +.. _swupd-guide: + +swupd guide +########### + +*swupd* manages the software update capability of |CLOSIA|. It can check for +valid system updates and, if found, download and install them. It can also +perform verification of the system software. + +|CL| uses :ref:`bundles-about` as the base abstraction for +installing functionality on top of the core operating system. Use the `swupd` +tool to install and remove bundles. + +.. contents:: + :local: + :depth: 2 + +.. _man_swupd: + +For a full listing of commands and options please see the man page in |CL| + +.. code-block:: bash + + man swupd + +OS Update and Verification +************************** + +|CL| is designed to promote a regular update cadence. `swupd` helps to +make sure that process is simple and secure. + +OS Info +======= + +Current OS version and update server info: + +.. code-block:: bash + + swupd info + +.. code-block:: console + Installed version: 23330 + Version URL: https://download.clearlinux.org/update/ + Content URL: https://cdn.download.clearlinux.org/update/ + +Disable Automatic Updates +========================= + +|CL| updates are automatic by default but can be toggled to occur only +on demand. Disable automatic updates: + +.. code-block:: bash + + sudo swupd autoupdate --disable + +To re-enable automatic updates use the `--enable` flag. + +Check for Updates +================= + +.. code-block:: bash + + sudo swupd check-update + +Perform a Manual Update +======================= + +You can update to a specific verion or accept the +latest as the default with no arguments. + +Initiate a manual update: + +.. code-block:: bash + + sudo swupd update -m 23330 + +Output from a successful update: + +.. code-block:: console + + Update started. + Version on server (23330) is not newer than system version (23330) + Update complete. System already up-to-date at version 23330 + +System Software Verification +============================ + +`swupd` can determine whether system directories and files have been added +to, overwritten, removed, or modified (eg., permissions). + +.. code-block:: bash + + sudo swupd verify + +All directories that are watched by `swupd` are verified according to +the manifest data and hash mismatches are flagged as follows: + +.. code-block:: console + + Verifying version 23300 + Verifying files + ...0% + Hash mismatch for file: /usr/bin/chardetect + ... + ... + Hash mismatch for file: /usr/lib/python3.6/site-packages/urllib3/util/wait.py + ...100% + Inspected 237180 files + 423 files did not match + Verify successful + +In this case, python packages that were installed on top of the default +install were flagged as mismatched. `swupd` can be directed to ignore +or fix issues based on :ref:`command line options `. + +Fixing Hash Mixmatches +====================== + +`swupd` can correct any issues it detects. Additional directives can be +added including a white list of directories that will be ignored, if +desired. + +The following command will repair issues, remove unknown items, and ignore files or directories matching `/usr/lib/python`: + +.. code-block:: bash + + sudo swupd verify --fix --picky --picky-whitelist=/usr/lib/python + +Bundles +******* + +Listing installed bundles +========================= + +You can list all of the bundles currently installed on the system + +.. code-block:: bash + + sudo swupd bundle-list --all + +Finding a bundle containing a binary +==================================== + +Run the following to display a list of bundles that contain a particular +binary. Note that it may be present in multiple bundles: + +.. code-block:: bash + + swupd search -b + +Adding a bundle +=============== + +Start by selecting a bundle from the list of :ref:`available-bundles`. In +this example we're adding dev-utils-dev, which is useful for development. + +.. code-block:: bash + + sudo swupd bundle-add dev-utils-dev + +Removing a bundle +================= + +Dependencies common to other bundles will not be removed + +.. code-block:: bash + + sudo swupd bundle-remove dev-utils-dev + From 70d8c38987a165f4dbcf59a6322b6fc9779d9e3f Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Mon, 2 Jul 2018 14:12:44 -0700 Subject: [PATCH 59/63] fixed some wording and typos --- .../guides/maintenance/swupd-guide.rst | 17 ++++++++--------- 1 file changed, 8 insertions(+), 9 deletions(-) diff --git a/source/clear-linux/guides/maintenance/swupd-guide.rst b/source/clear-linux/guides/maintenance/swupd-guide.rst index 2a25fc6d..b70e811d 100644 --- a/source/clear-linux/guides/maintenance/swupd-guide.rst +++ b/source/clear-linux/guides/maintenance/swupd-guide.rst @@ -1,7 +1,7 @@ .. _swupd-guide: -swupd guide -########### +Use swupd +######### *swupd* manages the software update capability of |CLOSIA|. It can check for valid system updates and, if found, download and install them. It can also @@ -65,10 +65,8 @@ Check for Updates Perform a Manual Update ======================= -You can update to a specific verion or accept the -latest as the default with no arguments. - -Initiate a manual update: +You can update to a specific version or accept the latest as the default with +no arguments. Initiate a manual update: .. code-block:: bash @@ -86,7 +84,7 @@ System Software Verification ============================ `swupd` can determine whether system directories and files have been added -to, overwritten, removed, or modified (eg., permissions). +to, overwritten, removed, or modified (e.g., permissions). .. code-block:: bash @@ -113,14 +111,15 @@ In this case, python packages that were installed on top of the default install were flagged as mismatched. `swupd` can be directed to ignore or fix issues based on :ref:`command line options `. -Fixing Hash Mixmatches +Fixing Hash Mismatches ====================== `swupd` can correct any issues it detects. Additional directives can be added including a white list of directories that will be ignored, if desired. -The following command will repair issues, remove unknown items, and ignore files or directories matching `/usr/lib/python`: +The following command will repair issues, remove unknown items, and +ignore files or directories matching `/usr/lib/python`: .. code-block:: bash From 979abaa9f694f757911bc75e224f51133684ee6e Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Mon, 2 Jul 2018 14:45:43 -0700 Subject: [PATCH 60/63] removed reference to successful manual update --- source/clear-linux/guides/maintenance/swupd-guide.rst | 8 -------- 1 file changed, 8 deletions(-) diff --git a/source/clear-linux/guides/maintenance/swupd-guide.rst b/source/clear-linux/guides/maintenance/swupd-guide.rst index b70e811d..a254ea9a 100644 --- a/source/clear-linux/guides/maintenance/swupd-guide.rst +++ b/source/clear-linux/guides/maintenance/swupd-guide.rst @@ -72,14 +72,6 @@ no arguments. Initiate a manual update: sudo swupd update -m 23330 -Output from a successful update: - -.. code-block:: console - - Update started. - Version on server (23330) is not newer than system version (23330) - Update complete. System already up-to-date at version 23330 - System Software Verification ============================ From 2135cccc98e0d0a49ad54f1144b373d57cdf6745 Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Tue, 3 Jul 2018 10:28:10 -0700 Subject: [PATCH 61/63] removed update.rst as material is duplicate of swupd-guide.rst, updated swupd-guide, and updated maintenance.rst to reflect removal update.rst --- .../guides/maintenance/maintenance.rst | 3 +- .../guides/maintenance/swupd-guide.rst | 46 ++++++++---- .../clear-linux/guides/maintenance/update.rst | 70 ------------------- 3 files changed, 35 insertions(+), 84 deletions(-) delete mode 100644 source/clear-linux/guides/maintenance/update.rst diff --git a/source/clear-linux/guides/maintenance/maintenance.rst b/source/clear-linux/guides/maintenance/maintenance.rst index 6cbf1034..76713380 100644 --- a/source/clear-linux/guides/maintenance/maintenance.rst +++ b/source/clear-linux/guides/maintenance/maintenance.rst @@ -10,11 +10,10 @@ maintaining |CLOSIA| after :ref:`installation ` is completed. :maxdepth: 2 enable-user-space - update + swupd-guide bulk-provision mixer mixin - swupd-guide validate-signatures telemetry-enable time diff --git a/source/clear-linux/guides/maintenance/swupd-guide.rst b/source/clear-linux/guides/maintenance/swupd-guide.rst index b70e811d..0c9ef8a0 100644 --- a/source/clear-linux/guides/maintenance/swupd-guide.rst +++ b/source/clear-linux/guides/maintenance/swupd-guide.rst @@ -11,6 +11,13 @@ perform verification of the system software. installing functionality on top of the core operating system. Use the `swupd` tool to install and remove bundles. +This guide assumes: + +* The device is on a well-connected network. + +* The device is able to connect to the release infrastructure + http://update.clearlinux.org + .. contents:: :local: :depth: 2 @@ -23,14 +30,14 @@ For a full listing of commands and options please see the man page in |CL| man swupd -OS Update and Verification +OS update and verification ************************** |CL| is designed to promote a regular update cadence. `swupd` helps to make sure that process is simple and secure. -OS Info -======= +View OS info +============ Current OS version and update server info: @@ -43,26 +50,36 @@ Current OS version and update server info: Version URL: https://download.clearlinux.org/update/ Content URL: https://cdn.download.clearlinux.org/update/ -Disable Automatic Updates -========================= +Enable or disable automatic updates +=================================== -|CL| updates are automatic by default but can be toggled to occur only -on demand. Disable automatic updates: +|CL| updates are automatic by default but can be set to occur only +on demand. To verify your current auto-update setting: + +.. code-block:: bash + + sudo swupd autoupdate + +Disable automatic updates: .. code-block:: bash sudo swupd autoupdate --disable -To re-enable automatic updates use the `--enable` flag. +To re-enable automatic: -Check for Updates +.. code-block:: bash + + sudo swupd autoupdate --enable + +Check for updates ================= .. code-block:: bash sudo swupd check-update -Perform a Manual Update +Perform a manual update ======================= You can update to a specific version or accept the latest as the default with @@ -80,7 +97,12 @@ Output from a successful update: Version on server (23330) is not newer than system version (23330) Update complete. System already up-to-date at version 23330 -System Software Verification +.. note:: + + After a kernel update, reboot immediately for the enhancements to + take effect. + +System software verification ============================ `swupd` can determine whether system directories and files have been added @@ -111,7 +133,7 @@ In this case, python packages that were installed on top of the default install were flagged as mismatched. `swupd` can be directed to ignore or fix issues based on :ref:`command line options `. -Fixing Hash Mismatches +Fixing hash mismatches ====================== `swupd` can correct any issues it detects. Additional directives can be diff --git a/source/clear-linux/guides/maintenance/update.rst b/source/clear-linux/guides/maintenance/update.rst deleted file mode 100644 index 5705fda3..00000000 --- a/source/clear-linux/guides/maintenance/update.rst +++ /dev/null @@ -1,70 +0,0 @@ -.. _update: - -Update Clear Linux -################## - -This section describes how to update |CLOSIA|. - -Prerequisites -============= - -* The system is up and running the Clear Linux 15400 release or later. - -* The device is on a well-connected network. - -* The device is able to connect to the release infrastructure - http://update.clearlinux.org - -To verify the current release running on the system, enter: - -.. code-block:: console - - $ sudo swupd update -s - -How to update the system -======================== - -Starting with version 15400, Clear Linux supports auto-update. By default, it -is turned on. - -To verify the current auto-update setting: - - .. code-block:: console - - $ swupd autoupdate - -To enable auto-update: - - .. code-block:: console - - $ sudo swupd autoupdate --enable - -To disable auto-update: - - .. code-block:: console - - $ sudo swupd autoupdate --disable - -To force a manual update: - - .. code-block:: console - - $ sudo swupd update - -.. note:: - - When the swupd console output indicates a kernel update, reboot - immediately for the enhancements to take effect. - - -Additional information -====================== - -To see the man page listing additional swupd options, install the -`sysadmin-basic` bundle to access the `man` command and later access -the man page: - - .. code-block:: console - - $ sudo swupd bundle-add sysadmin-basic - $ man swupd From 9242b467b8ac91736a5045238f401b63591f4345 Mon Sep 17 00:00:00 2001 From: Mike Tullis Date: Tue, 3 Jul 2018 11:29:34 -0700 Subject: [PATCH 62/63] Simplified sentence (test PR) --- .../get-started/bare-metal-install/bare-metal-install.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/clear-linux/get-started/bare-metal-install/bare-metal-install.rst b/source/clear-linux/get-started/bare-metal-install/bare-metal-install.rst index 46a492f6..30e0967d 100644 --- a/source/clear-linux/get-started/bare-metal-install/bare-metal-install.rst +++ b/source/clear-linux/get-started/bare-metal-install/bare-metal-install.rst @@ -44,7 +44,7 @@ Follow these steps to install |CL| on the target system: #. Power on the system. -#. Open the system BIOS setup menu, normally by pressing the :kbd:`F2` key. +#. Open the system BIOS setup menu by pressing the :kbd:`F2` key. Your BIOS setup menu entry point may vary. #. In the setup menu, enable the UEFI boot and set the USB drive as the first From 963039ec224aaaa0647a2988ef9c93e025646f47 Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Tue, 3 Jul 2018 16:59:34 -0700 Subject: [PATCH 63/63] added autoupdate version to swupd-guide.rst --- source/clear-linux/guides/maintenance/swupd-guide.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/clear-linux/guides/maintenance/swupd-guide.rst b/source/clear-linux/guides/maintenance/swupd-guide.rst index 23726f4d..1c5123f0 100644 --- a/source/clear-linux/guides/maintenance/swupd-guide.rst +++ b/source/clear-linux/guides/maintenance/swupd-guide.rst @@ -53,7 +53,7 @@ Current OS version and update server info: Enable or disable automatic updates =================================== -|CL| updates are automatic by default but can be set to occur only +|CL| updates are automatic by default starting with version 15400 but can be set to occur only on demand. To verify your current auto-update setting: .. code-block:: bash